Ledger Hardware Wallet
The Helium tokens have support for Ledger Hardware Wallets via the Solana blockchain. Ledger allows for:
- Viewing account address(es) and balances
- Transferring tokens
- Signing transactions
At this time, Hotspot management actions such as onboarding or asserting location are not supported. You will need to perform these actions within the Helium Wallet App.
Helium HNT, MOBILE and IOT are Solana SPL tokens and are supported by the Solana App for Ledger but not directly in Ledger Live.
Installation instructions for the Solana App are on Ledger Solana support page. Remember to configure blind signing.
Basic Setup Guide Using Helium Black Wallet App and Ledger
-
Turn on Ledger by pressing left button
-
Using on screen Guide to Setup as new device
-
Set the access PIN for the ledger
-
Record the 24 word recovery phrase (don't share this, store in safe place)
-
Install desktop version of Ledger Live App
-
Connect Ledger to your computer with USB cable
-
Open Ledger Live Desktop App
-
Click on "My Ledger" at the bottom of the left menu stack
-
Approve the connection on Ledger device by clicking both buttons
-
Look for banner at the top of the desktop Ledger Live window for FW update notification
-
Approve updates on the ledger device as needed
importantIt may take multiple serial updates to get your Ledger up to date.
-
In desktop Ledger Live window go to settings -> Developer Mode -> Enable
-
In desktop Ledger Live window, find Solana App and click install
-
On Ledger Device start Solana app by clicking both buttons
-
On Ledger Device navigate to Settings in Solana App and enable "Allow Blind Signing"
-
Open Helium Black Wallet App on smartphone
-
In Black Wallet App navigate to Add/Import Wallet
-
In Black Wallet App select Ledger from the options at the top
-
In Black Wallet App select your Ledger device from the list (should be only one in most cases)
-
In Black Wallet App select wallet to import (if more than one, import all for now)
-
On Ledger Device approve the wallet import
-
On Black Wallet App, you should now see your Helium friendly wallet with zero balance.
-
On Black Wallet App, tap the pub key / address above the wallet balance to copy your pub key to clipboard
-
Save your wallet pubkey somewhere handy, this is destination for transfers into your cold wallet.
Testing your Ledger Cold Wallet
Before making any significant transfers into your new Ledger wallet, it is best to make a series of test transfers in and out of your wallet.
-
Open the Helium Black Wallet App on your smartphone
-
Navigate to your Ledger Wallet from steps above
-
Copy the pub key of your Ledger Wallet
-
Make a test transfer of SOL into your new Ledger Wallet
tipTransfers out of your wallet will require SOL to pay fees, so start by adding at little SOL e.g. 0.1 SOL to your wallet.
-
Copy the pub key of an external wallet (either Coinbase or other Black Wallet App native wallet)
-
Make a test transfer of SOL out of your new Ledger Wallet
noteThis will require your Ledger to be PIN unlocked and Solana App started and "ready" to complete
-
Review and Approve the transaction on your Ledger Device when prompted
-
Repeat the Process with HNT or IOT again with small amounts
-
After your have tested transfers in and out of your Ledger wallet, you are ready for safe cold storage using your Ledger Wallet.
Using Third Party Wallet Apps
Users may alternatively use Solflare or Phantom to access SOL/SPL tokens with Ledger.
Solflare, Phantom and other non-custodial wallets can import the private key from the Helium Wallet App. Follow the instructions on our using Third Party Wallets documentation.
Ledger Helium L1 to Solana Migration
If you have an unmigrated Ledger wallet that existed on the Helium L1 prior to the migration to Solana on April 18th, 2023, you will need to follow these instructions.
Video Walkthrough
Installing the Helium-Solana App
Update your Ledger firmware to at least 2.1.0, perferably 2.4.x before you start.
As of now, we are still waiting on Ledger to release our app. Until then, to install you must follow these steps:
- Open Ledger Live.
- Go to Settings (top right corner)
- Click
Experimental Features
- Enable
Developer Mode
- Install the Helium-Solana Ledger App as you normally would.
- Close Ledger Live
Migrating
The following utility will migrate all tokens from the Helium derivation path 44'/904'/n'/0'
to
the Solana derivation path 44'/501'/n'/0'
.
Ledger users will need to update their Helium Ledger App to a version that's pending release. This upcoming version will use the Solana private key derivation path that moves all your tokens and balances over to Solana. You may need to uninstall any Solana Ledger Apps during the Wallet migration process.
Migration Tool
Your public key will change on Solana, but the private key will remain the same. Note this app only works with Chrome, Brave, or other Chromium-based web browsers.
- Helium-Solana Ledger App now available from Ledger Live (ensure Developer Mode is enabled)
- Solana Ledger App using Ledger Live
Before starting these steps, close the Ledger Live application or the transactions will fail.
Open the Solana App on your ledger. Be sure to enable blind signing in the Ledger Settings. Select the account number you would like to migrate. Then click the button below.
Derivation Paths and your new Public Key
The Helium Ledger App uses ED25519
keys, similarly to Solana, but at a different derivation path.
This means that, while seed phrases are the same, private keys are different on Solana.
In order to get around this, when you run the migration, the migration application will ask you to use the old derivation path to approve sending all of your Hotspots, tokens, etc. to the new derivation path.
More information on Derivation paths: Derivation Paths Explained a Youtube video from solandy.sol