@metamask-previews/network-connection-banner-controller 0.1.0-preview-6fc64deac → 0.1.0-preview-975339c60

package/README.md

@@ -2,7 +2,11 @@
 
 NetworkConnectionBannerController decides when and how to surface the network
 connection banner based on RPC endpoint health. It encapsulates the rule and
-the 5s/30s timer state machine.
+the 5s/30s timer state machine. Both timeouts are configurable via the
+`degradedBannerTimeout` and `unavailableBannerTimeout` constructor options
+(defaults exported as `DEFAULT_DEGRADED_BANNER_TIMEOUT` and
+`DEFAULT_UNAVAILABLE_BANNER_TIMEOUT`); the unavailable timeout is measured
+from the same failure start and must be greater than the degraded one.
 
 ## Lifecycle
 

package/dist/NetworkConnectionBannerController.cjs

@@ -1,18 +1,18 @@
 "use strict";
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _NetworkConnectionBannerController_instances, _NetworkConnectionBannerController_degradedTimer, _NetworkConnectionBannerController_unavailableTimer, _NetworkConnectionBannerController_pendingNetworkClientId, _NetworkConnectionBannerController_isStarted, _NetworkConnectionBannerController_isUiOpen, _NetworkConnectionBannerController_isUnlocked, _NetworkConnectionBannerController_updateLifecycle, _NetworkConnectionBannerController_start, _NetworkConnectionBannerController_stop, _NetworkConnectionBannerController_refreshState, _NetworkConnectionBannerController_resetBanner, _NetworkConnectionBannerController_clearTimers, _NetworkConnectionBannerController_findFailedNetwork, _NetworkConnectionBannerController_getEnabledEvmChainIds, _NetworkConnectionBannerController_collectEnabledNetworks, _NetworkConnectionBannerController_buildFailedNetwork, _NetworkConnectionBannerController_pickFailedNetworkToDisplay;
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _NetworkConnectionBannerController_instances, _NetworkConnectionBannerController_degradedTimer, _NetworkConnectionBannerController_unavailableTimer, _NetworkConnectionBannerController_pendingNetworkClientId, _NetworkConnectionBannerController_isStarted, _NetworkConnectionBannerController_isUiOpen, _NetworkConnectionBannerController_isUnlocked, _NetworkConnectionBannerController_infuraProjectId, _NetworkConnectionBannerController_degradedBannerTimeout, _NetworkConnectionBannerController_unavailableBannerTimeout, _NetworkConnectionBannerController_updateLifecycle, _NetworkConnectionBannerController_start, _NetworkConnectionBannerController_stop, _NetworkConnectionBannerController_refreshState, _NetworkConnectionBannerController_resetBanner, _NetworkConnectionBannerController_clearTimers, _NetworkConnectionBannerController_findFailedNetwork, _NetworkConnectionBannerController_getEnabledEvmChainIds, _NetworkConnectionBannerController_collectEnabledNetworks, _NetworkConnectionBannerController_buildFailedNetwork, _NetworkConnectionBannerController_pickFailedNetworkToDisplay;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NetworkConnectionBannerController = exports.getDefaultNetworkConnectionBannerControllerState = void 0;
+exports.NetworkConnectionBannerController = exports.DEFAULT_UNAVAILABLE_BANNER_TIMEOUT = exports.DEFAULT_DEGRADED_BANNER_TIMEOUT = exports.getDefaultNetworkConnectionBannerControllerState = void 0;
 const base_controller_1 = require("@metamask/base-controller");
 const client_controller_1 = require("@metamask/client-controller");
 const connectivity_controller_1 = require("@metamask/connectivity-controller");
@@ -98,41 +98,54 @@ function getDefaultNetworkConnectionBannerControllerState() {
 }
 exports.getDefaultNetworkConnectionBannerControllerState = getDefaultNetworkConnectionBannerControllerState;
 /**
- * How long (in milliseconds) a failing network must remain in a "failed"
- * status ("degraded" or "unavailable") before the degraded banner appears.
+ * The default for how long (in milliseconds) a failing network must remain
+ * in a "failed" status ("degraded" or "unavailable") before the degraded
+ * banner appears.
  */
-const DEGRADED_BANNER_TIMEOUT = 5000;
+exports.DEFAULT_DEGRADED_BANNER_TIMEOUT = 5000;
 /**
- * How long (in milliseconds) a failing network must remain in a "failed"
- * status before the banner escalates to "unavailable".
+ * The default for how long (in milliseconds) a failing network must remain
+ * in a "failed" status before the banner escalates to "unavailable".
  */
-const UNAVAILABLE_BANNER_TIMEOUT = 30000;
+exports.DEFAULT_UNAVAILABLE_BANNER_TIMEOUT = 30000;
 const MESSENGER_EXPOSED_METHODS = [
     'dismissBanner',
     'switchToDefaultInfuraRpcEndpoint',
 ];
 /**
- * NetworkConnectionBannerController decides whether the network connection
- * banner should be shown for the user, and which failing network it should
- * describe. It encapsulates the rule and the 5s / 30s timer escalation.
+ * Drives the "network connection banner", a notice that appears within clients
+ * whose goal is to inform users about networks which have exhibited repeated
+ * request failures and offer potential workarounds.
+ *
+ * Some terminology: A "network" in this case is an RPC endpoint, and a network
+ * that has exhibited repeated request failures has entered a "failed" state (or
+ * is a "failed network").
  *
- * The banner shows when:
+ * For simplicity, the banner always represents a single failed network. If
+ * multiple networks are failing, the first custom network takes priority over
+ * the first Infura network.
  *
- * - A failing network's default RPC is a custom (non-Infura) endpoint —
- *   users always want to be informed about errors with RPCs they've chosen.
- * - Every enabled EVM network is reporting a failed connectivity status
- *   (escape hatch so Infura-only setups still get a signal).
+ * To ensure that the banner is actionable, the banner does not always appear
+ * even if there is a failed network to display. Instead it appears under these
+ * conditions:
  *
- * A partial Infura outage alongside healthy peers is suppressed since it
- * usually resolves on its own and the user cannot act on it. When a custom
- * failure is present, it's surfaced first so the "Switch to MetaMask default
- * RPC" CTA targets the network the user can act on.
+ * - The failed network is a custom (non-Infura) endpoint (we want to inform
+ *   users about endpoints they've added so they don't cast blame on MetaMask).
+ * - Every enabled EVM network has entered a failed state (this indicates a
+ *   broad connectivity issue).
  *
- * The controller manages its own lifecycle: it evaluates RPC health (and
- * runs the escalation timers) only while the client UI is open
- * (`ClientController`) and the wallet is unlocked (`KeyringController`).
- * Clients only need to render the banner from the controller's state and wire
- * click handlers to {@link dismissBanner} or {@link switchToDefaultInfuraRpcEndpoint}.
+ * Assuming that these conditions have been met, there are two variants of the
+ * banner which will be displayed at different times.
+ *
+ * - A "degraded" variant which will appear when 5 seconds has elapsed and there
+ *   is an eligible failed network to display
+ * - An "unavailable" variant which will appear when 30 seconds have elapsed and
+ *   there is an eligible failed network to display
+ *
+ * Finally, the controller contains actions that drive interactions with the
+ * banner. Namely, if the banner represents a custom network, then it will offer
+ * the user a way to switch to the default Infura network. The controller
+ * contains the logic to carry out that action.
  */
 class NetworkConnectionBannerController extends base_controller_1.BaseController {
     /**
@@ -140,8 +153,16 @@ class NetworkConnectionBannerController extends base_controller_1.BaseController
      *
      * @param args - The arguments to this controller.
      * @param args.messenger - The messenger suited for this controller.
+     * @param args.infuraProjectId - The wallet's Infura project id.
+     * @param args.degradedBannerTimeout - How long (in milliseconds) a failing
+     * network must remain failed before the degraded banner appears.
+     * @param args.unavailableBannerTimeout - How long (in milliseconds) before
+     * the banner escalates to "unavailable". Must be greater than
+     * `degradedBannerTimeout`.
+     * @throws If `unavailableBannerTimeout` is not greater than
+     * `degradedBannerTimeout`.
      */
-    constructor({ messenger }) {
+    constructor({ messenger, infuraProjectId, degradedBannerTimeout = exports.DEFAULT_DEGRADED_BANNER_TIMEOUT, unavailableBannerTimeout = exports.DEFAULT_UNAVAILABLE_BANNER_TIMEOUT, }) {
         super({
             messenger,
             metadata: networkConnectionBannerControllerMetadata,
@@ -157,6 +178,15 @@ class NetworkConnectionBannerController extends base_controller_1.BaseController
         _NetworkConnectionBannerController_isUiOpen.set(this, false);
         /** Whether the keyring is unlocked. Combined with {@link #isUiOpen}. */
         _NetworkConnectionBannerController_isUnlocked.set(this, false);
+        _NetworkConnectionBannerController_infuraProjectId.set(this, void 0);
+        _NetworkConnectionBannerController_degradedBannerTimeout.set(this, void 0);
+        _NetworkConnectionBannerController_unavailableBannerTimeout.set(this, void 0);
+        if (unavailableBannerTimeout <= degradedBannerTimeout) {
+            throw new Error(`\`unavailableBannerTimeout\` (${unavailableBannerTimeout}) must be greater than \`degradedBannerTimeout\` (${degradedBannerTimeout}).`);
+        }
+        __classPrivateFieldSet(this, _NetworkConnectionBannerController_infuraProjectId, infuraProjectId, "f");
+        __classPrivateFieldSet(this, _NetworkConnectionBannerController_degradedBannerTimeout, degradedBannerTimeout, "f");
+        __classPrivateFieldSet(this, _NetworkConnectionBannerController_unavailableBannerTimeout, unavailableBannerTimeout, "f");
         // Upstream controllers still expose :stateChange; switch to :stateChanged
         // once those packages migrate their event types.
         /* eslint-disable no-restricted-syntax -- awaiting upstream :stateChanged migration */
@@ -212,7 +242,7 @@ class NetworkConnectionBannerController extends base_controller_1.BaseController
         if (!networkConfiguration) {
             throw new Error(`No network configuration found for chain ID "${chainId}".`);
         }
-        const infuraEndpointIndex = networkConfiguration.rpcEndpoints.findIndex((endpoint) => (0, url_utils_1.getIsInfuraEndpoint)(endpoint.url));
+        const infuraEndpointIndex = networkConfiguration.rpcEndpoints.findIndex((endpoint) => (0, url_utils_1.getIsInfuraEndpoint)(endpoint.url, __classPrivateFieldGet(this, _NetworkConnectionBannerController_infuraProjectId, "f")));
         if (infuraEndpointIndex === -1) {
             throw new Error(`No Infura endpoint available for chain ID "${chainId}".`);
         }
@@ -220,21 +250,23 @@ class NetworkConnectionBannerController extends base_controller_1.BaseController
             // The default is already Infura; nothing to do.
             return;
         }
-        await this.messenger.call('NetworkController:updateNetwork', chainId, {
-            ...networkConfiguration,
-            defaultRpcEndpointIndex: infuraEndpointIndex,
-        });
-        // Move the active connection onto the Infura endpoint too, so the user
-        // is no longer connected to the failing endpoint.
+        // Move the active connection onto the Infura endpoint first, then make
+        // it the default. In this order a partial failure leaves the failing
+        // default in place and the banner visible, rather than hiding the banner
+        // while the wallet is still connected to the broken endpoint.
         const infuraNetworkClientId = networkConfiguration.rpcEndpoints[infuraEndpointIndex].networkClientId;
         const { selectedNetworkClientId } = this.messenger.call('NetworkController:getState');
         if (infuraNetworkClientId !== selectedNetworkClientId) {
             await this.messenger.call('NetworkController:setActiveNetwork', infuraNetworkClientId);
         }
+        await this.messenger.call('NetworkController:updateNetwork', chainId, {
+            ...networkConfiguration,
+            defaultRpcEndpointIndex: infuraEndpointIndex,
+        });
     }
 }
 exports.NetworkConnectionBannerController = NetworkConnectionBannerController;
-_NetworkConnectionBannerController_degradedTimer = new WeakMap(), _NetworkConnectionBannerController_unavailableTimer = new WeakMap(), _NetworkConnectionBannerController_pendingNetworkClientId = new WeakMap(), _NetworkConnectionBannerController_isStarted = new WeakMap(), _NetworkConnectionBannerController_isUiOpen = new WeakMap(), _NetworkConnectionBannerController_isUnlocked = new WeakMap(), _NetworkConnectionBannerController_instances = new WeakSet(), _NetworkConnectionBannerController_updateLifecycle = function _NetworkConnectionBannerController_updateLifecycle() {
+_NetworkConnectionBannerController_degradedTimer = new WeakMap(), _NetworkConnectionBannerController_unavailableTimer = new WeakMap(), _NetworkConnectionBannerController_pendingNetworkClientId = new WeakMap(), _NetworkConnectionBannerController_isStarted = new WeakMap(), _NetworkConnectionBannerController_isUiOpen = new WeakMap(), _NetworkConnectionBannerController_isUnlocked = new WeakMap(), _NetworkConnectionBannerController_infuraProjectId = new WeakMap(), _NetworkConnectionBannerController_degradedBannerTimeout = new WeakMap(), _NetworkConnectionBannerController_unavailableBannerTimeout = new WeakMap(), _NetworkConnectionBannerController_instances = new WeakSet(), _NetworkConnectionBannerController_updateLifecycle = function _NetworkConnectionBannerController_updateLifecycle() {
     if (__classPrivateFieldGet(this, _NetworkConnectionBannerController_isUiOpen, "f") && __classPrivateFieldGet(this, _NetworkConnectionBannerController_isUnlocked, "f")) {
         __classPrivateFieldGet(this, _NetworkConnectionBannerController_instances, "m", _NetworkConnectionBannerController_start).call(this);
     }
@@ -320,8 +352,8 @@ _NetworkConnectionBannerController_degradedTimer = new WeakMap(), _NetworkConnec
                 state.networkConnectionBannerStatus = 'unavailable';
                 state.networkConnectionBannerNetwork = failedNetwork;
             });
-        }, UNAVAILABLE_BANNER_TIMEOUT - DEGRADED_BANNER_TIMEOUT), "f");
-    }, DEGRADED_BANNER_TIMEOUT), "f");
+        }, __classPrivateFieldGet(this, _NetworkConnectionBannerController_unavailableBannerTimeout, "f") - __classPrivateFieldGet(this, _NetworkConnectionBannerController_degradedBannerTimeout, "f")), "f");
+    }, __classPrivateFieldGet(this, _NetworkConnectionBannerController_degradedBannerTimeout, "f")), "f");
 }, _NetworkConnectionBannerController_resetBanner = function _NetworkConnectionBannerController_resetBanner() {
     __classPrivateFieldGet(this, _NetworkConnectionBannerController_instances, "m", _NetworkConnectionBannerController_clearTimers).call(this);
     __classPrivateFieldSet(this, _NetworkConnectionBannerController_pendingNetworkClientId, undefined, "f");
@@ -375,13 +407,13 @@ _NetworkConnectionBannerController_degradedTimer = new WeakMap(), _NetworkConnec
         ];
     });
 }, _NetworkConnectionBannerController_buildFailedNetwork = function _NetworkConnectionBannerController_buildFailedNetwork({ chainId, name, rpcEndpoints, defaultRpcEndpointIndex, defaultRpcEndpoint, }) {
-    const isInfuraEndpoint = (0, url_utils_1.getIsInfuraEndpoint)(defaultRpcEndpoint.url);
+    const isInfuraEndpoint = (0, url_utils_1.getIsInfuraEndpoint)(defaultRpcEndpoint.url, __classPrivateFieldGet(this, _NetworkConnectionBannerController_infuraProjectId, "f"));
     // For custom endpoints (non-Infura), find an Infura endpoint on this
     // chain that we could offer to switch to.
     let switchableInfuraNetworkClientId = null;
     if (!isInfuraEndpoint) {
         const infuraEndpoint = rpcEndpoints.find((endpoint, index) => index !== defaultRpcEndpointIndex &&
-            (0, url_utils_1.getIsInfuraEndpoint)(endpoint.url));
+            (0, url_utils_1.getIsInfuraEndpoint)(endpoint.url, __classPrivateFieldGet(this, _NetworkConnectionBannerController_infuraProjectId, "f")));
         switchableInfuraNetworkClientId = infuraEndpoint?.networkClientId ?? null;
     }
     return {

package/dist/NetworkConnectionBannerController.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkConnectionBannerController.cjs","sourceRoot":"","sources":["../src/NetworkConnectionBannerController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangedEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport { clientControllerSelectors } from '@metamask/client-controller';\nimport type { ClientControllerState } from '@metamask/client-controller';\nimport {\n  CONNECTIVITY_STATUSES,\n  connectivityControllerSelectors,\n} from '@metamask/connectivity-controller';\nimport type {\n  ConnectivityControllerGetStateAction,\n  ConnectivityControllerState,\n  ConnectivityControllerStateChangeEvent,\n} from '@metamask/connectivity-controller';\nimport type {\n  KeyringControllerLockEvent,\n  KeyringControllerUnlockEvent,\n} from '@metamask/keyring-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type {\n  NetworkConfiguration,\n  NetworkControllerGetNetworkConfigurationByChainIdAction,\n  NetworkControllerGetStateAction,\n  NetworkControllerUpdateNetworkAction,\n  NetworkControllerSetActiveNetworkAction,\n  NetworkControllerStateChangeEvent,\n  NetworkMetadata,\n  NetworkState,\n} from '@metamask/network-controller';\nimport { NetworkStatus } from '@metamask/network-controller';\nimport type {\n  NetworkEnablementControllerGetStateAction,\n  NetworkEnablementControllerState,\n  NetworkEnablementControllerStateChangeEvent,\n} from '@metamask/network-enablement-controller';\nimport { selectEnabledNetworkMap } from '@metamask/network-enablement-controller';\nimport type { Hex } from '@metamask/utils';\nimport { KnownCaipNamespace } from '@metamask/utils';\nimport { createSelector } from 'reselect';\n\nimport type { NetworkConnectionBannerControllerMethodActions } from './NetworkConnectionBannerController-method-action-types';\nimport { getIsInfuraEndpoint } from './url-utils';\n\n/**\n * The name of the {@link NetworkConnectionBannerController}, used to namespace\n * the controller's actions and events and to namespace the controller's state\n * data when composed with other controllers.\n */\nconst CONTROLLER_NAME = 'NetworkConnectionBannerController';\n\n/**\n * Selects `networksMetadata` from the `NetworkController` state.\n *\n * @param state - The `NetworkController` state.\n * @returns The networks metadata map keyed by network client id.\n */\nconst selectNetworksMetadata = (\n  state: NetworkState,\n): NetworkState['networksMetadata'] => state.networksMetadata;\n\n/**\n * Selects `networkConfigurationsByChainId` from the `NetworkController`\n * state.\n *\n * @param state - The `NetworkController` state.\n * @returns The network configurations keyed by chain id.\n */\nconst selectNetworkConfigurationsByChainId = (\n  state: NetworkState,\n): NetworkState['networkConfigurationsByChainId'] =>\n  state.networkConfigurationsByChainId;\n\n/**\n * Selects the `NetworkController` state fields that influence the banner\n * rule. Composed with `createSelector` so the return object stays reference\n * stable while unrelated `NetworkController` state (e.g.\n * `selectedNetworkClientId`) changes.\n *\n * @param state - The `NetworkController` state.\n * @returns The relevant network fields.\n */\nconst selectNetworkControllerFields = createSelector(\n  [selectNetworksMetadata, selectNetworkConfigurationsByChainId],\n  (networksMetadata, networkConfigurationsByChainId) => ({\n    networksMetadata,\n    networkConfigurationsByChainId,\n  }),\n);\n\n/**\n * Selects the `NetworkEnablementController` state field that influences the\n * banner rule.\n *\n * @param state - The `NetworkEnablementController` state.\n * @returns The relevant enablement fields.\n */\nconst selectNetworkEnablementControllerFields = createSelector(\n  [selectEnabledNetworkMap],\n  (enabledNetworkMap) => ({ enabledNetworkMap }),\n);\n\n/**\n * Selects the `ConnectivityController` state field that influences the\n * banner rule.\n *\n * @param state - The `ConnectivityController` state.\n * @returns The relevant connectivity fields.\n */\nconst selectConnectivityControllerFields = createSelector(\n  [connectivityControllerSelectors.selectConnectivityStatus],\n  (connectivityStatus) => ({ connectivityStatus }),\n);\n\n/**\n * Status the banner can be in. `available` means no banner is shown; the\n * `degraded` and `unavailable` values mirror the two-tier escalation that the\n * UI renders.\n */\nexport type NetworkConnectionBannerStatus =\n  | 'available'\n  | 'degraded'\n  | 'unavailable';\n\n/**\n * An enabled network from `NetworkController` state with a default RPC\n * endpoint. Used as the input to the failed-network detection pipeline.\n * `metadata` is missing until the network's connectivity has been looked up.\n */\ntype EnabledNetwork = {\n  chainId: Hex;\n  name: string;\n  rpcEndpoints: NetworkConfiguration['rpcEndpoints'];\n  defaultRpcEndpointIndex: number;\n  defaultRpcEndpoint: NetworkConfiguration['rpcEndpoints'][number];\n  metadata: NetworkMetadata | undefined;\n};\n\n/**\n * Details of a failing network the banner describes.\n */\nexport type FailedNetwork = {\n  /** The chain id of the failing network. */\n  chainId: Hex;\n  /** The `networkClientId` of the failing default RPC endpoint. */\n  networkClientId: string;\n  /** The display name for the failing network. */\n  name: string;\n  /** The URL of the failing default RPC endpoint. */\n  rpcUrl: string;\n  /** Whether the failing endpoint is a MetaMask Infura endpoint. */\n  isInfuraEndpoint: boolean;\n  /**\n   * The networkClientId of an Infura endpoint on the same chain that the user\n   * can switch to. `null` when the failing endpoint is already Infura or when\n   * no Infura alternative exists.\n   */\n  switchableInfuraNetworkClientId: string | null;\n};\n\n/**\n * State for the {@link NetworkConnectionBannerController}.\n *\n * The keys carry the controller-domain prefix (like\n * `ConnectivityController`'s `connectivityStatus`) because some clients merge\n * all controller states into one flat object, where generic names like\n * `status` collide across controllers.\n */\nexport type NetworkConnectionBannerControllerState = {\n  networkConnectionBannerStatus: NetworkConnectionBannerStatus;\n  networkConnectionBannerNetwork: FailedNetwork | null;\n};\n\nconst networkConnectionBannerControllerMetadata = {\n  networkConnectionBannerStatus: {\n    persist: false,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  networkConnectionBannerNetwork: {\n    persist: false,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n} satisfies StateMetadata<NetworkConnectionBannerControllerState>;\n\n/**\n * Constructs the default {@link NetworkConnectionBannerController} state.\n *\n * @returns The default state.\n */\nexport function getDefaultNetworkConnectionBannerControllerState(): NetworkConnectionBannerControllerState {\n  return {\n    networkConnectionBannerStatus: 'available',\n    networkConnectionBannerNetwork: null,\n  };\n}\n\n/**\n * How long (in milliseconds) a failing network must remain in a \"failed\"\n * status (\"degraded\" or \"unavailable\") before the degraded banner appears.\n */\nconst DEGRADED_BANNER_TIMEOUT = 5_000;\n\n/**\n * How long (in milliseconds) a failing network must remain in a \"failed\"\n * status before the banner escalates to \"unavailable\".\n */\nconst UNAVAILABLE_BANNER_TIMEOUT = 30_000;\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'dismissBanner',\n  'switchToDefaultInfuraRpcEndpoint',\n] as const;\n\n/**\n * Retrieves the state of the {@link NetworkConnectionBannerController}.\n */\nexport type NetworkConnectionBannerControllerGetStateAction =\n  ControllerGetStateAction<\n    typeof CONTROLLER_NAME,\n    NetworkConnectionBannerControllerState\n  >;\n\n/**\n * Actions that {@link NetworkConnectionBannerControllerMessenger} exposes to\n * other consumers.\n */\nexport type NetworkConnectionBannerControllerActions =\n  | NetworkConnectionBannerControllerGetStateAction\n  | NetworkConnectionBannerControllerMethodActions;\n\n/**\n * Actions from other messengers that\n * {@link NetworkConnectionBannerControllerMessenger} calls.\n */\ntype AllowedActions =\n  | NetworkControllerGetStateAction\n  | NetworkControllerGetNetworkConfigurationByChainIdAction\n  | NetworkControllerUpdateNetworkAction\n  | NetworkControllerSetActiveNetworkAction\n  | NetworkEnablementControllerGetStateAction\n  | ConnectivityControllerGetStateAction;\n\n/**\n * Published when the state of {@link NetworkConnectionBannerController}\n * changes.\n */\nexport type NetworkConnectionBannerControllerStateChangedEvent =\n  ControllerStateChangedEvent<\n    typeof CONTROLLER_NAME,\n    NetworkConnectionBannerControllerState\n  >;\n\n/**\n * Events that {@link NetworkConnectionBannerControllerMessenger} exposes to\n * other consumers.\n */\nexport type NetworkConnectionBannerControllerEvents =\n  NetworkConnectionBannerControllerStateChangedEvent;\n\n/**\n * Published when the state of `ClientController` changes. Defined here\n * because the `client-controller` package still exports the legacy\n * `:stateChange` event type.\n */\ntype ClientControllerStateChangedEvent = ControllerStateChangedEvent<\n  'ClientController',\n  ClientControllerState\n>;\n\n/**\n * Events from other messengers that\n * {@link NetworkConnectionBannerControllerMessenger} subscribes to.\n */\ntype AllowedEvents =\n  | NetworkControllerStateChangeEvent\n  | NetworkEnablementControllerStateChangeEvent\n  | ConnectivityControllerStateChangeEvent\n  | ClientControllerStateChangedEvent\n  | KeyringControllerUnlockEvent\n  | KeyringControllerLockEvent;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link NetworkConnectionBannerController}.\n */\nexport type NetworkConnectionBannerControllerMessenger = Messenger<\n  typeof CONTROLLER_NAME,\n  NetworkConnectionBannerControllerActions | AllowedActions,\n  NetworkConnectionBannerControllerEvents | AllowedEvents\n>;\n\n/**\n * Options for constructing the {@link NetworkConnectionBannerController}.\n */\nexport type NetworkConnectionBannerControllerOptions = {\n  /**\n   * The messenger for inter-controller communication.\n   */\n  messenger: NetworkConnectionBannerControllerMessenger;\n};\n\n/**\n * NetworkConnectionBannerController decides whether the network connection\n * banner should be shown for the user, and which failing network it should\n * describe. It encapsulates the rule and the 5s / 30s timer escalation.\n *\n * The banner shows when:\n *\n * - A failing network's default RPC is a custom (non-Infura) endpoint —\n *   users always want to be informed about errors with RPCs they've chosen.\n * - Every enabled EVM network is reporting a failed connectivity status\n *   (escape hatch so Infura-only setups still get a signal).\n *\n * A partial Infura outage alongside healthy peers is suppressed since it\n * usually resolves on its own and the user cannot act on it. When a custom\n * failure is present, it's surfaced first so the \"Switch to MetaMask default\n * RPC\" CTA targets the network the user can act on.\n *\n * The controller manages its own lifecycle: it evaluates RPC health (and\n * runs the escalation timers) only while the client UI is open\n * (`ClientController`) and the wallet is unlocked (`KeyringController`).\n * Clients only need to render the banner from the controller's state and wire\n * click handlers to {@link dismissBanner} or {@link switchToDefaultInfuraRpcEndpoint}.\n */\nexport class NetworkConnectionBannerController extends BaseController<\n  typeof CONTROLLER_NAME,\n  NetworkConnectionBannerControllerState,\n  NetworkConnectionBannerControllerMessenger\n> {\n  #degradedTimer: ReturnType<typeof setTimeout> | undefined;\n\n  #unavailableTimer: ReturnType<typeof setTimeout> | undefined;\n\n  #pendingNetworkClientId: string | undefined;\n\n  #isStarted = false;\n\n  /** Whether the client UI is open. Combined with {@link #isUnlocked}. */\n  #isUiOpen = false;\n\n  /** Whether the keyring is unlocked. Combined with {@link #isUiOpen}. */\n  #isUnlocked = false;\n\n  /**\n   * Constructs a new {@link NetworkConnectionBannerController}.\n   *\n   * @param args - The arguments to this controller.\n   * @param args.messenger - The messenger suited for this controller.\n   */\n  constructor({ messenger }: NetworkConnectionBannerControllerOptions) {\n    super({\n      messenger,\n      metadata: networkConnectionBannerControllerMetadata,\n      name: CONTROLLER_NAME,\n      state: getDefaultNetworkConnectionBannerControllerState(),\n    });\n\n    // Upstream controllers still expose :stateChange; switch to :stateChanged\n    // once those packages migrate their event types.\n    /* eslint-disable no-restricted-syntax -- awaiting upstream :stateChanged migration */\n    this.messenger.subscribe(\n      'NetworkController:stateChange',\n      (networkControllerState) =>\n        this.#refreshState({\n          networkControllerState,\n          networkEnablementControllerState: this.messenger.call(\n            'NetworkEnablementController:getState',\n          ),\n          connectivityControllerState: this.messenger.call(\n            'ConnectivityController:getState',\n          ),\n        }),\n      selectNetworkControllerFields,\n    );\n    this.messenger.subscribe(\n      'NetworkEnablementController:stateChange',\n      (networkEnablementControllerState) =>\n        this.#refreshState({\n          networkControllerState: this.messenger.call(\n            'NetworkController:getState',\n          ),\n          networkEnablementControllerState,\n          connectivityControllerState: this.messenger.call(\n            'ConnectivityController:getState',\n          ),\n        }),\n      selectNetworkEnablementControllerFields,\n    );\n    this.messenger.subscribe(\n      'ConnectivityController:stateChange',\n      (connectivityControllerState) =>\n        this.#refreshState({\n          networkControllerState: this.messenger.call(\n            'NetworkController:getState',\n          ),\n          networkEnablementControllerState: this.messenger.call(\n            'NetworkEnablementController:getState',\n          ),\n          connectivityControllerState,\n        }),\n      selectConnectivityControllerFields,\n    );\n    /* eslint-enable no-restricted-syntax */\n\n    // Lifecycle: evaluate RPC health (and run the banner escalation timers)\n    // only while the client UI is open on an unlocked wallet.\n    this.messenger.subscribe(\n      'ClientController:stateChanged',\n      (isUiOpen) => {\n        this.#isUiOpen = isUiOpen;\n        this.#updateLifecycle();\n      },\n      clientControllerSelectors.selectIsUiOpen,\n    );\n    this.messenger.subscribe('KeyringController:unlock', () => {\n      this.#isUnlocked = true;\n      this.#updateLifecycle();\n    });\n    this.messenger.subscribe('KeyringController:lock', () => {\n      this.#isUnlocked = false;\n      this.#updateLifecycle();\n    });\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  #updateLifecycle(): void {\n    if (this.#isUiOpen && this.#isUnlocked) {\n      this.#start();\n    } else {\n      this.#stop();\n    }\n  }\n\n  /**\n   * Look for a failed network, if any, and populate the initial state of the\n   * banner. Reacts to upstream state changes from this point on. Idempotent.\n   */\n  #start(): void {\n    if (this.#isStarted) {\n      return;\n    }\n\n    this.#isStarted = true;\n    this.#refreshState({\n      networkControllerState: this.messenger.call('NetworkController:getState'),\n      networkEnablementControllerState: this.messenger.call(\n        'NetworkEnablementController:getState',\n      ),\n      connectivityControllerState: this.messenger.call(\n        'ConnectivityController:getState',\n      ),\n    });\n  }\n\n  /**\n   * Stops evaluating network connection state. Clears any pending banner\n   * timers and resets state to `available`. Idempotent.\n   */\n  #stop(): void {\n    if (!this.#isStarted) {\n      return;\n    }\n\n    this.#isStarted = false;\n    this.#resetBanner();\n  }\n\n  /**\n   * Clears the banner state such that the banner will be hidden.\n   */\n  dismissBanner(): void {\n    this.#resetBanner();\n  }\n\n  /**\n   * Switches the chain's default RPC endpoint to its Infura endpoint and\n   * makes it the active network, causing the banner to clear once the\n   * network becomes available again.\n   *\n   * @param chainId - The chain whose default RPC endpoint should be switched.\n   * @throws If the chain configuration cannot be found, or if it has no\n   * Infura endpoint to switch to, or if the default is already Infura.\n   */\n  async switchToDefaultInfuraRpcEndpoint(chainId: Hex): Promise<void> {\n    const networkConfiguration = this.messenger.call(\n      'NetworkController:getNetworkConfigurationByChainId',\n      chainId,\n    );\n    if (!networkConfiguration) {\n      throw new Error(\n        `No network configuration found for chain ID \"${chainId}\".`,\n      );\n    }\n\n    const infuraEndpointIndex = networkConfiguration.rpcEndpoints.findIndex(\n      (endpoint) => getIsInfuraEndpoint(endpoint.url),\n    );\n    if (infuraEndpointIndex === -1) {\n      throw new Error(\n        `No Infura endpoint available for chain ID \"${chainId}\".`,\n      );\n    }\n    if (infuraEndpointIndex === networkConfiguration.defaultRpcEndpointIndex) {\n      // The default is already Infura; nothing to do.\n      return;\n    }\n\n    await this.messenger.call('NetworkController:updateNetwork', chainId, {\n      ...networkConfiguration,\n      defaultRpcEndpointIndex: infuraEndpointIndex,\n    });\n\n    // Move the active connection onto the Infura endpoint too, so the user\n    // is no longer connected to the failing endpoint.\n    const infuraNetworkClientId =\n      networkConfiguration.rpcEndpoints[infuraEndpointIndex].networkClientId;\n    const { selectedNetworkClientId } = this.messenger.call(\n      'NetworkController:getState',\n    );\n    if (infuraNetworkClientId !== selectedNetworkClientId) {\n      await this.messenger.call(\n        'NetworkController:setActiveNetwork',\n        infuraNetworkClientId,\n      );\n    }\n  }\n\n  #refreshState({\n    networkControllerState,\n    networkEnablementControllerState,\n    connectivityControllerState,\n  }: {\n    networkControllerState: Pick<\n      NetworkState,\n      'networkConfigurationsByChainId' | 'networksMetadata'\n    >;\n    networkEnablementControllerState: Pick<\n      NetworkEnablementControllerState,\n      'enabledNetworkMap'\n    >;\n    connectivityControllerState: Pick<\n      ConnectivityControllerState,\n      'connectivityStatus'\n    >;\n  }): void {\n    if (!this.#isStarted) {\n      return;\n    }\n\n    if (\n      connectivityControllerState.connectivityStatus ===\n      CONNECTIVITY_STATUSES.Offline\n    ) {\n      this.#resetBanner();\n      return;\n    }\n\n    const failedNetwork = this.#findFailedNetwork(\n      networkControllerState,\n      networkEnablementControllerState,\n    );\n    if (!failedNetwork) {\n      this.#resetBanner();\n      return;\n    }\n\n    if (\n      this.state.networkConnectionBannerStatus !== 'available' &&\n      this.state.networkConnectionBannerNetwork?.networkClientId ===\n        failedNetwork.networkClientId\n    ) {\n      this.update((state) => {\n        // Even if the network client ID has not changed, save the current\n        // version of the failed network to state in case the user has updated\n        // its RPC URL.\n        state.networkConnectionBannerNetwork = failedNetwork;\n      });\n      return;\n    }\n\n    // A degraded timer is already counting down for this same network.\n    // Repeated `stateChange` events must not clear and restart it, or a\n    // steady stream of updates could postpone the banner indefinitely.\n    if (this.#pendingNetworkClientId === failedNetwork.networkClientId) {\n      return;\n    }\n\n    this.#clearTimers();\n    this.update((state) => {\n      state.networkConnectionBannerStatus = 'available';\n      state.networkConnectionBannerNetwork = null;\n    });\n\n    // If `stop` is called before scheduling timers, bail early.\n    if (!this.#isStarted) {\n      return;\n    }\n\n    // Remember which network the pending timer is for (see the guard above)\n    // and capture the failing network at schedule time. If the failure\n    // resolves or a different network becomes the banner target while we\n    // wait, the subscription handlers re-enter this method and cancel or\n    // replace the timer before it fires.\n    this.#pendingNetworkClientId = failedNetwork.networkClientId;\n    this.#degradedTimer = setTimeout(() => {\n      this.#degradedTimer = undefined;\n      this.#pendingNetworkClientId = undefined;\n      this.update((state) => {\n        state.networkConnectionBannerStatus = 'degraded';\n        state.networkConnectionBannerNetwork = failedNetwork;\n      });\n      // If `stop` is called before scheduling timers, bail early.\n      if (!this.#isStarted) {\n        return;\n      }\n      this.#unavailableTimer = setTimeout(() => {\n        this.#unavailableTimer = undefined;\n        this.update((state) => {\n          state.networkConnectionBannerStatus = 'unavailable';\n          state.networkConnectionBannerNetwork = failedNetwork;\n        });\n      }, UNAVAILABLE_BANNER_TIMEOUT - DEGRADED_BANNER_TIMEOUT);\n    }, DEGRADED_BANNER_TIMEOUT);\n  }\n\n  /**\n   * Clears timers and resets banner state to {@link NetworkConnectionBannerStatus|`available`}\n   * if it isn't there already.\n   */\n  #resetBanner(): void {\n    this.#clearTimers();\n    this.#pendingNetworkClientId = undefined;\n    if (\n      this.state.networkConnectionBannerStatus !== 'available' ||\n      this.state.networkConnectionBannerNetwork !== null\n    ) {\n      this.update((state) => {\n        state.networkConnectionBannerStatus = 'available';\n        state.networkConnectionBannerNetwork = null;\n      });\n    }\n  }\n\n  #clearTimers(): void {\n    if (this.#degradedTimer !== undefined) {\n      clearTimeout(this.#degradedTimer);\n      this.#degradedTimer = undefined;\n    }\n    if (this.#unavailableTimer !== undefined) {\n      clearTimeout(this.#unavailableTimer);\n      this.#unavailableTimer = undefined;\n    }\n  }\n\n  #findFailedNetwork(\n    networkState: Pick<\n      NetworkState,\n      'networkConfigurationsByChainId' | 'networksMetadata'\n    >,\n    enablementState: Pick<\n      NetworkEnablementControllerState,\n      'enabledNetworkMap'\n    >,\n  ): FailedNetwork | null {\n    const enabledNetworks = this.#collectEnabledNetworks(\n      networkState,\n      enablementState,\n    );\n    // Networks whose connectivity has not been looked up yet are not failed.\n    const failedNetworks = enabledNetworks\n      .filter(\n        ({ metadata }) =>\n          metadata !== undefined && metadata.status !== NetworkStatus.Available,\n      )\n      .map((network) => this.#buildFailedNetwork(network));\n    return this.#pickFailedNetworkToDisplay(\n      failedNetworks,\n      enabledNetworks.length,\n    );\n  }\n\n  #getEnabledEvmChainIds(\n    enabledNetworkMap: NetworkEnablementControllerState['enabledNetworkMap'],\n  ): Hex[] {\n    return Object.entries(enabledNetworkMap[KnownCaipNamespace.Eip155] ?? {})\n      .filter(([, enabled]) => enabled)\n      .map(([chainId]) => chainId as Hex);\n  }\n\n  #collectEnabledNetworks(\n    {\n      networkConfigurationsByChainId,\n      networksMetadata,\n    }: Pick<\n      NetworkState,\n      'networkConfigurationsByChainId' | 'networksMetadata'\n    >,\n    {\n      enabledNetworkMap,\n    }: Pick<NetworkEnablementControllerState, 'enabledNetworkMap'>,\n  ): EnabledNetwork[] {\n    return this.#getEnabledEvmChainIds(enabledNetworkMap).flatMap((chainId) => {\n      const networkConfiguration = networkConfigurationsByChainId[chainId];\n      if (!networkConfiguration) {\n        return [];\n      }\n      const { rpcEndpoints, defaultRpcEndpointIndex, name } =\n        networkConfiguration;\n      const defaultRpcEndpoint = rpcEndpoints[defaultRpcEndpointIndex];\n      if (!defaultRpcEndpoint) {\n        return [];\n      }\n      return [\n        {\n          chainId,\n          name,\n          rpcEndpoints,\n          defaultRpcEndpointIndex,\n          defaultRpcEndpoint,\n          metadata: networksMetadata[defaultRpcEndpoint.networkClientId],\n        },\n      ];\n    });\n  }\n\n  #buildFailedNetwork({\n    chainId,\n    name,\n    rpcEndpoints,\n    defaultRpcEndpointIndex,\n    defaultRpcEndpoint,\n  }: EnabledNetwork): FailedNetwork {\n    const isInfuraEndpoint = getIsInfuraEndpoint(defaultRpcEndpoint.url);\n\n    // For custom endpoints (non-Infura), find an Infura endpoint on this\n    // chain that we could offer to switch to.\n    let switchableInfuraNetworkClientId: string | null = null;\n    if (!isInfuraEndpoint) {\n      const infuraEndpoint = rpcEndpoints.find(\n        (endpoint, index) =>\n          index !== defaultRpcEndpointIndex &&\n          getIsInfuraEndpoint(endpoint.url),\n      );\n      switchableInfuraNetworkClientId = infuraEndpoint?.networkClientId ?? null;\n    }\n\n    return {\n      chainId,\n      networkClientId: defaultRpcEndpoint.networkClientId,\n      name,\n      rpcUrl: defaultRpcEndpoint.url,\n      isInfuraEndpoint,\n      switchableInfuraNetworkClientId,\n    };\n  }\n\n  #pickFailedNetworkToDisplay(\n    failedNetworks: FailedNetwork[],\n    totalEnabledNetworks: number,\n  ): FailedNetwork | null {\n    if (failedNetworks.length === 0) {\n      return null;\n    }\n\n    const firstCustomFailed = failedNetworks.find(\n      (entry) => !entry.isInfuraEndpoint,\n    );\n    const areAllEnabledNetworksFailed =\n      failedNetworks.length === totalEnabledNetworks;\n\n    if (!firstCustomFailed && !areAllEnabledNetworksFailed) {\n      return null;\n    }\n\n    return firstCustomFailed ?? failedNetworks[0];\n  }\n}\n"]}
+{"version":3,"file":"NetworkConnectionBannerController.cjs","sourceRoot":"","sources":["../src/NetworkConnectionBannerController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangedEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport { clientControllerSelectors } from '@metamask/client-controller';\nimport type { ClientControllerState } from '@metamask/client-controller';\nimport {\n  CONNECTIVITY_STATUSES,\n  connectivityControllerSelectors,\n} from '@metamask/connectivity-controller';\nimport type {\n  ConnectivityControllerGetStateAction,\n  ConnectivityControllerState,\n  ConnectivityControllerStateChangeEvent,\n} from '@metamask/connectivity-controller';\nimport type {\n  KeyringControllerLockEvent,\n  KeyringControllerUnlockEvent,\n} from '@metamask/keyring-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type {\n  NetworkConfiguration,\n  NetworkControllerGetNetworkConfigurationByChainIdAction,\n  NetworkControllerGetStateAction,\n  NetworkControllerUpdateNetworkAction,\n  NetworkControllerSetActiveNetworkAction,\n  NetworkControllerStateChangeEvent,\n  NetworkMetadata,\n  NetworkState,\n} from '@metamask/network-controller';\nimport { NetworkStatus } from '@metamask/network-controller';\nimport type {\n  NetworkEnablementControllerGetStateAction,\n  NetworkEnablementControllerState,\n  NetworkEnablementControllerStateChangeEvent,\n} from '@metamask/network-enablement-controller';\nimport { selectEnabledNetworkMap } from '@metamask/network-enablement-controller';\nimport type { Hex } from '@metamask/utils';\nimport { KnownCaipNamespace } from '@metamask/utils';\nimport { createSelector } from 'reselect';\n\nimport type { NetworkConnectionBannerControllerMethodActions } from './NetworkConnectionBannerController-method-action-types';\nimport { getIsInfuraEndpoint } from './url-utils';\n\n/**\n * The name of the {@link NetworkConnectionBannerController}, used to namespace\n * the controller's actions and events and to namespace the controller's state\n * data when composed with other controllers.\n */\nconst CONTROLLER_NAME = 'NetworkConnectionBannerController';\n\n/**\n * Selects `networksMetadata` from the `NetworkController` state.\n *\n * @param state - The `NetworkController` state.\n * @returns The networks metadata map keyed by network client id.\n */\nconst selectNetworksMetadata = (\n  state: NetworkState,\n): NetworkState['networksMetadata'] => state.networksMetadata;\n\n/**\n * Selects `networkConfigurationsByChainId` from the `NetworkController`\n * state.\n *\n * @param state - The `NetworkController` state.\n * @returns The network configurations keyed by chain id.\n */\nconst selectNetworkConfigurationsByChainId = (\n  state: NetworkState,\n): NetworkState['networkConfigurationsByChainId'] =>\n  state.networkConfigurationsByChainId;\n\n/**\n * Selects the `NetworkController` state fields that influence the banner\n * rule. Composed with `createSelector` so the return object stays reference\n * stable while unrelated `NetworkController` state (e.g.\n * `selectedNetworkClientId`) changes.\n *\n * @param state - The `NetworkController` state.\n * @returns The relevant network fields.\n */\nconst selectNetworkControllerFields = createSelector(\n  [selectNetworksMetadata, selectNetworkConfigurationsByChainId],\n  (networksMetadata, networkConfigurationsByChainId) => ({\n    networksMetadata,\n    networkConfigurationsByChainId,\n  }),\n);\n\n/**\n * Selects the `NetworkEnablementController` state field that influences the\n * banner rule.\n *\n * @param state - The `NetworkEnablementController` state.\n * @returns The relevant enablement fields.\n */\nconst selectNetworkEnablementControllerFields = createSelector(\n  [selectEnabledNetworkMap],\n  (enabledNetworkMap) => ({ enabledNetworkMap }),\n);\n\n/**\n * Selects the `ConnectivityController` state field that influences the\n * banner rule.\n *\n * @param state - The `ConnectivityController` state.\n * @returns The relevant connectivity fields.\n */\nconst selectConnectivityControllerFields = createSelector(\n  [connectivityControllerSelectors.selectConnectivityStatus],\n  (connectivityStatus) => ({ connectivityStatus }),\n);\n\n/**\n * Status the banner can be in. `available` means no banner is shown; the\n * `degraded` and `unavailable` values mirror the two-tier escalation that the\n * UI renders.\n */\nexport type NetworkConnectionBannerStatus =\n  | 'available'\n  | 'degraded'\n  | 'unavailable';\n\n/**\n * An enabled network from `NetworkController` state with a default RPC\n * endpoint. Used as the input to the failed-network detection pipeline.\n * `metadata` is missing until the network's connectivity has been looked up.\n */\ntype EnabledNetwork = {\n  chainId: Hex;\n  name: string;\n  rpcEndpoints: NetworkConfiguration['rpcEndpoints'];\n  defaultRpcEndpointIndex: number;\n  defaultRpcEndpoint: NetworkConfiguration['rpcEndpoints'][number];\n  metadata: NetworkMetadata | undefined;\n};\n\n/**\n * Details of a failing network the banner describes.\n */\nexport type FailedNetwork = {\n  /** The chain id of the failing network. */\n  chainId: Hex;\n  /** The `networkClientId` of the failing default RPC endpoint. */\n  networkClientId: string;\n  /** The display name for the failing network. */\n  name: string;\n  /** The URL of the failing default RPC endpoint. */\n  rpcUrl: string;\n  /** Whether the failing endpoint is a MetaMask Infura endpoint. */\n  isInfuraEndpoint: boolean;\n  /**\n   * The networkClientId of an Infura endpoint on the same chain that the user\n   * can switch to. `null` when the failing endpoint is already Infura or when\n   * no Infura alternative exists.\n   */\n  switchableInfuraNetworkClientId: string | null;\n};\n\n/**\n * State for the {@link NetworkConnectionBannerController}.\n *\n * The keys carry the controller-domain prefix (like\n * `ConnectivityController`'s `connectivityStatus`) because some clients merge\n * all controller states into one flat object, where generic names like\n * `status` collide across controllers.\n */\nexport type NetworkConnectionBannerControllerState = {\n  networkConnectionBannerStatus: NetworkConnectionBannerStatus;\n  networkConnectionBannerNetwork: FailedNetwork | null;\n};\n\nconst networkConnectionBannerControllerMetadata = {\n  networkConnectionBannerStatus: {\n    persist: false,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  networkConnectionBannerNetwork: {\n    persist: false,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n} satisfies StateMetadata<NetworkConnectionBannerControllerState>;\n\n/**\n * Constructs the default {@link NetworkConnectionBannerController} state.\n *\n * @returns The default state.\n */\nexport function getDefaultNetworkConnectionBannerControllerState(): NetworkConnectionBannerControllerState {\n  return {\n    networkConnectionBannerStatus: 'available',\n    networkConnectionBannerNetwork: null,\n  };\n}\n\n/**\n * The default for how long (in milliseconds) a failing network must remain\n * in a \"failed\" status (\"degraded\" or \"unavailable\") before the degraded\n * banner appears.\n */\nexport const DEFAULT_DEGRADED_BANNER_TIMEOUT = 5_000;\n\n/**\n * The default for how long (in milliseconds) a failing network must remain\n * in a \"failed\" status before the banner escalates to \"unavailable\".\n */\nexport const DEFAULT_UNAVAILABLE_BANNER_TIMEOUT = 30_000;\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'dismissBanner',\n  'switchToDefaultInfuraRpcEndpoint',\n] as const;\n\n/**\n * Retrieves the state of the {@link NetworkConnectionBannerController}.\n */\nexport type NetworkConnectionBannerControllerGetStateAction =\n  ControllerGetStateAction<\n    typeof CONTROLLER_NAME,\n    NetworkConnectionBannerControllerState\n  >;\n\n/**\n * Actions that {@link NetworkConnectionBannerControllerMessenger} exposes to\n * other consumers.\n */\nexport type NetworkConnectionBannerControllerActions =\n  | NetworkConnectionBannerControllerGetStateAction\n  | NetworkConnectionBannerControllerMethodActions;\n\n/**\n * Actions from other messengers that\n * {@link NetworkConnectionBannerControllerMessenger} calls.\n */\ntype AllowedActions =\n  | NetworkControllerGetStateAction\n  | NetworkControllerGetNetworkConfigurationByChainIdAction\n  | NetworkControllerUpdateNetworkAction\n  | NetworkControllerSetActiveNetworkAction\n  | NetworkEnablementControllerGetStateAction\n  | ConnectivityControllerGetStateAction;\n\n/**\n * Published when the state of {@link NetworkConnectionBannerController}\n * changes.\n */\nexport type NetworkConnectionBannerControllerStateChangedEvent =\n  ControllerStateChangedEvent<\n    typeof CONTROLLER_NAME,\n    NetworkConnectionBannerControllerState\n  >;\n\n/**\n * Events that {@link NetworkConnectionBannerControllerMessenger} exposes to\n * other consumers.\n */\nexport type NetworkConnectionBannerControllerEvents =\n  NetworkConnectionBannerControllerStateChangedEvent;\n\n/**\n * Published when the state of `ClientController` changes. Defined here\n * because the `client-controller` package still exports the legacy\n * `:stateChange` event type.\n */\ntype ClientControllerStateChangedEvent = ControllerStateChangedEvent<\n  'ClientController',\n  ClientControllerState\n>;\n\n/**\n * Events from other messengers that\n * {@link NetworkConnectionBannerControllerMessenger} subscribes to.\n */\ntype AllowedEvents =\n  | NetworkControllerStateChangeEvent\n  | NetworkEnablementControllerStateChangeEvent\n  | ConnectivityControllerStateChangeEvent\n  | ClientControllerStateChangedEvent\n  | KeyringControllerUnlockEvent\n  | KeyringControllerLockEvent;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link NetworkConnectionBannerController}.\n */\nexport type NetworkConnectionBannerControllerMessenger = Messenger<\n  typeof CONTROLLER_NAME,\n  NetworkConnectionBannerControllerActions | AllowedActions,\n  NetworkConnectionBannerControllerEvents | AllowedEvents\n>;\n\n/**\n * Options for constructing the {@link NetworkConnectionBannerController}.\n */\nexport type NetworkConnectionBannerControllerOptions = {\n  /**\n   * The messenger for inter-controller communication.\n   */\n  messenger: NetworkConnectionBannerControllerMessenger;\n\n  /**\n   * The wallet's Infura project id, used to recognize MetaMask Infura\n   * endpoints whose URL was persisted with the id already substituted.\n   */\n  infuraProjectId: string;\n\n  /**\n   * How long (in milliseconds) a failing network must remain in a \"failed\"\n   * status before the degraded banner appears. Defaults to\n   * {@link DEFAULT_DEGRADED_BANNER_TIMEOUT}.\n   */\n  degradedBannerTimeout?: number;\n\n  /**\n   * How long (in milliseconds), measured from the same failure start as\n   * `degradedBannerTimeout`, before the banner escalates to \"unavailable\".\n   * Must be greater than `degradedBannerTimeout`. Defaults to\n   * {@link DEFAULT_UNAVAILABLE_BANNER_TIMEOUT}.\n   */\n  unavailableBannerTimeout?: number;\n};\n\n/**\n * Drives the \"network connection banner\", a notice that appears within clients\n * whose goal is to inform users about networks which have exhibited repeated\n * request failures and offer potential workarounds.\n *\n * Some terminology: A \"network\" in this case is an RPC endpoint, and a network\n * that has exhibited repeated request failures has entered a \"failed\" state (or\n * is a \"failed network\").\n *\n * For simplicity, the banner always represents a single failed network. If\n * multiple networks are failing, the first custom network takes priority over\n * the first Infura network.\n *\n * To ensure that the banner is actionable, the banner does not always appear\n * even if there is a failed network to display. Instead it appears under these\n * conditions:\n *\n * - The failed network is a custom (non-Infura) endpoint (we want to inform\n *   users about endpoints they've added so they don't cast blame on MetaMask).\n * - Every enabled EVM network has entered a failed state (this indicates a\n *   broad connectivity issue).\n *\n * Assuming that these conditions have been met, there are two variants of the\n * banner which will be displayed at different times.\n *\n * - A \"degraded\" variant which will appear when 5 seconds has elapsed and there\n *   is an eligible failed network to display\n * - An \"unavailable\" variant which will appear when 30 seconds have elapsed and\n *   there is an eligible failed network to display\n *\n * Finally, the controller contains actions that drive interactions with the\n * banner. Namely, if the banner represents a custom network, then it will offer\n * the user a way to switch to the default Infura network. The controller\n * contains the logic to carry out that action.\n */\nexport class NetworkConnectionBannerController extends BaseController<\n  typeof CONTROLLER_NAME,\n  NetworkConnectionBannerControllerState,\n  NetworkConnectionBannerControllerMessenger\n> {\n  #degradedTimer: ReturnType<typeof setTimeout> | undefined;\n\n  #unavailableTimer: ReturnType<typeof setTimeout> | undefined;\n\n  #pendingNetworkClientId: string | undefined;\n\n  #isStarted = false;\n\n  /** Whether the client UI is open. Combined with {@link #isUnlocked}. */\n  #isUiOpen = false;\n\n  /** Whether the keyring is unlocked. Combined with {@link #isUiOpen}. */\n  #isUnlocked = false;\n\n  readonly #infuraProjectId: string;\n\n  readonly #degradedBannerTimeout: number;\n\n  readonly #unavailableBannerTimeout: number;\n\n  /**\n   * Constructs a new {@link NetworkConnectionBannerController}.\n   *\n   * @param args - The arguments to this controller.\n   * @param args.messenger - The messenger suited for this controller.\n   * @param args.infuraProjectId - The wallet's Infura project id.\n   * @param args.degradedBannerTimeout - How long (in milliseconds) a failing\n   * network must remain failed before the degraded banner appears.\n   * @param args.unavailableBannerTimeout - How long (in milliseconds) before\n   * the banner escalates to \"unavailable\". Must be greater than\n   * `degradedBannerTimeout`.\n   * @throws If `unavailableBannerTimeout` is not greater than\n   * `degradedBannerTimeout`.\n   */\n  constructor({\n    messenger,\n    infuraProjectId,\n    degradedBannerTimeout = DEFAULT_DEGRADED_BANNER_TIMEOUT,\n    unavailableBannerTimeout = DEFAULT_UNAVAILABLE_BANNER_TIMEOUT,\n  }: NetworkConnectionBannerControllerOptions) {\n    super({\n      messenger,\n      metadata: networkConnectionBannerControllerMetadata,\n      name: CONTROLLER_NAME,\n      state: getDefaultNetworkConnectionBannerControllerState(),\n    });\n\n    if (unavailableBannerTimeout <= degradedBannerTimeout) {\n      throw new Error(\n        `\\`unavailableBannerTimeout\\` (${unavailableBannerTimeout}) must be greater than \\`degradedBannerTimeout\\` (${degradedBannerTimeout}).`,\n      );\n    }\n\n    this.#infuraProjectId = infuraProjectId;\n    this.#degradedBannerTimeout = degradedBannerTimeout;\n    this.#unavailableBannerTimeout = unavailableBannerTimeout;\n\n    // Upstream controllers still expose :stateChange; switch to :stateChanged\n    // once those packages migrate their event types.\n    /* eslint-disable no-restricted-syntax -- awaiting upstream :stateChanged migration */\n    this.messenger.subscribe(\n      'NetworkController:stateChange',\n      (networkControllerState) =>\n        this.#refreshState({\n          networkControllerState,\n          networkEnablementControllerState: this.messenger.call(\n            'NetworkEnablementController:getState',\n          ),\n          connectivityControllerState: this.messenger.call(\n            'ConnectivityController:getState',\n          ),\n        }),\n      selectNetworkControllerFields,\n    );\n    this.messenger.subscribe(\n      'NetworkEnablementController:stateChange',\n      (networkEnablementControllerState) =>\n        this.#refreshState({\n          networkControllerState: this.messenger.call(\n            'NetworkController:getState',\n          ),\n          networkEnablementControllerState,\n          connectivityControllerState: this.messenger.call(\n            'ConnectivityController:getState',\n          ),\n        }),\n      selectNetworkEnablementControllerFields,\n    );\n    this.messenger.subscribe(\n      'ConnectivityController:stateChange',\n      (connectivityControllerState) =>\n        this.#refreshState({\n          networkControllerState: this.messenger.call(\n            'NetworkController:getState',\n          ),\n          networkEnablementControllerState: this.messenger.call(\n            'NetworkEnablementController:getState',\n          ),\n          connectivityControllerState,\n        }),\n      selectConnectivityControllerFields,\n    );\n    /* eslint-enable no-restricted-syntax */\n\n    // Lifecycle: evaluate RPC health (and run the banner escalation timers)\n    // only while the client UI is open on an unlocked wallet.\n    this.messenger.subscribe(\n      'ClientController:stateChanged',\n      (isUiOpen) => {\n        this.#isUiOpen = isUiOpen;\n        this.#updateLifecycle();\n      },\n      clientControllerSelectors.selectIsUiOpen,\n    );\n    this.messenger.subscribe('KeyringController:unlock', () => {\n      this.#isUnlocked = true;\n      this.#updateLifecycle();\n    });\n    this.messenger.subscribe('KeyringController:lock', () => {\n      this.#isUnlocked = false;\n      this.#updateLifecycle();\n    });\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  #updateLifecycle(): void {\n    if (this.#isUiOpen && this.#isUnlocked) {\n      this.#start();\n    } else {\n      this.#stop();\n    }\n  }\n\n  /**\n   * Look for a failed network, if any, and populate the initial state of the\n   * banner. Reacts to upstream state changes from this point on. Idempotent.\n   */\n  #start(): void {\n    if (this.#isStarted) {\n      return;\n    }\n\n    this.#isStarted = true;\n    this.#refreshState({\n      networkControllerState: this.messenger.call('NetworkController:getState'),\n      networkEnablementControllerState: this.messenger.call(\n        'NetworkEnablementController:getState',\n      ),\n      connectivityControllerState: this.messenger.call(\n        'ConnectivityController:getState',\n      ),\n    });\n  }\n\n  /**\n   * Stops evaluating network connection state. Clears any pending banner\n   * timers and resets state to `available`. Idempotent.\n   */\n  #stop(): void {\n    if (!this.#isStarted) {\n      return;\n    }\n\n    this.#isStarted = false;\n    this.#resetBanner();\n  }\n\n  /**\n   * Clears the banner state such that the banner will be hidden.\n   */\n  dismissBanner(): void {\n    this.#resetBanner();\n  }\n\n  /**\n   * Switches the chain's default RPC endpoint to its Infura endpoint and\n   * makes it the active network, causing the banner to clear once the\n   * network becomes available again.\n   *\n   * @param chainId - The chain whose default RPC endpoint should be switched.\n   * @throws If the chain configuration cannot be found, or if it has no\n   * Infura endpoint to switch to, or if the default is already Infura.\n   */\n  async switchToDefaultInfuraRpcEndpoint(chainId: Hex): Promise<void> {\n    const networkConfiguration = this.messenger.call(\n      'NetworkController:getNetworkConfigurationByChainId',\n      chainId,\n    );\n    if (!networkConfiguration) {\n      throw new Error(\n        `No network configuration found for chain ID \"${chainId}\".`,\n      );\n    }\n\n    const infuraEndpointIndex = networkConfiguration.rpcEndpoints.findIndex(\n      (endpoint) => getIsInfuraEndpoint(endpoint.url, this.#infuraProjectId),\n    );\n    if (infuraEndpointIndex === -1) {\n      throw new Error(\n        `No Infura endpoint available for chain ID \"${chainId}\".`,\n      );\n    }\n    if (infuraEndpointIndex === networkConfiguration.defaultRpcEndpointIndex) {\n      // The default is already Infura; nothing to do.\n      return;\n    }\n\n    // Move the active connection onto the Infura endpoint first, then make\n    // it the default. In this order a partial failure leaves the failing\n    // default in place and the banner visible, rather than hiding the banner\n    // while the wallet is still connected to the broken endpoint.\n    const infuraNetworkClientId =\n      networkConfiguration.rpcEndpoints[infuraEndpointIndex].networkClientId;\n    const { selectedNetworkClientId } = this.messenger.call(\n      'NetworkController:getState',\n    );\n    if (infuraNetworkClientId !== selectedNetworkClientId) {\n      await this.messenger.call(\n        'NetworkController:setActiveNetwork',\n        infuraNetworkClientId,\n      );\n    }\n\n    await this.messenger.call('NetworkController:updateNetwork', chainId, {\n      ...networkConfiguration,\n      defaultRpcEndpointIndex: infuraEndpointIndex,\n    });\n  }\n\n  #refreshState({\n    networkControllerState,\n    networkEnablementControllerState,\n    connectivityControllerState,\n  }: {\n    networkControllerState: Pick<\n      NetworkState,\n      'networkConfigurationsByChainId' | 'networksMetadata'\n    >;\n    networkEnablementControllerState: Pick<\n      NetworkEnablementControllerState,\n      'enabledNetworkMap'\n    >;\n    connectivityControllerState: Pick<\n      ConnectivityControllerState,\n      'connectivityStatus'\n    >;\n  }): void {\n    if (!this.#isStarted) {\n      return;\n    }\n\n    if (\n      connectivityControllerState.connectivityStatus ===\n      CONNECTIVITY_STATUSES.Offline\n    ) {\n      this.#resetBanner();\n      return;\n    }\n\n    const failedNetwork = this.#findFailedNetwork(\n      networkControllerState,\n      networkEnablementControllerState,\n    );\n    if (!failedNetwork) {\n      this.#resetBanner();\n      return;\n    }\n\n    if (\n      this.state.networkConnectionBannerStatus !== 'available' &&\n      this.state.networkConnectionBannerNetwork?.networkClientId ===\n        failedNetwork.networkClientId\n    ) {\n      this.update((state) => {\n        // Even if the network client ID has not changed, save the current\n        // version of the failed network to state in case the user has updated\n        // its RPC URL.\n        state.networkConnectionBannerNetwork = failedNetwork;\n      });\n      return;\n    }\n\n    // A degraded timer is already counting down for this same network.\n    // Repeated `stateChange` events must not clear and restart it, or a\n    // steady stream of updates could postpone the banner indefinitely.\n    if (this.#pendingNetworkClientId === failedNetwork.networkClientId) {\n      return;\n    }\n\n    this.#clearTimers();\n    this.update((state) => {\n      state.networkConnectionBannerStatus = 'available';\n      state.networkConnectionBannerNetwork = null;\n    });\n\n    // If `stop` is called before scheduling timers, bail early.\n    if (!this.#isStarted) {\n      return;\n    }\n\n    // Remember which network the pending timer is for (see the guard above)\n    // and capture the failing network at schedule time. If the failure\n    // resolves or a different network becomes the banner target while we\n    // wait, the subscription handlers re-enter this method and cancel or\n    // replace the timer before it fires.\n    this.#pendingNetworkClientId = failedNetwork.networkClientId;\n    this.#degradedTimer = setTimeout(() => {\n      this.#degradedTimer = undefined;\n      this.#pendingNetworkClientId = undefined;\n      this.update((state) => {\n        state.networkConnectionBannerStatus = 'degraded';\n        state.networkConnectionBannerNetwork = failedNetwork;\n      });\n      // If `stop` is called before scheduling timers, bail early.\n      if (!this.#isStarted) {\n        return;\n      }\n      this.#unavailableTimer = setTimeout(() => {\n        this.#unavailableTimer = undefined;\n        this.update((state) => {\n          state.networkConnectionBannerStatus = 'unavailable';\n          state.networkConnectionBannerNetwork = failedNetwork;\n        });\n      }, this.#unavailableBannerTimeout - this.#degradedBannerTimeout);\n    }, this.#degradedBannerTimeout);\n  }\n\n  /**\n   * Clears timers and resets banner state to {@link NetworkConnectionBannerStatus|`available`}\n   * if it isn't there already.\n   */\n  #resetBanner(): void {\n    this.#clearTimers();\n    this.#pendingNetworkClientId = undefined;\n    if (\n      this.state.networkConnectionBannerStatus !== 'available' ||\n      this.state.networkConnectionBannerNetwork !== null\n    ) {\n      this.update((state) => {\n        state.networkConnectionBannerStatus = 'available';\n        state.networkConnectionBannerNetwork = null;\n      });\n    }\n  }\n\n  #clearTimers(): void {\n    if (this.#degradedTimer !== undefined) {\n      clearTimeout(this.#degradedTimer);\n      this.#degradedTimer = undefined;\n    }\n    if (this.#unavailableTimer !== undefined) {\n      clearTimeout(this.#unavailableTimer);\n      this.#unavailableTimer = undefined;\n    }\n  }\n\n  #findFailedNetwork(\n    networkState: Pick<\n      NetworkState,\n      'networkConfigurationsByChainId' | 'networksMetadata'\n    >,\n    enablementState: Pick<\n      NetworkEnablementControllerState,\n      'enabledNetworkMap'\n    >,\n  ): FailedNetwork | null {\n    const enabledNetworks = this.#collectEnabledNetworks(\n      networkState,\n      enablementState,\n    );\n    // Networks whose connectivity has not been looked up yet are not failed.\n    const failedNetworks = enabledNetworks\n      .filter(\n        ({ metadata }) =>\n          metadata !== undefined && metadata.status !== NetworkStatus.Available,\n      )\n      .map((network) => this.#buildFailedNetwork(network));\n    return this.#pickFailedNetworkToDisplay(\n      failedNetworks,\n      enabledNetworks.length,\n    );\n  }\n\n  #getEnabledEvmChainIds(\n    enabledNetworkMap: NetworkEnablementControllerState['enabledNetworkMap'],\n  ): Hex[] {\n    return Object.entries(enabledNetworkMap[KnownCaipNamespace.Eip155] ?? {})\n      .filter(([, enabled]) => enabled)\n      .map(([chainId]) => chainId as Hex);\n  }\n\n  #collectEnabledNetworks(\n    {\n      networkConfigurationsByChainId,\n      networksMetadata,\n    }: Pick<\n      NetworkState,\n      'networkConfigurationsByChainId' | 'networksMetadata'\n    >,\n    {\n      enabledNetworkMap,\n    }: Pick<NetworkEnablementControllerState, 'enabledNetworkMap'>,\n  ): EnabledNetwork[] {\n    return this.#getEnabledEvmChainIds(enabledNetworkMap).flatMap((chainId) => {\n      const networkConfiguration = networkConfigurationsByChainId[chainId];\n      if (!networkConfiguration) {\n        return [];\n      }\n      const { rpcEndpoints, defaultRpcEndpointIndex, name } =\n        networkConfiguration;\n      const defaultRpcEndpoint = rpcEndpoints[defaultRpcEndpointIndex];\n      if (!defaultRpcEndpoint) {\n        return [];\n      }\n      return [\n        {\n          chainId,\n          name,\n          rpcEndpoints,\n          defaultRpcEndpointIndex,\n          defaultRpcEndpoint,\n          metadata: networksMetadata[defaultRpcEndpoint.networkClientId],\n        },\n      ];\n    });\n  }\n\n  #buildFailedNetwork({\n    chainId,\n    name,\n    rpcEndpoints,\n    defaultRpcEndpointIndex,\n    defaultRpcEndpoint,\n  }: EnabledNetwork): FailedNetwork {\n    const isInfuraEndpoint = getIsInfuraEndpoint(\n      defaultRpcEndpoint.url,\n      this.#infuraProjectId,\n    );\n\n    // For custom endpoints (non-Infura), find an Infura endpoint on this\n    // chain that we could offer to switch to.\n    let switchableInfuraNetworkClientId: string | null = null;\n    if (!isInfuraEndpoint) {\n      const infuraEndpoint = rpcEndpoints.find(\n        (endpoint, index) =>\n          index !== defaultRpcEndpointIndex &&\n          getIsInfuraEndpoint(endpoint.url, this.#infuraProjectId),\n      );\n      switchableInfuraNetworkClientId = infuraEndpoint?.networkClientId ?? null;\n    }\n\n    return {\n      chainId,\n      networkClientId: defaultRpcEndpoint.networkClientId,\n      name,\n      rpcUrl: defaultRpcEndpoint.url,\n      isInfuraEndpoint,\n      switchableInfuraNetworkClientId,\n    };\n  }\n\n  #pickFailedNetworkToDisplay(\n    failedNetworks: FailedNetwork[],\n    totalEnabledNetworks: number,\n  ): FailedNetwork | null {\n    if (failedNetworks.length === 0) {\n      return null;\n    }\n\n    const firstCustomFailed = failedNetworks.find(\n      (entry) => !entry.isInfuraEndpoint,\n    );\n    const areAllEnabledNetworksFailed =\n      failedNetworks.length === totalEnabledNetworks;\n\n    if (!firstCustomFailed && !areAllEnabledNetworksFailed) {\n      return null;\n    }\n\n    return firstCustomFailed ?? failedNetworks[0];\n  }\n}\n"]}

package/dist/NetworkConnectionBannerController.d.cts

@@ -59,6 +59,17 @@ export type NetworkConnectionBannerControllerState = {
  * @returns The default state.
  */
 export declare function getDefaultNetworkConnectionBannerControllerState(): NetworkConnectionBannerControllerState;
+/**
+ * The default for how long (in milliseconds) a failing network must remain
+ * in a "failed" status ("degraded" or "unavailable") before the degraded
+ * banner appears.
+ */
+export declare const DEFAULT_DEGRADED_BANNER_TIMEOUT = 5000;
+/**
+ * The default for how long (in milliseconds) a failing network must remain
+ * in a "failed" status before the banner escalates to "unavailable".
+ */
+export declare const DEFAULT_UNAVAILABLE_BANNER_TIMEOUT = 30000;
 /**
  * Retrieves the state of the {@link NetworkConnectionBannerController}.
  */
@@ -107,29 +118,59 @@ export type NetworkConnectionBannerControllerOptions = {
      * The messenger for inter-controller communication.
      */
     messenger: NetworkConnectionBannerControllerMessenger;
+    /**
+     * The wallet's Infura project id, used to recognize MetaMask Infura
+     * endpoints whose URL was persisted with the id already substituted.
+     */
+    infuraProjectId: string;
+    /**
+     * How long (in milliseconds) a failing network must remain in a "failed"
+     * status before the degraded banner appears. Defaults to
+     * {@link DEFAULT_DEGRADED_BANNER_TIMEOUT}.
+     */
+    degradedBannerTimeout?: number;
+    /**
+     * How long (in milliseconds), measured from the same failure start as
+     * `degradedBannerTimeout`, before the banner escalates to "unavailable".
+     * Must be greater than `degradedBannerTimeout`. Defaults to
+     * {@link DEFAULT_UNAVAILABLE_BANNER_TIMEOUT}.
+     */
+    unavailableBannerTimeout?: number;
 };
 /**
- * NetworkConnectionBannerController decides whether the network connection
- * banner should be shown for the user, and which failing network it should
- * describe. It encapsulates the rule and the 5s / 30s timer escalation.
+ * Drives the "network connection banner", a notice that appears within clients
+ * whose goal is to inform users about networks which have exhibited repeated
+ * request failures and offer potential workarounds.
+ *
+ * Some terminology: A "network" in this case is an RPC endpoint, and a network
+ * that has exhibited repeated request failures has entered a "failed" state (or
+ * is a "failed network").
+ *
+ * For simplicity, the banner always represents a single failed network. If
+ * multiple networks are failing, the first custom network takes priority over
+ * the first Infura network.
+ *
+ * To ensure that the banner is actionable, the banner does not always appear
+ * even if there is a failed network to display. Instead it appears under these
+ * conditions:
  *
- * The banner shows when:
+ * - The failed network is a custom (non-Infura) endpoint (we want to inform
+ *   users about endpoints they've added so they don't cast blame on MetaMask).
+ * - Every enabled EVM network has entered a failed state (this indicates a
+ *   broad connectivity issue).
  *
- * - A failing network's default RPC is a custom (non-Infura) endpoint —
- *   users always want to be informed about errors with RPCs they've chosen.
- * - Every enabled EVM network is reporting a failed connectivity status
- *   (escape hatch so Infura-only setups still get a signal).
+ * Assuming that these conditions have been met, there are two variants of the
+ * banner which will be displayed at different times.
  *
- * A partial Infura outage alongside healthy peers is suppressed since it
- * usually resolves on its own and the user cannot act on it. When a custom
- * failure is present, it's surfaced first so the "Switch to MetaMask default
- * RPC" CTA targets the network the user can act on.
+ * - A "degraded" variant which will appear when 5 seconds has elapsed and there
+ *   is an eligible failed network to display
+ * - An "unavailable" variant which will appear when 30 seconds have elapsed and
+ *   there is an eligible failed network to display
  *
- * The controller manages its own lifecycle: it evaluates RPC health (and
- * runs the escalation timers) only while the client UI is open
- * (`ClientController`) and the wallet is unlocked (`KeyringController`).
- * Clients only need to render the banner from the controller's state and wire
- * click handlers to {@link dismissBanner} or {@link switchToDefaultInfuraRpcEndpoint}.
+ * Finally, the controller contains actions that drive interactions with the
+ * banner. Namely, if the banner represents a custom network, then it will offer
+ * the user a way to switch to the default Infura network. The controller
+ * contains the logic to carry out that action.
  */
 export declare class NetworkConnectionBannerController extends BaseController<typeof CONTROLLER_NAME, NetworkConnectionBannerControllerState, NetworkConnectionBannerControllerMessenger> {
     #private;
@@ -138,8 +179,16 @@ export declare class NetworkConnectionBannerController extends BaseController<ty
      *
      * @param args - The arguments to this controller.
      * @param args.messenger - The messenger suited for this controller.
+     * @param args.infuraProjectId - The wallet's Infura project id.
+     * @param args.degradedBannerTimeout - How long (in milliseconds) a failing
+     * network must remain failed before the degraded banner appears.
+     * @param args.unavailableBannerTimeout - How long (in milliseconds) before
+     * the banner escalates to "unavailable". Must be greater than
+     * `degradedBannerTimeout`.
+     * @throws If `unavailableBannerTimeout` is not greater than
+     * `degradedBannerTimeout`.
      */
-    constructor({ messenger }: NetworkConnectionBannerControllerOptions);
+    constructor({ messenger, infuraProjectId, degradedBannerTimeout, unavailableBannerTimeout, }: NetworkConnectionBannerControllerOptions);
     /**
      * Clears the banner state such that the banner will be hidden.
      */

package/dist/NetworkConnectionBannerController.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkConnectionBannerController.d.cts","sourceRoot":"","sources":["../src/NetworkConnectionBannerController.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NetworkConnectionBannerController.d.cts","sourceRoot":"","sources":["../src/NetworkConnectionBannerController.ts"],"names":[],"mappings":"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"}