Skip to content

adds state overrides to debug_traceCall #1892

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
m4sterbunny wants to merge 3 commits into from
Closed

adds state overrides to debug_traceCall #1892

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1c13193
adds state overrides to debug_traceCall
m4sterbunny Dec 11, 2025
1a4c95d
adds state overrides to debug_traceCall
m4sterbunny Dec 11, 2025
79c8820
Merge branch '1874-overrides-debug_traceCall' of github.com:hyperledg…
m4sterbunny Dec 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 9 additions & 4 deletions docs/public-networks/reference/api/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2022,13 +2022,18 @@ Performs an [`eth_call`](#eth_call) within the execution environment of a given
`pending` returns the same value as `latest`.
:::

- `options`: _object_ - request options object with the following fields (all optional and default to `false`):
- `options`: _object_ - request options object with the following fields (all booleans default to `false`):

- `disableStorage`: _boolean_ - `true` disables storage capture.
- `disableStorage`: _boolean_ - (optional) `true` disables storage capture.

- `disableMemory`: _boolean_ - `true` disables memory capture.
- `disableMemory`: _boolean_ - (optional) `true` disables memory capture.

- `disableStack` : _boolean_ - `true` disables stack capture.
- `disableStack` : _boolean_ - (optional) `true` disables stack capture.

- `stateOverrides`: _object_ - (optional) [address-to-state mapping](./objects.md#state-override-object).
Each entry specifies a state that will be temporarily overridden before executing the call.
This allows you to test, analyze, and debug smart contracts more efficiently by allowing
temporary state changes without affecting the actual blockchain state.

#### Returns

Expand Down
4 changes: 2 additions & 2 deletions docs/public-networks/reference/api/objects.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -152,7 +152,7 @@ Returned by [`debug_storageRangeAt`](index.md#debug_storagerangeat).

## State override object

Parameter for [`eth_call`](./index.md#eth_call), [`eth_estimateGas`](./index.md#eth_estimategas), and [`eth_simulateV1`](index.md#eth_simulatev1).
Parameter for [`eth_call`](./index.md#eth_call), [`eth_estimateGas`](./index.md#eth_estimategas), [`eth_simulateV1`](index.md#eth_simulatev1), and [`debug_traceCall`](./index.md#debug_traceCall).
Override an account with the following state values temporarily before making the call. This allows you
to make ephemeral state changes, for the purposes of transaction simulation, without affecting the actual
blockchain state.
Expand All @@ -177,7 +177,7 @@ Log information returned as part of the [Trace object](#trace-object).
| `gas` | Integer | Gas remaining. |
| `gasCost` | Integer | Cost in wei of each gas unit. |
| `depth` | Integer | Execution depth. |
| `exceptionalHaltReasons` | Array | One or more strings representing an error condition causing the EVM execution to terminate. These strings suggest that EVM execution terminated for reasons such as running out of gas or attempting to execute an unknown instruction. Generally a single exceptional halt reason returns but it's possible for more than one to occur at once. |
| `exceptionalHaltReasons` | Array | One or more strings representing an error condition causing the EVM execution to terminate. These strings suggest that EVM execution terminated for reasons such as running out of gas or attempting to execute an unknown instruction. Generally, a single exceptional halt reason returns but it's possible for more than one to occur at once. |
| `stack` | Array of 32 byte arrays | EVM execution stack before executing current operation. |
| `memory` | Array of 32 byte arrays | Memory space of the contract before executing current operation. |
| `storage` | Object | Storage entries changed by the current transaction. |
Expand Down
Loading