accounts

Simple extendable smart account implementations (Smarter Accounts or NANI). v1.2.3

Built with the Foundry testing suite and Solady solidity optimizations, this codebase demonstrates contemporary and efficient account abstractions through a representative implementation (Account, v1.2.3) and factory that deploys related ERC1967 minimal proxies with UUPS upgradeability. As such, Accounts users can upgrade into any account implementation at any time from their NANI wallet, such as Kernel or Coinbase, while the latest version of NANI Accounts will be maintained and deployed here.

All Accounts support the following standards: ERC173, EIP712, ERC1271, ERC1822, ERC1967, ERC2098, ERC4337, ERC5267, ERC6492, ERC7582

Currently, Accounts is the most optimized smart account implementation available to the public with a companion user interface on nani.ooo. Incentives are designed for participation in testing and development. Governance of the Accounts implementation and interface models is also introduced in v1.2.3.

Getting Started

Run: curl -L https://foundry.paradigm.xyz | bash && source ~/.bashrc && foundryup

Build the foundry project with forge build. Run contract tests with forge test. Measure gas fees with forge snapshot. Format code with forge fmt.

Deployments

v1.2.3

Account URL (Unruggable): 0x0000000000004Bf084D1821a0d9D271A84E5c8E4

Set hard 'rug' limits for ETH txs

Plugin Validators:

Utilizes ERC7582 minimal modular account interface.

JointValidator: 0x000000000000D3D2b2980A7BC509018E4d88e947

Add joint owners to your smart account with full concurrent rights

RecoveryValidator: 0x000000000000a78fB292191473E51Dd34700c43D

Add backups to your smart account (can set time delay and m/n scheme)

PaymentValidator: 0x000000000000dF3C51a888aB783C3E6355e33fe0

Add payment plans and delegate token transfer permissions (e.g., invoice agents)

PermitValidator: 0x000000000000E8C738709eE8778063711B073680

Add arbitrary permissions within the Permit structure (e.g., voting and swapping rights)

RemoteValidator: 0x0000000000159aAFCA7067005E28665a28B5B4cf

Add simple scheduled transactions sequence (e.g., DCA) or other 'remote' agent operations

Plugin Owners:

Dagon: 0x000000000000FEb893BB5D63bA33323EdCC237cE

token-weighted ownership (simulates multisig m/n and DAO voting)

Keys: 0x000000000000B418eE0A5B649462Fb851B266522

token-bound ownership (NFTs are owners, i.e., "my Milady is my key")

Plugin Guards:

Guard: 0x00000000000076a46Ae808b2eDAE7b3f64EF5b31

hard checks for smart accounts (i.e., "can't spend more than 0.1 ETH")

Paymaster:

NEETH (ARB): 0x00000000000009B4AB3f1bC2b029bd7513Fbd8ED

NEETH (BASE): 0x00000000000077E2072D61672eb6EC18a136c80A

magic paymaster: stake ETH and use DeFi yield to sponsor transactions

0x0000000000006Ac3d14B99811525D19e0168fDFe

pay tx relay with any asset

Blueprint

lib
├─ forge-std — https://github.com/foundry-rs/forge-std
├─ solady — https://github.com/vectorized/solady
src
├─ Account — Account Contract
├─ Accounts - Factory Contract
test
└─ Account.t - Test Contract

Disclaimer

These smart contracts and testing suite are being provided as is. No guarantee, representation or warranty is being made, express or implied, as to the safety or correctness of anything provided herein or through related user interfaces. This repository and related code have not been audited and as such there can be no assurance anything will work as intended, and users may experience delays, failures, errors, omissions, loss of transmitted information or loss of funds. The creators are not liable for any of the foregoing. Users should proceed with caution and use at their own risk.

License

See LICENSE for more details.