Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update hardware-wallet.mdx #393

Merged
merged 2 commits into from
Sep 17, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 11 additions & 8 deletions packages/docs/pages/users/wallet/hardware-wallet.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@ import { Steps } from 'nextra-theme-docs'
# Ledger Hardware Wallet

<Callout type="info">
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.
</Callout>

Both the [Namada Keychain](./web-wallet.mdx) browser extension and the Namada CLI are compatible with the [Ledger](https://www.ledger.com/) hardware wallet.
Expand Down Expand Up @@ -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.

<Callout>
Disclaimer: this will oly work on Chrome-enabled browsers at the moment.
Disclaimer: this will only work on Chrome-enabled browsers at the moment.
</Callout>

### Importing (deriving) your Ledger address
Expand Down Expand Up @@ -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:

<Steps>
### Connect your device and open the Namada app
Expand Down Expand Up @@ -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.

Expand All @@ -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`
Expand All @@ -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`.
Make sure the `expert mode` toggle in the Ledger app is set to `disabled`.
Loading