Class EntryPointV7Simulations

Implementation of EntryPoint v0.7.0 simulations for user operations. Provides methods for simulating operation execution and handling operation results.

Example

const simulator = new EntryPointV7Simulations(rpcClient);
const result = await simulator.simulateHandleOp({
  userOperation: userOp,
  targetAddress: '0x123...',
  targetCallData: '0x456...'
});

Constructors

constructor

Properties

abi address client version

Methods

encodeHandleOpsFunctionData parseRpcRequestErrorData simulateHandleOp

Constructors

constructor

Properties

abi

abi: readonly [
    {
        inputs: readonly [];
        stateMutability: "nonpayable";
        type: "constructor";
    },
    {
        inputs: readonly [
            { internalType: "bool"; name: "success"; type: "bool" },
            { internalType: "bytes"; name: "ret"; type: "bytes" },
        ];
        name: "DelegateAndRevert";
        type: "error";
    },
    {
        inputs: readonly [
            { internalType: "uint256"; name: "opIndex"; type: "uint256" },
            { internalType: "string"; name: "reason"; type: "string" },
        ];
        name: "FailedOp";
        type: "error";
    },
    {
        inputs: readonly [
            { internalType: "uint256"; name: "opIndex"; type: "uint256" },
            { internalType: "string"; name: "reason"; type: "string" },
            { internalType: "bytes"; name: "inner"; type: "bytes" },
        ];
        name: "FailedOpWithRevert";
        type: "error";
    },
    {
        inputs: readonly [
            { internalType: "bytes"; name: "returnData"; type: "bytes" },
        ];
        name: "PostOpReverted";
        type: "error";
    },
    {
        inputs: readonly [];
        name: "ReentrancyGuardReentrantCall";
        type: "error";
    },
    {
        inputs: readonly [
            { internalType: "address"; name: "sender"; type: "address" },
        ];
        name: "SenderAddressResult";
        type: "error";
    },
    {
        inputs: readonly [
            { internalType: "address"; name: "aggregator"; type: "address" },
        ];
        name: "SignatureValidationFailed";
        type: "error";
    },
    {
        anonymous: false;
        inputs: readonly [
            {
                indexed: true;
                internalType: "bytes32";
                name: "userOpHash";
                type: "bytes32";
            },
            {
                indexed: true;
                internalType: "address";
                name: "sender";
                type: "address";
            },
            {
                indexed: false;
                internalType: "address";
                name: "factory";
                type: "address";
            },
            {
                indexed: false;
                internalType: "address";
                name: "paymaster";
                type: "address";
            },
        ];
        name: "AccountDeployed";
        type: "event";
    },
    {
        anonymous: false;
        inputs: readonly [];
        name: "BeforeExecution";
        type: "event";
    },
    {
        anonymous: false;
        inputs: readonly [
            {
                indexed: true;
                internalType: "address";
                name: "account";
                type: "address";
            },
            {
                indexed: false;
                internalType: "uint256";
                name: "totalDeposit";
                type: "uint256";
            },
        ];
        name: "Deposited";
        type: "event";
    },
    {
        anonymous: false;
        inputs: readonly [
            {
                indexed: true;
                internalType: "bytes32";
                name: "userOpHash";
                type: "bytes32";
            },
            {
                indexed: true;
                internalType: "address";
                name: "sender";
                type: "address";
            },
            {
                indexed: false;
                internalType: "uint256";
                name: "nonce";
                type: "uint256";
            },
            {
                indexed: false;
                internalType: "bytes";
                name: "revertReason";
                type: "bytes";
            },
        ];
        name: "PostOpRevertReason";
        type: "event";
    },
    {
        anonymous: false;
        inputs: readonly [
            {
                indexed: true;
                internalType: "address";
                name: "aggregator";
                type: "address";
            },
        ];
        name: "SignatureAggregatorChanged";
        type: "event";
    },
    {
        anonymous: false;
        inputs: readonly [
            {
                indexed: true;
                internalType: "address";
                name: "account";
                type: "address";
            },
            {
                indexed: false;
                internalType: "uint256";
                name: "totalStaked";
                type: "uint256";
            },
            {
                indexed: false;
                internalType: "uint256";
                name: "unstakeDelaySec";
                type: "uint256";
            },
        ];
        name: "StakeLocked";
        type: "event";
    },
    {
        anonymous: false;
        inputs: readonly [
            {
                indexed: true;
                internalType: "address";
                name: "account";
                type: "address";
            },
            {
                indexed: false;
                internalType: "uint256";
                name: "withdrawTime";
                type: "uint256";
            },
        ];
        name: "StakeUnlocked";
        type: "event";
    },
    {
        anonymous: false;
        inputs: readonly [
            {
                indexed: true;
                internalType: "address";
                name: "account";
                type: "address";
            },
            {
                indexed: false;
                internalType: "address";
                name: "withdrawAddress";
                type: "address";
            },
            {
                indexed: false;
                internalType: "uint256";
                name: "amount";
                type: "uint256";
            },
        ];
        name: "StakeWithdrawn";
        type: "event";
    },
    {
        anonymous: false;
        inputs: readonly [
            {
                indexed: true;
                internalType: "bytes32";
                name: "userOpHash";
                type: "bytes32";
            },
            {
                indexed: true;
                internalType: "address";
                name: "sender";
                type: "address";
            },
            {
                indexed: true;
                internalType: "address";
                name: "paymaster";
                type: "address";
            },
            {
                indexed: false;
                internalType: "uint256";
                name: "nonce";
                type: "uint256";
            },
            { indexed: false; internalType: "bool"; name: "success"; type: "bool" },
            {
                indexed: false;
                internalType: "uint256";
                name: "actualGasCost";
                type: "uint256";
            },
            {
                indexed: false;
                internalType: "uint256";
                name: "actualGasUsed";
                type: "uint256";
            },
        ];
        name: "UserOperationEvent";
        type: "event";
    },
    {
        anonymous: false;
        inputs: readonly [
            {
                indexed: true;
                internalType: "bytes32";
                name: "userOpHash";
                type: "bytes32";
            },
            {
                indexed: true;
                internalType: "address";
                name: "sender";
                type: "address";
            },
            {
                indexed: false;
                internalType: "uint256";
                name: "nonce";
                type: "uint256";
            },
        ];
        name: "UserOperationPrefundTooLow";
        type: "event";
    },
    {
        anonymous: false;
        inputs: readonly [
            {
                indexed: true;
                internalType: "bytes32";
                name: "userOpHash";
                type: "bytes32";
            },
            {
                indexed: true;
                internalType: "address";
                name: "sender";
                type: "address";
            },
            {
                indexed: false;
                internalType: "uint256";
                name: "nonce";
                type: "uint256";
            },
            {
                indexed: false;
                internalType: "bytes";
                name: "revertReason";
                type: "bytes";
            },
        ];
        name: "UserOperationRevertReason";
        type: "event";
    },
    {
        anonymous: false;
        inputs: readonly [
            {
                indexed: true;
                internalType: "address";
                name: "account";
                type: "address";
            },
            {
                indexed: false;
                internalType: "address";
                name: "withdrawAddress";
                type: "address";
            },
            {
                indexed: false;
                internalType: "uint256";
                name: "amount";
                type: "uint256";
            },
        ];
        name: "Withdrawn";
        type: "event";
    },
    {
        inputs: readonly [
            { internalType: "bytes"; name: "initCode"; type: "bytes" },
            { internalType: "address"; name: "sender"; type: "address" },
            { internalType: "bytes"; name: "paymasterAndData"; type: "bytes" },
        ];
        name: "_validateSenderAndPaymaster";
        outputs: readonly [];
        stateMutability: "view";
        type: "function";
    },
    {
        inputs: readonly [
            { internalType: "uint32"; name: "unstakeDelaySec"; type: "uint32" },
        ];
        name: "addStake";
        outputs: readonly [];
        stateMutability: "payable";
        type: "function";
    },
    {
        inputs: readonly [
            { internalType: "address"; name: "account"; type: "address" },
        ];
        name: "balanceOf";
        outputs: readonly [{ internalType: "uint256"; name: ""; type: "uint256" }];
        stateMutability: "view";
        type: "function";
    },
    {
        inputs: readonly [
            { internalType: "address"; name: "target"; type: "address" },
            { internalType: "bytes"; name: "data"; type: "bytes" },
        ];
        name: "delegateAndRevert";
        outputs: readonly [];
        stateMutability: "nonpayable";
        type: "function";
    },
    {
        inputs: readonly [
            { internalType: "address"; name: "account"; type: "address" },
        ];
        name: "depositTo";
        outputs: readonly [];
        stateMutability: "payable";
        type: "function";
    },
    {
        inputs: readonly [
            { internalType: "address"; name: ""; type: "address" },
        ];
        name: "deposits";
        outputs: readonly [
            { internalType: "uint256"; name: "deposit"; type: "uint256" },
            { internalType: "bool"; name: "staked"; type: "bool" },
            { internalType: "uint112"; name: "stake"; type: "uint112" },
            { internalType: "uint32"; name: "unstakeDelaySec"; type: "uint32" },
            { internalType: "uint48"; name: "withdrawTime"; type: "uint48" },
        ];
        stateMutability: "view";
        type: "function";
    },
    {
        inputs: readonly [
            { internalType: "address"; name: "account"; type: "address" },
        ];
        name: "getDepositInfo";
        outputs: readonly [
            {
                components: readonly [
                    { internalType: "uint256"; name: "deposit"; type: "uint256" },
                    { internalType: "bool"; name: "staked"; type: "bool" },
                    { internalType: "uint112"; name: "stake"; type: "uint112" },
                    { internalType: "uint32"; name: "unstakeDelaySec"; type: "uint32" },
                    { internalType: "uint48"; name: "withdrawTime"; type: "uint48" },
                ];
                internalType: "struct IStakeManager.DepositInfo";
                name: "info";
                type: "tuple";
            },
        ];
        stateMutability: "view";
        type: "function";
    },
    {
        inputs: readonly [
            { internalType: "address"; name: "sender"; type: "address" },
            { internalType: "uint192"; name: "key"; type: "uint192" },
        ];
        name: "getNonce";
        outputs: readonly [
            { internalType: "uint256"; name: "nonce"; type: "uint256" },
        ];
        stateMutability: "view";
        type: "function";
    },
    {
        inputs: readonly [
            { internalType: "bytes"; name: "initCode"; type: "bytes" },
        ];
        name: "getSenderAddress";
        outputs: readonly [];
        stateMutability: "nonpayable";
        type: "function";
    },
    {
        inputs: readonly [
            {
                components: readonly [
                    { internalType: "address"; name: "sender"; type: "address" },
                    { internalType: "uint256"; name: "nonce"; type: "uint256" },
                    { internalType: "bytes"; name: "initCode"; type: "bytes" },
                    { internalType: "bytes"; name: "callData"; type: "bytes" },
                    { internalType: "bytes32"; name: "accountGasLimits"; type: "bytes32" },
                    {
                        internalType: "uint256";
                        name: "preVerificationGas";
                        type: "uint256";
                    },
                    { internalType: "bytes32"; name: "gasFees"; type: "bytes32" },
                    { internalType: "bytes"; name: "paymasterAndData"; type: "bytes" },
                    { internalType: "bytes"; name: "signature"; type: "bytes" },
                ];
                internalType: "struct PackedUserOperation";
                name: "userOp";
                type: "tuple";
            },
        ];
        name: "getUserOpHash";
        outputs: readonly [{ internalType: "bytes32"; name: ""; type: "bytes32" }];
        stateMutability: "view";
        type: "function";
    },
    {
        inputs: readonly [
            {
                components: readonly [
                    {
                        components: readonly [
                            { internalType: "address"; name: "sender"; type: "address" },
                            { internalType: "uint256"; name: "nonce"; type: "uint256" },
                            { internalType: "bytes"; name: "initCode"; type: "bytes" },
                            { internalType: "bytes"; name: "callData"; type: "bytes" },
                            {
                                internalType: "bytes32";
                                name: "accountGasLimits";
                                type: "bytes32";
                            },
                            {
                                internalType: "uint256";
                                name: "preVerificationGas";
                                type: "uint256";
                            },
                            { internalType: "bytes32"; name: "gasFees"; type: "bytes32" },
                            { internalType: "bytes"; name: "paymasterAndData"; type: "bytes" },
                            { internalType: "bytes"; name: "signature"; type: "bytes" },
                        ];
                        internalType: "struct PackedUserOperation[]";
                        name: "userOps";
                        type: "tuple[]";
                    },
                    {
                        internalType: "contract IAggregator";
                        name: "aggregator";
                        type: "address";
                    },
                    { internalType: "bytes"; name: "signature"; type: "bytes" },
                ];
                internalType: "struct IEntryPoint.UserOpsPerAggregator[]";
                name: "opsPerAggregator";
                type: "tuple[]";
            },
            { internalType: "address payable"; name: "beneficiary"; type: "address" },
        ];
        name: "handleAggregatedOps";
        outputs: readonly [];
        stateMutability: "nonpayable";
        type: "function";
    },
    {
        inputs: readonly [
            {
                components: readonly [
                    { internalType: "address"; name: "sender"; type: "address" },
                    { internalType: "uint256"; name: "nonce"; type: "uint256" },
                    { internalType: "bytes"; name: "initCode"; type: "bytes" },
                    { internalType: "bytes"; name: "callData"; type: "bytes" },
                    { internalType: "bytes32"; name: "accountGasLimits"; type: "bytes32" },
                    {
                        internalType: "uint256";
                        name: "preVerificationGas";
                        type: "uint256";
                    },
                    { internalType: "bytes32"; name: "gasFees"; type: "bytes32" },
                    { internalType: "bytes"; name: "paymasterAndData"; type: "bytes" },
                    { internalType: "bytes"; name: "signature"; type: "bytes" },
                ];
                internalType: "struct PackedUserOperation[]";
                name: "ops";
                type: "tuple[]";
            },
            { internalType: "address payable"; name: "beneficiary"; type: "address" },
        ];
        name: "handleOps";
        outputs: readonly [];
        stateMutability: "nonpayable";
        type: "function";
    },
    {
        inputs: readonly [
            { internalType: "uint192"; name: "key"; type: "uint192" },
        ];
        name: "incrementNonce";
        outputs: readonly [];
        stateMutability: "nonpayable";
        type: "function";
    },
    {
        inputs: readonly [
            { internalType: "bytes"; name: "callData"; type: "bytes" },
            {
                components: readonly [
                    {
                        components: readonly [
                            { internalType: "address"; name: "sender"; type: "address" },
                            { internalType: "uint256"; name: "nonce"; type: "uint256" },
                            {
                                internalType: "uint256";
                                name: "verificationGasLimit";
                                type: "uint256";
                            },
                            { internalType: "uint256"; name: "callGasLimit"; type: "uint256" },
                            {
                                internalType: "uint256";
                                name: "paymasterVerificationGasLimit";
                                type: "uint256";
                            },
                            {
                                internalType: "uint256";
                                name: "paymasterPostOpGasLimit";
                                type: "uint256";
                            },
                            {
                                internalType: "uint256";
                                name: "preVerificationGas";
                                type: "uint256";
                            },
                            { internalType: "address"; name: "paymaster"; type: "address" },
                            { internalType: "uint256"; name: "maxFeePerGas"; type: "uint256" },
                            {
                                internalType: "uint256";
                                name: "maxPriorityFeePerGas";
                                type: "uint256";
                            },
                        ];
                        internalType: "struct EntryPoint.MemoryUserOp";
                        name: "mUserOp";
                        type: "tuple";
                    },
                    { internalType: "bytes32"; name: "userOpHash"; type: "bytes32" },
                    { internalType: "uint256"; name: "prefund"; type: "uint256" },
                    { internalType: "uint256"; name: "contextOffset"; type: "uint256" },
                    { internalType: "uint256"; name: "preOpGas"; type: "uint256" },
                ];
                internalType: "struct EntryPoint.UserOpInfo";
                name: "opInfo";
                type: "tuple";
            },
            { internalType: "bytes"; name: "context"; type: "bytes" },
        ];
        name: "innerHandleOp";
        outputs: readonly [
            { internalType: "uint256"; name: "actualGasCost"; type: "uint256" },
        ];
        stateMutability: "nonpayable";
        type: "function";
    },
    {
        inputs: readonly [
            { internalType: "address"; name: ""; type: "address" },
            { internalType: "uint192"; name: ""; type: "uint192" },
        ];
        name: "nonceSequenceNumber";
        outputs: readonly [{ internalType: "uint256"; name: ""; type: "uint256" }];
        stateMutability: "view";
        type: "function";
    },
    {
        inputs: readonly [
            {
                components: readonly [
                    { internalType: "address"; name: "sender"; type: "address" },
                    { internalType: "uint256"; name: "nonce"; type: "uint256" },
                    { internalType: "bytes"; name: "initCode"; type: "bytes" },
                    { internalType: "bytes"; name: "callData"; type: "bytes" },
                    { internalType: "bytes32"; name: "accountGasLimits"; type: "bytes32" },
                    {
                        internalType: "uint256";
                        name: "preVerificationGas";
                        type: "uint256";
                    },
                    { internalType: "bytes32"; name: "gasFees"; type: "bytes32" },
                    { internalType: "bytes"; name: "paymasterAndData"; type: "bytes" },
                    { internalType: "bytes"; name: "signature"; type: "bytes" },
                ];
                internalType: "struct PackedUserOperation";
                name: "op";
                type: "tuple";
            },
            { internalType: "address"; name: "target"; type: "address" },
            { internalType: "bytes"; name: "targetCallData"; type: "bytes" },
        ];
        name: "simulateHandleOp";
        outputs: readonly [
            {
                components: readonly [
                    { internalType: "uint256"; name: "preOpGas"; type: "uint256" },
                    { internalType: "uint256"; name: "paid"; type: "uint256" },
                    {
                        internalType: "uint256";
                        name: "accountValidationData";
                        type: "uint256";
                    },
                    {
                        internalType: "uint256";
                        name: "paymasterValidationData";
                        type: "uint256";
                    },
                    { internalType: "bool"; name: "targetSuccess"; type: "bool" },
                    { internalType: "bytes"; name: "targetResult"; type: "bytes" },
                ];
                internalType: "struct IEntryPointSimulations.ExecutionResult";
                name: "";
                type: "tuple";
            },
        ];
        stateMutability: "nonpayable";
        type: "function";
    },
    {
        inputs: readonly [
            {
                components: readonly [
                    { internalType: "address"; name: "sender"; type: "address" },
                    { internalType: "uint256"; name: "nonce"; type: "uint256" },
                    { internalType: "bytes"; name: "initCode"; type: "bytes" },
                    { internalType: "bytes"; name: "callData"; type: "bytes" },
                    { internalType: "bytes32"; name: "accountGasLimits"; type: "bytes32" },
                    {
                        internalType: "uint256";
                        name: "preVerificationGas";
                        type: "uint256";
                    },
                    { internalType: "bytes32"; name: "gasFees"; type: "bytes32" },
                    { internalType: "bytes"; name: "paymasterAndData"; type: "bytes" },
                    { internalType: "bytes"; name: "signature"; type: "bytes" },
                ];
                internalType: "struct PackedUserOperation";
                name: "userOp";
                type: "tuple";
            },
        ];
        name: "simulateValidation";
        outputs: readonly [
            {
                components: readonly [
                    {
                        components: readonly [
                            { internalType: "uint256"; name: "preOpGas"; type: "uint256" },
                            { internalType: "uint256"; name: "prefund"; type: "uint256" },
                            {
                                internalType: "uint256";
                                name: "accountValidationData";
                                type: "uint256";
                            },
                            {
                                internalType: "uint256";
                                name: "paymasterValidationData";
                                type: "uint256";
                            },
                            { internalType: "bytes"; name: "paymasterContext"; type: "bytes" },
                        ];
                        internalType: "struct IEntryPoint.ReturnInfo";
                        name: "returnInfo";
                        type: "tuple";
                    },
                    {
                        components: readonly [
                            { internalType: "uint256"; name: "stake"; type: "uint256" },
                            { internalType: "uint256"; name: "unstakeDelaySec"; type: "uint256" },
                        ];
                        internalType: "struct IStakeManager.StakeInfo";
                        name: "senderInfo";
                        type: "tuple";
                    },
                    {
                        components: readonly [
                            { internalType: "uint256"; name: "stake"; type: "uint256" },
                            { internalType: "uint256"; name: "unstakeDelaySec"; type: "uint256" },
                        ];
                        internalType: "struct IStakeManager.StakeInfo";
                        name: "factoryInfo";
                        type: "tuple";
                    },
                    {
                        components: readonly [
                            { internalType: "uint256"; name: "stake"; type: "uint256" },
                            { internalType: "uint256"; name: "unstakeDelaySec"; type: "uint256" },
                        ];
                        internalType: "struct IStakeManager.StakeInfo";
                        name: "paymasterInfo";
                        type: "tuple";
                    },
                    {
                        components: readonly [
                            { internalType: "address"; name: "aggregator"; type: "address" },
                            {
                                components: readonly [
                                    { internalType: "uint256"; name: "stake"; type: "uint256" },
                                    {
                                        internalType: "uint256";
                                        name: "unstakeDelaySec";
                                        type: "uint256";
                                    },
                                ];
                                internalType: "struct IStakeManager.StakeInfo";
                                name: "stakeInfo";
                                type: "tuple";
                            },
                        ];
                        internalType: "struct IEntryPoint.AggregatorStakeInfo";
                        name: "aggregatorInfo";
                        type: "tuple";
                    },
                ];
                internalType: "struct IEntryPointSimulations.ValidationResult";
                name: "";
                type: "tuple";
            },
        ];
        stateMutability: "nonpayable";
        type: "function";
    },
    {
        inputs: readonly [
            { internalType: "bytes4"; name: "interfaceId"; type: "bytes4" },
        ];
        name: "supportsInterface";
        outputs: readonly [{ internalType: "bool"; name: ""; type: "bool" }];
        stateMutability: "view";
        type: "function";
    },
    {
        inputs: readonly [];
        name: "unlockStake";
        outputs: readonly [];
        stateMutability: "nonpayable";
        type: "function";
    },
    {
        inputs: readonly [
            {
                internalType: "address payable";
                name: "withdrawAddress";
                type: "address";
            },
        ];
        name: "withdrawStake";
        outputs: readonly [];
        stateMutability: "nonpayable";
        type: "function";
    },
    {
        inputs: readonly [
            {
                internalType: "address payable";
                name: "withdrawAddress";
                type: "address";
            },
            { internalType: "uint256"; name: "withdrawAmount"; type: "uint256" },
        ];
        name: "withdrawTo";
        outputs: readonly [];
        stateMutability: "nonpayable";
        type: "function";
    },
    { stateMutability: "payable"; type: "receive" },
] = ENTRYPOINT_V7_SIMULATIONS_ABI

address

address: `0x${string}` = ENTRYPOINT_V7_ADDRESS

The EntryPoint contract address, defaults to ENTRYPOINT_V7_ADDRESS

Protectedclient

client: EntryPointRpcClient

The RPC client used for blockchain interactions

version

version: EntryPointVersion = EntryPointVersion.v070

Methods

encodeHandleOpsFunctionData

  • encodeHandleOpsFunctionData(
        userOperation: {
            callData: `0x${string}`;
            callGasLimit: bigint;
            factory: `0x${string}`;
            factoryData: `0x${string}`;
            maxFeePerGas: bigint;
            maxPriorityFeePerGas: bigint;
            nonce: bigint;
            paymaster: `0x${string}`;
            paymasterData: `0x${string}`;
            paymasterPostOpGasLimit?: bigint;
            paymasterVerificationGasLimit?: bigint;
            preVerificationGas: bigint;
            sender: `0x${string}`;
            signature: `0x${string}`;
            verificationGasLimit: bigint;
        },
        beneficiary: `0x${string}`,
    ): `0x${string}`

  • Encodes the function data for handling multiple user operations.

    Parameters

    • userOperation: {
          callData: `0x${string}`;
          callGasLimit: bigint;
          factory: `0x${string}`;
          factoryData: `0x${string}`;
          maxFeePerGas: bigint;
          maxPriorityFeePerGas: bigint;
          nonce: bigint;
          paymaster: `0x${string}`;
          paymasterData: `0x${string}`;
          paymasterPostOpGasLimit?: bigint;
          paymasterVerificationGasLimit?: bigint;
          preVerificationGas: bigint;
          sender: `0x${string}`;
          signature: `0x${string}`;
          verificationGasLimit: bigint;
      }

      The user operation to encode

      • callData: `0x${string}`
      • callGasLimit: bigint

        Gas limit for the main execution call

      • factory: `0x${string}`
      • factoryData: `0x${string}`
      • maxFeePerGas: bigint

        Maximum total fee per gas unit

      • maxPriorityFeePerGas: bigint

        Maximum priority fee per gas unit

      • nonce: bigint

        Account nonce

      • paymaster: `0x${string}`
      • paymasterData: `0x${string}`
      • OptionalpaymasterPostOpGasLimit?: bigint

        Gas limit for paymaster post-operation execution

      • OptionalpaymasterVerificationGasLimit?: bigint

        Gas limit for paymaster verification

      • preVerificationGas: bigint

        Gas overhead for pre-verification operations

      • sender: `0x${string}`
      • signature: `0x${string}`
      • verificationGasLimit: bigint

        Gas limit for the verification phase

    • beneficiary: `0x${string}`

      The address that will receive the gas refund

    Returns `0x${string}`

    The encoded function data as a hex string

    Example

    const encodedData = simulator.encodeHandleOpsFunctionData(
      userOperation,
      '0x123...' // beneficiary address
    );

parseRpcRequestErrorData

  • parseRpcRequestErrorData(err: unknown): `0x${string}`

  • Parses RPC request error data from various error formats observed across different networks and RPC providers.

    Parameters

    • err: unknown

      The unknown error format to parse

    Returns `0x${string}`

    The parsed error data as a hex string

    Throws

    ParseError if the error cannot be parsed

    Example

    try {
      // ... RPC call
    } catch (err) {
      const data = simulator.parseRpcRequestErrorData(err);
    }

simulateHandleOp

  • simulateHandleOp(
        params: SimulateHandleOpParams,
    ): Promise<
        {
            accountValidationData: bigint;
            paid: bigint;
            paymasterValidationData: bigint;
            preOpGas: bigint;
            targetResult: `0x${string}`;
            targetSuccess: boolean;
        },
    >

  • Simulates the execution of a user operation. This method always reverts by design, and the execution result is parsed from the revert data.

    Parameters

    • params: SimulateHandleOpParams

      The simulation parameters

      • OptionalstateOverrides?: StateOverrideSet
      • targetAddress: `0x${string}`
      • targetCallData: `0x${string}`
      • userOperation: {
            callData: `0x${string}`;
            callGasLimit: bigint;
            factory: `0x${string}`;
            factoryData: `0x${string}`;
            maxFeePerGas: bigint;
            maxPriorityFeePerGas: bigint;
            nonce: bigint;
            paymaster: `0x${string}`;
            paymasterData: `0x${string}`;
            paymasterPostOpGasLimit?: bigint;
            paymasterVerificationGasLimit?: bigint;
            preVerificationGas: bigint;
            sender: `0x${string}`;
            signature: `0x${string}`;
            verificationGasLimit: bigint;
        }
        • callData: `0x${string}`
        • callGasLimit: bigint

          Gas limit for the main execution call

        • factory: `0x${string}`
        • factoryData: `0x${string}`
        • maxFeePerGas: bigint

          Maximum total fee per gas unit

        • maxPriorityFeePerGas: bigint

          Maximum priority fee per gas unit

        • nonce: bigint

          Account nonce

        • paymaster: `0x${string}`
        • paymasterData: `0x${string}`
        • OptionalpaymasterPostOpGasLimit?: bigint

          Gas limit for paymaster post-operation execution

        • OptionalpaymasterVerificationGasLimit?: bigint

          Gas limit for paymaster verification

        • preVerificationGas: bigint

          Gas overhead for pre-verification operations

        • sender: `0x${string}`
        • signature: `0x${string}`
        • verificationGasLimit: bigint

          Gas limit for the verification phase

    Returns Promise<
        {
            accountValidationData: bigint;
            paid: bigint;
            paymasterValidationData: bigint;
            preOpGas: bigint;
            targetResult: `0x${string}`;
            targetSuccess: boolean;
        },
    >

    The execution result containing validation and execution details

    Throws

    ParseError if the error data cannot be parsed

    Throws

    Error if the simulation fails with an error

    Example

    const result = await simulator.simulateHandleOp({
      userOperation: {
        sender: '0x123...',
        nonce: '0x1',
        // ... other UserOperation fields
      },
      targetAddress: '0x456...',
      targetCallData: '0x789...',
      stateOverrides: {
        // Optional state modifications
      }
    });

Settings

Member Visibility

On This Page

Constructors
Properties
Methods