JSPM

@adrastia-oracle/ethers-fallback-provider

1.2.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1
  • Score
    100M100P100Q19273F
  • License MIT

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

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@adrastia-oracle/ethers-fallback-provider) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    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();