Receipts Sign & Verify Examples

This directory contains sample scripts demonstrating how to interact with the coordinator receipt endpoints and validate miner/coordinator signatures.

Prerequisites

Python 3.11+
Coordinator API running locally (defaults to http://localhost:8011)
Client API key with access to the coordinator (defaults to client_dev_key_1 in development fixtures)

Install the helper packages:

poetry install --directory packages/py/aitbc-crypto
poetry install --directory packages/py/aitbc-sdk

Fetch and Verify

fetch_and_verify.py fetches either the latest receipt or the entire receipt history for a job, then verifies miner signatures and optional coordinator attestations.

export PYTHONPATH=packages/py/aitbc-sdk/src:packages/py/aitbc-crypto/src
python examples/receipts-sign-verify/fetch_and_verify.py --job-id <job_id> \
  --coordinator http://localhost:8011 --api-key client_dev_key_1

Use --history to iterate over all stored receipts:

python examples/receipts-sign-verify/fetch_and_verify.py --job-id <job_id> --history

The script prints whether the miner signature and each coordinator attestation validated successfully.