Back to Documentation

# AITBC Full Documentation

Complete technical documentation for the AI Training & Blockchain Computing platform

## 1. Introduction

AITBC (AI Training & Blockchain Computing) is a decentralized platform that combines blockchain technology with AI/ML computing resources. It enables privacy-preserving AI computations with verifiable results on the blockchain.

### Key Features

- Privacy-preserving AI computations with zero-knowledge proofs
- Decentralized GPU marketplace for AI/ML workloads
- Blockchain-based verification and receipt system
- Hybrid Proof-of-Authority/Proof-of-Stake consensus
- Native token (AITBC) for payments and staking

### Use Cases

- Private AI inference without data exposure
- Verifiable ML model training
- Decentralized GPU resource sharing
- Cryptographic proof of computation

## 2. Architecture

AITBC consists of multiple components working together to provide a complete AI blockchain computing solution.

### System Architecture

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

### Core Components

- Blockchain Node: Distributed ledger with PoA/PoS consensus
- Coordinator API: Job orchestration and management
- Wallet Daemon: Secure wallet management
- Miner Daemon: GPU compute provider
- Pool Hub: Miner coordination and matching
- Marketplace Web: GPU compute marketplace UI
- Trade Exchange: Token trading platform

## 3. Installation

### Prerequisites

- Docker & Docker Compose
- Python 3.9+ (for development)
- Node.js 18+ (for frontend development)
- Rust 1.70+ (for blockchain node)

### Quick Start with Docker

    # Clone the repository
    git clone https://gitea.bubuit.net/oib/aitbc.git
    cd aitbc

    # Start all services
    docker-compose up -d

    # Check status
    docker-compose ps

### Development Setup

    # Backend services
    cd coordinator
    pip install -r requirements.txt
    python -m coordinator.main

    # Frontend
    cd website/marketplace
    npm install
    npm run dev

    # Blockchain node
    cd blockchain
    cargo run

## 4. APIs

### Coordinator API

RESTful API for job submission and management

    # Submit a job
    POST /api/v1/jobs
    {
      "type": "inference",
      "model": "llama3.2",
      "input": {
        "prompt": "Hello, AITBC!"
      }
    }

    # Get job status
    GET /api/v1/jobs/{job_id}

    # Get job result
    GET /api/v1/jobs/{job_id}/result

### Blockchain RPC

JSON-RPC API for blockchain interaction

    # Get latest block
    curl -X POST http://localhost:9080 \
      -H "Content-Type: application/json" \
      -d '{"jsonrpc":"2.0","method":"get_head","params":[],"id":1}'

    # Submit transaction
    curl -X POST http://localhost:9080 \
      -H "Content-Type: application/json" \
      -d '{"jsonrpc":"2.0","method":"send_tx","params":[tx],"id":1}'

### WebSocket API

Real-time updates for blocks, transactions, and jobs

    # Connect to WebSocket
    ws://localhost:9081/ws

    # Subscribe to events
    {
      "method": "subscribe",
      "params": ["new_blocks", "job_updates"]
    }

## 5. Components

### Blockchain Node

PoA/PoS consensus blockchain with REST/WebSocket RPC, real-time gossip layer, and comprehensive observability.

Learn more →

### Coordinator API

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

Learn more →

### Marketplace Web

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

Learn more →

### Wallet Daemon

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

Learn more →

### Trade Exchange

Bitcoin-to-AITBC exchange with QR payments, user management, and real-time trading capabilities.

Learn more →

### Pool Hub

Miner registry with scoring engine, Redis/PostgreSQL backing, and comprehensive metrics.

Learn more →

## 6. Guides

### Client Guide

Learn how to use AITBC as a client:

- Client Documentation
- Job submission workflow
- Privacy features
- Result verification

### Miner Guide

Learn how to become a miner:

- Miner Documentation
- Hardware requirements
- Setup and configuration
- Earning rewards

### Developer Guide

Learn how to build on AITBC:

- Developer Documentation
- API integration
- SDK usage
- Contributing

## 7. Advanced Topics

### Zero-Knowledge Proofs

AITBC uses zk-SNARKs to provide privacy-preserving computations:

- Input privacy: Your data never leaves your device
- Computation verification: Proofs are verified on-chain
- Efficient verification: Sub-second proof verification

### Consensus Mechanism

Hybrid PoA/PoS consensus provides:

- Fast finality: Blocks confirmed in seconds
- Energy efficiency: No proof-of-work mining
- Security: Multi-layer validation

### Tokenomics

AITBC token utilities:

- Payment for AI computations
- Staking for network security
- Governance voting rights
- Reward distribution

## 8. Troubleshooting

### Common Issues

Node not syncing? Check peer connections and network connectivity.

1. Connection Issues
   - Verify all services are running: `docker-compose ps`
   - Check logs: `docker-compose logs [service]`
   - Ensure ports are not blocked by firewall
2. Job Submission Fails
   - Check API key is valid
   - Verify model is available
   - Check wallet balance
3. GPU Mining Issues
   - Install latest NVIDIA drivers
   - Verify CUDA installation
   - Check GPU memory availability

## 9. Security

### Security Features

- End-to-end encryption for all data
- Zero-knowledge proofs for privacy
- Multi-signature wallet support
- Hardware wallet integration
- Audited smart contracts

### Best Practices

- Keep private keys secure
- Use hardware wallets for large amounts
- Enable two-factor authentication
- Regular security updates

### Reporting Issues

For security issues, please email: aitbc@bubuit.net