@0xtorch/evm 0.0.1

package/src/chains/definitions/bsc.ts

@@ -0,0 +1,182 @@
+import { bnb } from '@0xtorch/core'
+import { bsc } from 'viem/chains'
+import type { Client } from '../../clients'
+import { createViemClient } from '../../clients'
+import type { Explorer } from '../../explorers'
+import { createEtherscan } from '../../explorers'
+import type { Chain, HttpRpc } from '../types'
+import { defineChain } from './defineChain'
+
+export const createBscChain = (bscscanApiKey: string): Chain =>
+  createBscChainCustom({
+    client: createViemClient({
+      chain: bsc,
+      httpRpcs: bscHttpRpcs,
+    }),
+    explorer: createEtherscan({
+      name: 'BscScan',
+      url: 'https://bscscan.com',
+      apiUrl: 'https://api.bscscan.com/api',
+      apiKey: bscscanApiKey,
+    }),
+  })
+
+type CreateBscParameters<TClient extends Client, TExplorer extends Explorer> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createBscChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateBscParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 56,
+    network: 'bsc',
+    name: 'BNB Smart Chain',
+    nativeToken: {
+      name: 'BNB',
+      symbol: 'BNB',
+      decimals: 18,
+      currency: bnb,
+    },
+    explorer,
+    client,
+    blockTime: 3000,
+    coingeckoId: 'binance-smart-chain',
+    defillamaId: 'bsc',
+  })
+
+export const bscHttpRpcs = [
+  {
+    url: 'https://bsc-dataseed.bnbchain.org/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://bsc-dataseed1.defibit.io/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://bsc-dataseed1.ninicoin.io/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://bsc-dataseed2.defibit.io/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://bsc-dataseed3.defibit.io/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://bsc-dataseed4.defibit.io/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://bsc-dataseed2.ninicoin.io/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://bsc-dataseed3.ninicoin.io/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://bsc-dataseed4.ninicoin.io/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://bsc-dataseed1.bnbchain.org/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://bsc-dataseed2.bnbchain.org/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://bsc-dataseed3.bnbchain.org/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://bsc-dataseed4.bnbchain.org/',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://endpoints.omniatech.io/v1/bsc/mainnet/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://bsc-mainnet.nodereal.io/v1/64a9df0874fb4a93b9d0a3849de012d3',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 50_000n,
+  },
+  {
+    url: 'https://rpc.ankr.com/bsc',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://bscrpc.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://binance.nodereal.io',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://1rpc.io/bnb',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2000n,
+  },
+  {
+    url: 'https://bnb.api.onfinality.io/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2000n,
+  },
+  {
+    url: 'https://bsc.drpc.org',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 5000n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const bscWebsocketRpcUrls = ['wss://bsc.publicnode.com'] as const

package/src/chains/definitions/defineChain.ts

@@ -0,0 +1,7 @@
+import type { Chain } from '..'
+
+export const defineChain = <const TChain extends Chain>(
+  chain: TChain,
+): TChain => ({
+  ...chain,
+})

package/src/chains/definitions/ethereum.test.ts

@@ -0,0 +1,50 @@
+import { expect, it } from 'bun:test'
+import { createPublicClient, http } from 'viem'
+import { mainnet } from 'viem/chains'
+import { ethereumHttpRpcs } from './ethereum'
+import { sendMsgEvent as sendMessageEvent } from './tests'
+
+it('Should all ethereumHttpRpcs be the rpc url of the archive node', async () => {
+  for (const rpc of ethereumHttpRpcs) {
+    const { url, isArchive, getLogsIsUsable, getLogsMaxBlockRange } = rpc
+    console.debug('Checking >', url)
+    const client = createPublicClient({
+      chain: mainnet,
+      transport: http(url),
+    })
+
+    // get latest block number
+    const blockNumber = await client.getBlockNumber()
+    console.debug('Result getBlockNumber >', blockNumber)
+    expect(blockNumber).toBeGreaterThan(0n)
+
+    // archive
+    // - getTransactionReceipt
+    // - getBlock
+    if (isArchive) {
+      const hash =
+        '0x194f62e36b7d116de81de26712aded5e054d214fcfc2f44355e584f38f9d2f6f'
+      const blockNumber = 18_917_221n
+      const receipt = await client.getTransactionReceipt({ hash })
+      console.debug('Result getTransactionReceipt >', receipt.status)
+      const block = await client.getBlock({ blockNumber })
+      console.debug('Result getBlock >', block.timestamp)
+      expect(receipt.transactionHash).toEqual(hash)
+      expect(block.number).toEqual(blockNumber)
+    }
+
+    // getLogs
+    if (getLogsIsUsable) {
+      const toBlock = blockNumber - 5n
+      const fromBlock = toBlock - getLogsMaxBlockRange + 1n
+      const logs = await client.getLogs({
+        address: '0x296f55f8fb28e498b858d0bcda06d955b2cb3f97',
+        event: sendMessageEvent,
+        fromBlock,
+        toBlock,
+      })
+      console.debug('Result getLogs >', logs.length)
+      expect(logs).toBeDefined()
+    }
+  }
+}, 60_000)

package/src/chains/definitions/ethereum.ts

@@ -0,0 +1,169 @@
+import { ethereum } from '@0xtorch/core'
+import { mainnet } from 'viem/chains'
+import type { Client } from '../../clients'
+import { createViemClient } from '../../clients'
+import type { Explorer } from '../../explorers'
+import { createEtherscan } from '../../explorers'
+import type { Chain, HttpRpc } from '../types'
+import { defineChain } from './defineChain'
+
+export const createEthereumChain = (etherscanApiKey: string): Chain =>
+  createEthereumChainCustom({
+    client: createViemClient({
+      chain: mainnet,
+      httpRpcs: ethereumHttpRpcs,
+    }),
+    explorer: createEtherscan({
+      name: 'Etherscan',
+      url: 'https://etherscan.io',
+      apiUrl: 'https://api.etherscan.io/api',
+      apiKey: etherscanApiKey,
+    }),
+  })
+
+type CreateEthereumChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createEthereumChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateEthereumChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 1,
+    network: 'ethereum',
+    name: 'Ethereum',
+    nativeToken: {
+      name: 'Ethereum',
+      symbol: 'ETH',
+      decimals: 18,
+      currency: ethereum,
+    },
+    explorer,
+    client,
+    blockTime: 12_000,
+    coingeckoId: 'ethereum',
+    defillamaId: 'ethereum',
+  })
+
+export const ethereumHttpRpcs = [
+  {
+    url: 'https://endpoints.omniatech.io/v1/eth/mainnet/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 8000n,
+  },
+  {
+    url: 'https://rpc.ankr.com/eth',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://go.getblock.io/d7dab8149ec04390aaa923ff2768f914',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+  {
+    url: 'https://eth-mainnet.nodereal.io/v1/1659dfb40aa24bbb8153a677b98064d7',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 50_000n,
+  },
+  {
+    url: 'https://1rpc.io/eth',
+    isArchive: false,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://rpc.mevblocker.io',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://rpc.flashbots.net/',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 40_000n,
+  },
+  {
+    url: 'https://eth-pokt.nodies.app',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://ethereum.blockpi.network/v1/rpc/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 1024n,
+  },
+  {
+    url: 'https://eth.api.onfinality.io/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2000n,
+  },
+  {
+    url: 'https://core.gashawk.io/rpc',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+  {
+    url: 'https://rpc.eth.gateway.fm',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://eth.drpc.org',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://mainnet.gateway.tenderly.co',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+  {
+    url: 'https://gateway.tenderly.co/public/mainnet',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+  {
+    url: 'https://rpc.notadegen.com/eth',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+  {
+    url: 'https://eth.merkle.io',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://eth.llamarpc.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const ethereumWebsocketRpcUrls = [
+  'wss://ethereum.publicnode.com',
+] as const

package/src/chains/definitions/fantom.test.ts

@@ -0,0 +1,50 @@
+import { expect, it } from 'bun:test'
+import { createPublicClient, http } from 'viem'
+import { fantom } from 'viem/chains'
+import { fantomHttpRpcs } from './fantom'
+import { sendMsgEvent as sendMessageEvent } from './tests'
+
+it('Should all fantomHttpRpcs be the rpc url of the archive node', async () => {
+  for (const rpc of fantomHttpRpcs) {
+    const { url, isArchive, getLogsIsUsable, getLogsMaxBlockRange } = rpc
+    console.debug('Checking >', url)
+    const client = createPublicClient({
+      chain: fantom,
+      transport: http(url),
+    })
+
+    // get latest block number
+    const blockNumber = await client.getBlockNumber()
+    console.debug('Result getBlockNumber >', blockNumber)
+    expect(blockNumber).toBeGreaterThan(0n)
+
+    // archive
+    // - getTransactionReceipt
+    // - getBlock
+    if (isArchive) {
+      const hash =
+        '0xe2c22056d5ee8bbdbe29e3794d04f3cf81767376759ccf4e0af2b2b461ca2328'
+      const blockNumber = 34_078_237n
+      const receipt = await client.getTransactionReceipt({ hash })
+      console.debug('Result getTransactionReceipt >', receipt.status)
+      const block = await client.getBlock({ blockNumber })
+      console.debug('Result getBlock >', block.timestamp)
+      expect(receipt.transactionHash).toEqual(hash)
+      expect(block.number).toEqual(blockNumber)
+    }
+
+    // getLogs
+    if (getLogsIsUsable) {
+      const toBlock = blockNumber - 5n
+      const fromBlock = toBlock - getLogsMaxBlockRange + 1n
+      const logs = await client.getLogs({
+        address: '0x45a01e4e04f14f7a4a6702c74187c5f6222033cd',
+        event: sendMessageEvent,
+        fromBlock,
+        toBlock,
+      })
+      console.debug('Result getLogs >', logs.length)
+      expect(logs).toBeDefined()
+    }
+  }
+}, 60_000)

package/src/chains/definitions/fantom.ts

@@ -0,0 +1,123 @@
+import { fantom } from '@0xtorch/core'
+import { fantom as viemFantom } from 'viem/chains'
+import type { Client } from '../../clients'
+import { createViemClient } from '../../clients'
+import type { Explorer } from '../../explorers'
+import { createEtherscan } from '../../explorers'
+import type { Chain, HttpRpc } from '../types'
+import { defineChain } from './defineChain'
+
+export const createFantomChain = (ftmscanApiKey: string): Chain =>
+  createFantomChainCustom({
+    client: createViemClient({
+      chain: viemFantom,
+      httpRpcs: fantomHttpRpcs,
+    }),
+    explorer: createEtherscan({
+      name: 'FTMScan',
+      url: 'https://ftmscan.com',
+      apiUrl: 'https://api.ftmscan.com/api',
+      apiKey: ftmscanApiKey,
+    }),
+  })
+
+type CreateFantomChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createFantomChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateFantomChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 250,
+    network: 'fantom',
+    name: 'Fantom',
+    nativeToken: {
+      name: 'Fantom',
+      symbol: 'FTM',
+      decimals: 18,
+      currency: fantom,
+    },
+    explorer,
+    client,
+    blockTime: undefined,
+    coingeckoId: 'fantom',
+    defillamaId: 'fantom',
+  })
+
+export const fantomHttpRpcs = [
+  {
+    url: 'https://rpc.ankr.com/fantom/',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://rpcapi.fantom.network',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+  {
+    url: 'https://rpc.ftm.tools/',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://1rpc.io/ftm',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://fantom.publicnode.com/',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 40_000n,
+  },
+  {
+    url: 'https://fantom.blockpi.network/v1/rpc/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 1024n,
+  },
+  {
+    url: 'https://fantom.drpc.org/',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 4000n,
+  },
+  {
+    url: 'https://endpoints.omniatech.io/v1/fantom/mainnet/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://fantom.rpc.thirdweb.com/',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 50_000n,
+  },
+  {
+    url: 'https://fantom-pokt.nodies.app',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 50_000n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const fantomWebsocketRpcUrls = [
+  'wss://wsapi.fantom.network/',
+  'wss://fantom-mainnet.public.blastapi.io/',
+  'wss://fantom.publicnode.com',
+] as const

package/src/chains/definitions/index.ts

@@ -0,0 +1,88 @@
+export {
+  arbitrumOneHttpRpcs,
+  arbitrumOneWebsocketRpcUrls,
+  createArbitrumOneChain,
+  createArbitrumOneChainCustom,
+} from './arbitrumOne'
+export {
+  astarHttpRpcs,
+  astarWebsocketRpcUrls,
+  createAstarChain,
+  createAstarChainCustom,
+} from './astar'
+export {
+  avalancheCHttpRpcs,
+  avalancheCWebsocketRpcUrls,
+  createAvalancheCChain,
+  createAvalancheCChainCustom,
+} from './avalancheC'
+export {
+  baseHttpRpcs,
+  baseWebsocketRpcUrls,
+  createBaseChain,
+  createBaseChainCustom,
+} from './base'
+export {
+  bscHttpRpcs,
+  bscWebsocketRpcUrls,
+  createBscChain,
+  createBscChainCustom,
+} from './bsc'
+export {
+  createEthereumChain,
+  createEthereumChainCustom,
+  ethereumHttpRpcs,
+  ethereumWebsocketRpcUrls,
+} from './ethereum'
+export {
+  createFantomChain,
+  createFantomChainCustom,
+  fantomHttpRpcs,
+  fantomWebsocketRpcUrls,
+} from './fantom'
+export {
+  createLineaChain,
+  createLineaChainCustom,
+  lineaHttpRpcs,
+  lineaWebsocketRpcUrls,
+} from './linea'
+export {
+  createMantleChainCustom,
+  mantleHttpRpcs,
+  mantleWebsocketRpcUrls,
+} from './mantle'
+export {
+  createMetisChainCustom,
+  metisHttpRpcs,
+  metisWebsocketRpcUrls,
+} from './metis'
+export {
+  createMoonbeamChain,
+  createMoonbeamChainCustom,
+  moonbeamHttpRpcs,
+  moonbeamWebsocketRpcUrls,
+} from './moonbeam'
+export {
+  createMoonriverChain,
+  createMoonriverChainCustom,
+  moonriverHttpRpcs,
+  moonriverWebsocketRpcUrls,
+} from './moonriver'
+export {
+  createOptimismChain,
+  createOptimismChainCustom,
+  optimismHttpRpcs,
+  optimismWebsocketRpcUrls,
+} from './optimism'
+export {
+  createPolygonPosChain,
+  createPolygonPosChainCustom,
+  polygonPosHttpRpcs,
+  polygonPosWebsocketRpcUrls,
+} from './polygonPos'
+export {
+  createRoninChain,
+  createRoninChainCustom,
+  roninHttpRpcs,
+  roninWebsocketRpcUrls,
+} from './ronin'