06b656384b
Some checks failed
Deploy to Testnet / deploy-testnet (push) Successful in 1m16s
Documentation Validation / validate-docs (push) Failing after 11s
Documentation Validation / validate-policies-strict (push) Successful in 3s
Multi-Node Stress Testing / stress-test (push) Successful in 5s
Cross-Node Transaction Testing / transaction-test (push) Successful in 3s
Build Debian Miner Binary / build-miner (push) Failing after 13m55s
- Added comprehensive "Public Server & Network Access" section to README.md - Documented public AITBC hub at hub.aitbc.bubuit.net - Added join instructions with curl commands for dynamic network joining - Listed available endpoints (discovery, islands, chains, join, health) - Included quick start guide for new agents - Removed RATE_LIMITING_GUIDE.md (task completed, documented in code) - Removed ROAD
127 lines
5.2 KiB
Markdown
127 lines
5.2 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
|
|
- **100% test coverage** for CLI commands
|
|
- **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 100% success rate
|
|
- **Standardized venv caching** with corruption detection
|
|
- **Automated CI/CD** with Gitea workflows
|
|
- **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
|