trace_replayTransaction

Replays a transaction on Berachain and returns the requested traces.

Archive Node Required

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

Use Cases

• Transaction replay - Re-execute a transaction with full trace output
• State diff extraction - Get exact state changes from a transaction
• VM trace debugging - Get opcode-level execution details for liquidity-aligned DeFi (Infrared, Kodiak), yield farming, and validator-integrated liquidity incentives

Parameters

Parameter	Type	Required	Description
txHash	DATA	Yes	32-byte transaction hash
traceTypes	Array	Yes	Trace types: ["trace"], ["vmTrace"], ["stateDiff"], or combinations

Request

{
  "jsonrpc": "2.0",
  "method": "trace_replayTransaction",
  "params": ["0xc5c421e9e1f89c46d6f23e4057f24ed39fe8c8d75f0dc27159b46f8b6ece3671", ["trace"]],
  "id": 1
}

Code Examples

cURL

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

JavaScript

import { JsonRpcProvider } from 'ethers';

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

const result = await provider.send('trace_replayTransaction', [
  '0xc5c421e9e1f89c46d6f23e4057f24ed39fe8c8d75f0dc27159b46f8b6ece3671',
  ['trace']
]);
console.log('Trace:', result.trace.length, 'entries');
console.log('State diff:', result.stateDiff ? 'present' : 'not requested');

Python

from web3 import Web3

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

result = w3.provider.make_request('trace_replayTransaction', [
    '0xc5c421e9e1f89c46d6f23e4057f24ed39fe8c8d75f0dc27159b46f8b6ece3671',
    ['trace']
])
trace = result['result']
print(f'Trace entries: {len(trace["trace"])}')

Related Methods

• trace_replayBlockTransactions - Replay all transactions in a block
• trace_transaction - Get traces without replay
• trace_block - Get all traces in a block