EIP-8130

Reference implementation for EIP-8130: Account Abstraction by Account Configuration.

Warning — This is an active work in progress. The spec is changing and the code has not been audited. Do not use in production.

Overview

EIP-8130 defines a new transaction type and onchain system contract that together provide account abstraction. Accounts configure authorized actors and authenticators in the system contract; the protocol validates transactions using onchain authenticator contracts that implement IAuthenticator.authenticate(hash, data).

Contracts

Contract	Description
AccountConfiguration	System contract for actor authorization, account creation, and change sequencing
DefaultAccount	Default wallet implementation auto-delegated to EOAs
DefaultHighRateAccount	Wallet variant that blocks ETH transfers when locked for higher mempool rate limits

Authenticators

The canonical EIP-8130 authenticator set. secp256k1 (ECDSA) is built into AccountConfiguration as K1_AUTHENTICATOR (address(1), native ecrecover) — it is the single path for the default EOA and every k1 actor, so there is no standalone contract to deploy. AlwaysValidAuthenticator is an example/test helper, not a canonical authenticator.

Contract	Algorithm
K1_AUTHENTICATOR (built in, address(1))	secp256k1 (ECDSA)
P256Authenticator	secp256r1 / P-256 (raw)
WebAuthnAuthenticator	secp256r1 / P-256 (WebAuthn)
DelegateAuthenticator	Delegated validation (1-hop)
AlwaysValidAuthenticator	Always valid — keyless relay (example/testing only)

Usage

Build

forge build

Test

forge test

Format

forge fmt

CI runs forge fmt --check, so commits with unformatted Solidity will fail. A pre-commit hook in .githooks/ runs the same check locally. Enable it once per clone:

git config core.hooksPath .githooks

License

MIT