Skip to main content

debug_traceBlockByNumber

Returns tracing results by executing all transactions in the specified block number.

Parameters​

  • blockNumber: (string) [required] block number as a hexadecimal string, or one of the string tags latest, earliest , or pending, as described in the default block parameters.
  • Optional tracing options object with the following fields:
    • tracer: (string) [optional] type of tracer. Supports callTracer or prestateTracer.
    • tracerConfig: (object) [optional] tracer configuration options:
      • onlyTopCall: (boolean) [optional] when true, will only trace the primary (top-level) call and not any sub-calls. It eliminates the additional processing for each call frame.

Returns​

Depending on the specified tracer type, returns a callTracer object or prestateTracer object.

Example​

Replace <YOUR-API-KEY> with an API key from your MetaMask Developer dashboard.

Request​

curl https://scroll-mainnet.infura.io/v3/<YOUR-API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "debug_traceBlockByNumber", "params": ["0x4d0c", {"tracer": "callTracer"}], "id": 1}'

Result​

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "result": {
        "from": "0xa5ba45f484bc67fe293cf01f7d92d5ba3514dd42",
        "gas": "0x5208",
        "gasUsed": "0x5208",
        "input": "0x",
        "to": "0x45a318273749d6eb00f5f6ca3bc7cd3de26d642a",
        "type": "CALL",
        "value": "0x2ca186f5fda8004"
      }
    },
    {
      "result": {
        "from": "0x25f2650cc9e8ad863bf5da6a7598e24271574e29",
        "gas": "0xfe0e",
        "gasUsed": "0xafee",
        "input": "0xd0e30db0",
        "to": "0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f",
        "type": "CALL",
        "value": "0x2386f26fc10000"
      }
    }
    ...
  ]
}