# Simple 7702 Account (EntryPoint v0.9) The `Simple7702AccountV09` is a minimalist smart contract account for EIP-7702, targeting **EntryPoint v0.9** (`0x433709009B8330FDa32311DF1C2AFA402eD8D009`). It shares the same audited contract implementation and API surface as `Simple7702Account`, with type specialization for `UserOperationV9`. EntryPoint v0.9 maintains ABI compatibility with v0.8 while adding: * **Parallelizable Paymaster Signing**: New `paymasterSignature` field allows passing data to Paymasters after UserOperation signing. * **Block Number-Based Validity Ranges**: `validAfter` and `validUntil` can now specify block numbers instead of timestamps. * **Flexible InitCode Handling**: `initCode` is silently ignored if the Account already exists, enabling two-dimensional nonce usage. * **UserOp Hash Query**: New `getCurrentUserOpHash` function exposes the current UserOperation hash during execution. The following ERCs are supported: * ERC-165 * ERC-721 * ERC-1155 * ERC-1271 * ERC-4337 v0.9 Full Example A complete working example is available on GitHub: [upgrade-eoa-to-7702-smart-account-EP-v09.ts](https://github.com/candidelabs/abstractionkit-examples/blob/main/eip-7702/upgrade-eoa-to-7702-smart-account-EP-v09.ts) Paymaster Not Yet Supported Candide paymaster does not yet support EntryPoint v0.9. Gas sponsorship and ERC-20 gas payment features are unavailable for this entrypoint version. Use `Simple7702Account` (EP v0.8) if you need paymaster support. ## Smart Contracts and Audits[​](#smart-contracts-and-audits "Direct link to Smart Contracts and Audits") The contracts were developed by the Ethereum Foundation Account Abstraction Team and audited by Cantina. * [Smart Contracts](https://github.com/eth-infinitism/account-abstraction/blob/develop/contracts/accounts/Simple7702Account.sol) * [Audit](https://github.com/eth-infinitism/account-abstraction/blob/develop/audits/ERC-4337%20Account%20Abstraction%20v0.9%20Security%20Review%20-%20Cantina.pdf) ## How to Use[​](#how-to-use "Direct link to How to Use") ### Prerequisites[​](#prerequisites "Direct link to Prerequisites") Before using `Simple7702AccountV09`, you must have: * **Node.js**: Version 18.0 or higher. * **EIP-7702 Compatible Network**: Ethereum mainnet, Sepolia, or other EIP-7702 enabled chains with EP v0.9 support. * **Private Key Access**: Required for signing authorizations and user operations. ### Installation[​](#installation "Direct link to Installation") ``` npm install abstractionkit ``` ### Usage[​](#usage "Direct link to Usage") ``` import { Simple7702AccountV09 } from "abstractionkit"; const delegatorPublicAddress = "0xBdbc5FBC9cA8C3F514D073eC3de840Ac84FC6D31"; // EOA public key const smartAccount = new Simple7702AccountV09(delegatorPublicAddress); ``` **Constructor defaults:** * `entrypointAddress`: `0x433709009B8330FDa32311DF1C2AFA402eD8D009` (EntryPoint v0.9) * `delegateeAddress`: `0xa46cc63eBF4Bd77888AA327837d20b23A63a56B5` Both can be overridden by passing an `overrides` object as the second constructor argument. ## Essential Methods[​](#essential-methods "Direct link to Essential Methods") ### createUserOperation[​](#createuseroperation "Direct link to createUserOperation") Creates a UserOperation for EIP-7702 accounts that can be sent to bundlers for execution. * example.ts * Param Types * Return Type example.ts ``` import { Simple7702AccountV09 } from "abstractionkit"; const delegatorPublicAddress = "0xBdbc5FBC9cA8C3F514D073eC3de840Ac84FC6D31"; const smartAccount = new Simple7702AccountV09(delegatorPublicAddress); const transactions = [ { to: "0x...", value: 0n, data: "0x...", }, ]; const userOperation = await smartAccount.createUserOperation( transactions, "https://ethereum-sepolia-rpc.publicnode.com", // provider RPC "https://your-ep-v09-bundler-rpc", // bundler RPC (must support EP v0.9) { eip7702Auth: { chainId, // chainId at which the account will be authorized }, // Optional overrides maxFeePerGas: 20000000000n, maxPriorityFeePerGas: 2000000000n, } ); ``` | key | type | description | | :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------- | | `transactions` | `SimpleMetaTransaction[]` | Array of transactions to include in the user operation | | `providerRpc?` | `string` | Optional JSON-RPC provider URL for blockchain queries | | `bundlerRpc?` | `string` | Optional bundler RPC URL for gas estimation | | `overrides?` | `key type descriptioneip7702Auth? key type descriptionchainId string Chain ID in hexadecimal format where the authorization is valid address string Address to authorize for the EOA delegation nonce string Authorization nonce in hexadecimal format yParity string Y parity of the authorization signature r string R component of the authorization signature s string S component of the authorization signature EIP-7702 authorization parameters for EOA delegation nonce? string Anti-replay parameter (see Semi-abstracted Nonce Support) callData? string The data to pass to the sender during the main execution call callGasLimit? bigint The amount of gas to allocate the main execution call verificationGasLimit? bigint The amount of gas to allocate for the verification step preVerificationGas? bigint The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata maxFeePerGas? bigint Maximum fee per gas (similar to EIP-1559 max_fee_per_gas) maxPriorityFeePerGas? bigint Maximum priority fee per gas (similar to EIP-1559 max_priority_fee_per_gas) callGasLimitPercentageMultiplier? number Set the callGasLimitPercentageMultiplier instead of estimating gas using the bundler verificationGasLimitPercentageMultiplier? number Set the verificationGasLimitPercentageMultiplier instead of estimating gas using the bundler preVerificationGasPercentageMultiplier? number Set the preVerificationGasPercentageMultiplier instead of estimating gas using the bundler maxFeePerGasPercentageMultiplier? number Set the maxFeePerGasPercentageMultiplier instead of querying the current gas price from the RPC node maxPriorityFeePerGasPercentageMultiplier? number Set the maxPriorityFeePerGasPercentageMultiplier instead of querying the current gas price from the RPC node stateOverrideSet? StateOverrideSet Pass state override set for simulation dummySignature? string Dummy signature for gas estimation` | Optional overrides for user operation creation | SimpleMetaTransaction | key | type | description | | :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------- | | `SimpleMetaTransaction` | `key type descriptionto string Target contract address for the transaction value bigint Value transferred in the transaction (usually 0n for contract interactions) data string The call data for the transaction` | SimpleMetaTransaction is the type of transaction used with Simple7702Account. | | key | type | description | | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------ | | `userOperation` | `key type descriptionsender string The account making the operation nonce bigint Anti-replay parameter (see Semi-abstracted Nonce Support) factory string \| null Account factory address, only for new accounts (null if account already exists) factoryData string \| null Data for account factory (null if account already exists) callData string The data to pass to the sender during the main execution call callGasLimit bigint The amount of gas to allocate the main execution call verificationGasLimit bigint The amount of gas to allocate for the verification step preVerificationGas bigint The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata maxFeePerGas bigint Maximum fee per gas (similar to EIP-1559 max_fee_per_gas) maxPriorityFeePerGas bigint Maximum priority fee per gas (similar to EIP-1559 max_priority_fee_per_gas) paymaster string \| null Address of paymaster contract (null if account pays for itself) paymasterVerificationGasLimit bigint \| null The amount of gas to allocate for the paymaster verification step (null if no paymaster) paymasterPostOpGasLimit bigint \| null The amount of gas to allocate for the paymaster post-operation code (null if no paymaster) paymasterData string \| null Data for paymaster (null if no paymaster) eip7702Auth Authorization7702Hex \| null EIP-7702 authorization data for EOA delegation (null if not using EIP-7702) signature string Data passed into the account to verify authorization. Resolves to '0x' when the user did not provide their signature yet` | The constructed user operation for EIP-7702 | ### signUserOperation[​](#signuseroperation "Direct link to signUserOperation") Signs a UserOperation with the provided private key for the EIP-7702 account. * example.ts * Param Types * Return Type example.ts ``` const signature = smartAccount.signUserOperation( userOperation, "0x...private-key", 11155111n // chain ID ); userOperation.signature = signature; ``` | key | type | description | | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------ | | `userOperation` | `key type descriptionsender string The account making the operation nonce bigint Anti-replay parameter (see Semi-abstracted Nonce Support) factory string \| null Account factory address, only for new accounts (null if account already exists) factoryData string \| null Data for account factory (null if account already exists) callData string The data to pass to the sender during the main execution call callGasLimit bigint The amount of gas to allocate the main execution call verificationGasLimit bigint The amount of gas to allocate for the verification step preVerificationGas bigint The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata maxFeePerGas bigint Maximum fee per gas (similar to EIP-1559 max_fee_per_gas) maxPriorityFeePerGas bigint Maximum priority fee per gas (similar to EIP-1559 max_priority_fee_per_gas) paymaster string \| null Address of paymaster contract (null if account pays for itself) paymasterVerificationGasLimit bigint \| null The amount of gas to allocate for the paymaster verification step (null if no paymaster) paymasterPostOpGasLimit bigint \| null The amount of gas to allocate for the paymaster post-operation code (null if no paymaster) paymasterData string \| null Data for paymaster (null if no paymaster) eip7702Auth Authorization7702Hex \| null EIP-7702 authorization data for EOA delegation (null if not using EIP-7702) signature string Data passed into the account to verify authorization. Resolves to '0x' when the user did not provide their signature yet` | The user operation to sign | | `privateKey` | `string` | Private key to sign the user operation with | | `chainId` | `bigint` | Chain ID for the target blockchain | | key | type | description | | :---------- | :------- | :----------------------------------- | | `signature` | `string` | The signature for the user operation | ### sendUserOperation[​](#senduseroperation "Direct link to sendUserOperation") Sends a signed UserOperation to the bundler for execution on-chain. * example.ts * Param Types * Return Type example.ts ``` const response = await smartAccount.sendUserOperation( userOperation, "https://your-ep-v09-bundler-rpc" // bundler URL (must support EP v0.9) ); console.log("UserOperation hash:", response.userOperationHash); // Wait for the transaction to be included const receipt = await response.included(); console.log("Transaction receipt:", receipt); ``` | key | type | description | | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------- | | `userOperation` | `key type descriptionsender string The account making the operation nonce bigint Anti-replay parameter (see Semi-abstracted Nonce Support) factory string \| null Account factory address, only for new accounts (null if account already exists) factoryData string \| null Data for account factory (null if account already exists) callData string The data to pass to the sender during the main execution call callGasLimit bigint The amount of gas to allocate the main execution call verificationGasLimit bigint The amount of gas to allocate for the verification step preVerificationGas bigint The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata maxFeePerGas bigint Maximum fee per gas (similar to EIP-1559 max_fee_per_gas) maxPriorityFeePerGas bigint Maximum priority fee per gas (similar to EIP-1559 max_priority_fee_per_gas) paymaster string \| null Address of paymaster contract (null if account pays for itself) paymasterVerificationGasLimit bigint \| null The amount of gas to allocate for the paymaster verification step (null if no paymaster) paymasterPostOpGasLimit bigint \| null The amount of gas to allocate for the paymaster post-operation code (null if no paymaster) paymasterData string \| null Data for paymaster (null if no paymaster) eip7702Auth Authorization7702Hex \| null EIP-7702 authorization data for EOA delegation (null if not using EIP-7702) signature string Data passed into the account to verify authorization. Resolves to '0x' when the user did not provide their signature yet` | The signed user operation to send | | `bundlerRpc` | `string` | Bundler RPC URL to send the user operation to | | key | type | description | | :--------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- | | `response` | `key type descriptionuserOperationHash string The hash over the userOp (except signature), entryPoint and chainId bundler Bundler The Bundler class entrypointAddress string The entrypoint address where the useroperation got executed included() Promise Waits for the user operation to be included onchain and returns the user operation receipt on success, or the bundler error on failture` | Response containing user operation hash and bundler details | SendUseroperationResponse | key | type | description | | :------------------ | :----------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------- | | `userOperationHash` | `string` | The hash over the userOp (except signature), entryPoint and chainId | | `bundler` | `Bundler` | The Bundler class | | `entrypointAddress` | `string` | The entrypoint address where the useroperation got executed | | `included()` | `Promise` | Waits for the user operation to be included onchain and returns the user operation receipt on success, or the bundler error on failture | BundlerJsonRpcError | key | type | description | | :-------- | :------- | :------------------------------------ | | `code` | `number` | Bundler RPC error code | | `message` | `string` | Bundler RPC error message description | UserOperationReceiptResult | key | type | description | | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------ | | `userOpHash` | `string` | The hash of the user operation. | | `entryPoint` | `string` | The address of the entry point contract that processed the operation. | | `sender` | `string` | The address of the sender of the user operation. | | `nonce` | `bigint` | The nonce of the user operation. | | `paymaster` | `string` | The address of the paymaster that paid for the gas of the user operation. | | `actualGasCost` | `bigint` | The actual gas cost incurred for executing the user operation. | | `actualGasUsed` | `bigint` | The actual amount of gas used for the user operation. | | `success` | `boolean` | Indicates whether the user operation was successful. | | `logs` | `string` | The logs produced during the execution of the user operation. | | `receipt` | `key type descriptionblockHash string The hash of the block in which the transaction was included. blockNumber bigint The number of the block in which the transaction was included. from string The address that initiated the transaction. cumulativeGasUsed bigint The total amount of gas used in the block up to and including this transaction. gasUsed bigint The amount of gas used by this transaction. logs string Logs generated by the transaction. logsBloom string The bloom filter for the logs generated by the transaction. transactionHash string The unique hash of the transaction. transactionIndex bigint The index of the transaction within the block. effectiveGasPrice bigint The effective gas price for the transaction. This field is optional and may not be present in all receipts.` | The detailed receipt of the user operation. | ## Advanced Methods[​](#advanced-methods "Direct link to Advanced Methods") ### createAccountCallData[​](#createaccountcalldata "Direct link to createAccountCallData") Creates call data for a basic transaction with specified target, value, and data. * example.ts * Param Types * Return Type example.ts ``` const callData = Simple7702AccountV09.createAccountCallData( "0x...", // to address 1000000000000000000n, // value in wei "0x..." // transaction data ); ``` | key | type | description | | :------ | :------- | :----------------------------------- | | `to` | `string` | Target address for the transaction | | `value` | `bigint` | Value to transfer in the transaction | | `data` | `string` | Call data for the transaction | | key | type | description | | :--------- | :------- | :-------------------------------------------- | | `callData` | `string` | Encoded call data for the account transaction | ### createAccountCallDataSingleTransaction[​](#createaccountcalldatasingletransaction "Direct link to createAccountCallDataSingleTransaction") Creates call data for a single SimpleMetaTransaction. * example.ts * Param Types * Return Type example.ts ``` const metaTransaction = { to: "0x...", value: 0n, data: "0x...", }; const callData = Simple7702AccountV09.createAccountCallDataSingleTransaction(metaTransaction); ``` | key | type | description | | :---------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------ | | `metaTransaction` | `key type descriptionSimpleMetaTransaction key type descriptionto string Target contract address for the transaction value bigint Value transferred in the transaction (usually 0n for contract interactions) data string The call data for the transaction SimpleMetaTransaction is the type of transaction used with Simple7702Account.` | The SimpleMetaTransaction to create call data for | | key | type | description | | :--------- | :------- | :-------------------------------------------- | | `callData` | `string` | Encoded call data for the account transaction | ### createAccountCallDataBatchTransactions[​](#createaccountcalldatabatchtransactions "Direct link to createAccountCallDataBatchTransactions") Creates call data for batching multiple SimpleMetaTransactions together. * example.ts * Param Types * Return Type example.ts ``` const transactions = [ { to: "0x...", value: 0n, data: "0x..." }, { to: "0x...", value: 0n, data: "0x..." }, ]; const callData = Simple7702AccountV09.createAccountCallDataBatchTransactions(transactions); ``` | key | type | description | | :------------- | :------------------------ | :------------------------------------------------ | | `transactions` | `SimpleMetaTransaction[]` | Array of SimpleMetaTransactions to batch together | | key | type | description | | :--------- | :------- | :-------------------------------------------- | | `callData` | `string` | Encoded call data for the account transaction | ### estimateUserOperationGas[​](#estimateuseroperationgas "Direct link to estimateUserOperationGas") Estimates gas limits for a UserOperation using the bundler. * example.ts * Param Types * Return Type example.ts ``` const [callGasLimit, verificationGasLimit, preVerificationGas] = await smartAccount.estimateUserOperationGas( userOperation, "https://your-ep-v09-bundler-rpc", { // Optional overrides stateOverrideSet: {...}, dummySignature: "0x...", } ); ``` | key | type | description | | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------- | | `userOperation` | `key type descriptionsender string The account making the operation nonce bigint Anti-replay parameter (see Semi-abstracted Nonce Support) factory string \| null Account factory address, only for new accounts (null if account already exists) factoryData string \| null Data for account factory (null if account already exists) callData string The data to pass to the sender during the main execution call callGasLimit bigint The amount of gas to allocate the main execution call verificationGasLimit bigint The amount of gas to allocate for the verification step preVerificationGas bigint The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata maxFeePerGas bigint Maximum fee per gas (similar to EIP-1559 max_fee_per_gas) maxPriorityFeePerGas bigint Maximum priority fee per gas (similar to EIP-1559 max_priority_fee_per_gas) paymaster string \| null Address of paymaster contract (null if account pays for itself) paymasterVerificationGasLimit bigint \| null The amount of gas to allocate for the paymaster verification step (null if no paymaster) paymasterPostOpGasLimit bigint \| null The amount of gas to allocate for the paymaster post-operation code (null if no paymaster) paymasterData string \| null Data for paymaster (null if no paymaster) eip7702Auth Authorization7702Hex \| null EIP-7702 authorization data for EOA delegation (null if not using EIP-7702) signature string Data passed into the account to verify authorization. Resolves to '0x' when the user did not provide their signature yet` | The user operation to estimate gas for | | `bundlerRpc` | `string` | Bundler RPC URL for gas estimation | | `overrides?` | `key type descriptionstateOverrideSet? StateOverrideSet State override set for simulation dummySignature? string Dummy signature for gas estimation` | Optional overrides for gas estimation | | key | type | description | | :---------- | :------------------------- | :----------------------------------------------------------------- | | `gasLimits` | `[bigint, bigint, bigint]` | Tuple of \[callGasLimit, verificationGasLimit, preVerificationGas] | ## Error Handling & Common Issues[​](#error-handling--common-issues "Direct link to Error Handling & Common Issues") * Authorization Errors * Gas Estimation Issues * Network Mismatches ``` // Missing eip7702Auth on the first UserOperation authorization const userOperation = await smartAccount.createUserOperation( transactions, providerRpc, bundlerRpc, { eip7702Auth: { chainId: 11155111n }, // Required for EIP-7702 } ); ``` ``` // Use multipliers if gas prices are volatile const userOperation = await smartAccount.createUserOperation( transactions, providerRpc, bundlerRpc, { eip7702Auth: { chainId: 11155111n }, maxFeePerGasPercentageMultiplier: 120, // 20% above current network conditions maxPriorityFeePerGasPercentageMultiplier: 150, // 50% above current network conditions } ); ``` ``` // Ensure chainId, RPC, and bundler all target the same network const userOperation = await smartAccount.createUserOperation( transactions, "https://ethereum-sepolia-rpc.publicnode.com", // Sepolia RPC "https://your-ep-v09-bundler-rpc", // Sepolia EP v0.9 bundler { eip7702Auth: { chainId: 11155111n }, // Sepolia chainId } ); ```