e4f1a96172
Some checks failed
Blockchain Synchronization Verification / sync-verification (push) Failing after 8s
CLI Tests / test-cli (push) Successful in 10s
Contract Performance Benchmarks / benchmark-gas-usage (push) Successful in 1m22s
Contract Performance Benchmarks / benchmark-execution-time (push) Successful in 1m11s
Contract Performance Benchmarks / benchmark-throughput (push) Successful in 1m13s
Cross-Chain Functionality Tests / test-cross-chain-sync (push) Failing after 5s
Cross-Chain Functionality Tests / test-cross-chain-transactions (push) Successful in 5s
Cross-Chain Functionality Tests / test-cross-chain-bridge (push) Has been skipped
Cross-Chain Functionality Tests / test-multi-chain-consensus (push) Failing after 3s
Cross-Chain Functionality Tests / aggregate-results (push) Has been skipped
Cross-Node Transaction Testing / transaction-test (push) Successful in 5s
Deploy to Testnet / deploy-testnet (push) Successful in 1m14s
Contract Performance Benchmarks / compare-benchmarks (push) Has been cancelled
Documentation Validation / validate-docs (push) Failing after 10s
Multi-Node Stress Testing / stress-test (push) Has been cancelled
Node Failover Simulation / failover-test (push) Has been cancelled
Security Scanning / security-scan (push) Has been cancelled
Smart Contract Tests / test-solidity (map[name:aitbc-contracts path:contracts]) (push) Has been cancelled
Smart Contract Tests / test-solidity (map[name:aitbc-token path:packages/solidity/aitbc-token]) (push) Has been cancelled
Smart Contract Tests / test-foundry (push) Has been cancelled
Smart Contract Tests / lint-solidity (push) Has been cancelled
Smart Contract Tests / deploy-contracts (push) Has been cancelled
Documentation Validation / validate-policies-strict (push) Successful in 3s
Integration Tests / test-service-integration (push) Failing after 45s
Multi-Chain Island Architecture Tests / test-multi-chain-island (push) Failing after 2s
Multi-Node Blockchain Health Monitoring / health-check (push) Successful in 5s
P2P Network Verification / p2p-verification (push) Successful in 3s
Production Tests / Production Integration Tests (push) Failing after 7s
Python Tests / test-python (push) Failing after 46s
Staking Tests / test-staking-service (push) Failing after 2s
Staking Tests / test-staking-integration (push) Has been skipped
Staking Tests / test-staking-contract (push) Has been skipped
Staking Tests / run-staking-test-runner (push) Has been skipped
Systemd Sync / sync-systemd (push) Successful in 21s
API Endpoint Tests / test-api-endpoints (push) Failing after 12m19s
- Changed pytest calls to use `venv/bin/python -m pytest` with explicit config - Added `--rootdir "$PWD"` and `--import-mode=importlib` for consistent imports - Fixed PYTHONPATH to use absolute paths with $PWD prefix - Added smart contract security scanning for Solidity files - Added Circom circuit security checks for ZK proof circuits - Added ZK proof implementation security validation - Added contracts/** to security scanning workflow
4.6 KiB
4.6 KiB
AITBC Infrastructure Documentation
Last Updated: 2026-03-29
Version: 3.2 (Infrastructure Optimization)
Overview
This section documents the AITBC infrastructure components, runtime architecture, and system management following the latest infrastructure optimization.
🏗️ Recent Infrastructure Updates (March 29, 2026)
✅ Completed Optimizations
-
Runtime Directories: Implemented standard Linux directory structure
/var/lib/aitbc/keystore/- Secure blockchain key storage/var/lib/aitbc/data/- Database files and application data/var/lib/aitbc/logs/- Application logs/etc/aitbc/- Configuration files
-
SystemD Services: Fixed 34+ services with system Python3
- Replaced non-existent venv paths with
/usr/bin/python3 - Updated WorkingDirectory paths to correct locations
- Created missing environment files
- Fixed PYTHONPATH configurations
- Replaced non-existent venv paths with
-
Service Consolidation: Standardized agent services
- Consolidated into
/opt/aitbc/apps/agent-services/ - Consistent hyphenated naming (
agent-*) - Removed duplicate services
- Updated systemd service paths
- Consolidated into
🔧 Infrastructure Components
Core Services
- Coordinator API: Central orchestration (Port 8011)
- Blockchain Node: Core blockchain (Port 8545)
- Exchange API: Trading services (Port 8001)
- Wallet Service: Wallet management (Port 8003)
Agent Services
- Agent Registry: Service discovery and registration
- Agent Coordinator: Task coordination and management
- Agent Protocols: Communication and messaging
- Agent Bridge: Service integration layer
- Agent Compliance: Regulatory monitoring
- Agent Trading: Automated trading
Supporting Services
- GPU Services: Multimodal processing
- Marketplace Services: Enhanced marketplace
- Load Balancer: Geographic distribution
- Explorer: Blockchain explorer
📁 Documentation Structure
Core Infrastructure Files
- Runtime Directories Guide - Standard directory structure
- SystemD Services Guide - Service management
- Security Hardening Guide - Security best practices
Analysis Documents
Deployment Guides
- Codebase Update Summary - Service standardization
- Multimodal Services Deployment - GPU services
🔒 Security Architecture
Keystore Security
- Location:
/var/lib/aitbc/keystore/ - Permissions: 700 (root/aitbc user only)
- Isolation: Separate from application code
- Backup: Included in system backup strategy
Service Security
- User Isolation: Services run with minimal privileges
- Path Security: Sensitive paths properly secured
- Environment Security: Configuration files protected
🚀 Setup and Deployment
Automated Setup
# Complete infrastructure setup
sudo bash <(curl -sSL https://raw.githubusercontent.com/oib/aitbc/main/setup.sh)
Manual Setup
# Clone and setup manually
sudo git clone https://github.com/aitbc/aitbc.git /opt/aitbc
cd /opt/aitbc
sudo ./setup.sh
📊 Service Management
Health Monitoring
# Check all services
/opt/aitbc/scripts/monitoring/health_check.sh
# View logs (new locations)
tail -f /var/lib/aitbc/logs/aitbc-*.log
# SystemD control
systemctl status aitbc-*
systemctl restart aitbc-coordinator-api
Runtime Directory Access
# Check keystore
ls -la /var/lib/aitbc/keystore/
# Check data directory
ls -la /var/lib/aitbc/data/
# Check logs
ls -la /var/lib/aitbc/logs/
🔄 Maintenance Procedures
Regular Tasks
- Log Rotation: Automatic via logrotate
- Service Updates: Controlled systemd updates
- Security Patches: Regular system updates
- Backup Verification: Validate keystore backups
Troubleshooting
- Service Failures: Check journalctl logs
- Path Issues: Verify runtime directories exist
- Permission Issues: Check directory permissions
- Dependency Issues: Verify Python3 packages
Next Steps: Review individual service documentation for specific configuration details.
Category Overview
This section contains all documentation related to infrastructure documentation. The documented files have been automatically converted from completed planning analysis files.
Auto-generated index