@0xtorch/evm 0.0.1

package/src/chains/definitions/arbitrumOne.ts

@@ -0,0 +1,133 @@
+import { ethereum } from '@0xtorch/core'
+import { arbitrum } 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 createArbitrumOneChain = (arbiscanApiKey: string): Chain =>
+  createArbitrumOneChainCustom({
+    client: createViemClient({
+      chain: arbitrum,
+      httpRpcs: arbitrumOneHttpRpcs,
+    }),
+    explorer: createEtherscan({
+      name: 'ArbiScan',
+      url: 'https://arbiscan.io',
+      apiUrl: 'https://api.arbiscan.io/api',
+      apiKey: arbiscanApiKey,
+    }),
+  })
+
+type CreateArbitrumOneChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createArbitrumOneChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateArbitrumOneChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 42_161,
+    network: 'arbitrum-one',
+    name: 'Arbitrum One',
+    nativeToken: {
+      name: 'Ethereum',
+      symbol: 'ETH',
+      decimals: 18,
+      currency: ethereum,
+    },
+    explorer,
+    client,
+    blockTime: 250,
+    coingeckoId: 'arbitrum-one',
+    defillamaId: 'arbitrum',
+  })
+
+export const arbitrumOneHttpRpcs = [
+  {
+    url: 'https://arbitrum.llamarpc.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 80_000n,
+  },
+  {
+    url: 'https://arb1.arbitrum.io/rpc',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 160_000n,
+  },
+  {
+    url: 'https://rpc.ankr.com/arbitrum',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://1rpc.io/arb',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://arb-pokt.nodies.app',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 80_000n,
+  },
+  {
+    url: 'https://arbitrum.blockpi.network/v1/rpc/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 1024n,
+  },
+  {
+    url: 'https://endpoints.omniatech.io/v1/arbitrum/one/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://arb-mainnet-public.unifra.io',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://arbitrum.api.onfinality.io/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2000n,
+  },
+  {
+    url: 'https://rpc.arb1.arbitrum.gateway.fm',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://arbitrum-one.publicnode.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 40_000n,
+  },
+  {
+    url: 'https://arbitrum.meowrpc.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 40_000n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const arbitrumOneWebsocketRpcUrls = [
+  'wss://arbitrum-one.publicnode.com',
+] as const

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

@@ -0,0 +1,51 @@
+import { expect, it } from 'bun:test'
+import { createPublicClient, http } from 'viem'
+import { astar } from 'viem/chains'
+import { astarHttpRpcs } from './astar'
+import { relayEvent } from './tests'
+
+it('Should all astarHttpRpcs be the rpc url of the archive node', async () => {
+  for (const rpc of astarHttpRpcs) {
+    const { url, isArchive, getLogsIsUsable, getLogsMaxBlockRange } = rpc
+    console.debug('Checking >', url)
+    const client = createPublicClient({
+      chain: astar,
+      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 =
+        '0xd28d2d02d86f11a1ed6d83c102cd0b4e6ec9dc58a028e00f8e9d57138cdbb4a8'
+      const blockNumber = 2_579_366n
+      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
+    // getLogs
+    if (getLogsIsUsable) {
+      const toBlock = blockNumber - 5n
+      const fromBlock = toBlock - getLogsMaxBlockRange + 1n
+      const logs = await client.getLogs({
+        address: '0x841ce48F9446C8E281D3F1444cB859b4A6D0738C',
+        event: relayEvent,
+        fromBlock,
+        toBlock,
+      })
+      console.debug('Result getLogs >', logs.length)
+      expect(logs).toBeDefined()
+    }
+  }
+}, 60_000)

package/src/chains/definitions/astar.ts

@@ -0,0 +1,93 @@
+import { astar } from '@0xtorch/core'
+import { astar as viemAstar } from 'viem/chains'
+import type { Client } from '../../clients'
+import { createViemClient } from '../../clients'
+import type { Explorer } from '../../explorers'
+import { createBlockscout } from '../../explorers'
+import type { Chain, HttpRpc } from '../types'
+import { defineChain } from './defineChain'
+
+type CreateAstarChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createAstarChain = (): Chain =>
+  createAstarChainCustom({
+    client: createViemClient({
+      chain: viemAstar,
+      httpRpcs: astarHttpRpcs,
+    }),
+    explorer: createBlockscout({
+      name: 'Astar explorer',
+      url: 'https://astar.blockscout.com',
+      apiUrl: 'https://astar.blockscout.com/api',
+    }),
+  })
+
+export const createAstarChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateAstarChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 592,
+    network: 'astar-evm',
+    name: 'Astar (EVM)',
+    nativeToken: {
+      name: 'Astar',
+      symbol: 'ASTR',
+      decimals: 18,
+      currency: astar,
+    },
+    explorer,
+    client,
+    blockTime: 12_000,
+    coingeckoId: 'astar',
+    defillamaId: 'astar',
+  })
+
+export const astarHttpRpcs = [
+  {
+    url: 'https://evm.astar.network/',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+  {
+    url: 'https://astar.public.blastapi.io',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://astar.api.onfinality.io/public',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://astar-rpc.dwellir.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://1rpc.io/astr',
+    isArchive: false,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const astarWebsocketRpcUrls = [
+  'wss://rpc.astar.network',
+  'wss://astar.public.blastapi.io',
+  'wss://astar.api.onfinality.io/public-ws',
+  'wss://astar-rpc.dwellir.com',
+] as const

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

@@ -0,0 +1,50 @@
+import { expect, it } from 'bun:test'
+import { createPublicClient, http } from 'viem'
+import { avalanche } from 'viem/chains'
+import { avalancheCHttpRpcs } from './avalancheC'
+import { sendMsgEvent as sendMessageEvent } from './tests'
+
+it('Should all avalancheCHttpRpcs be the rpc url of the archive node', async () => {
+  for (const rpc of avalancheCHttpRpcs) {
+    const { url, isArchive, getLogsIsUsable, getLogsMaxBlockRange } = rpc
+    console.debug('Checking >', url)
+    const client = createPublicClient({
+      chain: avalanche,
+      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 =
+        '0x7a3751bb732d4e1676967237627c3f1cabaf4cede5b97865cfb7d2936f2954ee'
+      const blockNumber = 20_249_733n
+      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: '0x9d1b1669c73b033dfe47ae5a0164ab96df25b944',
+        event: sendMessageEvent,
+        fromBlock,
+        toBlock,
+      })
+      console.debug('Result getLogs >', logs.length)
+      expect(logs).toBeDefined()
+    }
+  }
+}, 60_000)

package/src/chains/definitions/avalancheC.ts

@@ -0,0 +1,115 @@
+import { avalanche } from '@0xtorch/core'
+import { avalanche as viemAvalanche } 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 createAvalancheCChain = (snowscanApiKey: string): Chain =>
+  createAvalancheCChainCustom({
+    client: createViemClient({
+      chain: viemAvalanche,
+      httpRpcs: avalancheCHttpRpcs,
+    }),
+    explorer: createEtherscan({
+      name: 'Snowscan',
+      url: 'https://snowscan.xyz',
+      apiUrl: 'https://api.snowscan.xyz/api',
+      apiKey: snowscanApiKey,
+    }),
+  })
+
+type CreateAvalancheCChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createAvalancheCChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateAvalancheCChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 43_114,
+    network: 'avalanche-c',
+    name: 'Avalanche C-Chain',
+    nativeToken: {
+      name: 'Avalanche',
+      symbol: 'AVAX',
+      decimals: 18,
+      currency: avalanche,
+    },
+    explorer,
+    client,
+    blockTime: undefined,
+    coingeckoId: 'avalanche',
+    defillamaId: 'avax',
+  })
+
+export const avalancheCHttpRpcs = [
+  {
+    url: 'https://api.avax.network/ext/bc/C/rpc',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2048n,
+  },
+  {
+    url: 'https://avalanche.public-rpc.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2048n,
+  },
+  {
+    url: 'https://rpc.ankr.com/avalanche',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://avalanche-c-chain.publicnode.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+  {
+    url: 'https://1rpc.io/avax/c',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://avalanche.blockpi.network/v1/rpc/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 1024n,
+  },
+  {
+    url: 'https://avalanche.api.onfinality.io/public/ext/bc/C/rpc',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2000n,
+  },
+  {
+    url: 'https://endpoints.omniatech.io/v1/avax/mainnet/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://avalanche.drpc.org',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2048n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const avalancheCWebsocketRpcUrls = [
+  'wss://avalanche-c-chain.publicnode.com',
+] as const

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

@@ -0,0 +1,50 @@
+import { expect, it } from 'bun:test'
+import { createPublicClient, http } from 'viem'
+import { base } from 'viem/chains'
+import { baseHttpRpcs } from './base'
+import { sendMsgEvent as sendMessageEvent } from './tests'
+
+it('Should all baseHttpRpcs be the rpc url of the archive node', async () => {
+  for (const rpc of baseHttpRpcs) {
+    const { url, isArchive, getLogsIsUsable, getLogsMaxBlockRange } = rpc
+    console.debug('Checking >', url)
+    const client = createPublicClient({
+      chain: base,
+      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 =
+        '0x10876f15bf90940a49e89436b16b3e7ab23cd43b56a5559900b5d3b23abd5a8b'
+      const blockNumber = 2_121_130n
+      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: '0xaf54be5b6eec24d6bfacf1cce4eaf680a8239398',
+        event: sendMessageEvent,
+        fromBlock,
+        toBlock,
+      })
+      console.debug('Result getLogs >', logs.length)
+      expect(logs).toBeDefined()
+    }
+  }
+}, 60_000)

package/src/chains/definitions/base.ts

@@ -0,0 +1,125 @@
+import { ethereum } from '@0xtorch/core'
+import { base } 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 createBaseChain = (basescanApiKey: string): Chain =>
+  createBaseChainCustom({
+    client: createViemClient({
+      chain: base,
+      httpRpcs: baseHttpRpcs,
+    }),
+    explorer: createEtherscan({
+      name: 'BaseScan',
+      url: 'https://basescan.org',
+      apiUrl: 'https://api.basescan.org/api',
+      apiKey: basescanApiKey,
+    }),
+  })
+
+type CreateBaseChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createBaseChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateBaseChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 8453,
+    network: 'base',
+    name: 'Base',
+    nativeToken: {
+      name: 'Ethereum',
+      symbol: 'ETH',
+      decimals: 18,
+      currency: ethereum,
+    },
+    explorer,
+    client,
+    blockTime: 2000,
+    coingeckoId: 'base',
+    defillamaId: 'base',
+  })
+
+export const baseHttpRpcs = [
+  {
+    url: 'https://mainnet.base.org',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2000n,
+  },
+  {
+    url: 'https://developer-access-mainnet.base.org',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2000n,
+  },
+  {
+    url: 'https://base.blockpi.network/v1/rpc/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 1024n,
+  },
+  {
+    url: 'https://1rpc.io/base',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://base-pokt.nodies.app',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 40_000n,
+  },
+  {
+    url: 'https://base.gateway.tenderly.co',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 40_000n,
+  },
+  {
+    url: 'https://gateway.tenderly.co/public/base',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 80_000n,
+  },
+  {
+    url: 'https://rpc.notadegen.com/base',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 80_000n,
+  },
+  {
+    url: 'https://base.drpc.org',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2000n,
+  },
+  {
+    url: 'https://endpoints.omniatech.io/v1/base/mainnet/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://base.api.onfinality.io/public',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const baseWebsocketRpcUrls = ['wss://base.publicnode.com'] as const

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

@@ -0,0 +1,50 @@
+import { expect, it } from 'bun:test'
+import { createPublicClient, http } from 'viem'
+import { bsc } from 'viem/chains'
+import { bscHttpRpcs } from './bsc'
+import { sendMsgEvent as sendMessageEvent } from './tests'
+
+it('Should all bscHttpRpcs be the rpc url of the archive node', async () => {
+  for (const rpc of bscHttpRpcs) {
+    const { url, isArchive, getLogsIsUsable, getLogsMaxBlockRange } = rpc
+    console.debug('Checking >', url)
+    const client = createPublicClient({
+      chain: bsc,
+      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 =
+        '0x9dfc1fc56d478a949f00133ea5304f757785c45ea1544b2e5d72529600016557'
+      const blockNumber = 15_168_926n
+      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: '0x6694340fc020c5e6b96567843da2df01b2ce1eb6',
+        event: sendMessageEvent,
+        fromBlock,
+        toBlock,
+      })
+      console.debug('Result getLogs >', logs.length)
+      expect(logs).toBeDefined()
+    }
+  }
+}, 60_000)