@0xtorch/evm 0.0.46 → 0.0.47

package/explorers/definitions/roninExplorer.ts

@@ -1,3 +1,4 @@
+import type { Logger } from '@0xtorch/core'
 import type { Hex } from 'viem'
 import type { LowerHex } from '../../types'
 import {
@@ -123,6 +124,12 @@ export const createRoninExplorer = <
       }
       return Promise.resolve(undefined)
     },
+    getContractCreations: (_, logger?: Logger) => {
+      if (logger !== undefined) {
+        logger.info('getContractCreations is not supported on Ronin Explorer')
+      }
+      throw new Error('Not supported')
+    },
     getInternalTransactionOfTransaction: async ({
       hash,
       nativeCurrency,

package/explorers/definitions/routescan.ts

@@ -49,6 +49,11 @@ export const createRoutescan = <
       await new Promise((resolve) => setTimeout(resolve))
       throw new Error('not implemented')
     },
+    getContractCreations: async () => {
+      // TODO implement
+      await new Promise((resolve) => setTimeout(resolve))
+      throw new Error('not implemented')
+    },
     getInternalTransactionOfTransaction: async () => {
       // TODO implement
       await new Promise((resolve) => setTimeout(resolve))

package/explorers/externals/blockscout/getContractCreations.ts

@@ -0,0 +1,85 @@
+import type { Logger } from '@0xtorch/core'
+import { z } from 'zod'
+import type { Hex } from '../../../types'
+import { isHex, toLowerHex } from '../../../types'
+import { createBlockscoutClient } from './middleware'
+
+type GetContractCreationsParameters = {
+  readonly apiEndpoint: string
+  readonly addresses: readonly Hex[]
+  readonly logger?: Logger
+}
+
+const contractCreationSchema = z.object({
+  contractAddress: z
+    .string()
+    .regex(/^0x[\da-f]{40}$/)
+    .transform((x) => (isHex(x) ? toLowerHex(x) : '0x')),
+  contractCreator: z
+    .string()
+    .regex(/^0x[\da-f]{40}$/)
+    .transform((x) => (isHex(x) ? toLowerHex(x) : '0x')),
+  txHash: z
+    .string()
+    .regex(/^0x[\da-f]{64}$/)
+    .transform((x) => (isHex(x) ? toLowerHex(x) : '0x')),
+})
+
+const responseSchema = z.object({
+  status: z.string(),
+  message: z.string(),
+  result: z
+    .union([
+      z.array(contractCreationSchema),
+      z.array(z.object({})).transform(() => undefined),
+      z.string(),
+    ])
+    .nullable(),
+})
+
+type ContractCreation = Readonly<z.infer<typeof contractCreationSchema>>
+type ReturnType = readonly ContractCreation[]
+
+/** {@link https://docs.blockscout.com/developer-support/api/rpc-endpoints/contract#get-contract-creator-address-hash-and-creation-transaction-hash} */
+export const getContractCreations = async ({
+  apiEndpoint,
+  addresses,
+  logger,
+}: GetContractCreationsParameters): Promise<ReturnType> => {
+  try {
+    const { status, message, result } = await createBlockscoutClient(
+      apiEndpoint,
+    ).get(
+      '',
+      {
+        module: 'contract',
+        action: 'getcontractcreation',
+        contractaddresses: addresses.join(','),
+      },
+      responseSchema,
+      logger,
+    )
+    if (status !== '1' || result === null) {
+      const error =
+        typeof result === 'string' ? new Error(result) : new Error(message)
+      throw error
+    }
+    if (typeof result === 'string') {
+      throw new TypeError(result)
+    }
+    if (result === undefined) {
+      return []
+    }
+    return result
+  } catch (error) {
+    if (error instanceof Error && error.message === 'Max rate limit reached') {
+      await new Promise((resolve) => setTimeout(resolve, 1000))
+      return await getContractCreations({
+        apiEndpoint,
+        addresses,
+        logger,
+      })
+    }
+    throw error
+  }
+}

package/explorers/externals/blockscout/index.ts

@@ -1,5 +1,6 @@
 export { getBlockNumberOfTimestamp } from './getBlockNumberOfTimestamp'
 export { getContractByAddress } from './getContractByAddress'
+export { getContractCreations } from './getContractCreations'
 export { getInternalTransactionsByAddress } from './getInternalTransactionsByAddress'
 export { getInternalTransactionsByTransactionHash } from './getInternalTransactionsByTransactionHash'
 export { getNormalTransactionsByAddress } from './getNormalTransactionsByAddress'

package/explorers/externals/etherscan/getContractCreations.ts

@@ -0,0 +1,80 @@
+import type { Logger } from '@0xtorch/core'
+import { z } from 'zod'
+import type { Hex } from '../../../types'
+import { isHex, toLowerHex } from '../../../types'
+import { createEtherscanClient } from './middleware'
+
+type GetContractCreationsParameters = {
+  readonly apiEndpoint: string
+  readonly apiKey: string
+  readonly addresses: readonly Hex[]
+  readonly logger?: Logger
+}
+
+const contractCreationSchema = z.object({
+  contractAddress: z
+    .string()
+    .regex(/^0x[\da-f]{40}$/)
+    .transform((x) => (isHex(x) ? toLowerHex(x) : '0x')),
+  contractCreator: z
+    .string()
+    .regex(/^0x[\da-f]{40}$/)
+    .transform((x) => (isHex(x) ? toLowerHex(x) : '0x')),
+  txHash: z
+    .string()
+    .regex(/^0x[\da-f]{64}$/)
+    .transform((x) => (isHex(x) ? toLowerHex(x) : '0x')),
+})
+
+const responseSchema = z.object({
+  status: z.string(),
+  message: z.string(),
+  result: z.union([z.array(contractCreationSchema), z.string()]).nullable(),
+})
+
+type ContractCreation = Readonly<z.infer<typeof contractCreationSchema>>
+type ReturnType = readonly ContractCreation[]
+
+/** {@link https://docs.etherscan.io/api-endpoints/contracts#get-contract-creator-and-creation-tx-hash} */
+export const getContractCreations = async ({
+  apiEndpoint,
+  apiKey,
+  addresses,
+  logger,
+}: GetContractCreationsParameters): Promise<ReturnType> => {
+  try {
+    const { status, message, result } = await createEtherscanClient(
+      apiEndpoint,
+      apiKey,
+    ).get(
+      '',
+      {
+        module: 'contract',
+        action: 'getcontractcreation',
+        contractaddresses: addresses.join(','),
+      },
+      responseSchema,
+      logger,
+    )
+    if (status !== '1' || result === null) {
+      const error =
+        typeof result === 'string' ? new Error(result) : new Error(message)
+      throw error
+    }
+    if (typeof result === 'string') {
+      throw new TypeError(result)
+    }
+    return result
+  } catch (error) {
+    if (error instanceof Error && error.message === 'Max rate limit reached') {
+      await new Promise((resolve) => setTimeout(resolve, 1000))
+      return await getContractCreations({
+        apiEndpoint,
+        apiKey,
+        addresses,
+        logger,
+      })
+    }
+    throw error
+  }
+}

package/explorers/externals/etherscan/index.ts

@@ -1,5 +1,6 @@
 export { getBlockNumberOfTimestamp } from './getBlockNumberOfTimestamp'
 export { getContractByAddress } from './getContractByAddress'
+export { getContractCreations } from './getContractCreations'
 export { getErc1155TokenTransfersByAddress } from './getErc1155TokenTransfersByAddress'
 export { getErc20TokenTransfersByAddress } from './getErc20TokenTransfersByAddress'
 export { getErc721TokenTransfersByAddress } from './getErc721TokenTransfersByAddress'

package/explorers/types.ts

@@ -16,6 +16,7 @@ export type Explorer = {
     logger?: Logger,
   ) => Promise<bigint>
   readonly getContract: FunctionGetContract
+  readonly getContractCreations: FunctionGetContractCreations
   readonly getInternalTransactionOfTransaction: FunctionGetInternalTransactionOfTransaction
 }
 
@@ -86,6 +87,17 @@ type FunctionGetContract = (
   | undefined
 >
 
+type FunctionGetContractCreations = (
+  addresses: readonly Hex[],
+  logger?: Logger,
+) => Promise<
+  readonly {
+    readonly contractAddress: Hex
+    readonly contractCreator: Hex
+    readonly txHash: Hex
+  }[]
+>
+
 type FunctionGetInternalTransactionOfTransaction = (parameters: {
   readonly hash: Hex
   readonly nativeCurrency: CryptoCurrency

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xtorch/evm",
-  "version": "0.0.46",
+  "version": "0.0.47",
   "description": "Cryptorch EVM extension",
   "keywords": [
     "cryptorch",