debug_traceBlockByNumber - Etherlink RPC Method
Trace all transactions in a block by number on Etherlink. Analyze gas consumption, debug state transitions, and inspect historical block execution.
Traces all transactions in a block on Etherlink identified by its block number or tag. This is the most convenient block-tracing method - pass a block number or "latest" to get full execution traces of every transaction in that block.
Node Requirement
Use callTracer. Mainnet block tracing starts at Bifrost block 4,162,673. The Dune client skips trace RPC below that height. Requests with timeout 119s succeeded; timeout enforcement was not verified.
When to Use This Method
Read callTracer output for block 4,162,737. Mainnet block tracing starts at Bifrost block 4,162,673. Below that height, Dune skips trace RPC.
Best Practices
Keep the recorded block height and address together when reproducing a historical example. Preserve RPC errors instead of replacing them with empty results.
Response Body
ResponseCode Examples
curl -X POST "https://api-etherlink-mainnet.n.dwellir.com/YOUR_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"jsonrpc":"2.0","id":26,"method":"debug_traceBlockByNumber","params":["0x3f84b1",{"tracer":"callTracer","timeout":"119s"}]}'