Class EVMGasEstimator

Base implementation of gas estimation for EVM-compatible chains. Provides methods for estimating gas costs for user operations including verification, execution, and pre-verification gas.

Implements

GasEstimator

Example

const estimator = new EVMGasEstimator(
  chain,
  rpcClient,
  {
    [EntryPointVersion.v060]: entryPointV6,
    [EntryPointVersion.v070]: entryPointV7
  }
);

const gasEstimate = await estimator.estimateUserOperationGas({
  unEstimatedUserOperation,
  baseFeePerGas: 1000000000n
});

Hierarchy (View Summary)

EVMGasEstimator

Implements

GasEstimator

Index

Constructors

constructor

new EVMGasEstimator(
    chain: {
        chainId: number;
        eip1559: boolean;
        entryPoints?: {
            v060?: { address: string };
            v070?: {
                address: string;
                state?: { deposits: Record<string, { stateKey: string }> };
            };
        };
        isTestnet: boolean;
        name: string;
        nativeCurrency?: string;
        paymasters: {
            v060?: Record<string, { dummyPaymasterAndData: string; type: string }>;
            v070?: Record<
                string,
                { dummyPaymasterData: string; postOpGasLimit: bigint; type: string },
            >;
        };
        simulation?: {
            callGasLimit: bigint;
            preVerificationGas: bigint;
            verificationGasLimit: bigint;
        };
        smartAccountSupport: { nexus: boolean; smartAccountsV2: boolean };
        stack: ChainStack;
        stateOverrideSupport: {
            balance: boolean;
            bytecode: boolean;
            stateDiff: boolean;
        };
    },
    rpcClient: GasEstimatorRpcClient,
    entryPoints: EntryPoints,
    simulationLimits?: SimulationLimits,
): EVMGasEstimator
Creates a new EVMGasEstimator instance
Parameters
- chain: {
      chainId: number;
      eip1559: boolean;
      entryPoints?: {
          v060?: { address: string };
          v070?: {
              address: string;
              state?: { deposits: Record<string, { stateKey: string }> };
          };
      };
      isTestnet: boolean;
      name: string;
      nativeCurrency?: string;
      paymasters: {
          v060?: Record<string, { dummyPaymasterAndData: string; type: string }>;
          v070?: Record<
              string,
              { dummyPaymasterData: string; postOpGasLimit: bigint; type: string },
          >;
      };
      simulation?: {
          callGasLimit: bigint;
          preVerificationGas: bigint;
          verificationGasLimit: bigint;
      };
      smartAccountSupport: { nexus: boolean; smartAccountsV2: boolean };
      stack: ChainStack;
      stateOverrideSupport: {
          balance: boolean;
          bytecode: boolean;
          stateDiff: boolean;
      };
  }
  The SupportedChain to estimate gas for
- rpcClient: GasEstimatorRpcClient
  The RPC client for making blockchain requests
- entryPoints: EntryPoints
  Map of EntryPointVersion to their contract instances
- simulationLimits: SimulationLimits = ...
  Optional gas limits for simulation, defaults to predefined constants
Returns EVMGasEstimator
- Defined in gas-estimator/evm/EVMGasEstimator.ts:78

Properties

chain

chain: {
    chainId: number;
    eip1559: boolean;
    entryPoints?: {
        v060?: { address: string };
        v070?: {
            address: string;
            state?: { deposits: Record<string, { stateKey: string }> };
        };
    };
    isTestnet: boolean;
    name: string;
    nativeCurrency?: string;
    paymasters: {
        v060?: Record<string, { dummyPaymasterAndData: string; type: string }>;
        v070?: Record<
            string,
            { dummyPaymasterData: string; postOpGasLimit: bigint; type: string },
        >;
    };
    simulation?: {
        callGasLimit: bigint;
        preVerificationGas: bigint;
        verificationGasLimit: bigint;
    };
    smartAccountSupport: { nexus: boolean; smartAccountsV2: boolean };
    stack: ChainStack;
    stateOverrideSupport: {
        balance: boolean;
        bytecode: boolean;
        stateDiff: boolean;
    };
}

The SupportedChain to estimate gas for

entryPoints

entryPoints: EntryPoints

Map of EntryPointVersion to their contract instances

`Protected`rpcClient

rpcClient: GasEstimatorRpcClient

The RPC client for making blockchain requests

simulationLimits

simulationLimits: SimulationLimits = ...

Optional gas limits for simulation, defaults to predefined constants

Methods

estimatePreVerificationGas

estimatePreVerificationGas(
userOperation: UserOperation,
baseFeePerGas?: bigint,
): Promise<bigint>
Estimates pre-verification gas for a user operation. Calculates gas costs for calldata and fixed overheads.
Parameters
- userOperation: UserOperation
  The UserOperation to estimate for
- OptionalbaseFeePerGas: bigint
  Optional base fee per gas
Returns Promise<bigint>
The estimated pre-verification gas as a bigint
Example
```
const preVerificationGas = await estimator.estimatePreVerificationGas(
  userOperation,
  1000000000n
);
```
Implementation of GasEstimator.estimatePreVerificationGas
- Defined in gas-estimator/evm/EVMGasEstimator.ts:463

estimateUserOperationGas

estimateUserOperationGas(
params: EstimateUserOperationGasParams,
): Promise<EstimateUserOperationGasResult>
Estimates all gas parameters for a user operation.
Parameters
- params: EstimateUserOperationGasParams
  The estimation parameters
  
  Parameters for estimating user operation gas.
  - baseFeePerGas: bigint
    Current base fee per gas
  - Optionaloptions?: Partial<EstimateUserOperationGasOptions>
    Additional estimation options
  - OptionalstateOverrides?: StateOverrideSet
    Optional state overrides for simulation
  - unEstimatedUserOperation: UnEstimatedUserOperation
    User operation without gas estimates
Returns Promise<EstimateUserOperationGasResult>
Gas estimation results including all required gas limits
Throws
Error if simulation or estimation fails
Example
```
const estimate = await estimator.estimateUserOperationGas({
  unEstimatedUserOperation: {
    sender: "0x123...",
    nonce: 1n,
    // ... other fields
  },
  baseFeePerGas: 1000000000n,
  stateOverrides: {
    // Optional state modifications
  }
});
```
Implementation of GasEstimator.estimateUserOperationGas
- Defined in gas-estimator/evm/EVMGasEstimator.ts:116

estimateVerificationAndCallGasLimits

estimateVerificationAndCallGasLimits(
    userOperation: UserOperation,
    executionResult: ExecutionResult,
): {
    callGasLimit: bigint;
    validAfter: number;
    validUntil: number;
    verificationGasLimit: bigint;
}
Internal
Estimates verification and call gas limits from execution results.
Parameters
- userOperation: UserOperation
  The user operation being estimated
- executionResult: ExecutionResult
  The simulation execution result
Returns {
    callGasLimit: bigint;
    validAfter: number;
    validUntil: number;
    verificationGasLimit: bigint;
}
Object containing gas limits and validity window
- Defined in gas-estimator/evm/EVMGasEstimator.ts:422

mergeEstimateUserOperationGasOptions

mergeEstimateUserOperationGasOptions(
entryPointVersion: EntryPointVersion,
options?: Partial<EstimateUserOperationGasOptions>,
): EstimateUserOperationGasOptions
Internal
Merges user-provided options with default estimation options.
Parameters
- entryPointVersion: EntryPointVersion
  The EntryPointVersion being used
- Optionaloptions: Partial<EstimateUserOperationGasOptions>
  Partial options to merge with defaults
Returns EstimateUserOperationGasOptions
Complete estimation options
- Defined in gas-estimator/evm/EVMGasEstimator.ts:504

useBinarySearch

useBinarySearch(
    userOperation: {
        callData: `0x${string}`;
        callGasLimit: bigint;
        initCode: `0x${string}`;
        maxFeePerGas: bigint;
        maxPriorityFeePerGas: bigint;
        nonce: bigint;
        paymasterAndData: `0x${string}`;
        preVerificationGas: bigint;
        sender: `0x${string}`;
        signature: `0x${string}`;
        verificationGasLimit: bigint;
    },
    baseFeePerGas: bigint,
    options: EstimateUserOperationGasOptions,
    stateOverrides?: StateOverrideSet,
): Promise<EstimateUserOperationGasResult>
Internal
Uses binary search to estimate gas limits for deployed accounts.
Parameters
- userOperation: {
      callData: `0x${string}`;
      callGasLimit: bigint;
      initCode: `0x${string}`;
      maxFeePerGas: bigint;
      maxPriorityFeePerGas: bigint;
      nonce: bigint;
      paymasterAndData: `0x${string}`;
      preVerificationGas: bigint;
      sender: `0x${string}`;
      signature: `0x${string}`;
      verificationGasLimit: bigint;
  }
  The user operation to estimate for
  - callData: `0x${string}`
  - callGasLimit: bigint
    Gas limit for the main execution call
  - initCode: `0x${string}`
  - maxFeePerGas: bigint
    Maximum total fee per gas unit
  - maxPriorityFeePerGas: bigint
    Maximum priority fee per gas unit
  - nonce: bigint
    Account nonce
  - paymasterAndData: `0x${string}`
  - preVerificationGas: bigint
    Gas overhead for pre-verification operations
  - sender: `0x${string}`
  - signature: `0x${string}`
  - verificationGasLimit: bigint
    Gas limit for the verification phase
- baseFeePerGas: bigint
  Current base fee per gas
- options: EstimateUserOperationGasOptions
  Estimation options
- OptionalstateOverrides: StateOverrideSet
  Optional state overrides
Returns Promise<EstimateUserOperationGasResult>
Gas estimation results

Throws
Error if binary search fails
- Defined in gas-estimator/evm/EVMGasEstimator.ts:378

Class EVMGasEstimator

Implements

Example

Hierarchy (View Summary)

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns EVMGasEstimator

Properties

chain

entryPoints

ProtectedrpcClient

simulationLimits

Methods

estimatePreVerificationGas

Parameters

Returns Promise<bigint>

Example

estimateUserOperationGas

Parameters

baseFeePerGas: bigint

Optionaloptions?: Partial<EstimateUserOperationGasOptions>

OptionalstateOverrides?: StateOverrideSet

unEstimatedUserOperation: UnEstimatedUserOperation

Returns Promise<EstimateUserOperationGasResult>

Throws

Example

estimateVerificationAndCallGasLimits

Parameters

Returns { callGasLimit: bigint; validAfter: number; validUntil: number; verificationGasLimit: bigint;}

mergeEstimateUserOperationGasOptions

Parameters

Returns EstimateUserOperationGasOptions

useBinarySearch

Parameters

callData: `0x${string}`

callGasLimit: bigint

initCode: `0x${string}`

maxFeePerGas: bigint

maxPriorityFeePerGas: bigint

nonce: bigint

paymasterAndData: `0x${string}`

preVerificationGas: bigint

sender: `0x${string}`

signature: `0x${string}`

verificationGasLimit: bigint

Returns Promise<EstimateUserOperationGasResult>

Throws

Settings

On This Page

`Protected`rpcClient

`Optional`options?: Partial<EstimateUserOperationGasOptions>

`Optional`stateOverrides?: StateOverrideSet

Returns {
callGasLimit: bigint;
validAfter: number;
validUntil: number;
verificationGasLimit: bigint;
}