Recover users wallets
How to recover a wallet using recovery
Last updated
How to recover a wallet using recovery
Last updated
Users of Cometh Connect will generate and use a Safe as their wallet, with exclusive ownership and access to the funds it contains. Nonetheless, in the event of a lost key (such as misplacing their device or any other unforeseen circumstance), we aim to facilitate user's recovery of wallet access without compromising their security or self-custody. To achieve this, we have implemented a default feature in any Safe deployed to allow a guardian to initiate a recovery request. Upon the completion of a recovery request, the ownership structure of the Safe will be modified.
Our decentralized recovery model implementation is based on .
Before initiating a recovery request, the following conditions are assumed to be met:
The user possesses a Safe created using the connect-api.
The application using Cometh SDK should have identified their users before starting any recovery procedure.
A recovery request consists of three phases:
Creating a new owner: end user must create a signer that will be the new owner of his lost wallet.
User identification and submitting the recovery request: after identification of the user by the application, the recovery request can be created and sent to the guardian for signature.
Finalizing the recovery request: after Cometh's verification, provided the cooldown period is over (24h by default), the request can be processed. This action effectively modifies the ownership structure of the user's Safe.
In the case of lost access to the wallet, you can start a recovery procedure by calling the initRecoveryRequest function from the SDK. It will return an object that contains the new signer that will be the new owner of your wallet.
Following the creation of the new owner, they can then initiate a recovery request. This process is similar to a "Forgot password" feature, requiring the user to specify the new addresses they wish to designate as the new owners of their Safe.
From a technical standpoint, after identification of the user at the application level, this is done by calling Cometh Connect API :
Once the 24h recovery period is over without the owner of the Safe canceling the recovery, the request can be finalized. This step does not require any signature and can be executed by any party. Either Cometh, the project or the user can finalize the request.
An easy way to finalize the recovery request is by calling Cometh Connect API:
This action will do an on-chain transaction finalizing the change.
You can get the current recovery request using the getRecoveryRequest method of the SDK. You'll get the creation date of the request and the hash of the transaction.
Here is the method to call from the SDK:
If a recovery request is still in the cooldown period, the user can cancel it if he has access to a device with a valid signer. This is done using the SDK method cancelRecoveryRequest, triggering an onchain transaction that will cancel the recovery request.
delayAddress
(optional): The address used to delay the cancellation. If provided, the recovery request will be cancelled through this address.
Here is the method to call from the SDK:
This function sets up a delay module for the wallet. The setup involves deploying the delay module, enabling it on the wallet, and configuring it with the provided guardian address.
Parameters
guardianAddress
(string): The address of the guardian.
expiration
(number, optional): The expiration time for the delay module, 0 by default.
cooldown
(number, optional): The cooldown period for the delay module, 600 by default.
Here is the method to call from the SDK:
This function retrieves the delay module address for the wallet based on the specified expiration time and cooldown period.
Parameters
expiration
(number): The expiration time for the delay module.
cooldown
(number): The cooldown period for the delay module.
Here is the method to call from the SDK:
This function retrieves the current recovery parameters for the wallet, provided the delay module is already enabled on the wallet.
Parameters
delayModuleAddress
(string, optional): The address of the delay module. By default, the delay module address related to the guardian address of Cometh is used.
Here is the method to call from the SDK:
This function retrieves the guardian address for the specified delay module address. It ensures that the provided delay module address is enabled on the wallet before fetching the guardian address.
Parameters
delayModuleAddress
(string): The address of the delay module from which the guardian address will be retrieved.
Here is the method to call from the SDK:
This function disables a guardian's access to the delay module associated with the wallet by revoking the permissions previously granted to the specified guardian.
Parameters
guardianAddress
(string): The address of the guardian whose access is being disabled.
expiration
(number, optional): The expiration time for the delay module.
cooldown
(number, optional): The cooldown period for the delay module.
It requires the expiration and cooldown parameters only when the delay module has been set up using the setupDelayModule
function with specific expiration and cooldown periods.
Here is the method to call from the SDK:
This function allows to reactivate a guardian for the wallet. This function can only be used to reactivate a guardian that has been deactivated. It is important to note that at any given time, only one guardian can be linked to the delay module.
Parameters
delayModuleAddress
(string): The address of the delay module associated with the wallet. This module must already be enabled on the wallet.
guardianAddress
(string): The address of the new guardian to be added.
Here is the method to call from the SDK:
Start a recovery process. This will start the recovery period. During this period, the owner can cancel the recovery.
A string representation of a customer ApiSecret.
78d8e101a-9154-4000-91c5-b02527f4c70e
A wallet address
0x7Fc751C1725F3B955Aa8781640E1BAf5B75684c2
Pattern: ^0x[a-fA-F0-9]{40}$
A signer address.
0x3D9819210A31b4961b30EF54bE2aeD79B9c9Cd3B
The device system information.
A string representation of the public Key Id.
0xebd7c0e4e702a4b7310f860901406bd91db6f4c874996b69775ea15f71409b38
A string representation of the public Key X.
0xebd7c0e4e702a4b7310f860901406bd91db6f4c874996b69775ea15f71409b38
A string representation of the public Key Y.
0xebd7c0e4e702a4b7310f860901406bd91db6f4c874996b69775ea15f71409b38
Finalize a recovery process. This can be done only once the recovery period is over.
A string representation of a customer ApiSecret.
78d8e101a-9154-4000-91c5-b02527f4c70e
A wallet address
0x7Fc751C1725F3B955Aa8781640E1BAf5B75684c2
Pattern: ^0x[a-fA-F0-9]{40}$