diff --git a/packages/docs/pages/users/wallet/hardware-wallet.mdx b/packages/docs/pages/users/wallet/hardware-wallet.mdx index e068a732..2f8e1b11 100644 --- a/packages/docs/pages/users/wallet/hardware-wallet.mdx +++ b/packages/docs/pages/users/wallet/hardware-wallet.mdx @@ -4,8 +4,8 @@ import { Steps } from 'nextra-theme-docs' # Ledger Hardware Wallet -The Namada Ledger app is still in active development, and the version available on the official Ledger App store is not compatible with the current release of Namada. -See the installation instructions below if you'd like to sideload an updated development version of the app onto your device for testing purposes. +The Namada Ledger app is not yet updated in the Ledger Live catalogue, so the only way to use one in the meantime is with 1) a Ledger **Nano** device and 2) sideloading as a work-around: [Zondax Hub](https://hub.zondax.ch) +Typically sideloading an unaudited version of the app onto your device is only for testing purposes, but it is effective as a work-around. See the installation instructions below. Both the [Namada Keychain](./web-wallet.mdx) browser extension and the Namada CLI are compatible with the [Ledger](https://www.ledger.com/) hardware wallet. @@ -42,11 +42,11 @@ Scroll down until you find Namada in the list, and select the newest version fro ## 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 +You can use the Ledger app with the Namada Keychain browser extension to sign transactions in front-end web apps. **Expert mode must be turned off.** See the [Namada Keychain](./web-wallet.mdx) page for general installation and usage instructions. -Disclaimer: this will oly work on Chrome-enabled browsers at the moment. +Disclaimer: this will only work on Chrome-enabled browsers at the moment. ### Importing (deriving) your Ledger address @@ -74,7 +74,7 @@ Give your account an easy to remember name. 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'. ### Signing a transaction -To sign a transaction from a front-end app (such as [Namadillo](./../../integrating-with-namada/interface.mdx)), follow these steps: +**Expert mode must be turned off.** To sign a transaction from a front-end app (such as [Namadillo](./../../integrating-with-namada/interface.mdx)), follow these steps: ### Connect your device and open the Namada app @@ -110,10 +110,10 @@ To derive your address using a Ledger: ### Open the Namada app on your device -### Derive your address/public key +### Derive your address / public key This command will derive your address and public key and add them to your wallet under an `alias` of your choosing: ```bash copy -namadaw --use-device --alias $ALIAS +namadaw derive --use-device --alias $ALIAS ``` The default derivation path is `m/44'/877'/0'/0'/0`. You can use the flag `--hd-path` to specify a different derivation path. Use `namadaw derive --help` for more information. @@ -138,6 +138,9 @@ namadac transparent-transfer \ 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 written above, the Namada Ledger app is not yet updated in the Ledger Live catalogue, so the only way to use one in the meantime is with 1) a Ledger **Nano** device and 2) sideloading as a work-around: [Zondax Hub](https://hub.zondax.ch) +Typically sideloading an unaudited version of the app onto your device is only for testing purposes, but it is effective as a work-around. + 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` @@ -150,4 +153,4 @@ Make sure you're using the correct versions of both the Ledger app and Namada bi Make sure the Ledger account has been properly [added to your wallet](#importing-deriving-your-ledger-address-1). - The CLI panics part-way through signing and the Ledger reboots. -Make sure the `expert mode` toggle in the Ledger app is set to `disabled`. \ No newline at end of file +Make sure the `expert mode` toggle in the Ledger app is set to `disabled`.