@1delta/providers 0.0.41 → 0.0.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1delta/providers",
-  "version": "0.0.41",
+  "version": "0.0.43",
   "description": "",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -17,14 +17,13 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "lodash": "^4.17.21",
+    "vitest": "^4.0.18",
     "@1delta/chain-registry": "0.0.4",
-    "@1delta/data-sdk": "0.0.11"
+    "@1delta/data-sdk": "0.0.14"
   },
   "devDependencies": {
-    "@types/lodash": "^4.17.21",
-    "typescript": "^5.9.3",
-    "tsup": "^8.5.1"
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts",

package/src/chains/chainMapping.ts

@@ -0,0 +1,314 @@
+import { Chain } from '@1delta/chain-registry'
+import {
+  mantle,
+  mainnet,
+  optimism,
+  arbitrum,
+  bsc,
+  avalanche,
+  taiko,
+  metis,
+  polygon,
+  zksync,
+  scroll,
+  gnosis,
+  base,
+  blast,
+  kaia,
+  opBNB,
+  fantom,
+  sonic,
+  linea,
+  hemi,
+  neonMainnet,
+  degen,
+  gravity,
+  lightlinkPhoenix,
+  plume,
+  abstract,
+  peaq,
+  flowMainnet,
+  soneium,
+  goat,
+  berachain,
+  rootstock,
+  ink,
+  vanar,
+  fuse,
+  superposition,
+  story,
+  apeChain,
+  telos,
+  flare,
+  aurora,
+  kava,
+  iota,
+  coreDao,
+  unichain,
+  mode,
+  xLayer,
+  zircuit,
+  corn,
+  bob,
+  manta,
+  harmonyOne,
+  celo,
+  bitlayer,
+  merlin,
+  sei,
+  iotex,
+  bsquared,
+  zetachain,
+  ronin,
+  inEVM,
+  pulsechain,
+  xdc,
+  cronos,
+  cronoszkEVM,
+  taraxa,
+  meter,
+  morph,
+  moonbeam,
+  zkLinkNova,
+  vana,
+} from 'viem/chains'
+import { customChains, katana, plasma } from './customChains'
+
+export function getEvmChain(chain: string) {
+  switch (chain) {
+    case Chain.ARBITRUM_ONE:
+      return arbitrum
+    case Chain.ETHEREUM_MAINNET:
+      return mainnet
+    case Chain.MANTLE:
+      return mantle
+    case Chain.BNB_SMART_CHAIN_MAINNET:
+      return bsc
+    case Chain.OPBNB_MAINNET:
+      return opBNB
+    case Chain.TAIKO_ALETHIA:
+      return taiko
+    case Chain.AVALANCHE_C_CHAIN:
+      return avalanche
+    case Chain.OP_MAINNET:
+      return optimism
+    case Chain.METIS_ANDROMEDA_MAINNET:
+      return metis
+    case Chain.POLYGON_MAINNET:
+      return polygon
+    case Chain.ZKSYNC_MAINNET:
+      return zksync
+    case Chain.SCROLL:
+      return scroll
+    case Chain.GNOSIS:
+      return gnosis
+    case Chain.BASE:
+      return base
+    case Chain.BLAST:
+      return blast
+    case Chain.KAIA_MAINNET:
+      return kaia
+    case Chain.FANTOM_OPERA:
+      return fantom
+    case Chain.SONIC_MAINNET:
+      return sonic
+    case Chain.LINEA:
+      return linea
+    case Chain.HEMI_NETWORK:
+      return {
+        ...hemi,
+        contracts: {
+          multicall3: {
+            address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+            blockCreated: 1,
+          },
+        },
+      }
+    case Chain.NEON_EVM_MAINNET:
+      return neonMainnet
+    case Chain.DEGEN_CHAIN:
+      return {
+        ...degen,
+        contracts: {
+          multicall3: {
+            address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+            blockCreated: 1,
+          },
+        },
+      }
+    case Chain.GRAVITY_ALPHA_MAINNET:
+      return gravity
+    case Chain.LIGHTLINK_PHOENIX_MAINNET:
+      return lightlinkPhoenix
+    case Chain.PLUME_MAINNET:
+      return plume
+    case Chain.ABSTRACT:
+      return abstract
+    case Chain.PEAQ:
+      return peaq
+    case Chain.EVM_ON_FLOW:
+      return flowMainnet
+    case Chain.SONEIUM:
+      return soneium
+    case Chain.GOAT_NETWORK:
+      return goat
+    case Chain.BERACHAIN:
+      return berachain
+    case Chain.ROOTSTOCK_MAINNET:
+      return rootstock
+    case Chain.VANAR_MAINNET:
+      return vanar
+    case Chain.INK:
+      return {
+        ...ink,
+        contracts: {
+          multicall3: {
+            address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+            blockCreated: 1,
+          },
+        },
+      }
+    case Chain.FUSE_MAINNET:
+      return fuse
+    case Chain.SUPERPOSITION:
+      return superposition
+    case Chain.STORY:
+      return {
+        ...story,
+        contracts: {
+          multicall3: {
+            address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+            blockCreated: 1,
+          },
+        },
+      }
+    case Chain.APECHAIN:
+      return apeChain
+    case Chain.IOTEX_NETWORK_MAINNET:
+      return iotex
+    case Chain.TELOS_EVM_MAINNET:
+      return telos
+    case Chain.FLARE_MAINNET:
+      return flare
+    case Chain.AURA_MAINNET:
+      return aurora
+    case Chain.KAVA:
+      return kava
+    case Chain.IOTA_EVM:
+      return iota
+    case Chain.AURORA_MAINNET:
+      return aurora
+    case Chain.UNICHAIN:
+      return unichain
+    case Chain.CORE_BLOCKCHAIN_MAINNET:
+      return coreDao
+    case Chain.MODE:
+      return mode
+    case Chain.CORN:
+      return corn
+    case Chain.BOB:
+      return bob
+    case Chain.RONIN_MAINNET:
+      return ronin
+    case Chain.MANTA_PACIFIC_MAINNET:
+      return manta
+    case Chain.ZIRCUIT_MAINNET:
+      return zircuit
+    case Chain.GRAPHLINQ_BLOCKCHAIN_MAINNET:
+      return customChains.GraphLinq
+    case Chain.ZETACHAIN_MAINNET:
+      return zetachain
+    case Chain.BITLAYER_MAINNET:
+      return bitlayer
+    case Chain.CROSSFI_MAINNET:
+      return customChains.crossfi
+    case Chain.INEVM_MAINNET:
+      return inEVM
+    case Chain.XDC_NETWORK:
+      return xdc
+    case Chain.CRONOS_MAINNET:
+      return cronos
+    case Chain.CRONOS_ZKEVM_MAINNET:
+      return cronoszkEVM
+    case Chain.B2_MAINNET:
+      return {
+        ...bsquared,
+        contracts: {
+          multicall3: {
+            address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+            blockCreated: 1,
+          },
+        },
+      }
+    case Chain.SEI_NETWORK:
+      return sei
+    case Chain.MERLIN_MAINNET:
+      return {
+        ...merlin,
+        contracts: {
+          multicall3: {
+            address: '0x46063722c010AF39E465d286B84936A12aFb81F0',
+            blockCreated: 1,
+          },
+        },
+      }
+    case Chain.X_LAYER_MAINNET:
+      return xLayer
+    case Chain.CELO_MAINNET:
+      return celo
+    case Chain.BOTANIX_MAINNET:
+      return customChains.botanix
+    case Chain.HARMONY_MAINNET_SHARD_0:
+      return harmonyOne
+    case Chain.HYPEREVM:
+      return customChains.hyperEvm
+    case Chain.KATANA:
+      return katana
+    case Chain.TARAXA_MAINNET:
+      return {
+        ...taraxa,
+        contracts: {
+          multicall3: {
+            address: '0xca11bde05977b3631167028862be2a173976ca11',
+            blockCreated: 1,
+          },
+        },
+      }
+    case Chain.METER_MAINNET:
+      return {
+        ...meter,
+        contracts: {
+          multicall3: {
+            address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+            blockCreated: 1,
+          },
+        },
+      }
+    case Chain.ARTELA_MAINNET:
+      return customChains.artela
+    case Chain.MORPH:
+      return morph
+    case Chain.VANA:
+      return vana
+    case Chain.PULSECHAIN:
+      return pulsechain
+    case Chain.PLASMA_MAINNET:
+      return plasma
+    case Chain.MOONBEAM:
+      return moonbeam
+    case Chain.MONAD_MAINNET:
+      return customChains.monadMainnet
+    case Chain.ZKLINK_NOVA_MAINNET:
+      return {
+        ...zkLinkNova,
+        contracts: {
+          multicall3: {
+            address: '0x825267E0fA5CAe92F98540828a54198dcB3Eaeb5',
+            blockCreated: 1,
+          },
+        },
+      }
+    default:
+      throw new Error('Not in VIEM: ' + chain)
+  }
+}

package/src/chains/customChains.ts

@@ -0,0 +1,202 @@
+import { defineChain } from 'viem'
+
+const crossfi = defineChain({
+  id: 4158,
+  name: 'CrossFi Mainet',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'XFI',
+    symbol: 'XFI',
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.mainnet.ms/'],
+    },
+  },
+  blockExplorers: {
+    default: { name: 'Explorer', url: 'https://xfiscan.com/' },
+  },
+})
+
+const botanix = defineChain({
+  id: 3637,
+  name: 'Botanix',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'BTC',
+    symbol: 'BTC',
+  },
+  rpcUrls: {
+    default: {
+      http: [
+        'https://rpc.ankr.com/botanix_mainnet',
+        'https://rpc.botanixlabs.com',
+      ],
+    },
+  },
+  blockExplorers: {
+    default: { name: 'Explorer', url: 'https://botanixscan.io/' },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 1,
+    },
+  },
+})
+
+const hyperEvm = defineChain({
+  id: 999,
+  name: 'Hyper EVM',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'HYPE',
+    symbol: 'HYPE',
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.hyperliquid.xyz/evm'],
+    },
+  },
+  blockExplorers: {
+    default: { name: 'Explorer', url: 'https://hypurrscan.io/' },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 1,
+    },
+  },
+})
+
+export const katana = defineChain({
+  id: 747474,
+  name: 'Katana',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'Ether',
+    symbol: 'ETH',
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.katana.network'],
+      webSocket: [],
+    },
+  },
+  blockExplorers: {
+    default: { name: 'Explorer', url: 'https://katanascan.com/' },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 0,
+    },
+  },
+})
+
+const GraphLinq = defineChain({
+  id: 614,
+  name: 'GraphLinq Chain',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'GLQ',
+    symbol: 'GLQ',
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://glq-dataseed.graphlinq.io'],
+    },
+  },
+  blockExplorers: {
+    default: { name: 'Explorer', url: 'https://explorer.graphlinq.io' },
+  },
+})
+
+const artela = defineChain({
+  id: 11820,
+  name: 'Artela Mainnet',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'ART',
+    symbol: 'ART',
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://node-euro.artela.network/rpc'],
+    },
+  },
+  blockExplorers: {
+    default: { name: 'Explorer', url: 'https://artscan.artela.network' },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 1,
+    },
+  },
+})
+
+export const plasma = defineChain({
+  id: 9745,
+  name: 'Plasma Mainnet',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'XPL',
+    symbol: 'XPL',
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.plasma.to'],
+    },
+  },
+  blockExplorers: {
+    default: { name: 'Explorer', url: 'https://plasmascan.to/' },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 1,
+    },
+  },
+})
+
+const monadMainnet = defineChain({
+  id: 143,
+  name: 'Monad Mainnet',
+  network: 'monad',
+  nativeCurrency: {
+    name: 'Monad',
+    symbol: 'MON',
+    decimals: 18,
+  },
+  blockExplorers: {
+    default: { name: 'Explorer', url: 'https://monadvision.com/' },
+  },
+  rpcUrls: {
+    default: {
+      http: [
+        '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',
+      ],
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 1,
+    },
+  },
+})
+
+export const customChains = {
+  artela,
+  botanix,
+  crossfi,
+  GraphLinq,
+  hyperEvm,
+  monadMainnet,
+} as const

package/src/client/client.ts

@@ -0,0 +1,110 @@
+import { chains } from '@1delta/data-sdk'
+import { createPublicClient, PublicClient } from 'viem'
+import { getEvmChain } from '../chains/chainMapping'
+import { LIST_OVERRIDES } from '../rpc/rpcOverrides'
+import { createTransport } from '../transport/transport'
+import { trimTrailingSlash, uniq } from '../utils/utils'
+
+function getEvmClientInternal(chain: string, rpcId = 0): PublicClient {
+  const chainInfo = getEvmChain(chain)
+  let rpc: string
+  if (rpcId === 0)
+    rpc = chainInfo.rpcUrls.default.http[0] ?? LIST_OVERRIDES[chain]?.[0]
+  else {
+    const rpcsChain = (LIST_OVERRIDES[chain] ??
+      chains()?.[chain]?.rpc ??
+      []) as any[]
+    const rpcs = chainInfo.rpcUrls.default.http.map((a) => trimTrailingSlash(a))
+    const rpcsAdded = rpcsChain.map((a) => trimTrailingSlash(a))
+    const allRpcs = uniq([...rpcsAdded, ...rpcs])
+    const currId = Math.min(allRpcs.length - 1, rpcId)
+    rpc = allRpcs[currId] as any
+  }
+  if (!rpc)
+    throw new Error('Failed to get RPC at index ' + rpcId + ' for ' + chain)
+  return createPublicClient({
+    chain: chainInfo as any,
+    transport: createTransport(rpc),
+  }) as any
+}
+
+export function getEvmClient(chain: string, rpcId = 0): PublicClient {
+  return getEvmClientInternal(chain, rpcId)
+}
+
+export function getEvmClientUniversal({
+  chain,
+  rpcId = 0,
+}: {
+  chain: string
+  rpcId: number
+}): PublicClient {
+  return getEvmClientInternal(chain, rpcId)
+}
+
+function getEvmClientWithCustomRpcsInternal(
+  chain: string,
+  rpcId = 0,
+  customRpcs: Record<string, string[]> = LIST_OVERRIDES,
+): PublicClient {
+  const chainInfo = getEvmChain(chain)
+  let rpc: string
+
+  if (customRpcs && customRpcs[chain]) {
+    const customRpcList = uniq(
+      customRpcs[chain]
+        .filter(Boolean)
+        .map((url) => trimTrailingSlash(url))
+        .filter((url): url is string => Boolean(url)),
+    )
+
+    if (customRpcList.length === 0) {
+      throw new Error(`No valid custom RPCs provided for chain ${chain}`)
+    }
+
+    rpc = customRpcList[rpcId % customRpcList.length]
+  } else {
+    if (rpcId === 0)
+      rpc = chainInfo.rpcUrls.default.http[0] ?? LIST_OVERRIDES[chain]?.[0]
+    else {
+      const rpcsChain = (chains()?.[chain]?.rpc ?? []) as any[]
+      const rpcs = chainInfo.rpcUrls.default.http.map((a) =>
+        trimTrailingSlash(a),
+      )
+      const rpcsAdded = rpcsChain.map((a) => trimTrailingSlash(a))
+      const allRpcs = uniq([...rpcs, ...rpcsAdded])
+      const currId = Math.min(allRpcs.length - 1, rpcId)
+      rpc = allRpcs[currId] as any
+    }
+  }
+  if (!rpc)
+    throw new Error('Failed to get RPC at index ' + rpcId + ' for ' + chain)
+  return createPublicClient({
+    chain: chainInfo as any,
+    transport: createTransport(rpc),
+  }) as any
+}
+
+/**
+ * @deprecated use getEvmClientWithCustomRpcsUniversal instead
+ * @see getEvmClientWithCustomRpcsUniversal
+ */
+export function getEvmClientWithCustomRpcs(
+  chain: string,
+  rpcId = 0,
+  customRpcs: Record<string, string[]> = LIST_OVERRIDES,
+): PublicClient {
+  return getEvmClientWithCustomRpcsInternal(chain, rpcId, customRpcs)
+}
+
+export function getEvmClientWithCustomRpcsUniversal({
+  chain,
+  rpcId = 0,
+  customRpcs = LIST_OVERRIDES,
+}: {
+  chain: string
+  rpcId: number
+  customRpcs: Record<string, string[]>
+}): PublicClient {
+  return getEvmClientWithCustomRpcsInternal(chain, rpcId, customRpcs)
+}