ERC-7579 Reference Implementation

Reference Implementation to Minimal Modular Smart Account (ERC-7579).

Usage

Installation

pnpm i

Account flavors

The reference implementation provides two account flavors:

MSABasic: A basic modular smart account that supports the minimal set of features required to be compliant with the ERC-7579 standard.
MSAAdvanced: A modular smart account that supports the mandatory ERC-7579 features and the optional hook extension.

Note: The reference implementation is required to make some choices that are left open by the standard, such as how validators are encoded. The interface that is required by the ERC, without any additions, can be found in IERC7579.sol.

Security Note

The contracts in this repository are not audited. We advise against using this in production.

Credits

Validator Encoding in Signature: inspired by taek's (ZeroDev) Kernel
Validator Encoding in Nonce: Implementation of validator encoding in userOp nonce is inspired by ross' (Nani) Account
Fallback Manager: Fallback Manager is inspiried by Richard's (Safe) Fallback Manager
Try/catch execution: original idea by Elim and the OKX team