@0xtorch/evm 0.0.1

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

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

package/src/chains/definitions/optimism.ts

@@ -0,0 +1,139 @@
+import { ethereum } from '@0xtorch/core'
+import { optimism } 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 createOptimismChain = (opscanApiKey: string): Chain =>
+  createOptimismChainCustom({
+    client: createViemClient({
+      chain: optimism,
+      httpRpcs: optimismHttpRpcs,
+    }),
+    explorer: createEtherscan({
+      name: 'OP Mainnet Explorer',
+      url: 'https://optimistic.etherscan.io',
+      apiUrl: 'https://api-optimistic.etherscan.io/api',
+      apiKey: opscanApiKey,
+    }),
+  })
+
+type CreateOptimismChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createOptimismChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateOptimismChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 10,
+    network: 'optimism',
+    name: 'Optimism',
+    nativeToken: {
+      name: 'Ethereum',
+      symbol: 'ETH',
+      decimals: 18,
+      currency: ethereum,
+    },
+    explorer,
+    client,
+    blockTime: 2000,
+    coingeckoId: 'optimistic-ethereum',
+    defillamaId: 'optimism',
+  })
+
+export const optimismHttpRpcs = [
+  {
+    url: 'https://mainnet.optimism.io/',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://rpc.ankr.com/optimism',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://1rpc.io/op',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://op-pokt.nodies.app',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 40_000n,
+  },
+  {
+    url: 'https://optimism.blockpi.network/v1/rpc/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 1024n,
+  },
+  {
+    url: 'https://endpoints.omniatech.io/v1/op/mainnet/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://optimism.api.onfinality.io/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2000n,
+  },
+  {
+    url: 'https://rpc.optimism.gateway.fm',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 4000n,
+  },
+  {
+    url: 'https://optimism.publicnode.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://optimism.meowrpc.com',
+    isArchive: false,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://optimism.drpc.org',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+  {
+    url: 'https://optimism.gateway.tenderly.co',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 40_000n,
+  },
+  {
+    url: 'https://gateway.tenderly.co/public/optimism',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 40_000n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const optimismWebsocketRpcUrls = [
+  'wss://optimism.publicnode.com',
+] as const

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

@@ -0,0 +1,50 @@
+import { expect, it } from 'bun:test'
+import { createPublicClient, http } from 'viem'
+import { polygon } from 'viem/chains'
+import { polygonPosHttpRpcs } from './polygonPos'
+import { sendMsgEvent as sendMessageEvent } from './tests'
+
+it('Should all polygonPosHttpRpcs be the rpc url of the archive node', async () => {
+  for (const rpc of polygonPosHttpRpcs) {
+    const { url, isArchive, getLogsIsUsable, getLogsMaxBlockRange } = rpc
+    console.debug('Checking >', url)
+    const client = createPublicClient({
+      chain: polygon,
+      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 =
+        '0x5167041ce62d05c47bf1aaa288c378704078e1a2e5e86f774291dee997a7024f'
+      const blockNumber = 25_583_651n
+      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/polygonPos.ts

@@ -0,0 +1,121 @@
+import { maticNetwork } from '@0xtorch/core'
+import { polygon } 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 createPolygonPosChain = (polygonscanApiKey: string): Chain =>
+  createPolygonPosChainCustom({
+    client: createViemClient({
+      chain: polygon,
+      httpRpcs: polygonPosHttpRpcs,
+    }),
+    explorer: createEtherscan({
+      name: 'PolygonScan',
+      url: 'https://polygonscan.com',
+      apiUrl: 'https://api.polygonscan.com/api',
+      apiKey: polygonscanApiKey,
+    }),
+  })
+
+type CreatePolygonPosChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createPolygonPosChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreatePolygonPosChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 137,
+    network: 'polygon-pos',
+    name: 'Polygon PoS',
+    nativeToken: {
+      name: 'Polygon',
+      symbol: 'MATIC',
+      decimals: 18,
+      currency: maticNetwork,
+    },
+    explorer,
+    client,
+    blockTime: 2000,
+    coingeckoId: 'polygon-pos',
+    defillamaId: 'polygon',
+  })
+
+export const polygonPosHttpRpcs = [
+  {
+    url: 'https://rpc-mainnet.maticvigil.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 1000n,
+  },
+  {
+    url: 'https://endpoints.omniatech.io/v1/matic/mainnet/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  // {
+  //   url: 'https://polygon-rpc.com',
+  //   isArchive: true,
+  //   getLogsIsUsable: true,
+  //   getLogsMaxBlockRange: 3000n,
+  // },
+  {
+    url: 'https://rpc-mainnet.matic.quiknode.pro',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://rpc.ankr.com/polygon',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://1rpc.io/matic',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://polygon.blockpi.network/v1/rpc/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 1024n,
+  },
+  {
+    url: 'https://polygon.api.onfinality.io/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2000n,
+  },
+  {
+    url: 'https://polygon.gateway.tenderly.co',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+  {
+    url: 'https://gateway.tenderly.co/public/polygon',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const polygonPosWebsocketRpcUrls = [
+  'wss://polygon-bor.publicnode.com',
+] as const

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

@@ -0,0 +1,50 @@
+import { expect, it } from 'bun:test'
+import { createPublicClient, http } from 'viem'
+import { ronin } from 'viem/chains'
+import { roninHttpRpcs } from '.'
+import { depositedEvent } from './tests'
+
+it('Should all roninHttpRpcs be the rpc url of the active node', async () => {
+  for (const rpc of roninHttpRpcs) {
+    const { url, isArchive, getLogsIsUsable, getLogsMaxBlockRange } = rpc
+    console.debug('Checking >', url)
+    const client = createPublicClient({
+      chain: ronin,
+      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 =
+        '0x2c803382bb49072f2d41d0941432761663b806b6cd4f1a84a361dd0a3c00d006'
+      const blockNumber = 11_123_530n
+      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: '0x0cf8ff40a508bdbc39fbe1bb679dcba64e65c7df',
+        event: depositedEvent,
+        fromBlock,
+        toBlock,
+      })
+      console.debug('Result getLogs >', logs.length)
+      expect(logs).toBeDefined()
+    }
+  }
+}, 60_000)

package/src/chains/definitions/ronin.ts

@@ -0,0 +1,75 @@
+import { ronin } from '@0xtorch/core'
+import { ronin as viemRonin } from 'viem/chains'
+import type { Client } from '../../clients'
+import { createViemClient } from '../../clients'
+import type { Explorer } from '../../explorers'
+import { createRoninExplorer } from '../../explorers'
+import type { Chain, HttpRpc } from '../types'
+import { defineChain } from './defineChain'
+
+type CreateRoninChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createRoninChain = (
+  skymavisApiKey: string,
+  explorerApiUrl: string,
+): Chain =>
+  createRoninChainCustom({
+    client: createViemClient({
+      chain: viemRonin,
+      httpRpcs: roninHttpRpcs,
+    }),
+    explorer: createRoninExplorer({
+      name: 'The Ronin Block Explorer',
+      url: 'https://app.roninchain.com',
+      apiUrl: 'https://api-gateway.skymavis.com',
+      apiKey: skymavisApiKey,
+      explorerApiUrl,
+    }),
+  })
+
+export const createRoninChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateRoninChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 2020,
+    network: 'ronin',
+    name: 'Ronin',
+    nativeToken: {
+      name: 'Ronin',
+      symbol: 'RON',
+      decimals: 18,
+      currency: ronin,
+    },
+    explorer,
+    client,
+    blockTime: 3000,
+    coingeckoId: 'ronin',
+    defillamaId: 'ronin',
+  })
+
+export const roninHttpRpcs = [
+  {
+    url: 'https://api.roninchain.com/rpc',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 200n,
+  },
+  {
+    url: 'https://ronin.lgns.net/rpc',
+    isArchive: false,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const roninWebsocketRpcUrls = [] as const