ethers-queue-provider

• About
• Installation
• Documentation
• Usage
  • Browser
  • Example

About

Ethers.js compatible JSONRPC provider with support of Axios, Batching, and automated request Queue

AxiosQueueProvider is an easy to use ethers.js v5 compatible Ethereum Javascript (Typescript) JSONRPC API Provider powered by a powerful Axios HTTP client wrapped by axios-auto library to help your automated error handling & Promise.any powered client-side load balancing feature.

It supports sending several Request objects and will expect to receive array of returned objects following the specification of Batching by JSON RPC 2.0.

Features:

• Integrated cross-platform promise queue handler to ensure batch requests are sent under the rate limits of public nodes.
• Provides much better error handling & timeouts for public RPC nodes the most widely used HTTP client Axios.
• Supports custom http.agent / https.Agent via Axios (Node.js feature to support Tor, Socks5, Https proxy connection)
• Client side load-balancer using Promise.any() to resolve fastest query result from the fastest node connection.
• Sends a query to multiple nodes (like Promise.all but without waiting for every promise to resolve)
• Advanced retries for server-side error using axios-auto
• Return cached eth_chainId value since network doesn't change for RPC nodes for most cases.

Installation

Node.js

# Wouldn't work without axios or ethers installed
npm i --save axios ethers ethers-queue-provider

Documentation

https://ayanamitech.github.io/ethers-queue-provider

Usage

Browser

Every release of ethers-queue-provider will have new build of ./dist/browser/index.js for use in the browser. To get access to module classes use AxiosQueueProvider global variable.

WARN: We recommend hosting and controlling your own copy for security reasons

<!-- Since Browser bundle comes with axios-auto built in, no need to add additional axios or axios-auto dependency -->
<script src="https://cdn.jsdelivr.net/npm/ethers-queue-provider@latest"></script>

<!-- Since Browser bundle comes with axios-auto built in, no need to add additional axios or axios-auto dependency -->
<script src="https://unpkg.com/ethers-queue-provider@latest"></script>

Note that it would be helpful to setup the Subresource Integrity hash to ensure that the imported library has the desired codes.

For more info, see https://www.srihash.org/.

Node.js

// CommonJS
const AxiosQueueProvider = require('ethers-queue-provider');

// ModuleJS / TypeScript
import AxiosQueueProvider from 'ethers-queue-provider';

const provider = new AxiosQueueProvider('rpc-host-here');

Promise.all([
  provider.getBlockNumber(),
  provider.getBlock('latest'),
  provider.getBlockWithTransactions('latest')
]).then(result => console.log(result));