EntryPoint

ERC-4337 entry point contract address type

EntryPoint

EntryPoint is a branded Address type representing the ERC-4337 entry point contract. The entry point is the central coordinator for account abstraction, validating and executing user operations submitted by bundlers.

Overview

The EntryPoint contract is the singleton that handles all user operations. It validates signatures, executes operations, and manages gas accounting and paymaster interactions. Voltaire provides constants for both v0.6 and v0.7 entry point addresses.

import { EntryPoint, ENTRYPOINT_V06, ENTRYPOINT_V07 } from '@tevm/voltaire/primitives/EntryPoint';

// Use v0.7 entry point
const entryPoint = EntryPoint.from(ENTRYPOINT_V07);
console.log(EntryPoint.toHex(entryPoint));
// "0x0000000071727de22e5e9d8baf0edac6f37da032"

// Use v0.6 entry point (legacy)
const legacyEntryPoint = EntryPoint.from(ENTRYPOINT_V06);
console.log(EntryPoint.toHex(legacyEntryPoint));
// "0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789"

Type Definition

import type { AddressType } from '../Address/AddressType.js';
import type { brand } from '../../brand.js';

export type EntryPointType = AddressType & { readonly [brand]: "EntryPoint" };

EntryPoint is a branded Address type. TypeScript enforces type safety through a unique Symbol brand, preventing mixing with other addresses while maintaining compatibility with Address operations.

API Reference

Constructors

from

Create EntryPoint from address input.

function from(
  value: number | bigint | string | Uint8Array | AddressType
): EntryPointType

From hex string

import { EntryPoint } from '@tevm/voltaire/primitives/EntryPoint';

const entryPoint = EntryPoint.from("0x0000000071727De22E5E9d8BAf0edAc6f37da032");

From constant

import { EntryPoint, ENTRYPOINT_V07 } from '@tevm/voltaire/primitives/EntryPoint';

const entryPoint = EntryPoint.from(ENTRYPOINT_V07);

Converters

toHex

Convert EntryPoint to hex string.

function toHex(
  entryPoint: number | bigint | string | Uint8Array | AddressType
): string

import { EntryPoint, ENTRYPOINT_V07 } from '@tevm/voltaire/primitives/EntryPoint';

const hex = EntryPoint.toHex(ENTRYPOINT_V07);
console.log(hex);
// "0x0000000071727de22e5e9d8baf0edac6f37da032"

Comparisons

equals

Check if two EntryPoint addresses are equal.

function equals(
  entryPoint1: number | bigint | string | Uint8Array | AddressType,
  entryPoint2: number | bigint | string | Uint8Array | AddressType
): boolean

import { EntryPoint, ENTRYPOINT_V06, ENTRYPOINT_V07 } from '@tevm/voltaire/primitives/EntryPoint';

console.log(EntryPoint.equals(ENTRYPOINT_V06, ENTRYPOINT_V07));
// false

const addr = "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789";
console.log(EntryPoint.equals(ENTRYPOINT_V06, addr));
// true

Constants

ENTRYPOINT_V06

Entry point v0.6.0 address: 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789

Original ERC-4337 entry point. Supports separate gas limit fields.

import { ENTRYPOINT_V06 } from '@tevm/voltaire/primitives/EntryPoint';

ENTRYPOINT_V07

Entry point v0.7.0 address: 0x0000000071727De22E5E9d8BAf0edAc6f37da032

Latest ERC-4337 entry point. Uses packed gas limits for reduced calldata size.

import { ENTRYPOINT_V07 } from '@tevm/voltaire/primitives/EntryPoint';

Entry Point Responsibilities

The EntryPoint contract handles:

1. Validation: Verifies user operation signatures and nonces
2. Gas accounting: Tracks pre-verification, verification, and execution gas
3. Paymaster interaction: Validates paymaster approval and handles gas sponsorship
4. Execution: Calls the account contract with the operation calldata
5. Event emission: Logs successful operations for indexing

Version Differences

v0.6.0

• Separate callGasLimit and verificationGasLimit fields
• Separate maxFeePerGas and maxPriorityFeePerGas fields
• Standard UserOperation struct

v0.7.0

• Packed gas limits: accountGasLimits (bytes32)
• Packed fees: gasFees (bytes32)
• PackedUserOperation struct
• Reduced calldata size (lower bundler costs)

Usage Patterns

Submitting User Operations

import { UserOperation } from '@tevm/voltaire/primitives/UserOperation';
import { EntryPoint, ENTRYPOINT_V07 } from '@tevm/voltaire/primitives/EntryPoint';

const userOp = UserOperation.from({
  sender: "0x742d35Cc6634C0532925a3b844Bc9e7595f251e3",
  nonce: 0n,
  initCode: "0x",
  callData: "0x...",
  callGasLimit: 100000n,
  verificationGasLimit: 200000n,
  preVerificationGas: 50000n,
  maxFeePerGas: 1000000000n,
  maxPriorityFeePerGas: 1000000000n,
  paymasterAndData: "0x",
  signature: "0x",
});

// Hash for signing
const userOpHash = UserOperation.hash(userOp, ENTRYPOINT_V07, 1);

Multi-Chain Support

import { EntryPoint, ENTRYPOINT_V07 } from '@tevm/voltaire/primitives/EntryPoint';

// Same entry point address across all chains
const mainnetEntry = EntryPoint.from(ENTRYPOINT_V07);
const optimismEntry = EntryPoint.from(ENTRYPOINT_V07);

console.log(EntryPoint.equals(mainnetEntry, optimismEntry));
// true

Related Types

• EntryPoint (Effect) - Effect.ts integration with Schema validation
• UserOperation - User operation structure (v0.6)
• PackedUserOperation - Packed user operation (v0.7)
• Paymaster - Gas sponsorship address
• Bundler - Operation bundler address
• Address - Base address type

References

• ERC-4337 Specification
• Entry Point v0.6
• Entry Point v0.7