dpos-ledger-api

This library eases the interaction with the corresponding ledger nano implementation

Usage no npm install needed!

<script type="module">
  import dposLedgerApi from 'https://cdn.skypack.dev/dpos-ledger-api';
</script>

README

npm Build Status Coverage Status

dPoS Ledger

This library is meant to be used with the corresponding Ledger C implementation. Given the end-user have:

  • His ledger connected & unlocked;
  • the corresponding app open;

This JS library will serve as an interface between your code and the hardware wallet handling the communication protocol.

Documentation

Documention is available here.

Environment Support

This library does not make any assumption on the environment on which it is being consumed.

Both Node.JS and minified Browser version of this library are provided.

NodeJS

To consume this library through an app running under the NodeVM, you'll need to use the @ledgerhq/hw-transport-node-hid transport.

This library, and the ledger app, have been developed and tested with hw-transport-node-hid@4.7.6.

Browser

The Browser version currently weights 32KB (non gzipped). It can be used both via webpack or directly including it in your page just like any other script.

This library, and the ledger app, have been tested with @ledgerhq/hw-transport-node-hid@4.7.3 as Transport.

Platform Indipendent Example

import TransportU2F from '@ledgerhq/hw-transport-u2f';
import TransportNodeHid from '@ledgerhq/hw-transport-node-hid';
import { isBrowser, isNode } from 'browser-or-node';
import { DposLedge, CommHandler } from 'dpos-ledger-api';

let transportMethod;
if (isBrowser) {
    transportMethod = TransportU2F;
} else if (isNode) {
    transportMethod = TransportNodeHid;
} else {
    // ??
}

transportMethod.create()
    .then((transport) => new DposLedger(new CommHandler(transport)))
    .then((instance) => {
        // ..
    });

Thanks

Any improvement/suggestion is very welcome :)