Hive Application for the Ledger Nano S/X Hardware Wallet

image credit @thepeakstudio

Hive wallet application framework for Ledger Nano S/X

When installed on a Ledger Nano S/X device, this application will deserialize transactions and display them on the hardware wallet for secure validation by the user. If the user accepts the transaction, this application will then sign the transaction with the key specified by the user.

There is a pre-compiled binary available in the bin/ folder and attached to each public Github release. However, you may optionally choose to compile the Hive Ledger Nano S/X application manually with help of the run.sh script provided in the repository. Usage instructions and examples are below..

Latest Stable Release

https://github.com/netuoso/ledger-app-hive/releases/tag/v1.0.0

Building the Development Version

Clone this repository
- git clone https://github.com/netuoso/ledger-app-hive
Install Docker if not already installed
- ./run.sh install_docker
Pull the latest ledger-app-hive docker image
- ./run.sh update
Start the Docker container
- ./run.sh start
Build the ledger-app-hive application
- ./run.sh build VERSION # replace VERSION with 1.4,1.5,1.6 based on your Ledger Nano S firmware

Loading the Development App on a Ledger Nano S

you must use Python 3.7 for loading
Connect the Ledger Nano S to your computer
Install the Ledger python module
- pip install ledgerblue
Load the application onto the Ledger Nano S
- ./run.sh load VERSION # replace VERSION with 1.4,1.5,1.6 based on your Ledger Nano S firmware

Testing the Application

Navigate to the test directory
- cd test
Run the getPublicKey.py script python3 required
- python getPublicKey.py
Run the signTransaction.py script python2.7 required
- python signTransaction.py

Example Testing Output

getPublicKey:

Public key compressed 03d3ead6a886a5896dd05f546704761228c14d6b8d306fa7b0945f75df678b6193
Calculated from public key: Address STM8SZg3gBcuAEkz9xGKVMnwJHWESHcXFYWDbRcSBCz322dH6jPwy
Received from ledger: Address STM8SZg3gBcuAEkz9xGKVMnwJHWESHcXFYWDbRcSBCz322dH6jPwy

signTransaction:

HID => d40400007205800000308000000d8000000080000000800000000420000000000000000000000000000000000000000000000000000000000000000004021b88040485342c6304048164b85e040101042302086e65747479626f74076e6574756f736f010000000000000003535445454d000000040100
HID <= 1f636611993e469a3ad201fbe40df36e8c2be55378a3ca338654f3844d80ce2d6d32a27448c4e5d5e63707f1b9164b42e8cf29f052ae72bd12609182c9d8c88c389000
1f636611993e469a3ad201fbe40df36e8c2be55378a3ca338654f3844d80ce2d6d32a27448c4e5d5e63707f1b9164b42e8cf29f052ae72bd12609182c9d8c88c38

Technical Application Spec

ledger-app-hive Technical Documentation

Contributing

If you are interested in contributing the to ledger-app-hive repository, you will need a Github account. Ensure that you have compiled the application, have it installed on your Ledger Nano S/X, and/or throughly read this README and visited the relevant links before filing an issue.

Bug Reports

If you encounter an issue while using the ledger-app-hive application on a Ledger Nano S/X Device, visit the issues pages and leave a detailed issue with all necessary information to assist with debugging.

Notes

This application is in its initial release (v1.0.0)
There may be bugs that I have not encountered
If the Ledger Nano Device ever locks up, just unplug and restart it
If you encounter bugs/issues file them on the Github repository
Try and break the application and report bugs for the benefit of everyone
Contact @netuoso on Hive, on the HiveDevs Discord, or on Twitter (@netuoso)
Thanks to @thepeakstudio and @doze for their contribution of the Hive + Ledger image assets used on this page

Vote @netuoso For Hive Witness

Links

image credit @doze