# 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` | ✅ Active | Main orchestration and coordination | | 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 ```bash /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 ```bash /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 ```bash /etc/systemd/system/aitbc-gpu.service # Port 8010 /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 ```bash /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 ```bash # 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 ```bash 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 ```bash curl -s http://localhost:8020/health # Multimodal Service curl -s http://localhost:8021/health # Modality Optimization ``` ### Blockchain Services ```bash # 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