Skip to main content

Trace transactions

Forest pruning deprecation notice

Forest pruning (using the --pruning-enabled option) is deprecated and will be removed in a future release. We recommend using Bonsai Tries as an alternative for saving disk space.

To get detailed information about transaction processing, use the TRACE API. Enable the TRACE API using the --rpc-http-api or --rpc-ws-api command line options.

The TRACE API has two sets of trace calls, ad-hoc tracing APIs and transaction-trace filtering APIs.

Ad-hoc tracing APIs

These APIs allow you to use the trace, vmTrace, or stateDiff diagnostic options when tracing calls or transactions.

To use the ad-hoc tracing APIs, the requested block or transaction must be within the number of blocks retained with pruning enabled (by default, 1024).

The ad-hoc tracing APIs are:

Transaction-trace filtering APIs

These APIs allow you to filter and search by specific information such as the block, address, or transaction. These APIs only use the trace type.

To use the transaction-trace filtering APIs, your node must be an archive node (that is, synchronized without pruning or fast sync) or the requested block or transaction must be within the number of blocks retained with pruning enabled (by default, 1024).

The transaction-trace filtering APIs are: