Docs
Supported ChainsFlow EVM GatewayJSON-RPC APIDebug Methods

debug_traceBlock - Flow EVM RPC Method

Trace all transactions in a block on Flow EVM Gateway. Requires archive node for consumer NFTs (NBA Top Shot, Disney Pinnacle), gaming dApps, and hybrid Cadence-EVM applications.

Traces all transactions in a block on Flow EVM Gateway 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 consumer NFTs (NBA Top Shot, Disney Pinnacle), gaming dApps, and hybrid Cadence-EVM applications

Request Parameters

Request
blockRlpDATA

RLP-encoded block data

tracerConfigObject

Tracer configuration

Response Body

Response

Code Examples

Bash
curl -X POST https://api-flow-evm-gateway-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-flow-evm-gateway-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);

On this page