Skip to main content
Executes a new message call and returns a number of possible traces. This method will use 80 Compute Units.

Parameters

object - object - Required - The transaction call object
  • from - string - The address the transaction is sent from
  • to - string - The address the transaction is directed to
  • gas - string - The gas provided for the transaction execution, encoded as hexadecimal
  • gasPrice - string - The gas price for each paid gas, encoded as hexadecimal
  • value - string - The value sent with this transaction, encoded as hexadecimal
  • data - string - The call data: the 4-byte function selector followed by the ABI-encoded parameters
array - array - Required - The type of trace, which can be one of the following:
  • trace - string - To get the basic trace of the given call
  • stateDiff - string - To get information on altered state due to execution of the given call
  • vmTrace - string - To get a full trace of the virtual machine’s state during execution
blockNumber - String - Required - The block number as a string in hexadecimal format or tags. The supported tag values include:
  • 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

Returns

object - object -The transaction trace result object
  • output - string - The data returned as output encoded in hexadecimal format
  • stateDiff - object - The altered Ethereum 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