Ledger Hardware Wallet Support—Developer Preview

[kyranjamie]

Ledger Support for the Hiro Wallet

We're launching a developer preview of Ledger support for the Hiro Wallet, to gather user feedback and catch bugs ahead of the forthcoming stable release of this feature.

Here, you'll find all the information you need to set up the preview build.

Warning
This is a beta software release. Do not test this software with your main cryptocurrency holdings. Use a separate Ledger device for testing.

Getting started

You'll need to follow a few steps to begin testing out the preview release.

Install Stacks app for Ledger

Update: 01-07-2022 You can download the Stacks App directly from Ledger Live

Old development build instructions

You’ll need the development build of the Stacks Ledger app, developed by our partners at Zondax.

Note
Only the Ledger Nano S and Ledger Nano S Plus are supported for preview builds

Installation instructions

1. Download the latest release on their Github, v0.22.7. There are separate builds depending on which device you have.
2. In your terminal, give the downloaded binary executable permissions chmod +x installer_nanos.sh
3. Ensure your test Ledger device is plugged in, unlocked, and on the home screen
4. Run ./installer_nanos.sh load
5. Follow the instructions that appear on your Ledger device
6. Open the Stacks app (you'll need to approve an unofficial app warning when opening)

Install Hiro Wallet developer preview

Download the latest developer preview build of the Hiro Wallet here →

Once downloaded, unpack the .zip file, and load the unpacked extension into your browser.

Note
For instructions on how to load an “unpacked” Web Extension, follow Chrome’s developer documentation

For testing purposes, we recommend you use a different browser to the one you have your primary wallet set up in.

Upgrading your apps

There are some limitations and differences to be aware of using the Hiro Wallet when set up with a Ledger.

@stacks/connect

If using @stacks/connect you'll need to upgrade to the latest version to allow Ledger users to initiate authentication and transaction signing.

yarn upgrade @stacks/connect @stacks/connect-react -L

npm update @stacks/connect @stacks/connect-react

No appPrivateKey, Gaia support

In software wallet mode, the appPrivateKey is derived from the wallet's dataPrivateKey. By design, this is not accessible when using a hardware wallet.

Apps that rely on the appPrivateKey, and features that need this key, such as Gaia, will not work. We're aware this has a big impact for some projects. If this affects your app, let us know, and contribute to this discussion to consider alternative implementations →

No Message Signing support

This is a new feature released in v3.8 and is not currently supported in Ledger mode.

Feedback

💬 If you have high-level thoughts, feedback, or questions on our Ledger implementation, comment here on the discussion 👇🏼

🐞 For bugs, create a new issue here →

We look forward to everyone's input,
Hiro UserX team ❤️

[fbwoolf]

The latest build is now v0.22.7: https://github.com/Zondax/ledger-blockstack/releases