Skip to main content
Traces every transaction in the block specified by block hash and returns the tracer result for each one. This method will use 80 Compute Units.

Parameters

blockHash - String - Required - The block hash. object - Object - Required - The tracer object with the following fields:
  • tracer - String - The type of tracer, options are: callTracer or prestateTracer.
    • callTracer - String - The callTracer keeps track of all call frames, including depth - calls, that are made during a transaction.
    • prestateTracer - String - The prestateTracer replays the transaction and tracks every part of state that occurred during the transaction.
  • tracerConfig - Object (Optional) - The object to specify the configurations of the tracer.
    • onlyTopCall - Boolean - When set to true, this will only trace the primary (top-level) call and not any sub-calls. It eliminates the additional processing for each call frame.

Returns

result - An array with one entry per transaction in the block, each containing:
  • txHash - The hash of the transaction.
  • result - With callTracer, the call trace of the transaction, an object with:
    • from - The address the transaction is sent from.
    • gas - The integer of the gas provided for the transaction execution.
    • gasUsed - The integer of the gas used.
    • to - The address the transaction is directed to.
    • input - The data given at the time of input.
    • output - The data returned by the call, when present.
    • value - The integer of the value sent with this transaction.
    • type - The type of call.
    • calls - A list of sub-calls, when present.
With prestateTracer, each result is instead a map keyed by account address, holding the state the transaction touched (such as balance, nonce, code and storage).