Proofs API - Fairseq Docs

Use the Proofs API to submit ordered batches, receive proof IDs, and fetch completed proofs.

Create a proof

TEXT

POST /v1/proofs

Request body

JSON

{
  "transactions": [
    { "hash": "0xabc...", "timestamp": 1704067200000 },
    { "hash": "0xdef...", "timestamp": 1704067200100 }
  ],
  "options": {
    "orderingRule": "fifo",
    "metadata": { "source": "my-dex" }
  }
}

Response

JSON

{
  "ok": true,
  "proof": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "proof_hash": "0x...",
    "lighthouse_epoch_start": 12345,
    "lighthouse_epoch_end": 12346,
    "transaction_count": 2
  }
}

Retrieve a proof

TEXT

GET /v1/proofs/{proof_id}

Response

JSON

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "proof_hash": "0x...",
  "proof_bytes": "0x...",
  "metadata": { "source": "my-dex" }
}

Errors

400 invalid_request when the batch is malformed
401 unauthorized when the API key is missing
429 rate_limited when you exceed your tier limits