EIPs

EIP-4337 — Account abstraction via entry-point

eips.ethereum.org/EIPS/eip-4337

The “smart account” standard. Replaces an EOA’s nonce + signature + tx_type flow with a UserOperation object that gets routed through a singleton EntryPoint contract. Bundlers aggregate user-operations into blocks; paymasters can sponsor gas.

import {
  ENTRY_POINT_V07_ADDRESS,
  eth_send_user_operation,
  pack_user_operation,
  type UserOperation,
} from "@ethernauta/eip/4337";

const packed = pack_user_operation(user_op);
const hash = await eth_send_user_operation({
  user_op: packed,
  entry_point: ENTRY_POINT_V07_ADDRESS,
})(signer({ chain_id: eip155_1.chain_id }));

Surface

Entry points

Export	Value
`ENTRY_POINT_V06_ADDRESS`	`0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789`
`ENTRY_POINT_V07_ADDRESS`	`0x0000000071727De22E5E9d8BAf0edAc6f37da032`

RPC methods

Method	Shape	Purpose
`eth_estimate_user_operation_gas`	`Signable<EstimateUserOperationGasResult>`	Gas estimation for a UserOp.
`eth_send_user_operation`	`Signable<Hash32>`	Submit a UserOp to a bundler.
`eth_get_user_operation_by_hash`	`Readable<UserOperationByHash>`	Look up a submitted UserOp.
`eth_get_user_operation_receipt`	`Readable<UserOperationReceipt>`	Receipt for a UserOp.
`eth_supported_entry_points`	`Readable<Address[]>`	Which entry-point addresses the node supports.

Packing

UserOperations have two on-the-wire shapes: the v0.6 form (separate fields) and the v0.7 form (packed into bytes32 fields). The packers convert between them:

Export	Purpose
`pack_user_operation`	Full v0.6 → v0.7 packing.
`pack_account_gas_limits`	`(uint128, uint128)` → `bytes32`.
`pack_gas_fees`	Priority fee + max fee → `bytes32`.
`pack_init_code`	Factory + factoryData → `bytes`.
`pack_paymaster_and_data`	Paymaster + gas limits + data.
`unpack_uint128_pair`	Reverse the gas-pair packing.

Signing

import { sign_user_op } from "@ethernauta/eip/4337";

const signature = sign_user_op({
  user_op,
  entry_point,
  chain_id,
  private_key,
});

sign_user_op computes the UserOp hash and signs it. Used in test fixtures and off-wallet flows; the wallet does the same composition internally when serving an eth_sendTransaction-equivalent for smart accounts.

Types and schemas

UserOperation, PackedUserOperation, UserOperationByHash, UserOperationReceipt, EstimateUserOperationGasResult — all with matching Valibot schemas (*Schema).

A note on scope

EIP-4337 as written requires off-chain infrastructure (bundlers, paymasters). The library ships the protocol shapes — packing, hashing, signing, the RPC method bindings — but does not stand up a hosted bundler or paymaster. That keeps M4 (no hosted infrastructure) intact.

A dapp using 4337 today still needs a bundler endpoint somewhere (its own, a third-party service, or a chain whose node speaks the methods natively). The library is bundler-agnostic.