Connecting to MetaMask
Last updated
Last updated
If you're new to MetaMask, this guide will teach you all you need to know about establishing a connection to the app with your Lattice and using it in the most secure way possible.
If you're already using MetaMask (most new Lattice owners are), make sure the wallet you have on MetaMask is different from the wallet you have on the Lattice.
MetaMask will import each address you want it to as a standalone account, and each new MetaMask account has to have a unique address. This means that if you have the same wallet on Metamask as you do on the Lattice, MM won't let you import any addresses that already exist as accounts on the extension.
The same goes for other hardware wallet accounts already linked to MetaMask - if you imported your Trezor/Ledger seed to the Lattice, you won't be able to import any addresses from which MetaMask hardware-linked accounts are already created.
You can start by clicking on Account 1 at the top of MetaMask and selecting Add hardware wallet. Select the Lattice1 and click on Continue.
This will open a new browser tab with the secure GridPlus Lattice Connector module (the domain needs to be https://lattice.gridplus.io). The Lattice Connector is an interface you will use to create and log into 3rd party app connections - the process is the same for all apps that have a Lattice integration built into them. You will need to enter your device ID and a password on this page. Your device ID is unique to your device and is used to establish a connection with our servers - you can find it on your Lattice's homescreen as Device ID. Enter any password you like - this can be later reset. Press Connect.
Even though the password can be easily reset, it's better if you type in something you will remember or save it to a password manager, because if you'll want to add new accounts in the future using the same Lattice (more addresses from your Lattice wallet or addresses from a SafeCard wallet), you'll have to go through this process again - and the password needs to be the same if you don't want to re-connect from scratch.
This will take you to the next step - you should see a new screen asking you to enter a secret, which will now be displayed on your Lattice1 screen. Once you type in the secret correctly, your MetaMask app will be paired to your Lattice1. This will also create a new MetaMask permission on your device, and also a 3rd party connection on the Lattice Manager.
On this step, you may possibly encounter two errors:
An error that will pop up directly in MetaMask and will say Failed to get accounts.
The Lattice Connector will just spin endlessly without sending you to the screen you would normally after this step.
To get past these errors, please visit the MetaMask Troubleshooting Guide
.
You will be taken back to MetaMask to the Select an Account screen. Here you will select all the addresses from your wallet on the Lattice that you want to import to MetaMask. Each address will create a new standalone MetaMask account (the first address will be imported as a Lattice 1 account, the second as Lattice 2 etc.) - these new imported accounts will be linked to your Lattice. All transaction requests initiated from these accounts will also require your approval on the device screen, in addition to clicking Approve on MetaMask.
When should you change the HD path?
You should change the HD path if the wallet you imported on the Lattice1 was originally created on a Ledger device. All other wallets (Trezor wallets, MetaMask wallets etc.) use standard derivation paths.
Ledger Live or Ledger Legacy?
If you bought your Ledger device before July 2018, Legacy. If you bought it after, Live.
If you're unsure whether you'll need more than one account, selecting just the first address is fine - you can always get back to the Select an Account screen by going through the Add hardware wallet module again. When you've selected all the addresses you wish to use, click on Unlock.
And there you go, all set now! You should now see all the addresses you imported as separate accounts in MetaMask - all Lattice accounts should have a "Lattice1" tag next to them, like this:
You can now do everything you're used to doing with MetaMask: sending crypto, swaps, DeFi, minting NFTs, you name it. Everything that has to be signed with your private keys will now have to be approved on the screen of your Lattice1.
After you've successfully connected your Lattice to MetaMask, be sure to check out our Advanced MetaMask Setup guide where we've hand-picked the best features MetaMask has to offer - even though it has advanced in the name, it still covers things that are fairly basic, but it's always good to know them!