debug_traceBlock

Traces all transactions in a block on Immutable by block RLP.

Archive Node Required

This method requires an archive node. It is not available on full nodes.

Use Cases

• Transaction debugging - Analyze transaction execution step-by-step
• Smart contract analysis - Debug contract interactions
• Security auditing - Trace internal calls for Web3 gaming (Gods Unchained, RavenQuest), gaming NFTs with enforced royalties, and cross-chain game assets

Parameters

Parameter	Type	Required	Description
blockRlp	DATA	Yes	RLP-encoded block data
tracerConfig	Object	No	Tracer configuration

Request

{
  "jsonrpc": "2.0",
  "method": "debug_traceBlock",
  "params": ["0xf9..."],
  "id": 1
}

Code Examples

cURL

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_traceBlock",
    "params": ["0xf9..."],
    "id": 1
  }'

JavaScript

import { JsonRpcProvider } from 'ethers';

const provider = new JsonRpcProvider('https://api-immutable-zkevm-mainnet.n.dwellir.com/YOUR_API_KEY');

// Use debug_traceBlockByNumber instead (more practical)
const traces = await provider.send('debug_traceBlockByNumber', ['latest', {}]);
console.log('Transaction traces:', traces.length);

Related Methods

• debug_traceBlockByNumber - Trace by block number
• debug_traceBlockByHash - Trace by block hash