@0xtorch/evm 0.0.126 → 0.0.128

package/explorer/etherscanV2/getInternalTransactionsByTransactionHash.ts

@@ -0,0 +1,76 @@
+import { z } from 'zod'
+import type { LowerHex } from '../../types'
+import type { InternalTransactionWithIndex } from '../../types/internalTransaction'
+import { addressPrimitiveSchema, bigintTextSchema } from '../../types/primitive'
+import type { EtherscanV2Client } from './client'
+
+type GetInternalTransactionsByTransactionHashParameters = {
+  client: EtherscanV2Client
+  txhash: LowerHex
+  headers?: Record<string, string>
+}
+
+const internalTransactionSchema = z.object({
+  blockNumber: z.string().regex(/^\d+$/).transform(Number),
+  contractAddress: z.union([
+    addressPrimitiveSchema,
+    z
+      .literal('')
+      .nullable()
+      .transform(() => undefined),
+  ]),
+  from: addressPrimitiveSchema,
+  gas: bigintTextSchema,
+  isError: z
+    .string()
+    .regex(/^\d+$/)
+    .transform((x) => x === '1'),
+  timeStamp: z.string().regex(/^\d+$/).transform(Number),
+  to: z.union([
+    addressPrimitiveSchema,
+    z
+      .literal('')
+      .nullable()
+      .transform(() => undefined),
+  ]),
+  value: bigintTextSchema,
+})
+const resultSchema = z.array(internalTransactionSchema)
+
+/** {@link https://docs.etherscan.io/etherscan-v2/api-endpoints/accounts#get-internal-transactions-by-transaction-hash} */
+export const getInternalTransactionsByTransactionHash = async ({
+  client,
+  txhash,
+  headers,
+}: GetInternalTransactionsByTransactionHashParameters): Promise<
+  InternalTransactionWithIndex[]
+> => {
+  try {
+    const result = await client.get({
+      path: '',
+      query: {
+        module: 'account',
+        action: 'txlistinternal',
+        txhash,
+      },
+      resultSchema,
+      headers,
+    })
+    return result.map((v) => ({
+      blockNumber: v.blockNumber,
+      contractAddress: v.contractAddress,
+      from: v.from,
+      gas: v.gas,
+      isError: v.isError,
+      timestamp: v.timeStamp * 1000,
+      to: v.to,
+      txHash: txhash,
+      value: v.value,
+    }))
+  } catch (error) {
+    if (error instanceof Error && error.message === 'No transactions found') {
+      return []
+    }
+    throw error
+  }
+}

package/explorer/etherscanV2/getListOfErc1155TokenTransferEventsByAddress.ts

@@ -0,0 +1,74 @@
+import { z } from 'zod'
+import { lowerHexSchema } from '../../types/primitive'
+import type { TransactionIndex } from '../../types/transactionIndex'
+import type { EtherscanV2Client } from './client'
+
+type GetListOfErc1155TokenTransferEventsByAddressParameters = {
+  client: EtherscanV2Client
+  address: string
+  startblock?: number
+  endblock?: number
+  page?: number
+  offset?: number
+  sort?: 'asc' | 'desc'
+  headers?: Record<string, string>
+}
+
+const transferSchema = z.object({
+  blockNumber: z.string().regex(/^\d+$/).transform(Number),
+  hash: lowerHexSchema,
+  timeStamp: z.string().regex(/^\d+$/).transform(Number),
+})
+const resultSchema = z.array(transferSchema)
+
+/** {@link https://docs.etherscan.io/etherscan-v2/api-endpoints/accounts#get-a-list-of-erc1155-token-transfer-events-by-address} */
+export const getListOfErc1155TokenTransferEventsByAddress = async ({
+  client,
+  address,
+  startblock = 0,
+  endblock,
+  page = 1,
+  offset = 10_000,
+  sort = 'asc',
+  headers,
+}: GetListOfErc1155TokenTransferEventsByAddressParameters): Promise<
+  TransactionIndex[]
+> => {
+  try {
+    const result = await client.get({
+      path: '',
+      query: {
+        module: 'account',
+        action: 'token1155tx',
+        address,
+        startblock: startblock.toString(),
+        ...(endblock === undefined
+          ? {}
+          : {
+              endblock: endblock.toString(),
+            }),
+        page: page.toString(),
+        offset: offset.toString(),
+        sort,
+      },
+      resultSchema,
+      headers,
+    })
+    return result.map((v) => ({
+      blockNumber: v.blockNumber,
+      hash: v.hash,
+      timestamp: v.timeStamp * 1000,
+    }))
+  } catch (error) {
+    if (
+      error instanceof Error &&
+      (error.message === 'No transactions found' ||
+        error.message === 'Error! Missing Or invalid Action name' ||
+        error.message ===
+          'Query Timeout occured. Please select a smaller result dataset')
+    ) {
+      return []
+    }
+    throw error
+  }
+}

package/explorer/etherscanV2/getListOfErc20TokenTransferEventsByAddress.ts

@@ -0,0 +1,92 @@
+import { z } from 'zod'
+import type { Erc20Transfer } from '../../types'
+import { bigintTextSchema, lowerHexSchema } from '../../types/primitive'
+import type { TransactionIndex } from '../../types/transactionIndex'
+import type { EtherscanV2Client } from './client'
+
+type GetListOfErc20TokenTransferEventsByAddressParameters = {
+  client: EtherscanV2Client
+  address: string
+  startblock?: number
+  endblock?: number
+  page?: number
+  offset?: number
+  sort?: 'asc' | 'desc'
+  headers?: Record<string, string>
+}
+
+const transferSchema = z.object({
+  blockNumber: z.string().regex(/^\d+$/).transform(Number),
+  hash: lowerHexSchema,
+  timeStamp: z.string().regex(/^\d+$/).transform(Number),
+  contractAddress: lowerHexSchema,
+  from: lowerHexSchema,
+  to: lowerHexSchema,
+  value: bigintTextSchema,
+})
+const resultSchema = z.array(transferSchema)
+
+/** {@link https://docs.etherscan.io/etherscan-v2/api-endpoints/accounts#get-a-list-of-erc20-token-transfer-events-by-address} */
+export const getListOfErc20TokenTransferEventsByAddress = async ({
+  client,
+  address,
+  startblock = 0,
+  endblock,
+  page = 1,
+  offset = 10_000,
+  sort = 'asc',
+  headers,
+}: GetListOfErc20TokenTransferEventsByAddressParameters): Promise<{
+  indexes: readonly TransactionIndex[]
+  erc20Transfers: readonly Erc20Transfer[]
+}> => {
+  try {
+    const result = await client.get({
+      path: '',
+      query: {
+        module: 'account',
+        action: 'tokentx',
+        address,
+        startblock: startblock.toString(),
+        ...(endblock === undefined
+          ? {}
+          : {
+              endblock: endblock.toString(),
+            }),
+        page: page.toString(),
+        offset: offset.toString(),
+        sort,
+      },
+      resultSchema,
+      headers,
+    })
+    const indexes: TransactionIndex[] = []
+    const transfers: Erc20Transfer[] = []
+    for (const data of result) {
+      indexes.push({
+        blockNumber: data.blockNumber,
+        hash: data.hash,
+        timestamp: data.timeStamp * 1000,
+      })
+      transfers.push({
+        address: data.contractAddress,
+        from: data.from,
+        logIndex: 0,
+        to: data.to,
+        value: data.value,
+      })
+    }
+    return {
+      indexes,
+      erc20Transfers: transfers,
+    }
+  } catch (error) {
+    if (error instanceof Error && error.message === 'No transactions found') {
+      return {
+        indexes: [],
+        erc20Transfers: [],
+      }
+    }
+    throw error
+  }
+}

package/explorer/etherscanV2/getListOfErc721TokenTransferEventsByAddress.ts

@@ -0,0 +1,68 @@
+import { z } from 'zod'
+import { lowerHexSchema } from '../../types/primitive'
+import type { TransactionIndex } from '../../types/transactionIndex'
+import type { EtherscanV2Client } from './client'
+
+type GetListOfErc721TokenTransferEventsByAddressParameters = {
+  client: EtherscanV2Client
+  address: string
+  startblock?: number
+  endblock?: number
+  page?: number
+  offset?: number
+  sort?: 'asc' | 'desc'
+  headers?: Record<string, string>
+}
+
+const transferSchema = z.object({
+  blockNumber: z.string().regex(/^\d+$/).transform(Number),
+  hash: lowerHexSchema,
+  timeStamp: z.string().regex(/^\d+$/).transform(Number),
+})
+const resultSchema = z.array(transferSchema)
+
+/** {@link https://docs.etherscan.io/etherscan-v2/api-endpoints/accounts#get-a-list-of-erc721-token-transfer-events-by-address} */
+export const getListOfErc721TokenTransferEventsByAddress = async ({
+  client,
+  address,
+  startblock = 0,
+  endblock,
+  page = 1,
+  offset = 10_000,
+  sort = 'asc',
+  headers,
+}: GetListOfErc721TokenTransferEventsByAddressParameters): Promise<
+  TransactionIndex[]
+> => {
+  try {
+    const result = await client.get({
+      path: '',
+      query: {
+        module: 'account',
+        action: 'tokennfttx',
+        address,
+        startblock: startblock.toString(),
+        ...(endblock === undefined
+          ? {}
+          : {
+              endblock: endblock.toString(),
+            }),
+        page: page.toString(),
+        offset: offset.toString(),
+        sort,
+      },
+      resultSchema,
+      headers,
+    })
+    return result.map((v) => ({
+      blockNumber: v.blockNumber,
+      hash: v.hash,
+      timestamp: v.timeStamp * 1000,
+    }))
+  } catch (error) {
+    if (error instanceof Error && error.message === 'No transactions found') {
+      return []
+    }
+    throw error
+  }
+}

package/explorer/etherscanV2/getListOfInternalTransactionsByAddress.ts

@@ -0,0 +1,100 @@
+import { z } from 'zod'
+import type { Hex } from '../../types'
+import type { InternalTransactionWithIndex } from '../../types/internalTransaction'
+import {
+  addressPrimitiveSchema,
+  bigintTextSchema,
+  lowerHexSchema,
+} from '../../types/primitive'
+import type { EtherscanV2Client } from './client'
+
+type GetListOfInternalTransactionsByAddressParameters = {
+  client: EtherscanV2Client
+  address: Hex
+  startblock?: number
+  endblock?: number
+  page?: number
+  offset?: number
+  sort?: 'asc' | 'desc'
+  headers?: Record<string, string>
+}
+
+const internalTransactionSchema = z.object({
+  blockNumber: z.string().regex(/^\d+$/).transform(Number),
+  contractAddress: z.union([
+    addressPrimitiveSchema,
+    z
+      .literal('')
+      .nullable()
+      .transform(() => undefined),
+  ]),
+  from: addressPrimitiveSchema,
+  gas: bigintTextSchema,
+  hash: lowerHexSchema,
+  isError: z
+    .string()
+    .regex(/^\d+$/)
+    .transform((x) => x === '1'),
+  timeStamp: z.string().regex(/^\d+$/).transform(Number),
+  to: z.union([
+    addressPrimitiveSchema,
+    z
+      .literal('')
+      .nullable()
+      .transform(() => undefined),
+  ]),
+  value: bigintTextSchema,
+})
+const resultSchema = z.array(internalTransactionSchema)
+
+/** {@link https://docs.etherscan.io/etherscan-v2/api-endpoints/accounts#get-a-list-of-internal-transactions-by-address} */
+export const getListOfInternalTransactionsByAddress = async ({
+  client,
+  address,
+  startblock = 0,
+  endblock,
+  page = 1,
+  offset = 10_000,
+  sort = 'asc',
+  headers,
+}: GetListOfInternalTransactionsByAddressParameters): Promise<
+  InternalTransactionWithIndex[]
+> => {
+  try {
+    const result = await client.get({
+      path: '',
+      query: {
+        module: 'account',
+        action: 'txlistinternal',
+        address,
+        startblock: startblock.toString(),
+        ...(endblock === undefined
+          ? {}
+          : {
+              endblock: endblock.toString(),
+            }),
+        page: page.toString(),
+        offset: offset.toString(),
+        sort,
+      },
+      resultSchema,
+      headers,
+    })
+    return result.map((v) => ({
+      blockNumber: v.blockNumber,
+      contractAddress: v.contractAddress,
+      from: v.from,
+      gas: v.gas,
+      isError: v.isError,
+      timestamp: v.timeStamp * 1000,
+      to: v.to,
+      txHash: v.hash,
+      value: v.value,
+    }))
+  } catch (error) {
+    if (error instanceof Error && error.message === 'No transactions found') {
+      return []
+    }
+    throw error
+  }
+}

package/explorer/etherscanV2/getListOfNormalTransactionsByAddress.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod'
+import type { Hex } from '../../types'
+import { bigintTextSchema, lowerHexSchema } from '../../types/primitive'
+import type { TransactionIndex } from '../../types/transactionIndex'
+import type { EtherscanV2Client } from './client'
+
+type GetListOfNormalTransactionsByAddressParameters = {
+  client: EtherscanV2Client
+  address: Hex
+  startblock?: number
+  endblock?: number
+  page?: number
+  offset?: number
+  sort?: 'asc' | 'desc'
+  headers?: Record<string, string>
+}
+
+const transactionSchema = z.object({
+  blockNumber: z.string().regex(/^\d+$/).transform(Number),
+  hash: lowerHexSchema,
+  timeStamp: z.string().regex(/^\d+$/).transform(Number),
+  input: lowerHexSchema,
+  value: bigintTextSchema,
+})
+const resultSchema = z.array(transactionSchema)
+
+/** {@link https://docs.etherscan.io/etherscan-v2/api-endpoints/accounts#get-a-list-of-normal-transactions-by-address} */
+export const getListOfNormalTransactionsByAddress = async ({
+  client,
+  address,
+  startblock = 0,
+  endblock,
+  page = 1,
+  offset = 10_000,
+  sort = 'asc',
+  headers,
+}: GetListOfNormalTransactionsByAddressParameters): Promise<
+  TransactionIndex[]
+> => {
+  try {
+    const result = await client.get({
+      path: '',
+      query: {
+        module: 'account',
+        action: 'txlist',
+        address,
+        startblock: startblock.toString(),
+        ...(endblock === undefined
+          ? {}
+          : {
+              endblock: endblock.toString(),
+            }),
+        page: page.toString(),
+        offset: offset.toString(),
+        sort,
+      },
+      resultSchema,
+      headers,
+    })
+    return result.map((v) => ({
+      blockNumber: v.blockNumber,
+      hash: v.hash,
+      timestamp: v.timeStamp * 1000,
+      input: v.input,
+      value: v.value,
+    }))
+  } catch (error) {
+    if (error instanceof Error && error.message === 'No transactions found') {
+      return []
+    }
+    throw error
+  }
+}

package/explorer/index.ts

@@ -1,4 +1,5 @@
 export { createEtherscan } from './etherscan/create'
+export { createEtherscanV2 } from './etherscanV2/create'
 export type { Explorer } from './types'
 export { createMoralisExplorer } from './moralis/create'
 export { createNoApiExplorer } from './noApiExplorer/create'

package/index.ts

@@ -158,6 +158,7 @@ export { createClient } from './client'
 export {
   createBlockscout,
   createEtherscan,
+  createEtherscanV2,
   createNoApiExplorer,
 } from './explorer'
 export type { Explorer } from './explorer'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xtorch/evm",
-  "version": "0.0.126",
+  "version": "0.0.128",
   "description": "Cryptorch EVM extension",
   "keywords": [
     "cryptorch",
@@ -41,6 +41,6 @@
     "@0xtorch/core": "^0.0.60",
     "abitype": "^1.0.6",
     "viem": "2.21.18",
-    "zod": "^3.23.8"
+    "zod": "3.23.8"
   }
 }