@metamask-previews/transaction-controller 38.3.0-preview-7692db0d → 38.3.0-preview-de5d2fda

package/dist/helpers/TransactionPoller.d.mts

@@ -1,31 +0,0 @@
-import type { BlockTracker } from "@metamask/network-controller";
-import type { TransactionMeta } from "../types.mjs";
-export declare const ACCELERATED_COUNT_MAX = 5;
-export declare const ACCELERATED_INTERVAL: number;
-/**
- * Helper class to orchestrate when to poll pending transactions.
- * Initially starts polling via a timeout chain every 2 seconds up to 5 times.
- * Following that, it will poll on every new block via the block tracker.
- */
-export declare class TransactionPoller {
-    #private;
-    constructor(blockTracker: BlockTracker);
-    /**
-     * Start the poller with a listener that will be called on every interval.
-     * @param listener - The listener to call on every interval.
-     */
-    start(listener: (latestBlockNumber: string) => Promise<void>): void;
-    /**
-     * Stop the poller.
-     * Remove all timeouts and block tracker listeners.
-     */
-    stop(): void;
-    /**
-     * Notify the poller of the pending transactions being monitored.
-     * This will reset to the accelerated polling and reset the count
-     * when new transactions are added or removed.
-     * @param pendingTransactions - The pending transactions to poll.
-     */
-    setPendingTransactions(pendingTransactions: TransactionMeta[]): void;
-}
-//# sourceMappingURL=TransactionPoller.d.mts.map

package/dist/helpers/TransactionPoller.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TransactionPoller.d.mts","sourceRoot":"","sources":["../../src/helpers/TransactionPoller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,qCAAqC;AAKjE,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAiB;AAEhD,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,oBAAoB,QAAW,CAAC;AAI7C;;;;GAIG;AACH,qBAAa,iBAAiB;;gBAehB,YAAY,EAAE,YAAY;IAItC;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,CAAC,iBAAiB,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;IAa5D;;;OAGG;IACH,IAAI;IAgBJ;;;;;OAKG;IACH,sBAAsB,CAAC,mBAAmB,EAAE,eAAe,EAAE;CAwF9D"}

package/dist/helpers/TransactionPoller.mjs

@@ -1,130 +0,0 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _TransactionPoller_instances, _TransactionPoller_acceleratedCount, _TransactionPoller_blockTracker, _TransactionPoller_blockTrackerListener, _TransactionPoller_listener, _TransactionPoller_pendingTransactions, _TransactionPoller_running, _TransactionPoller_timeout, _TransactionPoller_queue, _TransactionPoller_interval, _TransactionPoller_stopTimeout, _TransactionPoller_stopBlockTracker;
-import { createModuleLogger } from "@metamask/utils";
-import $lodash from "lodash";
-const { isEqual } = $lodash;
-import { projectLogger } from "../logger.mjs";
-export const ACCELERATED_COUNT_MAX = 5;
-export const ACCELERATED_INTERVAL = 1000 * 2; // 2 Seconds
-const log = createModuleLogger(projectLogger, 'transaction-poller');
-/**
- * Helper class to orchestrate when to poll pending transactions.
- * Initially starts polling via a timeout chain every 2 seconds up to 5 times.
- * Following that, it will poll on every new block via the block tracker.
- */
-export class TransactionPoller {
-    constructor(blockTracker) {
-        _TransactionPoller_instances.add(this);
-        _TransactionPoller_acceleratedCount.set(this, 0);
-        _TransactionPoller_blockTracker.set(this, void 0);
-        _TransactionPoller_blockTrackerListener.set(this, void 0);
-        _TransactionPoller_listener.set(this, void 0);
-        _TransactionPoller_pendingTransactions.set(this, void 0);
-        _TransactionPoller_running.set(this, false);
-        _TransactionPoller_timeout.set(this, void 0);
-        __classPrivateFieldSet(this, _TransactionPoller_blockTracker, blockTracker, "f");
-    }
-    /**
-     * Start the poller with a listener that will be called on every interval.
-     * @param listener - The listener to call on every interval.
-     */
-    start(listener) {
-        if (__classPrivateFieldGet(this, _TransactionPoller_running, "f")) {
-            return;
-        }
-        __classPrivateFieldSet(this, _TransactionPoller_listener, listener, "f");
-        __classPrivateFieldSet(this, _TransactionPoller_running, true, "f");
-        __classPrivateFieldGet(this, _TransactionPoller_instances, "m", _TransactionPoller_queue).call(this);
-        log('Started');
-    }
-    /**
-     * Stop the poller.
-     * Remove all timeouts and block tracker listeners.
-     */
-    stop() {
-        if (!__classPrivateFieldGet(this, _TransactionPoller_running, "f")) {
-            return;
-        }
-        __classPrivateFieldSet(this, _TransactionPoller_running, false, "f");
-        __classPrivateFieldSet(this, _TransactionPoller_listener, undefined, "f");
-        __classPrivateFieldSet(this, _TransactionPoller_acceleratedCount, 0, "f");
-        __classPrivateFieldSet(this, _TransactionPoller_pendingTransactions, undefined, "f");
-        __classPrivateFieldGet(this, _TransactionPoller_instances, "m", _TransactionPoller_stopTimeout).call(this);
-        __classPrivateFieldGet(this, _TransactionPoller_instances, "m", _TransactionPoller_stopBlockTracker).call(this);
-        log('Stopped');
-    }
-    /**
-     * Notify the poller of the pending transactions being monitored.
-     * This will reset to the accelerated polling and reset the count
-     * when new transactions are added or removed.
-     * @param pendingTransactions - The pending transactions to poll.
-     */
-    setPendingTransactions(pendingTransactions) {
-        const currentPendingTransactionIds = (__classPrivateFieldGet(this, _TransactionPoller_pendingTransactions, "f") ?? []).map((tx) => tx.id);
-        __classPrivateFieldSet(this, _TransactionPoller_pendingTransactions, pendingTransactions, "f");
-        const newPendingTransactionIds = pendingTransactions.map((tx) => tx.id);
-        const hasUpdatedIds = !isEqual(currentPendingTransactionIds, newPendingTransactionIds);
-        if (!__classPrivateFieldGet(this, _TransactionPoller_running, "f") || !hasUpdatedIds) {
-            return;
-        }
-        log('Detected new pending transactions', newPendingTransactionIds);
-        __classPrivateFieldSet(this, _TransactionPoller_acceleratedCount, 0, "f");
-        if (__classPrivateFieldGet(this, _TransactionPoller_blockTrackerListener, "f")) {
-            __classPrivateFieldGet(this, _TransactionPoller_instances, "m", _TransactionPoller_stopBlockTracker).call(this);
-            __classPrivateFieldGet(this, _TransactionPoller_instances, "m", _TransactionPoller_queue).call(this);
-        }
-    }
-}
-_TransactionPoller_acceleratedCount = new WeakMap(), _TransactionPoller_blockTracker = new WeakMap(), _TransactionPoller_blockTrackerListener = new WeakMap(), _TransactionPoller_listener = new WeakMap(), _TransactionPoller_pendingTransactions = new WeakMap(), _TransactionPoller_running = new WeakMap(), _TransactionPoller_timeout = new WeakMap(), _TransactionPoller_instances = new WeakSet(), _TransactionPoller_queue = function _TransactionPoller_queue() {
-    if (!__classPrivateFieldGet(this, _TransactionPoller_running, "f")) {
-        return;
-    }
-    if (__classPrivateFieldGet(this, _TransactionPoller_acceleratedCount, "f") >= ACCELERATED_COUNT_MAX) {
-        // eslint-disable-next-line @typescript-eslint/no-misused-promises
-        __classPrivateFieldSet(this, _TransactionPoller_blockTrackerListener, (latestBlockNumber) => __classPrivateFieldGet(this, _TransactionPoller_instances, "m", _TransactionPoller_interval).call(this, false, latestBlockNumber), "f");
-        __classPrivateFieldGet(this, _TransactionPoller_blockTracker, "f").on('latest', __classPrivateFieldGet(this, _TransactionPoller_blockTrackerListener, "f"));
-        log('Added block tracker listener');
-        return;
-    }
-    __classPrivateFieldGet(this, _TransactionPoller_instances, "m", _TransactionPoller_stopTimeout).call(this);
-    // eslint-disable-next-line @typescript-eslint/no-misused-promises
-    __classPrivateFieldSet(this, _TransactionPoller_timeout, setTimeout(async () => {
-        await __classPrivateFieldGet(this, _TransactionPoller_instances, "m", _TransactionPoller_interval).call(this, true);
-        __classPrivateFieldGet(this, _TransactionPoller_instances, "m", _TransactionPoller_queue).call(this);
-    }, ACCELERATED_INTERVAL), "f");
-}, _TransactionPoller_interval = async function _TransactionPoller_interval(isAccelerated, latestBlockNumber) {
-    if (isAccelerated) {
-        log('Accelerated interval', __classPrivateFieldGet(this, _TransactionPoller_acceleratedCount, "f") + 1);
-    }
-    else {
-        log('Block tracker interval', latestBlockNumber);
-    }
-    const latestBlockNumberFinal = latestBlockNumber ?? (await __classPrivateFieldGet(this, _TransactionPoller_blockTracker, "f").getLatestBlock());
-    await __classPrivateFieldGet(this, _TransactionPoller_listener, "f")?.call(this, latestBlockNumberFinal);
-    if (isAccelerated && __classPrivateFieldGet(this, _TransactionPoller_running, "f")) {
-        __classPrivateFieldSet(this, _TransactionPoller_acceleratedCount, __classPrivateFieldGet(this, _TransactionPoller_acceleratedCount, "f") + 1, "f");
-    }
-}, _TransactionPoller_stopTimeout = function _TransactionPoller_stopTimeout() {
-    if (!__classPrivateFieldGet(this, _TransactionPoller_timeout, "f")) {
-        return;
-    }
-    clearTimeout(__classPrivateFieldGet(this, _TransactionPoller_timeout, "f"));
-    __classPrivateFieldSet(this, _TransactionPoller_timeout, undefined, "f");
-}, _TransactionPoller_stopBlockTracker = function _TransactionPoller_stopBlockTracker() {
-    if (!__classPrivateFieldGet(this, _TransactionPoller_blockTrackerListener, "f")) {
-        return;
-    }
-    __classPrivateFieldGet(this, _TransactionPoller_blockTracker, "f").removeListener('latest', __classPrivateFieldGet(this, _TransactionPoller_blockTrackerListener, "f"));
-    __classPrivateFieldSet(this, _TransactionPoller_blockTrackerListener, undefined, "f");
-};
-//# sourceMappingURL=TransactionPoller.mjs.map

package/dist/helpers/TransactionPoller.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"TransactionPoller.mjs","sourceRoot":"","sources":["../../src/helpers/TransactionPoller.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BlockTracker } from '@metamask/network-controller';\nimport { createModuleLogger } from '@metamask/utils';\nimport { isEqual } from 'lodash';\n\nimport { projectLogger } from '../logger';\nimport type { TransactionMeta } from '../types';\n\nexport const ACCELERATED_COUNT_MAX = 5;\nexport const ACCELERATED_INTERVAL = 1000 * 2; // 2 Seconds\n\nconst log = createModuleLogger(projectLogger, 'transaction-poller');\n\n/**\n * Helper class to orchestrate when to poll pending transactions.\n * Initially starts polling via a timeout chain every 2 seconds up to 5 times.\n * Following that, it will poll on every new block via the block tracker.\n */\nexport class TransactionPoller {\n  #acceleratedCount = 0;\n\n  #blockTracker: BlockTracker;\n\n  #blockTrackerListener?: (latestBlockNumber: string) => void;\n\n  #listener?: (latestBlockNumber: string) => Promise<void>;\n\n  #pendingTransactions?: TransactionMeta[];\n\n  #running = false;\n\n  #timeout?: NodeJS.Timeout;\n\n  constructor(blockTracker: BlockTracker) {\n    this.#blockTracker = blockTracker;\n  }\n\n  /**\n   * Start the poller with a listener that will be called on every interval.\n   * @param listener - The listener to call on every interval.\n   */\n  start(listener: (latestBlockNumber: string) => Promise<void>) {\n    if (this.#running) {\n      return;\n    }\n\n    this.#listener = listener;\n    this.#running = true;\n\n    this.#queue();\n\n    log('Started');\n  }\n\n  /**\n   * Stop the poller.\n   * Remove all timeouts and block tracker listeners.\n   */\n  stop() {\n    if (!this.#running) {\n      return;\n    }\n\n    this.#running = false;\n    this.#listener = undefined;\n    this.#acceleratedCount = 0;\n    this.#pendingTransactions = undefined;\n\n    this.#stopTimeout();\n    this.#stopBlockTracker();\n\n    log('Stopped');\n  }\n\n  /**\n   * Notify the poller of the pending transactions being monitored.\n   * This will reset to the accelerated polling and reset the count\n   * when new transactions are added or removed.\n   * @param pendingTransactions - The pending transactions to poll.\n   */\n  setPendingTransactions(pendingTransactions: TransactionMeta[]) {\n    const currentPendingTransactionIds = (this.#pendingTransactions ?? []).map(\n      (tx) => tx.id,\n    );\n\n    this.#pendingTransactions = pendingTransactions;\n\n    const newPendingTransactionIds = pendingTransactions.map((tx) => tx.id);\n\n    const hasUpdatedIds = !isEqual(\n      currentPendingTransactionIds,\n      newPendingTransactionIds,\n    );\n\n    if (!this.#running || !hasUpdatedIds) {\n      return;\n    }\n\n    log('Detected new pending transactions', newPendingTransactionIds);\n\n    this.#acceleratedCount = 0;\n\n    if (this.#blockTrackerListener) {\n      this.#stopBlockTracker();\n      this.#queue();\n    }\n  }\n\n  #queue() {\n    if (!this.#running) {\n      return;\n    }\n\n    if (this.#acceleratedCount >= ACCELERATED_COUNT_MAX) {\n      // eslint-disable-next-line @typescript-eslint/no-misused-promises\n      this.#blockTrackerListener = (latestBlockNumber) =>\n        this.#interval(false, latestBlockNumber);\n\n      this.#blockTracker.on('latest', this.#blockTrackerListener);\n\n      log('Added block tracker listener');\n\n      return;\n    }\n\n    this.#stopTimeout();\n\n    // eslint-disable-next-line @typescript-eslint/no-misused-promises\n    this.#timeout = setTimeout(async () => {\n      await this.#interval(true);\n      this.#queue();\n    }, ACCELERATED_INTERVAL);\n  }\n\n  async #interval(isAccelerated: boolean, latestBlockNumber?: string) {\n    if (isAccelerated) {\n      log('Accelerated interval', this.#acceleratedCount + 1);\n    } else {\n      log('Block tracker interval', latestBlockNumber);\n    }\n\n    const latestBlockNumberFinal =\n      latestBlockNumber ?? (await this.#blockTracker.getLatestBlock());\n\n    await this.#listener?.(latestBlockNumberFinal);\n\n    if (isAccelerated && this.#running) {\n      this.#acceleratedCount += 1;\n    }\n  }\n\n  #stopTimeout() {\n    if (!this.#timeout) {\n      return;\n    }\n\n    clearTimeout(this.#timeout);\n    this.#timeout = undefined;\n  }\n\n  #stopBlockTracker() {\n    if (!this.#blockTrackerListener) {\n      return;\n    }\n\n    this.#blockTracker.removeListener('latest', this.#blockTrackerListener);\n    this.#blockTrackerListener = undefined;\n  }\n}\n"]}

package/dist/utils/etherscan.cjs

@@ -1,115 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getEtherscanApiHost = exports.fetchEtherscanTokenTransactions = exports.fetchEtherscanTransactions = void 0;
-const controller_utils_1 = require("@metamask/controller-utils");
-const constants_1 = require("../constants.cjs");
-const logger_1 = require("../logger.cjs");
-/**
- * Retrieves transaction data from Etherscan.
- *
- * @param request - Configuration required to fetch transactions.
- * @param request.address - Address to retrieve transactions for.
- * @param request.apiKey - Etherscan API key to prevent rate limiting.
- * @param request.chainId - Current chain ID used to determine subdomain and domain.
- * @param request.fromBlock - Block number to start fetching transactions from.
- * @param request.limit - Number of transactions to retrieve.
- * @returns An Etherscan response object containing the request status and an array of token transaction data.
- */
-async function fetchEtherscanTransactions({ address, apiKey, chainId, fromBlock, limit, }) {
-    return await fetchTransactions('txlist', {
-        address,
-        apiKey,
-        chainId,
-        fromBlock,
-        limit,
-    });
-}
-exports.fetchEtherscanTransactions = fetchEtherscanTransactions;
-/**
- * Retrieves token transaction data from Etherscan.
- *
- * @param request - Configuration required to fetch token transactions.
- * @param request.address - Address to retrieve token transactions for.
- * @param request.apiKey - Etherscan API key to prevent rate limiting.
- * @param request.chainId - Current chain ID used to determine subdomain and domain.
- * @param request.fromBlock - Block number to start fetching token transactions from.
- * @param request.limit - Number of token transactions to retrieve.
- * @returns An Etherscan response object containing the request status and an array of token transaction data.
- */
-async function fetchEtherscanTokenTransactions({ address, apiKey, chainId, fromBlock, limit, }) {
-    return await fetchTransactions('tokentx', {
-        address,
-        apiKey,
-        chainId,
-        fromBlock,
-        limit,
-    });
-}
-exports.fetchEtherscanTokenTransactions = fetchEtherscanTokenTransactions;
-/**
- * Retrieves transaction data from Etherscan from a specific endpoint.
- *
- * @param action - The Etherscan endpoint to use.
- * @param options - Options bag.
- * @param options.address - Address to retrieve transactions for.
- * @param options.apiKey - Etherscan API key to prevent rate limiting.
- * @param options.chainId - Current chain ID used to determine subdomain and domain.
- * @param options.fromBlock - Block number to start fetching transactions from.
- * @param options.limit - Number of transactions to retrieve.
- * @returns An object containing the request status and an array of transaction data.
- */
-async function fetchTransactions(action, { address, apiKey, chainId, fromBlock, limit, }) {
-    const urlParams = {
-        module: 'account',
-        address,
-        startBlock: fromBlock?.toString(),
-        offset: limit?.toString(),
-        sort: 'desc',
-    };
-    const etherscanTxUrl = getEtherscanApiUrl(chainId, {
-        ...urlParams,
-        action,
-        apikey: apiKey,
-    });
-    (0, logger_1.incomingTransactionsLogger)('Sending Etherscan request', etherscanTxUrl);
-    const response = (await (0, controller_utils_1.handleFetch)(etherscanTxUrl));
-    return response;
-}
-/**
- * Return a URL that can be used to fetch data from Etherscan.
- *
- * @param chainId - Current chain ID used to determine subdomain and domain.
- * @param urlParams - The parameters used to construct the URL.
- * @returns URL to access Etherscan data.
- */
-function getEtherscanApiUrl(chainId, urlParams) {
-    const apiUrl = getEtherscanApiHost(chainId);
-    let url = `${apiUrl}/api?`;
-    for (const paramKey of Object.keys(urlParams)) {
-        const value = urlParams[paramKey];
-        if (!value) {
-            continue;
-        }
-        url += `${paramKey}=${value}&`;
-    }
-    url += 'tag=latest&page=1';
-    return url;
-}
-/**
- * Return the host url used to fetch data from Etherscan.
- *
- * @param chainId - Current chain ID used to determine subdomain and domain.
- * @returns host URL to access Etherscan data.
- */
-function getEtherscanApiHost(chainId) {
-    // @ts-expect-error We account for `chainId` not being a property below
-    const networkInfo = constants_1.ETHERSCAN_SUPPORTED_NETWORKS[chainId];
-    if (!networkInfo) {
-        throw new Error(`Etherscan does not support chain with ID: ${chainId}`);
-    }
-    // TODO: Either fix this lint violation or explain why it's necessary to ignore.
-    // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
-    return `https://${networkInfo.subdomain}.${networkInfo.domain}`;
-}
-exports.getEtherscanApiHost = getEtherscanApiHost;
-//# sourceMappingURL=etherscan.cjs.map

package/dist/utils/etherscan.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"etherscan.cjs","sourceRoot":"","sources":["../../src/utils/etherscan.ts"],"names":[],"mappings":";;;AAAA,iEAAyD;AAGzD,gDAA4D;AAC5D,0CAA8D;AAsE9D;;;;;;;;;;GAUG;AACI,KAAK,UAAU,0BAA0B,CAAC,EAC/C,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,EACT,KAAK,GACuB;IAG5B,OAAO,MAAM,iBAAiB,CAAC,QAAQ,EAAE;QACvC,OAAO;QACP,MAAM;QACN,OAAO;QACP,SAAS;QACT,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAhBD,gEAgBC;AAED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,+BAA+B,CAAC,EACpD,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,EACT,KAAK,GACuB;IAG5B,OAAO,MAAM,iBAAiB,CAAC,SAAS,EAAE;QACxC,OAAO;QACP,MAAM;QACN,OAAO;QACP,SAAS;QACT,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAhBD,0EAgBC;AAED;;;;;;;;;;;GAWG;AACH,KAAK,UAAU,iBAAiB,CAG9B,MAAc,EACd,EACE,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,EACT,KAAK,GAON;IAED,MAAM,SAAS,GAAG;QAChB,MAAM,EAAE,SAAS;QACjB,OAAO;QACP,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE;QACjC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE;QACzB,IAAI,EAAE,MAAM;KACb,CAAC;IAEF,MAAM,cAAc,GAAG,kBAAkB,CAAC,OAAO,EAAE;QACjD,GAAG,SAAS;QACZ,MAAM;QACN,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;IAEH,IAAA,mCAAG,EAAC,2BAA2B,EAAE,cAAc,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAA,8BAAW,EACjC,cAAc,CACf,CAA+C,CAAC;IAEjD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CACzB,OAAY,EACZ,SAA6C;IAE7C,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,GAAG,GAAG,GAAG,MAAM,OAAO,CAAC;IAE3B,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;QAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE;YACV,SAAS;SACV;QAED,GAAG,IAAI,GAAG,QAAQ,IAAI,KAAK,GAAG,CAAC;KAChC;IAED,GAAG,IAAI,mBAAmB,CAAC;IAE3B,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,OAAY;IAC9C,uEAAuE;IACvE,MAAM,WAAW,GAAG,wCAA4B,CAAC,OAAO,CAAC,CAAC;IAE1D,IAAI,CAAC,WAAW,EAAE;QAChB,MAAM,IAAI,KAAK,CAAC,6CAA6C,OAAO,EAAE,CAAC,CAAC;KACzE;IAED,gFAAgF;IAChF,4EAA4E;IAC5E,OAAO,WAAW,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;AAClE,CAAC;AAXD,kDAWC","sourcesContent":["import { handleFetch } from '@metamask/controller-utils';\nimport type { Hex } from '@metamask/utils';\n\nimport { ETHERSCAN_SUPPORTED_NETWORKS } from '../constants';\nimport { incomingTransactionsLogger as log } from '../logger';\n\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface EtherscanTransactionMetaBase {\n  blockNumber: string;\n  blockHash: string;\n  confirmations: string;\n  contractAddress: string;\n  cumulativeGasUsed: string;\n  from: string;\n  gas: string;\n  gasPrice: string;\n  gasUsed: string;\n  hash: string;\n  nonce: string;\n  timeStamp: string;\n  to: string;\n  transactionIndex: string;\n  value: string;\n}\n\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface EtherscanTransactionMeta extends EtherscanTransactionMetaBase {\n  functionName: string;\n  input: string;\n  isError: string;\n  methodId: string;\n  // TODO: Either fix this lint violation or explain why it's necessary to ignore.\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  txreceipt_status: string;\n}\n\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface EtherscanTokenTransactionMeta\n  extends EtherscanTransactionMetaBase {\n  tokenDecimal: string;\n  tokenName: string;\n  tokenSymbol: string;\n}\n\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface EtherscanTransactionResponse<\n  // TODO: Either fix this lint violation or explain why it's necessary to ignore.\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  T extends EtherscanTransactionMetaBase,\n> {\n  status: '0' | '1';\n  message?: string;\n  result: string | T[];\n}\n\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface EtherscanTransactionRequest {\n  address: string;\n  apiKey?: string;\n  chainId: Hex;\n  fromBlock?: number;\n  limit?: number;\n}\n\n/**\n * Retrieves transaction data from Etherscan.\n *\n * @param request - Configuration required to fetch transactions.\n * @param request.address - Address to retrieve transactions for.\n * @param request.apiKey - Etherscan API key to prevent rate limiting.\n * @param request.chainId - Current chain ID used to determine subdomain and domain.\n * @param request.fromBlock - Block number to start fetching transactions from.\n * @param request.limit - Number of transactions to retrieve.\n * @returns An Etherscan response object containing the request status and an array of token transaction data.\n */\nexport async function fetchEtherscanTransactions({\n  address,\n  apiKey,\n  chainId,\n  fromBlock,\n  limit,\n}: EtherscanTransactionRequest): Promise<\n  EtherscanTransactionResponse<EtherscanTransactionMeta>\n> {\n  return await fetchTransactions('txlist', {\n    address,\n    apiKey,\n    chainId,\n    fromBlock,\n    limit,\n  });\n}\n\n/**\n * Retrieves token transaction data from Etherscan.\n *\n * @param request - Configuration required to fetch token transactions.\n * @param request.address - Address to retrieve token transactions for.\n * @param request.apiKey - Etherscan API key to prevent rate limiting.\n * @param request.chainId - Current chain ID used to determine subdomain and domain.\n * @param request.fromBlock - Block number to start fetching token transactions from.\n * @param request.limit - Number of token transactions to retrieve.\n * @returns An Etherscan response object containing the request status and an array of token transaction data.\n */\nexport async function fetchEtherscanTokenTransactions({\n  address,\n  apiKey,\n  chainId,\n  fromBlock,\n  limit,\n}: EtherscanTransactionRequest): Promise<\n  EtherscanTransactionResponse<EtherscanTokenTransactionMeta>\n> {\n  return await fetchTransactions('tokentx', {\n    address,\n    apiKey,\n    chainId,\n    fromBlock,\n    limit,\n  });\n}\n\n/**\n * Retrieves transaction data from Etherscan from a specific endpoint.\n *\n * @param action - The Etherscan endpoint to use.\n * @param options - Options bag.\n * @param options.address - Address to retrieve transactions for.\n * @param options.apiKey - Etherscan API key to prevent rate limiting.\n * @param options.chainId - Current chain ID used to determine subdomain and domain.\n * @param options.fromBlock - Block number to start fetching transactions from.\n * @param options.limit - Number of transactions to retrieve.\n * @returns An object containing the request status and an array of transaction data.\n */\nasync function fetchTransactions<\n  ResponseData extends EtherscanTransactionMetaBase,\n>(\n  action: string,\n  {\n    address,\n    apiKey,\n    chainId,\n    fromBlock,\n    limit,\n  }: {\n    address: string;\n    apiKey?: string;\n    chainId: Hex;\n    fromBlock?: number;\n    limit?: number;\n  },\n): Promise<EtherscanTransactionResponse<ResponseData>> {\n  const urlParams = {\n    module: 'account',\n    address,\n    startBlock: fromBlock?.toString(),\n    offset: limit?.toString(),\n    sort: 'desc',\n  };\n\n  const etherscanTxUrl = getEtherscanApiUrl(chainId, {\n    ...urlParams,\n    action,\n    apikey: apiKey,\n  });\n\n  log('Sending Etherscan request', etherscanTxUrl);\n\n  const response = (await handleFetch(\n    etherscanTxUrl,\n  )) as EtherscanTransactionResponse<ResponseData>;\n\n  return response;\n}\n\n/**\n * Return a URL that can be used to fetch data from Etherscan.\n *\n * @param chainId - Current chain ID used to determine subdomain and domain.\n * @param urlParams - The parameters used to construct the URL.\n * @returns URL to access Etherscan data.\n */\nfunction getEtherscanApiUrl(\n  chainId: Hex,\n  urlParams: Record<string, string | undefined>,\n): string {\n  const apiUrl = getEtherscanApiHost(chainId);\n  let url = `${apiUrl}/api?`;\n\n  for (const paramKey of Object.keys(urlParams)) {\n    const value = urlParams[paramKey];\n\n    if (!value) {\n      continue;\n    }\n\n    url += `${paramKey}=${value}&`;\n  }\n\n  url += 'tag=latest&page=1';\n\n  return url;\n}\n\n/**\n * Return the host url used to fetch data from Etherscan.\n *\n * @param chainId - Current chain ID used to determine subdomain and domain.\n * @returns host URL to access Etherscan data.\n */\nexport function getEtherscanApiHost(chainId: Hex) {\n  // @ts-expect-error We account for `chainId` not being a property below\n  const networkInfo = ETHERSCAN_SUPPORTED_NETWORKS[chainId];\n\n  if (!networkInfo) {\n    throw new Error(`Etherscan does not support chain with ID: ${chainId}`);\n  }\n\n  // TODO: Either fix this lint violation or explain why it's necessary to ignore.\n  // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n  return `https://${networkInfo.subdomain}.${networkInfo.domain}`;\n}\n"]}

package/dist/utils/etherscan.d.cts

@@ -1,74 +0,0 @@
-import type { Hex } from "@metamask/utils";
-export interface EtherscanTransactionMetaBase {
-    blockNumber: string;
-    blockHash: string;
-    confirmations: string;
-    contractAddress: string;
-    cumulativeGasUsed: string;
-    from: string;
-    gas: string;
-    gasPrice: string;
-    gasUsed: string;
-    hash: string;
-    nonce: string;
-    timeStamp: string;
-    to: string;
-    transactionIndex: string;
-    value: string;
-}
-export interface EtherscanTransactionMeta extends EtherscanTransactionMetaBase {
-    functionName: string;
-    input: string;
-    isError: string;
-    methodId: string;
-    txreceipt_status: string;
-}
-export interface EtherscanTokenTransactionMeta extends EtherscanTransactionMetaBase {
-    tokenDecimal: string;
-    tokenName: string;
-    tokenSymbol: string;
-}
-export interface EtherscanTransactionResponse<T extends EtherscanTransactionMetaBase> {
-    status: '0' | '1';
-    message?: string;
-    result: string | T[];
-}
-export interface EtherscanTransactionRequest {
-    address: string;
-    apiKey?: string;
-    chainId: Hex;
-    fromBlock?: number;
-    limit?: number;
-}
-/**
- * Retrieves transaction data from Etherscan.
- *
- * @param request - Configuration required to fetch transactions.
- * @param request.address - Address to retrieve transactions for.
- * @param request.apiKey - Etherscan API key to prevent rate limiting.
- * @param request.chainId - Current chain ID used to determine subdomain and domain.
- * @param request.fromBlock - Block number to start fetching transactions from.
- * @param request.limit - Number of transactions to retrieve.
- * @returns An Etherscan response object containing the request status and an array of token transaction data.
- */
-export declare function fetchEtherscanTransactions({ address, apiKey, chainId, fromBlock, limit, }: EtherscanTransactionRequest): Promise<EtherscanTransactionResponse<EtherscanTransactionMeta>>;
-/**
- * Retrieves token transaction data from Etherscan.
- *
- * @param request - Configuration required to fetch token transactions.
- * @param request.address - Address to retrieve token transactions for.
- * @param request.apiKey - Etherscan API key to prevent rate limiting.
- * @param request.chainId - Current chain ID used to determine subdomain and domain.
- * @param request.fromBlock - Block number to start fetching token transactions from.
- * @param request.limit - Number of token transactions to retrieve.
- * @returns An Etherscan response object containing the request status and an array of token transaction data.
- */
-export declare function fetchEtherscanTokenTransactions({ address, apiKey, chainId, fromBlock, limit, }: EtherscanTransactionRequest): Promise<EtherscanTransactionResponse<EtherscanTokenTransactionMeta>>;
-/**
- * Return the host url used to fetch data from Etherscan.
- *
- * @param chainId - Current chain ID used to determine subdomain and domain.
- * @returns host URL to access Etherscan data.
- */
-export declare function getEtherscanApiHost(chainId: Hex): string;
-//# sourceMappingURL=etherscan.d.cts.map

package/dist/utils/etherscan.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"etherscan.d.cts","sourceRoot":"","sources":["../../src/utils/etherscan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAQ3C,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,MAAM,WAAW,wBAAyB,SAAQ,4BAA4B;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IAGjB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAKD,MAAM,WAAW,6BACf,SAAQ,4BAA4B;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,WAAW,4BAA4B,CAG3C,CAAC,SAAS,4BAA4B;IAEtC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;CACtB;AAKD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAAC,EAC/C,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,EACT,KAAK,GACN,EAAE,2BAA2B,GAAG,OAAO,CACtC,4BAA4B,CAAC,wBAAwB,CAAC,CACvD,CAQA;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,+BAA+B,CAAC,EACpD,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,EACT,KAAK,GACN,EAAE,2BAA2B,GAAG,OAAO,CACtC,4BAA4B,CAAC,6BAA6B,CAAC,CAC5D,CAQA;AAoFD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,UAW/C"}

package/dist/utils/etherscan.d.mts

@@ -1,74 +0,0 @@
-import type { Hex } from "@metamask/utils";
-export interface EtherscanTransactionMetaBase {
-    blockNumber: string;
-    blockHash: string;
-    confirmations: string;
-    contractAddress: string;
-    cumulativeGasUsed: string;
-    from: string;
-    gas: string;
-    gasPrice: string;
-    gasUsed: string;
-    hash: string;
-    nonce: string;
-    timeStamp: string;
-    to: string;
-    transactionIndex: string;
-    value: string;
-}
-export interface EtherscanTransactionMeta extends EtherscanTransactionMetaBase {
-    functionName: string;
-    input: string;
-    isError: string;
-    methodId: string;
-    txreceipt_status: string;
-}
-export interface EtherscanTokenTransactionMeta extends EtherscanTransactionMetaBase {
-    tokenDecimal: string;
-    tokenName: string;
-    tokenSymbol: string;
-}
-export interface EtherscanTransactionResponse<T extends EtherscanTransactionMetaBase> {
-    status: '0' | '1';
-    message?: string;
-    result: string | T[];
-}
-export interface EtherscanTransactionRequest {
-    address: string;
-    apiKey?: string;
-    chainId: Hex;
-    fromBlock?: number;
-    limit?: number;
-}
-/**
- * Retrieves transaction data from Etherscan.
- *
- * @param request - Configuration required to fetch transactions.
- * @param request.address - Address to retrieve transactions for.
- * @param request.apiKey - Etherscan API key to prevent rate limiting.
- * @param request.chainId - Current chain ID used to determine subdomain and domain.
- * @param request.fromBlock - Block number to start fetching transactions from.
- * @param request.limit - Number of transactions to retrieve.
- * @returns An Etherscan response object containing the request status and an array of token transaction data.
- */
-export declare function fetchEtherscanTransactions({ address, apiKey, chainId, fromBlock, limit, }: EtherscanTransactionRequest): Promise<EtherscanTransactionResponse<EtherscanTransactionMeta>>;
-/**
- * Retrieves token transaction data from Etherscan.
- *
- * @param request - Configuration required to fetch token transactions.
- * @param request.address - Address to retrieve token transactions for.
- * @param request.apiKey - Etherscan API key to prevent rate limiting.
- * @param request.chainId - Current chain ID used to determine subdomain and domain.
- * @param request.fromBlock - Block number to start fetching token transactions from.
- * @param request.limit - Number of token transactions to retrieve.
- * @returns An Etherscan response object containing the request status and an array of token transaction data.
- */
-export declare function fetchEtherscanTokenTransactions({ address, apiKey, chainId, fromBlock, limit, }: EtherscanTransactionRequest): Promise<EtherscanTransactionResponse<EtherscanTokenTransactionMeta>>;
-/**
- * Return the host url used to fetch data from Etherscan.
- *
- * @param chainId - Current chain ID used to determine subdomain and domain.
- * @returns host URL to access Etherscan data.
- */
-export declare function getEtherscanApiHost(chainId: Hex): string;
-//# sourceMappingURL=etherscan.d.mts.map

package/dist/utils/etherscan.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"etherscan.d.mts","sourceRoot":"","sources":["../../src/utils/etherscan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAQ3C,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,MAAM,WAAW,wBAAyB,SAAQ,4BAA4B;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IAGjB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAKD,MAAM,WAAW,6BACf,SAAQ,4BAA4B;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,WAAW,4BAA4B,CAG3C,CAAC,SAAS,4BAA4B;IAEtC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;CACtB;AAKD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAAC,EAC/C,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,EACT,KAAK,GACN,EAAE,2BAA2B,GAAG,OAAO,CACtC,4BAA4B,CAAC,wBAAwB,CAAC,CACvD,CAQA;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,+BAA+B,CAAC,EACpD,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,EACT,KAAK,GACN,EAAE,2BAA2B,GAAG,OAAO,CACtC,4BAA4B,CAAC,6BAA6B,CAAC,CAC5D,CAQA;AAoFD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,UAW/C"}

package/dist/utils/etherscan.mjs

@@ -1,109 +0,0 @@
-import { handleFetch } from "@metamask/controller-utils";
-import { ETHERSCAN_SUPPORTED_NETWORKS } from "../constants.mjs";
-import { incomingTransactionsLogger as log } from "../logger.mjs";
-/**
- * Retrieves transaction data from Etherscan.
- *
- * @param request - Configuration required to fetch transactions.
- * @param request.address - Address to retrieve transactions for.
- * @param request.apiKey - Etherscan API key to prevent rate limiting.
- * @param request.chainId - Current chain ID used to determine subdomain and domain.
- * @param request.fromBlock - Block number to start fetching transactions from.
- * @param request.limit - Number of transactions to retrieve.
- * @returns An Etherscan response object containing the request status and an array of token transaction data.
- */
-export async function fetchEtherscanTransactions({ address, apiKey, chainId, fromBlock, limit, }) {
-    return await fetchTransactions('txlist', {
-        address,
-        apiKey,
-        chainId,
-        fromBlock,
-        limit,
-    });
-}
-/**
- * Retrieves token transaction data from Etherscan.
- *
- * @param request - Configuration required to fetch token transactions.
- * @param request.address - Address to retrieve token transactions for.
- * @param request.apiKey - Etherscan API key to prevent rate limiting.
- * @param request.chainId - Current chain ID used to determine subdomain and domain.
- * @param request.fromBlock - Block number to start fetching token transactions from.
- * @param request.limit - Number of token transactions to retrieve.
- * @returns An Etherscan response object containing the request status and an array of token transaction data.
- */
-export async function fetchEtherscanTokenTransactions({ address, apiKey, chainId, fromBlock, limit, }) {
-    return await fetchTransactions('tokentx', {
-        address,
-        apiKey,
-        chainId,
-        fromBlock,
-        limit,
-    });
-}
-/**
- * Retrieves transaction data from Etherscan from a specific endpoint.
- *
- * @param action - The Etherscan endpoint to use.
- * @param options - Options bag.
- * @param options.address - Address to retrieve transactions for.
- * @param options.apiKey - Etherscan API key to prevent rate limiting.
- * @param options.chainId - Current chain ID used to determine subdomain and domain.
- * @param options.fromBlock - Block number to start fetching transactions from.
- * @param options.limit - Number of transactions to retrieve.
- * @returns An object containing the request status and an array of transaction data.
- */
-async function fetchTransactions(action, { address, apiKey, chainId, fromBlock, limit, }) {
-    const urlParams = {
-        module: 'account',
-        address,
-        startBlock: fromBlock?.toString(),
-        offset: limit?.toString(),
-        sort: 'desc',
-    };
-    const etherscanTxUrl = getEtherscanApiUrl(chainId, {
-        ...urlParams,
-        action,
-        apikey: apiKey,
-    });
-    log('Sending Etherscan request', etherscanTxUrl);
-    const response = (await handleFetch(etherscanTxUrl));
-    return response;
-}
-/**
- * Return a URL that can be used to fetch data from Etherscan.
- *
- * @param chainId - Current chain ID used to determine subdomain and domain.
- * @param urlParams - The parameters used to construct the URL.
- * @returns URL to access Etherscan data.
- */
-function getEtherscanApiUrl(chainId, urlParams) {
-    const apiUrl = getEtherscanApiHost(chainId);
-    let url = `${apiUrl}/api?`;
-    for (const paramKey of Object.keys(urlParams)) {
-        const value = urlParams[paramKey];
-        if (!value) {
-            continue;
-        }
-        url += `${paramKey}=${value}&`;
-    }
-    url += 'tag=latest&page=1';
-    return url;
-}
-/**
- * Return the host url used to fetch data from Etherscan.
- *
- * @param chainId - Current chain ID used to determine subdomain and domain.
- * @returns host URL to access Etherscan data.
- */
-export function getEtherscanApiHost(chainId) {
-    // @ts-expect-error We account for `chainId` not being a property below
-    const networkInfo = ETHERSCAN_SUPPORTED_NETWORKS[chainId];
-    if (!networkInfo) {
-        throw new Error(`Etherscan does not support chain with ID: ${chainId}`);
-    }
-    // TODO: Either fix this lint violation or explain why it's necessary to ignore.
-    // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
-    return `https://${networkInfo.subdomain}.${networkInfo.domain}`;
-}
-//# sourceMappingURL=etherscan.mjs.map

package/dist/utils/etherscan.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"etherscan.mjs","sourceRoot":"","sources":["../../src/utils/etherscan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mCAAmC;AAGzD,OAAO,EAAE,4BAA4B,EAAE,yBAAqB;AAC5D,OAAO,EAAE,0BAA0B,IAAI,GAAG,EAAE,sBAAkB;AAsE9D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,EAC/C,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,EACT,KAAK,GACuB;IAG5B,OAAO,MAAM,iBAAiB,CAAC,QAAQ,EAAE;QACvC,OAAO;QACP,MAAM;QACN,OAAO;QACP,SAAS;QACT,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,EACpD,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,EACT,KAAK,GACuB;IAG5B,OAAO,MAAM,iBAAiB,CAAC,SAAS,EAAE;QACxC,OAAO;QACP,MAAM;QACN,OAAO;QACP,SAAS;QACT,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,KAAK,UAAU,iBAAiB,CAG9B,MAAc,EACd,EACE,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,EACT,KAAK,GAON;IAED,MAAM,SAAS,GAAG;QAChB,MAAM,EAAE,SAAS;QACjB,OAAO;QACP,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE;QACjC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE;QACzB,IAAI,EAAE,MAAM;KACb,CAAC;IAEF,MAAM,cAAc,GAAG,kBAAkB,CAAC,OAAO,EAAE;QACjD,GAAG,SAAS;QACZ,MAAM;QACN,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;IAEH,GAAG,CAAC,2BAA2B,EAAE,cAAc,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAG,CAAC,MAAM,WAAW,CACjC,cAAc,CACf,CAA+C,CAAC;IAEjD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CACzB,OAAY,EACZ,SAA6C;IAE7C,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,GAAG,GAAG,GAAG,MAAM,OAAO,CAAC;IAE3B,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;QAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE;YACV,SAAS;SACV;QAED,GAAG,IAAI,GAAG,QAAQ,IAAI,KAAK,GAAG,CAAC;KAChC;IAED,GAAG,IAAI,mBAAmB,CAAC;IAE3B,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAY;IAC9C,uEAAuE;IACvE,MAAM,WAAW,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IAE1D,IAAI,CAAC,WAAW,EAAE;QAChB,MAAM,IAAI,KAAK,CAAC,6CAA6C,OAAO,EAAE,CAAC,CAAC;KACzE;IAED,gFAAgF;IAChF,4EAA4E;IAC5E,OAAO,WAAW,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;AAClE,CAAC","sourcesContent":["import { handleFetch } from '@metamask/controller-utils';\nimport type { Hex } from '@metamask/utils';\n\nimport { ETHERSCAN_SUPPORTED_NETWORKS } from '../constants';\nimport { incomingTransactionsLogger as log } from '../logger';\n\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface EtherscanTransactionMetaBase {\n  blockNumber: string;\n  blockHash: string;\n  confirmations: string;\n  contractAddress: string;\n  cumulativeGasUsed: string;\n  from: string;\n  gas: string;\n  gasPrice: string;\n  gasUsed: string;\n  hash: string;\n  nonce: string;\n  timeStamp: string;\n  to: string;\n  transactionIndex: string;\n  value: string;\n}\n\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface EtherscanTransactionMeta extends EtherscanTransactionMetaBase {\n  functionName: string;\n  input: string;\n  isError: string;\n  methodId: string;\n  // TODO: Either fix this lint violation or explain why it's necessary to ignore.\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  txreceipt_status: string;\n}\n\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface EtherscanTokenTransactionMeta\n  extends EtherscanTransactionMetaBase {\n  tokenDecimal: string;\n  tokenName: string;\n  tokenSymbol: string;\n}\n\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface EtherscanTransactionResponse<\n  // TODO: Either fix this lint violation or explain why it's necessary to ignore.\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  T extends EtherscanTransactionMetaBase,\n> {\n  status: '0' | '1';\n  message?: string;\n  result: string | T[];\n}\n\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface EtherscanTransactionRequest {\n  address: string;\n  apiKey?: string;\n  chainId: Hex;\n  fromBlock?: number;\n  limit?: number;\n}\n\n/**\n * Retrieves transaction data from Etherscan.\n *\n * @param request - Configuration required to fetch transactions.\n * @param request.address - Address to retrieve transactions for.\n * @param request.apiKey - Etherscan API key to prevent rate limiting.\n * @param request.chainId - Current chain ID used to determine subdomain and domain.\n * @param request.fromBlock - Block number to start fetching transactions from.\n * @param request.limit - Number of transactions to retrieve.\n * @returns An Etherscan response object containing the request status and an array of token transaction data.\n */\nexport async function fetchEtherscanTransactions({\n  address,\n  apiKey,\n  chainId,\n  fromBlock,\n  limit,\n}: EtherscanTransactionRequest): Promise<\n  EtherscanTransactionResponse<EtherscanTransactionMeta>\n> {\n  return await fetchTransactions('txlist', {\n    address,\n    apiKey,\n    chainId,\n    fromBlock,\n    limit,\n  });\n}\n\n/**\n * Retrieves token transaction data from Etherscan.\n *\n * @param request - Configuration required to fetch token transactions.\n * @param request.address - Address to retrieve token transactions for.\n * @param request.apiKey - Etherscan API key to prevent rate limiting.\n * @param request.chainId - Current chain ID used to determine subdomain and domain.\n * @param request.fromBlock - Block number to start fetching token transactions from.\n * @param request.limit - Number of token transactions to retrieve.\n * @returns An Etherscan response object containing the request status and an array of token transaction data.\n */\nexport async function fetchEtherscanTokenTransactions({\n  address,\n  apiKey,\n  chainId,\n  fromBlock,\n  limit,\n}: EtherscanTransactionRequest): Promise<\n  EtherscanTransactionResponse<EtherscanTokenTransactionMeta>\n> {\n  return await fetchTransactions('tokentx', {\n    address,\n    apiKey,\n    chainId,\n    fromBlock,\n    limit,\n  });\n}\n\n/**\n * Retrieves transaction data from Etherscan from a specific endpoint.\n *\n * @param action - The Etherscan endpoint to use.\n * @param options - Options bag.\n * @param options.address - Address to retrieve transactions for.\n * @param options.apiKey - Etherscan API key to prevent rate limiting.\n * @param options.chainId - Current chain ID used to determine subdomain and domain.\n * @param options.fromBlock - Block number to start fetching transactions from.\n * @param options.limit - Number of transactions to retrieve.\n * @returns An object containing the request status and an array of transaction data.\n */\nasync function fetchTransactions<\n  ResponseData extends EtherscanTransactionMetaBase,\n>(\n  action: string,\n  {\n    address,\n    apiKey,\n    chainId,\n    fromBlock,\n    limit,\n  }: {\n    address: string;\n    apiKey?: string;\n    chainId: Hex;\n    fromBlock?: number;\n    limit?: number;\n  },\n): Promise<EtherscanTransactionResponse<ResponseData>> {\n  const urlParams = {\n    module: 'account',\n    address,\n    startBlock: fromBlock?.toString(),\n    offset: limit?.toString(),\n    sort: 'desc',\n  };\n\n  const etherscanTxUrl = getEtherscanApiUrl(chainId, {\n    ...urlParams,\n    action,\n    apikey: apiKey,\n  });\n\n  log('Sending Etherscan request', etherscanTxUrl);\n\n  const response = (await handleFetch(\n    etherscanTxUrl,\n  )) as EtherscanTransactionResponse<ResponseData>;\n\n  return response;\n}\n\n/**\n * Return a URL that can be used to fetch data from Etherscan.\n *\n * @param chainId - Current chain ID used to determine subdomain and domain.\n * @param urlParams - The parameters used to construct the URL.\n * @returns URL to access Etherscan data.\n */\nfunction getEtherscanApiUrl(\n  chainId: Hex,\n  urlParams: Record<string, string | undefined>,\n): string {\n  const apiUrl = getEtherscanApiHost(chainId);\n  let url = `${apiUrl}/api?`;\n\n  for (const paramKey of Object.keys(urlParams)) {\n    const value = urlParams[paramKey];\n\n    if (!value) {\n      continue;\n    }\n\n    url += `${paramKey}=${value}&`;\n  }\n\n  url += 'tag=latest&page=1';\n\n  return url;\n}\n\n/**\n * Return the host url used to fetch data from Etherscan.\n *\n * @param chainId - Current chain ID used to determine subdomain and domain.\n * @returns host URL to access Etherscan data.\n */\nexport function getEtherscanApiHost(chainId: Hex) {\n  // @ts-expect-error We account for `chainId` not being a property below\n  const networkInfo = ETHERSCAN_SUPPORTED_NETWORKS[chainId];\n\n  if (!networkInfo) {\n    throw new Error(`Etherscan does not support chain with ID: ${chainId}`);\n  }\n\n  // TODO: Either fix this lint violation or explain why it's necessary to ignore.\n  // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n  return `https://${networkInfo.subdomain}.${networkInfo.domain}`;\n}\n"]}