ERC-4337 Smart Accounts

All of thirdweb's smart wallets are EIP-4337 smart contract wallets with role-based permission control.

Users can deploy a smart wallet for individual use, and app developers can issue smart wallets to their users programmatically.

thirdweb's smart wallets have the following features by default:

  • Have multiple owners
  • Execute transactions (single and batched).
  • Send and receive native tokens.
  • Send and receive ERC-721 and ERC-1155 NFTs.
  • Multicall-able.
  • Store contract metadata.

Choose the right smart wallet setup for your app. thirdweb offers the following three different kinds of smart wallets:

UpgradeabilityNon-upgradeableAccount upgrades controlled centrally by the parent account factory admin.
User personaDeveloper wants to issue simple smart wallets to their users. They do not anticipate that users wallets will need any feature upgrades.Developer wants to issue smart wallets to their users. They do anticipate feature upgrades to user wallets, and want to push upgrades to user wallets for seamless/invisible UX for upgrades.

Simple smart wallets

Account.sol & AccountFactory.sol

The Account smart wallet is a simple smart wallet that comes with all the basic benefits of account abstraction, along with the mentioned default features.

App developers can issue Account smart wallets programmatically by deploying an AccountFactory smart contract.

The Account smart contract is non-upgradeable. Developers should use this wallet if they do not anticipate making any future upgrades to their users’ wallets.

Managed Smart Wallets

ManagedAccount.sol & ManagedAccountFactory.sol

The ManagedAccount smart wallet is an upgradeable smart contract written in the dynamic contract pattern.

App developers can issue ManagedAccount smart wallets programmatically by deploying a ManagedAccountFactory smart contract.

The admin of the ManagedAccountFactory contract can push upgrades to all ManagedAccount that it creates. This admin does not require any permissions on the ManagedAccount smart wallets to do so. An upgrade to the features of ManagedAccount applies to all ManagedAccount smart wallets created by the factory. This is the right wallet for developers who anticipate pushing upgrades to their users’ wallets.

Example use case of push upgrades:

An app wants its user wallets to only be able to own NFTs within its ecosystem. This would be an upgrade to the smart wallet contract's onERC721Received and onERC1155Received transfer hooks.

The app can enforce this behaviour by pushing this upgrade to its user wallets.