You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Gaëtan Renaudeau 210ff622ec
5 days ago
.circleci update circleci to node 12 3 weeks ago
docs Add doc to migrate ETH app to erc20 update 11 months ago
packages v5.9.0 5 days ago
script Split hw-app-btc, refactor in async/await, progress events 1 month ago
.eslintrc.json Prettier & lint. flow still needs some workarounds.. 2 years ago
.gitignore update tests to connect to codecov 1 month ago
.nvmrc fix(web3-subprovider): incorrect inport of ethereumjs-tx 3 weeks ago
.prettierignore Document new library @ledgerhq/hw-transport-node-ble 8 months ago Update 2 years ago
LICENSE Initial commit 4 years ago Use Jest to write tests in each package 1 month ago
babel.config.js add ES module target 1 month ago
lerna.json v5.9.0 5 days ago
package.json update flow 5 days ago
yarn.lock update flow 5 days ago

Ledger Devs Slack License

Welcome to Ledger’s JavaScript libraries.

See also:


To communicate with a Ledger device, you first need to identify which transport(s) to use.

The hw-transport libraries implement communication protocol for our hardware wallet devices (Ledger Nano / Ledger Nano S / Ledger Nano X / Ledger Blue) in many platforms: Web, Node, Electron, React Native,… and using many different communication channels: U2F, HID, WebUSB, Bluetooth,…

Channels U2F/WebAuthn HID WebUSB Bluetooth

Summary of implementations available per platform

Platforms U2F/WebAuthn HID WebUSB Bluetooth
Web @ledgerhq/hw-transport-u2f (Chrome, Opera) @ledgerhq/hw-transport-webhid (Chrome DEV under experimental flags) @ledgerhq/hw-transport-webusb (Chrome) @ledgerhq/hw-transport-web-ble (Chrome)
Electron/Node.js NO @ledgerhq/hw-transport-node-hid1 NO @ledgerhq/hw-transport-node-ble
iOS NO NO NO @ledgerhq/react-native-hw-transport-ble
Android @ledgerhq/hw-transport-u2f2 @ledgerhq/react-native-hid @ledgerhq/hw-transport-webusb2 @ledgerhq/react-native-hw-transport-ble
  1. 3 implementations available
  2. via Android Chrome

Please find respective documentation for each transport:

An unified Transport interface

All these transports implement a generic interface exposed by @ledgerhq/hw-transport. There are specifics for each transport which are explained in each package.

A Transport is essentially:

  • Transport.listen: (observer)=>Subscription
  • (descriptor)=>Promise<Transport>
  • Buffer): Promise<Buffer>
  • transport.close()

and some derivates:

  • transport.create(): Promise<Transport>: make use of listen and open for the most simple scenario.
  • transport.send(cla, ins, p1, p2, data): Promise<Buffer>: a small abstraction of exchange

NB: APDU is the encoding primitive for all binary exchange with the devices. (it comes from smart card industry)


As soon as your Transport is created, you can already communicate by implementing the apps protocol (refer to application documentations, for instance BTC app and ETH app ones).

We also provide libraries that help implementing the low level exchanges. These higher level APIs are split per app:

Community packages:

We invite all third party app developers to not send PR to this repository to provide more implementations but instead to maintain your own version in your own repository and we would be happy to reference them here ♥.

Other packages

Published Packages

Package Version Description
create-dapp npm Ledger DApp Ethereum starter kit
@ledgerhq/web3-subprovider npm web3 subprovider implementation for web3-provider-engine
Development Tools
@ledgerhq/hw-transport-mocker npm Tool used for test to record and replay APDU calls.

Basic gist

import Transport from "@ledgerhq/hw-transport-node-hid";
// import Transport from "@ledgerhq/hw-transport-web-usb";
// import Transport from "@ledgerhq/react-native-hw-transport-ble";
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/0");
  return result.bitcoinAddress;
getBtcAddress().then(a => console.log(a));


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

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