Enable debug & trace APIs for your Ethereum node

Introduction

The debug and trace API methods are special RPC methods that allow you to replay transactions in the Ethereum Virtual Machine to get the execution details in the exact same way as they happened on the chain.

To get the debug and trace API methods enabled on your Chainstack node, you must deploy a node of a certain configuration which will also depend on your subscription plan. Node configurations distribute between the subscription plans as follows:

API methodsSubscription planNode typeNode modeClient
debug_*Growth and higherDedicatedFullGeth
debug_*Growth and higherDedicatedArchiveGeth
debug_* and trace_*Growth and higherDedicatedArchiveErigon
debug_* and trace_*Business and higherElasticArchiveErigon

Elastic Ethereum node

Once you have joined a public network, deploy your elastic Ethereum node with both debug_* and trace_* API methods enabled:

  1. Select the project with the network.
  2. Select the network.
  3. Click Add node.
  4. Provide a node name.
  5. Under Type, select Elastic.
  6. Under Mode, select Archive. With an archive node, you will be able to query historical states for the entire chain.
  7. Under Debug and trace APIs, select On.
  8. Under Hosting, select Chainstack.
  9. For Chainstack hosting, select a cloud provider and a region.
  10. Review your changes and click Add node.

The node status will change from Pending to Running once deployed. You will also see the Debug and trace tag next to the node name.

Dedicated Ethereum node

Once you have joined a public network, deploy your dedicated Ethereum node with the debug_* or both debug_* and trace_* API methods enabled:

  1. Select the project with the network.
  2. Select the network.
  3. Click Add node.
  4. Provide a node name.
  5. Under Type, select Dedicated.
  6. Under Mode, select one of the following modes:
    • Full β€” will enable the debug_* API method on your node by default. With a full node, you will be able to query historical states for the immediately previous 128 blocks.
    • Archive β€” with an archive node, you will be able to query historical states for the entire chain.
  7. Under Hosting, select Chainstack. See Support hosting options.
  8. For Chainstack hosting, select a cloud provider and a region.
  9. If you are deploying a dedicated archive node, under Client, select one of the following:
    • Geth β€” to enable the debug_* API method on your node.
    • Erigon β€” to enable both debug_* and trace_* API methods on your node.
  10. Review your changes and click Send request.

Chainstack Sales team will reach out to your shortly.