oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 21 Packages Projects Releases Wiki Activity
Files
d1f3d3ca97cbcd499070319bc791d9a64df4f0cb
aitbc/docs/blockchain/3_operations.md
aitbc 19d415a235
Some checks failed
Blockchain Synchronization Verification / sync-verification (push) Failing after 3s
Details
CLI Tests / test-cli (push) Failing after 3s
Details
Cross-Chain Functionality Tests / test-cross-chain-sync (push) Successful in 2s
Details
Cross-Chain Functionality Tests / test-cross-chain-transactions (push) Successful in 3s
Details
Cross-Chain Functionality Tests / test-cross-chain-bridge (push) Has been skipped
Details
Cross-Chain Functionality Tests / test-multi-chain-consensus (push) Successful in 2s
Details
Cross-Chain Functionality Tests / aggregate-results (push) Has been skipped
Details
Deploy to Testnet / deploy-testnet (push) Successful in 1m12s
Details
Documentation Validation / validate-docs (push) Failing after 8s
Details
Documentation Validation / validate-policies-strict (push) Successful in 3s
Details
Integration Tests / test-service-integration (push) Successful in 2m6s
Details
Multi-Chain Island Architecture Tests / test-multi-chain-island (push) Successful in 2s
Details
Multi-Node Blockchain Health Monitoring / health-check (push) Failing after 4s
Details
P2P Network Verification / p2p-verification (push) Successful in 4s
Details
Package Tests / Python package - aitbc-agent-sdk (push) Successful in 32s
Details
Package Tests / Python package - aitbc-core (push) Successful in 14s
Details
Package Tests / Python package - aitbc-crypto (push) Successful in 12s
Details
Package Tests / Python package - aitbc-sdk (push) Successful in 9s
Details
Package Tests / JavaScript package - aitbc-sdk-js (push) Successful in 8s
Details
Package Tests / JavaScript package - aitbc-token (push) Successful in 17s
Details
Python Tests / test-python (push) Successful in 15s
Details
Security Scanning / security-scan (push) Successful in 27s
Details
Node Failover Simulation / failover-test (push) Successful in 7s
Details
Multi-Node Stress Testing / stress-test (push) Successful in 6s
Details
Cross-Node Transaction Testing / transaction-test (push) Successful in 4s
Details
feat: add SQLCipher database encryption support and consolidate agent documentation 
- Add SQLCipher encryption for ait-mainnet database with configurable flag
- Add db_encryption_enabled and db_encryption_key_path config settings
- Implement encryption key loading and PRAGMA key setup via connection events
- Add shutdown_db function for proper database cleanup
- Export middleware classes in aitbc/__init__.py
- Fix import path in sync.py for settings
- Remove duplicate agent documentation from docs
2026-05-03 12:00:38 +02:00

6.6 KiB
Raw Blame History

Node Operations

Day-to-day operations for blockchain nodes using the enhanced AITBC CLI.

Enhanced CLI Blockchain Commands

The enhanced AITBC CLI provides comprehensive blockchain management capabilities:

# Blockchain status and synchronization
aitbc blockchain status
aitbc blockchain sync
aitbc blockchain info

# Network information
aitbc blockchain peers
aitbc blockchain blocks --limit 10
aitbc blockchain validators

# Transaction operations
aitbc blockchain transaction <TX_ID>

Starting the Node

# Enhanced CLI node management
aitbc blockchain node start

# Start with custom configuration
aitbc blockchain node start --config /path/to/config.yaml

# Start as daemon
aitbc blockchain node start --daemon

# Legacy commands (still supported)
aitbc-chain start
aitbc-chain start --daemon

Stopping the Node

# Enhanced CLI graceful shutdown
aitbc blockchain node stop

# Force stop
aitbc blockchain node stop --force

# Legacy commands
aitbc-chain stop
aitbc-chain stop --force

Node Status

# Enhanced CLI status with more details
aitbc blockchain status

# Detailed node information
aitbc blockchain info

# Network status
aitbc blockchain peers

# Legacy command
aitbc-chain status

Shows:

  • Block height
  • Peers connected
  • Mempool size
  • Last block time
  • Network health
  • Validator status

Checking Sync Status

# Enhanced CLI sync status
aitbc blockchain sync

# Detailed sync information
aitbc blockchain sync --verbose

# Progress monitoring
aitbc blockchain sync --watch

# Legacy command
aitbc-chain sync-status

Shows:

  • Current height
  • Target height
  • Sync progress percentage
  • Estimated time to sync
  • Network difficulty
  • Block production rate

Managing Peers

List Peers

# Enhanced CLI peer management
aitbc blockchain peers

# Detailed peer information
aitbc blockchain peers --detailed

# Filter by status
aitbc blockchain peers --status connected

# Legacy command
aitbc-chain peers list

Add Peer

# Enhanced CLI peer addition
aitbc blockchain peers add /dns4/new-node.example.com/tcp/7070/p2p/...

# Add with validation
aitbc blockchain peers add --peer <MULTIADDR> --validate

# Legacy command
aitbc-chain peers add /dns4/new-node.example.com/tcp/7070/p2p/...

Remove Peer

# Enhanced CLI peer removal
aitbc blockchain peers remove <PEER_ID>

# Remove with confirmation
aitbc blockchain peers remove <PEER_ID> --confirm

# Legacy command
aitbc-chain peers remove <PEER_ID>

Validator Operations

# Enhanced CLI validator management
aitbc blockchain validators

# Validator status
aitbc blockchain validators --status active

# Validator rewards
aitbc blockchain validators --rewards

# Become a validator
aitbc blockchain validators register --stake 1000

# Legacy equivalent
aitbc-validator status

Backup & Restore

Backup Data

# Enhanced CLI backup with more options
aitbc blockchain backup --output /backup/chain-backup.tar.gz

# Compressed backup
aitbc blockchain backup --compress --output /backup/chain-backup.tar.gz

# Incremental backup
aitbc blockchain backup --incremental --output /backup/incremental.tar.gz

# Legacy command
aitbc-chain backup --output /backup/chain-backup.tar.gz

Restore Data

# Enhanced CLI restore with validation
aitbc blockchain restore --input /backup/chain-backup.tar.gz

# Restore with verification
aitbc blockchain restore --input /backup/chain-backup.tar.gz --verify

# Legacy command
aitbc-chain restore --input /backup/chain-backup.tar.gz

Log Management

# Enhanced CLI log management
aitbc blockchain logs --tail 100

# Filter by level and component
aitbc blockchain logs --level error --component consensus

# Real-time monitoring
aitbc blockchain logs --follow

# Export logs with formatting
aitbc blockchain logs --export /var/log/aitbc-chain.log --format json

# Legacy commands
aitbc-chain logs --tail 100
aitbc-chain logs --level error

Advanced Operations

Network Diagnostics

# Enhanced CLI network diagnostics
aitbc blockchain diagnose --network

# Full system diagnostics
aitbc blockchain diagnose --full

# Connectivity test
aitbc blockchain test-connectivity

Performance Monitoring

# Enhanced CLI performance metrics
aitbc blockchain metrics

# Resource usage
aitbc blockchain metrics --resource

# Historical performance
aitbc blockchain metrics --history 24h

Configuration Management

# Enhanced CLI configuration
aitbc blockchain config show

# Update configuration
aitbc blockchain config set key value

# Validate configuration
aitbc blockchain config validate

# Reset to defaults
aitbc blockchain config reset

Troubleshooting with Enhanced CLI

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

# Reset database if needed
aitbc blockchain reset --hard

Sync Issues

# Enhanced CLI sync diagnostics
aitbc blockchain diagnose --sync

# Force resync
aitbc blockchain sync --force

# Check peer connectivity
aitbc blockchain peers --status connected

# Network health check
aitbc blockchain diagnose --network

Performance Issues

# Enhanced CLI performance analysis
aitbc blockchain metrics --detailed

# Resource monitoring
aitbc blockchain metrics --resource --follow

# Bottleneck analysis
aitbc blockchain diagnose --performance

Integration with Monitoring

# Enhanced CLI monitoring integration
aitbc monitor dashboard --component blockchain

# Set up alerts
aitbc monitor alerts create --type blockchain_sync --threshold 90%

# Export metrics for Prometheus
aitbc blockchain metrics --export prometheus

Best Practices

  1. Use enhanced CLI commands for better functionality
  2. Monitor regularly with aitbc blockchain status
  3. Backup frequently using enhanced backup options
  4. Validate configuration before starting node
  5. Use diagnostic tools for troubleshooting
  6. Integrate with monitoring for production deployments

Migration from Legacy Commands

If you're migrating from legacy commands:

# Old → New
aitbc-chain start → aitbc blockchain node start
aitbc-chain status → aitbc blockchain status
aitbc-chain peers list → aitbc blockchain peers
aitbc-chain backup → aitbc blockchain backup

Next