Files
aitbc/docs/reference/PORT_MAPPING_GUIDE.md
aitbc 19d415a235
Some checks failed
Blockchain Synchronization Verification / sync-verification (push) Failing after 3s
CLI Tests / test-cli (push) Failing after 3s
Cross-Chain Functionality Tests / test-cross-chain-sync (push) Successful in 2s
Cross-Chain Functionality Tests / test-cross-chain-transactions (push) Successful in 3s
Cross-Chain Functionality Tests / test-cross-chain-bridge (push) Has been skipped
Cross-Chain Functionality Tests / test-multi-chain-consensus (push) Successful in 2s
Cross-Chain Functionality Tests / aggregate-results (push) Has been skipped
Deploy to Testnet / deploy-testnet (push) Successful in 1m12s
Documentation Validation / validate-docs (push) Failing after 8s
Documentation Validation / validate-policies-strict (push) Successful in 3s
Integration Tests / test-service-integration (push) Successful in 2m6s
Multi-Chain Island Architecture Tests / test-multi-chain-island (push) Successful in 2s
Multi-Node Blockchain Health Monitoring / health-check (push) Failing after 4s
P2P Network Verification / p2p-verification (push) Successful in 4s
Package Tests / Python package - aitbc-agent-sdk (push) Successful in 32s
Package Tests / Python package - aitbc-core (push) Successful in 14s
Package Tests / Python package - aitbc-crypto (push) Successful in 12s
Package Tests / Python package - aitbc-sdk (push) Successful in 9s
Package Tests / JavaScript package - aitbc-sdk-js (push) Successful in 8s
Package Tests / JavaScript package - aitbc-token (push) Successful in 17s
Python Tests / test-python (push) Successful in 15s
Security Scanning / security-scan (push) Successful in 27s
Node Failover Simulation / failover-test (push) Successful in 7s
Multi-Node Stress Testing / stress-test (push) Successful in 6s
Cross-Node Transaction Testing / transaction-test (push) Successful in 4s
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

7.8 KiB

AITBC Port Mapping Guide - March 30, 2026

🚀 Complete Service Port Allocation

🔧 Core Services (8000-8009) - Essential Infrastructure

Port Service Endpoint Status Description
8000 Coordinator API http://localhost:8000/health ⚠️ Legacy DEPRECATED - Use Agent Coordinator (9001) or microservices
8001 Exchange API http://localhost:8001/api/health Active Trading and exchange functionality
8002 Marketplace API http://localhost:8002/health Active GPU compute marketplace
8003 Wallet API http://localhost:8003/health Active Digital wallet management
8004 Explorer http://localhost:8004/health Active Blockchain explorer interface
8005 Available - 🔄 Free Available for future core service
8006 Blockchain RPC - Active Blockchain RPC (systemd service)
8007 Web UI http://localhost:8007/ Active Web user interface
8008 Available - 🔄 Free Available for future core service
8009 Available - 🔄 Free Available for future core service

🚀 AI/Agent/GPU Services (8010-8019) - Advanced Features

Port Service Endpoint Status Description
8010 GPU Service http://localhost:8010/health Active GPU-accelerated processing
8011 Learning Service http://localhost:8011/health Active Machine learning and adaptation
8012 Agent Coordinator http://localhost:8012/health Active Agent orchestration and coordination
8013 Agent Registry http://localhost:8013/health Active Agent registration and discovery
8014 OpenClaw Service http://localhost:8014/health Active Edge computing and agent orchestration
8015 AI Service http://localhost:8015/health Active Advanced AI capabilities
8016 Available - 🔄 Free Available for future AI/agent service
8017 Available - 🔄 Free Available for future AI/agent service
8018 Available - 🔄 Free Available for future AI/agent service
8019 Available - 🔄 Free Available for future AI/agent service

📊 Other Services (8020-8029) - Specialized Services

Port Service Endpoint Status Description
8020 Multimodal Service http://localhost:8020/health Active Multi-modal data processing
8021 Modality Optimization http://localhost:8021/health Active Modality optimization engine
8022 Available - 🔄 Free Available for future specialized service
8023 Available - 🔄 Free Available for future specialized service
8024 Available - 🔄 Free Available for future specialized service
8025 Available - 🔄 Free Available for future specialized service
8026 Available - 🔄 Free Available for future specialized service
8027 Available - 🔄 Free Available for future specialized service
8028 Available - 🔄 Free Available for future specialized service
8029 Available - 🔄 Free Available for future specialized service

🔧 Service Configuration Files

Core Services

/etc/systemd/system/aitbc-coordinator-api.service      # Port 8000
/etc/systemd/system/aitbc-exchange-api.service           # Port 8001
/etc/systemd/system/aitbc-marketplace.service              # Port 8002
/etc/systemd/system/aitbc-wallet.service                   # Port 8003
apps/blockchain-explorer/main.py                          # Port 8004
/etc/systemd/system/aitbc-web-ui.service                   # Port 8007

Blockchain Services

/etc/systemd/system/aitbc-blockchain-node.service           # Systemd service
/etc/systemd/system/aitbc-blockchain-rpc.service            # Port 8006 (from blockchain.env)

AI/Agent/GPU Services

# GPU functionality unified into aitbc-marketplace.service (port 8007)
/etc/systemd/system/aitbc-learning.service                  # Port 8011
apps/agent-services/agent-coordinator/src/coordinator.py   # Port 8012
apps/agent-services/agent-registry/src/app.py             # Port 8013
/etc/systemd/system/aitbc-openclaw.service                  # Port 8014
apps/coordinator-api/src/app/services/advanced_ai_service.py # Port 8015

Other Services

/etc/systemd/system/aitbc-multimodal.service               # Port 8020
/etc/systemd/system/aitbc-modality-optimization.service     # Port 8021

🎯 Port Allocation Strategy

Core Services (8000-8009)

  • Purpose: Essential AITBC infrastructure
  • Services: Coordinator, Exchange, Marketplace, Wallet, Explorer, Web UI
  • Blockchain: Node and RPC services
  • Priority: Highest - required for basic AITBC functionality

AI/Agent/GPU Services (8010-8019)

  • Purpose: Advanced AI, agent orchestration, and GPU processing
  • Services: GPU, Learning, Agent Coordinator, Agent Registry, OpenClaw, AI
  • Priority: High - enhances AITBC capabilities
  • Features: Machine learning, agent management, edge computing

Other Services (8020-8029)

  • Purpose: Specialized and experimental services
  • Services: Multimodal processing, modality optimization
  • Priority: Medium - optional enhancements
  • Features: Multi-modal data processing, optimization engines

🚀 Health Check Commands

Quick Health Check

# Run comprehensive health check
/opt/aitbc/health-check.sh

# Check specific service categories
curl -s http://localhost:8000/health  # Coordinator API
curl -s http://localhost:8001/api/health  # Exchange API
curl -s http://localhost:8002/health  # Marketplace API
curl -s http://localhost:8003/health  # Wallet API
curl -s http://localhost:8004/health  # Explorer
curl -s http://localhost:8007/  # Web UI

AI/Agent/GPU Services

curl -s http://localhost:8010/health  # GPU Service
curl -s http://localhost:8011/health  # Learning Service
curl -s http://localhost:8012/health  # Agent Coordinator
curl -s http://localhost:8013/health  # Agent Registry
curl -s http://localhost:8014/health  # OpenClaw Service
curl -s http://localhost:8015/health  # AI Service

Other Services

curl -s http://localhost:8020/health  # Multimodal Service
curl -s http://localhost:8021/health  # Modality Optimization

Blockchain Services

# Check blockchain services (systemd)
systemctl status aitbc-blockchain-node.service
systemctl status aitbc-blockchain-rpc.service

📋 Port Usage Summary

  • Total Services: 16 active services
  • Used Ports: 8000-8007, 8010-8015, 8020-8021
  • Available Ports: 8005, 8008-8009, 8016-8019, 8022-8029
  • Port Conflicts: None resolved
  • Status: Perfect organization achieved

🔄 Recent Changes (March 30, 2026)

Port Reorganization Complete

  • Resolved all port conflicts
  • Sequential port assignment within ranges
  • Services grouped by function and importance
  • Complete documentation synchronization
  • Perfect port allocation strategy compliance

Service Migration Summary

  • Explorer: Moved from 8022 → 8004 (Core Services)
  • Web UI: Moved from 8016 → 8007 (Core Services)
  • Learning Service: Moved from 8010 → 8011 (AI/Agent/GPU)
  • Agent Coordinator: Moved from 8011 → 8012 (AI/Agent/GPU)
  • Agent Registry: Moved from 8012 → 8013 (AI/Agent/GPU)
  • OpenClaw Service: Moved from 8013 → 8014 (AI/Agent/GPU)
  • AI Service: Moved from 8009 → 8015 (AI/Agent/GPU)
  • Modality Optimization: Moved from 8023 → 8021 (Other Services)
  • Multimodal Service: Moved from 8005 → 8020 (Other Services)

Last Updated: March 30, 2026
Status: Perfect port organization achieved
Next Review: As needed for new service additions