Skip to main content

debug_traceBlockByNumber

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

Parameters​

  • blockParameter: (string) [required] A hexadecimal block number, or one of the tags latest, earliest, pending or finalized. See the default block parameter.

    warning

    safe isn't supported. Use finalized instead. Learn more about Linea's layer 2 finalization.

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