WARNING: The contracts in this repository are experimental, not audited and should not be used in production.
- ERC-4337 Specification
- Vitalik Blog: ERC 4337: account abstraction without Ethereum protocol changes
- ERC-4337: A Complete Guide to Account Abstraction
- Argent Part 1: WTF is Account Abstraction
- Argent Part 2: WTF is Account Abstraction
- OpenZeppelin EIP-437 - Ethereum Account Abstraction Incremental Audit
- Stackup Infrastructure for Smart Contract Wallets ERC-4337 Overview
- Account Abstraction Resources
- Diagrams of the Account Abstraction Contracts
- Abstract Account Process Diagrams
Clone and compile this repository:
git clone [email protected]:naddison36/abstract-accounts.git
yarn
yarn compile
Hardhat Tasks are used to execute different transactions.
To see a list of available tasks run:
yarn task
The URL of the Ethereum node provider is set with the NODE_URL environment variable. For example:
export NODE_URL=https://eth-goerli.g.alchemy.com/v2/your-project-id
If deploying contracts, the ETHERSCAN_KEY environment variable is required so the contracts can be verified on Etherscan. You need to login to Etherscan and generate an API key at https://etherscan.io/myapikey
export ETHERSCAN_KEY=your-api-key
To see the log output, export the DEBUG environment variable:
export DEBUG=aa:*
In order to send transactions or sign user operations for the abstract wallet, a signer is required. This is an eternally owned account that uses a private key to cryptographically sign data. From this private key, the account address can be derived.
The following signers are supported:
- A private key by setting the
PRIVATE_KEYenvironment variable. - A mnemonic by setting the
MNEMONICenvironment variable. - Impersonating an account if working against a local Hardhat or Anvil node by setting the
IMPERSONATEenvironment variable to the account or contract address. - Using Defender Relay from Open Zeppelin by generating an API key and setting the
DEFENDER_API_KEYandDEFENDER_API_SECRETenvironment variables.
Uses the SimpleAccount contract from the Core Ethereum's eth-infinitism/account-abstraction repository. The Core contracts have been copied into this repo as typechain can't import the contracts from the @account-abstraction/contracts package. See typechain issue #816 for details.
The following Hardhat tasks work with the SimpleAccount contract:
AVAILABLE TASKS:
account-address Gets the abstract account for the signer
account-create Deploys a new SimpleAccount using the factory
account-factory-deploy Deploys a SimpleAccountFactory
account-transfers Transfers native currency (eg ETH) or tokens from the abstract account to one or more accounts by directly calling the EntryPoint contract
To create your own simple abstract wallet, run the following after setting up your signer:
yarn task account-create --network goerli
To deploy a new SimpleAccountFactory contract, run the following:
yarn task account-factory-deploy --network goerli
Run a Decentralized Exchange (DEX) in your wallet with DexWallet. No fees, approvals, deposits/withdrawals, impairment loss or slippage. Publish a signed order of what you want to exchange and let a market maker trade directly with your wallet.
Features:
- Whole swaps between two tokens.
- Buying or selling tokens at a fixed rate but to the available liquidity in the wallet.
- Buying or selling a batch of NFTs for a fixed token unit price.
- No approvals by either party.
- Expiry of orders.
- Canceling orders.
- Cross-chain replay protection.
Token Swap
To deploy a new DexWalletFactory contract, run the following:
yarn task account-factory-deploy --network goerli --factory DexWalletFactory
To verify the newly deployed DexWallet implementation contract
yarn task account-verify --network goerli --type DexWallet --address 0x7EdC734891a04750B7fc26cE7FdBCf771e96563C
To create your own dex wallet, run the following after setting up your signer:
yarn task account-create --network goerli --type DexWallet