aitbc/docs/developer/testing/localhost-testing-scenario.md

AITBC Testing Scenario: Customer-Service Provider Interaction

Overview

This document outlines a comprehensive testing scenario for customers and service providers interacting on the AITBC platform. This scenario enables end-to-end testing of the complete marketplace workflow using the publicly accessible deployment at https://aitbc.bubuit.net/.

Integration Tests

Test Suite Status (Updated 2026-01-29)

The integration test suite has been updated to use real implemented features:

✅ Passing Tests (6)

1. End-to-End Job Execution - Tests complete job workflow
2. Multi-Tenant Isolation - Verifies tenant data separation
3. Block Propagation - Tests P2P network block sync
4. Transaction Propagation - Tests P2P transaction sync
5. Marketplace Integration - Connects to live marketplace
6. Security Integration - Uses real ZK proof features

🆕 Cross-Site Synchronization (2026-01-29)

• Multi-site blockchain deployment active
• 3 nodes across 2 sites with RPC synchronization
• Transaction propagation between sites enabled
• ✅ Block import endpoint fully functional (/blocks/import)
• Test endpoints:
  • Local nodes: https://aitbc.bubuit.net/rpc/, /rpc2/
  • Remote node: http://aitbc.keisanki.net/rpc/
• Status: ✅ COMPLETE - Full cross-site synchronization active

⏸️ Skipped Tests (1)

1. Wallet Payment Flow - Awaiting wallet-coordinator integration

Running Tests

# Run all integration tests
python -m pytest tests/integration/test_full_workflow.py -v

# Run specific test class
python -m pytest tests/integration/test_full_workflow.py::TestSecurityIntegration -v

# Run with real client (not mocks)
export USE_REAL_CLIENT=1
python -m pytest tests/integration/ -v

Test Features

• Tests work with both real client and mock fallback
• Security tests use actual ZK proof requirements
• Marketplace tests connect to https://aitbc.bubuit.net/marketplace
• All tests pass in CLI and Windsorf environments

Prerequisites

System Requirements

• Modern web browser (Chrome, Firefox, Safari, or Edge)
• Internet connection to access https://aitbc.bubuit.net/
• Terminal/command line access (for API testing)
• Python 3.11+ and virtual environment (for local testing)
• Ollama installed and running (for GPU miner testing)
• systemd (for running miner as service)

Local Development Setup

For localhost testing, ensure you have:

• AITBC repository cloned to /home/oib/windsurf/aitbc
• Virtual environment created: python3 -m venv .venv
• Dependencies installed: source .venv/bin/python -m pip install -e .
• Bash CLI wrapper: /home/oib/windsurf/aitbc/scripts/aitbc-cli.sh

Services Running

Ensure all AITBC services are accessible via:

• Coordinator API (http://127.0.0.1:18000/)
• Blockchain Node (http://127.0.0.1:19000/)
• Wallet Daemon (http://127.0.0.1:20000/)
• Marketplace UI (http://127.0.0.1:21000/)
• Explorer Web (http://127.0.0.1:22000/)
• Trade Exchange (http://127.0.0.1:23000/)
• Miner Dashboard (http://127.0.0.1:24000/)

Scenario: GPU Computing Service Marketplace

Actors

1. Customer - Wants to purchase GPU computing power
2. Service Provider - Offers GPU computing services
3. Platform - AITBC marketplace facilitating the transaction

Testing Workflow

Phase 1: Service Provider Setup

1.1 Register as a Service Provider

# Navigate to marketplace
http://127.0.0.1:21000/

# Click "Become a Provider"
# Fill in provider details:
- Provider Name: "GPUCompute Pro"
- Service Type: "GPU Computing"
- Description: "High-performance GPU computing for AI/ML workloads"
- Pricing Model: "Per Hour"
- Rate: "100 AITBC tokens/hour"

1.2 Configure Service Offering

# Example service configuration
service_config = {
    "service_id": "gpu-compute-001",
    "name": "GPU Computing Service",
    "type": "gpu_compute",
    "specs": {
        "gpu_type": "NVIDIA RTX 4090",
        "memory": "24GB",
        "cuda_cores": 16384,
        "supported_frameworks": ["PyTorch", "TensorFlow", "JAX"]
    },
    "pricing": {
        "rate_per_hour": 100,
        "currency": "AITBC"
    },
    "availability": {
        "start_time": "2024-01-01T00:00:00Z",
        "end_time": "2024-12-31T23:59:59Z",
        "timezone": "UTC"
    }
}

1.3 Register Service with Coordinator

# Using bash CLI wrapper
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh admin-miners

# Or POST to coordinator API directly
curl -X POST http://127.0.0.1:18000/v1/services/register \
  -H "Content-Type: application/json" \
  -H "X-API-Key: provider-api-key" \
  -d @service_config.json

Phase 2: Customer Discovery and Selection

2.1 Browse Available Services

# Customer navigates to marketplace
http://127.0.0.1:21000/

# Or use CLI to check coordinator status
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh health

# Filter by:
- Service Category: "GPU Computing"
- Price Range: "50-200 AITBC/hour"
- Availability: "Available Now"

2.2 View Service Details

# Using bash CLI wrapper
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh browser --receipt-limit 5

# Or GET service details via API
service_id="gpu-compute-001"
curl -X GET "http://127.0.0.1:18000/v1/services/${service_id}" \
  -H "X-API-Key: customer-api-key"

2.3 Verify Provider Reputation

# Check provider ratings and reviews
curl -X GET http://127.0.0.1:18000/v1/providers/gpu-compute-pro/reputation

# View transaction history
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh receipts --limit 10

Phase 3: Service Purchase and Execution

3.1 Purchase Service Credits

# Navigate to Trade Exchange
http://127.0.0.1:23000/

# Purchase AITBC tokens:
- Amount: 1000 AITBC
- Payment Method: Bitcoin (testnet)
- Exchange Rate: 1 BTC = 100,000 AITBC

# Or check balance via CLI
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh admin-stats

3.2 Create Service Job

# Using bash CLI wrapper (recommended)
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh submit inference \
  --prompt "Train a ResNet model on ImageNet" \
  --model llama3.2:latest \
  --ttl 900

# Example output:
# ✅ Job submitted successfully!
#    Job ID: 707c75d0910e49e2965196bce0127ba1

# Track job status
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh status 707c75d0910e49e2965196bce0127ba1

Or using Python/curl:

# Create job request
job_request = {
    "service_id": "gpu-compute-001",
    "customer_id": "customer-123",
    "requirements": {
        "task_type": "model_training",
        "framework": "PyTorch",
        "dataset_size": "10GB",
        "estimated_duration": "2 hours"
    },
    "budget": {
        "max_cost": 250,
        "currency": "AITBC"
    }
}

# Submit job
response = requests.post(
    "http://127.0.0.1:18000/v1/jobs/create",
    json=job_request,
    headers={"X-API-Key": "customer-api-key"}
)
job_id = response.json()["job_id"]

3.3 Monitor Job Progress

# Using bash CLI wrapper
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh status <job_id>

# Or real-time job monitoring via API
curl -X GET http://127.0.0.1:18000/v1/jobs/{job_id}/status

# WebSocket for live updates
ws://127.0.0.1:18000/v1/jobs/{job_id}/stream

# View blockchain transactions
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh browser --block-limit 5

3.4 Receive Results

# Using bash CLI wrapper to check receipts
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh receipts --job-id <job_id>

# Or download completed job results via API
response=$(curl -s -X GET "http://127.0.0.1:18000/v1/jobs/{job_id}/results" \
  -H "X-API-Key: customer-api-key")

echo "$response" | jq .

# Verify results with receipt
receipt=$(echo "$response" | jq -r .receipt)
# Verify receipt signature with customer public key

Or using Python:

import requests

response = requests.get(
    f"http://127.0.0.1:18000/v1/jobs/{job_id}/results",
    headers={"X-API-Key": "customer-api-key"}
)

# Verify results with receipt
receipt = response.json()["receipt"]
verified = verify_job_receipt(receipt, customer_public_key)

Phase 4: Payment and Settlement

4.1 Automatic Payment Processing

# Payment automatically processed upon job completion
# Check transaction on blockchain
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh browser --receipt-limit 1

# Or via RPC API
curl -X POST http://127.0.0.1:19000/api/v1/transaction/get \
  -d '{"tx_hash": "0x..."}'

4.2 Provider Receives Payment

# Provider checks wallet balance via CLI
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh admin-stats

# Or via wallet daemon API
curl -X GET http://127.0.0.1:20000/api/v1/wallet/balance \
  -H "X-API-Key: provider-api-key"

# Example output: {"balance": 100.0, "currency": "AITBC"}

Or using Python:

# Provider checks wallet balance
balance = wallet_daemon.get_balance(provider_address)
print(f"Received payment: {balance} AITBC")

4.3 Rate and Review

# Customer rates service via API
POST http://127.0.0.1:18000/v1/services/{service_id}/rate
{
    "rating": 5,
    "review": "Excellent service! Fast execution and great results.",
    "customer_id": "customer-123"
}

# Or check provider stats
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh admin-miners

Testing Scripts

Automated Test Runner

#!/usr/bin/env python3
"""
AITBC Test Runner for Marketplace
Tests complete customer-provider workflow
"""

import asyncio
import requests
import time
from datetime import datetime

class AITBCTestTester:
    def __init__(self):
        self.base_url = "http://127.0.0.1"
        self.coordinator_url = "http://127.0.0.1:18000"
        self.marketplace_url = "http://127.0.0.1:21000"
        self.exchange_url = "http://127.0.0.1:23000"
        self.cli_path = "/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh"
        
    async def run_full_scenario(self):
        """Run complete customer-provider test scenario"""
        print("Starting AITBC Test Scenario...")
        
        # Phase 1: Setup
        await self.setup_test_environment()
        
        # Phase 2: Provider Registration
        provider_id = await self.register_provider()
        
        # Phase 3: Service Registration
        service_id = await self.register_service(provider_id)
        
        # Phase 4: Customer Setup
        customer_id = await self.setup_customer()
        
        # Phase 5: Service Discovery
        await self.test_service_discovery()
        
        # Phase 6: Job Creation and Execution
        job_id = await self.create_and_execute_job(service_id, customer_id)
        
        # Phase 7: Payment and Settlement
        await self.test_payment_flow(job_id)
        
        # Phase 8: Review and Rating
        await self.test_review_system(service_id, customer_id)
        
        print("Test scenario completed successfully!")
        
    async def setup_test_environment(self):
        """Setup test wallets and accounts"""
        print("Setting up test environment...")
        # Create test wallets for customer and provider
        # Fund test accounts with AITBC tokens
        
    async def register_provider(self):
        """Register a test service provider"""
        print("Registering service provider...")
        # Implementation here
        
    async def register_service(self, provider_id):
        """Register a test service"""
        print("Registering service...")
        # Implementation here
        
    async def setup_customer(self):
        """Setup test customer"""
        print("Setting up customer...")
        # Implementation here
        
    async def test_service_discovery(self):
        """Test service discovery functionality"""
        print("Testing service discovery...")
        # Implementation here
        
    async def create_and_execute_job(self, service_id, customer_id):
        """Create and execute a test job"""
        print("Creating and executing job...")
        # Implementation here
        return "test-job-123"
        
    async def test_payment_flow(self, job_id):
        """Test payment processing"""
        print("Testing payment flow...")
        # Implementation here
        
    async def test_review_system(self, service_id, customer_id):
        """Test review and rating system"""
        print("Testing review system...")
        # Implementation here

if __name__ == "__main__":
    tester = AITBCTestTester()
    asyncio.run(tester.run_full_scenario())

Manual Testing Checklist

Pre-Test Setup

• All services running and accessible
• Test wallets created with initial balance
• SSL certificates configured (if using HTTPS)
• Browser cache cleared

Provider Workflow

• Provider registration successful
• Service configuration accepted
• Service appears in marketplace listings
• Provider dashboard shows active services

Customer Workflow

• Customer can browse marketplace
• Service search and filters working
• Service details display correctly
• Job submission successful
• Real-time progress updates working
• Results download successful
• Payment processed correctly

Post-Transaction

• Provider receives payment
• Transaction visible on explorer
• Review system working
• Reputation scores updated

Test Data and Mock Services

Sample GPU Service Configurations

{
  "services": [
    {
      "id": "gpu-ml-training",
      "name": "ML Model Training",
      "type": "gpu_compute",
      "specs": {
        "gpu": "RTX 4090",
        "memory": "24GB",
        "software": ["PyTorch 2.0", "TensorFlow 2.13"]
      },
      "pricing": {"rate": 100, "unit": "hour", "currency": "AITBC"}
    },
    {
      "id": "gpu-rendering",
      "name": "3D Rendering Service",
      "type": "gpu_compute",
      "specs": {
        "gpu": "RTX 4090",
        "memory": "24GB",
        "software": ["Blender", "Maya", "3ds Max"]
      },
      "pricing": {"rate": 80, "unit": "hour", "currency": "AITBC"}
    }
  ]
}

Mock Job Templates

# Machine Learning Training Job
ml_job = {
    "type": "ml_training",
    "parameters": {
        "model": "resnet50",
        "dataset": "imagenet",
        "epochs": 10,
        "batch_size": 32
    },
    "expected_duration": "2 hours",
    "estimated_cost": 200
}

# 3D Rendering Job
render_job = {
    "type": "3d_render",
    "parameters": {
        "scene": "architectural_visualization",
        "resolution": "4K",
        "samples": 256,
        "engine": "cycles"
    },
    "expected_duration": "3 hours",
    "estimated_cost": 240
}

Monitoring and Debugging

Log Locations

# Service logs (localhost)
sudo journalctl -u coordinator-api.service -f
sudo journalctl -u aitbc-blockchain.service -f
sudo journalctl -u wallet-daemon.service -f
sudo journalctl -u aitbc-host-gpu-miner.service -f

# Application logs
tail -f /var/log/aitbc/marketplace.log
tail -f /var/log/aitbc/exchange.log

# Virtual environment logs
cd /home/oib/windsurf/aitbc
source .venv/bin/activate

Debug Tools

# Check service health
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh health

curl http://127.0.0.1:18000/v1/health
curl http://127.0.0.1:19000/api/v1/health

# Monitor blockchain
curl http://127.0.0.1:19000/api/v1/block/latest

# Check active jobs
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh admin-jobs

# Verify transactions
/home/oib/windsurf/aitbc/scripts/aitbc-cli.sh browser --tx-limit 5

# Run GPU miner manually for debugging
cd /home/oib/windsurf/aitbc
source .venv/bin/activate
python3 gpu_miner_host.py

# Or as systemd service
sudo systemctl restart aitbc-host-gpu-miner.service
sudo journalctl -u aitbc-host-gpu-miner.service -f

Common Issues and Solutions

Service Not Accessible

• Check if service is running: sudo systemctl status [service-name]
• Verify port is not blocked: netstat -tlnp | grep [port]
• Check nginx configuration: sudo nginx -t
• For localhost: ensure services are running in Incus container
• Check coordinator API: /home/oib/windsurf/aitbc/scripts/aitbc-cli.sh health

Transaction Failed

• Verify wallet balance: curl http://127.0.0.1:20000/api/v1/wallet/balance
• Check gas settings: Ensure sufficient gas for transaction
• Verify network sync: curl http://127.0.0.1:19000/api/v1/sync/status

Job Not Starting

• Check service availability: curl http://127.0.0.1:18000/v1/services/{id}
• Verify customer balance: Check wallet has sufficient tokens
• Review job requirements: Ensure they match service capabilities
• Check if miner is running: sudo systemctl status aitbc-host-gpu-miner.service
• View miner logs: sudo journalctl -u aitbc-host-gpu-miner.service -n 50
• Submit test job: /home/oib/windsurf/aitbc/scripts/aitbc-cli.sh submit inference --prompt "test" --model llama3.2:latest

Performance Testing

Load Testing Script

"""
Simulate multiple customers and providers
"""
import asyncio
import aiohttp

async def simulate_load(num_customers=10, num_providers=5):
    """Simulate marketplace load"""
    async with aiohttp.ClientSession() as session:
        # Create providers
        providers = []
        for i in range(num_providers):
            provider = await create_provider(session, f"provider-{i}")
            providers.append(provider)
        
        # Create customers and jobs
        jobs = []
        for i in range(num_customers):
            customer = await create_customer(session, f"customer-{i}")
            job = await create_job(session, customer, random.choice(providers))
            jobs.append(job)
        
        # Monitor execution
        await monitor_jobs(session, jobs)

Security Considerations for Testing

Test Network Isolation

• Use testnet blockchain, not mainnet
• Isolate test wallets from production funds
• Use test API keys, not production keys

Data Privacy

• Sanitize PII from test data
• Use synthetic data for testing
• Clear test data after completion

Next Steps

1. Production Readiness

   • Security audit of test scenarios
   • Performance benchmarking
   • Documentation review

2. Expansion

   • Add more service types
   • Implement advanced matching algorithms
   • Add dispute resolution workflow

3. Automation

   • CI/CD integration for test scenarios
   • Automated regression testing
   • Performance monitoring alerts

Conclusion

This localhost testing scenario provides a comprehensive environment for validating the complete AITBC marketplace workflow. It enables developers and testers to verify all aspects of the customer-provider interaction in a controlled setting before deploying to production.

Quick Start Commands

# 1. Setup environment
cd /home/oib/windsurf/aitbc
source .venv/bin/activate

# 2. Check all services
./scripts/aitbc-cli.sh health

# 3. Start GPU miner
sudo systemctl restart aitbc-host-gpu-miner.service
sudo journalctl -u aitbc-host-gpu-miner.service -f

# 4. Submit test job
./scripts/aitbc-cli.sh submit inference --prompt "Hello AITBC" --model llama3.2:latest

# 5. Monitor progress
./scripts/aitbc-cli.sh status <job_id>
./scripts/aitbc-cli.sh browser --receipt-limit 5

Host User Paths

• Repository: /home/oib/windsurf/aitbc
• Virtual Environment: /home/oib/windsurf/aitbc/.venv
• CLI Wrapper: /home/oib/windsurf/aitbc/scripts/aitbc-cli.sh
• GPU Miner Script: /home/oib/windsurf/aitbc/scripts/gpu/gpu_miner_host.py
• Systemd Unit: /etc/systemd/system/aitbc-host-gpu-miner.service
• Client Scripts: /home/oib/windsurf/aitbc/home/client/
• Test Scripts: /home/oib/windsurf/aitbc/home/