aitbc
c497e1512e
Apps Directory Port Update - Complete: ✅ APPS DIRECTORY UPDATED: All hardcoded port references updated to current assignments - apps/coordinator-api/src/app/routers/marketplace_enhanced_app.py: Port 8006 → 8002 - apps/coordinator-api/src/app/routers/openclaw_enhanced_app.py: Port 8007 → 8014 - apps/coordinator-api/src/app/routers/adaptive_learning_health.py: Port 8005 → 8011 - apps/coordinator-api/src/app/routers/gpu_multimodal_health.py: Port 8003 → 8010 - apps/coordinator-api/src/app/routers/marketplace_enhanced_health.py: Port 8006 → 8002 - apps/agent-services/agent-bridge/src/integration_layer.py: Updated service endpoints - Reason: Apps directory now synchronized with health check port assignments ✅ SERVICE ENDPOINTS UPDATED: 🔧 Core Services: - Coordinator API: Port 8000 ✅ (correct) - Exchange Service: Port 8001 ✅ (correct) - Marketplace: Port 8002 ✅ (updated from 8006) - Agent Registry: Port 8013 ✅ (updated from 8003) 🚀 AI/Agent/GPU Services: - GPU Service: Port 8010 ✅ (updated from 8003) - Learning Service: Port 8011 ✅ (updated from 8005) - OpenClaw Service: Port 8014 ✅ (updated from 8007) 📊 Health Check Routers: - Adaptive Learning Health: Port 8011 ✅ (updated from 8005) - GPU Multimodal Health: Port 8010 ✅ (updated from 8003) - Marketplace Enhanced Health: Port 8002 ✅ (updated from 8006) ✅ INTEGRATION LAYER UPDATED: ✅ Agent Bridge Integration: All service endpoints updated ✅ Service Discovery: Correct port assignments for agent communication ✅ API Endpoints: Marketplace and agent registry ports corrected ✅ Consistent References: No hardcoded old ports remaining ✅ PORT CONFLICTS RESOLVED: ✅ Port 8002: Marketplace service (was conflicting with old references) ✅ Port 8010: GPU service (was conflicting with old references) ✅ Port 8011: Learning service (was conflicting with old references) ✅ Port 8013: Agent registry (was conflicting with old references) ✅ Port 8014: OpenClaw service (was conflicting with old references) ✅ COMPLETE SYNCHRONIZATION: ✅ Health Check Script: ✅ Matches service configurations ✅ Service Files: ✅ All updated to match health check ✅ Documentation: ✅ Reflects actual port assignments ✅ Apps Directory: ✅ All hardcoded references updated ✅ Integration Layer: ✅ Service endpoints synchronized ✅ SYSTEM-WIDE CONSISTENCY: ✅ No Port Conflicts: All services use unique ports ✅ Sequential Assignment: Services use sequential ports within ranges ✅ Functional Grouping: Services grouped by purpose ✅ Complete Coverage: Every reference updated across codebase ✅ VERIFICATION READY: ✅ Health Check: All endpoints will work correctly ✅ Service Discovery: Agent communication will work ✅ API Integration: All service-to-service calls will work ✅ Documentation: All references are accurate RESULT: Successfully updated all port references in the apps directory to match the new port assignments. The entire AITBC codebase is now perfectly synchronized with no port conflicts and complete consistency across health check, service configurations, documentation, and application code.
Coordinator API
Purpose & Scope
FastAPI service that accepts client compute jobs, matches miners, and tracks job lifecycle for the AITBC network.
Marketplace Extensions
Stage 2 introduces public marketplace endpoints exposed under /v1/marketplace:
GET /v1/marketplace/offers– list available provider offers (filterable by status).GET /v1/marketplace/stats– aggregated supply/demand metrics surfaced in the marketplace web dashboard.POST /v1/marketplace/bids– accept bid submissions for matching (mock-friendly; returns202 Accepted).
These endpoints serve the apps/marketplace-web/ dashboard via VITE_MARKETPLACE_DATA_MODE=live.
Explorer Endpoints
The coordinator now exposes read-only explorer data under /v1/explorer for apps/explorer-web/ live mode:
GET /v1/explorer/blocks– block summaries derived from recent job activity.GET /v1/explorer/transactions– transaction-like records for coordinator jobs.GET /v1/explorer/addresses– aggregated address activity and balances.GET /v1/explorer/receipts– latest job receipts (filterable byjob_id).
Set VITE_DATA_MODE=live and VITE_COORDINATOR_API in the explorer web app to consume these APIs.
Development Setup
- Create a virtual environment in
apps/coordinator-api/.venv. - Install dependencies listed in
pyproject.tomlonce added. - Run the FastAPI app via
uvicorn app.main:app --reload.
Configuration
Expects environment variables defined in .env (see docs/bootstrap/coordinator_api.md).
Signed receipts (optional)
- Generate an Ed25519 key:
python - <<'PY' from nacl.signing import SigningKey sk = SigningKey.generate() print(sk.encode().hex()) PY - Set
RECEIPT_SIGNING_KEY_HEXin the.envfile to the printed hex string to enable signed receipts returned by/v1/miners/{job_id}/resultand retrievable via/v1/jobs/{job_id}/receipt. - Receipt history is available at
/v1/jobs/{job_id}/receipts(requires client API key) and returns all stored signed payloads. - To enable coordinator attestations, set
RECEIPT_ATTESTATION_KEY_HEXto a separate Ed25519 private key; responses include anattestationsarray alongside the miner signature. - Clients can verify
signatureobjects using theaitbc_cryptopackage (seeprotocols/receipts/spec.md).
Systemd
Service name: aitbc-coordinator-api (to be defined under configs/systemd/).