Etherspot Modular Accounts

Smart contract infrastructure for Etherspot Modular Accounts, supporting ERC7579 modular implementations.

Installation & Setup

Ensure that (Foundry)[https://github.com/foundry-rs/foundry] is installed.

forge install
forge build
forge test

ERC7579 Modular Contract Deployments

Prerequisites

Set up your .env file following the example found in .env.example.

Deployments

Can be found in /script folder. There are scripts for individual contract deployments and for staking/unstaking the wallet factory. There is also an all in one script to deploy all required contracts and stake the wallet factory.

To run all in one script:

forge script script/DeployAllAndSetup.s.sol:DeployAllAndSetupScript --broadcast -vvvv --rpc-url <NETWORK_NAME>

For individual deployment scripts (example):

forge script script/ModularEtherspotWallet.s.sol:ModularEtherspotWalletScript --broadcast -vvvv --rpc-url <NETWORK_NAME>

Test Suite

forge test

Solidity Usage

// SPDX-License-Identifier: MIT
pragma solidity 0.8.23;

import "@etherspot/modular-accounts/src/wallet/ModularEtherspotWallet.sol";

// ...

Documentation

• ERC4337 Specification
• ERC7579 Specification
• Integration Guide

License

MIT

Addresses

v1.0.0

Name	Address
ModularEtherspotWallet	0x339eAB59e54fE25125AceC3225254a0cBD305A7b
ModularEtherspotWalletFactory	0x2A40091f044e48DEB5C0FCbc442E443F3341B451
Bootstrap	0x0D5154d7751b6e2fDaa06F0cC9B400549394C8AA
MultipleOwnerECDSAValidator	0x0740Ed7c11b9da33d9C80Bd76b826e4E90CC1906