Docs
Supported ChainsFlow EVM GatewayJSON-RPC APIDebug Methods

debug_traceCall - Flow EVM RPC Method

Trace a call without executing on Flow EVM Gateway. Requires archive node for debugging consumer NFTs (NBA Top Shot, Disney Pinnacle), gaming dApps, and hybrid Cadence-EVM applications.

Traces a call without creating a transaction on Flow EVM Gateway.

Archive Node Required

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

Use Cases

  • Transaction simulation - Debug before sending
  • Gas analysis - Analyze gas usage per opcode
  • Contract debugging - Step through execution for consumer NFTs (NBA Top Shot, Disney Pinnacle), gaming dApps, and hybrid Cadence-EVM applications

Request Parameters

Request
callObject

Call object (same as eth_call)

blockNumberQUANTITY|TAG

Block number or tag

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_traceCall",
    "params": [
      {"to": "0xd3bF53DAC106A0290B0483EcBC89d40FcC961f3e", "data": "0x70a08231000000000000000000000000d3bF53DAC106A0290B0483EcBC89d40FcC961f3e"},
      "latest",
      {"tracer": "callTracer"}
    ],
    "id": 1
  }'
JavaScript
import { JsonRpcProvider } from 'ethers';

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

const trace = await provider.send('debug_traceCall', [
  { to: '0xd3bF53DAC106A0290B0483EcBC89d40FcC961f3e', data: '0x70a08231000000000000000000000000d3bF53DAC106A0290B0483EcBC89d40FcC961f3e' },
  'latest',
  { tracer: 'callTracer' }
]);
console.log('Trace:', trace);

On this page