Firefly FAQ

Official website | User guide | Ledger user guide | Github

Setup and installation

I'm worried I might make a mistake when setting up Firefly.

Don't worry! All you need to do is download Firefly only from the official website for your preferred OS and start the setup. The application has been designed to guide you through setting up your profile, securing it, and migrating your tokens successfully.

How do I back up my seed?

Shimmer Firefly now uses a 24-word mnemonic or a recovery phrase. Like with other cryptocurrencies, all you will need are 24 words to recover access to your tokens on the Tangle. You will be able to back up your recovery phrase using the recovery kit you create when you set up your wallet. You will have captured the 24-word recovery phrase in a safe location by saving a so-called stronghold file and writing the 24 words down.

This physical paper backup is recommended as computers can fail.

Hardware wallets such as the Ledger Nano X and S are also supported. In case you use a Ledger Nano device, all relevant security measures are taken by using your ledger device together with the Firefly Wallet. Ledger Seeds are only stored on the Ledger device and never revealed to you.

What is Stronghold?

Stronghold is a secure software implementation developed by the IOTA Foundation with the sole purpose of isolating digital secrets from exposure to hackers and accidental leaks. It uses versioned, file-based backups (with the file extension .stronghold) with double encryption that can be easily backed up and securely shared between devices. You can read more about Stronghold here!

I have lost access to my device. How do I recover my wallet?

There are several ways to recover your wallet, and both can be found in the backups you performed in the wallet setup. One way would be using your 24-word recovery phrase, while the other would be using the Stronghold file you backed up.

Do you plan to support Trezor or other hardware wallets?

We do not currently have any plans to support Trezor, but if a community member would like to work on the integration, please get in touch with Charlie#0123 on our Discord.

Which Ledger hardware do you support?

The Shimmer app is supported on Ledger Nano S/X via a USB connection.

Do I need to install the Ledger app on my computer? Where do I download this?

You can install the new Shimmer applications by downloading and installing Ledger Live. After ensuring your firmware is up-to-date, the Shimmer app can be installed to your Ledger device directly from Ledger Live in the Manager tab.

I don't have my original Ledger USB cable anymore. Will this be a problem?

Most Micro-USB (for Nano S) and USB-C (for Nano X) cables should work. We do recommend using the original cable, though.

Do I need to update my Ledger firmware before using it with Firefly?

Yes, the new application may not be visible in Ledger Live without the current firmware. Make sure you have the latest version of the app on your device.

I don't have the original Ledger device that I used when I first set up Firefly. Will this be a problem?

The 24 words mnemonic (also known as the recovery phrase) and your Firefly account index (default 0) are all you need to regain access to your tokens on the Shimmer Tangle. The tokens are in no way connected to the hardware itself. You can set up a new device with the same recovery phrase to access your tokens.

I have run out of space to install more applications on the Ledger. What should I do?

If you're short on space, you may need to remove other cryptocurrency applications from your Ledger device temporarily. This will have no impact on the related cryptocurrencies. After reinstalling the apps, they will be available again. You should refer to the official Ledger support site if you need more help.

Backups and recovery

I have the seed words (recovery phrase) but don't remember the password; what can I do?

The recovery phrase works without a password or PIN. Just input the words at the wallet set up, using the I have a text backup option.

Why should I do regular Stronghold backups?

Performing regular Stronghold backups will allow you to keep convenient, up-to-date digital backups should something happen, where you would then have a complete recovery of your funds.

What is an internal transfer? Is it different from a standard transaction?

An internal transfer is the same as a standard transaction. It is just made between your own wallets; it is also handled entirely on the Tangle. It is easier to perform because you don't need to input the address.

I have forgotten my device pin. How do I recover my Ledger?

Should you forget the Ledger PIN, you can reset and restore the Ledger using the 24-word recovery phrase.

How do I backup my Ledger transaction history?

Backups of your transaction history for Ledger Nano users are not currently supported but will be added in a later version. Firefly will sync your available transaction history when a Ledger profile is restored. It may not find all transactions, but 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 IOTA Tangle.

Are the 24 words previously found in the Ledger and are now in Firefly for the same seed?

The 24 words mnemonic, also known as the recovery passphrase, work in Firefly as both reflect the BIP39 standard. Never enter your recovery phrase anywhere other than your Ledger is strongly recommended. This defeats the security benefits of having a Ledger.

Can I save a Stronghold backup in Firefly for a Ledger Profile? If yes, does this contain my Ledger Seed?

Strongholds are not used for Ledger profiles in Firefly.

Can I put my 24 words from the Ledger into Firefly to see/use my funds with Firefly?

You can, but it is not recommended because it circumvents the hardware wallet security model entirely and is therefore strongly advised against it!

Profiles and wallets

What are profiles in Firefly?

Profiles in Firefly are representations of your Shimmer seed and contain all of your balances on different wallets. They also include general information such as your language and currency preferences and system notifications.

What are wallets in Firefly?

Wallets in Firefly are like a bank account and a personalized stock portfolio all in one. And in that sense, wallets always belong to a specific profile of your Firefly application. You can view your wallet balance and transactions, send and receive funds instantly, measure your wallet and token value over time, and check your wallet activity by month.

Can I change profile names after I create the profile?

No, you cannot change a profile name after creating a profile just yet. But you can add a profile with your preferred name and populate it near-instantly with your preferred wallet(s), security, and other such information.

Can I change wallet names after I create the account?

Yes. You can change your wallet name by clicking on the ellipses (three dots in a row) next to your wallet balance, giving you the Customise wallet option. There, you can change the name of the wallet you are currently in.

What is resync wallet? Why do I need it, and what happens when I resync my wallet?

Resyncing your wallet starts a background task that makes sure all of your wallets are up to date; you would need it to ensure your wallet is correct so you can conduct the everyday functions of Firefly without issues.

I want to delete a wallet; what happens to the funds in that wallet?

Wallets can only be deleted after your funds have been moved out of your wallet. So, you would need to send your funds from that wallet to another address.

However, an empty 0 balance profile can be deleted.

I want to delete a profile; what happens to the funds in that profile?

If you want to delete a profile, it is recommended that you first transfer your funds to a different profile. You need to make sure you have a backup for all of your wallets. If you delete a profile without a backup or recovery phrase, you will lose access to your Shimmer!

Why do I need to confirm the receiving address against one displayed on my Ledger device?

This function is in place to confirm that the receiving address hasn't been manipulated by malicious software or by a man-in-the-middle attack. Make sure you always double-check it matches what is displayed on your device.

Can I have a Ledger wallet under my standard Firefly profile, or do I need to set up an entirely new profile for Ledger?

Every seed and Ledger has its own profile in Firefly. You need to create a new Firefly profile for every Ledger device you own.

How can I easily switch from one profile to another? Do I need to sign out each time?

It is possible to change profiles. And yes, it is necessary to log out from one profile and log in to another with your PIN.

Is it a bad idea to use the same PIN for Firefly as I do for my Ledger device?

Yes! As with websites, where security experts generally recommend that you use strong and unique passwords for each of your accounts, it is recommended to use unique PINs for Firefly and the Ledger device.

Where are my tokens located exactly if they are not on my Ledger device nor on my computer?

Since the Tangle is a distributed ledger, no one actually "holds" Shimmer tokens in their wallet. The wallet controls the private keys.

A private key is like a secret passcode needed to transfer ownership of Shimmer tokens on the Tangle. The private keys give the power to alter the Tangle record by authorizing an ownership transfer from one address to another. That transaction gets recorded in the Tangle.

To go deeper, Shimmer tokens are, at their root, numbers: amounts assigned to Shimmer addresses. For every private key, there are one or more public keys (which are translated into Shimmer addresses).

The private key belonging to that corresponding public key is the secret code needed to "spend" Shimmer tokens.

You can think of the Firefly wallet as a password manager. Password managers store and secure the secret passwords you need to access websites, rather than the content of the websites themselves.

In this way, your Firefly wallet is essentially a key manager!

Your private keys are stored on the Ledger device for and can never be extracted.

Transactions

Can I use my own node to process my transaction?

Yes. You can use your own node to process your transaction if it is accessible over HTTPS.

I accidentally sent funds to the wrong address. Can I get them back?

There is no way to recover funds accidentally sent to the wrong address.

How can I send data transactions with Firefly?

You cannot send data transactions with Firefly at this point in time.

Where can I see my transaction history?

Your transaction history is broken down within your wallets. When you select Wallets from your dashboard, you will see a column with all of the transactions you made within the respective wallet.

Additionally, there is an extra function, wallet history, found in the ellipses (three dots) next to the wallet balance of your wallet page.

How do I find a specific transaction that I did send/receive; I only know the day when it happened. Is there a search function?

There is no search function in Firefly.

What is a deep link, and how do I use it?

Deep links automatically fill transaction data in Firefly when you click on an shimmer:// link.

Can I have a fixed receive address?

Yes, you can have a fixed receive address. Simply copy an address from Firefly and store it somewhere. You can safely receive to an address as much as you like, but it is recommended to use new addresses for better privacy.

Why do I need to confirm my transaction on the Ledger device against the one displayed in Firefly?

The Ledger Nano S/X shows you the transaction details before asking you to confirm. It then signs the transaction.

The addresses and values must exactly match those displayed by Firefly. This is to prevent man-in-the-middle attacks.

You should thoroughly verify them before confirming the transaction.

Settings

Where can I change my PIN and password?

You can change both your PIN and password under Security found in the settings of your dashboard.

Can I reuse an address? I know that this was always a problem in Trinity.

You can reuse an address in Firefly due to the EdDSA reusable address format.

Can I create NFTs or other digital assets in Firefly?

You cannot create NFTs or other digital assets in Firefly at this time.

Troubleshooting

How do I recover a PIN code?

If you have lost your PIN, you need to create the profile again from a backup (recovery phrase or a Stronghold file) to re-access the profile. Later, you will create a new profile with a new PIN.

I have my backup file but don't remember the password. How can I recover my funds?

Without the password, you will not be able to recover your funds using the backup file. It is possible to access your funds using the recovery phrase and to set up a new profile in Firefly. However, your Firefly settings and history are lost by doing so.

I received an error: what can I do?

You can report to this GitHub page for any issues or errors: https://github.com/iotaledger/firefly/issues.

I received an error: client error: { }. What does it mean, and what can I do?

You can report to this GitHub page with any issues or errors: https://github.com/iotaledger/firefly/issues.

I received the operation timed out error message. What does it mean, and how can I solve it?

You can report any issues or errors to this GitHub page: https://github.com/iotaledger/firefly/issues.

For those with more than one seed, can we replicate this process with every seed we have? Or do we need to transfer all tokens to one seed to migrate to the new network?

You can import multiple seeds in Firefly. But this process must be replicated for every seed you own. Each seed will be imported into a new profile.

Can I buy Shimmer directly in Firefly?

You cannot buy Shimmer directly in Firefly at this time. You can visit the Shimmer website for more information about buying Shimmer from an exchange.

Why won't Firefly connect with my Ledger? Also, My Shimmer application always closes after a couple of seconds after opening it. Why is this?

If your Ledger is already connected and unlocked, ensure that you have closed the official Ledger Live application or browser plug-ins that might use the Ledger (e.g. MetaMask). Then make sure Ledger Live is not running silently in the background. Firefly cannot communicate with Ledger hardware if the Ledger Live software is open simultaneously. Firefly also provides a guide during setup to help with connection issues, and you can read the official Ledger guide here.

Finding balances keeps stalling. Why is this?

If your Ledger device does not show Generating address… while finding balances, then try disconnecting and reconnecting the device in rare cases where you used an old version of the legacy app. You may need to uninstall and reinstall the legacy app. Return to Ledger Live, reinstall this application on your Ledger device and try again.

Why does my balance keep showing zero?

Firstly, you can try Check Again to search for more addresses with balance.

If your balance continues to display 0, you may have selected the wrong account index number. The default account index number is 0, but it is possible to change this from 0-2147483647. If this was changed during your Trinity Ledger setup, you might wish to try alternative account indexes to reveal your funds.

What happens if my computer falls asleep or restarts during the migration process?

First, check if the migration is still in progress. If it is, then it should be complete on its own. Alternatively, you can check if you have a profile for that migration as it may have already been completed. If there are no profiles associated with the migration, you can simply create a new profile to start the migration again. If there is a profile, but the full set of migration transactions are not there, go to Advanced Settings and select Migrate Another Index. You can continue where you left off by choosing the same account index and searching for more balance.