Import from Ledger

As of 2024 July 1st, the Polkadot Generic Ledger App is live and is the recommended app to use on Polkadot-SDK networks that support it. Previous ledger apps will be refered to as "Legacy Ledger Apps" in this document.

Polkadot Ledger App

Polkadot Ledger App accounts can be used on all Polkadot-SDK networks, they can sign any type of transaction and do not require frequent app updates. This is why it is often refered to as the Polkadot Generic App.

Polkadot Ledger App accounts can be used on all Polkadot-SDK based networks that performed the CheckMetadataHash runtime upgrade. The upgrade will be rolled out to all networks progressively. This real-time dashboard indicates the status for each network: Parachains Metadata dashboard

Before connecting your Polkadot Ledger account in Talisman, ensure that your device has the latest version of the Polkadot Ledger app, which can be installed from Ledger Live.

  1. To connect your Polkadot Ledger accounts, click the Add account button from the navigation menu, then click the Connect button (on the top right), then Connect Ledger like shown below:

  1. Select Polkadot, then Polkadot App. Talisman will then try connect to your device, make sure it's connected via USB, and that the Polkadot Ledger App is running

  1. Once connection is successfull, click the Continue button

  1. The next screen will display the accounts that are available in the Ledger device. Select the ones that you want to connect to Talisman by checking the checkbox, then click Continue

That's it! you may now use your Polkadot Ledger account with Talisman.

Polkadot Migration Ledger App

As of July 1, 2024, legacy Ledger apps other than the Polkadot App will be progressively deprecated, and only the Polkadot App will be intended for use. The Polkadot Migration Ledger App will help users recover funds that were previously stored in network-specific legacy Ledger apps as they become deprecated.

The Polkadot Migration App can be used to recover funds on networks that have updated their runtime with the CheckMetadataHash. It will be rolled out to all networks progressively. This real-time dashboard indicates the status for each network: Parachains Metadata dashboard

For example if you previously connected an account from the Kusama Ledger App, you should do the following:

  • Install the Polkadot Migration Ledger App on your device from Ledger live.

  • Remove the existing Kusama Ledger account(s) from Talisman.

  • Reconnect these same account(s) to Talisman, by selecting the Migration App option.

  • Transfer the tokens from these accounts to your Polkadot Ledger Account.

  • Remove the migration accounts permanently.

To connect accounts from the Polkadot Migration Ledger App, follow the same steps as for the Polkadot Generic Ledger App, but when selecting the app (step 2), select Migration App instead. You will also need to select the network from which you wish to recover funds. It is important to select the correct network because legacy Ledger apps used different accounts for each network.

After transferring all funds from the migration account(s) to your Polkadot Ledger account, it is recommended to uninstall the Polkadot Migration App from your Ledger device and remove the migration account(s) from Talisman.

Legacy Ledger Apps

As of July 1, 2024, legacy Ledger apps (network-specific) will be progressively deprecated in favor of the generic, multi-chain Polkadot App. Legacy Ledger apps will only work on networks that have not yet upgraded their runtime with CheckMetadataHash. See the Parachains Metadata dashboard for details.

In order to import your Ledger accounts into your Talisman Wallet you have to make sure that you are using the latest Ledger app for the chain you want to use. So to import your Kusama Ledger account you need to have the latest Kusama Ledger app as well as the latest Ledger firmware installed in order for the whole process to work. In case you have trouble you can also check Ledger's official guide on how to connect your Ledger.

Even when you import your Ledger Account into your Talisman Wallet the private key never leaves your Ledger. Talisman only broadcasts your transactions to your Ledger and lets you keep track of your assets. Everything stays safe.

  1. To start importing your Ledger account you need to go to the Talisman Settings and choose Import from Ledger.

2. Chose the ecosystem (Substrate or Ethereum) of the account you want to import.

3. Chose the chain for which you want to import the accounts. Right now only Kusama and Polkadot are supported by Talisman.

4. Now a chrome-ui popup should display and ask for a device that you want to connect. Chose your Ledger and confirm by clicking Connect. Make sure that theLedger App open and the Ledger is unlocked.

5. Talisman approves the successfull connection and you can proceed with Continue

6. Now that your ledger is connected and Talisman has been granted access you can decide on which accounts you want to import. Keep in mind that Load next shows the next account that is derived from the root account. The accounts all share the same underlying seed phrase and shouldn't be thought of as isolated from each other. Tick all the checkboxes for the accounts you want to import and click Continue.

7. The import is complete and you can now select the freshly imported accounts via the dropdown menu. They are specially tagged as a Ledger account with the yellow USB sign to remind you that these accounts are from external devices. The chain these accounts support is marked in the account image with the respective logo.

v 1.1

Last updated