AITBC Documentation

Comprehensive guides and technical documentation for the AITBC platform

Getting Started

Welcome to AITBC! This guide will help you get started with the AI Training & Blockchain Computing platform.

Prerequisites

  • Linux or macOS operating system
  • Docker installed (version 20.10+)
  • Git
  • Node.js (version 16+) for frontend development
  • Python (version 3.8+) for backend development

Quick Installation

Note: For production deployments, please refer to the Deployment Guide. 
# Clone the repository
git clone https://github.com/aitbc/aitbc.git
cd aitbc

# Run the setup script
./scripts/setup.sh

# Start the development environment
docker-compose up -d

Verify Installation

Once the services are running, you can verify the installation by checking:

  • Blockchain Node: http://localhost:8545
  • Coordinator API: http://localhost:8080
  • Marketplace UI: http://localhost:3000

Architecture

AITBC is built with a modular architecture consisting of several key components:

Core Components

1. Blockchain Node

The blockchain node implements a hybrid Proof of Authority/Proof of Stake consensus mechanism with dynamic mode switching:

  • FAST Mode: 100-200ms finality, up to 50,000 TPS
  • BALANCED Mode: 500ms-1s finality, up to 20,000 TPS
  • SECURE Mode: 2-5s finality, up to 10,000 TPS

2. Coordinator API

The coordinator acts as the central hub for marketplace operations:

  • Job management and scheduling
  • Receipt verification and storage
  • Provider registration and reputation
  • Multi-tenant support

3. GPU Service Provider

Decentralized compute providers offer AI/ML services:

  • Model inference
  • Training and fine-tuning
  • Result verification
  • Cross-chain compatibility

Data Flow

  1. Client submits job request to Coordinator
  2. Coordinator matches with suitable provider
  3. Provider executes computation
  4. Results submitted with cryptographic proof
  5. Verification and settlement on blockchain

API Reference

AITBC provides REST APIs for interacting with the platform:

Coordinator API

Authentication

All API requests require authentication using JWT tokens:

Authorization: Bearer <your-jwt-token>

Endpoints

Method Endpoint Description
POST /api/v1/jobs Create a new job
GET /api/v1/jobs/{id} Get job details
GET /api/v1/jobs List jobs
POST /api/v1/receipts/verify Verify a receipt

Example: Create a Job

curl -X POST http://localhost:8080/api/v1/jobs \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "inference",
    "model_id": "gpt-4",
    "input_data": "Hello, world!",
    "requirements": {
      "max_tokens": 100,
      "temperature": 0.7
    }
  }'

Developer Guide

This section provides detailed information for developers building on AITBC.

SDKs

AITBC provides SDKs for multiple languages:

  • Python SDK: pip install aitbc
  • JavaScript SDK: npm install @aitbc/client
  • Go SDK: go get github.com/aitbc/go-sdk

Building Extensions

Developers can extend AITBC functionality through:

  1. Custom marketplace extensions
  2. New compute provider implementations
  3. Alternative consensus mechanisms
  4. Cross-chain bridges

Contributing

We welcome contributions! Please see our contributing guide for details.

Deployment Guide

This guide covers deploying AITBC in production environments.

System Requirements

Minimum Requirements:
  • 4 CPU cores
  • 8GB RAM
  • 100GB storage
  • Stable internet connection

Production Deployment

# Clone the repository
git clone https://github.com/aitbc/aitbc.git
cd aitbc

# Configure environment
cp .env.example .env
# Edit .env with your settings

# Deploy with Docker Compose
docker-compose -f docker-compose.prod.yml up -d

Monitoring

AITBC includes built-in monitoring capabilities:

  • Prometheus metrics endpoint
  • Grafana dashboards
  • Health check endpoints
  • Log aggregation

Security

Security is a top priority for AITBC. Here are the key security features:

Cryptography

  • Zero-knowledge proofs for privacy
  • Threshold signatures for security
  • End-to-end encryption
  • Secure multi-party computation

Audit Reports

Our smart contracts have been audited by:

  • Trail of Bits (2024)
  • CertiK (2024)
  • OpenZeppelin (2023)

Bug Bounty

We offer a bug bounty program with rewards up to $100,000. Report vulnerabilities at security@aitbc.io.

Frequently Asked Questions

General

What is AITBC?

AITBC is a decentralized platform for AI/ML workloads that combines blockchain technology with artificial intelligence to create a trustless marketplace for computational resources.

How does AITBC ensure privacy?

We use zero-knowledge proofs and secure enclaves to protect sensitive data while enabling verification of computation.

What blockchains does AITBC support?

AITBC currently supports Ethereum, Polygon, and Binance Smart Chain, with more chains being added.

Technical

What is the maximum TPS?

AITBC can achieve up to 100,000 TPS through sharding and rollup architectures.

How long does finality take?

Finality time depends on the consensus mode: 100ms (FAST), 1s (BALANCED), or 5s (SECURE).

Economic

How are providers rewarded?

Providers earn AITBC tokens for completing computations, with rewards based on performance and reputation.

What are the fees?

Transaction fees are dynamic and depend on network load, typically ranging from 0.1% to 1% of the transaction value.