@0xtorch/evm 0.0.1

package/src/clients/index.ts

@@ -0,0 +1,2 @@
+export { createViemClient } from './definitions'
+export type { Client } from './types'

package/src/clients/types.ts

@@ -0,0 +1,113 @@
+import type { Logger } from '@0xtorch/core'
+import type { AbiEvent } from 'abitype'
+import type {
+  Abi,
+  Block,
+  ContractFunctionName,
+  FeeValues,
+  GetLogsReturnType,
+  MulticallParameters,
+  MulticallReturnType,
+  ReadContractParameters,
+  ReadContractReturnType,
+  Transaction,
+  TransactionReceipt,
+} from 'viem'
+import type { Hex, LowerHex } from '../types'
+
+export type Client = {
+  readonly httpRpcCount: number
+  // TODO 主要関数を定義する
+  readonly estimateFeesPerGas: FunctionEstimateFeesPerGas
+  readonly getBalance: FunctionGetBalance
+  readonly getBlock: FunctionGetBlock
+  readonly getBlockNumber: FunctionGetBlockNumber
+  readonly getEventLogs: FunctionGetEventLogs
+  readonly getTransaction: FunctionGetTransaction
+  readonly getTransactionCount: FunctionGetTransactionCount
+  readonly getTransactionReceipt: FunctionGetTransactionReceipt
+  readonly multicall: FunctionMulticall
+  readonly readContract: FunctionReadContract
+}
+
+type FunctionEstimateFeesPerGas = (config?: {
+  readonly timeout?: number
+  readonly logger?: Logger
+}) => Promise<FeeValues>
+
+type FunctionGetBalance = (
+  address: LowerHex,
+  config?: {
+    readonly timeout?: number
+    readonly logger?: Logger
+  },
+) => Promise<bigint>
+
+type FunctionGetBlock = (
+  blockNumber: bigint,
+  config?: {
+    readonly timeout?: number
+    readonly logger?: Logger
+  },
+) => Promise<Block>
+
+type FunctionGetBlockNumber = (config?: {
+  readonly timeout?: number
+  readonly logger?: Logger
+}) => Promise<bigint>
+
+type FunctionGetEventLogs = <const TAbiEvent extends AbiEvent>(
+  parameters: {
+    readonly contractAddress: LowerHex
+    readonly event: TAbiEvent
+    readonly fromBlock: bigint
+    readonly toBlock: bigint
+  },
+  config?: {
+    readonly timeout?: number
+    readonly logger?: Logger
+  },
+) => Promise<GetLogsReturnType<TAbiEvent>>
+
+type FunctionGetTransaction = (
+  hash: Hex,
+  config?: {
+    readonly timeout?: number
+    readonly logger?: Logger
+  },
+) => Promise<Transaction>
+
+type FunctionGetTransactionCount = (
+  address: LowerHex,
+  config?: {
+    readonly timeout?: number
+    readonly logger?: Logger
+  },
+) => Promise<number>
+
+type FunctionGetTransactionReceipt = (
+  hash: Hex,
+  config?: {
+    readonly timeout?: number
+    readonly logger?: Logger
+  },
+) => Promise<TransactionReceipt>
+
+type FunctionMulticall = <const TContracts extends readonly unknown[]>(
+  parameters: MulticallParameters<TContracts>,
+  config?: {
+    readonly timeout?: number
+    readonly logger?: Logger
+  },
+) => Promise<MulticallReturnType<TContracts>>
+
+type FunctionReadContract = <
+  const TAbi extends Abi | readonly unknown[],
+  const TFunctionName extends ContractFunctionName<TAbi, 'pure' | 'view'>,
+>(
+  parameters: ReadContractParameters<TAbi, TFunctionName>,
+  config?: {
+    readonly timeout?: number
+    readonly logger?: Logger
+  },
+) => Promise<ReadContractReturnType<TAbi, TFunctionName>>

package/src/creates/createEvmAccount.ts

@@ -0,0 +1,12 @@
+import type { EvmAccount } from '../types'
+
+export const createEvmAccount = (
+  account: Omit<EvmAccount, 'id' | 'category' | 'name'> & {
+    readonly name?: string
+  },
+): EvmAccount => ({
+  ...account,
+  id: `evm_${account.chainId}_${account.address}`,
+  category: 'evm',
+  name: account.name ?? account.address,
+})

package/src/decoder/decode.test.ts

@@ -0,0 +1,324 @@
+import { describe, expect, it } from 'bun:test'
+import { createEthereumChain } from '../chains'
+import { isIntegrationTest } from '../tests'
+import { decode } from './decode'
+import { testTxSwapExactETHForTokens } from './tests'
+
+describe.if(isIntegrationTest)('decode', () => {
+  // https://etherscan.io/tx/0x78ef484e62a5174b5fb716cde105a9669fc333e7ccb59c8eced163a9802a9c43
+  it('Should decode swapExactETHForTokens (UniV2 router) transaction', async () => {
+    const chain = createEthereumChain(process.env.ETHERSCAN_API_KEY ?? '')
+
+    const result = await decode({
+      chain,
+      transactions: [testTxSwapExactETHForTokens],
+    })
+
+    expect(result.transactions).toHaveLength(1)
+    const transaction = result.transactions[0]
+    expect(transaction.function).toEqual({
+      name: 'swapExactETHForTokens',
+      args: [
+        {
+          name: 'amountOutMin',
+          type: 'uint256',
+          value: 5_977_323_005_749_423n,
+        },
+        {
+          name: 'path',
+          type: 'address[]',
+          value: [
+            '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
+            '0xAbaF9c47094B1a774432FfaE5B6d92c78eE69BbB',
+          ],
+        },
+        {
+          name: 'to',
+          type: 'address',
+          value: '0x95ABcA1617e57b6B99185A288728f58286b5570e',
+        },
+        {
+          name: 'deadline',
+          type: 'uint256',
+          value: 1_705_464_035n,
+        },
+      ],
+    })
+    expect(transaction.erc20Transfers).toEqual([
+      {
+        type: 'Erc20Transfer',
+        logIndex: 100,
+        from: '0x7a250d5630b4cf539739df2c5dacb4c659f2488d',
+        to: '0x775e4d9f7b97b0b67cab8c953bef80c5e194ebaf',
+        value: 1_000_000_000_000_000_000n,
+        price: undefined,
+        token: {
+          contractAddress: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
+          name: 'Wrapped Ether',
+          symbol: 'WETH',
+          decimals: 18,
+          currency: {
+            type: 'CryptoCurrency',
+            id: 'weth',
+            name: 'WETH',
+            symbol: 'WETH',
+            icon: undefined,
+            market: {
+              coingeckoId: 'weth',
+              marketCapUsd: undefined,
+            },
+            updatedAt: transaction.erc20Transfers[0].token.currency.updatedAt,
+          },
+        },
+      },
+      {
+        type: 'Erc20Transfer',
+        logIndex: 101,
+        from: '0x775e4d9f7b97b0b67cab8c953bef80c5e194ebaf',
+        to: '0x95abca1617e57b6b99185a288728f58286b5570e',
+        value: 5_992_361_277_547_358n,
+        price: undefined,
+        token: {
+          contractAddress: '0xabaf9c47094b1a774432ffae5b6d92c78ee69bbb',
+          name: 'NOBODY',
+          symbol: 'NOBODY',
+          decimals: 9,
+          currency: {
+            type: 'CryptoCurrency',
+            id: 'evm_1_0xabaf9c47094b1a774432ffae5b6d92c78ee69bbb',
+            name: 'NOBODY',
+            symbol: 'NOBODY',
+            icon: undefined,
+            market: {
+              coingeckoId: undefined,
+              marketCapUsd: undefined,
+            },
+            updatedAt: transaction.erc20Transfers[1].token.currency.updatedAt,
+          },
+        },
+      },
+    ])
+    expect(transaction.erc721Transfers).toEqual([])
+    expect(transaction.erc1155Transfers).toEqual([])
+    expect(transaction.logs).toEqual([
+      {
+        type: 'decoded',
+        log: {
+          address: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
+          blockHash:
+            '0xfa2cfe13f3f4545f09accc3de4d90776f5e9d2df81b022eb3612ff2714f6137b',
+          blockNumber: 19_023_982n,
+          data: '0x0000000000000000000000000000000000000000000000000de0b6b3a7640000',
+          logIndex: 99,
+          transactionHash:
+            '0x78ef484e62a5174b5fb716cde105a9669fc333e7ccb59c8eced163a9802a9c43',
+          transactionIndex: 72,
+          removed: false,
+          topics: [
+            '0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c',
+            '0x0000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488d',
+          ],
+          eventName: 'Deposit',
+          args: [
+            {
+              indexed: true,
+              name: 'dst',
+              type: 'address',
+              value: '0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D',
+            },
+            {
+              indexed: false,
+              name: 'wad',
+              type: 'uint256',
+              value: 1_000_000_000_000_000_000n,
+            },
+          ],
+          type: 'DecodedLog',
+        },
+        source: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
+      },
+      {
+        type: 'decoded',
+        log: {
+          address: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
+          blockHash:
+            '0xfa2cfe13f3f4545f09accc3de4d90776f5e9d2df81b022eb3612ff2714f6137b',
+          blockNumber: 19_023_982n,
+          data: '0x0000000000000000000000000000000000000000000000000de0b6b3a7640000',
+          logIndex: 100,
+          transactionHash:
+            '0x78ef484e62a5174b5fb716cde105a9669fc333e7ccb59c8eced163a9802a9c43',
+          transactionIndex: 72,
+          removed: false,
+          topics: [
+            '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+            '0x0000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488d',
+            '0x000000000000000000000000775e4d9f7b97b0b67cab8c953bef80c5e194ebaf',
+          ],
+          eventName: 'Transfer',
+          args: [
+            {
+              indexed: true,
+              name: 'src',
+              type: 'address',
+              value: '0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D',
+            },
+            {
+              indexed: true,
+              name: 'dst',
+              type: 'address',
+              value: '0x775e4D9F7b97b0B67CaB8C953bEF80c5e194EbAF',
+            },
+            {
+              indexed: false,
+              name: 'wad',
+              type: 'uint256',
+              value: 1_000_000_000_000_000_000n,
+            },
+          ],
+          type: 'DecodedLog',
+        },
+        source: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
+      },
+      {
+        type: 'decoded',
+        log: {
+          address: '0xabaf9c47094b1a774432ffae5b6d92c78ee69bbb',
+          blockHash:
+            '0xfa2cfe13f3f4545f09accc3de4d90776f5e9d2df81b022eb3612ff2714f6137b',
+          blockNumber: 19_023_982n,
+          data: '0x00000000000000000000000000000000000000000000000000154a055550635e',
+          logIndex: 101,
+          transactionHash:
+            '0x78ef484e62a5174b5fb716cde105a9669fc333e7ccb59c8eced163a9802a9c43',
+          transactionIndex: 72,
+          removed: false,
+          topics: [
+            '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+            '0x000000000000000000000000775e4d9f7b97b0b67cab8c953bef80c5e194ebaf',
+            '0x00000000000000000000000095abca1617e57b6b99185a288728f58286b5570e',
+          ],
+          eventName: 'Transfer',
+          args: [
+            {
+              indexed: true,
+              name: 'from',
+              type: 'address',
+              value: '0x775e4D9F7b97b0B67CaB8C953bEF80c5e194EbAF',
+            },
+            {
+              indexed: true,
+              name: 'to',
+              type: 'address',
+              value: '0x95ABcA1617e57b6B99185A288728f58286b5570e',
+            },
+            {
+              indexed: false,
+              name: 'value',
+              type: 'uint256',
+              value: 5_992_361_277_547_358n,
+            },
+          ],
+          type: 'DecodedLog',
+        },
+        source: '0xabaf9c47094b1a774432ffae5b6d92c78ee69bbb',
+      },
+      {
+        type: 'decoded',
+        log: {
+          address: '0x775e4d9f7b97b0b67cab8c953bef80c5e194ebaf',
+          blockHash:
+            '0xfa2cfe13f3f4545f09accc3de4d90776f5e9d2df81b022eb3612ff2714f6137b',
+          blockNumber: 19_023_982n,
+          data: '0x000000000000000000000000000000000000000000000000052b1fcd42f64cd300000000000000000000000000000000000000000000000369cc1ead89f126ed',
+          logIndex: 102,
+          transactionHash:
+            '0x78ef484e62a5174b5fb716cde105a9669fc333e7ccb59c8eced163a9802a9c43',
+          transactionIndex: 72,
+          removed: false,
+          topics: [
+            '0x1c411e9a96e071241c2f21f7726b17ae89e3cab4c78be50e062b03a9fffbbad1',
+          ],
+          eventName: 'Sync',
+          args: [
+            {
+              indexed: false,
+              name: 'reserve0',
+              type: 'uint112',
+              value: 372_426_360_640_392_403n,
+            },
+            {
+              indexed: false,
+              name: 'reserve1',
+              type: 'uint112',
+              value: 62_963_734_221_052_520_173n,
+            },
+          ],
+          type: 'DecodedLog',
+        },
+        source: '0x775e4d9f7b97b0b67cab8c953bef80c5e194ebaf',
+      },
+      {
+        type: 'decoded',
+        log: {
+          address: '0x775e4d9f7b97b0b67cab8c953bef80c5e194ebaf',
+          blockHash:
+            '0xfa2cfe13f3f4545f09accc3de4d90776f5e9d2df81b022eb3612ff2714f6137b',
+          blockNumber: 19_023_982n,
+          data: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000de0b6b3a764000000000000000000000000000000000000000000000000000000154a055550635e0000000000000000000000000000000000000000000000000000000000000000',
+          logIndex: 103,
+          transactionHash:
+            '0x78ef484e62a5174b5fb716cde105a9669fc333e7ccb59c8eced163a9802a9c43',
+          transactionIndex: 72,
+          removed: false,
+          topics: [
+            '0xd78ad95fa46c994b6551d0da85fc275fe613ce37657fb8d5e3d130840159d822',
+            '0x0000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488d',
+            '0x00000000000000000000000095abca1617e57b6b99185a288728f58286b5570e',
+          ],
+          eventName: 'Swap',
+          args: [
+            {
+              indexed: true,
+              name: 'sender',
+              type: 'address',
+              value: '0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D',
+            },
+            {
+              indexed: false,
+              name: 'amount0In',
+              type: 'uint256',
+              value: 0n,
+            },
+            {
+              indexed: false,
+              name: 'amount1In',
+              type: 'uint256',
+              value: 1_000_000_000_000_000_000n,
+            },
+            {
+              indexed: false,
+              name: 'amount0Out',
+              type: 'uint256',
+              value: 5_992_361_277_547_358n,
+            },
+            {
+              indexed: false,
+              name: 'amount1Out',
+              type: 'uint256',
+              value: 0n,
+            },
+            {
+              indexed: true,
+              name: 'to',
+              type: 'address',
+              value: '0x95ABcA1617e57b6B99185A288728f58286b5570e',
+            },
+          ],
+          type: 'DecodedLog',
+        },
+        source: '0x775e4d9f7b97b0b67cab8c953bef80c5e194ebaf',
+      },
+    ])
+  }, 60_000)
+})