Wallet Modals Overview​

Transform any Web2 platform to a fully functional Web3 environment

Wallet Modals and Self-Custody: Introduction

To prevent the platform from knowing the user's private key and from being considered a custodian, there are Seven widgets the platform needs to call:

These widgets ensure that the platform never knows the user's private key and is not able to sign transactions or messages on the user's behalf.


A wallet is created when the platform calls the sdk.wallet.create() function. There are no more steps needed. The widget is transparent.


A logged-in user (to the platform) that lost access to their wallet can regain access to the wallet by using the Sign-in widget. When the platform will calls the sdk.wallet.create() function, Tweed will identify that the user is known to the platform and the Sign-in widget will automatically open. If the user created a Recovery Kit they will get a dedicated social Sign-in modal, if not, they will get a sign-in flow based on their recovery phrase.

widget: The user did not create a Recovery Kit

widget: The user created a Recovery Kit

Create a Recovery Kit

After the platform creates the wallet for the user by calling the sdk.wallet.create() method, the platform can call this widget by calling the sdk.wallet.createRecovery() method. This will give the user the ability to back up their wallet by using the recovery seed phrase or by using Tweed's proprietary Recovery Kit technology. The user can decide not to back up their wallet and do it another time.

Sign Transaction

The user needs to approve transactions that require signing, such as selling crypto or sending crypto to another wallet. The user approves or rejects a transaction through the Sign Transaction widget. It also shows the transaction's financial and blockchain information.

Sign Message

The user needs to approve messages that require signing, such as connecting their wallet to another application. The user can approve or reject the message through the Sign Message widget. The widget shows the message that requires the signature.

Mnemonic Phrase

Optionally, you can make an end user's wallet seed phrase available and visible to them upon wallet creation, and save in plaintext to their Google Drive.

We recommend using the Recovery Kit; but should you want to make the seed phrase available to your users, use the Show Recovery Phase modal in the React docs.

With this widget, the end user can see their recovery phrase. A button in the modal prompts them to save their seed phrase to their Google Drive. All the user has to do is click this button and the seed phrase is saved to their Google Drive without any additional user action.


A Helper modal that shows all the addresses of the user with an easy to scan QR code.

Last updated