@0xtorch/evm 0.0.126 → 0.0.127

package/_esm/explorer/etherscanV2/create.js

@@ -0,0 +1,195 @@
+import { createInternalTransactionId } from '../../utils/createInternalTransactionId';
+import { createEtherscanV2Client } from './client';
+import { getBlockNumberByTimestamp } from './getBlockNumberByTimestamp';
+import { getContractCreatorAndCreationTxHash } from './getContractCreatorAndCreationTxHash';
+import { getContractSourceCodeForVerifiedContract } from './getContractSourceCodeForVerifiedContract';
+import { getEventLogsByAddressFilteredByTopics } from './getEventLogsByAddressFilteredByTopics';
+import { getInternalTransactionsByTransactionHash } from './getInternalTransactionsByTransactionHash';
+import { getListOfErc20TokenTransferEventsByAddress } from './getListOfErc20TokenTransferEventsByAddress';
+import { getListOfErc721TokenTransferEventsByAddress } from './getListOfErc721TokenTransferEventsByAddress';
+import { getListOfErc1155TokenTransferEventsByAddress } from './getListOfErc1155TokenTransferEventsByAddress';
+import { getListOfInternalTransactionsByAddress } from './getListOfInternalTransactionsByAddress';
+import { getListOfNormalTransactionsByAddress } from './getListOfNormalTransactionsByAddress';
+export const createEtherscanV2 = ({ name, baseUrl, chainId, apiKey, proxyUrl, pageSize = 10_000, }) => {
+    const client = createEtherscanV2Client({
+        chainId,
+        apiKey,
+        proxyUrl,
+    });
+    return {
+        name,
+        baseUrl,
+        getAddressInternalTransactions: async ({ address, fromBlock, toBlock, headers, }) => {
+            const internalTransactions = new Map();
+            let startblock = fromBlock;
+            const endblock = toBlock;
+            while (true) {
+                const result = await getListOfInternalTransactionsByAddress({
+                    client,
+                    address,
+                    startblock,
+                    endblock,
+                    offset: pageSize,
+                    headers,
+                });
+                for (const transaction of result) {
+                    const id = createInternalTransactionId(transaction);
+                    if (!internalTransactions.has(id)) {
+                        internalTransactions.set(id, transaction);
+                    }
+                }
+                if (result.length < pageSize) {
+                    break;
+                }
+                const maxBlockNumber = Math.max(...result.map((x) => x.blockNumber));
+                startblock = maxBlockNumber;
+            }
+            return [...internalTransactions.values()];
+        },
+        getAddressTransactionIndexes: async ({ address, fromBlock, toBlock, headers, }) => {
+            const indexes = new Map();
+            let startblock = fromBlock;
+            const endblock = toBlock;
+            while (true) {
+                const result = await getListOfNormalTransactionsByAddress({
+                    client,
+                    address,
+                    startblock,
+                    endblock,
+                    offset: pageSize,
+                    headers,
+                });
+                for (const index of result) {
+                    if (!indexes.has(index.hash)) {
+                        indexes.set(index.hash, index);
+                    }
+                }
+                if (result.length < pageSize) {
+                    break;
+                }
+                const maxBlockNumber = Math.max(...result.map((x) => x.blockNumber));
+                startblock = maxBlockNumber;
+            }
+            return [...indexes.values()];
+        },
+        getAddressTokenTransferIndexes: async ({ address, fromBlock, toBlock, headers, }) => {
+            const indexes = new Map();
+            const erc20Transfers = [];
+            const endblock = toBlock;
+            // ERC20
+            let startblock = fromBlock;
+            while (true) {
+                const { indexes: resultIndexes, erc20Transfers: resultErc20Transfers } = await getListOfErc20TokenTransferEventsByAddress({
+                    client,
+                    address,
+                    startblock,
+                    endblock,
+                    offset: pageSize,
+                    headers,
+                });
+                for (const index of resultIndexes) {
+                    if (!indexes.has(index.hash)) {
+                        indexes.set(index.hash, index);
+                    }
+                }
+                erc20Transfers.push(...resultErc20Transfers);
+                if (resultIndexes.length < pageSize) {
+                    break;
+                }
+                const maxBlockNumber = Math.max(...resultIndexes.map((x) => x.blockNumber));
+                startblock = maxBlockNumber;
+            }
+            // ERC721
+            startblock = fromBlock;
+            while (true) {
+                const result = await getListOfErc721TokenTransferEventsByAddress({
+                    client,
+                    address,
+                    startblock,
+                    endblock,
+                    offset: pageSize,
+                    headers,
+                });
+                for (const index of result) {
+                    if (!indexes.has(index.hash)) {
+                        indexes.set(index.hash, index);
+                    }
+                }
+                if (result.length < pageSize) {
+                    break;
+                }
+                const maxBlockNumber = Math.max(...result.map((x) => x.blockNumber));
+                startblock = maxBlockNumber;
+            }
+            // ERC1155
+            startblock = fromBlock;
+            while (true) {
+                const result = await getListOfErc1155TokenTransferEventsByAddress({
+                    client,
+                    address,
+                    startblock,
+                    endblock,
+                    offset: pageSize,
+                    headers,
+                });
+                for (const index of result) {
+                    if (!indexes.has(index.hash)) {
+                        indexes.set(index.hash, index);
+                    }
+                }
+                if (result.length < pageSize) {
+                    break;
+                }
+                const maxBlockNumber = Math.max(...result.map((x) => x.blockNumber));
+                startblock = maxBlockNumber;
+            }
+            return {
+                indexes: [...indexes.values()],
+                erc20Transfers,
+            };
+        },
+        getBlockNumberOfTimestamp: ({ timestamp, headers }) => getBlockNumberByTimestamp({
+            client,
+            timestamp: Math.floor(timestamp / 1000),
+            headers,
+        }),
+        getContract: ({ address, headers }) => getContractSourceCodeForVerifiedContract({
+            client,
+            address,
+            headers,
+        }),
+        getContractCreations: ({ addresses, headers }) => getContractCreatorAndCreationTxHash({
+            client,
+            contractaddresses: addresses,
+            headers,
+        }),
+        getEventLogs: async ({ address, topic0, fromBlock: fromBlockParam, toBlock, headers, }) => {
+            const logs = [];
+            let fromBlock = fromBlockParam ?? 0;
+            const maxPageSize = 10_000;
+            while (true) {
+                const result = await getEventLogsByAddressFilteredByTopics({
+                    client,
+                    address,
+                    topic0,
+                    fromBlock,
+                    toBlock,
+                    headers,
+                });
+                logs.push(...result);
+                if (result.length < maxPageSize) {
+                    break;
+                }
+                const maxBlockNumber = Math.max(...result.map((x) => x.blockNumber));
+                fromBlock = maxBlockNumber;
+            }
+            return logs;
+        },
+        getInternalTransactionOfTransaction: ({ hash, headers }) => getInternalTransactionsByTransactionHash({
+            client,
+            txhash: hash,
+            headers,
+        }),
+    };
+};
+//# sourceMappingURL=create.js.map

package/_esm/explorer/etherscanV2/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../explorer/etherscanV2/create.ts"],"names":[],"mappings":"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"}

package/_esm/explorer/etherscanV2/getBlockNumberByTimestamp.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+const resultSchema = z.string().regex(/^\d+$/).transform(Number);
+/** {@link https://docs.etherscan.io/etherscan-v2/api-endpoints/blocks#get-block-number-by-timestamp} */
+export const getBlockNumberByTimestamp = async ({ client, timestamp, closest = 'before', headers, }) => {
+    const result = await client.get({
+        path: '',
+        query: {
+            module: 'block',
+            action: 'getblocknobytime',
+            timestamp: timestamp.toString(),
+            closest,
+        },
+        resultSchema,
+        headers,
+    });
+    return result;
+};
+//# sourceMappingURL=getBlockNumberByTimestamp.js.map

package/_esm/explorer/etherscanV2/getBlockNumberByTimestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBlockNumberByTimestamp.js","sourceRoot":"","sources":["../../../explorer/etherscanV2/getBlockNumberByTimestamp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAWvB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;AAEhE,wGAAwG;AACxG,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,EAAE,EAC9C,MAAM,EACN,SAAS,EACT,OAAO,GAAG,QAAQ,EAClB,OAAO,GAC6B,EAAE,EAAE;IACxC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;QAC9B,IAAI,EAAE,EAAE;QACR,KAAK,EAAE;YACL,MAAM,EAAE,OAAO;YACf,MAAM,EAAE,kBAAkB;YAC1B,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE;YAC/B,OAAO;SACR;QACD,YAAY;QACZ,OAAO;KACR,CAAC,CAAA;IACF,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/_esm/explorer/etherscanV2/getContractCreatorAndCreationTxHash.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { addressPrimitiveSchema, lowerHexSchema } from '../../types/primitive';
+const contractCreationSchema = z.object({
+    contractAddress: addressPrimitiveSchema,
+    contractCreator: addressPrimitiveSchema,
+    txHash: lowerHexSchema,
+});
+const resultSchema = z.array(contractCreationSchema);
+/** {@link https://docs.etherscan.io/etherscan-v2/api-endpoints/contracts#get-contract-creator-and-creation-tx-hash} */
+export const getContractCreatorAndCreationTxHash = async ({ client, contractaddresses, headers, }) => {
+    try {
+        const result = await client.get({
+            path: '',
+            query: {
+                module: 'contract',
+                action: 'getcontractcreation',
+                contractaddresses: contractaddresses.join(','),
+            },
+            resultSchema,
+            headers,
+        });
+        return result;
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('No data found')) {
+            return [];
+        }
+        throw error;
+    }
+};
+//# sourceMappingURL=getContractCreatorAndCreationTxHash.js.map

package/_esm/explorer/etherscanV2/getContractCreatorAndCreationTxHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContractCreatorAndCreationTxHash.js","sourceRoot":"","sources":["../../../explorer/etherscanV2/getContractCreatorAndCreationTxHash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAU9E,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,eAAe,EAAE,sBAAsB;IACvC,eAAe,EAAE,sBAAsB;IACvC,MAAM,EAAE,cAAc;CACvB,CAAC,CAAA;AACF,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAA;AAEpD,uHAAuH;AACvH,MAAM,CAAC,MAAM,mCAAmC,GAAG,KAAK,EAAE,EACxD,MAAM,EACN,iBAAiB,EACjB,OAAO,GACuC,EAE9C,EAAE;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;YAC9B,IAAI,EAAE,EAAE;YACR,KAAK,EAAE;gBACL,MAAM,EAAE,UAAU;gBAClB,MAAM,EAAE,qBAAqB;gBAC7B,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC;aAC/C;YACD,YAAY;YACZ,OAAO;SACR,CAAC,CAAA;QACF,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YACtE,OAAO,EAAE,CAAA;QACX,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA"}

package/_esm/explorer/etherscanV2/getContractSourceCodeForVerifiedContract.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+const resultSchema = z.array(z.object({
+    ABI: z.string().optional(),
+    ContractName: z.string().optional(),
+}));
+/** {@link https://docs.etherscan.io/etherscan-v2/api-endpoints/contracts#get-contract-source-code-for-verified-contract-source-codes} */
+export const getContractSourceCodeForVerifiedContract = async ({ client, address, headers, }) => {
+    const result = await client.get({
+        path: '',
+        query: {
+            module: 'contract',
+            action: 'getsourcecode',
+            address,
+        },
+        resultSchema,
+        headers,
+    });
+    if (result.length === 0) {
+        return undefined;
+    }
+    const contract = result[0];
+    if (contract.ABI === undefined ||
+        contract.ABI.length === 0 ||
+        contract.ContractName === undefined ||
+        contract.ContractName.length === 0) {
+        return undefined;
+    }
+    return {
+        abi: contract.ABI,
+        name: contract.ContractName,
+    };
+};
+//# sourceMappingURL=getContractSourceCodeForVerifiedContract.js.map

package/_esm/explorer/etherscanV2/getContractSourceCodeForVerifiedContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContractSourceCodeForVerifiedContract.js","sourceRoot":"","sources":["../../../explorer/etherscanV2/getContractSourceCodeForVerifiedContract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAWvB,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAC1B,CAAC,CAAC,MAAM,CAAC;IACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CACH,CAAA;AAED,yIAAyI;AACzI,MAAM,CAAC,MAAM,wCAAwC,GAAG,KAAK,EAAE,EAC7D,MAAM,EACN,OAAO,EACP,OAAO,GAC4C,EAEnD,EAAE;IACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;QAC9B,IAAI,EAAE,EAAE;QACR,KAAK,EAAE;YACL,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,eAAe;YACvB,OAAO;SACR;QACD,YAAY;QACZ,OAAO;KACR,CAAC,CAAA;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IAC1B,IACE,QAAQ,CAAC,GAAG,KAAK,SAAS;QAC1B,QAAQ,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC;QACzB,QAAQ,CAAC,YAAY,KAAK,SAAS;QACnC,QAAQ,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAClC,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,OAAO;QACL,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,IAAI,EAAE,QAAQ,CAAC,YAAY;KAC5B,CAAA;AACH,CAAC,CAAA"}

package/_esm/explorer/etherscanV2/getEventLogsByAddressFilteredByTopics.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { addressPrimitiveSchema, lowerHexSchema } from '../../types/primitive';
+const logSchema = z.object({
+    address: addressPrimitiveSchema,
+    blockNumber: z
+        .string()
+        .regex(/^0x[\da-f]*$/)
+        .transform((x) => (x === '0x' ? 0 : Number(x))),
+    data: lowerHexSchema,
+    logIndex: z
+        .string()
+        .regex(/^0x[\da-f]*$/)
+        .transform((x) => (x === '0x' ? 0 : Number(x))),
+    topics: z
+        .array(lowerHexSchema.nullable())
+        .transform((x) => x.filter((v) => v !== null)),
+    transactionHash: lowerHexSchema,
+});
+const resultSchema = z.array(logSchema);
+/** {@link https://docs.etherscan.io/etherscan-v2/api-endpoints/logs#get-event-logs-by-address-filtered-by-topics} */
+export const getEventLogsByAddressFilteredByTopics = async ({ client, address, topic0, fromBlock, toBlock, headers, }) => {
+    try {
+        const result = await client.get({
+            path: '',
+            query: {
+                module: 'logs',
+                action: 'getLogs',
+                address,
+                topic0,
+                ...(fromBlock === undefined ? {} : { fromBlock: fromBlock.toString() }),
+                ...(toBlock === undefined ? {} : { toBlock: toBlock.toString() }),
+            },
+            resultSchema,
+            headers,
+        });
+        return result;
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('No records found')) {
+            return [];
+        }
+        throw error;
+    }
+};
+//# sourceMappingURL=getEventLogsByAddressFilteredByTopics.js.map

package/_esm/explorer/etherscanV2/getEventLogsByAddressFilteredByTopics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEventLogsByAddressFilteredByTopics.js","sourceRoot":"","sources":["../../../explorer/etherscanV2/getEventLogsByAddressFilteredByTopics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAa9E,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,OAAO,EAAE,sBAAsB;IAC/B,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,KAAK,CAAC,cAAc,CAAC;SACrB,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,KAAK,CAAC,cAAc,CAAC;SACrB,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;SAChC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAiB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC/D,eAAe,EAAE,cAAc;CAChC,CAAC,CAAA;AACF,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;AAEvC,qHAAqH;AACrH,MAAM,CAAC,MAAM,qCAAqC,GAAG,KAAK,EAAE,EAC1D,MAAM,EACN,OAAO,EACP,MAAM,EACN,SAAS,EACT,OAAO,EACP,OAAO,GACyC,EAEhD,EAAE;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;YAC9B,IAAI,EAAE,EAAE;YACR,KAAK,EAAE;gBACL,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,SAAS;gBACjB,OAAO;gBACP,MAAM;gBACN,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACvE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;aAClE;YACD,YAAY;YACZ,OAAO;SACR,CAAC,CAAA;QACF,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACzE,OAAO,EAAE,CAAA;QACX,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA"}

package/_esm/explorer/etherscanV2/getInternalTransactionsByTransactionHash.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { addressPrimitiveSchema, bigintTextSchema } from '../../types/primitive';
+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, }) => {
+    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;
+    }
+};
+//# sourceMappingURL=getInternalTransactionsByTransactionHash.js.map

package/_esm/explorer/etherscanV2/getInternalTransactionsByTransactionHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getInternalTransactionsByTransactionHash.js","sourceRoot":"","sources":["../../../explorer/etherscanV2/getInternalTransactionsByTransactionHash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAShF,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;IACxD,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC;QACvB,sBAAsB;QACtB,CAAC;aACE,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,EAAE;aACV,SAAS,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;KAC9B,CAAC;IACF,IAAI,EAAE,sBAAsB;IAC5B,GAAG,EAAE,gBAAgB;IACrB,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,KAAK,CAAC,OAAO,CAAC;SACd,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;IACtD,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;QACV,sBAAsB;QACtB,CAAC;aACE,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,EAAE;aACV,SAAS,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;KAC9B,CAAC;IACF,KAAK,EAAE,gBAAgB;CACxB,CAAC,CAAA;AACF,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAA;AAEvD,0HAA0H;AAC1H,MAAM,CAAC,MAAM,wCAAwC,GAAG,KAAK,EAAE,EAC7D,MAAM,EACN,MAAM,EACN,OAAO,GAC4C,EAEnD,EAAE;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;YAC9B,IAAI,EAAE,EAAE;YACR,KAAK,EAAE;gBACL,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,gBAAgB;gBACxB,MAAM;aACP;YACD,YAAY;YACZ,OAAO;SACR,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,eAAe,EAAE,CAAC,CAAC,eAAe;YAClC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,IAAI;YAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC,CAAA;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,uBAAuB,EAAE,CAAC;YACxE,OAAO,EAAE,CAAA;QACX,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA"}

package/_esm/explorer/etherscanV2/getListOfErc1155TokenTransferEventsByAddress.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { lowerHexSchema } from '../../types/primitive';
+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, }) => {
+    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;
+    }
+};
+//# sourceMappingURL=getListOfErc1155TokenTransferEventsByAddress.js.map

package/_esm/explorer/etherscanV2/getListOfErc1155TokenTransferEventsByAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getListOfErc1155TokenTransferEventsByAddress.js","sourceRoot":"","sources":["../../../explorer/etherscanV2/getListOfErc1155TokenTransferEventsByAddress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAetD,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;CACvD,CAAC,CAAA;AACF,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;AAE5C,mIAAmI;AACnI,MAAM,CAAC,MAAM,4CAA4C,GAAG,KAAK,EAAE,EACjE,MAAM,EACN,OAAO,EACP,UAAU,GAAG,CAAC,EACd,QAAQ,EACR,IAAI,GAAG,CAAC,EACR,MAAM,GAAG,MAAM,EACf,IAAI,GAAG,KAAK,EACZ,OAAO,GACgD,EAEvD,EAAE;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;YAC9B,IAAI,EAAE,EAAE;YACR,KAAK,EAAE;gBACL,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,aAAa;gBACrB,OAAO;gBACP,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE;gBACjC,GAAG,CAAC,QAAQ,KAAK,SAAS;oBACxB,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC;wBACE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;qBAC9B,CAAC;gBACN,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;gBACrB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;gBACzB,IAAI;aACL;YACD,YAAY;YACZ,OAAO;SACR,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,IAAI;SAC9B,CAAC,CAAC,CAAA;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,KAAK,YAAY,KAAK;YACtB,CAAC,KAAK,CAAC,OAAO,KAAK,uBAAuB;gBACxC,KAAK,CAAC,OAAO,KAAK,uCAAuC;gBACzD,KAAK,CAAC,OAAO;oBACX,+DAA+D,CAAC,EACpE,CAAC;YACD,OAAO,EAAE,CAAA;QACX,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA"}

package/_esm/explorer/etherscanV2/getListOfErc20TokenTransferEventsByAddress.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { bigintTextSchema, lowerHexSchema } from '../../types/primitive';
+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, }) => {
+    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 = [];
+        const transfers = [];
+        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;
+    }
+};
+//# sourceMappingURL=getListOfErc20TokenTransferEventsByAddress.js.map

package/_esm/explorer/etherscanV2/getListOfErc20TokenTransferEventsByAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getListOfErc20TokenTransferEventsByAddress.js","sourceRoot":"","sources":["../../../explorer/etherscanV2/getListOfErc20TokenTransferEventsByAddress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAexE,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;IACtD,eAAe,EAAE,cAAc;IAC/B,IAAI,EAAE,cAAc;IACpB,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,gBAAgB;CACxB,CAAC,CAAA;AACF,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;AAE5C,iIAAiI;AACjI,MAAM,CAAC,MAAM,0CAA0C,GAAG,KAAK,EAAE,EAC/D,MAAM,EACN,OAAO,EACP,UAAU,GAAG,CAAC,EACd,QAAQ,EACR,IAAI,GAAG,CAAC,EACR,MAAM,GAAG,MAAM,EACf,IAAI,GAAG,KAAK,EACZ,OAAO,GAC8C,EAGpD,EAAE;IACH,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;YAC9B,IAAI,EAAE,EAAE;YACR,KAAK,EAAE;gBACL,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,SAAS;gBACjB,OAAO;gBACP,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE;gBACjC,GAAG,CAAC,QAAQ,KAAK,SAAS;oBACxB,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC;wBACE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;qBAC9B,CAAC;gBACN,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;gBACrB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;gBACzB,IAAI;aACL;YACD,YAAY;YACZ,OAAO;SACR,CAAC,CAAA;QACF,MAAM,OAAO,GAAuB,EAAE,CAAA;QACtC,MAAM,SAAS,GAAoB,EAAE,CAAA;QACrC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC;gBACX,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,SAAS,EAAE,IAAI,CAAC,SAAS,GAAG,IAAI;aACjC,CAAC,CAAA;YACF,SAAS,CAAC,IAAI,CAAC;gBACb,OAAO,EAAE,IAAI,CAAC,eAAe;gBAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,CAAC;gBACX,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAA;QACJ,CAAC;QACD,OAAO;YACL,OAAO;YACP,cAAc,EAAE,SAAS;SAC1B,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,uBAAuB,EAAE,CAAC;YACxE,OAAO;gBACL,OAAO,EAAE,EAAE;gBACX,cAAc,EAAE,EAAE;aACnB,CAAA;QACH,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA"}

package/_esm/explorer/etherscanV2/getListOfErc721TokenTransferEventsByAddress.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { lowerHexSchema } from '../../types/primitive';
+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, }) => {
+    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;
+    }
+};
+//# sourceMappingURL=getListOfErc721TokenTransferEventsByAddress.js.map

package/_esm/explorer/etherscanV2/getListOfErc721TokenTransferEventsByAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getListOfErc721TokenTransferEventsByAddress.js","sourceRoot":"","sources":["../../../explorer/etherscanV2/getListOfErc721TokenTransferEventsByAddress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAetD,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;CACvD,CAAC,CAAA;AACF,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;AAE5C,kIAAkI;AAClI,MAAM,CAAC,MAAM,2CAA2C,GAAG,KAAK,EAAE,EAChE,MAAM,EACN,OAAO,EACP,UAAU,GAAG,CAAC,EACd,QAAQ,EACR,IAAI,GAAG,CAAC,EACR,MAAM,GAAG,MAAM,EACf,IAAI,GAAG,KAAK,EACZ,OAAO,GAC+C,EAEtD,EAAE;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;YAC9B,IAAI,EAAE,EAAE;YACR,KAAK,EAAE;gBACL,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,YAAY;gBACpB,OAAO;gBACP,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE;gBACjC,GAAG,CAAC,QAAQ,KAAK,SAAS;oBACxB,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC;wBACE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;qBAC9B,CAAC;gBACN,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;gBACrB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;gBACzB,IAAI;aACL;YACD,YAAY;YACZ,OAAO;SACR,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,IAAI;SAC9B,CAAC,CAAC,CAAA;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,uBAAuB,EAAE,CAAC;YACxE,OAAO,EAAE,CAAA;QACX,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA"}