Class StateOverrideBuilder

Builder class for creating and managing state overrides in Ethereum transactions. Allows for overriding balances, code, and paymaster deposits in a chainable manner.

Example

const builder = new StateOverrideBuilder()
  .overrideBalance('0x123...', 1000n)
  .overrideCode('0x456...', '0x1234...')
  .build();

Index

Constructors

constructor

Methods

build overrideBalance overrideCode overridePaymasterDeposit

Constructors

constructor

new StateOverrideBuilder(
stateOverrides?: StateOverrideSet,
): StateOverrideBuilder
Creates a new StateOverrideBuilder instance
Parameters
- OptionalstateOverrides: StateOverrideSet
  Optional initial state overrides to merge with new overrides
Returns StateOverrideBuilder
- Defined in entrypoint/shared/stateOverrides.ts:25

Methods

build

build(): undefined | StateOverrideSet
Builds and returns the final state override set

Returns undefined | StateOverrideSet
The merged state overrides or undefined if no overrides exist
Example
```
const overrides = new StateOverrideBuilder()
  .overrideBalance('0x123...', 1000n)
  .build();
```
- Defined in entrypoint/shared/stateOverrides.ts:132

overrideBalance

overrideBalance(address: `0x${string}`, balance: bigint): StateOverrideBuilder
Overrides the balance for a specific address
Parameters
- address: `0x${string}`
  The Ethereum address to override the balance for
- balance: bigint
  The new balance value as a bigint
Returns StateOverrideBuilder
The builder instance for method chaining
Example
```
builder.overrideBalance('0x123...', 1000000000000000000n); // Set balance to 1 ETH
```
- Defined in entrypoint/shared/stateOverrides.ts:62

overrideCode

overrideCode(address: `0x${string}`, code: `0x${string}`): StateOverrideBuilder
Overrides the contract code for a specific address
Parameters
- address: `0x${string}`
  The Ethereum address to override the code for
- code: `0x${string}`
  The new contract bytecode as a hex string
Returns StateOverrideBuilder
The builder instance for method chaining
Example
```
builder.overrideCode('0x123...', '0x608060405234801...');
```
- Defined in entrypoint/shared/stateOverrides.ts:78

overridePaymasterDeposit

overridePaymasterDeposit(
    entryPointAddress: `0x${string}`,
    paymasterAddress: `0x${string}`,
    storageValue?: string,
): StateOverrideBuilder
Overrides the paymaster deposit amount in the EntryPoint contract
Parameters
- entryPointAddress: `0x${string}`
  The address of the EntryPoint contract
- paymasterAddress: `0x${string}`
  The address of the Paymaster contract
- storageValue: string = PAYMASTER_DEPOSIT_MAX
  The deposit amount to set, defaults to PAYMASTER_DEPOSIT_MAX
Returns StateOverrideBuilder
The builder instance for method chaining
Example
```
builder.overridePaymasterDeposit(
  '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789',
  '0x123...'
);
```
- Defined in entrypoint/shared/stateOverrides.ts:98

Class StateOverrideBuilder

Example

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns StateOverrideBuilder

Methods

build

Returns undefined | StateOverrideSet

Example

overrideBalance

Parameters

Returns StateOverrideBuilder

Example

overrideCode

Parameters

Returns StateOverrideBuilder

Example

overridePaymasterDeposit

Parameters

Returns StateOverrideBuilder

Example

Settings

On This Page