@0xtorch/evm 0.0.46 → 0.0.48

package/_types/explorers/externals/etherscan/getContractCreations.d.ts

@@ -0,0 +1,28 @@
+import type { Logger } from '@0xtorch/core';
+import { z } from 'zod';
+import type { Hex } from '../../../types';
+type GetContractCreationsParameters = {
+    readonly apiEndpoint: string;
+    readonly apiKey: string;
+    readonly addresses: readonly Hex[];
+    readonly logger?: Logger;
+};
+declare const contractCreationSchema: z.ZodObject<{
+    contractAddress: z.ZodEffects<z.ZodString, `0x${Lowercase<string>}`, string>;
+    contractCreator: z.ZodEffects<z.ZodString, `0x${Lowercase<string>}`, string>;
+    txHash: z.ZodEffects<z.ZodString, `0x${Lowercase<string>}`, string>;
+}, "strip", z.ZodTypeAny, {
+    contractAddress: `0x${Lowercase<string>}`;
+    contractCreator: `0x${Lowercase<string>}`;
+    txHash: `0x${Lowercase<string>}`;
+}, {
+    contractAddress: string;
+    contractCreator: string;
+    txHash: string;
+}>;
+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 declare const getContractCreations: ({ apiEndpoint, apiKey, addresses, logger, }: GetContractCreationsParameters) => Promise<ReturnType>;
+export {};
+//# sourceMappingURL=getContractCreations.d.ts.map

package/_types/explorers/externals/etherscan/getContractCreations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContractCreations.d.ts","sourceRoot":"","sources":["../../../../explorers/externals/etherscan/getContractCreations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAIzC,KAAK,8BAA8B,GAAG;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,EAAE,CAAA;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,QAAA,MAAM,sBAAsB;;;;;;;;;;;;EAa1B,CAAA;AAQF,KAAK,gBAAgB,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAA;AACxE,KAAK,UAAU,GAAG,SAAS,gBAAgB,EAAE,CAAA;AAE7C,0GAA0G;AAC1G,eAAO,MAAM,oBAAoB,gDAK9B,8BAA8B,KAAG,QAAQ,UAAU,CAoCrD,CAAA"}

package/_types/explorers/externals/etherscan/index.d.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/_types/explorers/externals/etherscan/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../explorers/externals/etherscan/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAA;AACvF,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAA;AACnF,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAA;AACrF,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAA;AACrF,OAAO,EAAE,wCAAwC,EAAE,MAAM,4CAA4C,CAAA;AACrG,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../explorers/externals/etherscan/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAA;AACvF,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAA;AACnF,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAA;AACrF,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAA;AACrF,OAAO,EAAE,wCAAwC,EAAE,MAAM,4CAA4C,CAAA;AACrG,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAA"}

package/_types/explorers/types.d.ts

@@ -12,6 +12,7 @@ export type Explorer = {
     readonly getAddressTokenTransferHashesWithTimestamp: FunctionGetAddressTokenTransferHashesWithTimestamp;
     readonly getBlockNumberOfTimestamp: (timestamp: number, logger?: Logger) => Promise<bigint>;
     readonly getContract: FunctionGetContract;
+    readonly getContractCreations: FunctionGetContractCreations;
     readonly getInternalTransactionOfTransaction: FunctionGetInternalTransactionOfTransaction;
 };
 type FunctionGetAddressTransactionHashes = (parameters: {
@@ -64,6 +65,11 @@ type FunctionGetContract = (address: Hex, logger?: Logger) => Promise<{
     readonly name: string;
     readonly abi: string;
 } | 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/_types/explorers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../explorers/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../explorers/types.ts"],"names":[],"mappings":"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"}

package/clients/externals/viem/middleware.ts

@@ -6,7 +6,12 @@ import type {
   MulticallReturnType,
   Chain as ViemChain,
 } from 'viem'
-import { CallExecutionError, createPublicClient, http } from 'viem'
+import {
+  CallExecutionError,
+  ContractFunctionExecutionError,
+  createPublicClient,
+  http,
+} from 'viem'
 import type { HttpRpc } from '../../../chains'
 import type { LowerHex } from '../../../types'
 import { bigIntMin } from '../../../utils'
@@ -244,6 +249,9 @@ export const createViemClient = (() => {
       mut_rpcs[chain.id] = unlockRpc(mut_rpcs[chain.id], url)
       return result
     } catch (error) {
+      if (error instanceof ContractFunctionExecutionError) {
+        throw error
+      }
       if (error instanceof Error) {
         mut_rpcs[chain.id] = saveRpcError(mut_rpcs[chain.id], url, error)
         if (logger !== undefined) {

package/decoder/tests.ts

@@ -73,6 +73,9 @@ const testExplorer: Explorer = {
     await new Promise((resolve) => setTimeout(resolve))
     return undefined
   },
+  getContractCreations: () => {
+    throw new Error('Not implemented')
+  },
   getInternalTransactionOfTransaction: () => {
     throw new Error('Not implemented')
   },

package/explorers/definitions/blockscout.ts

@@ -1,6 +1,7 @@
 import type { Logger } from '@0xtorch/core'
 import type { InternalTransaction, LowerHex } from '../../types'
 import {
+  getContractCreations as apiGetContractCreations,
   getBlockNumberOfTimestamp,
   getContractByAddress,
   getInternalTransactionsByAddress,
@@ -181,6 +182,14 @@ export const createBlockscout = <
         abi: contract.ABI,
       }
     },
+    getContractCreations: async (addresses, logger?: Logger) => {
+      const creations = await apiGetContractCreations({
+        apiEndpoint: apiUrl,
+        addresses,
+        logger,
+      })
+      return creations
+    },
     getInternalTransactionOfTransaction: async ({
       hash,
       nativeCurrency,

package/explorers/definitions/etherscan.ts

@@ -1,6 +1,7 @@
 import type { Logger } from '@0xtorch/core'
 import type { InternalTransaction, LowerHex } from '../../types'
 import {
+  getContractCreations as apiGetContractCreations,
   getBlockNumberOfTimestamp,
   getContractByAddress,
   getErc1155TokenTransfersByAddress,
@@ -254,6 +255,15 @@ export const createEtherscan = <
         abi: contract.ABI,
       }
     },
+    getContractCreations: async (addresses, logger?: Logger) => {
+      const creations = await apiGetContractCreations({
+        apiEndpoint: apiUrl,
+        apiKey,
+        addresses,
+        logger,
+      })
+      return creations
+    },
     getInternalTransactionOfTransaction: async ({
       hash,
       nativeCurrency,

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.48",
   "description": "Cryptorch EVM extension",
   "keywords": [
     "cryptorch",