POST
/
efb0a5eccd2caa5135eb54eba6f7f300
curl --request POST \
  --url https://optimism-mainnet.core.chainstack.com/efb0a5eccd2caa5135eb54eba6f7f300 \
  --header 'Content-Type: application/json' \
  --data '{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByNumber",
  "id": 1,
  "params": [
    "0x6eee7bc"
  ]
}'
{
  "jsonrpc": "<string>",
  "id": 123,
  "result": [
    {}
  ]
}

The debug_traceBlockByNumber RPC method is used to retrieve detailed execution traces for all transactions included in a block, identified by the block’s number. This method is particularly useful for developers and analysts who need to deeply understand transaction execution and state changes within a specific block.

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

Request

To use debug_traceBlockByNumber, send a POST request with a JSON RPC call in the body.

Parameters

  • Block Number (string): The number of the block for which to retrieve the execution traces, in hexadecimal format.

Response

The response includes detailed execution traces for all transactions in the specified block.

  • result (array): An array of execution traces for each transaction in the block. Each trace provides comprehensive details about the execution, including calls, state changes, and gas usage.

Use case

The debug_traceBlockByNumber method is essential for:

  • Developers debugging complex interactions within a block.
  • Analysts conducting forensic analysis of block transactions.
  • Tools and services that provide insights into the Ethereum Virtual Machine (EVM) execution and state changes.

Body

application/json
jsonrpc
string
default:2.0
required
method
string
default:debug_traceBlockByNumber
required
id
integer
default:1
required
params
string[]
required

Response

200 - application/json
Detailed execution traces for all transactions in the specified block
jsonrpc
string
id
integer
result
object[]

An array of execution traces for each transaction in the block.