debug_traceBlockByNumber on Optimism
Returns execution traces for all transactions in a block. Used by analytics pipelines reconstructing internal transfers and call trees. Heavy; needs a free API key.
Output and cost scale with block activity, so it can be very large on busy chains. Use callTracer to reconstruct internal transfers and process block-by-block rather than requesting wide ranges.
Optimism endpoint (keyed — free)
https://rpc.nodeflare.app/op/v1/YOUR_KEYMethod
debug_traceBlockByNumber
Cost
100 CU
Chain ID
10
Block time
~2 s
Finality
~2 s soft · L1-final ~13 min
Tracing on Optimism
debug_ tracing is supported. Pre-Bedrock blocks (before June 2023) come from the legacy system and don't trace like Bedrock blocks; deposit transactions (type 0x7e) trace without a mempool counterpart.
Parameters
[blockNumber|tag, { tracer }]cURL
curl https://rpc.nodeflare.app/op/v1/YOUR_KEY \
-X POST \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","method":"debug_traceBlockByNumber","params":["latest", {"tracer": "callTracer"}],"id":1}'ethers.js
import { ethers } from 'ethers';
const provider = new ethers.JsonRpcProvider(
'https://rpc.nodeflare.app/op/v1/YOUR_KEY'
);
const result = await provider.send('debug_traceBlockByNumber', ["latest", {"tracer": "callTracer"}]);Try it live
Runs the example above against the public Optimism endpoint — straight from your browser.
debug_traceBlockByNumber on Optimism — FAQ
How do I call debug_traceBlockByNumber on Optimism?
POST a JSON-RPC 2.0 request with "method": "debug_traceBlockByNumber" to NodeFlare's Optimism endpoint at https://rpc.nodeflare.app/op/v1/YOUR_KEY. This method requires a free API key — it is not available on the public endpoint.
What does debug_traceBlockByNumber cost on the free tier?
debug_traceBlockByNumber is weighted at 100 compute units per call. The free tier includes 2,000,000 CU/month, so that is roughly 20,000 debug_traceBlockByNumber calls per month — no credit card.
Is debug_traceBlockByNumber available on the public Optimism endpoint?
No. debug_traceBlockByNumber is a heavy method and requires a free API key. The public no-key endpoint serves standard read methods; create a free key to unlock debug_traceBlockByNumber, eth_getLogs, trace_* and debug_*.
Anything Optimism-specific to know when using debug_traceBlockByNumber?
debug_ tracing is supported. Pre-Bedrock blocks (before June 2023) come from the legacy system and don't trace like Bedrock blocks; deposit transactions (type 0x7e) trace without a mempool counterpart.
Call debug_traceBlockByNumber on Optimism with a free key
2,000,000 compute units/month, heavy methods unlocked, every chain included. No credit card.
Get your free API key →debug_traceBlockByNumber on other chains