debug_traceBlockByHash

Replays all transactions in a block by hash and returns an execution trace for each.

Debug methods require a node with debug APIs enabled. Availability and rate limits vary by node provider. These methods replay transactions and are computationally expensive — avoid calling them in hot paths.

Replays all transactions in a block identified by its hash and returns an execution trace for each transaction.

Parameters

blockHash · string · required

The 32-byte hash of the block to trace.

traceOptions · object

Optional trace configuration. Accepts the same fields as debug_traceTransaction.

Returns

result · array

An array of trace result objects, one per transaction in the block.

Show Trace result object fields

txHash · string

The transaction hash.

result · object

The execution trace for this transaction. Same format as the result of debug_traceTransaction.

Example

Request

{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByHash",
  "params": [
    "0x3a4e8c5d7f2b1a6e9d0c4f8b3e7a2d5c8f1b4e7a0d3c6f9b2e5a8d1c4f7b0e3",
    { "tracer": "callTracer" }
  ],
  "id": 1
}