Taifoon — On-Chain Synchronization Layer

TAIFOON PROTOCOL — API REFERENCE

13API QUICK REFERENCE

API Quick Reference

TL;DR

REST API live at api.taifoon.dev: Cryptographic proofs, finality verification, event indexing, asset pricing, and trading signals across 27 chains. Open access (auth optional).

Available API Endpoints

GRID	METHOD	PATH	DESCRIPTION
G2	GET	/finality/:chain_id	Latest finalized block per chain
G2	GET	/finality/:chain_id/proof/:block	Finality proof for specific block
G1	GET	/v5/superroot	Latest SuperRoot V5 (all chains)
G1	GET	/v5/proof/:chain/:block	Cryptographic inclusion proof
G3	GET	/events/:order_id	Event synchronization state
G3	POST	/bloom/query	Universal bloom filter (address/topic presence)
G3	GET	/v5/proof/tx/:chain_id/:tx_hash	Transaction with MPT proof (indexed txs only)
G3	GET	/v5/proof/event/:chain_id/:block_number/:tx_index/:log_index	Event with receipt proof (indexed events only)
G4	GET	/price/:chain/:token	DEX price snapshot (TWAP/reserves)
G5	GET	/signals/launches	Token launch signals (SSE stream)
G5	GET	/signals/arb	Cross-chain arbitrage opportunities

Base URL: https://taifoon.io · All responses include V5 proof anchors · Authentication: X-Taifoon-Key header (optional)

Working Examples — Cryptographic Proofs

Transaction Proof — Ethereum

curl https://taifoon.io/v5/proof/tx/1/0xabc...def

Returns: Transaction data + MPT proof siblings + receipt root + block header. Use the proof to verify the transaction was included in the canonical chain without trusting the API. Note: Only indexed transactions are available (bloom-gated collection).

Event Proof — Polygon

curl https://taifoon.io/v5/proof/event/137/:block_number/:tx_index/:log_index

Returns: Event log + receipt proof + bloom filter verification path. Requires block_number, tx_index (position in block), and log_index (position in receipt). Enables deterministic cross-chain event verification. Note: Only indexed events are available.

SuperRoot Anchor — All Chains

curl https://taifoon.io/v5/superroot

Returns: Latest SuperRoot hash + all 9 Mini-MMR roots + block refs for 27 chains. This is the global anchor for all Taifoon proofs. Use it to verify any block inclusion proof against the canonical multi-chain state.

Block Inclusion Proof — Arbitrum

curl https://taifoon.io/api/lambda/proof-bundle/block/42161/24680000

Returns: Block header + Merkle siblings (6 levels) + chain_id + super_root_hash + finality metadata. Use this proof to verify that block 24,680,000 on Arbitrum was collected by Taifoon and included in the SuperRoot MMR.

Contract Addresses — EVM Arbitrum Sepolia

FOON Token

0x7EbD02ab3236DA856B4D0289A2CAd3E5b4BDBEA0

FOON Staking

0x26bB2de46AFd5C242Ca2F4200E81bE1df52659Dc

Reward Distributor

0x2d70a5Fb7f9190eF8D56304FC4C68535d2b8BC4B

Contract Addresses — Solana Devnet

Teleport Vault (SPL Token Escrow)

FY9fkzfvdY61Nj4PLL5BMZCMMiRsoUZPq5jj1qkpwRmE

These are devnet/testnet addresses. Mainnet addresses will be published after security audits.

Proof Generation API

Endpoint	What It Returns	Proof Level	Use Case
/kv/proof/:chain_id/:block_number	MMR inclusion proof for a block	Level 3–5 (Twig → SuperRoot)	Bridge settlement, state sync
/kv/super-root/latest	Current SuperRoot + all 9 Mini-MMR roots	Level 5	On-chain anchor reference
/api/finality/:chain_id/proof/:block	Finality proof for a specific block	Level 5 + finality metadata	Dispute resolution, L2 settlement
POST /kv/verify	Proof validity check (off-chain)	All levels	Pre-submission validation
/kv/blob/:superroot_hash	Full SuperRoot blob by hash	Level 5	Archival / audit retrieval
/v5/tx/:chain/:hash	Transaction + MPT proof	Level 1–5 (full chain)	Trustless TX verification
/v5/event/:chain/:tx/:log_index	Event log + receipt proof	Level 1–5 (full chain)	Cross-chain messaging

Pricing Tiers

Taifoon offers three pricing models depending on integration depth and volume requirements. All plans include V5 proof anchors and cryptographic verification.

PAY-AS-YOU-GO / SUBSCRIBERS

Self-serve metered billing · $10/1M tokens (1M free) · Verification + Pricing + Signals + Lambda

For: Trading Bots · DApp Devs · Quant · Retail · DAOs
Grids: Finality + Pricing + Signals + Events
Monthly: $21-65/mo (typical usage)

MONTHLY / ANNUAL · INTEGRATORS

White-label embed, 70/30 split · $99-999/mo or $999-9,999/yr · Cryptographic proofs · 99.9% SLA

For: Messaging · Oracle · Bridges · Indexers · Market Makers · DEX Agg · Relayers
Grids: All standard grids + white-label dashboard
Monthly: $35-2,500/mo

ENTERPRISE / STRATEGIC

Custom grids, capital partners · White-label dashboard · Rev share · enterprise@taifoon.dev

For: Bridge Infra · L1s/L2s · Accelerators · VCs
Grids: Proprietary grids + custom infrastructure
Pricing: Negotiated

Authentication

API key authentication is optional. Add the X-Taifoon-Key header to bypass rate limits and access premium features. Keys are generated at scanner.taifoon.dev/grids.

curl -H "X-Taifoon-Key: your_api_key" https://taifoon.io/v5/superroot

Rate limits: 100 req/min (no key) → 5,000 req/min (paid plan)

Error Codes

Code	Meaning
400	Invalid request parameters
401	Missing or invalid API key
429	Rate limit exceeded
500	Internal server error
503	Chain temporarily unavailable

Response Format

All responses are JSON. Most endpoints return structured data directly. Proof endpoints return block headers with Merkle siblings for verification. Event endpoints include MPT proofs and receipt paths.

Integration Examples

Verify Transaction Inclusion (TypeScript)

const proof = await fetch('https://taifoon.io/v5/proof/tx/1/0xabc...def')
  .then(r => r.json());

// Verify MPT siblings match receipt root
const isValid = verifyMPTProof(
  proof.transaction,
  proof.siblings,
  proof.receiptRoot
);

if (isValid) {
  console.log('TX verified against SuperRoot:', proof.superRootHash);
}

Stream Token Launch Signals (SSE)

const eventSource = new EventSource('https://taifoon.io/signals/launches');

eventSource.addEventListener('token_launch', (event) => {
  const launch = JSON.parse(event.data);
  console.log('New token:', launch.symbol, 'on chain', launch.chainId);
  console.log('Initial liquidity:', launch.liquidityUSD);
  console.log('Proof:', launch.proofHash);
});