@0xtorch/evm 0.0.51 → 0.0.53

package/_types/explorers/definitions/blockscout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blockscout.d.ts","sourceRoot":"","sources":["../../../explorers/definitions/blockscout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAYhE,KAAK,0BAA0B,CAC7B,KAAK,SAAS,MAAM,EACpB,IAAI,SAAS,MAAM,EACnB,OAAO,SAAS,MAAM,IACpB;IACF,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qEA6I6B,MAAM;4DAMtB,MAAM;;;;kFAcK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAqCpC,QAAQ;4BACH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;4BAwCN,MAAM;;;;;;;;uBAyDX,QAAQ;4BACH,MAAM;;CAiC9B,CAAA"}
+{"version":3,"file":"blockscout.d.ts","sourceRoot":"","sources":["../../../explorers/definitions/blockscout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAarE,KAAK,0BAA0B,CAC7B,KAAK,SAAS,MAAM,EACpB,IAAI,SAAS,MAAM,EACnB,OAAO,SAAS,MAAM,IACpB;IACF,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qEA6I6B,MAAM;4DAMtB,MAAM;;;;kFAcK,MAAM;;;;;;;;;;;;qBAYtC,MAAM;yBACF,GAAG;cACd,GAAG;gBACD,SAAS,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAoDP,QAAQ;4BACH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;4BAwCN,MAAM;;;;;;;;uBAyDX,QAAQ;4BACH,MAAM;;CAiC9B,CAAA"}

package/_types/explorers/definitions/etherscan.d.ts

@@ -1,5 +1,5 @@
 import type { Logger } from '@0xtorch/core';
-import type { InternalTransaction, LowerHex } from '../../types';
+import type { Hex, InternalTransaction, LowerHex } from '../../types';
 type CreateEtherscanExplorerParameters<TName extends string, TUrl extends string, TApiUrl extends string> = {
     readonly name: TName;
     readonly url: TUrl;
@@ -49,11 +49,23 @@ export declare const createEtherscan: <TName extends string, TUrl extends string
         name: string;
         abi: string;
     } | undefined>;
-    readonly getContractCreations: (addresses: readonly `0x${string}`[], logger?: Logger) => Promise<readonly Readonly<{
+    readonly getContractCreations: (addresses: readonly `0x${string}`[], logger?: Logger) => Promise<{
         contractAddress: `0x${Lowercase<string>}`;
-        contractCreator: `0x${Lowercase<string>}`;
-        txHash: `0x${Lowercase<string>}`;
-    }>[]>;
+        contractCreator: `0x${Lowercase<string>}` | undefined;
+        txHash: `0x${string}` | undefined;
+    }[]>;
+    readonly getEventLogs: ({ address, topic0, fromBlock, toBlock, logger }: {
+        readonly address: `0x${string}`;
+        readonly topic0: `0x${string}`;
+        readonly fromBlock?: bigint | undefined;
+        readonly toBlock?: bigint | undefined;
+        readonly logger?: Logger | undefined;
+    }) => Promise<{
+        blockNumber: bigint;
+        transactionHash: Hex;
+        data: Hex;
+        topics: readonly Hex[];
+    }[]>;
     readonly getInternalTransactionOfTransaction: ({ hash, nativeCurrency, logger, }: {
         readonly hash: `0x${string}`;
         readonly nativeCurrency: {

package/_types/explorers/definitions/etherscan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"etherscan.d.ts","sourceRoot":"","sources":["../../../explorers/definitions/etherscan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAchE,KAAK,iCAAiC,CACpC,KAAK,SAAS,MAAM,EACpB,IAAI,SAAS,MAAM,EACnB,OAAO,SAAS,MAAM,IACpB;IACF,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qEAiN8B,MAAM;4DAOtB,MAAM;;;;kFAeK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAuCpC,QAAQ;4BACH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;4BAyCN,MAAM;;;;;;;;uBA2DX,QAAQ;4BACH,MAAM;;CAqG9B,CAAA"}
+{"version":3,"file":"etherscan.d.ts","sourceRoot":"","sources":["../../../explorers/definitions/etherscan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAerE,KAAK,iCAAiC,CACpC,KAAK,SAAS,MAAM,EACpB,IAAI,SAAS,MAAM,EACnB,OAAO,SAAS,MAAM,IACpB;IACF,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qEAiN8B,MAAM;4DAOtB,MAAM;;;;kFAeK,MAAM;;;;;;;;;;;;qBAiBtC,MAAM;yBACF,GAAG;cACd,GAAG;gBACD,SAAS,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAmDP,QAAQ;4BACH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;4BAyCN,MAAM;;;;;;;;uBA2DX,QAAQ;4BACH,MAAM;;CAqG9B,CAAA"}

package/_types/explorers/definitions/roninExplorer.d.ts

@@ -48,6 +48,13 @@ export declare const createRoninExplorer: <TName extends string, TUrl extends st
     readonly getBlockNumberOfTimestamp: () => never;
     readonly getContract: (_: `0x${string}`, logger: Logger | undefined) => Promise<undefined>;
     readonly getContractCreations: (_: readonly `0x${string}`[], logger?: Logger) => never;
+    readonly getEventLogs: ({ logger }: {
+        readonly address: `0x${string}`;
+        readonly topic0: `0x${string}`;
+        readonly fromBlock?: bigint | undefined;
+        readonly toBlock?: bigint | undefined;
+        readonly logger?: Logger | undefined;
+    }) => never;
     readonly getInternalTransactionOfTransaction: ({ hash, nativeCurrency, logger, }: {
         readonly hash: `0x${string}`;
         readonly nativeCurrency: {

package/_types/explorers/definitions/roninExplorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roninExplorer.d.ts","sourceRoot":"","sources":["../../../explorers/definitions/roninExplorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAQ3C,KAAK,6BAA6B,CAChC,KAAK,SAAS,MAAM,EACpB,IAAI,SAAS,MAAM,EACnB,OAAO,SAAS,MAAM,IACpB;IACF,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0EAwGO,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAsCtB,QAAQ;4BACH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAmDX,QAAQ;4BACH,MAAM;;CAsC9B,CAAA"}
+{"version":3,"file":"roninExplorer.d.ts","sourceRoot":"","sources":["../../../explorers/definitions/roninExplorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAQ3C,KAAK,6BAA6B,CAChC,KAAK,SAAS,MAAM,EACpB,IAAI,SAAS,MAAM,EACnB,OAAO,SAAS,MAAM,IACpB;IACF,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0EAwGO,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA4CtB,QAAQ;4BACH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAmDX,QAAQ;4BACH,MAAM;;CAsC9B,CAAA"}

package/_types/explorers/definitions/routescan.d.ts

@@ -14,6 +14,7 @@ export declare const createRoutescan: <TName extends string, TUrl extends string
     readonly getBlockNumberOfTimestamp: () => Promise<never>;
     readonly getContract: () => Promise<never>;
     readonly getContractCreations: () => Promise<never>;
+    readonly getEventLogs: () => Promise<never>;
     readonly getInternalTransactionOfTransaction: () => Promise<never>;
     readonly getAddressTransactionHashesWithTimestamp: () => Promise<never>;
     readonly getAddressInternalTransactionsWithTimestamp: () => Promise<never>;

package/_types/explorers/definitions/routescan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routescan.d.ts","sourceRoot":"","sources":["../../../explorers/definitions/routescan.ts"],"names":[],"mappings":"AAEA,KAAK,iCAAiC,CACpC,KAAK,SAAS,MAAM,EACpB,IAAI,SAAS,MAAM,EACnB,OAAO,SAAS,MAAM,IACpB;IACF,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;CA+DxB,CAAA"}
+{"version":3,"file":"routescan.d.ts","sourceRoot":"","sources":["../../../explorers/definitions/routescan.ts"],"names":[],"mappings":"AAEA,KAAK,iCAAiC,CACpC,KAAK,SAAS,MAAM,EACpB,IAAI,SAAS,MAAM,EACnB,OAAO,SAAS,MAAM,IACpB;IACF,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;CAoExB,CAAA"}

package/_types/explorers/externals/blockscout/getEventLogsByAddressAndTopics.d.ts

@@ -0,0 +1,39 @@
+import type { Logger } from '@0xtorch/core';
+import { z } from 'zod';
+import type { Hex } from '../../../types';
+type GetEventLogsByAddressAndTopicsParameters = {
+    readonly apiEndpoint: string;
+    readonly address: Hex;
+    readonly topic0: Hex;
+    readonly fromBlock: bigint | 'latest';
+    readonly toBlock: bigint | 'latest';
+    readonly logger?: Logger;
+};
+declare const logSchema: z.ZodObject<{
+    address: z.ZodEffects<z.ZodString, `0x${Lowercase<string>}`, string>;
+    topics: z.ZodEffects<z.ZodArray<z.ZodNullable<z.ZodEffects<z.ZodString, `0x${string}`, string>>, "many">, `0x${string}`[], (string | null)[]>;
+    data: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    blockNumber: z.ZodEffects<z.ZodString, bigint, string>;
+    logIndex: z.ZodEffects<z.ZodString, bigint, string>;
+    transactionHash: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+}, "strip", z.ZodTypeAny, {
+    address: `0x${Lowercase<string>}`;
+    transactionHash: `0x${string}`;
+    blockNumber: bigint;
+    data: `0x${string}`;
+    logIndex: bigint;
+    topics: `0x${string}`[];
+}, {
+    address: string;
+    transactionHash: string;
+    blockNumber: string;
+    data: string;
+    logIndex: string;
+    topics: (string | null)[];
+}>;
+type Log = Readonly<z.infer<typeof logSchema>>;
+type ReturnType = readonly Log[];
+/** {@link https://docs.blockscout.com/developer-support/api/rpc-endpoints/logs#get-event-logs-by-address-and-or-topic-s} */
+export declare const getEventLogsByAddressAndTopics: ({ apiEndpoint, address, topic0, fromBlock, toBlock, logger, }: GetEventLogsByAddressAndTopicsParameters) => Promise<ReturnType>;
+export {};
+//# sourceMappingURL=getEventLogsByAddressAndTopics.d.ts.map

package/_types/explorers/externals/blockscout/getEventLogsByAddressAndTopics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEventLogsByAddressAndTopics.d.ts","sourceRoot":"","sources":["../../../../explorers/externals/blockscout/getEventLogsByAddressAndTopics.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,wCAAwC,GAAG;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAA;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;EA8Bb,CAAA;AAQF,KAAK,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC,CAAA;AAC9C,KAAK,UAAU,GAAG,SAAS,GAAG,EAAE,CAAA;AAEhC,4HAA4H;AAC5H,eAAO,MAAM,8BAA8B,kEAOxC,wCAAwC,KAAG,QAAQ,UAAU,CAwC/D,CAAA"}

package/_types/explorers/externals/blockscout/index.d.ts

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

package/_types/explorers/externals/blockscout/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../explorers/externals/blockscout/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,gCAAgC,EAAE,MAAM,oCAAoC,CAAA;AACrF,OAAO,EAAE,wCAAwC,EAAE,MAAM,4CAA4C,CAAA;AACrG,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAA;AACjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../explorers/externals/blockscout/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,8BAA8B,EAAE,MAAM,kCAAkC,CAAA;AACjF,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAA;AACrF,OAAO,EAAE,wCAAwC,EAAE,MAAM,4CAA4C,CAAA;AACrG,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAA;AACjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAA"}

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

@@ -9,12 +9,12 @@ type GetContractCreationsParameters = {
 };
 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>;
+    contractCreator: z.ZodUnion<[z.ZodEffects<z.ZodString, `0x${Lowercase<string>}`, string>, z.ZodEffects<z.ZodString, undefined, string>]>;
+    txHash: z.ZodUnion<[z.ZodEffects<z.ZodString, `0x${string}`, string>, z.ZodEffects<z.ZodString, undefined, string>]>;
 }, "strip", z.ZodTypeAny, {
     contractAddress: `0x${Lowercase<string>}`;
-    contractCreator: `0x${Lowercase<string>}`;
-    txHash: `0x${Lowercase<string>}`;
+    contractCreator?: `0x${Lowercase<string>}` | undefined;
+    txHash?: `0x${string}` | undefined;
 }, {
     contractAddress: string;
     contractCreator: string;

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;EAmB1B,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/getEventLogsByAddressAndTopics.d.ts

@@ -0,0 +1,41 @@
+import type { Logger } from '@0xtorch/core';
+import { z } from 'zod';
+import type { Hex } from '../../../types';
+type GetEventLogsByAddressAndTopicsParameters = {
+    readonly apiEndpoint: string;
+    readonly apiKey: string;
+    readonly address: Hex;
+    readonly topic0: Hex;
+    readonly fromBlock?: bigint;
+    readonly toBlock?: bigint;
+    readonly page?: number;
+    readonly logger?: Logger;
+};
+declare const logSchema: z.ZodObject<{
+    address: z.ZodEffects<z.ZodString, `0x${Lowercase<string>}`, string>;
+    topics: z.ZodArray<z.ZodEffects<z.ZodString, `0x${string}`, string>, "many">;
+    data: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    blockNumber: z.ZodEffects<z.ZodString, bigint, string>;
+    logIndex: z.ZodEffects<z.ZodString, bigint, string>;
+    transactionHash: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+}, "strip", z.ZodTypeAny, {
+    address: `0x${Lowercase<string>}`;
+    transactionHash: `0x${string}`;
+    blockNumber: bigint;
+    data: `0x${string}`;
+    logIndex: bigint;
+    topics: `0x${string}`[];
+}, {
+    address: string;
+    transactionHash: string;
+    blockNumber: string;
+    data: string;
+    logIndex: string;
+    topics: string[];
+}>;
+type Log = Readonly<z.infer<typeof logSchema>>;
+type ReturnType = readonly Log[];
+/** {@link https://docs.etherscan.io/api-endpoints/logs#get-event-logs-by-address-filtered-by-topics} */
+export declare const getEventLogsByAddressAndTopics: ({ apiEndpoint, apiKey, address, topic0, fromBlock, toBlock, page, logger, }: GetEventLogsByAddressAndTopicsParameters) => Promise<ReturnType>;
+export {};
+//# sourceMappingURL=getEventLogsByAddressAndTopics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getEventLogsByAddressAndTopics.d.ts","sourceRoot":"","sources":["../../../../explorers/externals/etherscan/getEventLogsByAddressAndTopics.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,wCAAwC,GAAG;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAA;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;EA2Bb,CAAA;AAQF,KAAK,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC,CAAA;AAC9C,KAAK,UAAU,GAAG,SAAS,GAAG,EAAE,CAAA;AAEhC,wGAAwG;AACxG,eAAO,MAAM,8BAA8B,gFASxC,wCAAwC,KAAG,QAAQ,UAAU,CA6C/D,CAAA"}

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

@@ -4,6 +4,7 @@ export { getContractCreations } from './getContractCreations';
 export { getErc1155TokenTransfersByAddress } from './getErc1155TokenTransfersByAddress';
 export { getErc20TokenTransfersByAddress } from './getErc20TokenTransfersByAddress';
 export { getErc721TokenTransfersByAddress } from './getErc721TokenTransfersByAddress';
+export { getEventLogsByAddressAndTopics } from './getEventLogsByAddressAndTopics';
 export { getInternalTransactionsByAddress } from './getInternalTransactionsByAddress';
 export { getInternalTransactionsByTransactionHash } from './getInternalTransactionsByTransactionHash';
 export { getNormalTransactionsByAddress } from './getNormalTransactionsByAddress';

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,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,8BAA8B,EAAE,MAAM,kCAAkC,CAAA;AACjF,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

@@ -1,5 +1,5 @@
 import type { CryptoCurrency, Logger } from '@0xtorch/core';
-import type { Hex, InternalTransaction } from '../types';
+import type { Hex, InternalTransaction, LowerHex } from '../types';
 export type Explorer = {
     readonly name: string;
     readonly url: string;
@@ -13,6 +13,7 @@ export type Explorer = {
     readonly getBlockNumberOfTimestamp: (timestamp: number, logger?: Logger) => Promise<bigint>;
     readonly getContract: FunctionGetContract;
     readonly getContractCreations: FunctionGetContractCreations;
+    readonly getEventLogs: FunctionGetEventLogs;
     readonly getInternalTransactionOfTransaction: FunctionGetInternalTransactionOfTransaction;
 };
 type FunctionGetAddressTransactionHashes = (parameters: {
@@ -66,9 +67,21 @@ type FunctionGetContract = (address: Hex, logger?: Logger) => Promise<{
     readonly abi: string;
 } | undefined>;
 type FunctionGetContractCreations = (addresses: readonly Hex[], logger?: Logger) => Promise<readonly {
-    readonly contractAddress: Hex;
-    readonly contractCreator: Hex;
-    readonly txHash: Hex;
+    readonly contractAddress: LowerHex;
+    readonly contractCreator: LowerHex | undefined;
+    readonly txHash: Hex | undefined;
+}[]>;
+type FunctionGetEventLogs = (parameters: {
+    readonly address: Hex;
+    readonly topic0: Hex;
+    readonly fromBlock?: bigint;
+    readonly toBlock?: bigint;
+    readonly logger?: Logger;
+}) => Promise<readonly {
+    blockNumber: bigint;
+    transactionHash: Hex;
+    data: Hex;
+    topics: readonly Hex[];
 }[]>;
 type FunctionGetInternalTransactionOfTransaction = (parameters: {
     readonly hash: Hex;

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/createViemInstance.ts

@@ -81,12 +81,14 @@ export const createViemInstance = (() => {
       })
       return await caller(client)
     } catch (error) {
-      // TODO 後で消す
-      console.debug(error)
       if (error instanceof HttpRequestError && error.status === 429) {
+        // TODO 後で消す
+        console.debug(error)
         cooldownEndpoint(endpoint)
         return await call(chain, caller, timeout - (Date.now() - start))
       } else if (error instanceof TransactionReceiptNotFoundError) {
+        // TODO 後で消す
+        console.debug(error)
         cooldownEndpoint(endpoint, 5000)
         return await call(chain, caller, timeout - (Date.now() - start))
       }

package/decoder/tests.ts

@@ -76,6 +76,9 @@ const testExplorer: Explorer = {
   getContractCreations: () => {
     throw new Error('Not implemented')
   },
+  getEventLogs: () => {
+    throw new Error('Not implemented')
+  },
   getInternalTransactionOfTransaction: () => {
     throw new Error('Not implemented')
   },

package/explorers/definitions/blockscout.ts

@@ -1,9 +1,10 @@
 import type { Logger } from '@0xtorch/core'
-import type { InternalTransaction, LowerHex } from '../../types'
+import type { Hex, InternalTransaction, LowerHex } from '../../types'
 import {
   getContractCreations as apiGetContractCreations,
   getBlockNumberOfTimestamp,
   getContractByAddress,
+  getEventLogsByAddressAndTopics,
   getInternalTransactionsByAddress,
   getInternalTransactionsByTransactionHash,
   getNormalTransactionsByAddress,
@@ -190,6 +191,36 @@ export const createBlockscout = <
       })
       return creations
     },
+    getEventLogs: async ({ address, topic0, fromBlock, toBlock, logger }) => {
+      const loop = true
+      let mut_fromBlock = fromBlock ?? 0n
+      const mut_logs: {
+        blockNumber: bigint
+        transactionHash: Hex
+        data: Hex
+        topics: readonly Hex[]
+      }[] = []
+      while (loop) {
+        const logs = await getEventLogsByAddressAndTopics({
+          apiEndpoint: apiUrl,
+          address,
+          topic0,
+          fromBlock: mut_fromBlock,
+          toBlock: toBlock ?? 'latest',
+          logger,
+        })
+        mut_logs.push(...logs)
+        if (logs.length < 1000) {
+          break
+        }
+        const maxBlockNumber = logs.reduce(
+          (max, { blockNumber }) => (max < blockNumber ? blockNumber : max),
+          logs[0].blockNumber,
+        )
+        mut_fromBlock = maxBlockNumber
+      }
+      return mut_logs
+    },
     getInternalTransactionOfTransaction: async ({
       hash,
       nativeCurrency,

package/explorers/definitions/etherscan.ts

@@ -1,5 +1,5 @@
 import type { Logger } from '@0xtorch/core'
-import type { InternalTransaction, LowerHex } from '../../types'
+import type { Hex, InternalTransaction, LowerHex } from '../../types'
 import {
   getContractCreations as apiGetContractCreations,
   getBlockNumberOfTimestamp,
@@ -7,6 +7,7 @@ import {
   getErc1155TokenTransfersByAddress,
   getErc20TokenTransfersByAddress,
   getErc721TokenTransfersByAddress,
+  getEventLogsByAddressAndTopics,
   getInternalTransactionsByAddress,
   getInternalTransactionsByTransactionHash,
   getNormalTransactionsByAddress,
@@ -262,7 +263,39 @@ export const createEtherscan = <
         addresses,
         logger,
       })
-      return creations
+      return creations.map((creation) => ({
+        contractAddress: creation.contractAddress,
+        contractCreator: creation.contractCreator,
+        txHash: creation.txHash,
+      }))
+    },
+    getEventLogs: async ({ address, topic0, fromBlock, toBlock, logger }) => {
+      const loop = true
+      let mut_page: number | undefined
+      const mut_logs: {
+        blockNumber: bigint
+        transactionHash: Hex
+        data: Hex
+        topics: readonly Hex[]
+      }[] = []
+      while (loop) {
+        const logs = await getEventLogsByAddressAndTopics({
+          apiEndpoint: apiUrl,
+          apiKey,
+          address,
+          topic0,
+          fromBlock,
+          toBlock,
+          page: mut_page,
+          logger,
+        })
+        mut_logs.push(...logs)
+        if (logs.length < 1000) {
+          break
+        }
+        mut_page = (mut_page ?? 0) + 1
+      }
+      return mut_logs
     },
     getInternalTransactionOfTransaction: async ({
       hash,

package/explorers/definitions/roninExplorer.ts

@@ -130,6 +130,12 @@ export const createRoninExplorer = <
       }
       throw new Error('Not supported')
     },
+    getEventLogs: ({ logger }) => {
+      if (logger !== undefined) {
+        logger.info('getEventLogs is not supported on Ronin Explorer')
+      }
+      throw new Error('Not supported')
+    },
     getInternalTransactionOfTransaction: async ({
       hash,
       nativeCurrency,

package/explorers/definitions/routescan.ts

@@ -54,6 +54,11 @@ export const createRoutescan = <
       await new Promise((resolve) => setTimeout(resolve))
       throw new Error('not implemented')
     },
+    getEventLogs: 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/getEventLogsByAddressAndTopics.ts

@@ -0,0 +1,105 @@
+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 GetEventLogsByAddressAndTopicsParameters = {
+  readonly apiEndpoint: string
+  readonly address: Hex
+  readonly topic0: Hex
+  readonly fromBlock: bigint | 'latest'
+  readonly toBlock: bigint | 'latest'
+  readonly logger?: Logger
+}
+
+const logSchema = z.object({
+  address: z
+    .string()
+    .regex(/^0x[\da-f]{40}$/)
+    .transform((x) => (isHex(x) ? toLowerHex(x) : '0x')),
+  topics: z
+    .array(
+      z
+        .string()
+        .regex(/^0x[\da-f]{64}$/)
+        .transform((x) => (isHex(x) ? x : '0x'))
+        .nullable(),
+    )
+    .transform((x) => x.filter((y): y is Hex => y !== null)),
+  data: z
+    .string()
+    .regex(/^0x[\da-f]*$/)
+    .transform((x) => (isHex(x) ? x : '0x')),
+  blockNumber: z
+    .string()
+    .regex(/^0x[\da-f]*$/)
+    .transform(BigInt),
+  logIndex: z
+    .string()
+    .regex(/^0x[\da-f]*$/)
+    .transform(BigInt),
+  transactionHash: z
+    .string()
+    .regex(/^0x[\da-f]{64}$/)
+    .transform((x) => (isHex(x) ? x : '0x')),
+})
+
+const responseSchema = z.object({
+  status: z.string(),
+  message: z.string(),
+  result: z.union([z.array(logSchema), z.string()]).nullable(),
+})
+
+type Log = Readonly<z.infer<typeof logSchema>>
+type ReturnType = readonly Log[]
+
+/** {@link https://docs.blockscout.com/developer-support/api/rpc-endpoints/logs#get-event-logs-by-address-and-or-topic-s} */
+export const getEventLogsByAddressAndTopics = async ({
+  apiEndpoint,
+  address,
+  topic0,
+  fromBlock,
+  toBlock,
+  logger,
+}: GetEventLogsByAddressAndTopicsParameters): Promise<ReturnType> => {
+  try {
+    const { status, message, result } = await createBlockscoutClient(
+      apiEndpoint,
+    ).get(
+      '',
+      {
+        module: 'logs',
+        action: 'getLogs',
+        address,
+        topic0,
+        fromBlock: fromBlock.toString(),
+        toBlock: toBlock.toString(),
+      },
+      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 getEventLogsByAddressAndTopics({
+        apiEndpoint,
+        address,
+        topic0,
+        fromBlock,
+        toBlock,
+        logger,
+      })
+    }
+    throw error
+  }
+}

package/explorers/externals/blockscout/index.ts

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

package/explorers/externals/etherscan/getContractCreations.ts

@@ -16,14 +16,20 @@ const contractCreationSchema = z.object({
     .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')),
+  contractCreator: z.union([
+    z
+      .string()
+      .regex(/^0x[\da-f]{40}$/)
+      .transform((x) => (isHex(x) ? toLowerHex(x) : '0x')),
+    z.string().transform(() => undefined),
+  ]),
+  txHash: z.union([
+    z
+      .string()
+      .regex(/^0x[\da-f]{64}$/)
+      .transform((x) => (isHex(x) ? x : '0x')),
+    z.string().transform(() => undefined),
+  ]),
 })
 
 const responseSchema = z.object({