README.md

Etherspot Prime Contracts

Smart contract infrastructure for Etherspot Prime, supporting both ERC4337 (V1) and ERC7579 Modular (V2) implementations.

Installation & Setup

npm run setup

ERC4337 (V1) Contract Deployments

Prerequisites

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

Etherspot Wallet Factory deployment

npx hardhat deploy --network <NETWORK_NAME> --tags 'etherspot-wallet-factory'

Etherspot Paymaster deployment

npx hardhat deploy --network <NETWORK_NAME> --tags 'etherspot-paymaster'

Etherspot Wallet Factory & Etherspot Paymaster deployment

npx hardhat deploy --network <NETWORK_NAME> --tags 'required'

Test Suite

npx hardhat test

Solidity Usage

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.12;

import "@etherspot/prime-contracts/src/etherspot-wallet-v1/wallet/EtherspotWallet.sol";

// ...

ERC7579 Modular (V2) 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/prime-contracts/src/modular-etherspot-wallet/wallet/ModularEtherspotWallet.sol";

// ...

Documentation

• ERC4337 Specification
• ERC7579 Specification
• Integration Guide

License

MIT