Introduction
The TrustVault MetaMask Snap enhances the capabilities of MetaMask by allowing users to utilize TrustVault sub-wallets as accounts within MetaMask. This comprehensive guide will walk you through the process of installing and using the Snap, ensuring you can maximize its features effectively.
Prerequisites
Before you can install and use a Snap, it is essential to confirm that you have the latest version of MetaMask installed on your browser. This is a crucial step to ensure compatibility and a smooth user experience.
- For Production: To install MetaMask, you can either download it from the Chrome Web Store or visit the TrustVault Web Snap page, where you should click on the option that says "Install MetaMask on Chrome Web Store." It is important to note that all subsequent instructions will be based on the assumption that you are using the Production version; however, these steps are also applicable if you are working in a Sandbox environment.
- For Sandbox: If you are looking to work in a development environment, you will need to install MetaMask Flask, which is a specialized version that supports Snap functionality. You can find it in the extension store of your browser or navigate to the TrustVault Web Snap page (Sandbox) and click on "Install MetaMask Flask on Chrome Web Store."
Step 1: Installing MetaMask
- If you already have MetaMask installed, you can directly move on to Step 2 of this guide.
In case you do not have MetaMask installed in your browser, you will be prompted to install it.- Follow these steps:
- Click on "Install MetaMask on Chrome Web Store."
- Proceed with the installation of the extension by following the on-screen instructions.
- If you already possess an existing wallet, click on "Import existing wallet" and adhere to the provided instructions.
- If you are new to MetaMask and do not have an existing wallet, click on "Create new wallet" and follow the necessary steps to set up your new wallet.
If you currently have the TrustVault MetaMask Extension installed, please consult the migration section for guidance on how to transition smoothly.
Step 2: Installing the Snap
- Begin by opening your preferred web browser and navigating to the TrustVault Web Snap page.
- On the webpage, locate the button labeled "Install TrustVault MetaMask Snap."
- Click on this button and approve the installation request that appears in MetaMask to proceed with the installation.
- Once the installation is complete, the Snap will be ready for you to use.
Step 3: Upgrading the Snap
If you need to upgrade the Snap, the process is identical to the initial installation. Should you not have the latest version of the Snap, the TrustVault Web Snap page will automatically detect this and prompt you to install the most recent version.
Step 4: Adding Accounts to the Snap
- To start, open the TrustVault Web Snap page and ensure that the Snap is successfully installed.
- Next, find and click the "Add" button located next to the Snap account you wish to add.
You will then need to approve the request that appears in MetaMask to authorize the addition of this account. - Finally, open MetaMask to verify that the account has been added successfully and check that it is marked with the "TrustVault" symbol, indicating that it is linked to your TrustVault accounts.
Step 5: Using the Snap
Once you have added your accounts, you can utilize them to engage with MetaMask or interact with various decentralized applications (dApps):
Using MetaMask:
- Open your MetaMask extension and select an account that displays the "TrustVault" symbol.
- Click on the "Send" option, where you can specify the recipient and the amount you wish to send.
- Confirm the transaction details in MetaMask to proceed.
- Complete the TrustVault signing process, which may involve filling out Travel Rule information and signing with the devices specified in your policy.
- After a few moments, your transaction will be broadcasted to the network, and you will see it marked as "Confirmed" in MetaMask.
Using a Decentralized Application (dApp):
- Navigate to the dApp you wish to use.
- Interact with the dApp to initiate a transaction or a signing request.
- Carefully review the details of the request displayed in MetaMask.
- Confirm the request within MetaMask to proceed.
- Complete the TrustVault signing process, similar to the previous steps (including Travel Rule information and signing with your policy devices).
- Within a few moments, the transaction will be broadcasted, and you will see it marked as "Confirmed" in MetaMask, or the signing request will be returned to the dApp for further processing.
Step 6: Removing the Snap
If you find that you no longer require the Snap, you can easily remove it by following these steps:
- Open your MetaMask extension and navigate to the Settings menu.
- From the menu, select Snaps to view your installed Snaps.
- Locate the TrustVault Snap within the list of installed Snaps.
- Click on the Remove option and confirm your action to uninstall the Snap.
- The TrustVault Snap will then be successfully uninstalled from your MetaMask extension.
Migrating from TrustVault MetaMask Extension
If you have previously utilized the TrustVault MetaMask extension, migrating to the TrustVault Snap can be accomplished in two distinct ways, depending on how you have used the extension:
MetaMask with only TrustVault accounts (simple)
If your usage of the TrustVault MetaMask extension has been limited solely to interacting with TrustVault and you have not received any funds in a non-TrustVault MetaMask account, the migration process is straightforward and involves the following steps:
- Begin by uninstalling the TrustVault MetaMask extension from your browser.
- Proceed to follow the steps outlined in the Installing MetaMask section to create a new wallet.
After creating a new wallet, follow the steps in the Installing the Snap section to set up the Snap.
MetaMask with both TrustVault and non-TrustVault accounts (advanced)
If your use of the TrustVault MetaMask extension has included interactions with both TrustVault and non-TrustVault accounts (as depicted in the accompanying image), you can migrate by following these steps:
- First, export your TrustVault MetaMask extension recovery seed phrase by performing the following actions:
- Click on the three dots located at the top right corner of the extension interface.
- Navigate to
Settings -> Security & privacy.
- Click on Reveal Secret Recovery Phrase and follow the instructions until the recovery phrase is revealed.
- Ensure that you secure the recovery phrase, for example, by saving it in a password manager.
- Next, uninstall the TrustVault MetaMask extension from your browser.
- After uninstalling, follow the steps in the Installing MetaMask section, opting to import an existing wallet and using the recovery phrase you saved in the previous step.
- Finally, follow the steps in the Installing the Snap section to complete the setup.
Troubleshooting
Are transactions or requests not being created or completed? If you encounter this issue, try removing the Snap and then navigate back to the TrustVault Web Snap page to reinstall the Snap.
Walkthrough
We have prepared a video walkthough of the setup that can be viewed here