> For the complete documentation index, see [llms.txt](https://docs.alloc8.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alloc8.xyz/architechure/readme/modular-smart-accounts.md).

# Modular Smart Accounts

Alloc8’s smart accounts are built on top of the **ERC-4337 account abstraction standard**, extended with **modularity**. At the core is the `Modular4337Account` — a **highly composable**, **upgrade-friendly**, and **developer-extensible** smart wallet contract.

At the center is the **Modular4337Account**: a smart wallet that supports plug-and-play modules for custom logic, without ever changing the core contract. Using a **hook-based architecture**, developers can add validation rules, execution logic, policy enforcement, fee routing, and more — safely and flexibly.

***

#### Key Capabilities

* **Modular Hook Design**\
  Add or remove functionality with `installModule()` and `removeModule()`. Only use what you need.
* **Validation Hooks**\
  Enforce arbitrary preconditions during validateUserOp() — such as session keys, time locks, multi-sig auth, or custom signature schemes.
* **Execution Hooks**\
  Modify or extend transactions on-chain — e.g., allowlists, fee rebates, or automatic forwarding.
* **ERC-1271 Signature Compatibility**\
  Works with dApps expecting standard ECDSA signatures.
* **Native ERC-4337 Integration**\
  Compatible with the EntryPoint contract and bundler flows for gasless UX and programmable userOps.
* **Extensible by Design**\
  Any module that follows the `IModule` interface can be plugged in, enabling safe upgrades and new features.

***

#### Why Use Modular4337Account?

Unlike fixed-function smart wallets, `Modular4337Account` it lets you compose wallet features like plug-ins in a software framework:

* You don’t need to deploy new contracts to add new capabilities/features to the wallet.
* You can progressively add features like **social recovery**, **role-based access**, **ERC20 spending caps**, or **session delegation**.
* Modules are auditable, reusable, and independently testable.
