@1delta/providers 0.0.41 → 0.0.43

package/src/multicall/multicall.ts

@@ -0,0 +1,250 @@
+import {
+  BaseError,
+  ContractFunctionExecutionError,
+  ContractFunctionRevertedError,
+} from 'viem'
+import { LIST_OVERRIDES } from '../rpc/rpcOverrides'
+import { getEvmClientWithCustomRpcsUniversal } from '../client/client'
+import { DEFAULT_BATCH_SIZE, deepCompare, isArray } from '../utils/utils'
+
+/** Return true if it is a revert case */
+function isContractRevert(e: unknown): boolean {
+  if (!(e instanceof BaseError)) return false
+
+  // Walk the cause chain
+  let err: BaseError | null = e
+  while (err) {
+    // Strong signal
+    if (err instanceof ContractFunctionRevertedError) return true
+
+    // Weaker but common signal
+    if (
+      err.name === 'ContractFunctionRevertedError' ||
+      err.message?.toLowerCase().includes('execution reverted')
+    ) {
+      return true
+    }
+
+    err = err.cause instanceof BaseError ? err.cause : null
+  }
+
+  return false
+}
+
+export interface MulticallRetryParams {
+  chain: string
+  calls: any[]
+  abi: any
+  batchSize?: number
+  maxRetries?: number
+  providerId?: number
+  allowFailure?: boolean
+  overrdies?: Record<string, string[]>
+  logErrors?: boolean
+}
+
+export function createMulticallRetry(
+  customRpcs: Record<string, string[]> = LIST_OVERRIDES,
+) {
+  return async function multicallRetry(
+    chain: string,
+    calls: any[],
+    abi: any,
+    batchSize = DEFAULT_BATCH_SIZE,
+    maxRetries = 3,
+    providerId = 0,
+    allowFailure = true,
+    logErrors = false,
+    revertedIndices: Set<number> = new Set(),
+  ): Promise<any[]> {
+    const abiIsArray = isArray(abi[0])
+
+    try {
+      const nonRevertedIndices = calls
+        .map((_, i) => i)
+        .filter((i) => !revertedIndices.has(i))
+
+      const filteredCalls = nonRevertedIndices.map((i) => calls[i])
+      const filteredAbi = abiIsArray
+        ? nonRevertedIndices.map((i) => abi[i])
+        : abi
+
+      const provider = getEvmClientWithCustomRpcsUniversal({
+        chain,
+        rpcId: providerId,
+        customRpcs,
+      })
+      const data = await provider.multicall({
+        batchSize,
+        contracts: filteredCalls.map((call, i) => ({
+          abi: abiIsArray ? filteredAbi[i] : filteredAbi,
+          address: call.address as any,
+          functionName: call.name,
+          args: call.args ?? call.params ?? [],
+        })),
+        allowFailure: false,
+      })
+
+      if (revertedIndices.size > 0) {
+        const finalResults: any[] = []
+        let filteredIndex = 0
+
+        for (let i = 0; i < calls.length; i++) {
+          if (revertedIndices.has(i)) {
+            finalResults.push('0x')
+          } else {
+            finalResults.push(data[filteredIndex++])
+          }
+        }
+        return finalResults
+      }
+
+      return data
+    } catch (e) {
+      if (isContractRevert(e)) {
+        const error = e as ContractFunctionExecutionError
+        const errorAddress = (error as any).contractAddress?.toLowerCase()
+        const errorFunctionName = error.functionName
+        const errorArgs = (error as any).args
+
+        const nonRevertedIndices = calls
+          .map((_, i) => i)
+          .filter((i) => !revertedIndices.has(i))
+
+        const matchingIndices: number[] = []
+        for (let i = 0; i < nonRevertedIndices.length; i++) {
+          const originalIndex = nonRevertedIndices[i]
+          const call = calls[originalIndex]
+          const callAddress = call.address?.toLowerCase()
+          const callFunctionName = call.name
+          const callArgs = call.args ?? call.params ?? []
+
+          const addressMatch = errorAddress && callAddress === errorAddress
+          const functionMatch = errorFunctionName === callFunctionName
+          const argsMatch = deepCompare(errorArgs, callArgs)
+
+          if (addressMatch && functionMatch && argsMatch) {
+            matchingIndices.push(originalIndex)
+          }
+        }
+
+        if (matchingIndices.length > 0) {
+          const newRevertedIndices = new Set(revertedIndices)
+          matchingIndices.forEach((idx) => newRevertedIndices.add(idx))
+
+          if (newRevertedIndices.size === calls.length) {
+            return Array(calls.length).fill('0x')
+          }
+
+          return await multicallRetry(
+            chain,
+            calls,
+            abi,
+            batchSize,
+            maxRetries,
+            providerId,
+            allowFailure,
+            logErrors,
+            newRevertedIndices,
+          )
+        }
+      }
+
+      if (maxRetries === 0) {
+        if (!allowFailure) throw e
+        if (logErrors) console.debug(e)
+        return Array(calls.length).fill('0x')
+      }
+
+      if (logErrors) console.debug(e)
+
+      return await multicallRetry(
+        chain,
+        calls,
+        abi,
+        batchSize,
+        maxRetries - 1,
+        providerId + 1,
+        allowFailure,
+        logErrors,
+        revertedIndices,
+      )
+    }
+  }
+}
+
+async function multicallRetryInternal(
+  chain: string,
+  calls: any[],
+  abi: any,
+  batchSize = DEFAULT_BATCH_SIZE,
+  maxRetries = 5,
+  providerId = 0,
+  allowFailure = false,
+  overrdies: Record<string, string[]> = LIST_OVERRIDES,
+  logErrors = false,
+) {
+  const defaultMulticallRetry = createMulticallRetry(overrdies)
+  return defaultMulticallRetry(
+    chain,
+    calls,
+    abi,
+    batchSize,
+    maxRetries,
+    providerId,
+    allowFailure,
+    logErrors,
+  )
+}
+
+/**
+ * @deprecated use multicallRetryUniversal instead
+ * @see multicallRetryUniversal
+ */
+export async function multicallRetry(
+  chain: string,
+  calls: any[],
+  abi: any,
+  batchSize = DEFAULT_BATCH_SIZE,
+  maxRetries = 5,
+  providerId = 0,
+  allowFailure = false,
+  overrdies: Record<string, string[]> = LIST_OVERRIDES,
+  logErrors = false,
+) {
+  return multicallRetryInternal(
+    chain,
+    calls,
+    abi,
+    batchSize,
+    maxRetries,
+    providerId,
+    allowFailure,
+    overrdies,
+    logErrors,
+  )
+}
+
+export async function multicallRetryUniversal({
+  chain,
+  calls,
+  abi,
+  batchSize = DEFAULT_BATCH_SIZE,
+  maxRetries = 5,
+  providerId = 0,
+  allowFailure = false,
+  overrdies = LIST_OVERRIDES,
+  logErrors = false,
+}: MulticallRetryParams) {
+  return multicallRetryInternal(
+    chain,
+    calls,
+    abi,
+    batchSize,
+    maxRetries,
+    providerId,
+    allowFailure,
+    overrdies,
+    logErrors,
+  )
+}

package/src/rpc/rpcOverrides.ts

@@ -0,0 +1,248 @@
+import { Chain } from '@1delta/chain-registry'
+
+export const LIST_OVERRIDES: Record<string, string[]> = {
+  [Chain.BASE]: [
+    'https://base-rpc.publicnode.com',
+    'https://base.llamarpc.com',
+    'https://base.public.blockpi.network/v1/rpc/public',
+    'https://1rpc.io/base',
+    'https://base-pokt.nodies.app',
+    'https://base.meowrpc.com',
+    'https://developer-access-mainnet.base.org',
+    'https://base.drpc.org',
+    'https://base.api.onfinality.io/public',
+    'https://base.rpc.subquery.network/public',
+    'https://api.zan.top/base-mainnet',
+    'https://endpoints.omniatech.io/v1/base/mainnet/public',
+    'https://base.lava.build',
+    'https://0xrpc.io/base',
+    'https://base.therpc.io',
+  ],
+  [Chain.POLYGON_MAINNET]: [
+    'https://polygon-bor-rpc.publicnode.com',
+    'https://polygon.lava.build',
+    'https://polygon.drpc.org',
+    'https://gateway.tenderly.co/public/polygon',
+    'https://endpoints.omniatech.io/v1/matic/mainnet/public',
+    'https://polygon.therpc.io',
+    'https://rpc-mainnet.matic.quiknode.pro',
+    'https://polygon-pokt.nodies.app',
+    'https://polygon.gateway.tenderly.co',
+    'https://polygon-rpc.com',
+    'https://polygon.api.onfinality.io/public',
+    'https://api.zan.top/polygon-mainnet',
+    'https://polygon.rpc.subquery.network/public',
+    'https://polygon-mainnet.nodereal.io/v1/f510fc4d083b49d1ab383d25246cc7de',
+    'wss://polygon-mainnet.nodereal.io/ws/v1/f510fc4d083b49d1ab383d25246cc7de',
+  ],
+  [Chain.HEMI_NETWORK]: ['https://rpc.hemi.network/rpc'],
+  [Chain.MANTLE]: [
+    'https://rpc.mantle.xyz',
+    'https://1rpc.io/mantle',
+    'https://api.zan.top/mantle-mainnet',
+    'https://mantle-public.nodies.app',
+    'https://mantle.drpc.org',
+  ],
+  [Chain.XDC_NETWORK]: [
+    'https://rpc.ankr.com/xdc',
+    'https://earpc.xinfin.network',
+    'https://rpc.xinfin.network',
+    'https://rpc.xdc.org',
+    'https://rpc.xdc.network',
+    'https://erpc.xdcrpc.com',
+  ],
+  [Chain.ETHEREUM_MAINNET]: [
+    'https://eth.llamarpc.com',
+    'https://api.zan.top/eth-mainnet',
+    'https://rpc.flashbots.net/fast',
+    'https://rpc.owlracle.info/eth/70d38ce1826c4a60bb2a8e05a6c8b20f',
+    'https://eth.merkle.io',
+    'https://eth-mainnet.nodereal.io/v1/1659dfb40aa24bbb8153a677b98064d7',
+    'wss://eth-mainnet.nodereal.io/ws/v1/1659dfb40aa24bbb8153a677b98064d7',
+    'https://rpc.payload.de',
+    'https://ethereum-rpc.publicnode.com',
+    'https://eth-mainnet.g.alchemy.com/v2/demo',
+    'https://go.getblock.io/aefd01aa907c4805ba3c00a9e5b48c6b',
+    'https://rpc.flashbots.net',
+    'https://public-eth.nownodes.io',
+    'https://ethereum-json-rpc.stakely.io',
+    'https://eth.blockrazor.xyz',
+    'https://eth.drpc.org',
+    'https://ethereum.public.blockpi.network/v1/rpc/public',
+    'https://ethereum-public.nodies.app',
+    'https://0xrpc.io/eth',
+  ],
+  [Chain.PLASMA_MAINNET]: ['https://rpc.plasma.to', 'https://plasma.drpc.org'],
+  [Chain.SCROLL]: [
+    'https://rpc.scroll.io',
+    'https://1rpc.io/scroll',
+    'https://scroll.drpc.org',
+    'https://scroll.api.onfinality.io/public',
+    'https://endpoints.omniatech.io/v1/scroll/mainnet/public',
+    'https://scroll-rpc.publicnode.com',
+    'https://scroll.therpc.io',
+  ],
+  [Chain.SONIC_MAINNET]: [
+    'https://sonic.api.onfinality.io/public',
+    'https://sonic-rpc.publicnode.com',
+    'https://rpc.soniclabs.com',
+    'https://sonic.therpc.io',
+    'https://sonic.drpc.org',
+    'https://sonic-json-rpc.stakely.io',
+  ],
+  [Chain.KAIA_MAINNET]: [
+    'https://public-en.node.kaia.io',
+    'https://klaytn.api.onfinality.io/public',
+    'https://kaia-mainnet.gateway.tatum.io',
+    'https://kaia-public.nodies.app',
+    'https://kaia.blockpi.network/v1/rpc/public',
+    'https://rpc.ankr.com/kaia',
+    'https://klaytn.drpc.org',
+    'https://1rpc.io/klay',
+  ],
+  [Chain.MOONBEAM]: [
+    'https://moonbeam.unitedbloc.com',
+    'https://1rpc.io/glmr',
+    'https://moonbeam-rpc.dwellir.com',
+    'https://moonbeam-rpc.publicnode.com',
+    'https://moonbeam.drpc.org',
+    'https://endpoints.omniatech.io/v1/moonbeam/mainnet/public',
+    'https://rpc.api.moonbeam.network',
+    'https://rpc.poolz.finance/moonbeam',
+    'https://moonbeam.rpc.grove.city/v1/01fdb492',
+    'https://moonbeam.api.onfinality.io/public',
+  ],
+  [Chain.OP_MAINNET]: [
+    'https://optimism.public.blockpi.network/v1/rpc/public',
+    'https://optimism-rpc.publicnode.com',
+    'https://optimism.drpc.org',
+    'https://0xrpc.io/op',
+    'https://1rpc.io/op',
+    'wss://optimism-rpc.publicnode.com',
+    'wss://0xrpc.io/op',
+    'wss://optimism.drpc.org',
+    'https://optimism.api.onfinality.io/public',
+    'https://api.zan.top/opt-mainnet',
+  ],
+  [Chain.BNB_SMART_CHAIN_MAINNET]: [
+    'https://bsc-dataseed.bnbchain.org',
+    'https://binance.nodereal.io',
+    'https://bsc-mainnet.nodereal.io/v1/64a9df0874fb4a93b9d0a3849de012d3',
+    'wss://bsc-mainnet.nodereal.io/ws/v1/64a9df0874fb4a93b9d0a3849de012d3',
+    'https://bsc-dataseed.binance.org',
+    'https://bsc-dataseed1.binance.org',
+    'https://bsc-dataseed1.defibit.io',
+    'https://bsc-dataseed2.defibit.io',
+    'https://bsc-dataseed3.defibit.io',
+    'https://bsc-dataseed4.defibit.io',
+    'https://1rpc.io/bnb',
+    'https://bsc-rpc.publicnode.com',
+    'https://bsc.drpc.org',
+    'https://bsc.api.onfinality.io/public',
+  ],
+  [Chain.ARBITRUM_ONE]: [
+    'https://arb1.lava.build',
+    'https://arb1.arbitrum.io/rpc',
+    'https://arbitrum-one-rpc.publicnode.com',
+    'https://arbitrum.drpc.org',
+    'https://arbitrum.public.blockpi.network/v1/rpc/public',
+    'https://1rpc.io/arb',
+    'https://arbitrum.api.onfinality.io/public',
+    'https://0xrpc.io/arb',
+    'https://arbitrum.therpc.io',
+  ],
+  [Chain.LINEA]: [
+    'https://rpc.linea.build',
+    'https://1rpc.io/linea',
+    'https://linea.drpc.org',
+    'https://linea-rpc.publicnode.com',
+    'https://linea.decubate.com',
+    'https://linea.api.onfinality.io/public',
+  ],
+  [Chain.AVALANCHE_C_CHAIN]: [
+    'https://avalanche.drpc.org',
+    'https://1rpc.io/avax/c',
+    'https://avalanche-c-chain-rpc.publicnode.com',
+    'https://avalanche.api.onfinality.io/public/ext/bc/C/rpc',
+    'https://api.avax.network/ext/bc/C/rpc',
+    'https://avalanche.public-rpc.com',
+    'https://avax-rpc.gateway.pokt.network',
+  ],
+  [Chain.CELO_MAINNET]: [
+    'https://forno.celo.org',
+    'https://1rpc.io/celo',
+    'https://celo.drpc.org',
+    'https://celo-rpc.publicnode.com',
+  ],
+  [Chain.BLAST]: [
+    'https://rpc.blast.io',
+    'https://blast.drpc.org',
+    'https://blast-rpc.publicnode.com',
+  ],
+  [Chain.TAIKO_ALETHIA]: [
+    'https://rpc.taiko.xyz',
+    'https://rpc.ankr.com/taiko',
+    'https://rpc.mainnet.taiko.xyz',
+    'https://taiko-rpc.publicnode.com',
+  ],
+  [Chain.GNOSIS]: [
+    'https://gnosis.oat.farm',
+    'https://rpc.gnosischain.com',
+    'https://gnosis.drpc.org',
+    'https://gnosis-rpc.publicnode.com',
+    'https://1rpc.io/gnosis',
+  ],
+  [Chain.CORE_BLOCKCHAIN_MAINNET]: [
+    'https://rpc.coredao.org',
+    'https://core.drpc.org',
+    'https://core-rpc.publicnode.com',
+  ],
+  [Chain.MODE]: [
+    'https://mainnet.mode.network',
+    'https://mode.drpc.org',
+    'https://mode-rpc.publicnode.com',
+  ],
+  [Chain.METIS_ANDROMEDA_MAINNET]: [
+    'https://andromeda.metis.io/?owner=1088',
+    'https://metis.drpc.org',
+    'https://metis-rpc.publicnode.com',
+    'https://metis.api.onfinality.io/public',
+  ],
+  [Chain.FANTOM_OPERA]: [
+    'https://rpc.fantom.network',
+    'https://fantom.drpc.org',
+    'https://fantom-rpc.publicnode.com',
+    'https://1rpc.io/ftm',
+    'https://fantom.api.onfinality.io/public',
+  ],
+  [Chain.OPBNB_MAINNET]: [
+    'https://opbnb-mainnet.nodereal.io/v1/64a9df0874fb4a93b9d0a3849de012d3',
+    'wss://opbnb-mainnet.nodereal.io/ws/v1/64a9df0874fb4a93b9d0a3849de012d3',
+  ],
+  [Chain.X_LAYER_MAINNET]: ['https://xlayerrpc.okx.com'],
+  [Chain.MANTA_PACIFIC_MAINNET]: [
+    'https://manta.nirvanalabs.xyz/mantapublic',
+    'https://manta-pacific-gascap.calderachain.xyz/http',
+    'https://manta-pacific.calderachain.xyz/http',
+    'https://pacific-rpc.manta.network/http',
+    'https://r1.pacific.manta.systems/http',
+    'wss://manta-pacific.calderachain.xyz/ws',
+    'https://1rpc.io/manta',
+  ],
+  [Chain.SEI_NETWORK]: [
+    'https://evm-rpc.sei-apis.com',
+    'https://sei.drpc.org',
+    'https://sei-evm-rpc.stakeme.pro',
+    'https://sei-public.nodies.app',
+    'wss://sei.drpc.org',
+    'wss://evm-ws.sei-apis.com',
+  ],
+  [Chain.MONAD_MAINNET]: [
+    'https://rpc-mainnet.monadinfra.com',
+    'https://rpc.monad.xyz',
+    'https://rpc1.monad.xyz',
+    'https://rpc2.monad.xyz',
+    'https://rpc3.monad.xyz',
+    'https://rpc4.monad.xyz',
+  ],
+}

package/src/transport/transport.ts

@@ -0,0 +1,17 @@
+import { http, webSocket } from 'viem'
+
+export function createTransport(url: string, config?: any) {
+  if (!url) throw new Error('URL is required for transport')
+  const retryConfig = {
+    ...config,
+    retryCount: config?.retryCount ?? 0, // this is critical, especially for multicall failures where the reason for failure is rpc realted issues
+  }
+  if (url.startsWith('wss://')) {
+    return webSocket(url, retryConfig)
+  }
+  return http(url, retryConfig)
+}
+
+export function getTransport(url: string) {
+  return createTransport(url)
+}

package/src/utils/utils.ts

@@ -0,0 +1,55 @@
+export const DEFAULT_BATCH_SIZE = 4096
+
+export function trimTrailingSlash(url?: string) {
+  if (!url) return undefined
+  return url.endsWith('/') ? url.slice(0, -1) : url
+}
+
+export function deepCompare(a: any, b: any): boolean {
+  if (a === b) return true
+
+  if (a == null || b == null) return false
+
+  const typeA = typeof a
+  const typeB = typeof b
+
+  if (typeA !== typeB) return false
+
+  if (typeA === 'bigint') return false
+
+  if (typeA !== 'object') return false
+
+  const isArrayA = Array.isArray(a)
+  const isArrayB = Array.isArray(b)
+
+  if (isArrayA !== isArrayB) return false
+
+  if (isArrayA) {
+    if (a.length !== b.length) return false
+    for (let i = 0; i < a.length; i++) {
+      if (!deepCompare(a[i], b[i])) return false
+    }
+    return true
+  }
+
+  const keysA = Object.keys(a)
+  const keysB = Object.keys(b)
+
+  if (keysA.length !== keysB.length) return false
+
+  for (let i = 0; i < keysA.length; i++) {
+    const key = keysA[i]
+    if (!Object.prototype.hasOwnProperty.call(b, key)) return false
+    if (!deepCompare(a[key], b[key])) return false
+  }
+
+  return true
+}
+
+export function uniq<T>(array: T[]): T[] {
+  return [...new Set(array)]
+}
+
+export function isArray(value: any): boolean {
+  return Array.isArray(value)
+}