`debug-trace`

Spin up an anvil-zksync node that forks a remote network and attaches to the debug API for a given transaction.

Outputs either:

Perfect for diagnosing why a transaction reverted, inspecting nested calls, or analyzing low-level VM execution.

Synopsis

anvil-zksync debug-trace --rpc-url <FORK_URL> <TX>

Both parameters are required:

Alias	RPC endpoint
`era`, `mainnet`	`https://mainnet.era.zksync.io`
`era-testnet`, `sepolia-testnet`	`https://sepolia.era.zksync.dev`
`abstract`	`https://api.mainnet.abs.xyz`
`abstract-testnet`	`https://api.testnet.abs.xyz`
`sophon`	`https://rpc.sophon.xyz`
`sophon-testnet`	`https://rpc.testnet.sophon.xyz`
`cronos`	`https://mainnet.zkevm.cronos.org`
`cronos-testnet`	`https://testnet.zkevm.cronos.org`
`lens`	`https://rpc.lens.xyz`
`lens-testnet`	`https://rpc.testnet.lens.xyz`
`openzk`	`https://rpc.openzk.net`
`openzk-testnet`	`https://openzk-testnet.rpc.caldera.xyz/http`
`zkcandy`	`https://rpc.zkcandy.io`

Name	Description
`<TX>`	Transaction hash (`0x…`, 32 bytes). Required.

Flag	Description
`--rpc-url <FORK_URL>`	Network to fork from (endpoint or alias). Required.
`--only-top`	Restrict trace output to only the top-level call (skip internal calls).
`--raw`	Print raw debug JSON instead of formatted trace.

Queries the debug_traceTransaction RPC using the URL and TX provided.
Depending on flags:
- --only-top: prints only the root call.
- --raw: dumps the raw JSON response.
- Otherwise: prints a formatted tree trace with calls, gas, and status.

anvil-zksync debug-trace \
  --rpc-url mainnet \
  0x977b31d564042b7e14044c5d1fd7c1f95454e8f9ef643febd40a9c0d082d09cb

anvil-zksync debug-trace \
  --rpc-url mainnet \
  --only-top \
  0x977b31d564042b7e14044c5d1fd7c1f95454e8f9ef643febd40a9c0d082d09cb

anvil-zksync debug-trace \
  --rpc-url mainnet \
  --raw \
  0x977b31d564042b7e14044c5d1fd7c1f95454e8f9ef643febd40a9c0d082d09cb