oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 7 Packages Projects Releases Wiki Activity
Files
1ee2238cc8a09fc87ef424667f2e0ba4e104400e
aitbc/docs/beginner/05_cli/README.md
AITBC System 1ee2238cc8 feat: implement complete OpenClaw DAO governance system 
🏛️ OpenClawDAO Smart Contract Implementation:

Core Governance Contract:
- Enhanced OpenClawDAO with snapshot security and anti-flash-loan protection
- Token-weighted voting with 24-hour TWAS calculation
- Multi-sig protection for critical proposals (emergency/protocol upgrades)
- Agent swarm role integration (Provider/Consumer/Builder/Coordinator)
- Proposal types: Parameter Change, Protocol Upgrade, Treasury, Emergency, Agent Trading, DAO Grants
- Maximum voting power limits (5% per address) and vesting periods

Security Features:
- Snapshot-based voting power capture prevents flash-loan manipulation
- Proposal bonds and challenge mechanisms for proposal validation
- Multi-signature requirements for critical governance actions
- Reputation-based voting weight enhancement for agents
- Emergency pause and recovery mechanisms

Agent Wallet Contract:
- Autonomous agent voting with configurable strategies
- Role-specific voting preferences based on agent type
- Reputation-based voting power bonuses
- Authorized caller management for agent control
- Emergency stop and reactivate functionality
- Autonomous vote execution based on predefined strategies

GPU Staking Contract:
- GPU resource staking with AITBC token collateral
- Reputation-based reward rate calculations
- Utilization-based reward scaling
- Lock period enforcement with flexible durations
- Provider reputation tracking and updates
- Multi-pool support with different reward rates

Deployment & Testing:
- Complete deployment script with system configuration
- Comprehensive test suite covering all major functionality
- Multi-sig setup and initial agent registration
- Snapshot creation and staking pool initialization
- Test report generation with detailed results

🔐 Security Implementation:
- Anti-flash-loan protection through snapshot voting
- Multi-layer security (proposal bonds, challenges, multi-sig)
- Reputation-based access control and voting enhancement
- Emergency mechanisms for system recovery
- Comprehensive input validation and access controls

📊 Governance Features:
- 6 proposal types covering all governance scenarios
- 4 agent swarm roles with specialized voting preferences
- Token-weighted voting with reputation bonuses
- 7-day voting period with 1-day delay
- 4% quorum requirement and 1000 AITBC proposal threshold

🚀 Ready for deployment and integration with AITBC ecosystem
2026-03-18 20:32:44 +01:00

267 lines
7.1 KiB
Markdown
Raw Blame History

# AITBC CLI Documentation
**Complete Command Line Interface Reference with Testing Integration**
## 📊 **CLI Status: 100% Complete**
### ✅ **Test Results**
- **Total Tests**: 67 tests
- **Tests Passed**: 67/67 (100%)
- **Commands Working**: All 50+ CLI command groups operational
- **Integration**: Full service integration
- **Error Handling**: Comprehensive error management
## 🚀 **Quick Start**
### Installation and Setup
```bash
# Load development environment
source /opt/aitbc/.env.dev
# Test CLI installation
aitbc --help
aitbc version
```
### Basic Operations
```bash
# Wallet operations
aitbc wallet create
aitbc wallet list
aitbc wallet balance
# Exchange operations
aitbc exchange register --name "Binance" --api-key <key>
aitbc exchange create-pair AITBC/BTC
aitbc exchange start-trading --pair AITBC/BTC
# AI Trading & Analytics
aitbc ai-trading start --strategy mean_reversion
aitbc advanced-analytics dashboard
aitbc ai-surveillance start
# Multi-Chain Operations
aitbc chain list
aitbc wallet --use-daemon chain balance
# Service management
aitbc-services status
aitbc-services restart
```
## 📋 **Available Command Groups (50+)**
### **🔗 Blockchain & Core**
- `blockchain` - Blockchain node operations
- `wallet` - Wallet management
- `chain` - Multi-chain operations
- `cross-chain` - Cross-chain transactions
- `multisig` - Multi-signature operations
### **💰 Exchange & Trading**
- `exchange` - Exchange integration and trading
- `ai-trading` - AI-powered trading engine
- `marketplace` - Marketplace operations
- `market-maker` - Market making operations
- `oracle` - Price discovery and oracles
### **🤖 AI & Analytics**
- `ai-surveillance` - AI-powered surveillance (NEW)
- `advanced-analytics` - Advanced analytics platform
- `ai` - General AI operations
- `analytics` - Basic analytics
- `predictive-intelligence` - Predictive analytics
### **🔒 Security & Compliance**
- `compliance` - KYC/AML compliance
- `surveillance` - Trading surveillance
- `regulatory` - Regulatory reporting
- `security-test` - Security testing
- `genesis-protection` - Genesis protection
### **⚙️ System & Infrastructure**
- `admin` - Administrative operations
- `deployment` - Deployment management
- `monitor` - System monitoring
- `performance-test` - Performance testing
- `production-deploy` - Production deployment
### **🏗️ Development & Testing**
- `test-cli` - CLI testing
- `simulate` - Simulation operations
- `optimize` - System optimization
- `config` - Configuration management
### **🌐 Network & Services**
- `node` - Node management
- `miner` - Mining operations
- `client` - Client operations
- `explorer` - Blockchain explorer
- `dao` - DAO operations
### **🔌 Plugins & Extensions**
- `plugin-registry` - Plugin registry
- `plugin-marketplace` - Plugin marketplace
- `plugin-analytics` - Plugin analytics
- `plugin-security` - Plugin security
### **🌍 Global & Multi-Region**
- `global-infrastructure` - Global infrastructure
- `global-ai-agents` - Global AI agents
- `multi-region-load-balancer` - Multi-region load balancing
### **🎯 Agents & Coordination**
- `agent` - Agent operations
- `agent-comm` - Agent communication
- `swarm` - Swarm intelligence
- `agent-protocols` - Agent protocols
- `wallet history` - Transaction history
- `wallet backup` - Backup wallet
- `wallet restore` - Restore wallet
### **Exchange Commands**
- `exchange register` - Register with exchange
- `exchange create-pair` - Create trading pair
- `exchange start-trading` - Start trading
- `exchange stop-trading` - Stop trading
- `exchange status` - Exchange status
- `exchange balances` - Exchange balances
### **Blockchain Commands**
- `blockchain info` - Blockchain information
- `blockchain status` - Node status
- `blockchain blocks` - List blocks
- `blockchain balance` - Check balance
- `blockchain peers` - Network peers
- `blockchain transaction` - Transaction details
### **Config Commands**
- `config show` - Show configuration
- `config get <key>` - Get config value
- `config set <key> <value>` - Set config value
- `config edit` - Edit configuration
- `config validate` - Validate configuration
### **Compliance Commands**
- `compliance list-providers` - List KYC providers
- `compliance kyc-submit` - Submit KYC verification
- `compliance kyc-status` - Check KYC status
- `compliance aml-screen` - AML screening
- `compliance full-check` - Full compliance check
## 🧪 **Testing**
### Test Coverage
```bash
# Run comprehensive CLI tests
cd /opt/aitbc/cli/tests
python3 comprehensive_tests.py
# Run group-specific tests
python3 group_tests.py
# Run level-based tests
python3 run_simple_tests.py
```
### Test Results Summary
- **Level 1 (Basic)**: 7/7 tests passing (100%)
- **Level 2 (Compliance)**: 5/5 tests passing (100%)
- **Level 3 (Wallet)**: 5/5 tests passing (100%)
- **Level 4 (Blockchain)**: 5/5 tests passing (100%)
- **Level 5 (Config)**: 5/5 tests passing (100%)
- **Level 6 (Integration)**: 5/5 tests passing (100%)
- **Level 7 (Error Handling)**: 4/4 tests passing (100%)
**Group Tests**:
- **Wallet Group**: 9/9 tests passing (100%)
- **Blockchain Group**: 8/8 tests passing (100%)
- **Config Group**: 8/8 tests passing (100%)
- **Compliance Group**: 6/6 tests passing (100%)
## 🔧 **Development Environment**
### Permission Setup
```bash
# Fix permissions (no sudo prompts)
/opt/aitbc/scripts/fix-permissions.sh
# Test permission setup
/opt/aitbc/scripts/test-permissions.sh
```
### Environment Variables
```bash
# Load development environment
source /opt/aitbc/.env.dev
# Available aliases
aitbc-services # Service management
aitbc-fix # Quick permission fix
aitbc-logs # View logs
```
## 🛠️ **Advanced Usage**
### Global Options
```bash
# Output formats
aitbc --output json wallet balance
aitbc --output yaml blockchain info
# Debug mode
aitbc --debug wallet list
# Test mode
aitbc --test-mode exchange status
# Custom configuration
aitbc --config-file /path/to/config wallet list
```
### Service Integration
```bash
# Custom API endpoint
aitbc --url http://localhost:8000 blockchain status
# Custom API key
aitbc --api-key <key> exchange register --name "Exchange"
# Timeout configuration
aitbc --timeout 60 blockchain info
```
## 🔍 **Troubleshooting**
### Common Issues
1. **Permission Denied**: Run `/opt/aitbc/scripts/fix-permissions.sh`
2. **Service Not Running**: Use `aitbc-services status` to check
3. **Command Not Found**: Ensure CLI is installed and in PATH
4. **API Connection Issues**: Check service endpoints with `aitbc --debug`
### Debug Mode
```bash
# Enable debug output
aitbc --debug <command>
# Check configuration
aitbc config show
# Test service connectivity
aitbc --test-mode blockchain status
```
## 📚 **Additional Resources**
- [Testing Procedures](./testing.md) - Detailed testing documentation
- [Permission Setup](./permission-setup.md) - Development environment configuration
- [Service Management](../8_development/) - Service operation guides
- [Exchange Integration](../19_marketplace/) - Exchange and trading documentation
---
**Last Updated**: March 8, 2026
**CLI Version**: 0.1.0
**Test Coverage**: 67/67 tests passing (100%)
**Infrastructure**: Complete
Reference in New Issue View Git Blame Copy Permalink