debug_traceBlockByNumber - Immutable RPC Method
Trace all transactions in a block by number on Immutable. Requires archive node.
Traces all transactions in a block on Immutable by block number.
Archive Node Required
This method requires an archive node. It is not available on full nodes.
Request Parameters
Block number or tag
Tracer configuration
Response Body
Code Examples
curl -X POST https://api-immutable-zkevm-mainnet.n.dwellir.com/YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": ["latest", {"tracer": "callTracer"}],
"id": 1
}'import { JsonRpcProvider } from 'ethers';
const provider = new JsonRpcProvider('https://api-immutable-zkevm-mainnet.n.dwellir.com/YOUR_API_KEY');
const traces = await provider.send('debug_traceBlockByNumber', ['latest', { tracer: 'callTracer' }]);
console.log('Transaction traces:', traces.length);Related Methods
debug_traceBlockByHash- Trace by hashdebug_traceTransaction- Trace single transaction
debug_traceBlockByHash
Trace all transactions in a block by hash on Immutable. Requires archive node.
debug_traceCall
Trace a call without executing on Immutable. Requires archive node for debugging Web3 gaming (Gods Unchained, RavenQuest), gaming NFTs with enforced royalties, and cross-chain game assets.