Ledger Hardware Wallet

Both the Namada Keychain browser extension and the Namada CLI are compatible with the Ledger (opens in a new tab) hardware wallet. This guide will walk you through the process of setting up your Ledger device to work with Namada.

Prerequisites

You will need a Ledger device with the latest firmware installed. You can find instructions on how to update your firmware here (opens in a new tab).

In order to use the Ledger with the web wallet, you will need to install the Namada Keychain Extension. To use the Ledger with the Namada CLI, you will need to install the latest version of Namada.

Installing the Namada Ledger app

The Namada Ledger app is available on the official Ledger Live app catalog. Follow the instructions below to install the app on your device.

Using a Ledger with Namada Keychain (browser extension)

You can use the Ledger app with the Namada Keychain browser extension to sign transactions in front-end web apps. See the Namada Keychain page for instructions on installing and using the Namada Keychain browser extension.

Importing (deriving) your Ledger address

Before any other operations with the Ledger, we will want to derive an address and public key and add them to the extension (web wallet) under an alias for convenience. To derive your address using a Ledger:

Display your address/public key

To display your Ledger address/public key, first open Namada Keychain. Find your Ledger account in the list, click the ⋮ icon (three vertical dots) and select 'View keys'.

Staking using the Ledger

You can use the Ledger to sign a transactions from a front-end app (such as Namadillo). The example given below is for staking with a validator (or validators), but the signing process is essentially the same for any type of transaction you wish to make (transfers, voting on governance, etc.)

The following assumes you have completed the steps to install the Namada Ledger app, the Namada Keychain browser extension, and completed the initial setup process as described in Importing (deriving) your Ledger Address above.

Worth noting:

Whenever you're submitting a transaction of any kind for the first time from an address, you'll also see a 'Reveal PK' (Reveal Public Key) transaction automatically bundled with your other transaction(s) (6, below). Example of a staking transaction with Reveal PK message

Using the Ledger app with the CLI

You can use your Ledger to sign transactions from the Namada CLI.

Importing (deriving) your Ledger address

Before any other operations with the Ledger, we need to derive an address and public key and add them to the file system wallet under an alias for convenience. To derive your address using a Ledger:

namadaw derive --use-device --alias $ALIAS

namadaw list

Signing a transaction

Use the --use-device flag when you wish to sign a transaction using the Ledger. For example:

namadac transparent-transfer \
  --source $ALIAS \
  --target $DEST_ADDRESS \
  --token $TOKEN \
  --amount $AMOUNT \
  --use-device

When constructing the transfer, the CLI will check your wallet for the public key given under $ALIAS. You will then be prompted on the device to approve the transaction

Troubleshooting

As a first step when troubleshooting Ledger issues, make sure that you've updated your Ledger Live app and Ledger firmware to the latest versions. Additionally, check in the Ledger Live app catalog to make sure you have the latest version of the Namada app.

Some common errors you may encounter while using the Ledger with the Namada CLI:

• Unable to connect to query address and public key from Ledger: Ledger | App Error: | 21781 [APDU_ERROR] Unknown
  There is a USB connectivity issue; disconnecting and reconnecting the Ledger will often resolve this.

• The CLI panics with Message: Failed to sign transaction or similar.
  Make sure you're using the correct versions of both the Ledger app and Namada binaries

• The CLI panics with Message: No signature could be produced for a transaction of type ...
  Make sure the Ledger account has been properly added to your wallet.