{"uid":"cap_wUTHZb7n5xGUQNvKgbqZR","slug":"zksync-era-transaction-finality-lookup-64280c73","name":"ZKsync Era Transaction Finality Lookup","description":"ZKsync Era transaction finality lookup. Returns the rollup-reported confirmation level, execution status and supporting evidence for one transaction hash. A deeper tier adds an independent Ethereum L1 cross-check of the commit, prove and execute transactions. Responses include a signed provenance receipt and list any missing data.","url":"https://b2a-finality.b2a-finality-endpoint.workers.dev/v1/finality?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["chain","tx"],"properties":{"tx":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"32-byte transaction hash on that rollup"},"chain":{"enum":["zksync"],"type":"string","description":"Rollup identifier (zksync)"},"depth":{"enum":["standard","deep"],"type":"string","description":"Finality depth: standard, or deep (zksync only, adds the L1 cross-check)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["schema_version","evidence","missing","receipt"],"properties":{"tier":{"enum":["standard","deep","batch"],"type":"string"},"missing":{"type":"array"},"receipt":{"type":"object"},"evidence":{"type":"array"},"schema_version":{"type":"string"},"execution_status":{"enum":["success","reverted","unknown"],"type":"string"},"confirmation_level":{"enum":["pending","sequencer_confirmed","l1_data_posted","l1_proven","finalized","inconclusive"],"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GfO8Acl8pnJSf0pxU4Br7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the rollup-reported confirmation level, execution status, and optional Ethereum L1 cross-check evidence for a ZKsync Era transaction hash.","exampleAgentPrompt":"Can you do a deep finality check on ZKsync transaction 0x3a1b2c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b and tell me its confirmation level, whether it succeeded or reverted, and include the L1 cross-check of the commit, prove, and execute transactions?","exampleUseCases":[{"title":"Confirm withdrawal reached Ethereum","prompt":"I just bridged funds out of ZKsync — can you check transaction 0xabc123...def456 on ZKsync with deep finality depth and tell me if it's been committed, proven, and executed on Ethereum L1 yet?"},{"title":"Audit reverted DeFi transaction","prompt":"Our DeFi protocol flagged a failed trade on ZKsync. Can you look up tx hash 0x9f8e7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e and tell me the execution status and what finality level it reached?"},{"title":"Automate payment confirmation check","prompt":"Before releasing the order, verify that ZKsync transaction 0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1234 has a confirmation level of at least l1_proven — use standard depth and return the signed provenance receipt."}],"resultDescription":"A JSON response containing: schema_version, confirmation_level enum (pending, sequencer_confirmed, l1_data_posted, l1_proven, finalized, inconclusive), execution_status enum (success, reverted, unknown), a finality tier label, an evidence array with supporting on-chain data, a signed provenance receipt object, and a list of any missing data fields. The deep tier additionally includes L1 cross-check data for the commit, prove, and execute transactions on Ethereum mainnet.","failureModes":["Invalid or malformed transaction hash (not matching ^0x[0-9a-fA-F]{64}$) returns a validation error","Transaction not found on ZKsync returns inconclusive confirmation_level with missing data listed","Deep depth requested but L1 data not yet available results in partial evidence with missing fields noted","Unsupported chain value (anything other than 'zksync') returns a schema validation error","Payment failure (insufficient USDC or x402 protocol error) blocks the response","Network timeout from ZKsync or Ethereum RPC during deep cross-check may produce partial results"],"whenToPreferThis":"Choose this endpoint when you need authoritative, evidence-backed finality status for a ZKsync Era transaction — especially when you need to verify L1 settlement (commit, prove, execute) rather than just rollup-level confirmation. The signed provenance receipt makes it suitable for audit trails and automated payment release workflows. Prefer the deep tier when L1 finality certainty is required (e.g., large withdrawals, cross-chain bridges, compliance checks). Use standard tier for faster, cheaper rollup-level confirmation checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:30:12.149Z","isFirstParty":false,"canonicalSlug":"zksync-era-transaction-finality-lookup-64280c73"}