- 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.
- Update pyproject.toml version from 0.1.0 to v0.2.2
- Update FastAPI app version in blockchain node
- Update mock coordinator API version
- Update RPC version in blockchain info endpoint
- 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.
- Move EnvironmentFile from /opt/aitbc/.env to /etc/aitbc/blockchain.env in all systemd services
- Add main() entry point function to CLI for package installation compatibility
- Update aitbc-blockchain-node.service, aitbc-blockchain-node-dev.service
- Update aitbc-blockchain-rpc.service
- Update aitbc-blockchain-sync.service, aitbc-blockchain-sync-dev.service
This aligns with Linux filesystem hierarchy standards where /etc/ is the proper
- 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
aitbc-agent-sdk (package-tests.yml):
- Add AITBCAgent convenience class matching test expectations
- Fix test_agent_sdk.py: was importing nonexistent AITBCAgent, now tests
the real API (Agent.create, AgentCapabilities, to_dict) plus AITBCAgent
- Fix 3 remaining mypy errors: supported_models Optional coercion (line 64),
missing return types on _submit_to_marketplace/_update_marketplace_offer
- Run black on all 5 src files — zero mypy errors, zero black warnings
- All 6 tests pass
python-tests.yml:
- Add pynacl to pip install (aitbc-crypto and aitbc-sdk import nacl)
- Add pynacl>=1.5.0 to root requirements.txt
Service readiness (api-endpoint-tests.yml, integration-tests.yml):
- Replace curl -sf with curl http_code check — -sf fails on 404 responses
but port 8006 (blockchain RPC) returns 404 on / while being healthy
- Blockchain RPC uses REST /rpc/* endpoints, not JSON-RPC POST to /
Fix test_api_endpoints.py to test /health, /rpc/head, /rpc/info, /rpc/supply
- Remove dead test_rpc() function, add blockchain RPC to perf tests
- All 4 services now pass: coordinator, exchange, wallet, blockchain_rpc
- Integration-tests: check is-active before systemctl start to avoid
spurious warnings for already-running services
Hardhat compile (smart-contract-tests.yml, package-tests.yml):
- Relax engines field from >=24.14.0 to >=18.0.0 (CI has v24.13.0)
- Remove 2>/dev/null from hardhat compile/test so errors are visible
- Remove 2>/dev/null from npm run build/test in package-tests JS section
Service health checks:
- Exchange API uses /api/health not /health — updated test script
and workflow wait loops to check /api/health as fallback
- Increased wait time to 2s intervals, 15 retries for service readiness
- Performance tests now hit /health endpoints (not root /)
Hardhat compilation:
- aitbc-token was missing peer deps for @nomicfoundation/hardhat-toolbox
- Installed all 11 required peer packages (ethers, typechain, etc.)
- Contracts now compile (19 Solidity files) and all 17 tests pass
Rust workflow:
- Fixed HOME mismatch: gitea-runner HOME=/opt/gitea-runner vs
euid root HOME=/root — explicitly set HOME=/root in all steps
- Set RUSTUP_HOME and CARGO_HOME for consistent toolchain location
Mypy type annotations (aitbc-agent-sdk):
- agent.py: narrow key types to RSA (isinstance check before sign/verify),
fix supported_models Optional type, add __post_init__ return type
- compute_provider.py: add return types to all methods, declare
pricing_model/dynamic_pricing attrs, rename register→create_provider
to avoid signature conflict with parent, fix Optional safety
- swarm_coordinator.py: add return types to all 8 untyped methods
Fixes based on first CI run results:
Workflow fixes:
- python-tests.yml: Add pytest-timeout and click to pip install
(--timeout=30 unrecognized, conftest.py needs click)
- integration-tests.yml: Add click, pytest-timeout to pip install
Fix systemctl status capture (multiline output in subshell)
- systemd-sync.yml: Fix printf output — $(cmd || echo) captures
multiline; use $(cmd) || var=fallback instead
- test_api_endpoints.py: Count 404/405 as reachable in perf test
(APIs return 404 on root but are running)
Missing module fixes:
- aitbc-agent-sdk: Create compute_consumer.py and platform_builder.py
(__init__.py imported them but files didn't exist)
- aitbc-core: Create logging.py module with StructuredLogFormatter,
setup_logger, get_audit_logger (tests existed but module was missing)
Fix __init__.py duplicate imports
- Replace https://gitea.bubuit.net with http://10.0.3.107:3000
- Fix JavaScript packages CI cloning failures
- Update all git clone commands in package-tests.yml
- Resolve 'Failed to connect to gitea.bubuit.net port 443' error
- Use correct internal Gitea server address
CI Fixes:
- JavaScript packages workspace setup
- Cross-language compatibility tests
- Package integration tests
- All git clone operations now use reachable URL
- Simplify pyproject.toml classifiers to avoid Poetry lock conflicts
- Remove problematic dependencies (alembic, asyncio-mqtt, pre-commit, etc.)
- Add fallback requirements.txt for pip installation
- Remove poetry.lock to force regeneration
- Fix Python version classifier (3 :: Only)
- Reduce optional dependencies to essential ones only
CI Improvements:
- Poetry lock file regeneration should work now
- Fallback to pip if Poetry fails
- Essential dev tools (pytest, black, mypy) available
- Package building works correctly
This resolves the CI package test dependency installation failures.
- Add eth-account>=0.13.0 to pyproject.toml dependencies
- Add eth-account>=0.13.0 to central requirements.txt
- Fixes CI test failure: ModuleNotFoundError: No module named 'eth_account'
- Ensures blockchain contract tests can import eth_account properly
- Required for Guardian Contract and other blockchain functionality
## 🚀 Central Virtual Environment Implementation
- Created central venv at /opt/aitbc/venv for all services
- Updated 34+ systemd services to use central python interpreter
- Fixed PYTHONPATH configurations for proper module imports
- Created aitbc-env wrapper script for environment management
## 📦 Requirements Management Overhaul
- Consolidated 8 separate requirements.txt files into central requirements.txt
- Added web3>=6.11.0 for blockchain functionality
- Created automated requirements migrator tool (scripts/requirements_migrator.py)
- Established modular requirements structure (requirements-modules/)
- Generated comprehensive migration reports and documentation
## 🔧 Service Configuration Fixes
- Fixed Adaptive Learning service domain imports (AgentStatus)
- Resolved logging conflicts in zk_proofs and adaptive_learning_health
- Created missing data modules (consumer_gpu_profiles.py)
- Updated CLI to version 0.2.2 with proper import handling
- Fixed infinite loop in CLI alias configuration
## 📡 Port Mapping and Service Updates
- Updated blockchain node port from 8545 to 8005
- Added Adaptive Learning service on port 8010
- Consolidated P2P/sync into blockchain-node service
- All 5 core services now operational and responding
## 📚 Documentation Enhancements
- Updated SYSTEMD_SERVICES.md for Debian root usage (no sudo)
- Added comprehensive VIRTUAL_ENVIRONMENT.md guide
- Created REQUIREMENTS_MERGE_SUMMARY.md with migration details
- Updated RUNTIME_DIRECTORIES.md for standard Linux paths
- Fixed service port mappings and dependencies
## 🛠️ CLI Improvements
- Fixed import errors and version display (0.2.2)
- Resolved infinite loop in bashrc alias
- Added proper error handling for missing command modules
- Created aitbc-cli wrapper for clean execution
## ✅ Operational Status
- 5/5 AITBC services running successfully
- All health checks passing
- Central virtual environment fully functional
- Requirements management streamlined
- Documentation accurate and up-to-date
## 🎯 Technical Achievements
- Eliminated 7 redundant requirements.txt files
- Reduced service startup failures from 34+ to 0
- Established modular dependency management
- Created reusable migration tooling
- Standardized Debian root deployment practices
This represents a complete infrastructure modernization with improved reliability,
maintainability, and operational efficiency.
