@morpho-labs/ethers-fallback-provider

1.1.0 • Public • Published

ethers-fallback-provider

npm package Build Status Downloads Issues Commitizen Friendly Semantic Release

Package providing a fallback provider based on ethers package, adding more resilience.

The provider fallbacks on multiple providers in case of failure, and returns the first successful result.

It throws an error if all providers failed.

The providers are called in the order they are passed to the constructor.

Contrary to the FallbackProvider provided by ethers, this one does not use all providers at the same time, but only one at a time. The purpose is more to have resilience if one provider fails, rather than having a resilience on the result.

Installation

npm install @morpho-labs/ethers-fallback-provider

or

yarn add @morpho-labs/ethers-fallback-provider

Usage

import FallbackProvider from '@morpho-labs/ethers-fallback-provider';

import { 
    InfuraProvider, 
    AlchemyProvider, 
    getDefaultProvider 
} from "@ethersproject/providers";


const timeout = 1000; // 1 second, optionnal, default is 3000ms

const provider = new FallbackProvider([
    {
        provider: new InfuraProvider('mainnet', 'your-api-key'),
        retries: 3, // retry after a timeout or an error 3 times, default is 0.
        timeout,
        retryDelay: 1000 // wait a random time less than 1 second before retrying. Default is 0.
    },
    new AlchemyProvider('mainnet', 'your-api-key'),
    getDefaultProvider('mainnet')
]);

// You can now use the fallback provider as a classic provider
const blockNumber = await provider.getBlockNumber();

Versions

Current Tags

VersionDownloads (Last 7 Days)Tag
1.1.030latest

Version History

VersionDownloads (Last 7 Days)Published
1.1.030
1.0.22
1.0.12

Package Sidebar

Install

npm i @morpho-labs/ethers-fallback-provider

Weekly Downloads

34

Version

1.1.0

License

MIT

Unpacked Size

15.2 kB

Total Files

11

Last publish

Collaborators

  • merlin-egalite
  • julien-devatom
  • mathisgd
  • rubilmax