How to manage ownership of a Modular Account
The Multi Owner plugin lets your smart accounts have one or more ECDSA or SCA owners. This lets your account integrate with multiple signers at once, and supports recovering your account if one signer is lost.
The Multi-Owner Plugin is able to:
- Update (add or remove) owners for an MSCA.
- Check if an address is an owner address of an MSCA.
- Show all owners of an MSCA.
- Validate signed signatures of ERC-4337 enabled user operations as well as regular transactions.
All Modular Accounts have MultiOwnerPlugin
pre-installed upon creation, exposing following methods for account owners to update (add or remove) and read the current owners of the account:
When you connect your Modular Account to SmartAccountClient
you can extend the client with multiOwnerPluginActions
, which exposes a set of methods available to call the installed MultiOwnerPlugin
with the client connected to the account.
1. Check if an address is one of the current owners of a Modular Account
You should first extend the SmartAccountClient
connected to a Modular Account, which already comes with MultiOwnerPlugin
installed upon creation, with client to multiOwnerPluginActions
for the client to include the MultiOwnerPlugin
actions.
When using createModularAccountAlchemyClient
in
@account-kit/smart-contracts
, the SmartAccountClient
comes automatically
extended with multiOwnerPluginActions
, pluginManagerActions
, and
accountLoupeActions
decorators as defaults available for use.
Then, you can use the readOwners
method of the multiOwnerPluginActions
extended smart account client to check if a given address is one of the current owners of a Modular Account.
2. Get all current owners of a Modular Account
You can use the readOwners
method on the multiOwnerPluginActions
extended smart account client to fetch all current owners of the connected Modular Account.
3. Add or remove owners for a Modular Account
You can use the updateOwners
method on the multiOwnerPluginActions
extended smart account client to add or remove owners from the Modular Account.