Skip to content

supports state override #1893

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

Merged
m4sterbunny merged 5 commits into from
Dec 19, 2025
+26 −18
Merged

supports state override #1893

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
af7a7aa
supports state override
m4sterbunny Dec 11, 2025
dbc3952
adds details to override state values instruction
m4sterbunny Dec 12, 2025
5672032
completes supported list
m4sterbunny Dec 15, 2025
f681b0d
Merge branch 'main' into 1874=debug_traceCall-options
m4sterbunny Dec 18, 2025
524d6d8
Merge branch 'main' into 1874=debug_traceCall-options
m4sterbunny Dec 19, 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
16 changes: 9 additions & 7 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 @@ -2010,6 +2010,10 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"debug_traceBlockByNumber","param

Performs an [`eth_call`](#eth_call) within the execution environment of a given block, using the final state of its parent block as the base, and provides a detailed trace of the executed opcodes.

Each `options` 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.

#### Parameters

- `call`: _object_ - [transaction call object](objects.md#transaction-call-object)
Expand All @@ -2022,13 +2026,11 @@ 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`):

- `disableStorage`: _boolean_ - `true` disables storage capture.

- `disableMemory`: _boolean_ - `true` disables memory capture.

- `disableStack` : _boolean_ - `true` disables stack capture.
- `options`: _object_ - request options object with the following fields (all booleans default to `false`):
- `disableStorage`: _boolean_ - (optional) `true` disables storage capture.
- `disableMemory`: _boolean_ - (optional) `true` disables memory capture.
- `disableStack` : _boolean_ - (optional) `true` disables stack capture.
- `stateOverrides`: _object_ - (optional) [address-to-state mapping](./objects.md#state-override-object).

#### Returns

Expand Down
2 changes: 1 addition & 1 deletion 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 Down
Loading