aboutsummaryrefslogtreecommitdiffstats
path: root/packages/subproviders/README.md
blob: 5fa31611a0e5fbcacc32aaac54588554fecf57a6 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
Subproviders
-----------

A few useful subproviders.

## Installation

```
npm install @0xproject/subproviders --save
```

## Subproviders

#### Ledger Nano S subprovider

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.

#### 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.

#### Injected Web3 subprovider

A subprovider that relays all signing related requests to a particular provider (in our case the provider injected onto the web page), while sending all other requests to a different provider (perhaps your own backing Ethereum node or Infura).

### Integration tests

In order to run the integration tests, make sure you have a Ledger Nano S available.

- Plug it into your computer
- Unlock the device
- Open the on-device Ethereum app
- Make sure "browser support" is disabled

Then run:

```
yarn test:integration
```