Files
aitbc/docs/architecture/2_components-overview.md
aitbc 19d415a235
Some checks failed
Blockchain Synchronization Verification / sync-verification (push) Failing after 3s
CLI Tests / test-cli (push) Failing after 3s
Cross-Chain Functionality Tests / test-cross-chain-sync (push) Successful in 2s
Cross-Chain Functionality Tests / test-cross-chain-transactions (push) Successful in 3s
Cross-Chain Functionality Tests / test-cross-chain-bridge (push) Has been skipped
Cross-Chain Functionality Tests / test-multi-chain-consensus (push) Successful in 2s
Cross-Chain Functionality Tests / aggregate-results (push) Has been skipped
Deploy to Testnet / deploy-testnet (push) Successful in 1m12s
Documentation Validation / validate-docs (push) Failing after 8s
Documentation Validation / validate-policies-strict (push) Successful in 3s
Integration Tests / test-service-integration (push) Successful in 2m6s
Multi-Chain Island Architecture Tests / test-multi-chain-island (push) Successful in 2s
Multi-Node Blockchain Health Monitoring / health-check (push) Failing after 4s
P2P Network Verification / p2p-verification (push) Successful in 4s
Package Tests / Python package - aitbc-agent-sdk (push) Successful in 32s
Package Tests / Python package - aitbc-core (push) Successful in 14s
Package Tests / Python package - aitbc-crypto (push) Successful in 12s
Package Tests / Python package - aitbc-sdk (push) Successful in 9s
Package Tests / JavaScript package - aitbc-sdk-js (push) Successful in 8s
Package Tests / JavaScript package - aitbc-token (push) Successful in 17s
Python Tests / test-python (push) Successful in 15s
Security Scanning / security-scan (push) Successful in 27s
Node Failover Simulation / failover-test (push) Successful in 7s
Multi-Node Stress Testing / stress-test (push) Successful in 6s
Cross-Node Transaction Testing / transaction-test (push) Successful in 4s
feat: add SQLCipher database encryption support and consolidate agent documentation
- Add SQLCipher encryption for ait-mainnet database with configurable flag
- Add db_encryption_enabled and db_encryption_key_path config settings
- Implement encryption key loading and PRAGMA key setup via connection events
- Add shutdown_db function for proper database cleanup
- Export middleware classes in aitbc/__init__.py
- Fix import path in sync.py for settings
- Remove duplicate agent documentation from docs
2026-05-03 12:00:38 +02:00

5.5 KiB

AITBC System Components

Overview of all components in the AITBC platform, their status, and documentation links.

Core Components

Blockchain Node

● Live

PoA/PoS consensus with REST/WebSocket RPC, real-time gossip layer, and comprehensive observability. Production-ready with devnet tooling.

Learn More →

Coordinator API

● Live

FastAPI service for job submission, miner registration, and receipt management. SQLite persistence with comprehensive endpoints.

Learn More →

Marketplace Web

● Live

Vite/TypeScript marketplace with offer/bid functionality, stats dashboard, and mock/live data toggle. Production UI ready.

Learn More →

Blockchain Explorer

● Live

Agent-first Python FastAPI blockchain explorer with complete API and built-in HTML interface. TypeScript frontend merged and deleted for simplified architecture. Production-ready on port 8016.

Learn More →

Wallet Daemon

● Live

Encrypted keystore with Argon2id + XChaCha20-Poly1305, REST/JSON-RPC APIs, and receipt verification capabilities.

Learn More →

Trade Exchange

● Live

Bitcoin-to-AITBC exchange with QR payments, user management, and real-time trading. Buy tokens with BTC instantly.

Learn More →

ZK Circuits Engine

● Live

Zero-knowledge proof circuits for privacy-preserving ML operations. Includes inference verification, training verification, and cryptographic proof generation using Groth16.

Learn More →

FHE Service

● Live

Fully Homomorphic Encryption service for encrypted computation on sensitive ML data. TenSEAL integration with CKKS/BFV scheme support.

Learn More →

Enhanced Edge GPU

● Live

Consumer GPU optimization with dynamic discovery, latency measurement, and edge-aware scheduling. Supports Turing, Ampere, and Ada Lovelace architectures.

Learn More →

Miner registry with scoring engine, Redis/PostgreSQL backing, and comprehensive metrics. Live matching API deployed.

Learn More →

Architecture Overview

The AITBC platform consists of 7 core components working together to provide a complete AI blockchain computing solution:

Infrastructure Layer

  • Blockchain Node - Distributed ledger with PoA/PoS consensus
  • Coordinator API - Job orchestration and management
  • Wallet Daemon - Secure wallet management

Application Layer

  • Marketplace Web - GPU compute marketplace
  • Trade Exchange - Token trading platform
  • Explorer Web - Blockchain explorer
  • Pool Hub - Miner coordination service

CLI & Tooling

  • AITBC CLI - 12 command groups, 90+ subcommands (165/165 tests passing)
    • Client, miner, wallet, auth, blockchain, marketplace, admin, config, monitor, simulate, governance, plugin
    • 141 unit tests + 24 integration tests (CLI → live coordinator)
    • CI/CD via GitHub Actions, man page, shell completion

Component Interactions

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│   Clients   │────▶│ Coordinator  │────▶│ Blockchain  │
│             │     │     API      │     │    Node     │
└─────────────┘     └──────────────┘     └─────────────┘
       │                     │                     │
       ▼                     ▼                     ▼
┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│   Wallet    │     │   Pool Hub   │     │   Miners    │
│   Daemon    │     │              │     │             │
└─────────────┘     └──────────────┘     └─────────────┘

Trade Exchange Marketplace Explorer API Docs

Status Legend

  • ● Live - Production ready and deployed
  • ● Beta - In testing, limited availability
  • ● Development - Under active development

Deployment Information

All components are containerized and can be deployed using Docker Compose:

# Deploy all components
docker-compose up -d

# Check status
docker-compose ps

# View logs
docker-compose logs -f

Support

For component-specific issues: