Guide
EIP-8130 builder guide
Native account abstraction without bundlers or EntryPoints, live today on Vibenet. The same accounts work everywhere else through ERC-4337 providers. This guide is Viem-first and written for wallet and app builders.
What you get
- Batch calls: group multiple actions into a single transaction.
- Sponsorship: applications can pay for their users' gas fees or allow them to pay in any token.
- Portability: use the same account on any chain, even those that don't support native AA.
- Quantum ready: key rotation and multiple authentication schemes let users upgrade to post-quantum authentication.
- High throughput: parallel nonces and large sender limits unlock high levels of concurrency.
- Session keys: applications can act on your behalf with bounded and revocable permissions.
- Sub-accounts: fully isolated accounts owned by you and controllable by an application.
- Metadata: add memos and attributions to your transactions.
Two execution modes
| Concept | Meaning |
|---|---|
| Native EIP-8130 | Live on Vibenet today. Transactions are AA_TX_TYPE (0x79), no bundler, no EntryPoint. |
| Portable ERC-4337 | Same counterfactual address and account model via BackwardsCompatible4337Account + a bundler/provider where 8130 is not native yet. |
On the native path, sign an AA_TX_TYPE (0x79) envelope and submit it with eth_sendRawTransaction. Build once: same salt and initial actors yield the same address across both modes. Native is the happy path on Vibenet; 4337 providers extend reach everywhere else.
Learning path
Work the Phase A chapters in order. Later chapters are stubbed with the outline we will fill next.
- Mental model · Accounts, actors, authenticators, scopes, account changes, and call phases. (start here)
- Getting started · Configure a Viem client for EIP-8130, register chains, and connect to Vibenet.
- Creating accounts · EOA and smart accounts, multi-key setup, deployment templates, and counterfactual addresses.
- Sending transactions · Estimate, deploy-on-first-use, sign, submit, and read EIP-8130 receipts.
- Calls & phases · Atomic batches, multi-phase execution, and value-bearing calls.
- Keys & scopes · Authorize and revoke actors, scope presets, and just-in-time vs immediate rotations.
- Session keys · Policy-gated keys with spend limits, allowlists, and sign-with usage.
- Gas & payers · Co-signing payers, ERC-8168 payer services, and paying gas with USDV.
- Sub-accounts · Derive linked accounts and act through the delegate authenticator.
- Nonces & throughput · 2D nonces, nonceless transactions, and high-rate accounts.
- Multichain · Native EIP-8130 on Vibenet, portable ERC-4337 providers, same address everywhere.
- Signing · Sign with owners and session keys across authenticator types.
- Recipes · End-to-end checklists that stitch the chapters together.
Coming next
How to use this guide
- Snippets are Viem-first from
viem/experimental/eip8130. Full API detail lives in the Viem EIP-8130 docs. - Protocol docs: for mempool, validation, and design rationale see Protocol.