The new Firefly IOTA version compatible with the Stardust network upgrade has been released, introducing new features like native tokens and NFTs. Try it out here.
Frequently asked questions and helpful troubleshooting information for users of the Firefly wallet.
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?
IOTA 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 us on our Discord.
Which Ledger hardware do you support?
The IOTA app is supported on Ledger Nano S/X via a USB connection. Additionally, the IOTA legacy app, which would be needed for a network migration process from the deprecated legacy network, works with Ledger Blue. Since official support is no longer provided for the Blue by Ledger, Blue can only be used for migrating funds.
Do I need to install the Ledger app on my computer? Where do I download this?
You can install both the new and legacy applications by downloading and installing Ledger Live. After ensuring your firmware is up-to-date, both IOTA apps 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 legacy and the new applications may not be visible in Ledger Live without the current firmware. Make sure you have the latest versions of both apps 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 IOTA 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.
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.
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 IOTA 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.
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 IOTA!
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" IOTA tokens in their wallet. The wallet controls the private keys.
A private key is like a secret passcode needed to transfer ownership of IOTA 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, IOTA tokens are, at their root, numbers: amounts assigned to IOTA addresses. For every private key, there are one or more public keys (which are translated into IOTA addresses).
The private key belonging to that corresponding public key is the secret code needed to "spend" IOTA 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.
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.
What is a deep link, and how do I use it?
Deep links automatically fill transaction data in Firefly when you click on an
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.
How can I migrate my funds from the legacy network to the Stardust network?
To migrate your funds you will need to use the IOTA Legacy Migration Tool. This application is specifically designed to assist users in transferring their funds from the IOTA Legacy network to the IOTA Stardust network. Read more about the IOTA Legacy Migration Tool.
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.
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.
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 IOTAs directly in Firefly?
You cannot buy IOTAs directly in Firefly at this time. You can visit the IOTA website for more information about buying IOTA from an exchange.
Why won't Firefly connect with my Ledger? Also, My IOTA 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.
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.
Manage your IOTA assets directly from your computer with both software and hardware wallet support. Earn staking rewards and participate in governance votes.
Try out new features introduced with Shimmer, such as minting native tokens, setting transaction expiry times, and sending microtransactions.