trace_replayTransaction

Replays a transaction on Hyperliquid 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 perpetual futures trading, onchain order books, and institutional-grade derivatives

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": ["0x090cd1f41962604b7efbc2b3c93b536dc7716c8c3487bfe2ba3ff4fe57df0614", ["trace"]],
  "id": 1
}

Code Examples

cURL

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

JavaScript

import { JsonRpcProvider } from 'ethers';

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

const result = await provider.send('trace_replayTransaction', [
  '0x090cd1f41962604b7efbc2b3c93b536dc7716c8c3487bfe2ba3ff4fe57df0614',
  ['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-hyperliquid-mainnet-evm.n.dwellir.com/YOUR_API_KEY'))

result = w3.provider.make_request('trace_replayTransaction', [
    '0x090cd1f41962604b7efbc2b3c93b536dc7716c8c3487bfe2ba3ff4fe57df0614',
    ['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