Skip to content
Docs
Providers
Infura

Infura

The infuraProvider configures the chains with Infura RPC URLs and also provides an ethers.js InfuraProvider.

import { infuraProvider } from 'wagmi/providers/infura'

Usage

import { chain, configureChains } from 'wagmi'
import { infuraProvider } from 'wagmi/providers/infura'

const { chains, provider } = configureChains(
  [chain.mainnet, chain.polygon],
  [infuraProvider({ apiKey: 'yourInfuraApiKey' })],
)

Return Value

{
  chains: Chain[],
  provider: InfuraProvider,
  webSocketProvider: InfuraWebSocketProvider
}

Configuration

apiKey (optional)

Your Infura API key from the Infura Dashboard.

If no Infura API key is provided, it will use the public Infura API key. It is recommended to provide your own Infura API key to prevent being rate-limited.

import { chain, configureChains } from 'wagmi'
import { infuraProvider } from 'wagmi/providers/infura'

const { chains, provider } = configureChains(
  [chain.mainnet, chain.polygon],
  [infuraProvider({ apiKey: 'yourInfuraApiKey' })],
)

priority (optional)

The priority used for the provider. Lower-value priorities are favoured over higher-value priorities. If multiple providers share the same priority, they are chosen at random.

import { chain, configureChains } from 'wagmi'
import { infuraProvider } from 'wagmi/providers/infura'
import { publicProvider } from 'wagmi/providers/public'

const { chains, provider } = configureChains(
  [chain.mainnet, chain.polygon],
  [
    infuraProvider({
      apiKey: 'yourInfuraApiKey',
      priority: 0,
    }),
    publicProvider({ priority: 1 }),
  ],
)

stallTimeout (optional)

The timeout in milliseconds after which another provider will be attempted.

import { chain, configureChains } from 'wagmi'
import { infuraProvider } from 'wagmi/providers/infura'
import { publicProvider } from 'wagmi/providers/public'

const { chains, provider } = configureChains(
  [chain.mainnet, chain.polygon],
  [
    infuraProvider({
      apiKey: 'yourInfuraApiKey',
      stallTimeout: 1_000,
    }),
    publicProvider(),
  ],
)

weight (optional)

The weight a response from this provider provides. This can be used if a given provider is more trusted.

import { chain, configureChains } from 'wagmi'
import { infuraProvider } from 'wagmi/providers/infura'
import { publicProvider } from 'wagmi/providers/public'

const { chains, provider } = configureChains(
  [chain.mainnet, chain.polygon],
  [
    infuraProvider({
      apiKey: 'yourInfuraApiKey',
      weight: 1,
    }),
    publicProvider({ weight: 2 }),
  ],
)
Alchemy
Public