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