arbtrace_get
Retrieve specific transaction trace data from Arbitrum chains by specifying a path and transaction hash. Works with Arbitrum Nitro nodes and supports natural language queries for monitoring and analysis.
Instructions
Get specific trace data at a given path within a transaction (requires trace API)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chainName | No | Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL | |
| path | No | Path to specific trace data | |
| rpcUrl | No | The RPC URL of the Arbitrum node (optional if default is set) | |
| txHash | Yes | Transaction hash |
Implementation Reference
- src/index.ts:560-577 (handler)MCP tool handler for 'arbtrace_get': resolves RPC URL using chainLookupService if chainName provided, creates NitroNodeClient, calls traceGet(txHash, path), formats result as JSON text content.case "arbtrace_get": { const rpcUrl = await this.resolveRpcUrl( (args.rpcUrl as string) || (args.chainName as string) ); const nodeClient = new NitroNodeClient(rpcUrl); const result = await nodeClient.traceGet( args.txHash as string, (args.path as string[]) || [] ); return { content: [ { type: "text", text: JSON.stringify(result, null, 2), }, ], }; }
- src/index.ts:1323-1351 (schema)Input schema and metadata definition for the 'arbtrace_get' tool, used in ListTools response.name: "arbtrace_get", description: "Get specific trace data at a given path within a transaction (requires trace API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, txHash: { type: "string", description: "Transaction hash", }, path: { type: "array", description: "Path to specific trace data", items: { type: "string" }, }, }, required: ["txHash"], }, },
- Helper method in NitroNodeClient that executes the actual 'arbtrace_get' RPC call to the Arbitrum node with txHash and path, handling errors.async traceGet(txHash: string, path: string[]): Promise<TraceResult> { try { const traces = await this.makeRpcCall("arbtrace_get", [txHash, path]); return { traces }; } catch (error) { return { traces: null, error: `Trace get not supported on this RPC endpoint: ${ (error as Error).message }`, }; } }