You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
A simple ERC-4337 compatible smart contract account with a designated owner. [Account Kit](https://accountkit.alchemy.com) is the easiest way to integrate Light Account.
12
+
A set of lightweight ERC-4337 compatible smart contract accounts with designated ownership. [Account Kit](https://accountkit.alchemy.com) is the easiest way to integrate Light Account.
14
13
15
14
## Features
16
15
16
+
### `LightAccount`
17
+
17
18
Like [eth-infinitism](https://github.com/eth-infinitism/account-abstraction)'s [`SimpleAccount`](https://github.com/eth-infinitism/account-abstraction/blob/develop/contracts/samples/SimpleAccount.sol), but with the following changes:
18
19
19
20
1. Instead of the default storage slots, uses namespaced storage to avoid clashes when switching implementations.
@@ -24,9 +25,29 @@ Like [eth-infinitism](https://github.com/eth-infinitism/account-abstraction)'s [
24
25
25
26
_ERC-4337's bundler validation rules limit the types of contracts that can be used as owners to validate user operation signatures. For example, the contract's `isValidSignature` function may not use any forbidden opcodes such as `TIMESTAMP` or `NUMBER`, and the contract may not be an ERC-1967 proxy as it accesses a constant implementation slot not associated with the account, violating storage access rules. This also means that the owner of a `LightAccount` may not be another `LightAccount` if you want to send user operations through a bundler._
26
27
27
-
4. Event `SimpleAccountInitialized` renamed to `LightAccountInitialized`.
28
+
4. Improves gas estimation by enabling switching between `ecrecover` and ERC-1271 signature validation by prepending a `SignatureType` byte to the user operation signature. Allowed `SignatureType` values:
29
+
30
+
-`SignatureType.EOA`: For an EOA owner. Signature is validated using `ecrecover`.
31
+
-`SignatureType.CONTRACT`: For a contract owner. Signature is validated using `owner.isValidSignature`.
32
+
33
+
5. The factory uses Solady's `LibClone.createDeterministicERC1967` instead of OpenZeppelin's `ERC1967Proxy`.
34
+
35
+
6. The factory includes ownership and entry point staking capabilities to address mempool limitations for unstaked entities as defined in [ERC-7562](https://eips.ethereum.org/EIPS/eip-7562).
36
+
37
+
7. Event `SimpleAccountInitialized` renamed to `LightAccountInitialized`.
38
+
39
+
8. Uses custom errors.
40
+
41
+
### `MultiOwnerLightAccount`
42
+
43
+
Like `LightAccount`, but with the following changes:
44
+
45
+
1. Multiple owners are supported. They can be specified at account deployment, or updated via `updateOwners`. This is a simple single-step operation, so care must be taken to ensure that the ownership is being updated to the correct address(es).
46
+
47
+
2. Allowed `SignatureType` values:
28
48
29
-
5. Uses custom errors.
49
+
-`SignatureType.EOA`: For EOA owners. Signature is validated using `ecrecover`.
50
+
-`SignatureType.CONTRACT_WITH_ADDR`: For contract owners. Signature is validated using `owner.isValidSignature`. The contract owner address MUST be passed as part of the signature, following the format: `SignatureType.CONTRACT_WITH_ADDR || contractOwnerAddress || signature`, where `||` is the byte concatenation operator.
30
51
31
52
## Deployments
32
53
@@ -49,7 +70,8 @@ forge test -vvv
49
70
The deploy script supports any [wallet options](https://book.getfoundry.sh/reference/forge/forge-script#wallet-options---raw) provided by Foundry, including local private keys, mneumonics, hardware wallets, and remote signers. Append the chosen signing method's option to the field marked `[WALLET_OPTION]` in the following script command, and set the sender address in the field `[SENDER_ADDRESS]`.
0 commit comments