dda703de10
✅ v0.2 Release Preparation: - Update version to 0.2.0 in pyproject.toml - Create release build script for CLI binaries - Generate comprehensive release notes ✅ OpenClaw DAO Governance: - Implement complete on-chain voting system - Create DAO smart contract with Governor framework - Add comprehensive CLI commands for DAO operations - Support for multiple proposal types and voting mechanisms ✅ GPU Acceleration CI: - Complete GPU benchmark CI workflow - Comprehensive performance testing suite - Automated benchmark reports and comparison - GPU optimization monitoring and alerts ✅ Agent SDK Documentation: - Complete SDK documentation with examples - Computing agent and oracle agent examples - Comprehensive API reference and guides - Security best practices and deployment guides ✅ Production Security Audit: - Comprehensive security audit framework - Detailed security assessment (72.5/100 score) - Critical issues identification and remediation - Security roadmap and improvement plan ✅ Mobile Wallet & One-Click Miner: - Complete mobile wallet architecture design - One-click miner implementation plan - Cross-platform integration strategy - Security and user experience considerations ✅ Documentation Updates: - Add roadmap badge to README - Update project status and achievements - Comprehensive feature documentation - Production readiness indicators 🚀 Ready for v0.2.0 release with agent-first architecture
8.2 KiB
8.2 KiB
Troubleshooting
Common issues and solutions for blockchain nodes using the enhanced AITBC CLI.
Enhanced CLI Diagnostics
The enhanced AITBC CLI provides comprehensive diagnostic tools:
# Full system diagnostics
aitbc blockchain diagnose --full
# Network diagnostics
aitbc blockchain diagnose --network
# Sync diagnostics
aitbc blockchain diagnose --sync
# Performance diagnostics
aitbc blockchain diagnose --performance
# Startup diagnostics
aitbc blockchain diagnose --startup
Common Issues
Node Won't Start
# Enhanced CLI diagnostics
aitbc blockchain diagnose --startup
# Check configuration
aitbc blockchain config validate
# View detailed logs
aitbc blockchain logs --level error --follow
# Check port usage
aitbc blockchain diagnose --network
# Common causes:
# - Port already in use
# - Corrupted database
# - Invalid configuration
Solutions:
# Enhanced CLI port check
aitbc blockchain diagnose --network --check-ports
# Kill existing process (if needed)
sudo lsof -i :8080
sudo kill $(sudo lsof -t -i :8080)
# Reset database with enhanced CLI
aitbc blockchain reset --hard
# Validate and fix configuration
aitbc blockchain config validate
aitbc blockchain config fix
# Legacy approach
tail -f ~/.aitbc/logs/chain.log
rm -rf ~/.aitbc/data/chain.db
aitbc-chain init
Sync Stuck
# Enhanced CLI sync diagnostics
aitbc blockchain diagnose --sync
# Check sync status with details
aitbc blockchain sync --verbose
# Force resync
aitbc blockchain sync --force
# Check peer connectivity
aitbc blockchain peers --status connected
# Network health check
aitbc blockchain diagnose --network
# Monitor sync progress
aitbc blockchain sync --watch
Solutions:
# Enhanced CLI peer management
aitbc blockchain peers add --peer <MULTIADDR> --validate
# Add more bootstrap peers
aitbc blockchain peers add --bootstrap /dns4/new-peer.example.com/tcp/7070/p2p/...
# Clear peer database
aitbc blockchain peers clear
# Reset and resync
aitbc blockchain reset --sync
aitbc blockchain sync --force
# Check network connectivity
aitbc blockchain test-connectivity
High CPU/Memory Usage
# Enhanced CLI performance diagnostics
aitbc blockchain diagnose --performance
# Monitor resource usage
aitbc blockchain metrics --resource --follow
# Check for bottlenecks
aitbc blockchain metrics --detailed
# Historical performance data
aitbc blockchain metrics --history 24h
Solutions:
# Optimize configuration
aitbc blockchain config set max_peers 50
aitbc blockchain config set cache_size 1GB
# Enable performance mode
aitbc blockchain optimize --performance
# Monitor improvements
aitbc blockchain metrics --resource --follow
Peer Connection Issues
# Enhanced CLI peer diagnostics
aitbc blockchain diagnose --network
# Check peer status
aitbc blockchain peers --detailed
# Test connectivity
aitbc blockchain test-connectivity
# Network diagnostics
aitbc blockchain diagnose --network --full
Solutions:
# Add reliable peers
aitbc blockchain peers add --bootstrap <MULTIADDR>
# Update peer configuration
aitbc blockchain config set bootstrap_nodes <NODES>
# Reset peer database
aitbc blockchain peers reset
# Check firewall settings
aitbc blockchain diagnose --network --firewall
Validator Issues
# Enhanced CLI validator diagnostics
aitbc blockchain validators --diagnose
# Check validator status
aitbc blockchain validators --status active
# Validator rewards tracking
aitbc blockchain validators --rewards
# Performance metrics
aitbc blockchain validators --metrics
Solutions:
# Re-register as validator
aitbc blockchain validators register --stake 1000
# Check stake requirements
aitbc blockchain validators --requirements
# Monitor validator performance
aitbc blockchain validators --monitor
Advanced Troubleshooting
Database Corruption
# Enhanced CLI database diagnostics
aitbc blockchain diagnose --database
# Database integrity check
aitbc blockchain database check
# Repair database
aitbc blockchain database repair
# Rebuild database
aitbc blockchain database rebuild
Configuration Issues
# Enhanced CLI configuration diagnostics
aitbc blockchain config diagnose
# Validate configuration
aitbc blockchain config validate
# Reset to defaults
aitbc blockchain config reset
# Generate new configuration
aitbc blockchain config generate
Network Issues
# Enhanced CLI network diagnostics
aitbc blockchain diagnose --network --full
# Test all network endpoints
aitbc blockchain test-connectivity --all
# Check DNS resolution
aitbc blockchain diagnose --network --dns
# Firewall diagnostics
aitbc blockchain diagnose --network --firewall
Monitoring and Alerting
Real-time Monitoring
# Enhanced CLI monitoring
aitbc monitor dashboard --component blockchain
# Set up alerts
aitbc monitor alerts create --type blockchain_sync --threshold 90%
# Resource monitoring
aitbc blockchain metrics --resource --follow
# Export metrics
aitbc blockchain metrics --export prometheus
Log Analysis
# Enhanced CLI log analysis
aitbc blockchain logs --analyze --level error
# Export logs for analysis
aitbc blockchain logs --export /tmp/blockchain-logs.json --format json
# Filter by time range
aitbc blockchain logs --since "1 hour ago" --level error
# Real-time log monitoring
aitbc blockchain logs --follow --level warn
Recovery Procedures
Complete Node Recovery
# Enhanced CLI recovery sequence
aitbc blockchain backup --emergency
# Stop node safely
aitbc blockchain node stop --force
# Reset everything
aitbc blockchain reset --hard
# Restore from backup
aitbc blockchain restore --input /backup/emergency-backup.tar.gz --verify
# Start node
aitbc blockchain node start
# Monitor recovery
aitbc blockchain sync --watch
Emergency Procedures
# Emergency stop
aitbc blockchain node stop --emergency
# Emergency backup
aitbc blockchain backup --emergency --compress
# Emergency reset
aitbc blockchain reset --emergency
# Emergency recovery
aitbc blockchain recover --from-backup /backup/emergency.tar.gz
Best Practices
Prevention
- Regular monitoring with enhanced CLI tools
- Automated backups using enhanced backup options
- Configuration validation before changes
- Performance monitoring for early detection
- Network diagnostics for connectivity issues
Maintenance
- Weekly diagnostics with
aitbc blockchain diagnose --full - Monthly backups with verification
- Quarterly performance reviews
- Configuration audits
- Security scans
Troubleshooting Workflow
- Run diagnostics:
aitbc blockchain diagnose --full - Check logs:
aitbc blockchain logs --level error --follow - Verify configuration:
aitbc blockchain config validate - Test connectivity:
aitbc blockchain test-connectivity - Apply fixes: Use enhanced CLI commands
- Monitor recovery:
aitbc blockchain status --watch
Integration with Support
Export Diagnostic Data
# Export full diagnostic report
aitbc blockchain diagnose --full --export /tmp/diagnostic-report.json
# Export logs for support
aitbc blockchain logs --export /tmp/support-logs.tar.gz --compress
# Export configuration
aitbc blockchain config export --output /tmp/config-backup.yaml
Support Commands
# Generate support bundle
aitbc blockchain support-bundle --output /tmp/support-bundle.tar.gz
# System information
aitbc blockchain system-info --export /tmp/system-info.json
# Performance report
aitbc blockchain metrics --report --output /tmp/performance-report.json
Legacy Command Equivalents
For users transitioning from legacy commands:
# Old → New
tail -f ~/.aitbc/logs/chain.log → aitbc blockchain logs --follow
aitbc-chain validate-config → aitbc blockchain config validate
aitbc-chain reset --hard → aitbc blockchain reset --hard
aitbc-chain p2p connections → aitbc blockchain peers --status connected
Next
- Operations — Day-to-day operations
- Configuration — Node configuration
- Enhanced CLI — Complete CLI reference
- Monitoring — Monitoring and alerting