API · 2 of 6
Proofs and chain reads
Prove a transaction, a log, an order or a protocol transition against the root, and read blocks, transactions, receipts and logs with the proof that ties each answer to it.
THE COORDINATION LAYER · one namespace at https://coord.taifoon.io/v1 · 48 operations on this page · machine-readable at /v1/openapi.json (see Reference)
Try it
Prove a Base transaction. The first ask builds the proof and can take about 10 seconds; later asks for the same transaction are quick.
curl https://coord.taifoon.dev/v1/proof/tx/8453/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ffRead the same transaction, its receipt and the latest block. Each answer says where it came from (indexed or fetched) and whether the block is final.
curl https://coord.taifoon.dev/v1/chain/8453/tx/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff
curl https://coord.taifoon.dev/v1/chain/8453/tx/0x0f7f432e5fb3e650618387cdfbe99e94c105675f7729cc85a9a61b6c678500ff/receipt
curl https://coord.taifoon.dev/v1/chain/8453/block/latestThe guide Prove a transaction walks through the proof, level by level, and how to check it yourself.
Every operation (48)
Each row is generated from the table that routes /v1. The answer of each operation, field by field, is in the OpenAPI document; see Reference.
| Operation | What it does | Auth |
|---|---|---|
GET /v1/proof/tx/solana/:sig | The layer’s attested record of a Solana signature: the pipe’s ack leaf, its batch root and the superroot once pushed — not a block proof. | none |
GET /v1/proof/tx/:chain/:tx | Proof that one transaction is inside the root. | none |
GET /v1/protocol/:protocol/order/:key | One order of any protocol leaf the producer holds — a LayerZero message by guid, an Across deposit, a Mayan order, an ERC-8183 job — its stages across chains, each with its transaction and its leaf under the superroot. | none |
GET /v1/protocol/:protocol/stuck | The orders of one protocol past their expected next stage, each with one named reason from the protocol stage register: a LayerZero message verified but not committed or committed but not executed, an Across deposit not filled, an ERC-8183 job submitted but not evaluated. | none |
GET /v1/protocol/:protocol/paths | Measured stage-to-stage times of one protocol per source and destination chain: seconds from the start stage to each later stage, p50, p90 and n. | none |
GET /v1/protocol/:protocol/quote | How long an order of this protocol takes from one chain to another, measured from delivered orders (fees where the protocol exposes them; a transfer’s price across bridges is /v1/compare). | none |
GET /v1/projects | Every project workspace: a project (a bridge, a solver, a messaging protocol) whose orders the layer rebuilds as the generic order steps — its protocol’s stages on the one job lifecycle — with a board per project. | key optional |
POST /v1/projects | Register a project once: its protocol leaves, the filters that pick its orders (chains, addresses, order key prefixes), an optional webhook that receives each new step, and the write outlets its key may reach (default none: read and stream only). A protocol the producer does not read yet is registered with its lane spec and state lane_pending. | key |
GET /v1/projects/lanes | Every member’s own stream service as a user lane: a project that named its contract, its events and which event moves an order to which stage (stream: taifoon.stream.spec.v1) is served here compiled — a manifest the producer’s lane compiler runs without a rebuild, and the stage register the boards, stuck reasons and path times use. | none |
GET /v1/projects/:id | One project’s board: its orders as steppers (each step its protocol stage, lifecycle state, chain, transaction, block, time, leaf and proof link), its stuck orders with named reasons, its path times, its key’s scopes and write outlets — or the lane it waits for. | none |
POST /v1/projects/:id | Change your project: its name, what it is, its filters (chains, addresses, order-key prefixes), its webhook (deliver.endpoint, null clears) or pause it. The protocols and the lane stay as registered. | open read; writes keyed |
GET /v1/ops/search | Which operation answers a question: one search over every public /v1 operation’s name, summary and search keywords, and the protocol register (a protocol it names fills :protocol in the hits). | none |
GET /v1/proof/verifiable/:chain | The newest block of a chain that can be proven now. | none |
GET /v1/proof/onchain/:chain/:id | The on-demand proof batch for one source-chain transaction, ready for a gate on the target chain. | none |
GET /v1/proof/blocks/:chain | Proof that one or more blocks (?blocks=a,b,c, up to 256) are inside the root. | none |
GET /v1/protocols/proven | Every protocol whose transitions are inside the root, and how current each source is. | none |
GET /v1/proof/log/:chain/:tx | Proof that one event log (?log_index=, as eth_getLogs reports it) is inside the root, ready for an on-chain verifier. | none |
GET /v1/proof/order/:protocol/:key | Proof of one order’s whole lifecycle (key like erc8183:8453:81401): every transition and its current state, inside the root. | none |
GET /v1/proof/transition/:protocol | Proof that given transitions (?seqs=0,1,2, up to 256) of a protocol are inside the root, in order. | none |
GET /v1/chain/:chain/block/:id | One block, like eth_getBlockByNumber / ByHash, with its proof: {id} = latest (the newest block in the chain’s tree) | finalized (the tip the superroot leaf names) | a number | a block hash. | none |
GET /v1/chain/:chain/tx/:hash | One transaction, like eth_getTransactionByHash with its outcome, every event decoded, and the proof that its block is in the superroot. | none |
GET /v1/chain/:chain/tx/:hash/receipt | One receipt, like eth_getTransactionReceipt: every log raw and decoded, each with its own inclusion proof link, and the block proof. | none |
GET /v1/chain/:chain/logs | Event logs, like eth_getLogs, paged: the held headers’ blooms pick the blocks that may match and only those are read; a window over 10,000 blocks is a scan job (202). | none |
GET /v1/chain/:chain/address/:addr/events | Account scan: every event the address emitted or is named in (as an indexed topic) over a block window, decoded, with proofs; the held headers’ blooms pick the blocks. | none |
GET /v1/chain/:chain/address/:addr/txs | Account scan: the transactions that produced an event naming the address, over a block window, with direction and proofs. | none |
GET /v1/chain/:chain/scans/:id | A scan job (a logs or account window over 10,000 blocks): each read advances it one step and returns its progress and the rows so far. | none |
GET /v1/chain/:chain/scans/:id/stream | A scan job as server-sent events: progress after each step, then done (or paused when the connection’s minute is up). | none |
GET /v1/transitions/:protocol | A protocol’s state transitions from the protocol trees (no chain is read): one order’s lifecycle (?key=) or a page of the history by sequence, with both proof steps recomputed. | none |
GET /v1/protocols/decoders | The protocols the producer decodes, the chain tiers, and the manifest a new one sends. | none |
POST /v1/protocols/register | Register a protocol’s contracts and events for decoding; a v2 manifest adds the Lambda definition (key, states, transitions, actions, finality, author). | key optional |
GET /v1/protocols/pending | The manifest approval queue: submitted, approved, rejected, deprecated. | open read; writes keyed |
POST /v1/protocols/:id/approve | Approve a submitted manifest. | open read; writes keyed |
POST /v1/protocols/:id/reject | Reject a submitted manifest with a reason. | open read; writes keyed |
POST /v1/genie/storage | Commit one stored genie state.: the content hash of a program's state, output or a person's record kept off Taifoon's boxes (IPFS, Arweave, S3, their own bucket) becomes a record leaf on the coord stream (order key storage:<hash>). A hash commits once; its proof is GET /v1/genie/storage/:hash/proof. | key |
GET /v1/genie/storage/:hash/proof | Prove a genie state existed.: a genie program's state, output or a person's record stored off Taifoon's boxes (IPFS, Arweave, S3, their own bucket) has its content hash committed as a record leaf on the coord stream; this answers the leaf's envelope, pass batch, batch root and, once the batch is pushed, the superroot and the path. The anchor is the existing one: Taifoon mainnet 3692781 every 5 minutes, no new chain write. | none |
GET /v1/chain/tx | Up to 25 transactions in one call: status, block, time, confirmations, fee and every known event decoded. | none |
GET /v1/desk/chains | The Chain Desk's chains.: every chain the desk serves with its family (evm, tron, substrate), CAIP-2 id, finality rule, sources and health, and what a desk should do now. | none |
GET /v1/desk/deposit/:chain/:tx | One transaction as a deposit: CREDIT, WAIT or REJECT with the reason, the common deposit records (taifoon.deposit.v1) and the evidence; fail closed (unreadable is WAIT). | none |
GET /v1/desk/deposits/:chain/:address | The deposits to an address over a block window, as common deposit records with their level (EVM and Tron tokens up to 2,000 blocks a call). | none |
GET /v1/desk/withdrawal/:chain/preflight | May a withdrawal go out now: SEND or HOLD with the reason and the best node (the rotation's nodes asked their head now). Nothing is broadcast. | none |
GET /v1/desk/withdrawal/:chain/:tx/receipt | A sent withdrawal: DELIVERED once it succeeded in a final block, else NOT_YET (terminal when it reverted), with the proof link. | none |
GET /v1/desk/finality/stream | The desk_finality lane of /v1/stream on its own connection (the same events, named as before). Server-sent events of the desk chains' finality: finalized each time a chain's final block moves, halt and resume from its health (fail closed); every event id is the resume cursor. | none |
GET /v1/desk/deposits/stream | The desk_deposits lane of /v1/stream on its own connection (the same events, named as before). Server-sent events of the deposits to watched addresses: each transfer once per level it reaches (seen, confirmed, final), resumable by Last-Event-ID. | none |
GET /v1/desk/lambdas | The deposit lambda registry: the built-in lambdas (evm, tron, substrate) and the third-party manifests (data only), each with its family, chains, finality, hash and whether a reader exists. | none |
GET /v1/desk/proof/transfer/:chain/:tx | Membership proof of one EVM transaction.: it is in a final block under the superroot, who signed it, and exactly which ERC-20 transfers it moved; the bundle verifies offline. | none |
GET /v1/desk/proof/transfers/:chain/:address | Completeness proof over final blocks.: every ERC-20 transfer to (in) or from (out) an address in a range, and a proof there is no other; NONE proves absence. | none |
GET /v1/desk/proof/account/:chain/:address | State proof of an account at a final block.: its nonce and native balance, and one ERC-20 balance by its slot; an address with no account is proven absent. | none |
GET /v1/desk/metrics | The Chain Desk's state per chain in the Prometheus text format., to scrape into an exchange's own monitoring; ?format=json for JSON. | none |