trace_replayBlockTransactions

​

Parameters

• earliest - For the earliest/genesis block
• latest for the latest mined block
• safe for the most recent secure block
• finalized for the most recent secure block accepted by more than 2/3 of validators

• vmTrace string - To get a full trace of the virtual machine’s state during the execution of the given transaction, including for any subcalls
• trace - string - To get the basic trace of the given transaction
• stateDiff - string - To get information on altered Ethereum state due to execution of the given transaction

​

Returns

• output - string - The data returned as output encoded in hexadecimal format
• stateDiff - object - The altered state due to execution of the given transaction, or null if not available
• trace - array - An array of basic trace objects for the given transaction containing:
  • action - object The ParityTrace action object containing call details
    • from - string - The address of the sender
    • callType - string - The type of method such as call, staticcall, delegatecall
    • gas - string - The gas provided by the sender, encoded as hexadecimal
    • input - string - The input data sent along with the transaction
    • to - string - The address of the receiver
    • value - string - The integer of the value sent with this transaction, encoded as hexadecimal
  • result - object - The execution result of the trace
    • gasUsed - string - The amount of gas used by this trace
    • output - string - The return value of the contract call, empty if no RETURN executed
  • subtraces - integer - The number of subtraces (internal calls) within this trace
  • traceAddress - array - The list of addresses where the call executed, including parent calls and order
  • type - string The type of the trace, such as call or create
• vmTrace - object - The full trace of the virtual machine’s state during execution, including sub-calls, or null if not available
• transactionHash - string - The transaction hash

// Result
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    // ...
    {
      "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
      "stateDiff": null,
      "trace": [
        {
          "type": "call",
          "action": {
            "from": "0xd4db58f65cc967a67449dc1570f408aeb496e5c8",
            "callType": "call",
            "gas": "0x8b90",
            "input": "0xa9059cbb000000000000000000000000ae054f4e67bd9c95844e0152f5face89ee4e7e450000000000000000000000000000000000000000000023b5482ca79b97450164",
            "to": "0xb9cd945141f7d99fd562a6222accde5043350ad4",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0x5770",
            "output": "0x0000000000000000000000000000000000000000000000000000000000000001"
          },
          "subtraces": 0,
          "traceAddress": []
        }
      ],
      "vmTrace": null,
      "transactionHash": "0x86a487d74f726697ffc06cca32975d8217142401ee459a1a604b8174315f2378"
    }
  ]
}

curl https://mainnet.hyperliquid.validationcloud.io/v1/<YOUR_API_KEY_HERE>/evm \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"trace_replayBlockTransactions","params":["0x2e305d8",["trace"]],"id":1}'