@0xtorch/evm 0.0.52 → 0.0.53

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/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

@@ -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: {
@@ -70,6 +71,18 @@ type FunctionGetContractCreations = (addresses: readonly Hex[], logger?: Logger)
     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;
     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":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,KAAK,EAAE,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAElE,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,2BAA2B,EAAE,mCAAmC,CAAA;IACzE,QAAQ,CAAC,wCAAwC,EAAE,gDAAgD,CAAA;IACnG,QAAQ,CAAC,8BAA8B,EAAE,sCAAsC,CAAA;IAC/E,QAAQ,CAAC,2CAA2C,EAAE,mDAAmD,CAAA;IACzG,QAAQ,CAAC,6BAA6B,EAAE,qCAAqC,CAAA;IAC7E,QAAQ,CAAC,0CAA0C,EAAE,kDAAkD,CAAA;IACvG,QAAQ,CAAC,yBAAyB,EAAE,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,MAAM,CAAC,CAAA;IACpB,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAA;IACzC,QAAQ,CAAC,oBAAoB,EAAE,4BAA4B,CAAA;IAC3D,QAAQ,CAAC,mCAAmC,EAAE,2CAA2C,CAAA;CAC1F,CAAA;AAED,KAAK,mCAAmC,GAAG,CAAC,UAAU,EAAE;IACtD,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,KAAK,OAAO,CAAC,SAAS,GAAG,EAAE,CAAC,CAAA;AAE7B,KAAK,gDAAgD,GAAG,CAAC,UAAU,EAAE;IACnE,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,KAAK,OAAO,CACX,SAAS;IACP,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAA;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,EAAE,CACJ,CAAA;AAED,KAAK,sCAAsC,GAAG,CAAC,UAAU,EAAE;IACzD,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,KAAK,OAAO,CAAC,SAAS,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;AAExD,KAAK,mDAAmD,GAAG,CAAC,UAAU,EAAE;IACtE,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,KAAK,OAAO,CACX,SAAS,CAAC,mBAAmB,CAAC,SAAS,CAAC,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,CAC7E,CAAA;AAED,KAAK,qCAAqC,GAAG,CAAC,UAAU,EAAE;IACxD,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,KAAK,OAAO,CAAC,SAAS,GAAG,EAAE,CAAC,CAAA;AAE7B,KAAK,kDAAkD,GAAG,CAAC,UAAU,EAAE;IACrE,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,KAAK,OAAO,CACX,SAAS;IACP,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAA;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,EAAE,CACJ,CAAA;AAED,KAAK,mBAAmB,GAAG,CACzB,OAAO,EAAE,GAAG,EACZ,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CACR;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB,GACD,SAAS,CACZ,CAAA;AAED,KAAK,4BAA4B,GAAG,CAClC,SAAS,EAAE,SAAS,GAAG,EAAE,EACzB,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CACV,SAAS;IACP,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAA;IAClC,QAAQ,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC9C,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,CAAA;CACjC,EAAE,CACJ,CAAA;AAED,KAAK,2CAA2C,GAAG,CAAC,UAAU,EAAE;IAC9D,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAA;IAClB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,KAAK,OAAO,CAAC,SAAS,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA"}
+{"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,
@@ -268,6 +269,34 @@ export const createEtherscan = <
         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,
       nativeCurrency,

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

@@ -0,0 +1,111 @@
+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 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
+}
+
+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')),
+  ),
+  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.etherscan.io/api-endpoints/logs#get-event-logs-by-address-filtered-by-topics} */
+export const getEventLogsByAddressAndTopics = async ({
+  apiEndpoint,
+  apiKey,
+  address,
+  topic0,
+  fromBlock,
+  toBlock,
+  page,
+  logger,
+}: GetEventLogsByAddressAndTopicsParameters): Promise<ReturnType> => {
+  try {
+    const { status, message, result } = await createEtherscanClient(
+      apiEndpoint,
+      apiKey,
+    ).get(
+      '',
+      {
+        module: 'logs',
+        action: 'getLogs',
+        address,
+        topic0,
+        ...(fromBlock === undefined ? {} : { fromBlock: fromBlock.toString() }),
+        ...(toBlock === undefined ? {} : { toBlock: toBlock.toString() }),
+        ...(page === undefined ? {} : { page: page.toString() }),
+        offset: '1000',
+      },
+      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,
+        apiKey,
+        address,
+        topic0,
+        fromBlock,
+        toBlock,
+        page,
+        logger,
+      })
+    }
+    throw error
+  }
+}

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

@@ -17,6 +17,7 @@ export type Explorer = {
   ) => Promise<bigint>
   readonly getContract: FunctionGetContract
   readonly getContractCreations: FunctionGetContractCreations
+  readonly getEventLogs: FunctionGetEventLogs
   readonly getInternalTransactionOfTransaction: FunctionGetInternalTransactionOfTransaction
 }
 
@@ -98,6 +99,21 @@ type FunctionGetContractCreations = (
   }[]
 >
 
+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
   readonly nativeCurrency: CryptoCurrency

package/package.json

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