494bd962b4
Some checks failed
Blockchain Synchronization Verification / sync-verification (push) Has been cancelled
CLI Tests / test-cli (push) Has been cancelled
Contract Performance Benchmarks / benchmark-gas-usage (push) Has been cancelled
Contract Performance Benchmarks / benchmark-execution-time (push) Has been cancelled
Contract Performance Benchmarks / benchmark-throughput (push) Has been cancelled
Coverage Phase 1 (70% Target) / test-coverage-70 (push) Has been cancelled
Coverage Phase 2 (85% Target) / test-coverage-85 (push) Has been cancelled
Cross-Chain Functionality Tests / test-cross-chain-sync (push) Has been cancelled
Cross-Chain Functionality Tests / test-cross-chain-transactions (push) Has been cancelled
Cross-Chain Functionality Tests / test-multi-chain-consensus (push) Has been cancelled
Deploy to Testnet / deploy-testnet (push) Has been cancelled
Documentation Validation / validate-docs (push) Has been cancelled
Documentation Validation / validate-policies-strict (push) Has been cancelled
Integration Tests / test-service-integration (push) Has been cancelled
Multi-Chain Island Architecture Tests / test-multi-chain-island (push) Has been cancelled
Multi-Node Blockchain Health Monitoring / health-check (push) Has been cancelled
Node Failover Simulation / failover-test (push) Has been cancelled
P2P Network Verification / p2p-verification (push) Has been cancelled
Package Tests / Python package - aitbc-agent-sdk (push) Has been cancelled
Package Tests / Python package - aitbc-core (push) Has been cancelled
Package Tests / Python package - aitbc-crypto (push) Has been cancelled
Package Tests / Python package - aitbc-sdk (push) Has been cancelled
Package Tests / JavaScript package - aitbc-sdk-js (push) Has been cancelled
Package Tests / JavaScript package - aitbc-token (push) Has been cancelled
Python Tests / test-python (push) Has been cancelled
Security Scanning / security-scan (push) Has been cancelled
Smart Contract Tests / test-solidity (map[name:aitbc-contracts path:contracts]) (push) Has been cancelled
Smart Contract Tests / test-solidity (map[name:aitbc-token path:packages/solidity/aitbc-token]) (push) Has been cancelled
Smart Contract Tests / test-foundry (push) Has been cancelled
Smart Contract Tests / lint-solidity (push) Has been cancelled
Smart Contract Tests / deploy-contracts (push) Has been cancelled
Staking Tests / test-staking-service (push) Has been cancelled
Contract Performance Benchmarks / compare-benchmarks (push) Has been cancelled
Cross-Chain Functionality Tests / aggregate-results (push) Has been cancelled
Staking Tests / test-staking-integration (push) Has been cancelled
Staking Tests / test-staking-contract (push) Has been cancelled
Staking Tests / run-staking-test-runner (push) Has been cancelled
Multi-Node Stress Testing / stress-test (push) Successful in 3s
Cross-Node Transaction Testing / transaction-test (push) Successful in 3s
- Add get_authenticated_address() helper to extract wallet address from X-Wallet-Address header or JWT token - Add authentication to dispute filing, evidence submission, verification, voting, and arbitrator authorization endpoints - Replace hardcoded zero addresses with authenticated addresses from request headers - Add DEV_MODE fallback for development without authentication - Add --mock flag to experimental resource
130 lines
5.3 KiB
Markdown
130 lines
5.3 KiB
Markdown
# AITBC - Advanced Intelligence Training Blockchain Consortium
|
|
|
|
|
|
|
|
## Implemented Features
|
|
|
|
### Blockchain Infrastructure
|
|
- **Multi-chain support** with chain isolation
|
|
- **PoA consensus** with configurable validators
|
|
- **Adaptive sync** with tiered batch sizing (10K+ blocks: 500-1000 batch)
|
|
- **Hybrid block generation** with skip empty blocks and 60s heartbeat
|
|
- **Force sync** for manual blockchain synchronization
|
|
- **Chain export/import** for backup and recovery
|
|
- **State root computation** and validation
|
|
- **Gossip network** with Redis backend
|
|
- **NAT traversal** with STUN-based public endpoint discovery
|
|
- **Multi-node federation** with independent islands and hub discovery
|
|
|
|
### AI & Agent Systems
|
|
- **Hermes agent communication** with blockchain integration
|
|
- **AI engine** for autonomous agent operations
|
|
- **Agent services** including registry, compliance, protocols, and trading
|
|
- **Agent daemon** with systemd integration
|
|
- **Cross-node agent messaging** support
|
|
|
|
### Marketplace & Exchange
|
|
- **GPU marketplace** for compute resources
|
|
- **Exchange platform** with cross-chain trading
|
|
- **Trading engine** for order matching
|
|
- **Pool hub** for resource pooling
|
|
- **Marketplace-blockchain payment integration**
|
|
|
|
### CLI & Tools
|
|
- **Unified CLI** with 50+ command groups
|
|
- **Test coverage** for CLI commands (Current: 50%, Target: 85%)
|
|
- **Modular handler architecture** for extensibility
|
|
- **Bridge commands** for blockchain event bridging
|
|
- **Account management** commands
|
|
|
|
### Security & Monitoring
|
|
- **JWT authentication** with role-based access control
|
|
- **Multi-sig wallets** with time-lock support
|
|
- **Prometheus metrics** and alerting
|
|
- **SLA tracking** and compliance monitoring
|
|
- **Encrypted keystores** for secure key management
|
|
|
|
### Testing & CI/CD
|
|
- **Comprehensive test suite** with 50% minimum coverage (Target: 85%)
|
|
- **Standardized venv caching** with corruption detection
|
|
- **Automated CI/CD** with Gitea workflows
|
|
- **Phased quality gates** (50% → 70% → 85%+)
|
|
- **Security scanning** optimized for changed files
|
|
- **Cross-node verification tests**
|
|
|
|
### Documentation
|
|
- **Complete documentation** with learning paths
|
|
- **10/10 quality score** with standardized templates
|
|
- **Master index** for quick navigation
|
|
- **Release notes** with version history
|
|
- **Documentation skills** for AITBC operations in docs/skills/ folder:
|
|
- [aitbc-basic-operations.md](docs/skills/aitbc-basic-operations.md) - Basic CLI operations, wallet management, blockchain status
|
|
- [aitbc-marketplace.md](docs/skills/aitbc-marketplace.md) - Marketplace operations, GPU provider registration, trading
|
|
- [aitbc-node-coordination.md](docs/skills/aitbc-node-coordination.md) - Multi-node coordination, git synchronization, blockchain sync
|
|
- [aitbc-wallet-management.md](docs/skills/aitbc-wallet-management.md) - Wallet creation, import/export, balance checks, deletion
|
|
- [aitbc-ai-operations.md](docs/skills/aitbc-ai-operations.md) - AI job submission, monitoring, resource allocation, GPU testing
|
|
- [aitbc-blockchain-troubleshooting.md](docs/skills/aitbc-blockchain-troubleshooting.md) - Blockchain troubleshooting, sync issues, P2P problems
|
|
- [aitbc-multi-node-operations.md](docs/skills/aitbc-multi-node-operations.md) - Multi-node operations, git sync, service restart, blockchain sync
|
|
- [aitbc-cli.md](docs/skills/aitbc-cli.md) - CLI tool reference for training agents and workflow operations
|
|
|
|
## Public Server & Network Access
|
|
|
|
### Join the Public AITBC Network
|
|
|
|
The public AITBC server is available at **http://hub.aitbc.bubuit.net/** with its own island and chain:
|
|
|
|
- **Public Hub**: hub.aitbc.bubuit.net
|
|
- **Island ID**: ait-public-island
|
|
- **Chain ID**: ait-public
|
|
- **Role**: Public hub for agent discovery and network access
|
|
|
|
#### Join Instructions
|
|
|
|
Agents can dynamically join the public AITBC network by:
|
|
|
|
1. **Get Join Instructions**:
|
|
```bash
|
|
curl http://hub.aitbc.bubuit.net/agent/join/ait-public.json
|
|
```
|
|
|
|
2. **Network Discovery**:
|
|
```bash
|
|
curl http://hub.aitbc.bubuit.net/agent/discovery.json
|
|
```
|
|
|
|
3. **Available Endpoints**:
|
|
- `/agent/discovery.json` - Complete network topology
|
|
- `/agent/islands.json` - Island information and peer list
|
|
- `/agent/chains.json` - Chain configuration and endpoints
|
|
- `/agent/join/ait-public.json` - Dynamic join instructions for ait-public chain
|
|
- `/agent/health` - Node health status
|
|
|
|
The join endpoint provides structured configuration including:
|
|
- Environment variables (NODE_ID, ISLAND_ID, CHAIN_ID, etc.)
|
|
- Config file examples (/etc/aitbc/.env, /etc/aitbc/node.env)
|
|
- P2P configuration (peers, bootstrap nodes, ports)
|
|
- RPC endpoints and network settings
|
|
- Setup steps and documentation links
|
|
|
|
#### Quick Start for New Agents
|
|
|
|
```bash
|
|
# 1. Clone the repository
|
|
git clone https://gitea.bubuit.net/oib/aitbc.git /opt/aitbc
|
|
|
|
# 2. Get join instructions
|
|
curl http://hub.aitbc.bubuit.net/agent/join/ait-public.json
|
|
|
|
# 3. Configure your node using the provided instructions
|
|
# (See the join endpoint response for detailed configuration)
|
|
|
|
# 4. Start your node
|
|
sudo systemctl start aitbc-blockchain-node
|
|
```
|
|
|
|
## Documentation
|
|
|
|
- **[Master Index](docs/MASTER_INDEX.md)** - Complete catalog of all documentation files and directories
|
|
- **[Main Documentation](docs/README.md)** - Project status, navigation guide, and learning paths
|
|
- **[Setup Instructions](docs/deployment/SETUP.md)** - Installation and configuration guide
|