TaifoonTAIFOON
TaifoonTAIFOON
V5 PROOF API — CRYPTOGRAPHIC VERIFICATION PROTOCOL
05V5 PROOF API

V5 Proof API
Documentation

TL;DR
REST API for generating and verifying cryptographic inclusion proofs across 41 blockchains. <100ms response time, 2–4KB per proof. Currently in open beta — no API key required. On-chain Solidity verifier included: verify proofs without trusting any Taifoon infrastructure.
Generate and verify trustless, cryptographic proofs for block headers and transactions across 41 blockchain networks. Each proof uses MMR structures and can be verified both off-chain and on-chain without requiring trust in Taifoon infrastructure.
Key Features
Universal Format
Single proof format works across all supported chains (EVM, Solana, Bitcoin, etc.)
Compact Size
Average 2-4KB per proof, optimized for on-chain verification
Fast Generation
<100ms average response time
Cryptographically Verifiable
All proofs include merkle paths for independent verification
Chain-Specific Cryptography
Respects native consensus (PoS, PoW, BFT, TowerBFT, etc.)
01 — Authentication

The API is currently in open beta — no authentication required. All endpoints are freely accessible:

# No API key required during open beta curl https://taifoon.io/api/v5/proof/blob/1/24651876
API Keys Coming Soon
Authentication and rate limits will be added with paid tiers. Current integrations will continue to work — just add the Authorization header when auth goes live. See Pricing for timeline.
02 — Endpoints
1. Generate Block Proof

Generate a V5 proof for a specific block on any supported chain.

POST /api/v5/proof/block
{ chain_id: number; // Chain ID (e.g., 1 for Ethereum, 8453 for Base) block_number: number; // Block height to prove }
# Generate a block proof for Ethereum block 24651876 curl -X POST https://taifoon.io/api/v5/proof/block \ -H "Content-Type: application/json" \ -d '{ "chain_id": 1, "block_number": 24651876 }' # Response (V5ProofBlob): # { # "superroot": { # "superrootHash": "0x6577...", # "batchId": 1773445038, # "chainCount": 38, # "totalTwigs": 20457 # }, # "chainHeaders": [{ # "chainId": 1, # "chainType": 0, # "blockNumber": 24651876, # "blockHash": "0x3d60...", # "miniMmrRoot": "0x54d1...", # "twigCount": 235883 # }], # "superrootProof": { # "targetChainIndex": 0, # "siblings": ["0x34cf...", "0xd16a..."] # } # }
2. Generate Transaction Proof
POST /api/v5/proof/tx
{ chain_id: number; // Chain ID tx_hash: string; // Transaction hash (hex with 0x prefix) block_number: number; // Block containing the transaction }
3. Fetch Block Proof (Convenience GET)
GET /api/v5/proof/blob/:chain_id/:block_number
Cache Behavior
If proof was generated in last 24h, returns cached proof (<10ms). Otherwise, generates new proof (<100ms).
🧪 Interactive API Playground
Fetch complete V5 inclusion proof for latest Ethereum block (6-layer MMR proof + finality)
GET/api/lambda/proof-bundle/block/1/latest
Example Response:
{
  "chain_id": 1,
  "block_number": 24680000,
  "siblings": [
    "0xdd30...",
    "0x634c...",
    "0xbb7d...",
    "0x5e2e...",
    "0x53c0...",
    "0xf647..."
  ],
  "batch_id": 1773869521,
  "mini_mmr_root": "0xba35e73d320177d508c8972d1011a93dc39f77d9762330881e77bad3e99a950f",
  "super_root_hash": "a4bd851edc741b512ca6b4f6e2e21711666f75dcaf19250e487ddff10b5d8fac",
  "finality_block": 24687103,
  "is_finalized": true,
  "finality_type": "eth_pos_checkpoint",
  "transactions_root": "0x86ef...",
  "receipts_root": "0x0cd6...",
  "block_state_root": "0xe800..."
}
🤖 For AI Agents: This endpoint is also available via ai.taifoon.dev for agent testing