Firefly Ledger user guide
Firefly is available on Windows, Mac and Linux and supports Ledger Nano X and Ledger Nano S via USB connection. The Ledger Nano integration is straightforward and similar to using Firefly with a non-Ledger profile. This guide serves as an additional resource to help you understand how you can use your ledger to secure your tokens with Firefly and what you need to be aware of when you perform certain actions while using the wallet.
What is a Ledger Nano?
Ledger Nano is a hardware device that connects to your computer via USB (other models are available with bluetooth support but this is not currently supported in Firefly). When you set up your Ledger Nano, you are instructed to safely store a recovery phrase. This recovery phrase is used by the device to sign transactions and generate addresses. It is not possible to extract the recovery phrase (or private keys generated from it) from the Ledger device. So it is important to store your recovery phrase safely. The hardware device creates a boundary between your computer and the private keys needed to access your funds. It provides a level of security that is simply not possible with software alone.
Before you start, make sure
- You have initialized your Ledger device.
- Ledger Live is installed and ready to use.
- The latest firmware is installed.
- You have installed the latest version of Firefly
Install the Shimmer app on your ledger device
- Open the Manager tab in Ledger Live.
- Connect and unlock your Ledger device.
- Follow the onscreen instructions and allow Ledger Manager.
- Find and install Shimmer in the app catalog.
Creating a new Ledger profile
Creating a new Ledger profile in Firefly is quick and simple. Once you have downloaded Firefly, open the app and follow the setup instructions. You first need to review and accept the terms and conditions, set a theme (dark or light), then select "Create a new Shimmer profile".
Press "Create a hardware profile" to begin the Ledger profile setup process.
Choose a profile name. On the next page, you will be asked to set a PIN code. This PIN is used to log in to your wallet and blocks other people from logging in and viewing your balance transaction history. Choose a PIN that only you know and re-enter your PIN to confirm.
Now, Firefly will check that your Ledger Nano is connected. Make sure the Shimmer app is open on your device and that Ledger Live is closed. If you have connection problems follow the "Tips if your Ledger isn't connecting" guide in Firefly.
Hit "Finish Setup" and just wait for the dashboard to load. That's all there is to it. It really is that simple. You can now enter the dashboard and begin exploring Firefly.
If you would like to receive funds to your new Ledger profile just click within the "Receive funds" button on the dashboard. Firefly will then copy the address to the clipboard.
You can now share it with a friend or an exchange from which you wish to receive tokens.
Once you have received tokens to an address, your balance will update and you will be able to view the transaction in the transaction history. To send these tokens, press the "Send funds" button from the dashboard. Here you can fill in the address you want to send to, enter an amount, and hit "Send". Review your transaction details and then hit "Confirm".
You will then need to confirm that the full transaction details match what is displayed on your Ledger device. Confirm the details match by pressing both buttons when your Ledger reads "Accept". If they do not match press "Deny".
Note: This is a security check to ensure that you are connected to the official, secure version of Firefly. It ensures that no malicious software can alter the contents of your transaction and ensures you are sending the right amount to the correct address.
Creating wallets and sending internal transfers
Firefly makes it possible to organize your tokens into different wallets within your profile. These tokens are kept separate from one another. Technically speaking, they are stored on addresses generated on different sub-accounts on your Ledger. To add a new wallet to your profile, navigate to the wallet summary view and press "Add a wallet". Choose a name for your new wallet and press "Create".
Note: Your Ledger device must be unlocked and the Shimmer app must be opened in order to generate an address for the new wallet.
With multiple wallets, you can then send between them and split your tokens up to organize them however you like. In the "Send funds" view you can now automatically choose other wallets on your profile to send to.
Restoring an existing Ledger profile
If you need to restore an existing Firefly profile with a new device, or you somehow lose access to Firefly, you can plug in your Ledger and restore an existing profile in a few simple steps. To do so, select "Restore Shimmer profile" in setup and then "Use Ledger device".
Note: Backups of your transaction history for Ledger Nano users are not currently supported but will be added in a later version. Once a profile is restored, Firefly will sync your transaction history. It will always find your balance. In a future version, we will add support for retrieving your full transaction history from a node that stores the complete history of the Shimmer Tangle.
Adding a second Ledger device to Firefly
It is possible to have more than one Ledger device with the same Firefly app. You can add another device by creating an additional profile from the login page. Firefly will always check that the right device is connected and you will receive an error message if you try to generate an address or send a transaction with the wrong device.