Skip to main content

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

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​

The contracts were developed by the Ethereum Foundation Account Abstraction Team and audited by Cantina.

How to Use​

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​

npm install abstractionkit

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​

createUserOperation​

Creates a UserOperation for EIP-7702 accounts that can be sent to bundlers for execution.

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,
  }
);

signUserOperation​

Signs a UserOperation with the provided private key for the EIP-7702 account.

example.ts
const signature = smartAccount.signUserOperation(
  userOperation,
  "0x...private-key",
  11155111n // chain ID
);

userOperation.signature = signature;

sendUserOperation​

Sends a signed UserOperation to the bundler for execution on-chain.

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);

Advanced Methods​

createAccountCallData​

Creates call data for a basic transaction with specified target, value, and data.

example.ts
const callData = Simple7702AccountV09.createAccountCallData(
  "0x...", // to address
  1000000000000000000n, // value in wei
  "0x..." // transaction data
);

createAccountCallDataSingleTransaction​

Creates call data for a single SimpleMetaTransaction.

example.ts
const metaTransaction = {
  to: "0x...",
  value: 0n,
  data: "0x...",
};

const callData = Simple7702AccountV09.createAccountCallDataSingleTransaction(metaTransaction);

createAccountCallDataBatchTransactions​

Creates call data for batching multiple SimpleMetaTransactions together.

example.ts
const transactions = [
  { to: "0x...", value: 0n, data: "0x..." },
  { to: "0x...", value: 0n, data: "0x..." },
];

const callData = Simple7702AccountV09.createAccountCallDataBatchTransactions(transactions);

estimateUserOperationGas​

Estimates gas limits for a UserOperation using the bundler.

example.ts
const [callGasLimit, verificationGasLimit, preVerificationGas] =
  await smartAccount.estimateUserOperationGas(
    userOperation,
    "https://your-ep-v09-bundler-rpc",
    {
      // Optional overrides
      stateOverrideSet: {...},
      dummySignature: "0x...",
    }
  );

Error Handling & Common Issues​

// Missing eip7702Auth on the first UserOperation authorization
const userOperation = await smartAccount.createUserOperation(
  transactions,
  providerRpc,
  bundlerRpc,
  {
    eip7702Auth: { chainId: 11155111n }, // Required for EIP-7702
  }
);
Last updated on by sednaoui