{ "openapi": "3.1.1", "info": { "title": "Cross-Chain Transaction Explorer API", "version": "1.0.0", "summary": "Follow one transaction across chains: source tx, bridge deposit and destination fill on a timeline.", "description": "Every endpoint performs the same calculation as the human page and returns inputs, result, units, assumptions, sources, warnings and computedAt. MCP endpoint: /mcp." }, "servers": [ { "url": "https://crosschaintransactionexplorer.usefulweb.site" } ], "paths": { "/api/v1/calculate": { "post": { "operationId": "calculate", "summary": "Follow one transaction across chains: source tx, bridge deposit and destination fill on a timeline.", "description": "Give a transaction hash on an EVM chain or a Solana signature. The explorer decodes the source transaction, detects bridge deposits (Circle CCTP, Across, OP Stack and Arbitrum canonical bridges, Wormhole messages), asks the bridge's own status service where the funds went, looks the destination transaction up on the destination chain, and draws the whole journey as one timeline and graph.\n\nMethodology:\n- EVM source: the Transaction Decoder tool decodes the transaction (status, block time, finality, call, token transfers); the Bridge Transfer Tracker tool finds bridge deposit events (CCTP v1/v2, Across, OP Stack, Arbitrum) and queries the bridge's status service.\n- Solana source: getTransaction (jsonParsed, maxSupportedTransactionVersion 0) on the public mainnet-beta RPC; invoked programs are matched against verified Wormhole and Circle CCTP program ids; token balance changes come from pre/post token balances.\n- Wormhole: the source hash is looked up on the Wormholescan operations API, which reports the target chain and the redeem transaction when delivered.\n- Destination: when a status service returns a destination transaction (e.g. the Across fillTx or a Wormhole redeem) on a supported EVM chain, it is decoded on that chain with the Transaction Decoder.\n- Elapsed time = destination block time − source block time. Pasted logs are decoded offline without any network call (no timestamps).", "tags": [ "web3" ], "x-mcp-tool": "cross_chain_transaction_explorer", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CrossChainTransactionExplorerInput" }, "examples": { "example1": { "summary": "CCTP burn Ethereum → Base from pasted logs (offline)", "value": { "mode": "logs", "chain": "ethereum", "logs": "[{\"address\":\"0xbd3fa81b58ba92a82136038b25adec7066af3155\",\"topics\":[\"0x2fa9ca894982930190727e75500a97d8dc500233a5065e0f3126c48fbe0343c0\",\"0x000000000000000000000000000000000000000000000000000000000001e240\",\"0x000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\",\"0x0000000000000000000000005aaeb6053f3e94c9b9a09f33669435e7ef1beaed\"],\"data\":\"0x000000000000000000000000000000000000000000000000000000000ee6b2800000000000000000000000005aaeb6053f3e94c9b9a09f33669435e7ef1beaed00000000000000000000000000000000000000000000000000000000000000060000000000000000000000001682ae6375c4e4a97e4b583bc394c861a46d89620000000000000000000000000000000000000000000000000000000000000000\"}]" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CrossChainTransactionExplorerResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tool": { "get": { "operationId": "getToolDefinition", "summary": "Inputs, output schema and examples for this tool", "responses": { "200": { "description": "Tool definition.", "content": { "application/json": { "schema": { "type": "object" } } } } } } } }, "components": { "schemas": { "Problem": { "type": "object", "description": "RFC 9457 problem details. 422 responses include per-field `errors`.", "required": [ "type", "title", "status", "detail" ], "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "code": { "type": "string" }, "errors": { "type": "array", "items": { "type": "object", "required": [ "field", "message" ], "properties": { "field": { "type": "string" }, "message": { "type": "string" } } } } } }, "CrossChainTransactionExplorerInput": { "type": "object", "additionalProperties": false, "properties": { "mode": { "title": "What do you have?", "type": "string", "enum": [ "lookup", "logs" ], "default": "lookup" }, "chain": { "title": "Source chain (EVM)", "description": "Ignored for Solana signatures, which are detected automatically.", "type": "string", "enum": [ "ethereum", "base", "arbitrum", "optimism", "polygon", "avalanche", "bsc" ], "default": "ethereum" }, "hash": { "title": "Transaction hash or Solana signature", "type": "string", "maxLength": 100 }, "logs": { "title": "Source receipt logs JSON (offline mode)", "description": "The \"logs\" array of eth_getTransactionReceipt.", "type": "string", "maxLength": 500000 }, "followDestination": { "title": "Look up the destination transaction", "type": "boolean", "default": true } }, "required": [] }, "CrossChainTransactionExplorerResult": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "tool", "computedAt", "inputs", "summary", "result", "units", "assumptions", "sources", "warnings", "presentation", "links" ], "properties": { "schemaVersion": { "type": "string", "const": "1.0" }, "tool": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "version" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "version": { "type": "string" } } }, "computedAt": { "type": "string", "format": "date-time" }, "inputs": { "type": "object", "description": "Normalised inputs actually used, including applied defaults." }, "summary": { "type": "string" }, "result": { "type": "object", "additionalProperties": false, "required": [ "mode", "sourceChain", "hash", "hops", "bridges", "solana", "elapsedSeconds", "timeline", "graph" ], "properties": { "mode": { "type": "string", "enum": [ "evm", "solana", "logs" ] }, "sourceChain": { "type": "string" }, "hash": { "type": [ "string", "null" ] }, "hops": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "chain", "hash", "role", "status", "timestamp", "block", "from", "to", "summary" ], "properties": { "chain": { "type": "string" }, "hash": { "type": "string" }, "role": { "type": "string", "enum": [ "source", "destination" ] }, "status": { "type": "string" }, "timestamp": { "type": [ "string", "null" ] }, "block": { "type": [ "integer", "null" ] }, "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] }, "summary": { "type": "string" } } } }, "bridges": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "protocol", "amount", "symbol", "sender", "recipient", "destination", "destinationChain", "status", "detail", "destinationTx" ], "properties": { "protocol": { "type": "string" }, "amount": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "sender": { "type": [ "string", "null" ] }, "recipient": { "type": [ "string", "null" ] }, "destination": { "type": "string" }, "destinationChain": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "detail": { "type": "string" }, "destinationTx": { "type": [ "string", "null" ] } } } }, "solana": { "type": [ "object", "null" ], "additionalProperties": false, "required": [ "signer", "slot", "fee", "programs", "bridgePrograms", "instructions", "tokenChanges", "solChange" ], "properties": { "signer": { "type": [ "string", "null" ] }, "slot": { "type": "integer" }, "fee": { "type": "integer" }, "programs": { "type": "array", "items": { "type": "string" } }, "bridgePrograms": { "type": "array", "items": { "type": "string" } }, "instructions": { "type": "array", "items": { "type": "string" } }, "tokenChanges": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "owner", "mint", "change" ], "properties": { "owner": { "type": "string" }, "mint": { "type": "string" }, "change": { "type": "string" } } } }, "solChange": { "type": [ "string", "null" ] } } }, "elapsedSeconds": { "type": [ "integer", "null" ] }, "timeline": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "time", "label", "detail", "tone", "chain", "hash" ], "properties": { "time": { "type": "string" }, "label": { "type": "string" }, "detail": { "type": "string" }, "tone": { "type": "string" }, "chain": { "type": "string" }, "hash": { "type": [ "string", "null" ] } } } }, "graph": { "type": "object", "additionalProperties": false, "required": [ "nodes", "edges" ], "properties": { "nodes": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "label", "kind" ], "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "kind": { "type": "string" } } } }, "edges": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "from", "to", "label" ], "properties": { "from": { "type": "string" }, "to": { "type": "string" }, "label": { "type": "string" } } } } } } } }, "units": { "type": "object", "additionalProperties": { "type": "string" } }, "assumptions": { "type": "array", "items": { "type": "string" } }, "sources": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "title" ], "properties": { "title": { "type": "string" }, "url": { "type": "string" }, "publisher": { "type": "string" }, "retrievedAt": { "type": "string" }, "note": { "type": "string" } } } }, "warnings": { "type": "array", "items": { "type": "string" } }, "presentation": { "type": "array", "items": { "type": "object" }, "description": "Display blocks used by the human page (same data)." }, "links": { "type": "object", "additionalProperties": false, "required": [ "human", "api", "openapi", "methodology" ], "properties": { "human": { "type": "string", "format": "uri" }, "api": { "type": "string", "format": "uri" }, "openapi": { "type": "string", "format": "uri" }, "methodology": { "type": "string", "format": "uri" } } } } } } } }