#ledger-nano #ledger #nano #bitcoin

bitcoins-ledger

Ledger Nano X/S Bitcoin app utilization library

7 unstable releases (3 breaking)

0.7.0 Jul 6, 2022
0.6.1 Jul 1, 2022
0.6.0 Dec 20, 2021
0.3.3 Dec 20, 2021
0.2.2 Apr 4, 2021

#17 in #ledger-nano

27 downloads per month

MIT/Apache

135KB
3K SLoC

bitcoins-ledger

Ledger Bitcoin App abstraction.

Building

Windows is not yet supported.

Native

  • Install dependencies
    • Linux
      • $ sudo apt-get install libudev-dev libusb-1.0-0-dev
    • OSX
      • TODO
      • please file an issue if you know. I don't have a macbook :)
  • Build with native transport
    • cargo build

WASM

  • Install wasm-pack
  • building for wasm
    • MUST disable default features
    • MUST select feature AT MOST ONE of browser and node
    • browser
      • usage env must be able to import
    • node

Features

The node and browser features are mutually exclusive. You must specify exactly one, as well as the --no-default-features flag.

When building for non-wasm architectures, a native HID transport is compiled in. When building wasm via wasm-pack, you must specify whether you want the node or browser wasm transport.

Testing

  • run the unit tests
    • $ cargo test -- --lib
  • run the integration tests
    • Plug in a Ledger Nano S or X device
    • Unlock the device
    • Open the Bitcoin application on the device
    • $ cargo test

Dependencies

~5.5–8.5MB
~154K SLoC