Implement RECEIPT_CLAIM transaction type

- Add status fields to Receipt model (status, claimed_at, claimed_by)
- Add RECEIPT_CLAIM handling to state_transition.py with validation and reward minting
- Add type field to Transaction model for reliable transaction type storage
- Update router to use TransactionRequest model to preserve type field
- Update poa.py to extract type from mempool transaction content and store only original payload
- Add RECEIPT_CLAIM to GasType enum with gas schedule

.windsurf/references/ai-operations-reference.md

@@ -1,5 +1,25 @@
 # AITBC AI Operations Reference
 
+This reference guide covers AI operations in the AITBC blockchain network, including job submission, resource allocation, marketplace interactions, agent coordination, and blockchain integration.
+
+## Table of Contents
+- [AI Job Types and Parameters](#ai-job-types-and-parameters)
+- [Ollama Integration](#ollama-integration)
+- [Resource Allocation](#resource-allocation)
+- [Marketplace Operations](#marketplace-operations)
+- [GPU Provider Marketplace](#gpu-provider-marketplace)
+- [Agent AI Workflows](#agent-ai-workflows)
+- [OpenClaw Agent Coordination](#openclaw-agent-coordination)
+- [Cross-Node AI Coordination](#cross-node-ai-coordination)
+- [Blockchain Integration](#blockchain-integration)
+- [AI Economics and Pricing](#ai-economics-and-pricing)
+- [AI Monitoring and Analytics](#ai-monitoring-and-analytics)
+- [API Endpoints](#api-endpoints)
+- [AI Security and Compliance](#ai-security-and-compliance)
+- [Troubleshooting AI Operations](#troubleshooting-ai-operations)
+- [Best Practices](#best-practices)
+- [Real-World Workflows](#real-world-workflows)
+
 ## AI Job Types and Parameters
 
 ### Inference Jobs
@@ -30,6 +50,56 @@
 
 # Audio processing
 ./aitbc-cli ai job submit --wallet genesis-ops --type multimodal --prompt "Transcribe audio" --audio-path "/path/to/audio.wav" --payment 150
+
+# Video analysis
+./aitbc-cli ai job submit --wallet genesis-ops --type multimodal --prompt "Analyze video content" --video-path "/path/to/video.mp4" --payment 300
+```
+
+### Streaming Jobs
+```bash
+# Real-time inference streaming
+./aitbc-cli ai job submit --wallet genesis-ops --type inference --prompt "Generate story" --stream true --payment 150
+
+# Continuous monitoring
+./aitbc-cli ai job submit --wallet genesis-ops --type monitoring --target "network" --interval 60 --payment 200
+```
+
+## Ollama Integration
+
+### Ollama Model Operations
+```bash
+# List available Ollama models
+python3 /opt/aitbc/plugins/ollama/client_plugin.py --list-models
+
+# Run inference with Ollama
+python3 /opt/aitbc/plugins/ollama/client_plugin.py --model llama2 --prompt "Generate code for REST API"
+
+# Submit Ollama job via CLI
+./aitbc-cli ai job submit --wallet genesis-ops --type ollama --model "llama2:7b" --prompt "Analyze this data" --payment 50
+
+# Use custom Ollama endpoint
+./aitbc-cli ai job submit --wallet genesis-ops --type ollama --endpoint "http://localhost:11434" --model "mistral" --prompt "Generate summary" --payment 75
+```
+
+### Ollama GPU Provider Integration
+```bash
+# Register as Ollama GPU provider
+./aitbc-cli gpu provider register --type ollama --models "llama2,mistral,codellama" --gpu-count 1 --price 0.05
+
+# Submit Ollama job to specific provider
+./aitbc-cli ai job submit --wallet genesis-ops --type ollama --provider "provider_123" --model "llama2" --prompt "Generate text" --payment 50
+
+# Monitor Ollama provider status
+./aitbc-cli gpu provider status --provider-id "provider_123"
+```
+
+### Ollama Batch Operations
+```bash
+# Batch inference
+./aitbc-cli ai job submit --wallet genesis-ops --type ollama --model "llama2" --batch-file "prompts.json" --payment 200
+
+# Parallel Ollama jobs
+./aitbc-cli ai job submit --wallet genesis-ops --type ollama --model "mistral" --parallel 4 --prompts "prompt1,prompt2,prompt3,prompt4" --payment 150
 ```
 
 ## Resource Allocation
@@ -57,6 +127,18 @@
 
 ## Marketplace Operations
 
+### Service Provider Registration
+```bash
+# Register as AI service provider
+./aitbc-cli market provider register --name "AI-Service-Pro" --wallet genesis-ops --verification full
+
+# Update service listing
+./aitbc-cli market service update --service-id "service_123" --price 60 --description "Updated description"
+
+# Deactivate service
+./aitbc-cli market service deactivate --service-id "service_123"
+```
+
 ### Creating AI Services
 ```bash
 # Image generation service
@@ -84,6 +166,59 @@
 ./aitbc-cli market order execute --service-id "service_123" --job-data "prompt:Generate landscape image"
 ```
 
+## GPU Provider Marketplace
+
+### GPU Provider Registration
+```bash
+# Register as GPU provider
+./aitbc-cli gpu provider register --name "GPU-Provider-1" --wallet genesis-ops --gpu-model "RTX4090" --gpu-count 4 --price 0.10
+
+# Register Ollama-specific provider
+./aitbc-cli gpu provider register --name "Ollama-Node" --type ollama --models "llama2,mistral" --gpu-count 2 --price 0.05
+
+# Update provider capacity
+./aitbc-cli gpu provider update --provider-id "provider_123" --gpu-count 8 --price 0.08
+```
+
+### GPU Provider Operations
+```bash
+# List available GPU providers
+./aitbc-cli gpu provider list
+
+# Search for specific GPU models
+./aitbc-cli gpu provider search --model "RTX4090"
+
+# Check provider availability
+./aitbc-cli gpu provider availability --provider-id "provider_123"
+
+# Get provider pricing
+./aitbc-cli gpu provider pricing --provider-id "provider_123"
+```
+
+### GPU Allocation from Providers
+```bash
+# Allocate from specific provider
+./aitbc-cli resource allocate --provider-id "provider_123" --gpu 2 --memory 16384 --duration 3600
+
+# Auto-select best provider
+./aitbc-cli resource allocate --auto-select --gpu 1 --memory 8192 --duration 1800 --criteria price
+
+# Allocate with provider preferences
+./aitbc-cli resource allocate --preferred-providers "provider_123,provider_456" --gpu 1 --memory 8192 --duration 3600
+```
+
+### GPU Provider Earnings
+```bash
+# Check provider earnings
+./aitbc-cli gpu provider earnings --provider-id "provider_123" --period "7d"
+
+# Withdraw earnings
+./aitbc-cli gpu provider withdraw --provider-id "provider_123" --wallet genesis-ops --amount 1000
+
+# Provider utilization report
+./aitbc-cli gpu provider utilization --provider-id "provider_123" --period "24h"
+```
+
 ## Agent AI Workflows
 
 ### Creating AI Agents
@@ -110,6 +245,44 @@
 ./aitbc-cli agent execute --name "ai-coordinator" --wallet genesis-ops --priority high
 ```
 
+## OpenClaw Agent Coordination
+
+### OpenClaw AI Agent Setup
+```bash
+# Initialize OpenClaw AI agent
+openclaw agent init --name ai-inference-agent --type ai-worker
+
+# Configure agent for AI operations
+openclaw agent configure --name ai-inference-agent --ai-model "llama2" --gpu-requirement 1
+
+# Deploy agent to node
+openclaw agent deploy --name ai-inference-agent --target-node aitbc1
+```
+
+### OpenClaw AI Workflows
+```bash
+# Execute AI workflow via OpenClaw
+openclaw execute --agent AI-InferenceAgent --task run_inference --prompt "Generate image" --model "stable-diffusion"
+
+# Coordinate multi-agent AI pipeline
+openclaw execute --agent CoordinatorAgent --task ai_pipeline --workflow "preprocess->inference->postprocess"
+
+# Monitor agent AI performance
+openclaw monitor --agent AI-InferenceAgent --metrics gpu,throughput,errors
+```
+
+### Cross-Agent Communication
+```bash
+# Send AI job result to another agent
+openclaw message --from AI-InferenceAgent --to Data-ProcessingAgent --payload "job_id:123,result:image.png"
+
+# Request resources from coordinator
+openclaw message --from AI-TrainingAgent --to Resource-CoordinatorAgent --payload "request:gpu,count:2,duration:3600"
+
+# Broadcast job completion
+openclaw broadcast --from AI-InferenceAgent --channel ai-jobs --payload "job_123:completed"
+```
+
 ## Cross-Node AI Coordination
 
 ### Multi-Node Job Submission
@@ -130,6 +303,56 @@ ssh aitbc1 'cd /opt/aitbc && source venv/bin/activate && ./aitbc-cli resource al
 ./aitbc-cli ai job status --multi-node
 ```
 
+## Blockchain Integration
+
+### AI Job on Blockchain
+```bash
+# Submit AI job with blockchain recording
+./aitbc-cli ai job submit --wallet genesis-ops --type inference --prompt "Generate image" --payment 100 --record-on-chain
+
+# Verify AI job on blockchain
+./aitbc-cli blockchain verify --job-id "job_123" --check-integrity
+
+# Get AI job transaction hash
+./aitbc-cli ai job tx-hash --job-id "job_123"
+```
+
+### AI Payments via Blockchain
+```bash
+# Pay for AI job with blockchain transaction
+./aitbc-cli ai payment pay --job-id "job_123" --wallet genesis-ops --amount 100 --on-chain
+
+# Check payment status on blockchain
+./aitbc-cli blockchain tx-status --tx-hash "0x123...abc"
+
+# Get AI payment history
+./aitbc-cli ai payment history --wallet genesis-ops --on-chain
+```
+
+### AI Smart Contract Integration
+```bash
+# Deploy AI service smart contract
+./aitbc-cli contract deploy --type ai-service --name "AI-Inference-Service" --wallet genesis-ops
+
+# Interact with AI smart contract
+./aitbc-cli contract call --contract "0x123...abc" --method submitJob --params "prompt:Generate image,payment:100"
+
+# Query AI smart contract state
+./aitbc-cli contract query --contract "0x123...abc" --method getJobStatus --params "job_id:123"
+```
+
+### AI Data Verification
+```bash
+# Verify AI output integrity
+./aitbc-cli ai verify --job-id "job_123" --check-hash --check-signature
+
+# Generate AI output proof
+./aitbc-cli ai proof --job-id "job_123" --output-path "/path/to/output.png"
+
+# Store AI result on blockchain
+./aitbc-cli ai store --job-id "job_123" --ipfs --on-chain
+```
+
 ## AI Economics and Pricing
 
 ### Job Cost Estimation
@@ -152,6 +375,33 @@ ssh aitbc1 'cd /opt/aitbc && source venv/bin/activate && ./aitbc-cli resource al
 
 ## AI Monitoring and Analytics
 
+### Advanced Metrics
+```bash
+# Detailed job metrics
+./aitbc-cli ai metrics detailed --job-id "job_123" --include gpu,memory,network,io
+
+# Agent performance comparison
+./aitbc-cli ai metrics compare --agents "agent1,agent2,agent3" --period "24h"
+
+# Cost analysis
+./aitbc-cli ai metrics cost --wallet genesis-ops --period "30d" --breakdown job_type,provider
+
+# Error analysis
+./aitbc-cli ai metrics errors --period "7d" --group-by error_type
+```
+
+### Real-time Monitoring
+```bash
+# Stream live metrics
+./aitbc-cli ai monitor live --job-id "job_123"
+
+# Monitor multiple jobs
+./aitbc-cli ai monitor multi --job-ids "job1,job2,job3"
+
+# Set up alerts
+./aitbc-cli ai alert create --condition "job_duration > 3600" --action notify --email admin@example.com
+```
+
 ### Job Monitoring
 ```bash
 # Monitor specific job
@@ -176,6 +426,63 @@ ssh aitbc1 'cd /opt/aitbc && source venv/bin/activate && ./aitbc-cli resource al
 ./aitbc-cli ai metrics throughput --nodes "aitbc,aitbc1" --period "24h"
 ```
 
+## API Endpoints
+
+### AI Job API
+```bash
+# Submit AI job via API
+curl -X POST http://localhost:8006/api/ai/job/submit \
+  -H "Content-Type: application/json" \
+  -d '{"wallet":"genesis-ops","type":"inference","prompt":"Generate image","payment":100}'
+
+# Get job status
+curl http://localhost:8006/api/ai/job/status?job_id=job_123
+
+# List all jobs
+curl http://localhost:8006/api/ai/jobs
+```
+
+### Resource API
+```bash
+# Allocate resources via API
+curl -X POST http://localhost:8006/api/resource/allocate \
+  -H "Content-Type: application/json" \
+  -d '{"agent_id":"ai-agent","gpu":1,"memory":8192,"duration":3600}'
+
+# Get resource utilization
+curl http://localhost:8006/api/resource/utilization?type=gpu&period=1h
+```
+
+### Marketplace API
+```bash
+# List services
+curl http://localhost:8006/api/market/services
+
+# Create service
+curl -X POST http://localhost:8006/api/market/service/create \
+  -H "Content-Type: application/json" \
+  -d '{"name":"AI Service","type":"inference","price":50,"wallet":"genesis-ops"}'
+
+# Bid on service
+curl -X POST http://localhost:8006/api/market/order/bid \
+  -H "Content-Type: application/json" \
+  -d '{"service_id":"service_123","amount":60,"wallet":"genesis-ops"}'
+```
+
+### GPU Provider API
+```bash
+# Register provider
+curl -X POST http://localhost:8006/api/gpu/provider/register \
+  -H "Content-Type: application/json" \
+  -d '{"name":"GPU Provider","gpu_model":"RTX4090","gpu_count":4,"price":0.10}'
+
+# Get provider status
+curl http://localhost:8006/api/gpu/provider/status?provider_id=provider_123
+
+# List providers
+curl http://localhost:8006/api/gpu/providers
+```
+
 ## AI Security and Compliance
 
 ### Secure AI Operations
@@ -198,11 +505,71 @@ ssh aitbc1 'cd /opt/aitbc && source venv/bin/activate && ./aitbc-cli resource al
 
 ## Troubleshooting AI Operations
 
-### Common Issues
-1. **Job Not Starting**: Check resource allocation and wallet balance
-2. **GPU Allocation Failed**: Verify GPU availability and driver installation
-3. **High Latency**: Check network connectivity and resource utilization
-4. **Payment Failed**: Verify wallet has sufficient AIT balance
+### Common Issues and Solutions
+
+#### Job Submission Failures
+```bash
+# Check wallet balance
+./aitbc-cli wallet balance --name genesis-ops
+
+# Verify network connectivity
+./aitbc-cli network status
+
+# Check AI service availability
+./aitbc-cli ai service status
+
+# Verify job parameters
+./aitbc-cli ai job validate --type inference --prompt "test" --payment 50
+```
+
+#### GPU Allocation Issues
+```bash
+# Check GPU availability
+nvidia-smi
+./aitbc-cli resource available --type gpu
+
+# Verify GPU provider status
+./aitbc-cli gpu provider status --provider-id "provider_123"
+
+# Check resource locks
+./aitbc-cli resource locks --list
+
+# Release stuck resources
+./aitbc-cli resource release --allocation-id "alloc_123" --force
+```
+
+#### Performance Issues
+```bash
+# Check system resources
+htop
+iostat -x 1
+
+# Monitor GPU usage
+nvidia-smi dmon
+./aitbc-cli resource utilization --type gpu --live
+
+# Check network latency
+ping aitbc1
+./aitbc-cli network latency --target aitbc1
+
+# Analyze job logs
+./aitbc-cli ai job logs --job-id "job_123" --tail 100
+```
+
+#### Payment Issues
+```bash
+# Check transaction status
+./aitbc-cli blockchain tx-status --tx-hash "0x123...abc"
+
+# Verify wallet state
+./aitbc-cli wallet info --name genesis-ops
+
+# Check payment queue
+./aitbc-cli ai payment queue --wallet genesis-ops
+
+# Retry failed payment
+./aitbc-cli ai payment retry --job-id "job_123"
+```
 
 ### Debug Commands
 ```bash
@@ -220,6 +587,100 @@ ping aitbc1
 curl -s http://localhost:8006/health
 ```
 
+## Real-World Workflows
+
+### Workflow 1: Batch Image Generation
+```bash
+# 1. Allocate GPU resources
+./aitbc-cli resource allocate --agent-id batch-gen --gpu 2 --memory 16384 --duration 7200
+
+# 2. Submit batch job
+./aitbc-cli ai job submit --wallet genesis-ops --type inference --batch-file "prompts.json" --parallel 4 --payment 400
+
+# 3. Monitor progress
+./aitbc-cli ai job status --job-id "job_123" --watch
+
+# 4. Verify results
+./aitbc-cli ai job verify --job-id "job_123" --check-integrity
+
+# 5. Release resources
+./aitbc-cli resource release --agent-id batch-gen
+```
+
+### Workflow 2: Distributed Model Training
+```bash
+# 1. Register GPU providers on multiple nodes
+ssh aitbc1 './aitbc-cli gpu provider register --name "GPU-1" --gpu-count 2 --price 0.10'
+ssh aitbc2 './aitbc-cli gpu provider register --name "GPU-2" --gpu-count 4 --price 0.08'
+
+# 2. Submit distributed training job
+./aitbc-cli ai job submit --wallet genesis-ops --type training --model "distributed-model" \
+  --nodes "aitbc,aitbc1,aitbc2" --dataset "training.json" --payment 1000
+
+# 3. Monitor training across nodes
+./aitbc-cli ai job status --job-id "job_456" --multi-node
+
+# 4. Collect training metrics
+./aitbc-cli ai metrics training --job-id "job_456" --nodes "aitbc,aitbc1,aitbc2"
+```
+
+### Workflow 3: Ollama GPU Provider Service
+```bash
+# 1. Set up Ollama on node
+ssh gitea-runner 'ollama serve &'
+ssh gitea-runner 'ollama pull llama2'
+ssh gitea-runner 'ollama pull mistral'
+
+# 2. Register as Ollama provider
+./aitbc-cli gpu provider register --name "Ollama-Provider" --type ollama \
+  --models "llama2,mistral" --gpu-count 1 --price 0.05
+
+# 3. Submit Ollama jobs
+./aitbc-cli ai job submit --wallet genesis-ops --type ollama --provider "Ollama-Provider" \
+  --model "llama2" --prompt "Analyze text" --payment 50
+
+# 4. Monitor provider earnings
+./aitbc-cli gpu provider earnings --provider-id "provider_789" --period "7d"
+```
+
+### Workflow 4: AI Service Marketplace
+```bash
+# 1. Create AI service
+./aitbc-cli market service create --name "Premium Image Gen" --type ai-inference \
+  --price 100 --wallet genesis-ops --description "High-quality image generation"
+
+# 2. Register as provider
+./aitbc-cli market provider register --name "AI-Service-Pro" --wallet genesis-ops
+
+# 3. Customer bids on service
+./aitbc-cli market order bid --service-id "service_123" --amount 110 --wallet customer-wallet
+
+# 4. Execute service
+./aitbc-cli market order execute --service-id "service_123" --job-data "prompt:Generate landscape"
+
+# 5. Verify completion
+./aitbc-cli market order status --order-id "order_456"
+```
+
+### Workflow 5: OpenClaw Multi-Agent Pipeline
+```bash
+# 1. Initialize agents
+openclaw agent init --name Data-Preprocessor --type data-worker
+openclaw agent init --name AI-Inference --type ai-worker
+openclaw agent init --name Result-Postprocessor --type data-worker
+
+# 2. Configure agents
+openclaw agent configure --name AI-Inference --ai-model "llama2" --gpu-requirement 1
+
+# 3. Execute pipeline
+openclaw execute --agent CoordinatorAgent --task run_pipeline \
+  --workflow "Data-Preprocessor->AI-Inference->Result-Postprocessor" \
+  --input "data.json" --output "results.json"
+
+# 4. Monitor pipeline
+openclaw monitor --pipeline pipeline_123 --realtime
+```
+
 ## Best Practices
 
 ### Resource Management
@@ -239,6 +700,10 @@ curl -s http://localhost:8006/health
 - Verify job integrity regularly
 - Monitor audit logs
 - Implement access controls
+- Use blockchain verification for critical jobs
+- Keep AI models and data isolated
+- Regular security audits of AI services
+- Implement rate limiting for API endpoints
 
 ### Performance
 - Use appropriate job types