@metamask/transaction-controller 40.1.0 → 41.1.0

package/dist/TransactionController.cjs

@@ -13,7 +13,7 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _TransactionController_instances, _TransactionController_internalEvents, _TransactionController_incomingTransactionOptions, _TransactionController_pendingTransactionOptions, _TransactionController_trace, _TransactionController_transactionHistoryLimit, _TransactionController_isFirstTimeInteractionEnabled, _TransactionController_isSimulationEnabled, _TransactionController_testGasFeeFlows, _TransactionController_multichainTrackingHelper, _TransactionController_retryTransaction, _TransactionController_createNonceTracker, _TransactionController_createIncomingTransactionHelper, _TransactionController_createPendingTransactionTracker, _TransactionController_checkForPendingTransactionAndStartPolling, _TransactionController_stopAllTracking, _TransactionController_removeIncomingTransactionHelperListeners, _TransactionController_addIncomingTransactionHelperListeners, _TransactionController_removePendingTransactionTrackerListeners, _TransactionController_addPendingTransactionTrackerListeners, _TransactionController_getNonceTrackerPendingTransactions, _TransactionController_getGasFeeFlows, _TransactionController_getLayer1GasFeeFlows, _TransactionController_updateTransactionInternal, _TransactionController_updateFirstTimeInteraction, _TransactionController_updateSimulationData, _TransactionController_onGasFeePollerTransactionUpdate, _TransactionController_getNetworkClientId, _TransactionController_getGlobalNetworkClientId, _TransactionController_getGlobalChainId, _TransactionController_isCustomNetwork, _TransactionController_getSelectedAccount, _TransactionController_updateSubmitHistory;
+var _TransactionController_instances, _TransactionController_internalEvents, _TransactionController_methodDataHelper, _TransactionController_incomingTransactionOptions, _TransactionController_pendingTransactionOptions, _TransactionController_trace, _TransactionController_transactionHistoryLimit, _TransactionController_isFirstTimeInteractionEnabled, _TransactionController_isSimulationEnabled, _TransactionController_testGasFeeFlows, _TransactionController_multichainTrackingHelper, _TransactionController_retryTransaction, _TransactionController_getChainId, _TransactionController_getNetworkClientId, _TransactionController_getEthQuery, _TransactionController_getProvider, _TransactionController_createNonceTracker, _TransactionController_createRemoteTransactionSource, _TransactionController_createIncomingTransactionHelper, _TransactionController_createPendingTransactionTracker, _TransactionController_checkForPendingTransactionAndStartPolling, _TransactionController_stopAllTracking, _TransactionController_removeIncomingTransactionHelperListeners, _TransactionController_addIncomingTransactionHelperListeners, _TransactionController_removePendingTransactionTrackerListeners, _TransactionController_addPendingTransactionTrackerListeners, _TransactionController_getNonceTrackerPendingTransactions, _TransactionController_getGasFeeFlows, _TransactionController_getLayer1GasFeeFlows, _TransactionController_updateTransactionInternal, _TransactionController_updateFirstTimeInteraction, _TransactionController_updateSimulationData, _TransactionController_onGasFeePollerTransactionUpdate, _TransactionController_getSelectedAccount, _TransactionController_updateSubmitHistory;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TransactionController = exports.ApprovalState = exports.SPEED_UP_RATE = exports.CANCEL_RATE = exports.HARDFORK = void 0;
 const common_1 = require("@ethereumjs/common");
@@ -27,7 +27,8 @@ const nonce_tracker_1 = require("@metamask/nonce-tracker");
 const rpc_errors_1 = require("@metamask/rpc-errors");
 const utils_1 = require("@metamask/utils");
 const async_mutex_1 = require("async-mutex");
-const eth_method_registry_1 = require("eth-method-registry");
+// This package purposefully relies on Node's EventEmitter module.
+// eslint-disable-next-line import/no-nodejs-modules
 const events_1 = require("events");
 const lodash_1 = require("lodash");
 const uuid_1 = require("uuid");
@@ -40,6 +41,7 @@ const TestGasFeeFlow_1 = require("./gas-flows/TestGasFeeFlow.cjs");
 const EtherscanRemoteTransactionSource_1 = require("./helpers/EtherscanRemoteTransactionSource.cjs");
 const GasFeePoller_1 = require("./helpers/GasFeePoller.cjs");
 const IncomingTransactionHelper_1 = require("./helpers/IncomingTransactionHelper.cjs");
+const MethodDataHelper_1 = require("./helpers/MethodDataHelper.cjs");
 const MultichainTrackingHelper_1 = require("./helpers/MultichainTrackingHelper.cjs");
 const PendingTransactionTracker_1 = require("./helpers/PendingTransactionTracker.cjs");
 const logger_1 = require("./logger.cjs");
@@ -149,22 +151,10 @@ class TransactionController extends base_controller_1.BaseController {
         this.messagingSystem.publish(`${controllerName}:transactionFinished`, newTransactionMeta);
         __classPrivateFieldGet(this, _TransactionController_internalEvents, "f").emit(`${transactionMeta.id}:finished`, newTransactionMeta);
     }
-    async registryLookup(fourBytePrefix) {
-        const registryMethod = await this.registry.lookup(fourBytePrefix);
-        if (!registryMethod) {
-            return {
-                registryMethod: '',
-                parsedRegistryMethod: { name: undefined, args: undefined },
-            };
-        }
-        const parsedRegistryMethod = this.registry.parse(registryMethod);
-        return { registryMethod, parsedRegistryMethod };
-    }
     /**
      * Constructs a TransactionController.
      *
      * @param options - The controller options.
-     * @param options.blockTracker - The block tracker used to poll for new blocks data.
      * @param options.disableHistory - Whether to disable storing history in transaction metadata.
      * @param options.disableSendFlowHistory - Explicitly disable transaction metadata history.
      * @param options.disableSwaps - Whether to disable additional processing on swaps transactions.
@@ -177,13 +167,10 @@ class TransactionController extends base_controller_1.BaseController {
      * @param options.getPermittedAccounts - Get accounts that a given origin has permissions for.
      * @param options.getSavedGasFees - Gets the saved gas fee config.
      * @param options.incomingTransactions - Configuration options for incoming transaction support.
-     * @param options.isMultichainEnabled - Enable multichain support.
      * @param options.isFirstTimeInteractionEnabled - Whether first time interaction checks are enabled.
      * @param options.isSimulationEnabled - Whether new transactions will be automatically simulated.
      * @param options.messenger - The controller messenger.
-     * @param options.onNetworkStateChange - Allows subscribing to network controller state changes.
      * @param options.pendingTransactions - Configuration options for pending transaction support.
-     * @param options.provider - The provider used to create the underlying EthQuery instance.
      * @param options.securityProviderRequest - A function for verifying a transaction, whether it is malicious or not.
      * @param options.sign - Function used to sign transactions.
      * @param options.state - Initial state to set on this controller.
@@ -192,7 +179,7 @@ class TransactionController extends base_controller_1.BaseController {
      * @param options.transactionHistoryLimit - Transaction history limit.
      * @param options.hooks - The controller hooks.
      */
-    constructor({ blockTracker, disableHistory, disableSendFlowHistory, disableSwaps, getCurrentAccountEIP1559Compatibility, getCurrentNetworkEIP1559Compatibility, getExternalPendingTransactions, getGasFeeEstimates, getNetworkClientRegistry, getNetworkState, getPermittedAccounts, getSavedGasFees, incomingTransactions = {}, isMultichainEnabled = false, isFirstTimeInteractionEnabled, isSimulationEnabled, messenger, onNetworkStateChange, pendingTransactions = {}, provider, securityProviderRequest, sign, state, testGasFeeFlows, trace, transactionHistoryLimit = 40, hooks, }) {
+    constructor({ disableHistory, disableSendFlowHistory, disableSwaps, getCurrentAccountEIP1559Compatibility, getCurrentNetworkEIP1559Compatibility, getExternalPendingTransactions, getGasFeeEstimates, getNetworkClientRegistry, getNetworkState, getPermittedAccounts, getSavedGasFees, incomingTransactions = {}, isFirstTimeInteractionEnabled, isSimulationEnabled, messenger, pendingTransactions = {}, securityProviderRequest, sign, state, testGasFeeFlows, trace, transactionHistoryLimit = 40, hooks, }) {
         super({
             name: controllerName,
             metadata,
@@ -205,6 +192,7 @@ class TransactionController extends base_controller_1.BaseController {
         _TransactionController_instances.add(this);
         _TransactionController_internalEvents.set(this, new events_1.EventEmitter());
         this.approvingTransactionIds = new Set();
+        _TransactionController_methodDataHelper.set(this, void 0);
         this.mutex = new async_mutex_1.Mutex();
         _TransactionController_incomingTransactionOptions.set(this, void 0);
         _TransactionController_pendingTransactionOptions.set(this, void 0);
@@ -216,8 +204,6 @@ class TransactionController extends base_controller_1.BaseController {
         _TransactionController_testGasFeeFlows.set(this, void 0);
         _TransactionController_multichainTrackingHelper.set(this, void 0);
         _TransactionController_checkForPendingTransactionAndStartPolling.set(this, () => {
-            // PendingTransactionTracker reads state through its getTransactions hook
-            this.pendingTransactionTracker.startIfPendingTransactions();
             __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").checkForPendingTransactionAndStartPolling();
         });
         this.messagingSystem = messenger;
@@ -227,8 +213,6 @@ class TransactionController extends base_controller_1.BaseController {
         this.isSwapsDisabled = disableSwaps ?? false;
         __classPrivateFieldSet(this, _TransactionController_isFirstTimeInteractionEnabled, isFirstTimeInteractionEnabled ?? (() => true), "f");
         __classPrivateFieldSet(this, _TransactionController_isSimulationEnabled, isSimulationEnabled ?? (() => true), "f");
-        // @ts-expect-error the type in eth-method-registry is inappropriate and should be changed
-        this.registry = new eth_method_registry_1.MethodRegistry({ provider });
         this.getSavedGasFees = getSavedGasFees ?? ((_chainId) => undefined);
         this.getCurrentAccountEIP1559Compatibility =
             getCurrentAccountEIP1559Compatibility ?? (() => Promise.resolve(true));
@@ -256,18 +240,10 @@ class TransactionController extends base_controller_1.BaseController {
             hooks?.getAdditionalSignArguments ?? (() => []);
         this.publish =
             hooks?.publish ?? (() => Promise.resolve({ transactionHash: undefined }));
-        this.nonceTracker = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_createNonceTracker).call(this, {
-            provider,
-            blockTracker,
-        });
         const findNetworkClientIdByChainId = (chainId) => {
             return this.messagingSystem.call(`NetworkController:findNetworkClientIdByChainId`, chainId);
         };
         __classPrivateFieldSet(this, _TransactionController_multichainTrackingHelper, new MultichainTrackingHelper_1.MultichainTrackingHelper({
-            isMultichainEnabled,
-            provider,
-            nonceTracker: this.nonceTracker,
-            incomingTransactionOptions: incomingTransactions,
             findNetworkClientIdByChainId,
             getNetworkClientById: ((networkClientId) => {
                 return this.messagingSystem.call(`NetworkController:getNetworkClientById`, networkClientId);
@@ -278,33 +254,19 @@ class TransactionController extends base_controller_1.BaseController {
             createNonceTracker: __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_createNonceTracker).bind(this),
             createIncomingTransactionHelper: __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_createIncomingTransactionHelper).bind(this),
             createPendingTransactionTracker: __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_createPendingTransactionTracker).bind(this),
+            createRemoteTransactionSource: __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_createRemoteTransactionSource).bind(this),
             onNetworkStateChange: (listener) => {
                 this.messagingSystem.subscribe('NetworkController:stateChange', listener);
             },
         }), "f");
         __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").initialize();
-        const etherscanRemoteTransactionSource = new EtherscanRemoteTransactionSource_1.EtherscanRemoteTransactionSource({
-            apiKeysByChainId: incomingTransactions.etherscanApiKeysByChainId,
-            includeTokenTransfers: incomingTransactions.includeTokenTransfers,
-        });
-        this.incomingTransactionHelper = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_createIncomingTransactionHelper).call(this, {
-            blockTracker,
-            etherscanRemoteTransactionSource,
-        });
-        this.pendingTransactionTracker = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_createPendingTransactionTracker).call(this, {
-            provider,
-            blockTracker,
-        });
         this.gasFeeFlows = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getGasFeeFlows).call(this);
         this.layer1GasFeeFlows = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getLayer1GasFeeFlows).call(this);
         const gasFeePoller = new GasFeePoller_1.GasFeePoller({
             findNetworkClientIdByChainId,
             gasFeeFlows: this.gasFeeFlows,
             getGasFeeControllerEstimates: this.getGasFeeEstimates,
-            getProvider: (chainId, networkClientId) => __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getProvider({
-                networkClientId,
-                chainId,
-            }),
+            getProvider: (networkClientId) => __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getProvider).call(this, { networkClientId }),
             getTransactions: () => this.state.transactions,
             layer1GasFeeFlows: this.layer1GasFeeFlows,
             onStateChange: (listener) => {
@@ -312,15 +274,18 @@ class TransactionController extends base_controller_1.BaseController {
             },
         });
         gasFeePoller.hub.on('transaction-updated', __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_onGasFeePollerTransactionUpdate).bind(this));
+        __classPrivateFieldSet(this, _TransactionController_methodDataHelper, new MethodDataHelper_1.MethodDataHelper({
+            getProvider: (networkClientId) => __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getProvider).call(this, { networkClientId }),
+            getState: () => this.state.methodData,
+        }), "f");
+        __classPrivateFieldGet(this, _TransactionController_methodDataHelper, "f").hub.on('update', ({ fourBytePrefix, methodData }) => {
+            this.update((_state) => {
+                _state.methodData[fourBytePrefix] = methodData;
+            });
+        });
         // when transactionsController state changes
         // check for pending transactions and start polling if there are any
         this.messagingSystem.subscribe('TransactionController:stateChange', __classPrivateFieldGet(this, _TransactionController_checkForPendingTransactionAndStartPolling, "f"));
-        // TODO once v2 is merged make sure this only runs when
-        // selectedNetworkClientId changes
-        onNetworkStateChange(() => {
-            (0, logger_1.projectLogger)('Detected network change', this.getChainId());
-            this.pendingTransactionTracker.startIfPendingTransactions();
-        });
         this.onBootCleanup();
         __classPrivateFieldGet(this, _TransactionController_checkForPendingTransactionAndStartPolling, "f").call(this);
     }
@@ -334,25 +299,11 @@ class TransactionController extends base_controller_1.BaseController {
      * Handle new method data request.
      *
      * @param fourBytePrefix - The method prefix.
+     * @param networkClientId - The ID of the network client used to fetch the method data.
      * @returns The method data object corresponding to the given signature prefix.
      */
-    async handleMethodData(fourBytePrefix) {
-        const releaseLock = await this.mutex.acquire();
-        try {
-            const { methodData } = this.state;
-            const knownMethod = Object.keys(methodData).find((knownFourBytePrefix) => fourBytePrefix === knownFourBytePrefix);
-            if (knownMethod) {
-                return methodData[fourBytePrefix];
-            }
-            const registry = await this.registryLookup(fourBytePrefix);
-            this.update((state) => {
-                state.methodData[fourBytePrefix] = registry;
-            });
-            return registry;
-        }
-        finally {
-            releaseLock();
-        }
+    async handleMethodData(fourBytePrefix, networkClientId) {
+        return __classPrivateFieldGet(this, _TransactionController_methodDataHelper, "f").lookup(fourBytePrefix, networkClientId);
     }
     /**
      * Add a new unapproved transaction to state. Parameters will be validated, a
@@ -360,40 +311,38 @@ class TransactionController extends base_controller_1.BaseController {
      * if not provided. If A `<tx.id>:unapproved` hub event will be emitted once added.
      *
      * @param txParams - Standard parameters for an Ethereum transaction.
-     * @param opts - Additional options to control how the transaction is added.
-     * @param opts.actionId - Unique ID to prevent duplicate requests.
-     * @param opts.deviceConfirmedOn - An enum to indicate what device confirmed the transaction.
-     * @param opts.method - RPC method that requested the transaction.
-     * @param opts.origin - The origin of the transaction request, such as a dApp hostname.
-     * @param opts.requireApproval - Whether the transaction requires approval by the user, defaults to true unless explicitly disabled.
-     * @param opts.securityAlertResponse - Response from security validator.
-     * @param opts.sendFlowHistory - The sendFlowHistory entries to add.
-     * @param opts.type - Type of transaction to add, such as 'cancel' or 'swap'.
-     * @param opts.swaps - Options for swaps transactions.
-     * @param opts.swaps.hasApproveTx - Whether the transaction has an approval transaction.
-     * @param opts.swaps.meta - Metadata for swap transaction.
-     * @param opts.networkClientId - The id of the network client for this transaction.
-     * @param opts.traceContext - The parent context for any new traces.
+     * @param options - Additional options to control how the transaction is added.
+     * @param options.actionId - Unique ID to prevent duplicate requests.
+     * @param options.deviceConfirmedOn - An enum to indicate what device confirmed the transaction.
+     * @param options.method - RPC method that requested the transaction.
+     * @param options.origin - The origin of the transaction request, such as a dApp hostname.
+     * @param options.requireApproval - Whether the transaction requires approval by the user, defaults to true unless explicitly disabled.
+     * @param options.securityAlertResponse - Response from security validator.
+     * @param options.sendFlowHistory - The sendFlowHistory entries to add.
+     * @param options.type - Type of transaction to add, such as 'cancel' or 'swap'.
+     * @param options.swaps - Options for swaps transactions.
+     * @param options.swaps.hasApproveTx - Whether the transaction has an approval transaction.
+     * @param options.swaps.meta - Metadata for swap transaction.
+     * @param options.networkClientId - The id of the network client for this transaction.
+     * @param options.traceContext - The parent context for any new traces.
      * @returns Object containing a promise resolving to the transaction hash if approved.
      */
-    async addTransaction(txParams, { actionId, deviceConfirmedOn, method, origin, requireApproval, securityAlertResponse, sendFlowHistory, swaps = {}, traceContext, type, networkClientId: requestNetworkClientId, } = {}) {
-        (0, logger_1.projectLogger)('Adding transaction', txParams);
+    async addTransaction(txParams, options) {
+        (0, logger_1.projectLogger)('Adding transaction', txParams, options);
+        const { actionId, deviceConfirmedOn, method, networkClientId, origin, requireApproval, securityAlertResponse, sendFlowHistory, swaps = {}, traceContext, type, } = options;
         txParams = (0, utils_2.normalizeTransactionParams)(txParams);
-        if (requestNetworkClientId &&
-            !__classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").has(requestNetworkClientId)) {
-            throw new Error('The networkClientId for this transaction could not be found');
+        if (!__classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").has(networkClientId)) {
+            throw new Error(`Network client not found - ${networkClientId}`);
         }
-        const networkClientId = requestNetworkClientId ?? __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getGlobalNetworkClientId).call(this);
         const isEIP1559Compatible = await this.getEIP1559Compatibility(networkClientId);
         (0, validation_1.validateTxParams)(txParams, isEIP1559Compatible);
         if (origin && this.getPermittedAccounts) {
             await (0, validation_1.validateTransactionOrigin)(await this.getPermittedAccounts(origin), __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getSelectedAccount).call(this).address, txParams.from, origin);
         }
         const dappSuggestedGasFees = this.generateDappSuggestedGasFees(txParams, origin);
-        const chainId = this.getChainId(networkClientId);
-        const ethQuery = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getEthQuery({
+        const chainId = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getChainId).call(this, networkClientId);
+        const ethQuery = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getEthQuery).call(this, {
             networkClientId,
-            chainId,
         });
         const transactionType = type ?? (await (0, transaction_type_1.determineTransactionType)(txParams, ethQuery)).type;
         const existingTransactionMeta = this.getTransactionWithActionId(actionId);
@@ -470,29 +419,13 @@ class TransactionController extends base_controller_1.BaseController {
             transactionMeta: addedTransactionMeta,
         };
     }
-    startIncomingTransactionPolling(networkClientIds = []) {
-        if (networkClientIds.length === 0) {
-            this.incomingTransactionHelper.start();
-            return;
-        }
+    startIncomingTransactionPolling(networkClientIds) {
         __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").startIncomingTransactionPolling(networkClientIds);
     }
-    stopIncomingTransactionPolling(networkClientIds = []) {
-        if (networkClientIds.length === 0) {
-            this.incomingTransactionHelper.stop();
-            return;
-        }
+    stopIncomingTransactionPolling(networkClientIds) {
         __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").stopIncomingTransactionPolling(networkClientIds);
     }
-    stopAllIncomingTransactionPolling() {
-        this.incomingTransactionHelper.stop();
-        __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").stopAllIncomingTransactionPolling();
-    }
     async updateIncomingTransactions(networkClientIds = []) {
-        if (networkClientIds.length === 0) {
-            await this.incomingTransactionHelper.update();
-            return;
-        }
         await __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").updateIncomingTransactions(networkClientIds);
     }
     /**
@@ -556,7 +489,7 @@ class TransactionController extends base_controller_1.BaseController {
      * @returns The gas and gas price.
      */
     async estimateGas(transaction, networkClientId) {
-        const ethQuery = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getEthQuery({
+        const ethQuery = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getEthQuery).call(this, {
             networkClientId,
         });
         const { estimatedGas, simulationFails } = await (0, gas_1.estimateGas)(transaction, ethQuery);
@@ -570,7 +503,7 @@ class TransactionController extends base_controller_1.BaseController {
      * @param networkClientId - The network client id to use for the estimate.
      */
     async estimateGasBuffered(transaction, multiplier, networkClientId) {
-        const ethQuery = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getEthQuery({
+        const ethQuery = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getEthQuery).call(this, {
             networkClientId,
         });
         const { blockGasLimit, estimatedGas, simulationFails } = await (0, gas_1.estimateGas)(transaction, ethQuery);
@@ -613,24 +546,21 @@ class TransactionController extends base_controller_1.BaseController {
         this.updateTransaction(updatedTransactionMeta, `${controllerName}:updatesecurityAlertResponse - securityAlertResponse updated`);
     }
     /**
-     * Removes all transactions from state, optionally based on the current network.
+     * Remove transactions from state.
      *
-     * @param ignoreNetwork - Determines whether to wipe all transactions, or just those on the
-     * current network. If `true`, all transactions are wiped.
-     * @param address - If specified, only transactions originating from this address will be
-     * wiped on current network.
+     * @param options - The options bag.
+     * @param options.address - Remove transactions from this account only. Defaults to all accounts.
+     * @param options.chainId - Remove transactions for the specified chain only. Defaults to all chains.
      */
-    wipeTransactions(ignoreNetwork, address) {
-        /* istanbul ignore next */
-        if (ignoreNetwork && !address) {
+    wipeTransactions({ address, chainId, } = {}) {
+        if (!chainId && !address) {
             this.update((state) => {
                 state.transactions = [];
             });
             return;
         }
-        const currentChainId = this.getChainId();
-        const newTransactions = this.state.transactions.filter(({ chainId, txParams }) => {
-            const isMatchingNetwork = ignoreNetwork || chainId === currentChainId;
+        const newTransactions = this.state.transactions.filter(({ chainId: txChainId, txParams }) => {
+            const isMatchingNetwork = !chainId || chainId === txChainId;
             if (!isMatchingNetwork) {
                 return true;
             }
@@ -820,10 +750,8 @@ class TransactionController extends base_controller_1.BaseController {
         };
         editableParams.txParams = (0, lodash_1.pickBy)(editableParams.txParams);
         const updatedTransaction = (0, lodash_1.merge)({}, transactionMeta, editableParams);
-        const provider = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getProvider({
-            chainId: transactionMeta.chainId,
-            networkClientId: transactionMeta.networkClientId,
-        });
+        const { networkClientId } = transactionMeta;
+        const provider = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getProvider).call(this, { networkClientId });
         const ethQuery = new eth_query_1.default(provider);
         const { type } = await (0, transaction_type_1.determineTransactionType)(updatedTransaction.txParams, ethQuery);
         updatedTransaction.type = type;
@@ -851,19 +779,9 @@ class TransactionController extends base_controller_1.BaseController {
             return '';
         }
         const initialTx = listOfTxParams[0];
-        const common = this.getCommonConfiguration(initialTx.chainId);
-        // We need to ensure we get the nonce using the the NonceTracker on the chain matching
-        // the txParams. In this context we only have chainId available to us, but the
-        // NonceTrackers are keyed by networkClientId. To workaround this, we attempt to find
-        // a networkClientId that matches the chainId. As a fallback, the globally selected
-        // network's NonceTracker will be used instead.
-        let networkClientId;
-        try {
-            networkClientId = this.messagingSystem.call(`NetworkController:findNetworkClientIdByChainId`, initialTx.chainId);
-        }
-        catch (err) {
-            (0, logger_1.projectLogger)('failed to find networkClientId from chainId', err);
-        }
+        const { chainId } = initialTx;
+        const common = this.getCommonConfiguration(chainId);
+        const networkClientId = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getNetworkClientId).call(this, { chainId });
         const initialTxAsEthTx = tx_1.TransactionFactory.fromTxData(initialTx, {
             common,
         });
@@ -945,14 +863,12 @@ class TransactionController extends base_controller_1.BaseController {
      * Search transaction metadata for matching entries.
      *
      * @param opts - Options bag.
-     * @param opts.searchCriteria - An object containing values or functions for transaction properties to filter transactions with.
      * @param opts.initialList - The transactions to search. Defaults to the current state.
-     * @param opts.filterToCurrentNetwork - Whether to filter the results to the current network. Defaults to true.
      * @param opts.limit - The maximum number of transactions to return. No limit by default.
+     * @param opts.searchCriteria - An object containing values or functions for transaction properties to filter transactions with.
      * @returns An array of transactions matching the provided options.
      */
-    getTransactions({ searchCriteria = {}, initialList, filterToCurrentNetwork = true, limit, } = {}) {
-        const chainId = this.getChainId();
+    getTransactions({ initialList, limit, searchCriteria = {}, } = {}) {
         // searchCriteria is an object that might have values that aren't predicate
         // methods. When providing any other value type (string, number, etc), we
         // consider this shorthand for "check the value at key for strict equality
@@ -970,9 +886,6 @@ class TransactionController extends base_controller_1.BaseController {
         // Combine sortBy and pickBy to transform our state object into an array of
         // matching transactions that are sorted by time.
         const filteredTransactions = (0, lodash_1.sortBy)((0, lodash_1.pickBy)(transactionsToFilter, (transaction) => {
-            if (filterToCurrentNetwork && transaction.chainId !== chainId) {
-                return false;
-            }
             // iterate over the predicateMethods keys to check if the transaction
             // matches the searchCriteria
             for (const [key, predicate] of Object.entries(predicateMethods)) {
@@ -1028,9 +941,9 @@ class TransactionController extends base_controller_1.BaseController {
         return filteredTransactions;
     }
     async estimateGasFee({ transactionParams, chainId, networkClientId: requestNetworkClientId, }) {
-        const networkClientId = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getNetworkClientId).call(this, {
-            networkClientId: requestNetworkClientId,
+        const { id: networkClientId, provider } = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getNetworkClient({
             chainId,
+            networkClientId: requestNetworkClientId,
         });
         const transactionMeta = {
             txParams: transactionParams,
@@ -1039,10 +952,7 @@ class TransactionController extends base_controller_1.BaseController {
         };
         // Guaranteed as the default gas fee flow matches all transactions.
         const gasFeeFlow = (0, gas_flow_1.getGasFeeFlow)(transactionMeta, this.gasFeeFlows);
-        const ethQuery = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getEthQuery({
-            networkClientId,
-            chainId,
-        });
+        const ethQuery = new eth_query_1.default(provider);
         const gasFeeControllerData = await this.getGasFeeEstimates({
             networkClientId,
         });
@@ -1061,9 +971,9 @@ class TransactionController extends base_controller_1.BaseController {
      * @param request.networkClientId - The ID of a specific network client to process the transaction.
      */
     async getLayer1GasFee({ transactionParams, chainId, networkClientId, }) {
-        const provider = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getProvider({
-            networkClientId,
+        const provider = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getProvider).call(this, {
             chainId,
+            networkClientId,
         });
         return await (0, layer1_gas_fee_flow_1.getTransactionLayer1GasFee)({
             layer1GasFeeFlows: this.layer1GasFeeFlows,
@@ -1134,15 +1044,10 @@ class TransactionController extends base_controller_1.BaseController {
         const isEIP1559Compatible = transactionMeta.txParams.type !== types_1.TransactionEnvelopeType.legacy &&
             (await this.getEIP1559Compatibility(transactionMeta.networkClientId));
         const { networkClientId, chainId } = transactionMeta;
-        const isCustomNetwork = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_isCustomNetwork).call(this, networkClientId);
-        const ethQuery = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getEthQuery({
-            networkClientId,
-            chainId,
-        });
-        const provider = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getProvider({
-            networkClientId,
-            chainId,
-        });
+        const isCustomNetwork = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getNetworkClient({ networkClientId })
+            .configuration.type === network_controller_1.NetworkClientType.Custom;
+        const ethQuery = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getEthQuery).call(this, { networkClientId });
+        const provider = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getProvider).call(this, { networkClientId });
         await __classPrivateFieldGet(this, _TransactionController_trace, "f").call(this, { name: 'Update Gas', parentContext: traceContext }, async () => {
             await (0, gas_1.updateGas)({
                 ethQuery,
@@ -1300,10 +1205,8 @@ class TransactionController extends base_controller_1.BaseController {
             if (!rawTx) {
                 return ApprovalState.NotApproved;
             }
-            const ethQuery = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getEthQuery({
-                networkClientId: transactionMeta.networkClientId,
-                chainId: transactionMeta.chainId,
-            });
+            const { networkClientId } = transactionMeta;
+            const ethQuery = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getEthQuery).call(this, { networkClientId });
             let preTxBalance;
             const shouldUpdatePreTxBalance = transactionMeta.type === types_1.TransactionType.swap;
             if (shouldUpdatePreTxBalance) {
@@ -1497,14 +1400,6 @@ class TransactionController extends base_controller_1.BaseController {
         const isCompleted = this.isLocalFinalState(transaction.status);
         return { meta: transaction, isCompleted };
     }
-    getChainId(networkClientId) {
-        const globalChainId = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getGlobalChainId).call(this);
-        const globalNetworkClientId = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getGlobalNetworkClientId).call(this);
-        if (!networkClientId || networkClientId === globalNetworkClientId) {
-            return globalChainId;
-        }
-        return this.messagingSystem.call(`NetworkController:getNetworkClientById`, networkClientId).configuration.chainId;
-    }
     prepareUnsignedEthTx(chainId, txParams) {
         return tx_1.TransactionFactory.fromTxData(txParams, {
             freeze: false,
@@ -1530,14 +1425,16 @@ class TransactionController extends base_controller_1.BaseController {
     }
     onIncomingTransactions({ added, updated, }) {
         this.update((state) => {
-            const { transactions: currentTransactions } = state;
-            const updatedTransactions = [
-                ...added,
-                ...currentTransactions.map((originalTransaction) => {
-                    const updatedTransaction = updated.find(({ hash }) => hash === originalTransaction.hash);
-                    return updatedTransaction ?? originalTransaction;
-                }),
-            ];
+            const { transactions } = state;
+            const existingTransactions = transactions.map((tx) => updated.find(({ hash }) => hash === tx.hash) ?? tx);
+            const updatedTransactions = [...added, ...existingTransactions].map((tx) => {
+                const { chainId } = tx;
+                const networkClientId = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getNetworkClientId).call(this, { chainId });
+                return {
+                    ...tx,
+                    networkClientId,
+                };
+            });
             state.transactions = this.trimTransactionsForState(updatedTransactions);
         });
     }
@@ -1730,7 +1627,7 @@ class TransactionController extends base_controller_1.BaseController {
             transactionMeta,
         });
     }
-    getNonceTrackerTransactions(status, address, chainId = this.getChainId()) {
+    getNonceTrackerTransactions(status, address, chainId) {
         return (0, nonce_1.getAndFormatTransactionsForNonceTracker)(chainId, address, status, this.state.transactions);
     }
     onConfirmedTransaction(transactionMeta) {
@@ -1746,13 +1643,11 @@ class TransactionController extends base_controller_1.BaseController {
     }
     async updatePostBalance(transactionMeta) {
         try {
-            if (transactionMeta.type !== types_1.TransactionType.swap) {
+            const { networkClientId, type } = transactionMeta;
+            if (type !== types_1.TransactionType.swap) {
                 return;
             }
-            const ethQuery = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getEthQuery({
-                networkClientId: transactionMeta.networkClientId,
-                chainId: transactionMeta.chainId,
-            });
+            const ethQuery = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getEthQuery).call(this, { networkClientId });
             const { updatedTransactionMeta, approvalTransactionMeta } = await (0, swaps_1.updatePostTransactionBalance)(transactionMeta, {
                 ethQuery,
                 getTransaction: this.getTransaction.bind(this),
@@ -1774,7 +1669,6 @@ class TransactionController extends base_controller_1.BaseController {
         }
         catch (error) {
             if (this.isTransactionAlreadyConfirmedError(error)) {
-                await this.pendingTransactionTracker.forceCheckTransaction(transactionMeta);
                 throw new Error('Previous transaction is already confirmed');
             }
             throw error;
@@ -1795,7 +1689,7 @@ class TransactionController extends base_controller_1.BaseController {
     }
 }
 exports.TransactionController = TransactionController;
-_TransactionController_internalEvents = new WeakMap(), _TransactionController_incomingTransactionOptions = new WeakMap(), _TransactionController_pendingTransactionOptions = new WeakMap(), _TransactionController_trace = new WeakMap(), _TransactionController_transactionHistoryLimit = new WeakMap(), _TransactionController_isFirstTimeInteractionEnabled = new WeakMap(), _TransactionController_isSimulationEnabled = new WeakMap(), _TransactionController_testGasFeeFlows = new WeakMap(), _TransactionController_multichainTrackingHelper = new WeakMap(), _TransactionController_checkForPendingTransactionAndStartPolling = new WeakMap(), _TransactionController_instances = new WeakSet(), _TransactionController_retryTransaction = async function _TransactionController_retryTransaction({ actionId, afterSubmit, estimatedBaseFee, gasValues, label, prepareTransactionParams, rate, transactionId, transactionType, }) {
+_TransactionController_internalEvents = new WeakMap(), _TransactionController_methodDataHelper = new WeakMap(), _TransactionController_incomingTransactionOptions = new WeakMap(), _TransactionController_pendingTransactionOptions = new WeakMap(), _TransactionController_trace = new WeakMap(), _TransactionController_transactionHistoryLimit = new WeakMap(), _TransactionController_isFirstTimeInteractionEnabled = new WeakMap(), _TransactionController_isSimulationEnabled = new WeakMap(), _TransactionController_testGasFeeFlows = new WeakMap(), _TransactionController_multichainTrackingHelper = new WeakMap(), _TransactionController_checkForPendingTransactionAndStartPolling = new WeakMap(), _TransactionController_instances = new WeakSet(), _TransactionController_retryTransaction = async function _TransactionController_retryTransaction({ actionId, afterSubmit, estimatedBaseFee, gasValues, label, prepareTransactionParams, rate, transactionId, transactionType, }) {
     // If transaction is found for same action id, do not create a new transaction.
     if (this.getTransactionWithActionId(actionId)) {
         return;
@@ -1830,10 +1724,8 @@ _TransactionController_internalEvents = new WeakMap(), _TransactionController_in
         newFee,
         txParams: newTxParams,
     });
-    const ethQuery = __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getEthQuery({
-        networkClientId: transactionMeta.networkClientId,
-        chainId: transactionMeta.chainId,
-    });
+    const { networkClientId } = transactionMeta;
+    const ethQuery = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getEthQuery).call(this, { networkClientId });
     const newTransactionMeta = {
         ...transactionMetaWithRsv,
         actionId,
@@ -1862,6 +1754,23 @@ _TransactionController_internalEvents = new WeakMap(), _TransactionController_in
         actionId,
     });
     afterSubmit?.(newTransactionMeta);
+}, _TransactionController_getChainId = function _TransactionController_getChainId(networkClientId) {
+    return __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getNetworkClient({ networkClientId })
+        .configuration.chainId;
+}, _TransactionController_getNetworkClientId = function _TransactionController_getNetworkClientId({ chainId, networkClientId, }) {
+    if (networkClientId) {
+        return networkClientId;
+    }
+    return __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getNetworkClient({
+        chainId,
+    }).id;
+}, _TransactionController_getEthQuery = function _TransactionController_getEthQuery({ chainId, networkClientId, }) {
+    return new eth_query_1.default(__classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getProvider).call(this, { chainId, networkClientId }));
+}, _TransactionController_getProvider = function _TransactionController_getProvider({ chainId, networkClientId, }) {
+    return __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").getNetworkClient({
+        chainId,
+        networkClientId,
+    }).provider;
 }, _TransactionController_createNonceTracker = function _TransactionController_createNonceTracker({ provider, blockTracker, chainId, }) {
     return new nonce_tracker_1.NonceTracker({
         // TODO: Fix types
@@ -1870,18 +1779,23 @@ _TransactionController_internalEvents = new WeakMap(), _TransactionController_in
         // TODO: Fix types
         blockTracker,
         getPendingTransactions: __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getNonceTrackerPendingTransactions).bind(this, chainId),
-        getConfirmedTransactions: this.getNonceTrackerTransactions.bind(this, types_1.TransactionStatus.confirmed),
+        getConfirmedTransactions: this.getNonceTrackerTransactions.bind(this, types_1.TransactionStatus.confirmed, chainId),
     });
-}, _TransactionController_createIncomingTransactionHelper = function _TransactionController_createIncomingTransactionHelper({ blockTracker, etherscanRemoteTransactionSource, chainId, }) {
+}, _TransactionController_createRemoteTransactionSource = function _TransactionController_createRemoteTransactionSource() {
+    return new EtherscanRemoteTransactionSource_1.EtherscanRemoteTransactionSource({
+        apiKeysByChainId: __classPrivateFieldGet(this, _TransactionController_incomingTransactionOptions, "f").etherscanApiKeysByChainId,
+        includeTokenTransfers: __classPrivateFieldGet(this, _TransactionController_incomingTransactionOptions, "f").includeTokenTransfers,
+    });
+}, _TransactionController_createIncomingTransactionHelper = function _TransactionController_createIncomingTransactionHelper({ blockTracker, remoteTransactionSource, chainId, }) {
     const incomingTransactionHelper = new IncomingTransactionHelper_1.IncomingTransactionHelper({
         blockTracker,
         getCurrentAccount: () => __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getSelectedAccount).call(this),
         getLastFetchedBlockNumbers: () => this.state.lastFetchedBlockNumbers,
         getLocalTransactions: () => this.state.transactions,
-        getChainId: chainId ? () => chainId : this.getChainId.bind(this),
+        getChainId: () => chainId,
         isEnabled: __classPrivateFieldGet(this, _TransactionController_incomingTransactionOptions, "f").isEnabled,
         queryEntireHistory: __classPrivateFieldGet(this, _TransactionController_incomingTransactionOptions, "f").queryEntireHistory,
-        remoteTransactionSource: etherscanRemoteTransactionSource,
+        remoteTransactionSource,
         transactionLimit: __classPrivateFieldGet(this, _TransactionController_transactionHistoryLimit, "f"),
         updateTransactions: __classPrivateFieldGet(this, _TransactionController_incomingTransactionOptions, "f").updateTransactions,
     });
@@ -1889,15 +1803,14 @@ _TransactionController_internalEvents = new WeakMap(), _TransactionController_in
     return incomingTransactionHelper;
 }, _TransactionController_createPendingTransactionTracker = function _TransactionController_createPendingTransactionTracker({ provider, blockTracker, chainId, }) {
     const ethQuery = new eth_query_1.default(provider);
-    const getChainId = chainId ? () => chainId : this.getChainId.bind(this);
     const pendingTransactionTracker = new PendingTransactionTracker_1.PendingTransactionTracker({
         blockTracker,
-        getChainId,
+        getChainId: () => chainId,
         getEthQuery: () => ethQuery,
         getTransactions: () => this.state.transactions,
         isResubmitEnabled: __classPrivateFieldGet(this, _TransactionController_pendingTransactionOptions, "f").isResubmitEnabled,
         getGlobalLock: () => __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").acquireNonceLockForChainIdKey({
-            chainId: getChainId(),
+            chainId,
         }),
         publishTransaction: (_ethQuery, transactionMeta) => this.publishTransaction(_ethQuery, transactionMeta, {
             skipSubmitHistory: true,
@@ -1910,10 +1823,6 @@ _TransactionController_internalEvents = new WeakMap(), _TransactionController_in
     __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_addPendingTransactionTrackerListeners).call(this, pendingTransactionTracker);
     return pendingTransactionTracker;
 }, _TransactionController_stopAllTracking = function _TransactionController_stopAllTracking() {
-    this.pendingTransactionTracker.stop();
-    __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_removePendingTransactionTrackerListeners).call(this, this.pendingTransactionTracker);
-    this.incomingTransactionHelper.stop();
-    __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_removeIncomingTransactionHelperListeners).call(this, this.incomingTransactionHelper);
     __classPrivateFieldGet(this, _TransactionController_multichainTrackingHelper, "f").stopAllTracking();
 }, _TransactionController_removeIncomingTransactionHelperListeners = function _TransactionController_removeIncomingTransactionHelperListeners(incomingTransactionHelper) {
     incomingTransactionHelper.hub.removeAllListeners('transactions');
@@ -2070,26 +1979,6 @@ _TransactionController_internalEvents = new WeakMap(), _TransactionController_in
             txMeta.layer1GasFee = layer1GasFee;
         }
     });
-}, _TransactionController_getNetworkClientId = function _TransactionController_getNetworkClientId({ networkClientId: requestNetworkClientId, chainId, }) {
-    const globalChainId = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getGlobalChainId).call(this);
-    const globalNetworkClientId = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getGlobalNetworkClientId).call(this);
-    if (requestNetworkClientId) {
-        return requestNetworkClientId;
-    }
-    if (!chainId || chainId === globalChainId) {
-        return globalNetworkClientId;
-    }
-    return this.messagingSystem.call(`NetworkController:findNetworkClientIdByChainId`, chainId);
-}, _TransactionController_getGlobalNetworkClientId = function _TransactionController_getGlobalNetworkClientId() {
-    return this.getNetworkState().selectedNetworkClientId;
-}, _TransactionController_getGlobalChainId = function _TransactionController_getGlobalChainId() {
-    return this.messagingSystem.call(`NetworkController:getNetworkClientById`, this.getNetworkState().selectedNetworkClientId).configuration.chainId;
-}, _TransactionController_isCustomNetwork = function _TransactionController_isCustomNetwork(networkClientId) {
-    const globalNetworkClientId = __classPrivateFieldGet(this, _TransactionController_instances, "m", _TransactionController_getGlobalNetworkClientId).call(this);
-    if (!networkClientId || networkClientId === globalNetworkClientId) {
-        return !(0, controller_utils_1.isInfuraNetworkType)(this.getNetworkState().selectedNetworkClientId);
-    }
-    return (this.messagingSystem.call(`NetworkController:getNetworkClientById`, networkClientId).configuration.type === network_controller_1.NetworkClientType.Custom);
 }, _TransactionController_getSelectedAccount = function _TransactionController_getSelectedAccount() {
     return this.messagingSystem.call('AccountsController:getSelectedAccount');
 }, _TransactionController_updateSubmitHistory = function _TransactionController_updateSubmitHistory(transactionMeta, hash) {