oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 7 Packages Projects Releases Wiki Activity
Files
5c99c92ffbaf8f7aaa515b16e296a0f960bd51d6
aitbc/docs/done.md
oib 5c99c92ffb test
2026-01-26 19:58:21 +01:00

16 KiB
Raw Blame History

Completed Deployments

This document tracks components that have been successfully deployed and are operational.

Container Services (aitbc.bubuit.net)

  • ✅ Main Website - Deployed at https://aitbc.bubuit.net/

    • Static HTML/CSS with responsive design
    • Features overview, architecture, roadmap, platform status
    • Documentation portal integrated

  • ✅ Explorer Web - Deployed at https://aitbc.bubuit.net/explorer/

    • Full-featured blockchain explorer
    • Mock data with genesis block (height 0) displayed
    • Blocks, transactions, addresses, receipts tracking
    • Mock/live data toggle functionality (live mode backed by Coordinator API)
    • Live API (nginx): /api/explorer/*

  • ✅ Marketplace Web - Deployed at https://aitbc.bubuit.net/marketplace/

    • Vite + TypeScript frontend
    • Offer list, bid form, stats cards
    • Mock data fixtures with API abstraction
    • Integration tests now connect to live marketplace

  • ✅ Coordinator API - Deployed in container

    • FastAPI service running on port 8000
    • Health endpoint: /api/v1/health returns {"status":"ok","env":"dev"}
    • nginx proxy: /api/ routes to container service (so /api/v1/* works)
    • Explorer API (nginx): /api/explorer/* → backend /v1/explorer/*
    • Users API: /api/v1/users/* (compat: /api/users/* for Exchange)
    • ZK Applications API: /api/zk/ endpoints for privacy-preserving features
    • Integration tests use real ZK proof features

  • ✅ Wallet Daemon - Deployed in container

    • FastAPI service with encrypted keystore (Argon2id + XChaCha20-Poly1305)
    • REST and JSON-RPC endpoints for wallet management
    • Mock ledger adapter with SQLite backend
    • Running on port 8002, nginx proxy: /wallet/
    • Dependencies: aitbc-sdk, aitbc-crypto, fastapi, uvicorn
    • Bitcoin payment gateway implemented

  • ✅ Documentation - Deployed at https://aitbc.bubuit.net/docs/

    • Split documentation for different audiences
    • Miner, client, developer guides
    • API references and technical specs

  • ✅ Trade Exchange - Deployed at https://aitbc.bubuit.net/Exchange/

    • Bitcoin wallet integration for AITBC purchases
    • User management system with individual wallets
    • QR code generation for payments
    • Real-time payment monitoring
    • Session-based authentication
    • Exchange rate: 1 BTC = 100,000 AITBC

Integration Tests

  • ✅ Test Suite Updates - Completed 2026-01-26

    • Security tests now use real ZK proof features
    • Marketplace tests connect to live service
    • Performance tests removed (too early)
    • Wallet-coordinator integration added to roadmap
    • 6 tests passing, 1 skipped (wallet integration)

  • ✅ ZK Applications - Privacy-preserving features deployed

    • Circom compiler v2.2.3 installed
    • ZK circuits compiled (receipt_simple with 300 constraints)
    • Trusted setup ceremony completed (Powers of Tau)
    • Available features:
      • Identity commitments
      • Stealth addresses
      • Private receipt attestation
      • Group membership proofs
      • Private bidding
      • Computation proofs
    • API endpoints: /api/zk/

Host Services (GPU Access)

  • ✅ Blockchain Node - Running on host
    • SQLModel-based blockchain with PoA consensus
    • RPC API on port 9080 (proxied via /rpc/)
    • Mock coordinator on port 8090 (proxied via /v1/)
    • Devnet scripts and observability hooks
  • ✅ Host GPU Miner - Running on host (RTX 4060 Ti)
    • Real GPU inference via Ollama
    • Connects to container coordinator through Incus proxy on 127.0.0.1:18000
    • Receives jobs, submits results, and completes successfully

Infrastructure

  • ✅ Incus Container - 'aitbc' container deployed

    • RAID1 configuration for data redundancy
    • nginx reverse proxy for all web services
    • Bridge networking (10.1.223.1 gateway)

  • ✅ nginx Configuration - All routes configured

    • /explorer/ → Explorer Web
    • /marketplace/ → Marketplace Web
    • /api/ → Coordinator API (container)
    • /api/v1/ → Coordinator API (container)
    • /api/explorer/ → Explorer API (container)
    • /api/users/ → Users API (container, Exchange compatibility)
    • /api/zk/ → ZK Applications API (container)
    • /rpc/ → Blockchain RPC (host)
    • /v1/ → Mock Coordinator (host)
    • /wallet/ → Wallet Daemon (container)
    • /docs/ → Documentation portal

  • ✅ SSL/HTTPS - Configured and working

  • ✅ DNS Resolution - Fully operational

    • All endpoints accessible via domain name
    • SSL certificates properly configured

Deployment Architecture

  • Container Services: Public web access, no GPU required
    • Website, Explorer, Marketplace, Coordinator API, Wallet Daemon, Docs, ZK Apps
  • Host Services: GPU access required, private network
    • Blockchain Node, Mining operations
  • nginx Proxy: Routes requests between container and host
    • Seamless user experience across all services

Current Status

Production Ready: All core services deployed and operational

  • ✅ 9 container services running (including ZK Applications and Trade Exchange)
  • ✅ 2 host services running (blockchain node + GPU miner)
  • ✅ Complete nginx proxy configuration
  • ✅ SSL/HTTPS fully configured
  • ✅ DNS resolution working
  • ✅ Trade Exchange with Bitcoin integration
  • ✅ Zero-Knowledge proof capabilities enabled
  • ✅ Explorer live API integration complete

Remaining Tasks

  • Fix full Coordinator API codebase import issues (low priority)
  • Fix Blockchain Node SQLModel/SQLAlchemy compatibility issues (low priority)
  • Configure additional monitoring and observability
  • Set up automated backup procedures

Recent Updates (2026-01-21)

Service Maintenance and Fixes

  • ✅ Container Service Recovery - Fixed all failing AITBC services

    • Resolved duplicate service conflicts (aitbc-coordinator-api, aitbc-exchange-frontend)
    • Fixed marketplace service by creating proper server.py file
    • Identified and disabled redundant services to prevent port conflicts
    • All essential services now running correctly

  • ✅ Service Status Summary:

    • aitbc-blockchain.service - Running ✅
    • aitbc-exchange-api.service - Running ✅
    • aitbc-exchange.service - Running ✅
    • aitbc-marketplace.service - Running ✅ (Fixed)
    • aitbc-miner-dashboard.service - Running ✅
    • coordinator-api.service - Running ✅
    • wallet-daemon.service - Running ✅

  • ✅ SSH Access Configuration - Set up passwordless SSH access

    • Created dedicated SSH key for Cascade automation
    • Configured SSH alias 'aitbc-cascade' for seamless access
    • Enabled secure service management and monitoring

Skills Framework Implementation (2025-01-19)

  • ✅ Deploy-Production Skill - Created comprehensive deployment workflow skill

    • Location: .windsurf/skills/deploy-production/
    • Features: Pre-deployment checks, environment templates, rollback procedures
    • Scripts: pre-deploy-checks.sh, health-check.py use cases: Automated production deployments with safety checks

  • ✅ Blockchain-Operations Skill - Created blockchain operations management skill

    • Location: .windsurf/skills/blockchain-operations/
    • Features: Node health monitoring, transaction debugging, mining optimization
    • Scripts: node-health.sh, tx-tracer.py, mining-optimize.sh, sync-monitor.py, network-diag.py
    • Use cases: Node management, mining optimization, network diagnostics

Skills Benefits

  • Standardized workflows for complex operations
  • Automated safety checks and validation
  • Comprehensive documentation and error handling
  • Integration with Cascade for intelligent execution

Recent Updates (2026-01-23)

  • ✅ Host GPU Miner (Real GPU)
    • Host miner runs on RTX 4060 Ti with Ollama inference.
    • Uses Incus proxy on 127.0.0.1:18000 to reach the container coordinator.
    • Result submission fixed and jobs complete successfully.
  • ✅ Coordinator Systemd Alignment
    • coordinator-api.service enabled in container for startup on boot.
    • Legacy aitbc-coordinator-api.service removed to avoid conflicts.
  • ✅ Proxy Health Check (Host)
    • Added systemd timer aitbc-coordinator-proxy-health.timer to monitor proxy availability.

Recent Updates (2026-01-24)

Ollama GPU Inference End-to-End Testing

  • ✅ Complete Workflow Verification

    • Job submission via CLI → Coordinator API → Miner polling → Ollama inference → Result submission → Receipt generation → Blockchain recording
    • Successfully processed test job in 11.12 seconds with 218 tokens
    • Receipt generated with proper payment amounts: 11.846 gpu_seconds @ 0.02 AITBC = 0.23692 AITBC

  • ✅ Bash CLI Wrapper Script

    • Created unified CLI tool at /home/oib/windsurf/aitbc/scripts/aitbc-cli.sh
    • Commands: submit, status, browser, blocks, receipts, cancel, admin-miners, admin-jobs, admin-stats, health
    • Environment variable overrides for URL and API keys
    • Made executable and documented in localhost testing scenario

  • ✅ Coordinator API Bug Fix

    • Fixed NameError: name '_coerce_float' is not defined in receipt service
    • Added missing helper function to /opt/coordinator-api/src/app/services/receipts.py
    • Deployed fix to incus container via SSH
    • Result submission now returns 200 OK instead of 500 Internal Server Error

  • ✅ Miner Configuration Fix

    • Updated miner ID from host-gpu-miner to REDACTED_MINER_KEY for proper job assignment
    • Added explicit flush logging handler for better systemd journal visibility
    • Enhanced systemd unit with unbuffered logging environment variables

  • ✅ Blockchain-Operations Skill Enhancement

    • Updated skill with comprehensive Ollama testing scenarios
    • Created detailed test documentation in ollama-test-scenario.md
    • Added end-to-end test automation script template
    • Documented common issues, troubleshooting, and performance metrics

  • ✅ Documentation Updates

    • Updated docs/developer/testing/localhost-testing-scenario.md with CLI wrapper usage
    • Converted all examples to use localhost URLs (127.0.0.1) instead of production
    • Added host user paths and quick start commands
    • Documented complete testing workflow from setup to verification

Explorer Live Data Integration

  • ✅ Explorer API Integration

    • Switched explorer from mock data to live Coordinator API
    • Fixed receipt display: jobId, miner, payment amounts now shown correctly
    • Fixed address balances: calculated from actual job receipts
    • Updated all page text to indicate "Live data from AITBC coordinator API"

  • ✅ CLI Tool Enhancement

    • Added admin-cancel-running command to cancel all hanging jobs at once
    • Useful for cleaning up stuck jobs from dev/test sessions

Repository Reorganization

  • ✅ Root Level Cleanup - Moved 60+ loose files to proper directories

    • scripts/deploy/ - 9 deployment scripts
    • scripts/gpu/ - 13 GPU miner files
    • scripts/test/ - 7 test/verify scripts
    • scripts/service/ - 7 service management scripts
    • systemd/ - 4 systemd service files
    • infra/nginx/ - 5 nginx config files
    • website/dashboards/ - 2 dashboard HTML files
    • docs/ - 8 documentation MD files

  • ✅ Website/Docs Folder Structure

    • Moved HTML documentation to /website/docs/
    • Created shared CSS: /website/docs/css/docs.css (1232 lines)
    • Created theme toggle JS: /website/docs/js/theme.js
    • Migrated all HTML files to use external CSS (reduced file sizes 45-66%)
    • Cleaned /docs/ folder to only contain mkdocs markdown files

  • ✅ Dark Theme Fixes

    • Fixed background color consistency across all docs pages
    • Added dark theme support to full-documentation.html
    • Fixed Quick Start section cascade styling in docs-miners.html
    • Fixed SDK Examples cascade indentation in docs-clients.html
    • Updated API endpoint example to use Python/FastAPI (matches actual codebase)

  • ✅ Path References Updated

    • Updated systemd service file with new scripts/gpu/gpu_miner_host.py path
    • Updated skill documentation with new file locations
    • Updated localhost-testing-scenario.md with correct paths

  • ✅ Comprehensive .gitignore

    • Expanded from 39 to 145 lines with organized sections
    • Added project-specific rules for coordinator, explorer, GPU miner

Repository File Audit & Cleanup

  • ✅ File Audit Document (docs/files.md)

    • Created comprehensive audit of all 849 repository files
    • Categorized into Whitelist (60), Greylist (0), Placeholders (12), Removed (35)
    • All greylist items resolved - no pending reviews

  • ✅ Abandoned Folders Removed (35 items total)

    • ecosystem*/ (4 folders), enterprise-connectors/, research/
    • apps/client-web/, apps/marketplace-ui/, apps/wallet-cli/
    • apps/miner-node/, apps/miner-dashboard/
    • packages/py/aitbc-core/, aitbc-p2p/, aitbc-scheduler/
    • packages/js/ui-widgets/
    • python-sdk/, windsurf/, configs/, docs/user-guide/, docs/bootstrap/
    • api/, governance/, protocols/
    • 5 GPU miner variants, 3 extension variants

  • ✅ Docs Folder Reorganization

    • Root now contains only: done.md, files.md, roadmap.md
    • Created new subfolders: _config/, reference/components/, reference/governance/
    • Created: operator/deployment/, operator/migration/
    • Created: developer/testing/, developer/integration/
    • Moved 25 files to appropriate subfolders
    • Moved receipt spec: protocols/receipts/spec.md → docs/reference/specs/receipt-spec.md

  • ✅ Roadmap Updates

    • Added Stage 19: Placeholder Content Development
    • Added Stage 20: Technical Debt Remediation (blockchain-node, solidity-token, ZKReceiptVerifier)

Stage 19: Placeholder Content Development (2026-01-24)

  • ✅ Phase 1: Documentation (17 files created)

    • User Guides (docs/user/guides/): 8 files
      • getting-started.md, job-submission.md, payments-receipts.md, troubleshooting.md
    • Developer Tutorials (docs/developer/tutorials/): 5 files
      • building-custom-miner.md, coordinator-api-integration.md
      • marketplace-extensions.md, zk-proofs.md, sdk-examples.md
    • Reference Specs (docs/reference/specs/): 4 files
      • api-reference.md (OpenAPI 3.0), protocol-messages.md, error-codes.md

  • ✅ Phase 2: Infrastructure (8 files created)

    • Terraform Environments (infra/terraform/environments/):
      • staging/main.tf, prod/main.tf, variables.tf, secrets.tf, backend.tf
    • Helm Chart Values (infra/helm/values/):
      • dev/values.yaml, staging/values.yaml, prod/values.yaml

  • ✅ Phase 3: Application Components (13 files created)

    • Pool Hub Service (apps/pool-hub/src/app/):
      • routers/: miners.py, pools.py, jobs.py, health.py, init.py
      • registry/: miner_registry.py, init.py
      • scoring/: scoring_engine.py, init.py
    • Coordinator Migrations (apps/coordinator-api/migrations/):
      • 001_initial_schema.sql, 002_indexes.sql, 003_data_migration.py, README.md

Stage 20: Technical Debt Remediation (2026-01-24)

  • ✅ Blockchain Node SQLModel Fixes

    • Fixed models.py: Added __tablename__, proper Relationship definitions
    • Fixed type hints: List["Transaction"] instead of list["Transaction"]
    • Added sa_relationship_kwargs={"lazy": "selectin"} for efficient loading
    • Updated tests: 2 passing, 1 skipped (SQLModel validator limitation documented)
    • Created docs/SCHEMA.md with ERD and usage examples

  • ✅ Solidity Token Audit

    • Reviewed AIToken.sol and AITokenRegistry.sol
    • Added comprehensive tests: 17 tests passing
      • AIToken: 8 tests (minting, replay, zero address, zero units, non-coordinator)
      • AITokenRegistry: 9 tests (registration, updates, access control)
    • Created docs/DEPLOYMENT.md with full deployment guide

  • ✅ ZK Receipt Verifier Integration

    • Fixed ZKReceiptVerifier.sol to match receipt_simple circuit
    • Updated publicSignals to uint[1] (1 public signal: receiptHash)
    • Fixed authorization checks: require(authorizedVerifiers[msg.sender])
    • Created contracts/docs/ZK-VERIFICATION.md with integration guide