🚀 Advanced Operations:
• Enterprise CLI usage examples with batch processing, mining, marketplace, AI services
• Multi-node expansion procedures for horizontal scaling
• Performance optimization and monitoring commands
🔧 Configuration Management:
• Production environment configuration procedures
• Service optimization with systemd overrides
• Environment variable management for production
📊 Monitoring and Alerting:
• Comprehensive health check automation with cron scheduling
• Log management with logrotate configuration
• Real-time log monitoring for critical errors
🔒 Security Hardening:
• Network security with firewall and SSH hardening
• SSL/TLS configuration for RPC endpoints
• Access control with dedicated user and sudo rules
📈 Scaling and Growth:
• Horizontal scaling with automated node provisioning
• Load balancing with HAProxy configuration
• Performance tuning and optimization scripts
🧪 Testing and Validation:
• Load testing with Locust framework
• Integration testing suite for all components
• Automated testing procedures
📚 Documentation and Training:
• API documentation generation with Sphinx
• Operator training materials and guides
• Knowledge base for ongoing support
🎯 Production Readiness:
• Comprehensive pre-production checklist
• Maintenance automation with scheduled tasks
• Performance optimization procedures
🔄 Continuous Improvement:
• Weekly maintenance automation
• Performance tuning scripts
• Ongoing optimization procedures
The workflow now provides a complete path from initial setup
to production deployment with enterprise-grade features,
monitoring, security, and scalability.
- Remove manual TX_JSON creation in gift delivery section
- Remove manual TEST_TX creation in performance testing
- Replace with simple_wallet.py CLI commands
- Eliminate all manual JSON transaction building
- Ensure all transaction operations use CLI tool
- Maintain same functionality with cleaner CLI interface
This completes the CLI tool implementation by ensuring
all transaction operations use the CLI tool instead of
manual JSON construction.
- Add simple_wallet.py with create, send, list commands
- Compatible with existing keystore structure (/var/lib/aitbc/keystore)
- Uses requests library (available in central venv)
- Supports password file authentication
- Provides JSON and table output formats
- Replaces complex CLI fallbacks with working implementation
- Update workflow to use simple wallet CLI
- Cross-node deployment to both aitbc1 and aitbc
This provides a fully functional CLI tool for wallet operations
as requested, eliminating the need for Python script fallbacks.
- Update wallet creation to prefer CLI tool with Python script fallback
- Update transaction sending to prefer CLI tool with manual method fallback
- Add robust error handling for CLI implementation issues
- Maintain backward compatibility with existing Python scripts
- Provide clear feedback on which method is being used
- Ensure workflow works regardless of CLI implementation status
This provides the best of both worlds - modern CLI interface
when available, with reliable fallback to proven methods.
- Update wallet creation to use 'aitbc wallet create' CLI command
- Update transaction sending to use 'aitbc wallet send' CLI command
- Replace complex Python scripts with simple CLI commands
- Add wallet verification with 'aitbc wallet list'
- Add transaction hash retrieval with 'aitbc wallet transactions'
- Improve transaction monitoring with better progress tracking
- Simplify user experience with intuitive CLI interface
This makes the workflow more user-friendly and reduces
complexity by using the dedicated CLI tool instead of
manual Python scripts for wallet operations.
- Fix genesis wallet path to use central /var/lib/aitbc/keystore
- Update all environment file references to use /etc/aitbc/.env
- Remove references to old /etc/aitbc/blockchain.env file
- Update both aitbc1 and aitbc node configurations
- Ensure workflow uses correct centralized paths
This aligns the workflow with the actual directory structure
and consolidated environment file configuration.
- Remove duplicate /etc/aitbc/blockchain.env file
- Consolidate to single /etc/aitbc/.env file
- Update all systemd services to use /etc/aitbc/.env
- Code already configured to use /etc/aitbc/.env
- Files were identical - no data loss
- Update workflow documentation to reflect single env file
- Both aitbc1 and aitbc nodes updated
This eliminates confusion and ensures both code and services
use the same environment file location.
- Remove duplicate /opt/aitbc/cli/requirements.txt file
- All CLI dependencies already covered in central requirements.txt
- Central requirements has newer versions of all CLI dependencies
- Update workflow documentation to reflect central venv usage
- Update environment configuration to use /etc/aitbc/.env
- Remove duplicate dependency management
This consolidates all Python dependencies in the central requirements.txt
and eliminates the need for separate CLI requirements management.
- Update to use correct default environment file location /etc/aitbc/.env
- Use central virtual environment /opt/aitbc/venv instead of separate CLI venv
- Update CLI alias to use central venv
- Fix all EnvironmentFile references to use /etc/aitbc/.env
- Align with actual code configuration in config.py
This ensures the workflow uses the correct environment file location
that matches the codebase configuration and central virtual environment.
- Add Step 15: Cross-Node Code Synchronization
- Automatically pull latest changes on aitbc after git push on aitbc1
- Handle local changes with automatic stashing
- Detect blockchain code changes and restart services as needed
- Verify both nodes are running same version after sync
- Add Step 16: Complete Workflow Execution
- Provide end-to-end automated workflow execution
- Include interactive confirmation and comprehensive summary
- Cover all 16 steps for complete multi-node setup
This ensures both nodes stay synchronized with the latest code changes
and provides a complete automated workflow for multi-node deployment.
- Add Step 13: Legacy Environment File Cleanup
- Remove all .env.production and legacy .env references
- Update all systemd services to use /etc/aitbc/blockchain.env
- Add Step 14: Final Multi-Node Verification
- Include comprehensive success criteria validation
- Add service status, configuration, and sync verification
- Provide complete end-to-end workflow validation
This ensures all legacy environment file references are cleaned up
and provides a complete verification framework for the multi-node
blockchain setup with clear success criteria.
- Add Step 12: Chain ID Configuration Verification
- Include detection of chain ID inconsistencies between nodes
- Add automatic chain ID synchronization procedures
- Include configuration file verification and fixes
- Add cross-chain communication testing
- Provide warnings for null chain ID issues
- Ensure both nodes operate on same chain (ait-mainnet)
This section addresses the chain ID null issue and ensures
both nodes are properly configured for the same blockchain
network with verification and troubleshooting procedures.
- Add Step 11: Blockchain Synchronization Verification
- Include genesis block verification to ensure same blockchain
- Add height difference monitoring and automatic sync completion
- Include cross-node blockchain data verification
- Add wallet consistency checks across nodes
- Provide success criteria for blockchain synchronization
- Ensure both nodes are operating on identical blockchain data
This section ensures both aitbc1 and aitbc nodes are fully synchronized
and operating on the same blockchain with verification procedures.
- Add Step 10: Gift Delivery Completion with 3-phase approach
- Include complete sync verification and transaction monitoring
- Add transaction resubmission with correct nonce handling
- Include final verification with success criteria
- Add comprehensive troubleshooting for gift delivery
- Provide automated gift delivery monitoring and verification
This section ensures the 1000 AIT gift is successfully delivered
to the aitbc wallet with proper verification and fallback mechanisms.
- Add comprehensive transaction verification and mining monitoring
- Add advanced monitoring section with real-time blockchain monitoring
- Add performance testing section with transaction throughput testing
- Add network statistics and genesis wallet status checks
- Include detailed step-by-step transaction verification process
- Add final verification commands for complete workflow validation
The workflow now provides complete monitoring, performance testing,
and transaction verification capabilities for production deployment.
- Add batch sync optimization for faster initial setup
- Add complete sync section for full demonstration
- Add enhanced final verification with network health checks
- Add success criteria section with clear validation metrics
- Add Step 8 for complete sync continuation
- Include transaction verification and balance checking
- Add quick health check commands for validation
- Provide comprehensive workflow completion summary
This workflow now provides a complete, tested, and optimized
multi-node blockchain deployment with all necessary verification
steps and success criteria.
- Add prominent section about genesis block architecture
- Clarify that only aitbc1 should have the genesis block
- Explicitly warn against copying genesis block to follower nodes
- Explain wallet attachment process and coin access mechanism
- Detail how new wallets attach to existing blockchain
- Emphasize that AIT coins are transferred, not created
- Add specific DO NOT and INSTEAD examples
- Include wallet attachment explanation in wallet creation section
This prevents critical architecture mistakes and ensures proper
blockchain setup with single genesis source and correct wallet
attachment process.
- Add comprehensive systemd fixes for main files, drop-ins, and overrides
- Include keystore password file creation in pre-flight setup
- Add detailed troubleshooting section with specific solutions
- Update genesis creation to use Python script with automatic address extraction
- Update wallet and transaction creation to use Python scripts (CLI not fully implemented)
- Add comprehensive performance optimization section
- Include monitoring and metrics commands
- Add system resource optimization tips
- Provide real-time monitoring commands
- Include network and database performance tuning
This workflow is now more robust, efficient, and includes solutions
for all issues encountered during the first run.
- Add comprehensive pre-flight setup section covering all required steps
- Include systemd service updates, CLI setup, and config relocation
- Update aitbc1 and aitbc setup sections to reflect pre-flight completion
- Remove redundant steps from main workflow (moved to pre-flight)
- Add verification commands to ensure setup is correct
- Streamline workflow execution by handling prerequisites upfront
This makes the workflow more robust and ensures all prerequisites
are met before starting the actual blockchain deployment.
- Remove sed commands updating EnvironmentFile paths in both aitbc1 and aitbc sections
- Central .env file is already at /etc/aitbc/blockchain.env location
- Systemd services should already be configured to use standard config location
- Focus workflow on configuration file updates, not systemd modifications
- Cleaner workflow that assumes proper systemd configuration
- Remove redundant sed commands for WorkingDirectory and ExecStart
- Keep only necessary EnvironmentFile update to /etc/aitbc/blockchain.env
- Simplify systemd service configuration steps
- Remove unnecessary path updates that don't change anything
- Maintain focus on essential configuration changes only
- Replace direct Python script calls with aitbc CLI commands
- Use 'aitbc blockchain setup' for genesis block creation
- Use 'aitbc wallet create' for wallet creation
- Use 'aitbc transaction send' for sending transactions
- Remove complex manual RPC calls and private key handling
- Simplify workflow with user-friendly CLI interface
- Add AITBC CLI tool to prerequisites
- Maintain same functionality with cleaner, more maintainable commands
This makes the workflow more accessible and reduces the chance of
errors from manual private key handling and RPC formatting.
- Move central configuration from /opt/aitbc/.env to /etc/aitbc/blockchain.env
- Follow system standards for configuration file placement
- Update all workflow steps to use new config location
- Update systemd services to use /etc/aitbc/blockchain.env
- Update environment management section with new paths
- Maintain backup strategy with .backup files
- Standardize configuration location across all AITBC services
This aligns with Linux filesystem hierarchy standards where
/etc/ is the proper location for system configuration files.
- Add verification step before creating directories
- Check if /var/lib/aitbc/ structure already exists
- Provide feedback if directories need to be created
- Apply to both aitbc1 (localhost) and aitbc (remote) setup sections
- More robust directory handling for existing installations
- Remove SSH command for aitbc1 since running on localhost
- Update workflow to reflect aitbc1 is local, aitbc is remote
- Clarify genesis sync approach (aitbc syncs from blockchain, not copy)
- Update final verification section to show localhost vs remote commands
- Maintain proper separation between genesis authority (local) and follower (remote)
- Merge blockchain-node/.env.production into central /opt/aitbc/.env
- Update all blockchain paths to use standardized /var/lib/aitbc/ structure
- Remove separate .env.production file (merged into central config)
- Update systemd services to remove references to .env.production
- Standardize Coordinator API paths and RPC port (8006)
- Add trusted_proposers setting for follower nodes
- Update multi-node workflow to reflect merged configuration
- Use aitbc1genesis as default proposer in central .env
- All services now use single central .env file with standardized paths
This eliminates configuration file duplication and ensures consistent
directory structure across all AITBC services.
- Replace separate blockchain.env files with adaptations of central /opt/aitbc/.env
- Add environment configuration section explaining the centralized approach
- Update both aitbc1 (genesis) and aitbc (follower) setup to use central .env
- Add backup strategy for .env files before modification
- Remove genesis copying from aitbc1 to aitbc (follower should sync via blockchain)
- Add comprehensive environment management section with troubleshooting
- Maintain standardized directory structure while using single .env file
- Include commands for viewing and restoring .env configurations
- Comprehensive workflow for setting up two-node AITBC blockchain
- aitbc1 as genesis authority, aitbc as follower node
- Includes wallet creation, genesis setup, and cross-node transactions
- Uses standardized directory structure with /var/lib/aitbc and /etc/aitbc
- Step-by-step commands for Redis gossip sync and RPC configuration
- Upgrade ollama-gpu-provider skill to v2.0 with complete test workflow documentation
- Add comprehensive troubleshooting, monitoring commands, and CI/CD integration examples
- Update client.py default coordinator port from 8000 to 18000
- Clear currentissue.md and add usage guidelines for issue tracking
- Create dev-utils/ directory and move aitbc-pythonpath.pth from root
- Create docs/guides/ and docs
