fjrojasgarcia / ledgerjs

Ledger Nano / Nano S / Blue JavaScript APIs for Node.js and browsers

Home Page:

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

This repository hosts libraries to communicate with Ledger Nano / Nano S / Blue applications. There are implementations for Node and Browser.

Ledger Devs Slack License

Published Packages

Package Version Description
create-dapp npm Ledger DApp Ethereum starter kit
@ledgerhq/web3-subprovider npm web3 subprovider implementation for web3-provider-engine
@ledgerhq/hw-app-eth npm Ethereum Application API
@ledgerhq/hw-app-btc npm Bitcoin Application API
@ledgerhq/hw-app-xrp npm Ripple Application API
@ledgerhq/hw-app-str npm Stellar Application API
@ledgerhq/hw-app-ada npm Cardano ADA Application API
@ledgerhq/hw-transport-node-hid npm Node implementation of the communication layer, using node-hid (USB)
@ledgerhq/hw-transport-u2f npm Web implementation of the communication layer, using U2F api
@ledgerhq/react-native-hw-transport-ble npm BLE bluetooth for react-native communication layer
@ledgerhq/react-native-hid npm USB hid for react-native communication layer
@ledgerhq/hw-transport-http npm communicate to the device over HTTP. NB: DEV & testing purpose only. DO NOT use in PROD
@ledgerhq/hw-transport npm The generic interface of the communication layer
Development Tools
@ledgerhq/hw-http-proxy-devserver npm HTTP server proxy to use with hw-transport-node-hid NB: DEV & testing purpose only. DO NOT use in PROD
@ledgerhq/hw-hid-cli npm CLI utility to send APDU to the device via node-hid
@ledgerhq/hw-transport-mocker npm Tool used for test to record and replay APDU calls.


Basic example:

import Transport from "@ledgerhq/hw-transport-node-hid";
// import Transport from "@ledgerhq/hw-transport-u2f"; // for browser
import AppBtc from "@ledgerhq/hw-app-btc";
const getBtcAddress = async () => {
  const transport = await Transport.create();
  const btc = new AppBtc(transport);
  const result = await btc.getWalletPublicKey("44'/0'/0'/0");
  return result.bitcoinAddress;
getBtcAddress().then(a => console.log(a));

When using in a browser, make sure to set up "Browser mode" in the application settings on the device if available.

More advanced examples:

  • TODO



Please read our contribution guidelines before getting started.

You need to have a recent Node.js and Yarn installed.

Install dependencies



Build all packages

yarn build


Watch all packages change. Very useful during development to build only file that changes.

yarn watch


Lint all packages

yarn lint

Run Tests

First of all, this ensure the libraries are correctly building, and passing lint and flow:

yarn test

then to test on a real device...

Plug a device like the Nano S and open Bitcoin app.

Then run the test and accept the commands on the devices for the tests to continue.

yarn test-node

You can also test on the web:

yarn test-browser

make sure to configure your device app with "Browser support" set to "YES".


Checklist before deploying a new release:

  • you have the right in the LedgerHQ org on NPM
  • you have run npm login once (check npm whoami)
  • Go to master branch
    • your master point on LedgerHQ repository (check with git config remote.$(git config branch.master.remote).url and fix it with git branch --set-upstream master origin/master)
    • you are in sync (git pull) and there is no changes in git status
  • Run yarn once, there is still no changes in git status

deploy a new release

 yarn run publish

then, go to /releases and create a release with change logs.


deploy a canary release (beta, etc)

 yarn run publish -- -c beta

NB: if there is a new package, AFAIK you need to manually npm publish it once on NPM.

ezoic increase your site revenue


Ledger Nano / Nano S / Blue JavaScript APIs for Node.js and browsers

License:Apache License 2.0


Language:JavaScript 90.5%Language:Java 7.3%Language:HTML 1.5%Language:CSS 0.5%Language:Shell 0.2%