Using the Polkadot & Kusama Ledger Applications
If you need help using Ledger you can contact the Polkadot Support Team.
Because of required WebUSB support, Ledger wallets currently only work on Chromium-based browsers like Google Chrome.
The Polkadot Ledger application is compatible with the Ledger Nano S and the Ledger Nano X devices. Ledger devices are hardware wallets that keep your secret key secured on a physical device that does not expose it to your computer or the internet. The private keys will not be leaked even if you connect your nano via USB to your computer. Ledger devices are also hierarchical deterministic wallets (HD wallets), that is:
- Deterministic means that only one seed phrase generates all the accounts for different blockchain networks.
- Hierarchical means that the accounts are generated in a tree-like structure for different purposes.
Ledger devices can be equipped with applications that are blockchain-specific. Third parties usually develop such applications, enabling the user to transact securely on the blockchain network. The Polkadot Ledger application allows you to manage Polkadot's native token, DOT. It supports most of the transaction types of the network, including batch transactions from the Utility pallet.
Check the
Ledger Polkadot App
specification for the list of transactions supported. Some transactions are supported only on a
specific app version, and others are not supported by any version. For instance, the staking rebag
extrinsic is supported on the XL version but not on the lite version. Also, joining a
nomination pool is only possible with the XL version.
If you have trouble using Ledger or following the directions below, you can try searching for your issue on the Polkadot support pages.
Requirementsโ
The lite version of the Polkadot Ledger App that you can install by default in the Ledger Nano S has limited functionality. The Ledger Nano S is no longer produced and has limited memory that is just right to accommodate the XL version of the Polkadot Ledger App, which gives the user more functionalities.
If you do use a Nano S with the XL version you will not be able to:
- Install any other Ledger application on your device
- Add Polkadot accounts to the Ledger Live App, but you will be able to add them to treasury-funded wallets who support ledger devices or to the browser extension and the Polkadot-JS UI.
Here is a list of what you will need before using Polkadot with Ledger:
- A Ledger Nano X or Nano S plus (recommended for Polkadot Ledger App space requirements and functionalities).
- The latest firmware of the Polkadot Ledger App installed (always check for updates in Ledger Live under the "Manager" tab, you will need to allow access with your nano).
- Ledger Live is installed and at version 2.1 or newer (see settings -> about to find out if you're up to date).
- A Chromium-based web browser is installed that you can use to access the Polkadot-JS UI.
Using Ledger Liveโ
Check this support article to learn how to use Polkadot with ledger live.
Ledger Live will only show the main account with BIP44 path 44'/354'/0'/0'/0'. This means that if you import a derived account using Polkadot-JS with a derivation path 44'/354'/0'/0'/1', it will not be displayed on the Ledger Live App. Consequently, it is not possible to transact with derived accounts using the Ledger Live App, but it is possible to do so using Polkadot-JS. Check the accounts page for more information about derived accounts and derivation paths.
Using on Polkadot-JS Appsโ
Loading Your Accountโ
Ledger Live should be off while using Ledger with Polkadot-JS UI as it can interfere with normal operation.
You can import your Ledger account to Polkadot Extension or to the Polkadot-JS UI. For instructions on how to import Ledger accounts to the Polkadot Extension read through this support article, while if you want to import Ledger accounts to the Polkadot-JS UI you can consult this other article.
Derivation pathsโ
When adding a Ledger account using the extension or the UI, you will be asked to select an
account type
and an account index
. The first lets you select an account, while the second lets
you pick a derivation path from that account - think of it like a formula from which child accounts
are generated. When you are creating a
Polkadot ledger account for the first time on
Ledger Live with name Polkadot 1
, this
can be added to Polkadot-JS using the 0/0 derivation path (i.e. account type = 0 and account index =
0). If you add a second account called
Polkadot 2
, this will correspond to the
1/0 derivation path, and so on. We thus have multiple parent accounts that can be viewed and used in
both Ledger Live and Polkadot-JS. Additionally, we can use Polkadot-JS UI to create multiple
children accounts from each parent account. For example,
Polkadot 1
with 0/0 derivation path can
have child 0/1, 0/2, etc. that can be used within the UI. However, such children accounts cannot be
used in Ledger Live, as it only scans through the parent accounts. So, remember that the balances on
the children accounts cannot be viewed, and you will not be able to transact with those accounts on
Ledger Live.
Connecting your ledger deviceโ
While using a ledger device to sign transactions, depending on your browser and its security settings, you might need to confirm the USB connection through a popup like the one below:
If you are adding your Ledger Nano for the first time, click on the "Unknown device" line and the "Connect" button will become available.
If you have already connected your device, but an error message appears before signing a transaction, make sure you have opened the Polkadot application on your Ledger Nano device. Visit this support page for more information about signing transactions using your ledger.
Confirming the Address on your Deviceโ
To display your Polkadot ledger account address on your Ledger Nano, you can follow the guidelines on this support article. Here you can scroll through and make sure the address matches what is displayed on Polkadot-JS UI.
Checking the Balance of Your Accountโ
There are a few methods to check the balance of your account. Check out this support article for information.
Sending a Transferโ
General instructions to send a transfer can be found on this support page. To sign transactions with your Ledger nano check this support article.
Receiving a Transferโ
To receive a transfer on the accounts stored on your Ledger device, you must provide the sender (i.e. the payer) with your address. To do so, follow the instructions on this support page.
Before giving anyone your address, ensure it matches what's on the Ledger by confirming the address on your device. Some malware will intercept clicks and clipboard requests and can change your copied value in-flight, so being extra vigilant around copy-paste operations makes sense.
Stakingโ
For staking using Ledger devices, check the section "How to stake using your Ledger" on this support article.
Removing Expired Democracy Locksโ
Check out this support page the learn how to remove democracy locks after the end of a Governance referendum.
Please be advised: Despite the Polkadot ledger application being compatible with both the Ledger Nano S and the Ledger Nano X, none of the Democracy extrinsics are available in the light version. The following repository by Zondax lists the currently supported Democracy extrinsics on the full ledger.
Ledger Developer Releaseโ
This section is for developers only. It is recommended to install the application from Ledger Live unless you know precisely what you're doing.
Why you might need the Developer Releaseโ
Ledger apps for the Polkadot ecosystem are developed by Zondax. When new functionalities are added to the Ledger apps, they are made available on a developer release for testing purposes. After a successful audit and review, the apps would be available for download and installation using Ledger Live. As it takes some time for Ledger to audit and review the release, the app upgrade option may not be available on Ledger Live when the new runtime is deployed on the network. If this happens, users cannot use Ledger devices with the Polkadot-JS UI, and while signing for a transaction, will most likely incur the error message "txn version not supported". Please do not panic if this happens, as there are solutions to this problem. Suppose you cannot wait a few days until the app passes the Ledger audit, you can install the developer release from the shell using the latest version published on the Zondax GitHub repository.
Install the Developer Releaseโ
See this video tutorial to learn how to install the developer release of your ledger app.
Currently, the developer release can be installed only on the Nano S and S plus devices and can't be installed on the Nano X.
To install the developer version, make sure you have the latest pip
version and follow the steps
below:
- Install ledgerblue running the command
python3 -m pip install ledgerblue
. - Download the developer release from the
Zondax GitHub repository. The file will be
named
installer_nanos_plus.sh
or something similar, depending on your ledger device. - Locate the downloaded shell script and make it executable in your shell by typing the command
chmod +x installer_nanos_plus.sh
. - You can now use the
./installer_nanos_plus.sh --help
command to visualize the available options (see below)
- Attach your Ledger Nano (in this case Nano S Plus) to your computer, enter the PIN code, and run
the command
./installer_nanos_plus.sh load
. Scroll with the right button until you see "Allow unsafe manager", left and right press to confirm. You will be asked to confirm the action of uninstalling the app and subsequently installing the newer version. After confirming both actions, the shell script will install the version on your device. You must insert the PIN code to use the device after the installation. - If you wish to revert the version to the stable release, go to Ledger Live. The app will automatically detect the developer release and give the option to install the previous stable release.