POST
/
evm
trace_rawTransaction
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm \
  --header 'Content-Type: application/json' \
  --data '{
  "jsonrpc": "2.0",
  "method": "trace_rawTransaction",
  "params": [
    "0xf86d80843b9aca0082520894b7c609cffa0e47db2467ea03ff3e598bf59361a5880de0b6b3a7640000808207f2a02d013b9980176ca8674f77797ac04e928b8de3be92dd452501ec26acbb2b1abca054041f43109eeadbb4d6b712a20dc71e5dbe1225e549644be3de803b55041a89",
    [
      "trace"
    ]
  ],
  "id": 1
}'
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "action": {
        "from": "0x...",
        "to": "0x...",
        "value": "0x...",
        "gas": "0x...",
        "input": "0x",
        "callType": "call"
      },
      "result": {
        "gasUsed": "0x5208",
        "output": "0x"
      },
      "traceAddress": [],
      "type": "call"
    }
  ]
}
The trace_rawTransaction JSON-RPC method executes a raw transaction and returns trace information. This method simulates the execution of a raw transaction and provides detailed execution traces, making it useful for analyzing pre-signed transactions and testing transaction execution without broadcasting.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

  1. Raw transaction data (string, required): Raw transaction in hexadecimal format
  2. Trace types (array, required): Array of trace types to include in response

​
Trace types

  • "trace": Basic execution trace information
  • "vmTrace": Virtual machine execution trace
  • "stateDiff": State differences caused by the transaction

​
Response

The method returns an array of trace objects containing detailed execution information.

​
Response structure

Trace objects:
  • action — Details about the call action
  • result — Execution result
  • traceAddress — Address path within call hierarchy
  • type — Type of trace (call, create, suicide, etc.)

​
Usage example

​
Basic implementation

// Execute a raw transaction with tracing
const traceRawTransaction = async (rawTx, traceTypes = ['trace']) => {
  const response = await fetch('https://hyperliquid-mainnet.core.chainstack.com/YOUR_ENDPOINT/evm', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      method: 'trace_rawTransaction',
      params: [rawTx, traceTypes],
      id: 1
    })
  });
  
  const data = await response.json();
  return data.result;
};

// Example usage
const rawTx = '0xf86d80843b9aca0082520894b7c609cffa0e47db2467ea03ff3e598bf59361a5880de0b6b3a7640000808207f2a02d013b9980176ca8674f77797ac04e928b8de3be92dd452501ec26acbb2b1abca054041f43109eeadbb4d6b712a20dc71e5dbe1225e549644be3de803b55041a89';

traceRawTransaction(rawTx).then(traces => {
  console.log('Raw transaction trace:');
  traces.forEach(trace => {
    console.log(`Type: ${trace.type}`);
    console.log(`Gas used: ${parseInt(trace.result.gasUsed, 16)}`);
  });
});

​
Example request

Shell
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_rawTransaction",
    "params": [
      "0xf86d80843b9aca0082520894b7c609cffa0e47db2467ea03ff3e598bf59361a5880de0b6b3a7640000808207f2a02d013b9980176ca8674f77797ac04e928b8de3be92dd452501ec26acbb2b1abca054041f43109eeadbb4d6b712a20dc71e5dbe1225e549644be3de803b55041a89",
      ["trace"]
    ],
    "id": 1
  }' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm

​
Use cases

The trace_rawTransaction method is essential for applications that need to:
  • Pre-signed transaction analysis: Analyze transactions before broadcasting
  • Offline transaction testing: Test transaction execution offline
  • Transaction debugging: Debug transaction execution issues
  • Security analysis: Analyze transaction security and potential vulnerabilities
  • Gas estimation: Get accurate gas estimates for raw transactions
  • Development tools: Build transaction analysis and debugging tools
  • Wallet applications: Provide transaction previews in wallet interfaces
  • Compliance checking: Verify regulatory compliance before broadcasting
  • Educational tools: Create educational content about transaction execution
  • Research platforms: Support academic and commercial blockchain research
This method provides comprehensive analysis of raw transactions before execution on the Hyperliquid EVM platform.

Body

application/json
​
jsonrpc
enum<string>
default:2.0
required

JSON-RPC version

Available options:
2.0
​
method
enum<string>
default:trace_rawTransaction
required

The RPC method name

Available options:
trace_rawTransaction
​
params
any[]
required

Parameters: [raw transaction data, trace types array]

​
id
integer
default:1
required

Request identifier

Response

200 - application/json

Successful response with trace data

​
jsonrpc
string

JSON-RPC version

​
id
integer

Request identifier

​
result
any[]

Array of trace objects containing execution information