Kinto Wallet

Deployment Address

Mainnet implementation: 0x51c676fC24C776eBcb78B8ca3e6Ca2E810Dd6B80

Code: KintoWallet.sol

Interface: IKintoWallet.sol

---

Basics

• Executes transactions according to the Account Abstraction standard.

• Validates user operations signatures.

• Manages signers and signers policy.

• The emergency recovery process can be triggered through a unique signer.

• Approves applications explicitly.

• Manages the funder whitelist.

• Implements an insurance policy system.

---

State functions

initialize(address anOwner, address _recoverer) external virtual initializer onlyFactory

execute(address dest, uint256 value, bytes calldata func) external override

executeBatch(address[] calldata dest, uint256[] calldata values, bytes[] calldata func) external override

setSignerPolicy(uint8 newPolicy) public override onlySelf

resetSigners(address[] calldata newSigners, uint8 newPolicy) external override onlySelf

setFunderWhitelist(address[] calldata newWhitelist, bool[] calldata flags) external override onlySelf

whitelistApp(address[] calldata apps, bool[] calldata flags) external override onlySelf

setAppKey(address app, address signer) public override onlySelf

whitelistAppAndSetKey(address app, address signer) external override onlySelf

startRecovery() external override onlyFactory

completeRecovery(address[] calldata newSigners) external override onlyFactory

changeRecoverer(address newRecoverer) external override onlyFactory

cancelRecovery() public override onlySelf

setInsurancePolicy(uint256 newPolicy, address paymentToken) external override onlySelf

---

1. initialize (Factory only)

Initializes the KintoWallet with an owner and a recoverer.

function initialize(address anOwner, address _recoverer) external virtual initializer onlyFactory;

Parameter	Type	Explanation
anOwner	address	The initial owner of the KintoWallet.
_recoverer	address	The address designated as the recoverer for the wallet.

2. execute (EntryPoint only)

Executes a transaction.

function execute(address dest, uint256 value, bytes calldata func) external override;

Parameter	Type	Explanation
dest	address	The destination address.
value	uint256	The value to be transferred.
func	bytes	The calldata of the function.

3. executeBatch (EntryPoint only)

Executes a batch of transactions.

function executeBatch(address[] calldata dest, uint256[] calldata values, bytes[] calldata func) external override;

Parameter	Type	Explanation
dest	address[]	Array of destination addresses.
values	uint256[]	Array of values to be transferred.
func	bytes[]	Array of calldata for each function.

4. setSignerPolicy (only callable by Wallet itself)

Sets the signer policy of the wallet.

function setSignerPolicy(uint8 newPolicy) public override onlySelf;

Parameter	Type	Explanation
newPolicy	uint8	The new signer policy.

5. resetSigners (only callable by Wallet itself)

Resets the signers of the wallet.

function resetSigners(address[] calldata newSigners, uint8 newPolicy) external override onlySelf;

Parameter	Type	Explanation
newSigners	address[]	Array of new signers.
newPolicy	uint8	The signer policy to apply.

6. setFunderWhitelist (only callable by Wallet itself)

Sets the funder whitelist.

function setFunderWhitelist(address[] calldata newWhitelist, bool[] calldata flags) external override onlySelf;

Parameter	Type	Explanation
newWhitelist	address[]	Array of addresses to whitelist.
flags	bool[]	Flags to allow or disallow funders.

7. whitelistApp (only callable by Wallet itself)

Sets the app whitelist.

function whitelistApp(address[] calldata apps, bool[] calldata flags) external override onlySelf;

Parameter	Type	Explanation
apps	address[]	Array of app addresses.
flags	bool[]	Flags to allow or disallow apps.

8. setAppKey (only callable by Wallet itself)

Sets the app key for a specific app.

function setAppKey(address app, address signer) public override onlySelf;

Parameter	Type	Explanation
app	address	Address of the app.
signer	address	Address of the app signer.

9. whitelistAppAndSetKey (only callable by Wallet itself)

Whitelists an app and sets its app key.

function whitelistAppAndSetKey(address app, address signer) external override onlySelf;

Parameter	Type	Explanation
app	address	Address of the app.
signer	address	Address of the app signer.

10. startRecovery (only callable by Wallet Factory)

Starts the recovery process.

function startRecovery() external override onlyFactory;

No parameters.

11. completeRecovery (only callable by Wallet Factory)

Completes the recovery process and resets the signers.

function completeRecovery(address[] calldata newSigners) external override onlyFactory;

Parameter	Type	Explanation
newSigners	address[]	Array of new signers.

12. changeRecoverer (only callable by Wallet Factory)

Changes the recoverer.

function changeRecoverer(address newRecoverer) external override onlyFactory;

Parameter	Type	Explanation
newRecoverer	address	Address of the new recoverer.

13. cancelRecovery (only callable by Wallet itself)

Cancels the recovery process.

function cancelRecovery() public override onlySelf;

No parameters.

14. setInsurancePolicy (only callable by Wallet itself)

Sets the insurance policy for the wallet.

function setInsurancePolicy(uint256 newPolicy, address paymentToken) external override onlySelf;

Parameter	Type	Explanation
newPolicy	uint256	The new insurance policy to set.
paymentToken	address	The token address used for payment.

---

View Functions

isFunderWhitelisted(address funder) external view override returns (bool)

entryPoint() public view virtual override returns (IEntryPoint)

getNonce() public view virtual override(BaseAccount, IKintoWallet) returns (uint256)

getOwnersCount() external view override returns (uint256)

getOwners() external view override returns (address[] memory)

getInsurancePrice(uint256 newPolicy, address paymentToken) public pure override returns (uint256)

1. isFunderWhitelisted

Checks if a funder is whitelisted.

function isFunderWhitelisted(address funder) external view override returns (bool);

Parameter	Type	Explanation
funder	address	The funder address to check.

2. entryPoint

Returns the entry point of the wallet.

function entryPoint() public view virtual override returns (IEntryPoint);

No parameters.

3. getNonce

Gets the current nonce of the wallet.

function getNonce() public view virtual override(BaseAccount, IKintoWallet) returns (uint256);

No parameters.

4. getOwnersCount

Returns the count of owners of the wallet.

function getOwnersCount() external view override returns (uint256);

No parameters.

5. getOwners

Returns an array of the wallet's owners.

function getOwners() external view override returns (address[] memory);

No parameters.

6. getInsurancePrice

Returns the price of the insurance policy.

function getInsurancePrice(uint256 newPolicy, address paymentToken) public pure override returns (uint256);

Parameter	Type	Explanation
newPolicy	uint256	The insurance policy to price.
paymentToken	address	The token address used for payment.