protomux-rpc-client-pool/README.md

Reliably connect to one of a pool of protomux-rpc servers

# Protomux RPC Client Pool

Reliably connect to one of a pool of protomux-rpc servers.

Picks a random server to connect to, and keeps connecting to that server, unless it fails to respond, in which case it automatically switches over to another one.

## Install

```
npm i protomux-rpc-client-pool
```

## API

#### `const pool = new ProtomuxRpcClientPool(keys, rpcClient, opts)`

Create a new pool. `keys` is a list of [HyperDHT](https://github.com/holepunchto/hyperdht) servers that expose the same [protomux-rpc](https://github.com/holepunchto/protomux-rpc) service. `rpcClient` is a [Protomux RPC client](https://github.com/holepunchto/protomux-rpc-client) instance.

`opts` include:
- `retries` : the number of times to retry a request with a different server before giving up. Default: 3.
- `timeout` : the default timeout for a single request attempt, in ms. Note that the maximal total time for a `pool.request(...)` call is roughly `retries * timeout`.

#### `await pool.makeRequest(methodName, args, opts)`

Makes a request for the specifed `methodName` to one of the servers in the pool, passing the `args`. If the server fails to respond, it automatically retries with other servers.

Throws a `ProtomuxRpcClientPoolError.TOO_MANY_RETRIES` error if the request attempt fails `pool.retries` times.

`opts` include:
- `requestEncoding` the request encoding of the RPC service
- `responseEncoding` the response encoding of the RPC service
- `timeout` the timeout to use for each request attempt (in ms). Defaults to `pool.timeout`.