aboutsummaryrefslogtreecommitdiffstats
path: root/packages/subproviders/README.md
diff options
context:
space:
mode:
authorJacob Evans <jacob@dekz.net>2018-03-07 09:49:05 +0800
committerJacob Evans <jacob@dekz.net>2018-03-07 10:01:39 +0800
commita941f0ffb6c4c011160e04522613318a3da9c5b5 (patch)
treeedd643d637f1c4dffcc6d9c4ebe2c26919ea0077 /packages/subproviders/README.md
parentd7373a5c0455ef81a5a1852123136e4724f13e36 (diff)
downloaddexon-sol-tools-a941f0ffb6c4c011160e04522613318a3da9c5b5.tar
dexon-sol-tools-a941f0ffb6c4c011160e04522613318a3da9c5b5.tar.gz
dexon-sol-tools-a941f0ffb6c4c011160e04522613318a3da9c5b5.tar.bz2
dexon-sol-tools-a941f0ffb6c4c011160e04522613318a3da9c5b5.tar.lz
dexon-sol-tools-a941f0ffb6c4c011160e04522613318a3da9c5b5.tar.xz
dexon-sol-tools-a941f0ffb6c4c011160e04522613318a3da9c5b5.tar.zst
dexon-sol-tools-a941f0ffb6c4c011160e04522613318a3da9c5b5.zip
README
Diffstat (limited to 'packages/subproviders/README.md')
-rw-r--r--packages/subproviders/README.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/packages/subproviders/README.md b/packages/subproviders/README.md
index 67a6a92d2..52ad3388e 100644
--- a/packages/subproviders/README.md
+++ b/packages/subproviders/README.md
@@ -42,6 +42,26 @@ const accounts = await ledgerSubprovider.getAccountsAsync();
A subprovider that enables your dApp to send signing requests to a user's Ledger Nano S hardware wallet. These can be requests to sign transactions or messages.
+##### Ledger Nano S + Node-hid (usb)
+
+By default, node-hid transport support is an optional dependency. This is due to the requirement of native usb developer packages on the host system. If these aren't installed the entire `npm install` fails. We also no longer export node-hid transport client factories. To re-create this see our integration tests or follow the example below:
+
+```typescript
+import Eth from '@ledgerhq/hw-app-eth';
+import TransportNodeHid from '@ledgerhq/hw-transport-node-hid';
+async function ledgerEthereumNodeJsClientFactoryAsync(): Promise<LedgerEthereumClient> {
+ const ledgerConnection = await TransportNodeHid.create();
+ const ledgerEthClient = new Eth(ledgerConnection);
+ return ledgerEthClient;
+}
+
+// Create a LedgerSubprovider with the node-hid transport
+ledgerSubprovider = new LedgerSubprovider({
+ networkId,
+ ledgerEthereumClientFactoryAsync: ledgerEthereumNodeJsClientFactoryAsync,
+});
+```
+
#### Redundant RPC subprovider
A subprovider which attempts to send an RPC call to a list of RPC endpoints sequentially, until one of them returns a successful response.