trace_transaction

Returns all traces for a specific transaction on Base.

Archive Node Required

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

Use Cases

• Transaction analysis - See all internal calls made by a transaction
• Token transfer tracking - Trace value flows through contracts
• Debugging - Understand execution flow for consumer dApps, SocialFi, NFT marketplaces, and merchant payment integrations

Parameters

Parameter	Type	Required	Description
txHash	DATA	Yes	32-byte transaction hash

Request

{
  "jsonrpc": "2.0",
  "method": "trace_transaction",
  "params": ["0x5c884a466fb59ee69114a0c99cb15d4d8af670a37be53fd59ffda3b5566b4269"],
  "id": 1
}

Code Examples

cURL

curl -X POST https://api-base-mainnet-archive.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_transaction",
    "params": ["0x5c884a466fb59ee69114a0c99cb15d4d8af670a37be53fd59ffda3b5566b4269"],
    "id": 1
  }'

JavaScript

import { JsonRpcProvider } from 'ethers';

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

const traces = await provider.send('trace_transaction', [
  '0x5c884a466fb59ee69114a0c99cb15d4d8af670a37be53fd59ffda3b5566b4269'
]);
console.log('Traces:', traces.length);
for (const trace of traces) {
  console.log(`  ${trace.action.from} -> ${trace.action.to} (${trace.type})`);
}

Python

from web3 import Web3

w3 = Web3(Web3.HTTPProvider('https://api-base-mainnet-archive.n.dwellir.com/YOUR_API_KEY'))

traces = w3.provider.make_request('trace_transaction', [
    '0x5c884a466fb59ee69114a0c99cb15d4d8af670a37be53fd59ffda3b5566b4269'
])
for trace in traces['result']:
    action = trace['action']
    print(f'{action["from"]} -> {action.get("to", "CREATE")} ({trace["type"]})')

Related Methods

• trace_get - Get a specific trace by index
• trace_block - Get all traces in a block
• trace_filter - Filter traces by criteria