support state override for debug_traceTransaction ("offchain events")

[hananbeer]

the debug_traceCall function supports state overrides, but debug_traceTransaction does not - it only accepts a transaction hash.

I wrote this originally as the backbone for generating "offchain events" (as developed by shadow / ghost logs)

to prevent confusion with nodes that don't implement this feature I created a distinct function debug_traceTransactionOverrides.
by overriding contracts bytecode it is possible to reexecute onchain transactions in different context, specifically to emit so called "offchain events" but not limited to this.

usage:

cast rpc debug_traceTransactionOverrides $txhash '{ "stateOverrides": { "$addr": { "code": "$bytecode" } } }'

eg for mainnet:

cast rpc debug_traceTransactionOverrides 0xc9ab90a1796613b0fbccb33827de583901d4c0775e89c0f25d604b7c3a71771e '{ "stateOverrides": { "0x0000001D0000F38CC10d0028474a9c180058B091": { "code": "0x6000ff" } } }' | jq .

see equivalent implementations:

geth: ethereum/go-ethereum#29423
reth: paradigmxyz/reth#7410

[sonarqubecloud]

Quality Gate failed

Failed conditions
3.2% Duplication on New Code (required ≤ 3%)
E Reliability Rating on New Code (required ≥ A)

See analysis details on SonarCloud

Catch issues before they fail your Quality Gate with our IDE extension SonarLint

[AskAlexSharov]

@hananbeer hi. Seems geth PR was closed: ethereum/go-ethereum#29423

[hananbeer]

@hananbeer hi. Seems geth PR was closed: ethereum/go-ethereum#29423

yes apparently someone implemented this feature in a similar way using debug_traceCall. (just days before me 😅 )
it seems this is also merged into erigon we can close this pr too.

(based on TxIndex existing in TraceConfig)
https://github.com/ledgerwatch/erigon/blob/devel/eth/tracers/api.go#L22