@metamask/transaction-controller 24.0.0 → 25.0.0

package/dist/chunk-C67QD5PV.mjs

@@ -0,0 +1,320 @@
+import {
+  EtherscanRemoteTransactionSource
+} from "./chunk-2K7J3EY3.mjs";
+import {
+  incomingTransactionsLogger
+} from "./chunk-UQQWZT6C.mjs";
+import {
+  __privateAdd,
+  __privateGet,
+  __privateMethod,
+  __privateSet
+} from "./chunk-XUI43LEZ.mjs";
+
+// src/helpers/MultichainTrackingHelper.ts
+import EthQuery from "@metamask/eth-query";
+import { Mutex } from "async-mutex";
+var _isMultichainEnabled, _provider, _nonceTracker, _incomingTransactionOptions, _findNetworkClientIdByChainId, _getNetworkClientById, _getNetworkClientRegistry, _removeIncomingTransactionHelperListeners, _removePendingTransactionTrackerListeners, _createNonceTracker, _createIncomingTransactionHelper, _createPendingTransactionTracker, _nonceMutexesByChainId, _trackingMap, _etherscanRemoteTransactionSourcesMap, _refreshTrackingMap, _stopTrackingByNetworkClientId, stopTrackingByNetworkClientId_fn, _startTrackingByNetworkClientId, startTrackingByNetworkClientId_fn, _refreshEtherscanRemoteTransactionSources;
+var MultichainTrackingHelper = class {
+  constructor({
+    isMultichainEnabled,
+    provider,
+    nonceTracker,
+    incomingTransactionOptions,
+    findNetworkClientIdByChainId,
+    getNetworkClientById,
+    getNetworkClientRegistry,
+    removeIncomingTransactionHelperListeners,
+    removePendingTransactionTrackerListeners,
+    createNonceTracker,
+    createIncomingTransactionHelper,
+    createPendingTransactionTracker,
+    onNetworkStateChange
+  }) {
+    __privateAdd(this, _stopTrackingByNetworkClientId);
+    __privateAdd(this, _startTrackingByNetworkClientId);
+    __privateAdd(this, _isMultichainEnabled, void 0);
+    __privateAdd(this, _provider, void 0);
+    __privateAdd(this, _nonceTracker, void 0);
+    __privateAdd(this, _incomingTransactionOptions, void 0);
+    __privateAdd(this, _findNetworkClientIdByChainId, void 0);
+    __privateAdd(this, _getNetworkClientById, void 0);
+    __privateAdd(this, _getNetworkClientRegistry, void 0);
+    __privateAdd(this, _removeIncomingTransactionHelperListeners, void 0);
+    __privateAdd(this, _removePendingTransactionTrackerListeners, void 0);
+    __privateAdd(this, _createNonceTracker, void 0);
+    __privateAdd(this, _createIncomingTransactionHelper, void 0);
+    __privateAdd(this, _createPendingTransactionTracker, void 0);
+    __privateAdd(this, _nonceMutexesByChainId, /* @__PURE__ */ new Map());
+    __privateAdd(this, _trackingMap, /* @__PURE__ */ new Map());
+    __privateAdd(this, _etherscanRemoteTransactionSourcesMap, /* @__PURE__ */ new Map());
+    this.checkForPendingTransactionAndStartPolling = () => {
+      for (const [, trackers] of __privateGet(this, _trackingMap)) {
+        trackers.pendingTransactionTracker.startIfPendingTransactions();
+      }
+    };
+    __privateAdd(this, _refreshTrackingMap, (networkClients) => {
+      __privateGet(this, _refreshEtherscanRemoteTransactionSources).call(this, networkClients);
+      const networkClientIds = Object.keys(networkClients);
+      const existingNetworkClientIds = Array.from(__privateGet(this, _trackingMap).keys());
+      const networkClientIdsToRemove = existingNetworkClientIds.filter(
+        (id) => !networkClientIds.includes(id)
+      );
+      networkClientIdsToRemove.forEach((id) => {
+        __privateMethod(this, _stopTrackingByNetworkClientId, stopTrackingByNetworkClientId_fn).call(this, id);
+      });
+      const networkClientIdsToAdd = networkClientIds.filter(
+        (id) => !existingNetworkClientIds.includes(id)
+      );
+      networkClientIdsToAdd.forEach((id) => {
+        __privateMethod(this, _startTrackingByNetworkClientId, startTrackingByNetworkClientId_fn).call(this, id);
+      });
+    });
+    __privateAdd(this, _refreshEtherscanRemoteTransactionSources, (networkClients) => {
+      const chainIdsInRegistry = /* @__PURE__ */ new Set();
+      Object.values(networkClients).forEach(
+        (networkClient) => chainIdsInRegistry.add(networkClient.configuration.chainId)
+      );
+      const existingChainIds = Array.from(
+        __privateGet(this, _etherscanRemoteTransactionSourcesMap).keys()
+      );
+      const chainIdsToRemove = existingChainIds.filter(
+        (chainId) => !chainIdsInRegistry.has(chainId)
+      );
+      chainIdsToRemove.forEach((chainId) => {
+        __privateGet(this, _etherscanRemoteTransactionSourcesMap).delete(chainId);
+      });
+    });
+    __privateSet(this, _isMultichainEnabled, isMultichainEnabled);
+    __privateSet(this, _provider, provider);
+    __privateSet(this, _nonceTracker, nonceTracker);
+    __privateSet(this, _incomingTransactionOptions, incomingTransactionOptions);
+    __privateSet(this, _findNetworkClientIdByChainId, findNetworkClientIdByChainId);
+    __privateSet(this, _getNetworkClientById, getNetworkClientById);
+    __privateSet(this, _getNetworkClientRegistry, getNetworkClientRegistry);
+    __privateSet(this, _removeIncomingTransactionHelperListeners, removeIncomingTransactionHelperListeners);
+    __privateSet(this, _removePendingTransactionTrackerListeners, removePendingTransactionTrackerListeners);
+    __privateSet(this, _createNonceTracker, createNonceTracker);
+    __privateSet(this, _createIncomingTransactionHelper, createIncomingTransactionHelper);
+    __privateSet(this, _createPendingTransactionTracker, createPendingTransactionTracker);
+    onNetworkStateChange((_, patches) => {
+      if (__privateGet(this, _isMultichainEnabled)) {
+        const networkClients = __privateGet(this, _getNetworkClientRegistry).call(this);
+        patches.forEach(({ op, path }) => {
+          if (op === "remove" && path[0] === "networkConfigurations") {
+            const networkClientId = path[1];
+            delete networkClients[networkClientId];
+          }
+        });
+        __privateGet(this, _refreshTrackingMap).call(this, networkClients);
+      }
+    });
+  }
+  initialize() {
+    if (!__privateGet(this, _isMultichainEnabled)) {
+      return;
+    }
+    const networkClients = __privateGet(this, _getNetworkClientRegistry).call(this);
+    __privateGet(this, _refreshTrackingMap).call(this, networkClients);
+  }
+  has(networkClientId) {
+    return __privateGet(this, _trackingMap).has(networkClientId);
+  }
+  getEthQuery({
+    networkClientId,
+    chainId
+  } = {}) {
+    if (!__privateGet(this, _isMultichainEnabled)) {
+      return new EthQuery(__privateGet(this, _provider));
+    }
+    let networkClient;
+    if (networkClientId) {
+      try {
+        networkClient = __privateGet(this, _getNetworkClientById).call(this, networkClientId);
+      } catch (err) {
+        incomingTransactionsLogger("failed to get network client by networkClientId");
+      }
+    }
+    if (!networkClient && chainId) {
+      try {
+        networkClientId = __privateGet(this, _findNetworkClientIdByChainId).call(this, chainId);
+        networkClient = __privateGet(this, _getNetworkClientById).call(this, networkClientId);
+      } catch (err) {
+        incomingTransactionsLogger("failed to get network client by chainId");
+      }
+    }
+    if (networkClient) {
+      return new EthQuery(networkClient.provider);
+    }
+    return new EthQuery(__privateGet(this, _provider));
+  }
+  /**
+   * Gets the mutex intended to guard the nonceTracker for a particular chainId and key .
+   *
+   * @param opts - The options object.
+   * @param opts.chainId - The hex chainId.
+   * @param opts.key - The hex address (or constant) pertaining to the chainId
+   * @returns Mutex instance for the given chainId and key pair
+   */
+  async acquireNonceLockForChainIdKey({
+    chainId,
+    key = "global"
+  }) {
+    let nonceMutexesForChainId = __privateGet(this, _nonceMutexesByChainId).get(chainId);
+    if (!nonceMutexesForChainId) {
+      nonceMutexesForChainId = /* @__PURE__ */ new Map();
+      __privateGet(this, _nonceMutexesByChainId).set(chainId, nonceMutexesForChainId);
+    }
+    let nonceMutexForKey = nonceMutexesForChainId.get(key);
+    if (!nonceMutexForKey) {
+      nonceMutexForKey = new Mutex();
+      nonceMutexesForChainId.set(key, nonceMutexForKey);
+    }
+    return await nonceMutexForKey.acquire();
+  }
+  /**
+   * Gets the next nonce according to the nonce-tracker.
+   * Ensure `releaseLock` is called once processing of the `nonce` value is complete.
+   *
+   * @param address - The hex string address for the transaction.
+   * @param networkClientId - The network client ID for the transaction, used to fetch the correct nonce tracker.
+   * @returns object with the `nextNonce` `nonceDetails`, and the releaseLock.
+   */
+  async getNonceLock(address, networkClientId) {
+    let releaseLockForChainIdKey;
+    let nonceTracker = __privateGet(this, _nonceTracker);
+    if (networkClientId && __privateGet(this, _isMultichainEnabled)) {
+      const networkClient = __privateGet(this, _getNetworkClientById).call(this, networkClientId);
+      releaseLockForChainIdKey = await this.acquireNonceLockForChainIdKey({
+        chainId: networkClient.configuration.chainId,
+        key: address
+      });
+      const trackers = __privateGet(this, _trackingMap).get(networkClientId);
+      if (!trackers) {
+        throw new Error("missing nonceTracker for networkClientId");
+      }
+      nonceTracker = trackers.nonceTracker;
+    }
+    try {
+      const nonceLock = await nonceTracker.getNonceLock(address);
+      return {
+        ...nonceLock,
+        releaseLock: () => {
+          nonceLock.releaseLock();
+          releaseLockForChainIdKey?.();
+        }
+      };
+    } catch (err) {
+      releaseLockForChainIdKey?.();
+      throw err;
+    }
+  }
+  startIncomingTransactionPolling(networkClientIds = []) {
+    networkClientIds.forEach((networkClientId) => {
+      __privateGet(this, _trackingMap).get(networkClientId)?.incomingTransactionHelper.start();
+    });
+  }
+  stopIncomingTransactionPolling(networkClientIds = []) {
+    networkClientIds.forEach((networkClientId) => {
+      __privateGet(this, _trackingMap).get(networkClientId)?.incomingTransactionHelper.stop();
+    });
+  }
+  stopAllIncomingTransactionPolling() {
+    for (const [, trackers] of __privateGet(this, _trackingMap)) {
+      trackers.incomingTransactionHelper.stop();
+    }
+  }
+  async updateIncomingTransactions(networkClientIds = []) {
+    const promises = await Promise.allSettled(
+      networkClientIds.map(async (networkClientId) => {
+        return await __privateGet(this, _trackingMap).get(networkClientId)?.incomingTransactionHelper.update();
+      })
+    );
+    promises.filter((result) => result.status === "rejected").forEach((result) => {
+      incomingTransactionsLogger(
+        "failed to update incoming transactions",
+        result.reason
+      );
+    });
+  }
+  stopAllTracking() {
+    for (const [networkClientId] of __privateGet(this, _trackingMap)) {
+      __privateMethod(this, _stopTrackingByNetworkClientId, stopTrackingByNetworkClientId_fn).call(this, networkClientId);
+    }
+  }
+};
+_isMultichainEnabled = new WeakMap();
+_provider = new WeakMap();
+_nonceTracker = new WeakMap();
+_incomingTransactionOptions = new WeakMap();
+_findNetworkClientIdByChainId = new WeakMap();
+_getNetworkClientById = new WeakMap();
+_getNetworkClientRegistry = new WeakMap();
+_removeIncomingTransactionHelperListeners = new WeakMap();
+_removePendingTransactionTrackerListeners = new WeakMap();
+_createNonceTracker = new WeakMap();
+_createIncomingTransactionHelper = new WeakMap();
+_createPendingTransactionTracker = new WeakMap();
+_nonceMutexesByChainId = new WeakMap();
+_trackingMap = new WeakMap();
+_etherscanRemoteTransactionSourcesMap = new WeakMap();
+_refreshTrackingMap = new WeakMap();
+_stopTrackingByNetworkClientId = new WeakSet();
+stopTrackingByNetworkClientId_fn = function(networkClientId) {
+  const trackers = __privateGet(this, _trackingMap).get(networkClientId);
+  if (trackers) {
+    trackers.pendingTransactionTracker.stop();
+    __privateGet(this, _removePendingTransactionTrackerListeners).call(this, trackers.pendingTransactionTracker);
+    trackers.incomingTransactionHelper.stop();
+    __privateGet(this, _removeIncomingTransactionHelperListeners).call(this, trackers.incomingTransactionHelper);
+    __privateGet(this, _trackingMap).delete(networkClientId);
+  }
+};
+_startTrackingByNetworkClientId = new WeakSet();
+startTrackingByNetworkClientId_fn = function(networkClientId) {
+  const trackers = __privateGet(this, _trackingMap).get(networkClientId);
+  if (trackers) {
+    return;
+  }
+  const {
+    provider,
+    blockTracker,
+    configuration: { chainId }
+  } = __privateGet(this, _getNetworkClientById).call(this, networkClientId);
+  let etherscanRemoteTransactionSource = __privateGet(this, _etherscanRemoteTransactionSourcesMap).get(chainId);
+  if (!etherscanRemoteTransactionSource) {
+    etherscanRemoteTransactionSource = new EtherscanRemoteTransactionSource({
+      includeTokenTransfers: __privateGet(this, _incomingTransactionOptions).includeTokenTransfers
+    });
+    __privateGet(this, _etherscanRemoteTransactionSourcesMap).set(
+      chainId,
+      etherscanRemoteTransactionSource
+    );
+  }
+  const nonceTracker = __privateGet(this, _createNonceTracker).call(this, {
+    provider,
+    blockTracker,
+    chainId
+  });
+  const incomingTransactionHelper = __privateGet(this, _createIncomingTransactionHelper).call(this, {
+    blockTracker,
+    etherscanRemoteTransactionSource,
+    chainId
+  });
+  const pendingTransactionTracker = __privateGet(this, _createPendingTransactionTracker).call(this, {
+    provider,
+    blockTracker,
+    chainId
+  });
+  __privateGet(this, _trackingMap).set(networkClientId, {
+    nonceTracker,
+    incomingTransactionHelper,
+    pendingTransactionTracker
+  });
+};
+_refreshEtherscanRemoteTransactionSources = new WeakMap();
+
+export {
+  MultichainTrackingHelper
+};
+//# sourceMappingURL=chunk-C67QD5PV.mjs.map

package/dist/chunk-C67QD5PV.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/helpers/MultichainTrackingHelper.ts"],"sourcesContent":["import EthQuery from '@metamask/eth-query';\nimport type {\n  NetworkClientId,\n  NetworkController,\n  NetworkClient,\n  BlockTracker,\n  Provider,\n  NetworkControllerStateChangeEvent,\n} from '@metamask/network-controller';\nimport type { Hex } from '@metamask/utils';\nimport { Mutex } from 'async-mutex';\nimport type { NonceLock, NonceTracker } from 'nonce-tracker';\n\nimport { incomingTransactionsLogger as log } from '../logger';\nimport { EtherscanRemoteTransactionSource } from './EtherscanRemoteTransactionSource';\nimport type {\n  IncomingTransactionHelper,\n  IncomingTransactionOptions,\n} from './IncomingTransactionHelper';\nimport type { PendingTransactionTracker } from './PendingTransactionTracker';\n\n/**\n * Registry of network clients provided by the NetworkController\n */\ntype NetworkClientRegistry = ReturnType<\n  NetworkController['getNetworkClientRegistry']\n>;\n\nexport type MultichainTrackingHelperOptions = {\n  isMultichainEnabled: boolean;\n  provider: Provider;\n  nonceTracker: NonceTracker;\n  incomingTransactionOptions: IncomingTransactionOptions;\n\n  findNetworkClientIdByChainId: NetworkController['findNetworkClientIdByChainId'];\n  getNetworkClientById: NetworkController['getNetworkClientById'];\n  getNetworkClientRegistry: NetworkController['getNetworkClientRegistry'];\n\n  removeIncomingTransactionHelperListeners: (\n    IncomingTransactionHelper: IncomingTransactionHelper,\n  ) => void;\n  removePendingTransactionTrackerListeners: (\n    pendingTransactionTracker: PendingTransactionTracker,\n  ) => void;\n  createNonceTracker: (opts: {\n    provider: Provider;\n    blockTracker: BlockTracker;\n    chainId?: Hex;\n  }) => NonceTracker;\n  createIncomingTransactionHelper: (opts: {\n    blockTracker: BlockTracker;\n    etherscanRemoteTransactionSource: EtherscanRemoteTransactionSource;\n    chainId?: Hex;\n  }) => IncomingTransactionHelper;\n  createPendingTransactionTracker: (opts: {\n    provider: Provider;\n    blockTracker: BlockTracker;\n    chainId?: Hex;\n  }) => PendingTransactionTracker;\n  onNetworkStateChange: (\n    listener: (\n      ...payload: NetworkControllerStateChangeEvent['payload']\n    ) => void,\n  ) => void;\n};\n\nexport class MultichainTrackingHelper {\n  #isMultichainEnabled: boolean;\n\n  readonly #provider: Provider;\n\n  readonly #nonceTracker: NonceTracker;\n\n  readonly #incomingTransactionOptions: IncomingTransactionOptions;\n\n  readonly #findNetworkClientIdByChainId: NetworkController['findNetworkClientIdByChainId'];\n\n  readonly #getNetworkClientById: NetworkController['getNetworkClientById'];\n\n  readonly #getNetworkClientRegistry: NetworkController['getNetworkClientRegistry'];\n\n  readonly #removeIncomingTransactionHelperListeners: (\n    IncomingTransactionHelper: IncomingTransactionHelper,\n  ) => void;\n\n  readonly #removePendingTransactionTrackerListeners: (\n    pendingTransactionTracker: PendingTransactionTracker,\n  ) => void;\n\n  readonly #createNonceTracker: (opts: {\n    provider: Provider;\n    blockTracker: BlockTracker;\n    chainId?: Hex;\n  }) => NonceTracker;\n\n  readonly #createIncomingTransactionHelper: (opts: {\n    blockTracker: BlockTracker;\n    chainId?: Hex;\n    etherscanRemoteTransactionSource: EtherscanRemoteTransactionSource;\n  }) => IncomingTransactionHelper;\n\n  readonly #createPendingTransactionTracker: (opts: {\n    provider: Provider;\n    blockTracker: BlockTracker;\n    chainId?: Hex;\n  }) => PendingTransactionTracker;\n\n  readonly #nonceMutexesByChainId = new Map<Hex, Map<string, Mutex>>();\n\n  readonly #trackingMap: Map<\n    NetworkClientId,\n    {\n      nonceTracker: NonceTracker;\n      pendingTransactionTracker: PendingTransactionTracker;\n      incomingTransactionHelper: IncomingTransactionHelper;\n    }\n  > = new Map();\n\n  readonly #etherscanRemoteTransactionSourcesMap: Map<\n    Hex,\n    EtherscanRemoteTransactionSource\n  > = new Map();\n\n  constructor({\n    isMultichainEnabled,\n    provider,\n    nonceTracker,\n    incomingTransactionOptions,\n    findNetworkClientIdByChainId,\n    getNetworkClientById,\n    getNetworkClientRegistry,\n    removeIncomingTransactionHelperListeners,\n    removePendingTransactionTrackerListeners,\n    createNonceTracker,\n    createIncomingTransactionHelper,\n    createPendingTransactionTracker,\n    onNetworkStateChange,\n  }: MultichainTrackingHelperOptions) {\n    this.#isMultichainEnabled = isMultichainEnabled;\n    this.#provider = provider;\n    this.#nonceTracker = nonceTracker;\n    this.#incomingTransactionOptions = incomingTransactionOptions;\n\n    this.#findNetworkClientIdByChainId = findNetworkClientIdByChainId;\n    this.#getNetworkClientById = getNetworkClientById;\n    this.#getNetworkClientRegistry = getNetworkClientRegistry;\n\n    this.#removeIncomingTransactionHelperListeners =\n      removeIncomingTransactionHelperListeners;\n    this.#removePendingTransactionTrackerListeners =\n      removePendingTransactionTrackerListeners;\n    this.#createNonceTracker = createNonceTracker;\n    this.#createIncomingTransactionHelper = createIncomingTransactionHelper;\n    this.#createPendingTransactionTracker = createPendingTransactionTracker;\n\n    onNetworkStateChange((_, patches) => {\n      if (this.#isMultichainEnabled) {\n        const networkClients = this.#getNetworkClientRegistry();\n        patches.forEach(({ op, path }) => {\n          if (op === 'remove' && path[0] === 'networkConfigurations') {\n            const networkClientId = path[1] as NetworkClientId;\n            delete networkClients[networkClientId];\n          }\n        });\n\n        this.#refreshTrackingMap(networkClients);\n      }\n    });\n  }\n\n  initialize() {\n    if (!this.#isMultichainEnabled) {\n      return;\n    }\n    const networkClients = this.#getNetworkClientRegistry();\n    this.#refreshTrackingMap(networkClients);\n  }\n\n  has(networkClientId: NetworkClientId) {\n    return this.#trackingMap.has(networkClientId);\n  }\n\n  getEthQuery({\n    networkClientId,\n    chainId,\n  }: {\n    networkClientId?: NetworkClientId;\n    chainId?: Hex;\n  } = {}): EthQuery {\n    if (!this.#isMultichainEnabled) {\n      return new EthQuery(this.#provider);\n    }\n    let networkClient: NetworkClient | undefined;\n\n    if (networkClientId) {\n      try {\n        networkClient = this.#getNetworkClientById(networkClientId);\n      } catch (err) {\n        log('failed to get network client by networkClientId');\n      }\n    }\n    if (!networkClient && chainId) {\n      try {\n        networkClientId = this.#findNetworkClientIdByChainId(chainId);\n        networkClient = this.#getNetworkClientById(networkClientId);\n      } catch (err) {\n        log('failed to get network client by chainId');\n      }\n    }\n\n    if (networkClient) {\n      return new EthQuery(networkClient.provider);\n    }\n\n    // NOTE(JL): we're not ready to drop globally selected ethQuery yet.\n    // Some calls to getEthQuery only have access to optional networkClientId\n    // throw new Error('failed to get eth query instance');\n    return new EthQuery(this.#provider);\n  }\n\n  /**\n   * Gets the mutex intended to guard the nonceTracker for a particular chainId and key .\n   *\n   * @param opts - The options object.\n   * @param opts.chainId - The hex chainId.\n   * @param opts.key - The hex address (or constant) pertaining to the chainId\n   * @returns Mutex instance for the given chainId and key pair\n   */\n  async acquireNonceLockForChainIdKey({\n    chainId,\n    key = 'global',\n  }: {\n    chainId: Hex;\n    key?: string;\n  }): Promise<() => void> {\n    let nonceMutexesForChainId = this.#nonceMutexesByChainId.get(chainId);\n    if (!nonceMutexesForChainId) {\n      nonceMutexesForChainId = new Map<string, Mutex>();\n      this.#nonceMutexesByChainId.set(chainId, nonceMutexesForChainId);\n    }\n    let nonceMutexForKey = nonceMutexesForChainId.get(key);\n    if (!nonceMutexForKey) {\n      nonceMutexForKey = new Mutex();\n      nonceMutexesForChainId.set(key, nonceMutexForKey);\n    }\n\n    return await nonceMutexForKey.acquire();\n  }\n\n  /**\n   * Gets the next nonce according to the nonce-tracker.\n   * Ensure `releaseLock` is called once processing of the `nonce` value is complete.\n   *\n   * @param address - The hex string address for the transaction.\n   * @param networkClientId - The network client ID for the transaction, used to fetch the correct nonce tracker.\n   * @returns object with the `nextNonce` `nonceDetails`, and the releaseLock.\n   */\n  async getNonceLock(\n    address: string,\n    networkClientId?: NetworkClientId,\n  ): Promise<NonceLock> {\n    let releaseLockForChainIdKey: (() => void) | undefined;\n    let nonceTracker = this.#nonceTracker;\n    if (networkClientId && this.#isMultichainEnabled) {\n      const networkClient = this.#getNetworkClientById(networkClientId);\n      releaseLockForChainIdKey = await this.acquireNonceLockForChainIdKey({\n        chainId: networkClient.configuration.chainId,\n        key: address,\n      });\n      const trackers = this.#trackingMap.get(networkClientId);\n      if (!trackers) {\n        throw new Error('missing nonceTracker for networkClientId');\n      }\n      nonceTracker = trackers.nonceTracker;\n    }\n\n    // Acquires the lock for the chainId + address and the nonceLock from the nonceTracker, then\n    // couples them together by replacing the nonceLock's releaseLock method with\n    // an anonymous function that calls releases both the original nonceLock and the\n    // lock for the chainId.\n    try {\n      const nonceLock = await nonceTracker.getNonceLock(address);\n      return {\n        ...nonceLock,\n        releaseLock: () => {\n          nonceLock.releaseLock();\n          releaseLockForChainIdKey?.();\n        },\n      };\n    } catch (err) {\n      releaseLockForChainIdKey?.();\n      throw err;\n    }\n  }\n\n  startIncomingTransactionPolling(networkClientIds: NetworkClientId[] = []) {\n    networkClientIds.forEach((networkClientId) => {\n      this.#trackingMap.get(networkClientId)?.incomingTransactionHelper.start();\n    });\n  }\n\n  stopIncomingTransactionPolling(networkClientIds: NetworkClientId[] = []) {\n    networkClientIds.forEach((networkClientId) => {\n      this.#trackingMap.get(networkClientId)?.incomingTransactionHelper.stop();\n    });\n  }\n\n  stopAllIncomingTransactionPolling() {\n    for (const [, trackers] of this.#trackingMap) {\n      trackers.incomingTransactionHelper.stop();\n    }\n  }\n\n  async updateIncomingTransactions(networkClientIds: NetworkClientId[] = []) {\n    const promises = await Promise.allSettled(\n      networkClientIds.map(async (networkClientId) => {\n        return await this.#trackingMap\n          .get(networkClientId)\n          ?.incomingTransactionHelper.update();\n      }),\n    );\n\n    promises\n      .filter((result) => result.status === 'rejected')\n      .forEach((result) => {\n        log(\n          'failed to update incoming transactions',\n          (result as PromiseRejectedResult).reason,\n        );\n      });\n  }\n\n  checkForPendingTransactionAndStartPolling = () => {\n    for (const [, trackers] of this.#trackingMap) {\n      trackers.pendingTransactionTracker.startIfPendingTransactions();\n    }\n  };\n\n  stopAllTracking() {\n    for (const [networkClientId] of this.#trackingMap) {\n      this.#stopTrackingByNetworkClientId(networkClientId);\n    }\n  }\n\n  #refreshTrackingMap = (networkClients: NetworkClientRegistry) => {\n    this.#refreshEtherscanRemoteTransactionSources(networkClients);\n\n    const networkClientIds = Object.keys(networkClients);\n    const existingNetworkClientIds = Array.from(this.#trackingMap.keys());\n\n    // Remove tracking for NetworkClientIds that no longer exist\n    const networkClientIdsToRemove = existingNetworkClientIds.filter(\n      (id) => !networkClientIds.includes(id),\n    );\n    networkClientIdsToRemove.forEach((id) => {\n      this.#stopTrackingByNetworkClientId(id);\n    });\n\n    // Start tracking new NetworkClientIds from the registry\n    const networkClientIdsToAdd = networkClientIds.filter(\n      (id) => !existingNetworkClientIds.includes(id),\n    );\n    networkClientIdsToAdd.forEach((id) => {\n      this.#startTrackingByNetworkClientId(id);\n    });\n  };\n\n  #stopTrackingByNetworkClientId(networkClientId: NetworkClientId) {\n    const trackers = this.#trackingMap.get(networkClientId);\n    if (trackers) {\n      trackers.pendingTransactionTracker.stop();\n      this.#removePendingTransactionTrackerListeners(\n        trackers.pendingTransactionTracker,\n      );\n      trackers.incomingTransactionHelper.stop();\n      this.#removeIncomingTransactionHelperListeners(\n        trackers.incomingTransactionHelper,\n      );\n      this.#trackingMap.delete(networkClientId);\n    }\n  }\n\n  #startTrackingByNetworkClientId(networkClientId: NetworkClientId) {\n    const trackers = this.#trackingMap.get(networkClientId);\n    if (trackers) {\n      return;\n    }\n\n    const {\n      provider,\n      blockTracker,\n      configuration: { chainId },\n    } = this.#getNetworkClientById(networkClientId);\n\n    let etherscanRemoteTransactionSource =\n      this.#etherscanRemoteTransactionSourcesMap.get(chainId);\n    if (!etherscanRemoteTransactionSource) {\n      etherscanRemoteTransactionSource = new EtherscanRemoteTransactionSource({\n        includeTokenTransfers:\n          this.#incomingTransactionOptions.includeTokenTransfers,\n      });\n      this.#etherscanRemoteTransactionSourcesMap.set(\n        chainId,\n        etherscanRemoteTransactionSource,\n      );\n    }\n\n    const nonceTracker = this.#createNonceTracker({\n      provider,\n      blockTracker,\n      chainId,\n    });\n\n    const incomingTransactionHelper = this.#createIncomingTransactionHelper({\n      blockTracker,\n      etherscanRemoteTransactionSource,\n      chainId,\n    });\n\n    const pendingTransactionTracker = this.#createPendingTransactionTracker({\n      provider,\n      blockTracker,\n      chainId,\n    });\n\n    this.#trackingMap.set(networkClientId, {\n      nonceTracker,\n      incomingTransactionHelper,\n      pendingTransactionTracker,\n    });\n  }\n\n  #refreshEtherscanRemoteTransactionSources = (\n    networkClients: NetworkClientRegistry,\n  ) => {\n    // this will be prettier when we have consolidated network clients with a single chainId:\n    // check if there are still other network clients using the same chainId\n    // if not remove the etherscanRemoteTransaction source from the map\n    const chainIdsInRegistry = new Set();\n    Object.values(networkClients).forEach((networkClient) =>\n      chainIdsInRegistry.add(networkClient.configuration.chainId),\n    );\n    const existingChainIds = Array.from(\n      this.#etherscanRemoteTransactionSourcesMap.keys(),\n    );\n    const chainIdsToRemove = existingChainIds.filter(\n      (chainId) => !chainIdsInRegistry.has(chainId),\n    );\n\n    chainIdsToRemove.forEach((chainId) => {\n      this.#etherscanRemoteTransactionSourcesMap.delete(chainId);\n    });\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA,OAAO,cAAc;AAUrB,SAAS,aAAa;AAVtB;AAkEO,IAAM,2BAAN,MAA+B;AAAA,EAyDpC,YAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAAoC;AAsOpC;AAeA;AA3TA;AAEA,uBAAS,WAAT;AAEA,uBAAS,eAAT;AAEA,uBAAS,6BAAT;AAEA,uBAAS,+BAAT;AAEA,uBAAS,uBAAT;AAEA,uBAAS,2BAAT;AAEA,uBAAS,2CAAT;AAIA,uBAAS,2CAAT;AAIA,uBAAS,qBAAT;AAMA,uBAAS,kCAAT;AAMA,uBAAS,kCAAT;AAMA,uBAAS,wBAAyB,oBAAI,IAA6B;AAEnE,uBAAS,cAOL,oBAAI,IAAI;AAEZ,uBAAS,uCAGL,oBAAI,IAAI;AAmNZ,qDAA4C,MAAM;AAChD,iBAAW,CAAC,EAAE,QAAQ,KAAK,mBAAK,eAAc;AAC5C,iBAAS,0BAA0B,2BAA2B;AAAA,MAChE;AAAA,IACF;AAQA,4CAAsB,CAAC,mBAA0C;AAC/D,yBAAK,2CAAL,WAA+C;AAE/C,YAAM,mBAAmB,OAAO,KAAK,cAAc;AACnD,YAAM,2BAA2B,MAAM,KAAK,mBAAK,cAAa,KAAK,CAAC;AAGpE,YAAM,2BAA2B,yBAAyB;AAAA,QACxD,CAAC,OAAO,CAAC,iBAAiB,SAAS,EAAE;AAAA,MACvC;AACA,+BAAyB,QAAQ,CAAC,OAAO;AACvC,8BAAK,kEAAL,WAAoC;AAAA,MACtC,CAAC;AAGD,YAAM,wBAAwB,iBAAiB;AAAA,QAC7C,CAAC,OAAO,CAAC,yBAAyB,SAAS,EAAE;AAAA,MAC/C;AACA,4BAAsB,QAAQ,CAAC,OAAO;AACpC,8BAAK,oEAAL,WAAqC;AAAA,MACvC,CAAC;AAAA,IACH;AAmEA,kEAA4C,CAC1C,mBACG;AAIH,YAAM,qBAAqB,oBAAI,IAAI;AACnC,aAAO,OAAO,cAAc,EAAE;AAAA,QAAQ,CAAC,kBACrC,mBAAmB,IAAI,cAAc,cAAc,OAAO;AAAA,MAC5D;AACA,YAAM,mBAAmB,MAAM;AAAA,QAC7B,mBAAK,uCAAsC,KAAK;AAAA,MAClD;AACA,YAAM,mBAAmB,iBAAiB;AAAA,QACxC,CAAC,YAAY,CAAC,mBAAmB,IAAI,OAAO;AAAA,MAC9C;AAEA,uBAAiB,QAAQ,CAAC,YAAY;AACpC,2BAAK,uCAAsC,OAAO,OAAO;AAAA,MAC3D,CAAC;AAAA,IACH;AA1TE,uBAAK,sBAAuB;AAC5B,uBAAK,WAAY;AACjB,uBAAK,eAAgB;AACrB,uBAAK,6BAA8B;AAEnC,uBAAK,+BAAgC;AACrC,uBAAK,uBAAwB;AAC7B,uBAAK,2BAA4B;AAEjC,uBAAK,2CACH;AACF,uBAAK,2CACH;AACF,uBAAK,qBAAsB;AAC3B,uBAAK,kCAAmC;AACxC,uBAAK,kCAAmC;AAExC,yBAAqB,CAAC,GAAG,YAAY;AACnC,UAAI,mBAAK,uBAAsB;AAC7B,cAAM,iBAAiB,mBAAK,2BAAL;AACvB,gBAAQ,QAAQ,CAAC,EAAE,IAAI,KAAK,MAAM;AAChC,cAAI,OAAO,YAAY,KAAK,CAAC,MAAM,yBAAyB;AAC1D,kBAAM,kBAAkB,KAAK,CAAC;AAC9B,mBAAO,eAAe,eAAe;AAAA,UACvC;AAAA,QACF,CAAC;AAED,2BAAK,qBAAL,WAAyB;AAAA,MAC3B;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,aAAa;AACX,QAAI,CAAC,mBAAK,uBAAsB;AAC9B;AAAA,IACF;AACA,UAAM,iBAAiB,mBAAK,2BAAL;AACvB,uBAAK,qBAAL,WAAyB;AAAA,EAC3B;AAAA,EAEA,IAAI,iBAAkC;AACpC,WAAO,mBAAK,cAAa,IAAI,eAAe;AAAA,EAC9C;AAAA,EAEA,YAAY;AAAA,IACV;AAAA,IACA;AAAA,EACF,IAGI,CAAC,GAAa;AAChB,QAAI,CAAC,mBAAK,uBAAsB;AAC9B,aAAO,IAAI,SAAS,mBAAK,UAAS;AAAA,IACpC;AACA,QAAI;AAEJ,QAAI,iBAAiB;AACnB,UAAI;AACF,wBAAgB,mBAAK,uBAAL,WAA2B;AAAA,MAC7C,SAAS,KAAK;AACZ,mCAAI,iDAAiD;AAAA,MACvD;AAAA,IACF;AACA,QAAI,CAAC,iBAAiB,SAAS;AAC7B,UAAI;AACF,0BAAkB,mBAAK,+BAAL,WAAmC;AACrD,wBAAgB,mBAAK,uBAAL,WAA2B;AAAA,MAC7C,SAAS,KAAK;AACZ,mCAAI,yCAAyC;AAAA,MAC/C;AAAA,IACF;AAEA,QAAI,eAAe;AACjB,aAAO,IAAI,SAAS,cAAc,QAAQ;AAAA,IAC5C;AAKA,WAAO,IAAI,SAAS,mBAAK,UAAS;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,8BAA8B;AAAA,IAClC;AAAA,IACA,MAAM;AAAA,EACR,GAGwB;AACtB,QAAI,yBAAyB,mBAAK,wBAAuB,IAAI,OAAO;AACpE,QAAI,CAAC,wBAAwB;AAC3B,+BAAyB,oBAAI,IAAmB;AAChD,yBAAK,wBAAuB,IAAI,SAAS,sBAAsB;AAAA,IACjE;AACA,QAAI,mBAAmB,uBAAuB,IAAI,GAAG;AACrD,QAAI,CAAC,kBAAkB;AACrB,yBAAmB,IAAI,MAAM;AAC7B,6BAAuB,IAAI,KAAK,gBAAgB;AAAA,IAClD;AAEA,WAAO,MAAM,iBAAiB,QAAQ;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,aACJ,SACA,iBACoB;AACpB,QAAI;AACJ,QAAI,eAAe,mBAAK;AACxB,QAAI,mBAAmB,mBAAK,uBAAsB;AAChD,YAAM,gBAAgB,mBAAK,uBAAL,WAA2B;AACjD,iCAA2B,MAAM,KAAK,8BAA8B;AAAA,QAClE,SAAS,cAAc,cAAc;AAAA,QACrC,KAAK;AAAA,MACP,CAAC;AACD,YAAM,WAAW,mBAAK,cAAa,IAAI,eAAe;AACtD,UAAI,CAAC,UAAU;AACb,cAAM,IAAI,MAAM,0CAA0C;AAAA,MAC5D;AACA,qBAAe,SAAS;AAAA,IAC1B;AAMA,QAAI;AACF,YAAM,YAAY,MAAM,aAAa,aAAa,OAAO;AACzD,aAAO;AAAA,QACL,GAAG;AAAA,QACH,aAAa,MAAM;AACjB,oBAAU,YAAY;AACtB,qCAA2B;AAAA,QAC7B;AAAA,MACF;AAAA,IACF,SAAS,KAAK;AACZ,iCAA2B;AAC3B,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,gCAAgC,mBAAsC,CAAC,GAAG;AACxE,qBAAiB,QAAQ,CAAC,oBAAoB;AAC5C,yBAAK,cAAa,IAAI,eAAe,GAAG,0BAA0B,MAAM;AAAA,IAC1E,CAAC;AAAA,EACH;AAAA,EAEA,+BAA+B,mBAAsC,CAAC,GAAG;AACvE,qBAAiB,QAAQ,CAAC,oBAAoB;AAC5C,yBAAK,cAAa,IAAI,eAAe,GAAG,0BAA0B,KAAK;AAAA,IACzE,CAAC;AAAA,EACH;AAAA,EAEA,oCAAoC;AAClC,eAAW,CAAC,EAAE,QAAQ,KAAK,mBAAK,eAAc;AAC5C,eAAS,0BAA0B,KAAK;AAAA,IAC1C;AAAA,EACF;AAAA,EAEA,MAAM,2BAA2B,mBAAsC,CAAC,GAAG;AACzE,UAAM,WAAW,MAAM,QAAQ;AAAA,MAC7B,iBAAiB,IAAI,OAAO,oBAAoB;AAC9C,eAAO,MAAM,mBAAK,cACf,IAAI,eAAe,GAClB,0BAA0B,OAAO;AAAA,MACvC,CAAC;AAAA,IACH;AAEA,aACG,OAAO,CAAC,WAAW,OAAO,WAAW,UAAU,EAC/C,QAAQ,CAAC,WAAW;AACnB;AAAA,QACE;AAAA,QACC,OAAiC;AAAA,MACpC;AAAA,IACF,CAAC;AAAA,EACL;AAAA,EAQA,kBAAkB;AAChB,eAAW,CAAC,eAAe,KAAK,mBAAK,eAAc;AACjD,4BAAK,kEAAL,WAAoC;AAAA,IACtC;AAAA,EACF;AA+GF;AAlYE;AAES;AAEA;AAEA;AAEA;AAEA;AAEA;AAEA;AAIA;AAIA;AAMA;AAMA;AAMA;AAEA;AASA;AAkOT;AAuBA;AAAA,mCAA8B,SAAC,iBAAkC;AAC/D,QAAM,WAAW,mBAAK,cAAa,IAAI,eAAe;AACtD,MAAI,UAAU;AACZ,aAAS,0BAA0B,KAAK;AACxC,uBAAK,2CAAL,WACE,SAAS;AAEX,aAAS,0BAA0B,KAAK;AACxC,uBAAK,2CAAL,WACE,SAAS;AAEX,uBAAK,cAAa,OAAO,eAAe;AAAA,EAC1C;AACF;AAEA;AAAA,oCAA+B,SAAC,iBAAkC;AAChE,QAAM,WAAW,mBAAK,cAAa,IAAI,eAAe;AACtD,MAAI,UAAU;AACZ;AAAA,EACF;AAEA,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,eAAe,EAAE,QAAQ;AAAA,EAC3B,IAAI,mBAAK,uBAAL,WAA2B;AAE/B,MAAI,mCACF,mBAAK,uCAAsC,IAAI,OAAO;AACxD,MAAI,CAAC,kCAAkC;AACrC,uCAAmC,IAAI,iCAAiC;AAAA,MACtE,uBACE,mBAAK,6BAA4B;AAAA,IACrC,CAAC;AACD,uBAAK,uCAAsC;AAAA,MACzC;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,eAAe,mBAAK,qBAAL,WAAyB;AAAA,IAC5C;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,QAAM,4BAA4B,mBAAK,kCAAL,WAAsC;AAAA,IACtE;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,QAAM,4BAA4B,mBAAK,kCAAL,WAAsC;AAAA,IACtE;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,qBAAK,cAAa,IAAI,iBAAiB;AAAA,IACrC;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAEA;","names":[]}