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 hexidecimal 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​

Request​

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

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"
            }
        },
        ...
    ]
}