From d921d29acfca4436c2769c7d2def892bbef774ce Mon Sep 17 00:00:00 2001 From: Gavin Birch <13985253+gavinly@users.noreply.github.com> Date: Tue, 17 Sep 2024 10:32:46 -0400 Subject: [PATCH 1/2] Update hardware-wallet.mdx updated to include information about how only the Nano S devices will work --- packages/docs/pages/users/wallet/hardware-wallet.mdx | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/packages/docs/pages/users/wallet/hardware-wallet.mdx b/packages/docs/pages/users/wallet/hardware-wallet.mdx index e068a732..117a3621 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. @@ -46,7 +46,7 @@ You can use the Ledger app with the Namada Keychain browser extension to sign tr [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 @@ -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`. From cbe0b177a4f46e1557c4323426afe66db1ef383b Mon Sep 17 00:00:00 2001 From: Gavin Birch <13985253+gavinly@users.noreply.github.com> Date: Tue, 17 Sep 2024 10:50:37 -0400 Subject: [PATCH 2/2] Update hardware-wallet.mdx --- packages/docs/pages/users/wallet/hardware-wallet.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/packages/docs/pages/users/wallet/hardware-wallet.mdx b/packages/docs/pages/users/wallet/hardware-wallet.mdx index 117a3621..2f8e1b11 100644 --- a/packages/docs/pages/users/wallet/hardware-wallet.mdx +++ b/packages/docs/pages/users/wallet/hardware-wallet.mdx @@ -42,7 +42,7 @@ 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. @@ -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.