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

4.2 KiB

Raw Blame History

Payments and Receipts

This guide explains how payments work on the AITBC network and how to understand your receipts.

Payment Flow

Client submits job → Job processed by miner → Receipt generated → Payment settled

Step-by-Step

Job Submission: You submit a job with your prompt and parameters
Miner Selection: The Coordinator assigns your job to an available miner
Processing: The miner executes your job using their GPU
Receipt Creation: A cryptographic receipt is generated proving work completion
Settlement: AITBC tokens are transferred from client to miner

Understanding Receipts

Every completed job generates a receipt containing:

Field	Description
`receipt_id`	Unique identifier for this receipt
`job_id`	The job this receipt is for
`provider`	Miner address who processed the job
`client`	Your address (who requested the job)
`units`	Compute units consumed (e.g., GPU seconds)
`price`	Amount paid in AITBC tokens
`model`	AI model used
`started_at`	When processing began
`completed_at`	When processing finished
`signature`	Cryptographic proof of authenticity

Example Receipt

{
  "receipt_id": "rcpt-20260124-001234",
  "job_id": "job-abc123",
  "provider": "ait1miner...",
  "client": "ait1client...",
  "units": 2.5,
  "unit_type": "gpu_seconds",
  "price": 5.0,
  "model": "llama3.2",
  "started_at": 1737730800,
  "completed_at": 1737730803,
  "signature": {
    "alg": "Ed25519",
    "key_id": "miner-ed25519-2026-01",
    "sig": "Fql0..."
  }
}

Viewing Your Receipts

Explorer

Visit Explorer → Receipts to see:

All recent receipts on the network
Filter by your address to see your history
Click any receipt for full details

CLI

# List your receipts
./aitbc-cli.sh receipts

# Get specific receipt
./aitbc-cli.sh receipt <receipt_id>

API

curl https://aitbc.bubuit.net/api/v1/receipts?client=<your_address>

Pricing

How Pricing Works

Jobs are priced in compute units (typically GPU seconds)
Each model has a base rate per compute unit
Final price = units × rate

Current Rates

Model	Rate (AITBC/unit)	Typical Job Cost
`llama3.2`	2.0	2-10 AITBC
`llama3.2:1b`	0.5	0.5-2 AITBC
`codellama`	2.5	3-15 AITBC
`stable-diffusion`	5.0	10-50 AITBC

Rates may vary based on network demand and miner availability.

Getting AITBC Tokens

Via Exchange

Visit Trade Exchange
Create an account or connect wallet
Send Bitcoin to your deposit address
Receive AITBC at current exchange rate (1 BTC = 100,000 AITBC)

See Bitcoin Wallet Setup for detailed instructions.

Via Mining

Earn AITBC by providing GPU compute:

See Miner Documentation

Verifying Receipts

Receipts are cryptographically signed to ensure authenticity.

Signature Verification

from aitbc_crypto import verify_receipt

receipt = get_receipt("rcpt-20260124-001234")
is_valid = verify_receipt(receipt)
print(f"Receipt valid: {is_valid}")

On-Chain Verification

Receipts can be anchored on-chain for permanent proof:

ZK proofs enable privacy-preserving verification
See ZK Applications

Payment Disputes

If you believe a payment was incorrect:

Check the receipt - Verify units and price match expectations
Compare to job output - Ensure you received the expected result
Contact support - If discrepancy exists, report via the platform

Best Practices

Monitor your balance - Check before submitting large jobs
Set spending limits - Use API keys with rate limits
Keep receipts - Download important receipts for records
Verify signatures - For high-value transactions, verify cryptographically

Next Steps

Troubleshooting - Common payment issues
Getting Started - Back to basics

4.2 KiB Raw Blame History Unescape Escape