aitbc/README.md

AITBC - Advanced Intelligence Training Blockchain Consortium

Project Structure

This project has been organized for better maintainability. Here's the directory structure:

📁 Essential Root Files

• LICENSE - Project license
• aitbc-cli - Main CLI symlink
• README.md - This file

📁 Core Directories

• aitbc/ - Core AITBC Python package
• cli/ - Command-line interface implementation
• contracts/ - Smart contracts
• scripts/ - Automation and deployment scripts
• services/ - Microservices
• tests/ - Test suites

📁 Configuration

• project-config/ - Project configuration files
  • pyproject.toml - Python project configuration
  • requirements.txt - Python dependencies
  • poetry.lock - Dependency lock file
  • .gitignore - Git ignore rules
  • .deployment_progress - Deployment tracking

📁 Documentation

• docs/ - Comprehensive documentation
  • README.md - Main project documentation
  • SETUP.md - Setup instructions
  • PYTHON_VERSION_STATUS.md - Python compatibility
  • AITBC1_TEST_COMMANDS.md - Testing commands
  • AITBC1_UPDATED_COMMANDS.md - Updated commands
  • README_DOCUMENTATION.md - Detailed documentation

📁 Development

• dev/ - Development tools and examples
• .windsurf/ - IDE configuration
• packages/ - Package distributions
• extensions/ - Browser extensions
• plugins/ - System plugins

📁 Infrastructure

• infra/ - Infrastructure as code
• systemd/ - System service configurations
• monitoring/ - Monitoring setup

📁 Applications

• apps/ - Application components
• services/ - Service implementations
• website/ - Web interface

📁 AI & GPU

• gpu_acceleration/ - GPU optimization
• ai-ml/ - AI/ML components

📁 Security & Backup

• security/ - Security reports and fixes
• backup-config/ - Backup configurations
• backups/ - Data backups

📁 Cache & Logs

• venv/ - Python virtual environment
• logs/ - Application logs
• .mypy_cache/, .pytest_cache/, .ruff_cache/ - Tool caches

Quick Start

# Setup environment
cd /opt/aitbc
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run CLI
./aitbc-cli --help

# Run training
./scripts/training/master_training_launcher.sh

# Cross-node communication training
./scripts/training/openclaw_cross_node_comm.sh

Recent Achievements

See Completed Deployments for detailed project completion history.

ait-mainnet Migration & Cross-Node Tests (April 22, 2026)

• All Nodes Migrated to ait-mainnet: Successfully migrated all blockchain nodes from ait-devnet to ait-mainnet
  • aitbc: CHAIN_ID=ait-mainnet (already configured)
  • aitbc1: CHAIN_ID=ait-mainnet (changed from ait-devnet)
  • gitea-runner: CHAIN_ID=ait-mainnet (changed from ait-devnet)
• Cross-Node Blockchain Tests: Created comprehensive test suite for multi-node blockchain features
  • Test file: /opt/aitbc/tests/verification/test_cross_node_blockchain.py
  • Tests: Chain ID Consistency, Block Synchronization, Block Range Query, RPC Connectivity
  • All 4 tests passing across 3 nodes (aitbc, aitbc1, gitea-runner)
• SQLite Database Corruption Fix: Resolved database corruption on aitbc1 caused by Btrfs CoW behavior
  • Applied chattr +C to /var/lib/aitbc/data to disable CoW
  • Cleared corrupted database files and restarted service
• Network Connectivity Fixes: Corrected RPC URLs for all nodes
  • aitbc1: 10.1.223.40:8006 (corrected from 10.0.3.107:8006)
  • gitea-runner: 10.1.223.93:8006
• Test File Updates: Updated all verification tests to use ait-mainnet chain_id
  • test_tx_import.py, test_simple_import.py, test_minimal.py, test_block_import.py, test_block_import_complete.py

Multi-Node Blockchain Synchronization (April 10, 2026)

• Gossip Backend Configuration: Fixed both nodes to use broadcast backend with Redis
  • aitbc: gossip_backend=broadcast, gossip_broadcast_url=redis://localhost:6379
  • aitbc1: gossip_backend=broadcast, gossip_broadcast_url=redis://10.1.223.40:6379
• PoA Consensus Enhancements: Fixed busy-loop issue in poa.py when mempool is empty
  • Added propose_only_if_mempool_not_empty=true configuration
  • Modified _propose_block to return boolean indicating if a block was proposed
• Transaction Synchronization: Fixed transaction parsing in sync.py
  • Updated _append_block to use correct field names (from/to instead of sender/recipient)
• RPC Endpoint Enhancements: Fixed blocks-range endpoint to include parent_hash and proposer fields
• Block Synchronization Verification: Both nodes in sync at height 27201
• Git Conflict Resolution: Fixed gitea pull conflicts on aitbc1 by stashing local changes

OpenClaw Agent Communication (April 10, 2026)

• Successfully sent agent message from aitbc1 to aitbc
• Wallet used: temp-agent with password "temp123"
• Transaction hash: 0xdcf365542237eb8e40d0aa1cdb3fec2e77dbcb2475c30457682cf385e974b7b8
• Agent daemon: Running on aitbc configured to reply with "pong" on "ping"
• Agent daemon service: Deployed with systemd integration

Multi-Node Blockchain Network

• Genesis Node (aitbc1): Height 27201+, operational at 10.1.223.40:8006
• Follower Node (aitbc): Height 27201+, operational at 10.1.223.93:8006
• Synchronization: Nodes synchronized via gossip with Redis backend
• RPC Services: Running on both nodes

Documentation Updates (April 10, 2026)

• Blockchain Synchronization: docs/blockchain/blockchain_synchronization_issues_and_fixes.md
• OpenClaw Cross-Node Communication: docs/openclaw/guides/openclaw_cross_node_communication.md
• Cross-Node Training: docs/openclaw/training/cross_node_communication_training.md
• Agent Daemon Service: services/agent_daemon.py with systemd integration

Development

See docs/SETUP.md for detailed setup instructions.

Documentation

Recent Documentation Updates

• Cross-Node Communication Guide - Implementation guide for multi-node agent messaging
• Blockchain Synchronization Issues - Detailed documentation of sync fixes and workarounds
• Cross-Node Training Module - Training workflow for agent communication
• OpenClaw Documentation - Complete OpenClaw integration documentation

Core Documentation

• Main Documentation - Comprehensive project documentation
• Setup Instructions - Installation and configuration guide
• Python Compatibility - Python version requirements

Security

See security/SECURITY_VULNERABILITY_REPORT.md for security status.

License

See LICENSE for licensing information.