```

chore: remove obsolete files and add Solidity build artifacts to .gitignore - Add ignore patterns for Solidity build artifacts (typechain-types, artifacts, cache) - Remove unused exchange mock API server (api/exchange_mock_api.py) - Remove obsolete client-web README placeholder - Remove deprecated marketplace-ui HTML implementation ```
2026-01-24 15:46:23 +01:00
parent 9b9c5beb23
commit 55ced77928
195 changed files with 951 additions and 30090 deletions
--- a/docs/developer/testing/localhost-testing-scenario.md
+++ b/docs/developer/testing/localhost-testing-scenario.md
@@ -0,0 +1,633 @@
+# 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/.
+
+## 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
+```bash
+# 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
+```python
+# 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
+```bash
+# 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
+```bash
+# 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
+```bash
+# 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
+```bash
+# 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
+```bash
+# 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
+```bash
+# 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:
+```python
+# 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
+```bash
+# 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
+```bash
+# 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:
+```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
+```bash
+# 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
+```bash
+# 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:
+```python
+# Provider checks wallet balance
+balance = wallet_daemon.get_balance(provider_address)
+print(f"Received payment: {balance} AITBC")
+```
+
+#### 4.3 Rate and Review
+```bash
+# 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
+```python
+#!/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
+```json
+{
+  "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
+```python
+# 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
+```bash
+# 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
+```bash
+# 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
+```python
+"""
+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
+
+```bash
+# 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/`