How to Recover Access to Your IRON FISH Wallet


Did you install a wallet from GitHub but find it not working? Have you recently reinstalled your OS or accidentally deleted your wallet? Or something unexpected happened that caused you to lose access to your wallet.

If so, don't worry — you can still regain access to your wallet if you've saved a backup of your wallet or a seed phrase, which is a secret combination of 24 words.

It's important to note that your money is not stored in the program but in your wallet address. Whoever owns the keys to that wallet address owns access to your wallet!

We'll guide you through transferring your wallet address to an official working wallet.

Installing the Official Wallet

In our article, we've covered installing the official IRON FISH wallet, so we will describe only some of the processes here. You can find detailed instructions in our article here: .

Just follow the instructions up to Step 4. You don't need to create a new wallet; you must import your wallet address.


  • You need to use version 18 of Node.js. Do not install version 20 or later; it won't work with the wallet.

  • If you see a window like the one below when you try to install Node.js 18, you already have this version installed. In that case, just run the command npm install -g ironfish and install the wallet.

Importing Your Keys and Wallet

  1. We recommend running the ironfish wallet:address command first. Sometimes, the wallet will find connections with your old wallet after installation, and you won't need to import anything. If you see your wallet address after running this command, congratulations! You can skip the next step and proceed to wallet synchronization.

  2. If you don't see your wallet address after running the ironfish wallet:address command, or if you see the wrong one, you'll need to import your wallet using the 24-word seed phrase you received when you first created your wallet. Run the ironfish wallet:import command to do so.

  3. The wallet will ask you to specify the backup path or enter your 24-word seed phrase. Follow the prompts and press Enter.

  4. The wallet will then ask you to choose an account name for your wallet.

    • If you entered an account name but received an error message like the one below, the wallet with the same name is already created. You'll need to create a different name for your wallet.

    • If you entered a new name but received an error message like the one below, your wallet already exists in the database, and you don't need to import it again.

    • If there was no wallet in the database with the same account name — you will see the message Account AccountName imported

  5. Use the imported wallet as the default wallet, using the command ironfish wallet:use AccountName

Checking The Wallet

Please execute the command ironfish wallet:address and verify that the displayed wallet address is correct.

  • If the displayed address is the one you were expecting, congratulations! Your key import was successful.

  • If the displayed address is NOT the desired address, please check the list of accounts to ensure you are using the correct one. You can run the command ironfish wallet:accounts to view all the accounts in your wallet.

  • To determine which account is currently selected as the default account, please run the command ironfish wallet:witch.

  • To choose a different default account and view its address, run ironfish wallet:use AccountName followed by ironfish wallet:address.

Synchronizing Your Wallet

Once you have imported the necessary wallet and ensured that it is set as the default and that the address is accurate, the wallet must be synchronized with the network. Follow these steps:

  1. Run the ironfish mainnet command and verify that the wallet is connected to the mainnet.

    • If you see a message similar to the screenshot, you are already in the mainnet.

    • If the wallet prompts you to switch to the mainnet, enter Y and confirm the transition.

  2. Run the ironfish start command and wait for the synchronization to reach 100%. It may take some time, and you may feel like the process is frozen, but it's not. Just be patient and wait for the synchronization to finish.

  3. When the synchronization is complete, a similar message will appear. Do not close this window!

  4. Without closing the first window, open a second PowerShell window and run the ironfish wallet:rescan command. This command will scan your wallet; you must wait until it reaches 100%. It may take some time.

  5. Once the scan is complete, your wallet is ready to use.

Check Your Balance

When the wallet synchronization and scanning are completed, you can check your wallet balance and make online transfers.

Please do not close the synchronization window, as it needs to be running while you are working with the wallet.

We recommend keeping the sync window open if you use your IronFish wallet frequently to avoid the long sync process each time.

  1. To check the wallet balance, run the command ironfish wallet:balanceThe balance will only be accurate when the wallet is fully synced.

  2. To send funds to another address, use the ironfish wallet:send command and enter the recipient's wallet address, transfer amount, and network fee. Choosing a lower network fee will result in a cheaper transfer but will take longer to complete.

  3. To send funds to another address with a memo (such as an exchange), use the ironfish wallet:send --memo command and enter the memo, recipient's address, and transaction fee.

  4. Learn how to mine directly to exchange in our article.

Possible Issues

If you encounter any synchronization errors or the command fails to execute, restart your PC and reset the database by following these steps:

  1. Open PowerShell as an administrator and run the following commands:
    • ironfish reset — resets the database (confirm reset when prompted).
    • npm install -g ironfish — wait for the execution to complete, which will update the wallet.
    • ironfish mainnet — transfers the wallet to the mainnet (confirm the transition when prompted)
    • ironfish start — starts the wallet (wait for it to startup and sync up to 100%)
  2. Without closing the first PowerShell window, open a second one and run the command: ironfish wallet:rescan — this will update the wallet data.
  3. Finally, run the command ironfish wallet:status to confirm that your wallet is ready!

Useful Commands for Working with the Iron Fish Wallet

  1. ironfish wallet:accounts — View all active accounts in the Iron Fish wallet.
  2. ironfish wallet:which — See which wallet is selected as the default main wallet.
  3. ironfish wallet:use — Select and assign a default wallet.
  4. ironfish wallet:address — View the wallet address.
  5. ironfish wallet:balance — Check your wallet balance. Please note that the balance will only be correct when the wallet is fully synced.
  6. ironfish wallet:export — Create a full wallet backup. For example, use the command ironfish wallet:export YourAccountName --path C:\Wallets\Wallet.txt.
  7. ironfish wallet:export --mnemonic — Get your wallet secret seed.
  8. ironfish wallet:import — Restore your wallet from backup or seed phrase.
  9. ironfish wallet:send — Transfer coins from your wallet to another address.
  10. ironfish wallet:send --memo — Transfer coins from your wallet to another address using the memo.

Ця стаття доступна іншими мовами: