@0xtorch/evm 0.0.1

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

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

package/src/chains/definitions/linea.ts

@@ -0,0 +1,95 @@
+import { ethereum } from '@0xtorch/core'
+import { linea } 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 createLineaChain = (lineascanApiKey: string): Chain =>
+  createLineaChainCustom({
+    client: createViemClient({
+      chain: linea,
+      httpRpcs: lineaHttpRpcs,
+    }),
+    explorer: createEtherscan({
+      name: 'LineaScan',
+      url: 'https://lineascan.build',
+      apiUrl: 'https://api.lineascan.build/api',
+      apiKey: lineascanApiKey,
+    }),
+  })
+
+type CreateLineaChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createLineaChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateLineaChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 59_144,
+    network: 'linea',
+    name: 'Linea',
+    nativeToken: {
+      name: 'Ethereum',
+      symbol: 'ETH',
+      decimals: 18,
+      currency: ethereum,
+    },
+    explorer,
+    client,
+    blockTime: 6000,
+    coingeckoId: 'linea',
+    defillamaId: 'linea',
+  })
+
+export const lineaHttpRpcs = [
+  {
+    url: 'https://linea.blockpi.network/v1/rpc/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 1024n,
+  },
+  {
+    url: 'https://1rpc.io/linea',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://linea.drpc.org',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+  {
+    url: 'https://rpc.linea.build',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 40_000n,
+  },
+  {
+    url: 'https://linea.rpc.thirdweb.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://linea-mainnet-public.unifra.io',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const lineaWebsocketRpcUrls = [] as const

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

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

package/src/chains/definitions/mantle.ts

@@ -0,0 +1,75 @@
+import { mantle } from '@0xtorch/core'
+import type { Client } from '../../clients'
+import type { Explorer } from '../../explorers'
+import type { HttpRpc } from '../types'
+import { defineChain } from './defineChain'
+
+type CreateMantleChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createMantleChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateMantleChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 5000,
+    network: 'mantle',
+    name: 'Mantle',
+    nativeToken: {
+      name: 'Mantle',
+      symbol: 'MNT',
+      decimals: 18,
+      currency: mantle,
+    },
+    explorer,
+    client,
+    blockTime: undefined,
+    coingeckoId: 'mantle',
+    defillamaId: 'mantle',
+  })
+
+export const mantleHttpRpcs = [
+  {
+    url: 'https://rpc.ankr.com/mantle',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 3000n,
+  },
+  {
+    url: 'https://rpc.mantle.xyz/',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 320_000n,
+  },
+  {
+    url: 'https://mantle.publicnode.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 20_000n,
+  },
+  {
+    url: 'https://1rpc.io/mantle',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://mantle-mainnet.public.blastapi.io',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const mantleWebsocketRpcUrls = [
+  'wss://wss.mantle.xyz',
+  'wss://mantle.publicnode.com',
+] as const

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

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

package/src/chains/definitions/metis.ts

@@ -0,0 +1,60 @@
+import { metis } from '@0xtorch/core'
+import type { Client } from '../../clients'
+import type { Explorer } from '../../explorers'
+import type { HttpRpc } from '../types'
+import { defineChain } from './defineChain'
+
+type CreateMetisChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createMetisChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateMetisChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 1088,
+    network: 'metis',
+    name: 'Metis',
+    nativeToken: {
+      name: 'Metis',
+      symbol: 'METIS',
+      decimals: 18,
+      currency: metis,
+    },
+    explorer,
+    client,
+    blockTime: undefined,
+    coingeckoId: 'metis-andromeda',
+    defillamaId: 'metis',
+  })
+
+export const metisHttpRpcs = [
+  {
+    url: 'https://andromeda.metis.io/?owner=1088',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 160_000n,
+  },
+  {
+    url: 'https://metis.api.onfinality.io/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2000n,
+  },
+  {
+    url: 'https://metis-pokt.nodies.app',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 80_000n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const metisWebsocketRpcUrls = ['wss://andromeda-ws.metis.io'] as const

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

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

package/src/chains/definitions/moonbeam.ts

@@ -0,0 +1,117 @@
+import { moonbeam } from '@0xtorch/core'
+import { moonbeam as viemMoonbeam } 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 createMoonbeamChain = (moonscanApiKey: string): Chain =>
+  createMoonbeamChainCustom({
+    client: createViemClient({
+      chain: viemMoonbeam,
+      httpRpcs: moonbeamHttpRpcs,
+    }),
+    explorer: createEtherscan({
+      name: 'MoonScan',
+      url: 'https://moonbeam.moonscan.io',
+      apiUrl: 'https://api-moonbeam.moonscan.io/api',
+      apiKey: moonscanApiKey,
+    }),
+  })
+
+type CreateMoonbeamChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createMoonbeamChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateMoonbeamChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 1284,
+    network: 'moonbeam',
+    name: 'Moonbeam',
+    nativeToken: {
+      name: 'Moonbeam',
+      symbol: 'GLMR',
+      decimals: 18,
+      currency: moonbeam,
+    },
+    explorer,
+    client,
+    blockTime: undefined,
+    coingeckoId: 'moonbeam',
+    defillamaId: 'moonbeam',
+  })
+
+export const moonbeamHttpRpcs = [
+  {
+    url: 'https://rpc.api.moonbeam.network',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://moonbeam.api.onfinality.io/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2048n,
+  },
+  {
+    url: 'https://moonbeam.unitedbloc.com:3000',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://moonbeam.public.blastapi.io',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://rpc.ankr.com/moonbeam',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2048n,
+  },
+  {
+    url: 'https://1rpc.io/glmr',
+    isArchive: false,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://moonbeam-rpc.dwellir.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://endpoints.omniatech.io/v1/moonbeam/mainnet/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 2048n,
+  },
+  {
+    url: 'https://moonbeam-rpc.publicnode.com',
+    isArchive: false,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const moonbeamWebsocketRpcUrls = [
+  'wss://moonbeam.api.onfinality.io/public-ws',
+  'wss://moonbeam-rpc.dwellir.com',
+  'wss://moonbeam-rpc.publicnode.com',
+] as const

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

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

package/src/chains/definitions/moonriver.ts

@@ -0,0 +1,94 @@
+import { moonriver } from '@0xtorch/core'
+import { moonriver as viemMoonriver } 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 createMoonriverChain = (moonscanApiKey: string): Chain =>
+  createMoonriverChainCustom({
+    client: createViemClient({
+      chain: viemMoonriver,
+      httpRpcs: moonriverHttpRpcs,
+    }),
+    explorer: createEtherscan({
+      name: 'MoonScan',
+      url: 'https://moonriver.moonscan.io',
+      apiUrl: 'https://api-moonriver.moonscan.io/api',
+      apiKey: moonscanApiKey,
+    }),
+  })
+
+type CreateMoonriverChainParameters<
+  TClient extends Client,
+  TExplorer extends Explorer,
+> = {
+  readonly client: TClient
+  readonly explorer: TExplorer
+}
+
+export const createMoonriverChainCustom = <
+  const TClient extends Client,
+  const TExplorer extends Explorer,
+>({
+  client,
+  explorer,
+}: CreateMoonriverChainParameters<TClient, TExplorer>) =>
+  defineChain({
+    id: 1285,
+    network: 'moonriver',
+    name: 'Moonriver',
+    nativeToken: {
+      name: 'Moonriver',
+      symbol: 'MOVR',
+      decimals: 18,
+      currency: moonriver,
+    },
+    explorer,
+    client,
+    blockTime: undefined,
+    coingeckoId: 'moonriver',
+    defillamaId: 'moonriver',
+  })
+
+export const moonriverHttpRpcs = [
+  {
+    url: 'https://moonriver.api.onfinality.io/public',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://moonriver.unitedbloc.com:2000',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://moonriver.public.blastapi.io',
+    isArchive: true,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+  {
+    url: 'https://moonriver-rpc.dwellir.com',
+    isArchive: true,
+    getLogsIsUsable: true,
+    getLogsMaxBlockRange: 10_000n,
+  },
+  {
+    url: 'https://moonriver-rpc.publicnode.com',
+    isArchive: false,
+    getLogsIsUsable: false,
+    getLogsMaxBlockRange: 0n,
+  },
+] as const satisfies readonly HttpRpc[]
+
+export const moonriverWebsocketRpcUrls = [
+  'wss://moonriver.api.onfinality.io/public-ws',
+  'wss://moonriver.unitedbloc.com:2001',
+  'wss://moonriver-rpc.dwellir.com',
+  'wss://moonriver-rpc.publicnode.com',
+] as const