@metamask/network-controller 24.1.0 → 24.2.1

package/dist/NetworkController.mjs

@@ -9,7 +9,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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 _NetworkController_instances, _NetworkController_ethQuery, _NetworkController_infuraProjectId, _NetworkController_previouslySelectedNetworkClientId, _NetworkController_providerProxy, _NetworkController_blockTrackerProxy, _NetworkController_autoManagedNetworkClientRegistry, _NetworkController_autoManagedNetworkClient, _NetworkController_log, _NetworkController_getRpcServiceOptions, _NetworkController_getBlockTrackerOptions, _NetworkController_networkConfigurationsByNetworkClientId, _NetworkController_isRpcFailoverEnabled, _NetworkController_updateRpcFailoverEnabled, _NetworkController_refreshNetwork, _NetworkController_getLatestBlock, _NetworkController_determineEIP1559Compatibility, _NetworkController_validateNetworkFields, _NetworkController_determineNetworkConfigurationToPersist, _NetworkController_registerNetworkClientsAsNeeded, _NetworkController_unregisterNetworkClientsAsNeeded, _NetworkController_updateNetworkConfigurations, _NetworkController_ensureAutoManagedNetworkClientRegistryPopulated, _NetworkController_createAutoManagedNetworkClientRegistry, _NetworkController_applyNetworkSelection;
+var _NetworkController_instances, _NetworkController_ethQuery, _NetworkController_infuraProjectId, _NetworkController_previouslySelectedNetworkClientId, _NetworkController_providerProxy, _NetworkController_blockTrackerProxy, _NetworkController_autoManagedNetworkClientRegistry, _NetworkController_autoManagedNetworkClient, _NetworkController_log, _NetworkController_getRpcServiceOptions, _NetworkController_getBlockTrackerOptions, _NetworkController_networkConfigurationsByNetworkClientId, _NetworkController_isRpcFailoverEnabled, _NetworkController_updateRpcFailoverEnabled, _NetworkController_refreshNetwork, _NetworkController_determineNetworkMetadata, _NetworkController_lookupGivenNetwork, _NetworkController_lookupSelectedNetwork, _NetworkController_updateMetadataForNetwork, _NetworkController_getLatestBlock, _NetworkController_determineEIP1559Compatibility, _NetworkController_validateNetworkFields, _NetworkController_determineNetworkConfigurationToPersist, _NetworkController_registerNetworkClientsAsNeeded, _NetworkController_unregisterNetworkClientsAsNeeded, _NetworkController_updateNetworkConfigurations, _NetworkController_ensureAutoManagedNetworkClientRegistryPopulated, _NetworkController_createAutoManagedNetworkClientRegistry, _NetworkController_applyNetworkSelection;
 function $importDefault(module) {
     if (module?.__esModule) {
         return module.default;
@@ -362,16 +362,22 @@ export class NetworkController extends BaseController {
             name: controllerName,
             metadata: {
                 selectedNetworkClientId: {
+                    includeInStateLogs: true,
                     persist: true,
                     anonymous: false,
+                    usedInUi: true,
                 },
                 networksMetadata: {
+                    includeInStateLogs: true,
                     persist: true,
                     anonymous: false,
+                    usedInUi: true,
                 },
                 networkConfigurationsByChainId: {
+                    includeInStateLogs: true,
                     persist: true,
                     anonymous: false,
+                    usedInUi: true,
                 },
             },
             messenger,
@@ -535,221 +541,52 @@ export class NetworkController extends BaseController {
         }
         return customNetworkClient;
     }
-    /**
-     * Ensures that network clients for Infura and custom RPC endpoints have been
-     * created. Then, consulting state, initializes and establishes the currently
-     * selected network client.
-     */
-    async initializeProvider() {
+    initializeProvider({ lookupNetwork = true, } = {}) {
         __classPrivateFieldGet(this, _NetworkController_instances, "m", _NetworkController_applyNetworkSelection).call(this, this.state.selectedNetworkClientId);
-        await this.lookupNetwork();
-    }
-    /**
-     * Refreshes the network meta with EIP-1559 support and the network status
-     * based on the given network client ID.
-     *
-     * @param networkClientId - The ID of the network client to update.
-     */
-    async lookupNetworkByClientId(networkClientId) {
-        const isInfura = isInfuraNetworkType(networkClientId);
-        let updatedNetworkStatus;
-        let updatedIsEIP1559Compatible;
-        try {
-            updatedIsEIP1559Compatible =
-                await __classPrivateFieldGet(this, _NetworkController_instances, "m", _NetworkController_determineEIP1559Compatibility).call(this, networkClientId);
-            updatedNetworkStatus = NetworkStatus.Available;
+        if (lookupNetwork) {
+            return this.lookupNetwork();
         }
-        catch (error) {
-            debugLog('NetworkController: lookupNetworkByClientId: ', error);
-            // TODO: mock ethQuery.sendAsync to throw error without error code
-            /* istanbul ignore else */
-            if (isErrorWithCode(error)) {
-                let responseBody;
-                if (isInfura &&
-                    hasProperty(error, 'message') &&
-                    typeof error.message === 'string') {
-                    try {
-                        responseBody = JSON.parse(error.message);
-                    }
-                    catch {
-                        // error.message must not be JSON
-                        __classPrivateFieldGet(this, _NetworkController_log, "f")?.warn('NetworkController: lookupNetworkByClientId: json parse error: ', error);
-                    }
-                }
-                if (isPlainObject(responseBody) &&
-                    responseBody.error === INFURA_BLOCKED_KEY) {
-                    updatedNetworkStatus = NetworkStatus.Blocked;
-                }
-                else if (error.code === errorCodes.rpc.internal) {
-                    updatedNetworkStatus = NetworkStatus.Unknown;
-                    __classPrivateFieldGet(this, _NetworkController_log, "f")?.warn('NetworkController: lookupNetworkByClientId: rpc internal error: ', error);
-                }
-                else {
-                    updatedNetworkStatus = NetworkStatus.Unavailable;
-                    __classPrivateFieldGet(this, _NetworkController_log, "f")?.warn('NetworkController: lookupNetworkByClientId: ', error);
-                }
-            }
-            else if (typeof Error !== 'undefined' &&
-                hasProperty(error, 'message') &&
-                typeof error.message === 'string' &&
-                error.message.includes('No custom network client was found with the ID')) {
-                throw error;
-            }
-            else {
-                debugLog('NetworkController - could not determine network status', error);
-                updatedNetworkStatus = NetworkStatus.Unknown;
-                __classPrivateFieldGet(this, _NetworkController_log, "f")?.warn('NetworkController: lookupNetworkByClientId: ', error);
-            }
-        }
-        this.update((state) => {
-            if (state.networksMetadata[networkClientId] === undefined) {
-                state.networksMetadata[networkClientId] = {
-                    status: NetworkStatus.Unknown,
-                    EIPS: {},
-                };
-            }
-            const meta = state.networksMetadata[networkClientId];
-            meta.status = updatedNetworkStatus;
-            if (updatedIsEIP1559Compatible === undefined) {
-                delete meta.EIPS[1559];
-            }
-            else {
-                meta.EIPS[1559] = updatedIsEIP1559Compatible;
-            }
-        });
+        return undefined;
     }
     /**
-     * Persists the following metadata about the given or selected network to
-     * state:
+     * Uses a request for the latest block to gather the following information on
+     * the given or selected network, persisting it to state:
      *
-     * - The status of the network, namely, whether it is available, geo-blocked
-     * (Infura only), or unavailable, or whether the status is unknown
-     * - Whether the network supports EIP-1559, or whether it is unknown
+     * - The connectivity status: whether it is available, geo-blocked (Infura
+     * only), unavailable, or unknown
+     * - The capabilities status: whether it supports EIP-1559, whether it does
+     * not, or whether it is unknown
      *
-     * Note that it is possible for the network to be switched while this data is
-     * being collected. If that is the case, no metadata for the (now previously)
-     * selected network will be updated.
-     *
-     * @param networkClientId - The ID of the network client to update.
+     * @param networkClientId - The ID of the network client to inspect.
      * If no ID is provided, uses the currently selected network.
      */
     async lookupNetwork(networkClientId) {
         if (networkClientId) {
-            await this.lookupNetworkByClientId(networkClientId);
-            return;
-        }
-        if (!__classPrivateFieldGet(this, _NetworkController_ethQuery, "f")) {
-            return;
-        }
-        const isInfura = __classPrivateFieldGet(this, _NetworkController_autoManagedNetworkClient, "f")?.configuration.type ===
-            NetworkClientType.Infura;
-        let networkChanged = false;
-        const listener = () => {
-            networkChanged = true;
-            try {
-                this.messagingSystem.unsubscribe('NetworkController:networkDidChange', listener);
-            }
-            catch (error) {
-                // In theory, this `catch` should not be necessary given that this error
-                // would occur "inside" of the call to `#determineEIP1559Compatibility`
-                // below and so it should be caught by the `try`/`catch` below (it is
-                // impossible to reproduce in tests for that reason). However, somehow
-                // it occurs within Mobile and so we have to add our own `try`/`catch`
-                // here.
-                /* istanbul ignore next */
-                if (!(error instanceof Error) ||
-                    error.message !==
-                        'Subscription not found for event: NetworkController:networkDidChange') {
-                    // Again, this error should not happen and is impossible to reproduce
-                    // in tests.
-                    /* istanbul ignore next */
-                    throw error;
-                }
-            }
-        };
-        this.messagingSystem.subscribe('NetworkController:networkDidChange', listener);
-        let updatedNetworkStatus;
-        let updatedIsEIP1559Compatible;
-        try {
-            const isEIP1559Compatible = await __classPrivateFieldGet(this, _NetworkController_instances, "m", _NetworkController_determineEIP1559Compatibility).call(this, this.state.selectedNetworkClientId);
-            updatedNetworkStatus = NetworkStatus.Available;
-            updatedIsEIP1559Compatible = isEIP1559Compatible;
-        }
-        catch (error) {
-            // TODO: mock ethQuery.sendAsync to throw error without error code
-            /* istanbul ignore else */
-            if (isErrorWithCode(error)) {
-                let responseBody;
-                if (isInfura &&
-                    hasProperty(error, 'message') &&
-                    typeof error.message === 'string') {
-                    try {
-                        responseBody = JSON.parse(error.message);
-                    }
-                    catch (parseError) {
-                        // error.message must not be JSON
-                        __classPrivateFieldGet(this, _NetworkController_log, "f")?.warn('NetworkController: lookupNetwork: json parse error', parseError);
-                    }
-                }
-                if (isPlainObject(responseBody) &&
-                    responseBody.error === INFURA_BLOCKED_KEY) {
-                    updatedNetworkStatus = NetworkStatus.Blocked;
-                }
-                else if (error.code === errorCodes.rpc.internal) {
-                    updatedNetworkStatus = NetworkStatus.Unknown;
-                    __classPrivateFieldGet(this, _NetworkController_log, "f")?.warn('NetworkController: lookupNetwork: rpc internal error', error);
-                }
-                else {
-                    updatedNetworkStatus = NetworkStatus.Unavailable;
-                    __classPrivateFieldGet(this, _NetworkController_log, "f")?.warn('NetworkController: lookupNetwork: ', error);
-                }
-            }
-            else {
-                debugLog('NetworkController - could not determine network status', error);
-                updatedNetworkStatus = NetworkStatus.Unknown;
-                __classPrivateFieldGet(this, _NetworkController_log, "f")?.warn('NetworkController: lookupNetwork: ', error);
-            }
-        }
-        if (networkChanged) {
-            // If the network has changed, then `lookupNetwork` either has been or is
-            // in the process of being called, so we don't need to go further.
-            return;
-        }
-        try {
-            this.messagingSystem.unsubscribe('NetworkController:networkDidChange', listener);
-        }
-        catch (error) {
-            if (!(error instanceof Error) ||
-                error.message !==
-                    'Subscription not found for event: NetworkController:networkDidChange') {
-                throw error;
-            }
-        }
-        this.update((state) => {
-            const meta = state.networksMetadata[state.selectedNetworkClientId];
-            meta.status = updatedNetworkStatus;
-            if (updatedIsEIP1559Compatible === undefined) {
-                delete meta.EIPS[1559];
-            }
-            else {
-                meta.EIPS[1559] = updatedIsEIP1559Compatible;
-            }
-        });
-        if (isInfura) {
-            if (updatedNetworkStatus === NetworkStatus.Available) {
-                this.messagingSystem.publish('NetworkController:infuraIsUnblocked');
-            }
-            else if (updatedNetworkStatus === NetworkStatus.Blocked) {
-                this.messagingSystem.publish('NetworkController:infuraIsBlocked');
-            }
+            await __classPrivateFieldGet(this, _NetworkController_instances, "m", _NetworkController_lookupGivenNetwork).call(this, networkClientId);
         }
         else {
-            // Always publish infuraIsUnblocked regardless of network status to
-            // prevent consumers from being stuck in a blocked state if they were
-            // previously connected to an Infura network that was blocked
-            this.messagingSystem.publish('NetworkController:infuraIsUnblocked');
+            await __classPrivateFieldGet(this, _NetworkController_instances, "m", _NetworkController_lookupSelectedNetwork).call(this);
         }
     }
+    /**
+     * Uses a request for the latest block to gather the following information on
+     * the given network, persisting it to state:
+     *
+     * - The connectivity status: whether the network is available, geo-blocked
+     * (Infura only), unavailable, or unknown
+     * - The feature compatibility status: whether the network supports EIP-1559,
+     * whether it does not, or whether it is unknown
+     *
+     * @param networkClientId - The ID of the network client to inspect.
+     * @deprecated Please use `lookupNetwork` and pass a network client ID
+     * instead. This method will be removed in a future major version.
+     */
+    // We are planning on removing this so we aren't interested in testing this
+    // right now.
+    /* istanbul ignore next */
+    async lookupNetworkByClientId(networkClientId) {
+        await __classPrivateFieldGet(this, _NetworkController_instances, "m", _NetworkController_lookupGivenNetwork).call(this, networkClientId);
+    }
     /**
      * Convenience method to update provider network type settings.
      *
@@ -1243,6 +1080,174 @@ async function _NetworkController_refreshNetwork(networkClientId, options = {})
     __classPrivateFieldGet(this, _NetworkController_instances, "m", _NetworkController_applyNetworkSelection).call(this, networkClientId, options);
     this.messagingSystem.publish('NetworkController:networkDidChange', this.state);
     await this.lookupNetwork();
+}, _NetworkController_determineNetworkMetadata = 
+/**
+ * Uses a request for the latest block to gather the following information on
+ * the given network:
+ *
+ * - The connectivity status: whether it is available, geo-blocked (Infura
+ * only), unavailable, or unknown
+ * - The capabilities status: whether it supports EIP-1559, whether it does
+ * not, or whether it is unknown
+ *
+ * @param networkClientId - The ID of the network client to inspect.
+ * If no ID is provided, uses the currently selected network.
+ * @returns The resulting metadata for the network.
+ */
+async function _NetworkController_determineNetworkMetadata(networkClientId) {
+    // Force TypeScript to use one of the two overloads explicitly
+    const networkClient = isInfuraNetworkType(networkClientId)
+        ? this.getNetworkClientById(networkClientId)
+        : this.getNetworkClientById(networkClientId);
+    const isInfura = networkClient.configuration.type === NetworkClientType.Infura;
+    let networkStatus;
+    let isEIP1559Compatible;
+    try {
+        isEIP1559Compatible =
+            await __classPrivateFieldGet(this, _NetworkController_instances, "m", _NetworkController_determineEIP1559Compatibility).call(this, networkClientId);
+        networkStatus = NetworkStatus.Available;
+    }
+    catch (error) {
+        debugLog('NetworkController: lookupNetwork: ', error);
+        if (isErrorWithCode(error)) {
+            let responseBody;
+            if (isInfura &&
+                hasProperty(error, 'message') &&
+                typeof error.message === 'string') {
+                try {
+                    responseBody = JSON.parse(error.message);
+                }
+                catch {
+                    // error.message must not be JSON
+                    __classPrivateFieldGet(this, _NetworkController_log, "f")?.warn('NetworkController: lookupNetwork: json parse error: ', error);
+                }
+            }
+            if (isPlainObject(responseBody) &&
+                responseBody.error === INFURA_BLOCKED_KEY) {
+                networkStatus = NetworkStatus.Blocked;
+            }
+            else if (error.code === errorCodes.rpc.internal) {
+                networkStatus = NetworkStatus.Unknown;
+                __classPrivateFieldGet(this, _NetworkController_log, "f")?.warn('NetworkController: lookupNetwork: rpc internal error: ', error);
+            }
+            else {
+                networkStatus = NetworkStatus.Unavailable;
+                __classPrivateFieldGet(this, _NetworkController_log, "f")?.warn('NetworkController: lookupNetwork: ', error);
+            }
+        }
+        else {
+            debugLog('NetworkController - could not determine network status', error);
+            networkStatus = NetworkStatus.Unknown;
+            __classPrivateFieldGet(this, _NetworkController_log, "f")?.warn('NetworkController: lookupNetwork: ', error);
+        }
+    }
+    return { isInfura, networkStatus, isEIP1559Compatible };
+}, _NetworkController_lookupGivenNetwork = 
+/**
+ * Uses a request for the latest block to gather the following information on
+ * the given network, persisting it to state:
+ *
+ * - The connectivity status: whether the network is available, geo-blocked
+ * (Infura only), unavailable, or unknown
+ * - The feature compatibility status: whether the network supports EIP-1559,
+ * whether it does not, or whether it is unknown
+ *
+ * @param networkClientId - The ID of the network client to inspect.
+ */
+async function _NetworkController_lookupGivenNetwork(networkClientId) {
+    const { networkStatus, isEIP1559Compatible } = await __classPrivateFieldGet(this, _NetworkController_instances, "m", _NetworkController_determineNetworkMetadata).call(this, networkClientId);
+    __classPrivateFieldGet(this, _NetworkController_instances, "m", _NetworkController_updateMetadataForNetwork).call(this, networkClientId, networkStatus, isEIP1559Compatible);
+}, _NetworkController_lookupSelectedNetwork = 
+/**
+ * Uses a request for the latest block to gather the following information on
+ * the currently selected network, persisting it to state:
+ *
+ * - The connectivity status: whether the network is available, geo-blocked
+ * (Infura only), unavailable, or unknown
+ * - The feature compatibility status: whether the network supports EIP-1559,
+ * whether it does not, or whether it is unknown
+ *
+ * Note that it is possible for the current network to be switched while this
+ * method is running. If that is the case, it will exit early (as this method
+ * will also run for the new network).
+ */
+async function _NetworkController_lookupSelectedNetwork() {
+    if (!__classPrivateFieldGet(this, _NetworkController_ethQuery, "f")) {
+        return;
+    }
+    let networkChanged = false;
+    const listener = () => {
+        networkChanged = true;
+        try {
+            this.messagingSystem.unsubscribe('NetworkController:networkDidChange', listener);
+        }
+        catch (error) {
+            // In theory, this `catch` should not be necessary given that this error
+            // would occur "inside" of the call to `#determineEIP1559Compatibility`
+            // below and so it should be caught by the `try`/`catch` below (it is
+            // impossible to reproduce in tests for that reason). However, somehow
+            // it occurs within Mobile and so we have to add our own `try`/`catch`
+            // here.
+            /* istanbul ignore next */
+            if (!(error instanceof Error) ||
+                error.message !==
+                    'Subscription not found for event: NetworkController:networkDidChange') {
+                // Again, this error should not happen and is impossible to reproduce
+                // in tests.
+                /* istanbul ignore next */
+                throw error;
+            }
+        }
+    };
+    this.messagingSystem.subscribe('NetworkController:networkDidChange', listener);
+    const { isInfura, networkStatus, isEIP1559Compatible } = await __classPrivateFieldGet(this, _NetworkController_instances, "m", _NetworkController_determineNetworkMetadata).call(this, this.state.selectedNetworkClientId);
+    if (networkChanged) {
+        // If the network has changed, then `lookupNetwork` either has been or is
+        // in the process of being called, so we don't need to go further.
+        return;
+    }
+    try {
+        this.messagingSystem.unsubscribe('NetworkController:networkDidChange', listener);
+    }
+    catch (error) {
+        if (!(error instanceof Error) ||
+            error.message !==
+                'Subscription not found for event: NetworkController:networkDidChange') {
+            throw error;
+        }
+    }
+    __classPrivateFieldGet(this, _NetworkController_instances, "m", _NetworkController_updateMetadataForNetwork).call(this, this.state.selectedNetworkClientId, networkStatus, isEIP1559Compatible);
+    if (isInfura) {
+        if (networkStatus === NetworkStatus.Available) {
+            this.messagingSystem.publish('NetworkController:infuraIsUnblocked');
+        }
+        else if (networkStatus === NetworkStatus.Blocked) {
+            this.messagingSystem.publish('NetworkController:infuraIsBlocked');
+        }
+    }
+    else {
+        // Always publish infuraIsUnblocked regardless of network status to
+        // prevent consumers from being stuck in a blocked state if they were
+        // previously connected to an Infura network that was blocked
+        this.messagingSystem.publish('NetworkController:infuraIsUnblocked');
+    }
+}, _NetworkController_updateMetadataForNetwork = function _NetworkController_updateMetadataForNetwork(networkClientId, networkStatus, isEIP1559Compatible) {
+    this.update((state) => {
+        if (state.networksMetadata[networkClientId] === undefined) {
+            state.networksMetadata[networkClientId] = {
+                status: NetworkStatus.Unknown,
+                EIPS: {},
+            };
+        }
+        const meta = state.networksMetadata[networkClientId];
+        meta.status = networkStatus;
+        if (isEIP1559Compatible === undefined) {
+            delete meta.EIPS[1559];
+        }
+        else {
+            meta.EIPS[1559] = isEIP1559Compatible;
+        }
+    });
 }, _NetworkController_getLatestBlock = function _NetworkController_getLatestBlock(networkClientId) {
     if (networkClientId === undefined) {
         networkClientId = this.state.selectedNetworkClientId;
@@ -1441,6 +1446,7 @@ async function _NetworkController_determineEIP1559Compatibility(networkClientId)
                 getBlockTrackerOptions: __classPrivateFieldGet(this, _NetworkController_getBlockTrackerOptions, "f"),
                 messenger: this.messagingSystem,
                 isRpcFailoverEnabled: __classPrivateFieldGet(this, _NetworkController_isRpcFailoverEnabled, "f"),
+                logger: __classPrivateFieldGet(this, _NetworkController_log, "f"),
             });
         }
         else {
@@ -1456,6 +1462,7 @@ async function _NetworkController_determineEIP1559Compatibility(networkClientId)
                 getBlockTrackerOptions: __classPrivateFieldGet(this, _NetworkController_getBlockTrackerOptions, "f"),
                 messenger: this.messagingSystem,
                 isRpcFailoverEnabled: __classPrivateFieldGet(this, _NetworkController_isRpcFailoverEnabled, "f"),
+                logger: __classPrivateFieldGet(this, _NetworkController_log, "f"),
             });
         }
     }
@@ -1515,6 +1522,7 @@ async function _NetworkController_determineEIP1559Compatibility(networkClientId)
                         getBlockTrackerOptions: __classPrivateFieldGet(this, _NetworkController_getBlockTrackerOptions, "f"),
                         messenger: this.messagingSystem,
                         isRpcFailoverEnabled: __classPrivateFieldGet(this, _NetworkController_isRpcFailoverEnabled, "f"),
+                        logger: __classPrivateFieldGet(this, _NetworkController_log, "f"),
                     }),
                 ];
             }
@@ -1532,6 +1540,7 @@ async function _NetworkController_determineEIP1559Compatibility(networkClientId)
                     getBlockTrackerOptions: __classPrivateFieldGet(this, _NetworkController_getBlockTrackerOptions, "f"),
                     messenger: this.messagingSystem,
                     isRpcFailoverEnabled: __classPrivateFieldGet(this, _NetworkController_isRpcFailoverEnabled, "f"),
+                    logger: __classPrivateFieldGet(this, _NetworkController_log, "f"),
                 }),
             ];
         });