Wallet User Migration Guide | Helium Documentation (2024)

This guide provides step-by-step instructions for Helium Wallet app, CLI Wallet, and Ledger Walletusers to migrate their wallets to the Solana blockchain.

Wallet migration is necessary to interact with your HNT, DC, MOBILE, IOT, and Hotspots on the Solanablockchain. You can find Hotspot NFTs in the NFT Collectibles section in the Wallet app after yourwallet is migrated. Token balances are visible on the account page. You can also create or importmultiple accounts to a maximum of 10 on the Helium Wallet app.

Existing HNT and MOBILE tokens in your wallets will remain unchanged by this migration.

Migration Utility​

You can migrate a wallet using the widget below by entering a Helium or Solana wallet address andclicking the "Seed Wallet" button. Wallets seeded/migrated will have 0.00139088 SOL deposited inthem

For Helium App Users​

Helium Hotspot app users must migrate to the Helium Wallet App following these steps.

To start, ensure your Helium Hotspot app is updated to at least version 5.0.0 or later and thatthe Helium Wallet app version is 2.0.8 or later.

For Helium Wallet App Users​

Some users may know the Helium Wallet app as the "New Wallet app" or "the black app."

To migrate to Solana, simply update your Helium Wallet app version to 2.0.8 or newer. That's it! TheHelium Wallet app is regularly upgraded with new features and it is recommended that the wallet isupgraded to the latest version.

If you have Hotspots in any account, they will appear as an NFT Collectible. All other tokens andtheir balances are automatically transferred to the Solana Blockchain under the same token name.

Your public Wallet address will change, but your private key and seed phrase (12 or 24-word) willremain the same.

For CLI Wallet Users​

To migrate a Helium CLI Wallet to Solana, you will need to perform the following steps:

1. Inflate/seed your Solana-mapped Helium Wallet on Solana
2. Export your private key from the Helium CLI Wallet
3. Import your private key to any of the Solana CLI Wallet, Helium Wallet App, orPhantom Wallet.

Inflate/seed Solana-mapped Helium Wallet on Solana​

To provide high-level context, during the migration window a chain variable will be issued to causethe Helium L1 to cease block production after which time a snapshot of the Helium Network state willbe taken and loaded onto Solana Mainnet via a data structure (e.g., Merkle Tree). As such, allaccount state on the Helium L1 - including that of your CLI wallet - will be available on SolanaMainnet after the migration window.

Given the usage of the Merkle Tree, however, you will need to "inflate" or "seed" your Solana-mappedHelium Wallet on Solana. To do so, there is a passive means provided by the Helium Wallet App,or an active means using theMigration Widget provided inthe documentation.

Regarding the passive means, you can simply export your Helium private key from the Helium CLIWallet and import the Helium private key into the Helium Wallet App in the manner described in steps2 and 3 below. Once the migration window is complete and the Helium Network state has been loadedonto Solana, you will be able to open the Helium Wallet app and behind the scenes, your Wallet willbe inflated on Solana. After that point, you can use the Helium Wallet app to send HNT or MOBILEtransactions on Solana Mainnet.

Regarding the active means, you can use theMigration Widget. With theMigration Widget, you need to provide your Helium or Solana-mapped Helium public key into theWidget, then click the Seed Wallet button. After doing so, your Solana-mapped Helium Wallet onSolana will be inflated.

Please note that the Widget as currently provided operates on the Solana Devnet environment butwill be changed to Solana Mainnet during the migration window.

Export private key from the Helium CLI Wallet​

Starting in Helium CLI Walletv1.7.11, updates were made to theexport command to facilitate exporting private keys in (1) password-encrypted QR code format forimport into the Helium Wallet App, (2) raw format for import into a Solana CLI Wallet, and (3) rawformat for import into a Phantom Wallet. For each situation, example Helium CLI Wallet commands areprovided below:

1. Export raw private key as password encrypted QR code for import into Helium Wallet App

helium-wallet export --output qr

After executing the command, you will first be asked to provide the password for your Wallet, thenwill be asked to provide, and confirm, a password to encrypt the QR code of your private key. Oncecomplete, the command will produce a QR code that can be scanned into the Helium Wallet app, asdescribed in further detail in step 3 below.

2. Export raw, Solana-compatible private key for import into Solana CLI wallet

helium-wallet -f helium_wallet.key export --output seed > solana_wallet.json

Here, helium_wallet.key corresponds to your private key used for your CLI Wallet. By default, thisis usually named wallet.key. The result of the command is then used to create a Solana privatekey, which we are naming solana_wallet.json.

3. Export raw, Solana-compatible private key for import into Phantom Wallet

helium-wallet export --output seed

In executing this command, the Solana-compatible private key will be printed stdout and will bedisplayed in your terminal / command line window.

Import private key on Helium Wallet app, Solana CLI Wallet, or Phantom Wallet​

Depending on how you exported your private key from the Helium CLI Wallet, you will either (1)import your private key into the Helium Wallet app, (2) import your private key into the Solana CLIWallet, or (3) import your private key into Phantom Wallet.

1. Import private key into the Helium Wallet app

If you exported your private key in password-encrypted QR code form, you import the private key intothe Helium Wallet app. In particular, on the Helium Wallet app, you will need to navigate to the CLIQR code reader found at Add New Account > Import > CLI and scan the encrypted private key producedvia the Helium CLI Wallet.

Please note that after scanning the QR code in the Helium Wallet app, you will need to enter thepassword provided via the Helium CLI Wallet used to encrypt the QR code export. This password may bedifferent than the one used to execute CLI wallet commands.

2. Import private key into Solana CLI Wallet

If you exported your private key in a Solana-compatible form for usage with the Solana CLI Wallet,you are all set as the produced json file (which we called solana_wallet.json) is a bonafideprivate key for usage in executing Solana CLI Wallet commands.

3. Import private key into Phantom Wallet

If you exported your private key for import into Phantom Wallet, you will open your Phantom browserextension, go to the settings menu, select your account, select "Add/Connect Wallet", select "ImportPrivate Key", and copy/pasting the full output from the Helium CLI Wallet command.

For Ledger Wallet Users​

Ledger users will need to update their Helium Ledger App to a version that's pending release. Thisupcoming version will use the Solana private key derivation path that moves all your tokens andbalances over to Solana.

Your public key will change on Solana, but the private key will remain the same.

The Ledger Migration document includes the utilities needed to updateyour Helium Ledger account.

Derivation Paths and your new Public Key​

The Helium Ledger App uses ED25519 keys, similar to Solana, but at a different derivation path.

This means that while seed phrases are the same, private keys are different on Solana.

To get around this, when you run the migration, the migration application will ask you to use theold derivation path to approve sending all of your Hotspots, tokens, etc. to the new derivationpath.