oib/aitbc

Files

oib 329b3beeba ```

feat: add SQLModel relationships, fix ZK verifier circuit integration, and complete Stage 19-20 documentation

- Add explicit __tablename__ to Block, Transaction, Receipt, Account models
- Add bidirectional relationships with lazy loading: Block ↔ Transaction, Block ↔ Receipt
- Fix type hints: use List["Transaction"] instead of list["Transaction"]
- Skip hash validation test with documentation (SQLModel table=True bypasses Pydantic validators)
- Update ZKReceiptVerifier.sol to match receipt_simple circuit (

2026-01-24 18:34:37 +01:00

001_initial_schema.sql

```

2026-01-24 18:34:37 +01:00

002_indexes.sql

```

2026-01-24 18:34:37 +01:00

003_data_migration.py

```

2026-01-24 18:34:37 +01:00

README.md

```

2026-01-24 18:34:37 +01:00

README.md

Coordinator API Migrations

Database migration scripts for the Coordinator API.

Files

File	Description
`001_initial_schema.sql`	Initial database schema (tables)
`002_indexes.sql`	Performance indexes
`003_data_migration.py`	Data migration utilities

Running Migrations

Prerequisites

PostgreSQL 14+
Python 3.10+ (for data migrations)
asyncpg package

Apply Schema

# Connect to database
psql -h localhost -U aitbc -d coordinator

# Run migrations in order
\i 001_initial_schema.sql
\i 002_indexes.sql

Run Data Migrations

# Install dependencies
pip install asyncpg

# Backfill job history
python 003_data_migration.py --action=backfill_history

# Update miner statistics
python 003_data_migration.py --action=update_stats

# Run all maintenance tasks
python 003_data_migration.py --action=all

# Migrate from SQLite
python 003_data_migration.py --action=migrate_jobs --input-file=/path/to/jobs.db

# Migrate receipts from JSON
python 003_data_migration.py --action=migrate_receipts --input-file=/path/to/receipts.json

Schema Overview

Tables

jobs - AI compute jobs
miners - Registered GPU miners
receipts - Cryptographic receipts
blocks - Blockchain blocks
transactions - On-chain transactions
api_keys - API authentication
job_history - Event history for analytics

Key Indexes

idx_jobs_pending - Fast pending job lookup
idx_miners_available - Available miner selection
idx_receipts_provider_created - Miner receipt history
idx_receipts_client_created - Client receipt history

Rollback

To rollback migrations:

-- Drop all tables (DESTRUCTIVE)
DROP TABLE IF EXISTS job_history CASCADE;
DROP TABLE IF EXISTS api_keys CASCADE;
DROP TABLE IF EXISTS transactions CASCADE;
DROP TABLE IF EXISTS blocks CASCADE;
DROP TABLE IF EXISTS receipts CASCADE;
DROP TABLE IF EXISTS miners CASCADE;
DROP TABLE IF EXISTS jobs CASCADE;