debug_traceTransaction | Optimism

The debug_traceTransaction RPC method retrieves a detailed execution trace of a transaction, identified by the transaction's hash. This method is crucial for developers and analysts who need to understand the execution flow of a transaction, including all the operations (opcodes) executed, gas usage, and the transaction's outcome.


Get you own node endpoint today

Start 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.


To use debug_traceTransaction, send a POST request with a JSON RPC call in the body.


  • Transaction Hash (string): The hash of the transaction to trace.


The response includes a detailed execution trace of the transaction, providing insights into each step of the transaction's execution.

  • result (object): The detailed execution trace, including:
    • structLogs (array): An array of execution steps (opcodes) taken by the transaction.
    • gas (integer): The gas provided by the transaction.
    • returnValue (string): The return value of the transaction, if any.
    • gasUsed (integer): The total gas used by the transaction.
    • failed (boolean): Indicates whether the transaction failed.

Use case

The debug_traceTransaction method is essential for:

  • Developers debugging smart contract interactions.
  • Analysts conducting forensic analysis of transactions.
  • Tools and services that provide insights into Ethereum Virtual Machine (EVM) execution.

Try the debug_traceTransaction RPC method yourself

Click Try It! to start a request and see the response here!