--- updatedAt: 2026-03-05T10:56:24.000Z agentTools: projectIndex: https://docs.tatum.io/llms.txt --- # debug_traceBlockByHash - Berachain
Archive Method

Complex queries might take longer and incur additional cost

The **debug_traceBlockByHash** method allows developers to trace the execution of transactions within a block specified by its hash. This method is particularly useful for debugging purposes, as it provides detailed information about the execution of each transaction within the block, including the type of call, the addresses involved, the value transferred, the gas used, the input data, the output data, and any sub-calls made during the transaction. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "debug_traceBlockByHash - Berachain", "version": "1.0" }, "servers": [ { "url": "https://{berachain-network}.gateway.tatum.io", "description": "RPC Gateway - Recommended", "variables": { "berachain-network": { "enum": [ "berachain-mainnet" ], "default": "berachain-mainnet" } } }, { "url": "https://api.tatum.io/v3/blockchain/node/{berachain-network}", "description": "Deprecated", "variables": { "berachain-network": { "enum": [ "berachain-mainnet" ], "default": "berachain-mainnet" } } } ], "x-sandbox": { "category": { "type": { "name": "category", "type": "string", "enum": [ "core", "bundler", "nft", "token", "transfers", "transaction-receipts", "gas-manager", "trace", "debug", "gas-optimized-transactions", "private-transactions", "notify", "transaction-simulation" ] }, "value": "debug" } }, "paths": { "/": { "post": { "x-readme": { "samples-languages": [ "shell", "javascript", "python", "java", "php" ] }, "summary": "debug_traceBlockByHash - Berachain", "description": "
\n
Archive Method
\n

Complex queries might take longer and incur additional cost

\n
\n\nThe **debug_traceBlockByHash** method allows developers to trace the execution of transactions within a block specified by its hash.\nThis method is particularly useful for debugging purposes, as it provides detailed information about the execution of each transaction within the block, including the type of call, the addresses involved, the value transferred, the gas used, the input data, the output data, and any sub-calls made during the transaction.\n", "tags": [], "requestBody": { "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "id": { "type": "integer", "default": 1 }, "jsonrpc": { "type": "string", "default": "2.0" } } }, { "type": "object", "properties": { "method": { "default": "debug_traceBlockByHash", "type": "string" }, "params": { "type": "array", "description": "1. `string` - Block hash for the block to be traced\n2. `tracer` Object - Currently supports `callTracer` and `prestateTracer` (see above for definitions).\n", "minItems": 1, "maxItems": 1, "items": { "anyOf": [ { "type": "string", "title": "Block hash", "description": "block hash", "default": "0x7bd8357213af34d3fe7f725d9b21187a5a58127e39aac5776fd0594e3391ea6e" }, { "type": "object", "title": "Tracer", "default": {}, "properties": { "tracer": { "$ref": "#/paths/~1/post/requestBody/content/application~1json/schema/allOf/1/properties/params/prefixItems/1/properties/tracer" }, "tracerConfig": { "$ref": "#/paths/~1/post/requestBody/content/application~1json/schema/allOf/1/properties/params/prefixItems/1/properties/tracerConfig" } } } ] }, "prefixItems": [ { "type": "string", "title": "Block hash", "description": "block hash", "default": "0x7bd8357213af34d3fe7f725d9b21187a5a58127e39aac5776fd0594e3391ea6e" }, { "type": "object", "title": "Tracer", "default": {}, "properties": { "tracer": { "type": "string", "default": "callTracer", "enum": [ "callTracer", "prestateTracer" ], "description": "It might be callTracer or prestateTracer\n * `callTracer` - The calltracer keeps track of all call frames, including depth 0 calls, that are made during a transaction.\n * `prestateTracer` - The prestateTracer replays the transaction and tracks every part of state that occured during the transaction.\n" }, "tracerConfig": { "type": "object", "description": "An object that allows specifying configurations for the tracer.\n\nWhen using a tracer type disableMemory, disableStorage, disableStack, or disableReturnData will not have any effect. When no tracer is selected, the response defaults to Struct/opcode logger.\n", "properties": { "onlyTopCall": { "description": "When set to true, this will only trace the primary (top-level) call and not any sub-calls. It eliminates the additional processing for each call frame.", "type": "boolean" }, "disableStorage": { "description": "When enabled, it prevents tracing of storage changes made by the transaction being analyzed, which can reduce the resource requirements of the analysis. By default, this operation traces both memory and storage changes, but storage tracing can be particularly resource-intensive, especially for large transactions.", "type": "boolean" }, "disableStack": { "description": "When enabled, it skips tracing of stack changes made by the transaction being analyzed.", "type": "boolean" }, "disableMemory": { "description": "When true, it stops tracing of memory changes made by the transaction being analyzed, reducing resource requirements.", "type": "boolean" }, "disableReturnData": { "description": "When true, it prevents the method from tracing the return data of a transaction. This return data tracing can be very demanding on resources, as it requires a lot of time and processing power.", "type": "boolean" } } } } } ] } } } ] } } } }, "responses": { "200": { "description": "Returns - array of block traces", "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "id": { "type": "integer" }, "jsonrpc": { "type": "string" } } }, { "type": "object", "properties": { "result": { "type": "array", "description": "array of block traces", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "CALL or CREATE" }, "from": { "type": "string", "description": "20 Bytes - address of the sender" }, "to": { "type": "string", "description": "20 Bytes - address of the receiver. null when its a contract creation transaction" }, "value": { "type": "string", "description": "amount of value for transfer (in hex)" }, "gas": { "type": "string", "description": "amount of gas provided for the call (in hex)" }, "gasUsed": { "type": "string", "description": "amount of gas used during the call (in hex)" }, "input": { "type": "string", "description": "call data" }, "output": { "type": "string", "description": "return data" }, "error": { "type": "string", "description": "error, if any" }, "revertReason": { "type": "string", "description": "solidity revert reason, if any" }, "calls": { "type": "array", "description": "list of sub-calls" } } } } }, "example": { "jsonrpc": "2.0", "id": 1, "result": [ { "result": { "type": "CALL", "from": "0xe088776deabb472ffd2843e330e79c880a5f979e", "to": "0x70526cc7a6d6320b44122ea9d2d07670accc85a1", "value": "0xec5162", "gas": "0x7df99", "gasUsed": "0x34e29", "input": "0x00e051479210030000000000000000000000f160594a405d53811d3bc4766596efd80fd545a27000000000000000000000128acb080000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f56000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000009cc54410f805000000000000000000000000000fffd8963efd1fc6a506488495d951d5263988d2500000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002d6b175474e89094c44da98b954eedeac495271d0fc02aaa39b223fe8d0a0e5c4f27ead9083c756cc20001f4010001c4ba12222222228d8ba445958a75a0704d566bf2c80000000000000000000052bbbe2900000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f5600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f56000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000ff00000000000000000000000000000000008485b36623632ffa5e486008df4d0b6d363defdb00020000000000000000034a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000005f98805a4e8be255a32880fdec7f6728c6568ba000000000000000000000000000000000000000000000003acbfe2488ff5c000000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000000000f19663f2ca0454accad3e094448ea6f7744388045400000000000000000000128acb08000000000000000000000000dfee68a9adb981cd08699891a11cabe10f25ec44000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000003a6d6cd1833904000000000000000000000000000000000000000000000000000000000001000276a400000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002d5f98805a4e8be255a32880fdec7f6728c6568ba0c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000bb80000", "output": "0x", "calls": [ { "type": "CALL", "from": "0x70526cc7a6d6320b44122ea9d2d07670accc85a1", "to": "0x0000000000007f150bd6f54c40a34d7c3d5e9f56", "value": "0x0", "gas": "0x7b2a2", "gasUsed": "0x34064", "input": "0xe051479210030000000000000000000000f160594a405d53811d3bc4766596efd80fd545a27000000000000000000000128acb080000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f56000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000009cc54410f805000000000000000000000000000fffd8963efd1fc6a506488495d951d5263988d2500000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002d6b175474e89094c44da98b954eedeac495271d0fc02aaa39b223fe8d0a0e5c4f27ead9083c756cc20001f4010001c4ba12222222228d8ba445958a75a0704d566bf2c80000000000000000000052bbbe2900000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f5600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f56000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000ff00000000000000000000000000000000008485b36623632ffa5e486008df4d0b6d363defdb00020000000000000000034a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000005f98805a4e8be255a32880fdec7f6728c6568ba000000000000000000000000000000000000000000000003acbfe2488ff5c000000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000000000f19663f2ca0454accad3e094448ea6f7744388045400000000000000000000128acb08000000000000000000000000dfee68a9adb981cd08699891a11cabe10f25ec44000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000003a6d6cd1833904000000000000000000000000000000000000000000000000000000000001000276a400000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002d5f98805a4e8be255a32880fdec7f6728c6568ba0c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000bb80000", "output": "0x", "calls": [ { "type": "STATICCALL", "from": "0x0000000000007f150bd6f54c40a34d7c3d5e9f56", "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "gas": "0x77f15", "gasUsed": "0x9e6", "input": "0x70a08231000000000000000000000000dfee68a9adb981cd08699891a11cabe10f25ec44", "output": "0x0000000000000000000000000000000000000000000000313abf3c5282b4912f" }, { "type": "CALL", "from": "0x0000000000007f150bd6f54c40a34d7c3d5e9f56", "to": "0x60594a405d53811d3bc4766596efd80fd545a270", "value": "0x0", "gas": "0x76a9e", "gasUsed": "0xf59c", "input": "0x128acb080000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f56000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000009cc54410f805000000000000000000000000000fffd8963efd1fc6a506488495d951d5263988d2500000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002d6b175474e89094c44da98b954eedeac495271d0fc02aaa39b223fe8d0a0e5c4f27ead9083c756cc20001f40100", "output": "0xffffffffffffffffffffffffffffffffffffffffffffffc5311d4d18418aed2b00000000000000000000000000000000000000000000000009cc54410f805000", "calls": [ { "type": "CALL", "from": "0x60594a405d53811d3bc4766596efd80fd545a270", "to": "0x6b175474e89094c44da98b954eedeac495271d0f", "value": "0x0", "gas": "0x6df38", "gasUsed": "0x3312", "input": "0xa9059cbb0000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f5600000000000000000000000000000000000000000000003acee2b2e7be7512d5", "output": "0x0000000000000000000000000000000000000000000000000000000000000001" }, { "type": "STATICCALL", "from": "0x60594a405d53811d3bc4766596efd80fd545a270", "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "gas": "0x6a98c", "gasUsed": "0x9e6", "input": "0x70a0823100000000000000000000000060594a405d53811d3bc4766596efd80fd545a270", "output": "0x0000000000000000000000000000000000000000000000dbe172a2b8ca9ae46d" }, { "type": "CALL", "from": "0x60594a405d53811d3bc4766596efd80fd545a270", "to": "0x0000000000007f150bd6f54c40a34d7c3d5e9f56", "value": "0x0", "gas": "0x69cd4", "gasUsed": "0x2fa1", "input": "0xfa461e33ffffffffffffffffffffffffffffffffffffffffffffffc5311d4d18418aed2b00000000000000000000000000000000000000000000000009cc54410f8050000000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000002d6b175474e89094c44da98b954eedeac495271d0fc02aaa39b223fe8d0a0e5c4f27ead9083c756cc20001f4010000000000000000000000000000000000000000", "output": "0x", "calls": [ { "type": "CALL", "from": "0x0000000000007f150bd6f54c40a34d7c3d5e9f56", "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "value": "0x0", "gas": "0x67e20", "gasUsed": "0x2b11", "input": "0x23b872dd000000000000000000000000dfee68a9adb981cd08699891a11cabe10f25ec4400000000000000000000000060594a405d53811d3bc4766596efd80fd545a27000000000000000000000000000000000000000000000000009cc54410f805000", "output": "0x0000000000000000000000000000000000000000000000000000000000000001" } ] }, { "type": "STATICCALL", "from": "0x60594a405d53811d3bc4766596efd80fd545a270", "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "gas": "0x66b79", "gasUsed": "0x216", "input": "0x70a0823100000000000000000000000060594a405d53811d3bc4766596efd80fd545a270", "output": "0x0000000000000000000000000000000000000000000000dbeb3ef6f9da1b346d" } ] }, { "type": "CALL", "from": "0x0000000000007f150bd6f54c40a34d7c3d5e9f56", "to": "0xba12222222228d8ba445958a75a0704d566bf2c8", "value": "0x0", "gas": "0x66de6", "gasUsed": "0x11c84", "input": "0x52bbbe2900000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f5600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f56000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000ff00000000000000000000000000000000008485b36623632ffa5e486008df4d0b6d363defdb00020000000000000000034a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000005f98805a4e8be255a32880fdec7f6728c6568ba000000000000000000000000000000000000000000000003acbfe2488ff5c000000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000000", "output": "0x00000000000000000000000000000000000000000000003a9335df23feb747af", "calls": [ { "type": "CALL", "from": "0xba12222222228d8ba445958a75a0704d566bf2c8", "to": "0x8485b36623632ffa5e486008df4d0b6d363defdb", "value": "0x0", "gas": "0x60d56", "gasUsed": "0x4254", "input": "0x9d2c110c00000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000039d35935dae2cab038d40000000000000000000000000000000000000000000018f4c67acb2fb796ea8300000000000000000000000000000000000000000000000000000000000000000000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000005f98805a4e8be255a32880fdec7f6728c6568ba000000000000000000000000000000000000000000000003acbfe2488ff5c00008485b36623632ffa5e486008df4d0b6d363defdb00020000000000000000034a0000000000000000000000000000000000000000000000000000000000ec51330000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f560000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f5600000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000000", "output": "0x00000000000000000000000000000000000000000000003a9335df23feb747af" }, { "type": "CALL", "from": "0xba12222222228d8ba445958a75a0704d566bf2c8", "to": "0x6b175474e89094c44da98b954eedeac495271d0f", "value": "0x0", "gas": "0x5aa6d", "gasUsed": "0x297a", "input": "0x23b872dd0000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f56000000000000000000000000ba12222222228d8ba445958a75a0704d566bf2c800000000000000000000000000000000000000000000003acbfe2488ff5c0000", "output": "0x0000000000000000000000000000000000000000000000000000000000000001" }, { "type": "CALL", "from": "0xba12222222228d8ba445958a75a0704d566bf2c8", "to": "0x5f98805a4e8be255a32880fdec7f6728c6568ba0", "value": "0x0", "gas": "0x57251", "gasUsed": "0x3390", "input": "0xa9059cbb0000000000000000000000000000000000007f150bd6f54c40a34d7c3d5e9f5600000000000000000000000000000000000000000000003a9335df23feb747af", "output": "0x0000000000000000000000000000000000000000000000000000000000000001" } ] }, { "type": "CALL", "from": "0x0000000000007f150bd6f54c40a34d7c3d5e9f56", "to": "0x9663f2ca0454accad3e094448ea6f77443880454", "value": "0x0", "gas": "0x54b0b", "gasUsed": "0xead6", "input": "0x128acb08000000000000000000000000dfee68a9adb981cd08699891a11cabe10f25ec44000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000003a6d6cd1833904000000000000000000000000000000000000000000000000000000000001000276a400000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002d5f98805a4e8be255a32880fdec7f6728c6568ba0c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000bb80000", "output": "0x00000000000000000000000000000000000000000000003a6d6cd18339040000fffffffffffffffffffffffffffffffffffffffffffffffff6218cda9d1bdc4d", "calls": [ { "type": "CALL", "from": "0x9663f2ca0454accad3e094448ea6f77443880454", "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "value": "0x0", "gas": "0x4ad44", "gasUsed": "0x1f7e", "input": "0xa9059cbb000000000000000000000000dfee68a9adb981cd08699891a11cabe10f25ec4400000000000000000000000000000000000000000000000009de732562e423b3", "output": "0x0000000000000000000000000000000000000000000000000000000000000001" }, { "type": "STATICCALL", "from": "0x9663f2ca0454accad3e094448ea6f77443880454", "to": "0x5f98805a4e8be255a32880fdec7f6728c6568ba0", "gas": "0x48add", "gasUsed": "0x9b7", "input": "0x70a082310000000000000000000000009663f2ca0454accad3e094448ea6f77443880454", "output": "0x00000000000000000000000000000000000000000000b88db8ae77fad8af1b44" }, { "type": "CALL", "from": "0x9663f2ca0454accad3e094448ea6f77443880454", "to": "0x0000000000007f150bd6f54c40a34d7c3d5e9f56", "value": "0x0", "gas": "0x47e53", "gasUsed": "0x1d73", "input": "0xfa461e3300000000000000000000000000000000000000000000003a6d6cd18339040000fffffffffffffffffffffffffffffffffffffffffffffffff6218cda9d1bdc4d0000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000002d5f98805a4e8be255a32880fdec7f6728c6568ba0c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000bb8000000000000000000000000000000000000000000", "output": "0x", "calls": [ { "type": "CALL", "from": "0x0000000000007f150bd6f54c40a34d7c3d5e9f56", "to": "0x5f98805a4e8be255a32880fdec7f6728c6568ba0", "value": "0x0", "gas": "0x46844", "gasUsed": "0x1900", "input": "0xa9059cbb0000000000000000000000009663f2ca0454accad3e094448ea6f7744388045400000000000000000000000000000000000000000000003a6d6cd18339040000", "output": "0x0000000000000000000000000000000000000000000000000000000000000001" } ] }, { "type": "STATICCALL", "from": "0x9663f2ca0454accad3e094448ea6f77443880454", "to": "0x5f98805a4e8be255a32880fdec7f6728c6568ba0", "gas": "0x45edd", "gasUsed": "0x1e7", "input": "0x70a082310000000000000000000000009663f2ca0454accad3e094448ea6f77443880454", "output": "0x00000000000000000000000000000000000000000000b8c8261b497e11b31b44" } ] }, { "type": "STATICCALL", "from": "0x0000000000007f150bd6f54c40a34d7c3d5e9f56", "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "gas": "0x462ec", "gasUsed": "0x216", "input": "0x70a08231000000000000000000000000dfee68a9adb981cd08699891a11cabe10f25ec44", "output": "0x0000000000000000000000000000000000000000000000313ad15b36d61864e2" } ] } ] } }, { "...": null } ] } } ] } } } } }, "operationId": "rpc-berachain-debug_traceblockbyhash", "security": [ { "X-API-Key": [] } ] } } }, "components": { "securitySchemes": { "X-API-Key": { "type": "apiKey", "name": "x-api-key", "in": "header", "description": "Your **API key** is used to identify your account & your plan, including the number of API calls per second and total monthly calls you have.\n\nEach key is for individual use only.\n\nIf you don't have a key already you can [Sign up for a Free Tatum account](https://co.tatum.io/signup) to get two keys (testnet and mainnet), allowing up to 5 API calls per second and 1,000,000 Credits.\n\nFor testing purposes, you can use the following key which only works inside docs and has limited functionality (e.g. you cannot create virtual accounts or notification subscriptions with it):\n* t-66a730ccccfd17001c479705-2f597d14ad7543f289a03418\n\nFor more details on limits and plans, [click here](https://docs.tatum.io/docs/plans-limits).\n" } } }, "x-readme": { "explorer-enabled": true, "proxy-enabled": true } } ```