oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity
Files
ab45a81bd7f8b3bb484bcb6589044daff0095477
aitbc/README.md
aitbc e22d864944
Some checks failed
API Endpoint Tests / test-api-endpoints (push) Successful in 11s
Details
CLI Tests / test-cli (push) Failing after 7s
Details
Documentation Validation / validate-docs (push) Successful in 8s
Details
Documentation Validation / validate-policies-strict (push) Successful in 3s
Details
Integration Tests / test-service-integration (push) Successful in 38s
Details
Python Tests / test-python (push) Successful in 11s
Details
Security Scanning / security-scan (push) Successful in 29s
Details
Multi-Node Blockchain Health Monitoring / health-check (push) Successful in 1s
Details
feat: implement CLI blockchain features and pool hub enhancements 
CLI Blockchain Features:
- Added block operations: import, export, import-chain, blocks-range
- Added messaging system commands (deploy, state, topics, create-topic, messages, post, vote, search, reputation, moderate)
- Added network force-sync operation
- Replaced marketplace handlers with actual RPC calls
- Replaced AI handlers with actual RPC calls
- Added account operations (account get)
- Added transaction query operations
- Added mempool query operations
- Created keystore_auth.py for authentication
- Removed extended features interception
- All handlers use keystore credentials for authenticated endpoints

Pool Hub Enhancements:
- Added SLA monitoring and capacity tables
- Added billing integration service
- Added SLA collector service
- Added SLA router endpoints
- Updated pool hub models and settings
- Added integration tests for billing and SLA
- Updated documentation with SLA monitoring guide
2026-04-22 15:59:00 +02:00

166 lines
7.4 KiB
Markdown
Raw Blame History

# 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`](LICENSE) - Project license
- [`aitbc-cli`](aitbc-cli) - Main CLI symlink
- [`README.md`](README.md) - This file
### 📁 Core Directories
- [`aitbc/`](aitbc/) - Core AITBC Python package
- [`cli/`](cli/) - Command-line interface implementation
- [`contracts/`](contracts/) - Smart contracts
- [`scripts/`](scripts/) - Automation and deployment scripts
- [`services/`](services/) - Microservices
- [`tests/`](tests/) - Test suites
### 📁 Configuration
- [`project-config/`](project-config/) - Project configuration files
- [`pyproject.toml`](pyproject.toml) - Python project configuration
- [`requirements.txt`](requirements.txt) - Python dependencies
- [`poetry.lock`](poetry.lock) - Dependency lock file
- [`.gitignore`](.gitignore) - Git ignore rules
- [`.deployment_progress`](.deployment_progress) - Deployment tracking
### 📁 Documentation
- [`docs/`](docs/) - Comprehensive documentation
- [`README.md`](docs/README.md) - Main project documentation
- [`SETUP.md`](docs/SETUP.md) - Setup instructions
- [`PYTHON_VERSION_STATUS.md`](docs/PYTHON_VERSION_STATUS.md) - Python compatibility
- [`AITBC1_TEST_COMMANDS.md`](docs/AITBC1_TEST_COMMANDS.md) - Testing commands
- [`AITBC1_UPDATED_COMMANDS.md`](docs/AITBC1_UPDATED_COMMANDS.md) - Updated commands
- [`README_DOCUMENTATION.md`](docs/README_DOCUMENTATION.md) - Detailed documentation
### 📁 Development
- [`dev/`](dev/) - Development tools and examples
- [`.windsurf/`](.windsurf/) - IDE configuration
- [`packages/`](packages/) - Package distributions
- [`extensions/`](extensions/) - Browser extensions
- [`plugins/`](plugins/) - System plugins
### 📁 Infrastructure
- [`infra/`](infra/) - Infrastructure as code
- [`systemd/`](systemd/) - System service configurations
- [`monitoring/`](monitoring/) - Monitoring setup
### 📁 Applications
- [`apps/`](apps/) - Application components
- [`services/`](services/) - Service implementations
- [`website/`](website/) - Web interface
### 📁 AI & GPU
- [`gpu_acceleration/`](gpu_acceleration/) - GPU optimization
- [`ai-ml/`](ai-ml/) - AI/ML components
### 📁 Security & Backup
- [`security/`](security/) - Security reports and fixes
- [`backup-config/`](backup-config/) - Backup configurations
- [`backups/`](backups/) - Data backups
### 📁 Cache & Logs
- [`venv/`](venv/) - Python virtual environment
- [`logs/`](logs/) - Application logs
- `.mypy_cache/`, `.pytest_cache/`, `.ruff_cache/` - Tool caches
## Quick Start
```bash
# 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](docs/beginner/02_project/5_done.md) 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](docs/openclaw/guides/openclaw_cross_node_communication.md) - Implementation guide for multi-node agent messaging
- [Blockchain Synchronization Issues](docs/blockchain/blockchain_synchronization_issues_and_fixes.md) - Detailed documentation of sync fixes and workarounds
- [Cross-Node Training Module](docs/openclaw/training/cross_node_communication_training.md) - Training workflow for agent communication
- [OpenClaw Documentation](docs/openclaw/README.md) - Complete OpenClaw integration documentation
### Core Documentation
- [Main Documentation](docs/README.md) - Comprehensive project documentation
- [Setup Instructions](docs/SETUP.md) - Installation and configuration guide
- [Python Compatibility](docs/PYTHON_VERSION_STATUS.md) - Python version requirements
## Security
See `security/SECURITY_VULNERABILITY_REPORT.md` for security status.
## License
See `LICENSE` for licensing information.
Reference in New Issue View Git Blame Copy Permalink