@metamask-previews/config-registry-controller 3.1.0-preview-4f4c98e → 3.1.0-preview-eb263b0ee

package/CHANGELOG.md

@@ -7,11 +7,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Changed
-
-- **BREAKING:** Bump minimum Node.js version to 22 ([#9168](https://github.com/MetaMask/core/pull/9168))
-- Bump `@metamask/remote-feature-flag-controller` from `^6.0.0` to `^6.1.0` ([#9980](https://github.com/MetaMask/core/pull/9980))
-
 ## [3.1.0]
 
 ### Added

package/dist/ConfigRegistryController-method-action-types.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ConfigRegistryController-method-action-types.cjs.map

package/dist/ConfigRegistryController-method-action-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigRegistryController-method-action-types.cjs","sourceRoot":"","sources":["../src/ConfigRegistryController-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ConfigRegistryController } from './ConfigRegistryController.js';\n\n/**\n * Get the network configuration for a given CAIP-2 chain ID.\n *\n * @param caip2ChainId - The CAIP-2 chain ID (e.g., \"eip155:1\").\n * @returns The network configuration if found, otherwise undefined.\n */\nexport type ConfigRegistryControllerGetNetworkConfigByCaip2ChainIdAction = {\n  type: `ConfigRegistryController:getNetworkConfigByCaip2ChainId`;\n  handler: ConfigRegistryController['getNetworkConfigByCaip2ChainId'];\n};\n\n/**\n * Stop all polling.\n */\nexport type ConfigRegistryControllerStopPollingAction = {\n  type: `ConfigRegistryController:stopPolling`;\n  handler: ConfigRegistryController['stopPolling'];\n};\n\nexport type ConfigRegistryControllerStartPollingAction = {\n  type: `ConfigRegistryController:startPolling`;\n  handler: ConfigRegistryController['startPolling'];\n};\n\n/**\n * Union of all ConfigRegistryController action types.\n */\nexport type ConfigRegistryControllerMethodActions =\n  | ConfigRegistryControllerGetNetworkConfigByCaip2ChainIdAction\n  | ConfigRegistryControllerStopPollingAction\n  | ConfigRegistryControllerStartPollingAction;\n"]}

package/dist/{ConfigRegistryController-method-action-types.d.ts → ConfigRegistryController-method-action-types.d.cts}

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { ConfigRegistryController } from './ConfigRegistryController.js';
+import type { ConfigRegistryController } from "./ConfigRegistryController.cjs";
 /**
  * Get the network configuration for a given CAIP-2 chain ID.
  *
@@ -28,4 +28,4 @@ export type ConfigRegistryControllerStartPollingAction = {
  * Union of all ConfigRegistryController action types.
  */
 export type ConfigRegistryControllerMethodActions = ConfigRegistryControllerGetNetworkConfigByCaip2ChainIdAction | ConfigRegistryControllerStopPollingAction | ConfigRegistryControllerStartPollingAction;
-//# sourceMappingURL=ConfigRegistryController-method-action-types.d.ts.map
+//# sourceMappingURL=ConfigRegistryController-method-action-types.d.cts.map

package/dist/ConfigRegistryController-method-action-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigRegistryController-method-action-types.d.cts","sourceRoot":"","sources":["../src/ConfigRegistryController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,uCAAsC;AAE9E;;;;;GAKG;AACH,MAAM,MAAM,4DAA4D,GAAG;IACzE,IAAI,EAAE,yDAAyD,CAAC;IAChE,OAAO,EAAE,wBAAwB,CAAC,gCAAgC,CAAC,CAAC;CACrE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yCAAyC,GAAG;IACtD,IAAI,EAAE,sCAAsC,CAAC;IAC7C,OAAO,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,uCAAuC,CAAC;IAC9C,OAAO,EAAE,wBAAwB,CAAC,cAAc,CAAC,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAC7C,4DAA4D,GAC5D,yCAAyC,GACzC,0CAA0C,CAAC"}

package/dist/ConfigRegistryController-method-action-types.d.mts

@@ -0,0 +1,31 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { ConfigRegistryController } from "./ConfigRegistryController.mjs";
+/**
+ * Get the network configuration for a given CAIP-2 chain ID.
+ *
+ * @param caip2ChainId - The CAIP-2 chain ID (e.g., "eip155:1").
+ * @returns The network configuration if found, otherwise undefined.
+ */
+export type ConfigRegistryControllerGetNetworkConfigByCaip2ChainIdAction = {
+    type: `ConfigRegistryController:getNetworkConfigByCaip2ChainId`;
+    handler: ConfigRegistryController['getNetworkConfigByCaip2ChainId'];
+};
+/**
+ * Stop all polling.
+ */
+export type ConfigRegistryControllerStopPollingAction = {
+    type: `ConfigRegistryController:stopPolling`;
+    handler: ConfigRegistryController['stopPolling'];
+};
+export type ConfigRegistryControllerStartPollingAction = {
+    type: `ConfigRegistryController:startPolling`;
+    handler: ConfigRegistryController['startPolling'];
+};
+/**
+ * Union of all ConfigRegistryController action types.
+ */
+export type ConfigRegistryControllerMethodActions = ConfigRegistryControllerGetNetworkConfigByCaip2ChainIdAction | ConfigRegistryControllerStopPollingAction | ConfigRegistryControllerStartPollingAction;
+//# sourceMappingURL=ConfigRegistryController-method-action-types.d.mts.map

package/dist/ConfigRegistryController-method-action-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigRegistryController-method-action-types.d.mts","sourceRoot":"","sources":["../src/ConfigRegistryController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,uCAAsC;AAE9E;;;;;GAKG;AACH,MAAM,MAAM,4DAA4D,GAAG;IACzE,IAAI,EAAE,yDAAyD,CAAC;IAChE,OAAO,EAAE,wBAAwB,CAAC,gCAAgC,CAAC,CAAC;CACrE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yCAAyC,GAAG;IACtD,IAAI,EAAE,sCAAsC,CAAC;IAC7C,OAAO,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,uCAAuC,CAAC;IAC9C,OAAO,EAAE,wBAAwB,CAAC,cAAc,CAAC,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAC7C,4DAA4D,GAC5D,yCAAyC,GACzC,0CAA0C,CAAC"}

package/dist/{ConfigRegistryController-method-action-types.js → ConfigRegistryController-method-action-types.mjs}

@@ -3,4 +3,4 @@
  * Do not edit manually.
  */
 export {};
-//# sourceMappingURL=ConfigRegistryController-method-action-types.js.map
+//# sourceMappingURL=ConfigRegistryController-method-action-types.mjs.map

package/dist/ConfigRegistryController-method-action-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigRegistryController-method-action-types.mjs","sourceRoot":"","sources":["../src/ConfigRegistryController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ConfigRegistryController } from './ConfigRegistryController.js';\n\n/**\n * Get the network configuration for a given CAIP-2 chain ID.\n *\n * @param caip2ChainId - The CAIP-2 chain ID (e.g., \"eip155:1\").\n * @returns The network configuration if found, otherwise undefined.\n */\nexport type ConfigRegistryControllerGetNetworkConfigByCaip2ChainIdAction = {\n  type: `ConfigRegistryController:getNetworkConfigByCaip2ChainId`;\n  handler: ConfigRegistryController['getNetworkConfigByCaip2ChainId'];\n};\n\n/**\n * Stop all polling.\n */\nexport type ConfigRegistryControllerStopPollingAction = {\n  type: `ConfigRegistryController:stopPolling`;\n  handler: ConfigRegistryController['stopPolling'];\n};\n\nexport type ConfigRegistryControllerStartPollingAction = {\n  type: `ConfigRegistryController:startPolling`;\n  handler: ConfigRegistryController['startPolling'];\n};\n\n/**\n * Union of all ConfigRegistryController action types.\n */\nexport type ConfigRegistryControllerMethodActions =\n  | ConfigRegistryControllerGetNetworkConfigByCaip2ChainIdAction\n  | ConfigRegistryControllerStopPollingAction\n  | ConfigRegistryControllerStartPollingAction;\n"]}

package/dist/ConfigRegistryController.cjs

@@ -0,0 +1,160 @@
+"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 _ConfigRegistryController_instances, _ConfigRegistryController_setupEventListeners, _ConfigRegistryController_onUnlock, _ConfigRegistryController_onLock, _ConfigRegistryController_onFeatureFlagChange, _ConfigRegistryController_isFeatureFlagEnabled;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigRegistryController = exports.DEFAULT_POLLING_INTERVAL = void 0;
+const polling_controller_1 = require("@metamask/polling-controller");
+const utils_1 = require("@metamask/utils");
+const controllerName = 'ConfigRegistryController';
+exports.DEFAULT_POLLING_INTERVAL = (0, utils_1.inMilliseconds)(1, utils_1.Duration.Day);
+const FEATURE_FLAG_KEY = 'configRegistryApiEnabled';
+const stateMetadata = {
+    configs: {
+        persist: true,
+        includeInStateLogs: false,
+        includeInDebugSnapshot: true,
+        usedInUi: true,
+    },
+    version: {
+        persist: true,
+        includeInStateLogs: true,
+        includeInDebugSnapshot: true,
+        usedInUi: false,
+    },
+    lastFetched: {
+        persist: true,
+        includeInStateLogs: true,
+        includeInDebugSnapshot: true,
+        usedInUi: false,
+    },
+    etag: {
+        persist: true,
+        includeInStateLogs: false,
+        includeInDebugSnapshot: false,
+        usedInUi: false,
+    },
+};
+/**
+ * Default fallback configuration when no configs are available.
+ */
+const DEFAULT_FALLBACK_CONFIG = {};
+const MESSENGER_EXPOSED_METHODS = [
+    'startPolling',
+    'stopPolling',
+    'getNetworkConfigByCaip2ChainId',
+];
+class ConfigRegistryController extends (0, polling_controller_1.StaticIntervalPollingController)() {
+    /**
+     * @param options - The controller options.
+     * @param options.messenger - The controller messenger. Must have
+     *   `ConfigRegistryApiService:fetchConfig` action handler registered
+     *   (e.g. by instantiating {@link ConfigRegistryApiService} with the same
+     *   messenger).
+     * @param options.state - Initial state.
+     * @param options.pollingInterval - Polling interval in milliseconds.
+     * @param options.fallbackConfig - Fallback configuration.
+     */
+    constructor({ messenger, state = {}, pollingInterval = exports.DEFAULT_POLLING_INTERVAL, fallbackConfig = DEFAULT_FALLBACK_CONFIG, }) {
+        super({
+            name: controllerName,
+            metadata: stateMetadata,
+            messenger,
+            state: {
+                configs: {
+                    networks: state.configs?.networks ?? { ...fallbackConfig },
+                },
+                version: state.version ?? null,
+                lastFetched: state.lastFetched ?? null,
+                etag: state.etag ?? null,
+            },
+        });
+        _ConfigRegistryController_instances.add(this);
+        this.setIntervalLength(pollingInterval);
+        this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+        __classPrivateFieldGet(this, _ConfigRegistryController_instances, "m", _ConfigRegistryController_setupEventListeners).call(this);
+    }
+    /**
+     * Get the network configuration for a given CAIP-2 chain ID.
+     *
+     * @param caip2ChainId - The CAIP-2 chain ID (e.g., "eip155:1").
+     * @returns The network configuration if found, otherwise undefined.
+     */
+    getNetworkConfigByCaip2ChainId(caip2ChainId) {
+        return this.state.configs.networks[caip2ChainId];
+    }
+    async _executePoll(_input) {
+        try {
+            const result = await this.messenger.call('ConfigRegistryApiService:fetchConfig', {
+                etag: this.state.etag ?? undefined,
+            });
+            if (!result.modified) {
+                this.update((state) => {
+                    state.lastFetched = Date.now();
+                    if (result.etag !== undefined) {
+                        state.etag = result.etag ?? null;
+                    }
+                });
+                return;
+            }
+            const apiChains = result.data.data.chains;
+            const newConfigs = {};
+            // duplicate chainIds from API response are not expected
+            apiChains.forEach((chainConfig) => {
+                const { chainId } = chainConfig;
+                newConfigs[chainId] = chainConfig;
+            });
+            this.update((state) => {
+                state.configs.networks = newConfigs;
+                state.version = result.data.data.version;
+                state.lastFetched = Date.now();
+                state.etag = result.etag ?? null;
+            });
+        }
+        catch (error) {
+            const errorInstance = error instanceof Error ? error : new Error(String(error));
+            this.messenger.captureException?.(errorInstance);
+        }
+    }
+    /**
+     * Stop all polling.
+     */
+    stopPolling() {
+        // This is a wrapper around `super.stopAllPolling()` for backwards
+        // compatibility, while allowing this method to be exposed via the messenger
+        // using the `MESSENGER_EXPOSED_METHODS` array.
+        super.stopAllPolling();
+    }
+}
+exports.ConfigRegistryController = ConfigRegistryController;
+_ConfigRegistryController_instances = new WeakSet(), _ConfigRegistryController_setupEventListeners = function _ConfigRegistryController_setupEventListeners() {
+    this.messenger.subscribe('KeyringController:unlock', __classPrivateFieldGet(this, _ConfigRegistryController_instances, "m", _ConfigRegistryController_onUnlock).bind(this));
+    this.messenger.subscribe('KeyringController:lock', __classPrivateFieldGet(this, _ConfigRegistryController_instances, "m", _ConfigRegistryController_onLock).bind(this));
+    this.messenger.subscribe('RemoteFeatureFlagController:stateChange', __classPrivateFieldGet(this, _ConfigRegistryController_instances, "m", _ConfigRegistryController_onFeatureFlagChange).bind(this), (stateSelector) => stateSelector.remoteFeatureFlags[FEATURE_FLAG_KEY]);
+}, _ConfigRegistryController_onUnlock = function _ConfigRegistryController_onUnlock() {
+    if (__classPrivateFieldGet(this, _ConfigRegistryController_instances, "m", _ConfigRegistryController_isFeatureFlagEnabled).call(this)) {
+        this.startPolling(null);
+    }
+}, _ConfigRegistryController_onLock = function _ConfigRegistryController_onLock() {
+    this.stopAllPolling();
+}, _ConfigRegistryController_onFeatureFlagChange = function _ConfigRegistryController_onFeatureFlagChange(featureFlagValue) {
+    const { isUnlocked } = this.messenger.call('KeyringController:getState');
+    if (typeof featureFlagValue === 'boolean' &&
+        featureFlagValue &&
+        isUnlocked) {
+        this.startPolling(null);
+    }
+    else {
+        this.stopAllPolling();
+    }
+}, _ConfigRegistryController_isFeatureFlagEnabled = function _ConfigRegistryController_isFeatureFlagEnabled() {
+    const featureFlagValue = this.messenger.call('RemoteFeatureFlagController:getState').remoteFeatureFlags[FEATURE_FLAG_KEY];
+    if (typeof featureFlagValue !== 'boolean') {
+        return false;
+    }
+    return featureFlagValue;
+};
+//# sourceMappingURL=ConfigRegistryController.cjs.map

package/dist/ConfigRegistryController.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigRegistryController.cjs","sourceRoot":"","sources":["../src/ConfigRegistryController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangedEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport type {\n  KeyringControllerGetStateAction,\n  KeyringControllerLockEvent,\n  KeyringControllerUnlockEvent,\n} from '@metamask/keyring-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport { StaticIntervalPollingController } from '@metamask/polling-controller';\nimport type { RemoteFeatureFlagControllerGetStateAction } from '@metamask/remote-feature-flag-controller';\nimport type { RemoteFeatureFlagControllerStateChangeEvent } from '@metamask/remote-feature-flag-controller';\nimport { CaipChainId, Duration, inMilliseconds, Json } from '@metamask/utils';\n\nimport type { ConfigRegistryApiServiceFetchConfigAction } from './config-registry-api-service/config-registry-api-service-method-action-types.js';\nimport type { RegistryNetworkConfig } from './config-registry-api-service/types.js';\nimport type { ConfigRegistryControllerMethodActions } from './ConfigRegistryController-method-action-types.js';\n\nconst controllerName = 'ConfigRegistryController';\n\nexport const DEFAULT_POLLING_INTERVAL = inMilliseconds(1, Duration.Day);\n\nconst FEATURE_FLAG_KEY = 'configRegistryApiEnabled';\n\n/**\n * State for the ConfigRegistryController.\n *\n * Tracks network configurations fetched from the config registry API,\n * along with metadata about the fetch status and caching.\n */\nexport type ConfigRegistryControllerState = {\n  /**\n   * Network configurations organized by chain ID.\n   * Stores the full API response including isFeatured, isTestnet, etc.\n   * Use selectors (e.g. selectFeaturedNetworks) to filter when needed.\n   */\n  configs: {\n    networks: Record<CaipChainId, RegistryNetworkConfig>;\n  };\n  /**\n   * Semantic version string of the configuration data from the API.\n   * Indicates the version/schema of the configuration structure itself\n   * (e.g., \"v1.0.0\", \"1.0.0\").\n   * This is different from `etag` which is used for HTTP cache validation.\n   */\n  version: string | null;\n  /**\n   * Timestamp (milliseconds since epoch) of when the configuration\n   * was last successfully fetched from the API.\n   */\n  lastFetched: number | null;\n  /**\n   * HTTP entity tag (ETag) used for cache validation.\n   * Sent as `If-None-Match` header in subsequent requests to check\n   * if the content has changed. If the server returns 304 Not Modified,\n   * the full response body is not downloaded, improving efficiency.\n   * This is different from `version` which is a semantic version string\n   * indicating the schema/version of the configuration data itself.\n   */\n  etag: string | null;\n};\n\nconst stateMetadata = {\n  configs: {\n    persist: true,\n    includeInStateLogs: false,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  version: {\n    persist: true,\n    includeInStateLogs: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  lastFetched: {\n    persist: true,\n    includeInStateLogs: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  etag: {\n    persist: true,\n    includeInStateLogs: false,\n    includeInDebugSnapshot: false,\n    usedInUi: false,\n  },\n} satisfies StateMetadata<ConfigRegistryControllerState>;\n\n/**\n * Default fallback configuration when no configs are available.\n */\nconst DEFAULT_FALLBACK_CONFIG: Record<string, RegistryNetworkConfig> = {};\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'startPolling',\n  'stopPolling',\n  'getNetworkConfigByCaip2ChainId',\n] as const;\n\n/**\n * Published when the state of {@link ConfigRegistryController} changes.\n */\nexport type ConfigRegistryControllerStateChangedEvent =\n  ControllerStateChangedEvent<\n    typeof controllerName,\n    ConfigRegistryControllerState\n  >;\n\n/**\n * Retrieves the state of the {@link ConfigRegistryController}.\n */\nexport type ConfigRegistryControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  ConfigRegistryControllerState\n>;\n\n/**\n * Actions that {@link ConfigRegistryControllerMessenger} exposes to other consumers.\n */\nexport type ConfigRegistryControllerActions =\n  | ConfigRegistryControllerGetStateAction\n  | ConfigRegistryControllerMethodActions;\n\n/**\n * Actions from other messengers that {@link ConfigRegistryControllerMessenger}\n * calls.\n */\ntype AllowedActions =\n  | KeyringControllerGetStateAction\n  | RemoteFeatureFlagControllerGetStateAction\n  | ConfigRegistryApiServiceFetchConfigAction;\n\n/**\n * Events that {@link ConfigRegistryControllerMessenger} exposes to other consumers.\n */\nexport type ConfigRegistryControllerEvents =\n  ConfigRegistryControllerStateChangedEvent;\n\n/**\n * Events from other messengers that {@link ConfigRegistryControllerMessenger}\n * subscribes to.\n */\ntype AllowedEvents =\n  | KeyringControllerUnlockEvent\n  | KeyringControllerLockEvent\n  | RemoteFeatureFlagControllerStateChangeEvent;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link ConfigRegistryController}.\n */\nexport type ConfigRegistryControllerMessenger = Messenger<\n  typeof controllerName,\n  ConfigRegistryControllerActions | AllowedActions,\n  ConfigRegistryControllerEvents | AllowedEvents\n>;\n\nexport type ConfigRegistryControllerOptions = {\n  messenger: ConfigRegistryControllerMessenger;\n  state?: Partial<ConfigRegistryControllerState>;\n  pollingInterval?: number;\n  fallbackConfig?: Record<string, RegistryNetworkConfig>;\n};\n\nexport class ConfigRegistryController extends StaticIntervalPollingController<null>()<\n  typeof controllerName,\n  ConfigRegistryControllerState,\n  ConfigRegistryControllerMessenger\n> {\n  /**\n   * @param options - The controller options.\n   * @param options.messenger - The controller messenger. Must have\n   *   `ConfigRegistryApiService:fetchConfig` action handler registered\n   *   (e.g. by instantiating {@link ConfigRegistryApiService} with the same\n   *   messenger).\n   * @param options.state - Initial state.\n   * @param options.pollingInterval - Polling interval in milliseconds.\n   * @param options.fallbackConfig - Fallback configuration.\n   */\n  constructor({\n    messenger,\n    state = {},\n    pollingInterval = DEFAULT_POLLING_INTERVAL,\n    fallbackConfig = DEFAULT_FALLBACK_CONFIG,\n  }: ConfigRegistryControllerOptions) {\n    super({\n      name: controllerName,\n      metadata: stateMetadata,\n      messenger,\n      state: {\n        configs: {\n          networks: state.configs?.networks ?? { ...fallbackConfig },\n        },\n        version: state.version ?? null,\n        lastFetched: state.lastFetched ?? null,\n        etag: state.etag ?? null,\n      },\n    });\n\n    this.setIntervalLength(pollingInterval);\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n    this.#setupEventListeners();\n  }\n\n  /**\n   * Get the network configuration for a given CAIP-2 chain ID.\n   *\n   * @param caip2ChainId - The CAIP-2 chain ID (e.g., \"eip155:1\").\n   * @returns The network configuration if found, otherwise undefined.\n   */\n  getNetworkConfigByCaip2ChainId(\n    caip2ChainId: CaipChainId,\n  ): RegistryNetworkConfig | undefined {\n    return this.state.configs.networks[caip2ChainId];\n  }\n\n  async _executePoll(_input: null): Promise<void> {\n    try {\n      const result = await this.messenger.call(\n        'ConfigRegistryApiService:fetchConfig',\n        {\n          etag: this.state.etag ?? undefined,\n        },\n      );\n\n      if (!result.modified) {\n        this.update((state) => {\n          state.lastFetched = Date.now();\n          if (result.etag !== undefined) {\n            state.etag = result.etag ?? null;\n          }\n        });\n        return;\n      }\n\n      const apiChains = result.data.data.chains;\n      const newConfigs: Record<string, RegistryNetworkConfig> = {};\n      // duplicate chainIds from API response are not expected\n      apiChains.forEach((chainConfig) => {\n        const { chainId } = chainConfig;\n        newConfigs[chainId] = chainConfig;\n      });\n\n      this.update((state) => {\n        state.configs.networks = newConfigs;\n        state.version = result.data.data.version;\n        state.lastFetched = Date.now();\n        state.etag = result.etag ?? null;\n      });\n    } catch (error) {\n      const errorInstance =\n        error instanceof Error ? error : new Error(String(error));\n\n      this.messenger.captureException?.(errorInstance);\n    }\n  }\n\n  /**\n   * Stop all polling.\n   */\n  stopPolling(): void {\n    // This is a wrapper around `super.stopAllPolling()` for backwards\n    // compatibility, while allowing this method to be exposed via the messenger\n    // using the `MESSENGER_EXPOSED_METHODS` array.\n    super.stopAllPolling();\n  }\n\n  /**\n   * Setup messenger event listeners necessary for the controller lifecycle\n   */\n  #setupEventListeners(): void {\n    this.messenger.subscribe(\n      'KeyringController:unlock',\n      this.#onUnlock.bind(this),\n    );\n\n    this.messenger.subscribe('KeyringController:lock', this.#onLock.bind(this));\n\n    this.messenger.subscribe(\n      'RemoteFeatureFlagController:stateChange',\n      this.#onFeatureFlagChange.bind(this),\n      (stateSelector) => stateSelector.remoteFeatureFlags[FEATURE_FLAG_KEY],\n    );\n  }\n\n  /**\n   * Handle wallet unlock event by starting polling if the config registry API is enabled.\n   */\n  #onUnlock(): void {\n    if (this.#isFeatureFlagEnabled()) {\n      this.startPolling(null);\n    }\n  }\n\n  /**\n   * Handle wallet lock event by stopping all polling to prevent unnecessary API calls.\n   */\n  #onLock(): void {\n    this.stopAllPolling();\n  }\n\n  /**\n   * Handle changes to the config registry API feature flag by\n   * starting or stopping polling accordingly.\n   *\n   * @param featureFlagValue - The new value of the feature flag.\n   */\n  #onFeatureFlagChange(featureFlagValue: Json): void {\n    const { isUnlocked } = this.messenger.call('KeyringController:getState');\n\n    if (\n      typeof featureFlagValue === 'boolean' &&\n      featureFlagValue &&\n      isUnlocked\n    ) {\n      this.startPolling(null);\n    } else {\n      this.stopAllPolling();\n    }\n  }\n\n  /**\n   * Get the current status of the config registry feature flag.\n   *\n   * @returns Whether the config registry API is enabled.\n   */\n  #isFeatureFlagEnabled(): boolean {\n    const featureFlagValue = this.messenger.call(\n      'RemoteFeatureFlagController:getState',\n    ).remoteFeatureFlags[FEATURE_FLAG_KEY];\n\n    if (typeof featureFlagValue !== 'boolean') {\n      return false;\n    }\n\n    return featureFlagValue;\n  }\n}\n"]}

package/dist/{ConfigRegistryController.d.ts → ConfigRegistryController.d.cts}

@@ -1,12 +1,12 @@
-import type { ControllerGetStateAction, ControllerStateChangedEvent } from '@metamask/base-controller';
-import type { KeyringControllerGetStateAction, KeyringControllerLockEvent, KeyringControllerUnlockEvent } from '@metamask/keyring-controller';
-import type { Messenger } from '@metamask/messenger';
-import type { RemoteFeatureFlagControllerGetStateAction } from '@metamask/remote-feature-flag-controller';
-import type { RemoteFeatureFlagControllerStateChangeEvent } from '@metamask/remote-feature-flag-controller';
-import { CaipChainId } from '@metamask/utils';
-import type { ConfigRegistryApiServiceFetchConfigAction } from './config-registry-api-service/config-registry-api-service-method-action-types.js';
-import type { RegistryNetworkConfig } from './config-registry-api-service/types.js';
-import type { ConfigRegistryControllerMethodActions } from './ConfigRegistryController-method-action-types.js';
+import type { ControllerGetStateAction, ControllerStateChangedEvent } from "@metamask/base-controller";
+import type { KeyringControllerGetStateAction, KeyringControllerLockEvent, KeyringControllerUnlockEvent } from "@metamask/keyring-controller";
+import type { Messenger } from "@metamask/messenger";
+import type { RemoteFeatureFlagControllerGetStateAction } from "@metamask/remote-feature-flag-controller";
+import type { RemoteFeatureFlagControllerStateChangeEvent } from "@metamask/remote-feature-flag-controller";
+import { CaipChainId } from "@metamask/utils";
+import type { ConfigRegistryApiServiceFetchConfigAction } from "./config-registry-api-service/config-registry-api-service-method-action-types.cjs";
+import type { RegistryNetworkConfig } from "./config-registry-api-service/types.cjs";
+import type { ConfigRegistryControllerMethodActions } from "./ConfigRegistryController-method-action-types.cjs";
 declare const controllerName = "ConfigRegistryController";
 export declare const DEFAULT_POLLING_INTERVAL: number;
 /**
@@ -84,18 +84,18 @@ export type ConfigRegistryControllerOptions = {
     fallbackConfig?: Record<string, RegistryNetworkConfig>;
 };
 declare const ConfigRegistryController_base: (abstract new (...args: any[]) => {
-    readonly _callbacks: Map<string, Set<(input: null) => void>>;
+    readonly "__#6@#intervalIds": Record<string, NodeJS.Timeout>;
+    "__#6@#intervalLength": number | undefined;
+    setIntervalLength(intervalLength: number): void;
+    getIntervalLength(): number | undefined;
+    _startPolling(input: null): void;
+    _stopPollingByPollingTokenSetId(key: string): void;
+    readonly "__#3@#pollingTokenSets": Map<string, Set<string>>;
+    readonly "__#3@#callbacks": Map<string, Set<(input: null) => void>>;
     _executePoll(input: null): Promise<void>;
     startPolling(input: null): string;
     stopAllPolling(): void;
     stopPollingByPollingToken(pollingToken: string): void;
-    readonly _intervalIds: Record<import("@metamask/polling-controller").PollingTokenSetId, NodeJS.Timeout>;
-    _intervalLength: number | undefined;
-    setIntervalLength(intervalLength: number): void;
-    getIntervalLength(): number | undefined;
-    _startPolling(input: null): void;
-    _stopPollingByPollingTokenSetId(key: import("@metamask/polling-controller").PollingTokenSetId): void;
-    readonly _pollingTokenSets: Map<import("@metamask/polling-controller").PollingTokenSetId, Set<string>>;
     onPollingComplete(input: null, callback: (input: null) => void): void;
 }) & typeof import("@metamask/base-controller").BaseController;
 export declare class ConfigRegistryController extends ConfigRegistryController_base<typeof controllerName, ConfigRegistryControllerState, ConfigRegistryControllerMessenger> {
@@ -125,4 +125,4 @@ export declare class ConfigRegistryController extends ConfigRegistryController_b
     stopPolling(): void;
 }
 export {};
-//# sourceMappingURL=ConfigRegistryController.d.ts.map
+//# sourceMappingURL=ConfigRegistryController.d.cts.map

package/dist/ConfigRegistryController.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigRegistryController.d.cts","sourceRoot":"","sources":["../src/ConfigRegistryController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,2BAA2B,EAE5B,kCAAkC;AACnC,OAAO,KAAK,EACV,+BAA+B,EAC/B,0BAA0B,EAC1B,4BAA4B,EAC7B,qCAAqC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,KAAK,EAAE,yCAAyC,EAAE,iDAAiD;AAC1G,OAAO,KAAK,EAAE,2CAA2C,EAAE,iDAAiD;AAC5G,OAAO,EAAE,WAAW,EAAkC,wBAAwB;AAE9E,OAAO,KAAK,EAAE,yCAAyC,EAAE,0FAAyF;AAClJ,OAAO,KAAK,EAAE,qBAAqB,EAAE,gDAA+C;AACpF,OAAO,KAAK,EAAE,qCAAqC,EAAE,2DAA0D;AAE/G,QAAA,MAAM,cAAc,6BAA6B,CAAC;AAElD,eAAO,MAAM,wBAAwB,QAAkC,CAAC;AAIxE;;;;;GAKG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;;OAIG;IACH,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;KACtD,CAAC;IACF;;;;;OAKG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAwCF;;GAEG;AACH,MAAM,MAAM,yCAAyC,GACnD,2BAA2B,CACzB,OAAO,cAAc,EACrB,6BAA6B,CAC9B,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,sCAAsC,GAAG,wBAAwB,CAC3E,OAAO,cAAc,EACrB,6BAA6B,CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACvC,sCAAsC,GACtC,qCAAqC,CAAC;AAE1C;;;GAGG;AACH,KAAK,cAAc,GACf,+BAA+B,GAC/B,yCAAyC,GACzC,yCAAyC,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,8BAA8B,GACxC,yCAAyC,CAAC;AAE5C;;;GAGG;AACH,KAAK,aAAa,GACd,4BAA4B,GAC5B,0BAA0B,GAC1B,2CAA2C,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,SAAS,CACvD,OAAO,cAAc,EACrB,+BAA+B,GAAG,cAAc,EAChD,8BAA8B,GAAG,aAAa,CAC/C,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,SAAS,EAAE,iCAAiC,CAAC;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACxD,CAAC;;;;;;;;;;;;;;;;AAEF,qBAAa,wBAAyB,SAAQ,8BAC5C,OAAO,cAAc,EACrB,6BAA6B,EAC7B,iCAAiC,CAClC;;IACC;;;;;;;;;OASG;gBACS,EACV,SAAS,EACT,KAAU,EACV,eAA0C,EAC1C,cAAwC,GACzC,EAAE,+BAA+B;IAwBlC;;;;;OAKG;IACH,8BAA8B,CAC5B,YAAY,EAAE,WAAW,GACxB,qBAAqB,GAAG,SAAS;IAI9B,YAAY,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC/C;;OAEG;IACH,WAAW,IAAI,IAAI;CA6EpB"}

package/dist/ConfigRegistryController.d.mts

@@ -0,0 +1,128 @@
+import type { ControllerGetStateAction, ControllerStateChangedEvent } from "@metamask/base-controller";
+import type { KeyringControllerGetStateAction, KeyringControllerLockEvent, KeyringControllerUnlockEvent } from "@metamask/keyring-controller";
+import type { Messenger } from "@metamask/messenger";
+import type { RemoteFeatureFlagControllerGetStateAction } from "@metamask/remote-feature-flag-controller";
+import type { RemoteFeatureFlagControllerStateChangeEvent } from "@metamask/remote-feature-flag-controller";
+import { CaipChainId } from "@metamask/utils";
+import type { ConfigRegistryApiServiceFetchConfigAction } from "./config-registry-api-service/config-registry-api-service-method-action-types.mjs";
+import type { RegistryNetworkConfig } from "./config-registry-api-service/types.mjs";
+import type { ConfigRegistryControllerMethodActions } from "./ConfigRegistryController-method-action-types.mjs";
+declare const controllerName = "ConfigRegistryController";
+export declare const DEFAULT_POLLING_INTERVAL: number;
+/**
+ * State for the ConfigRegistryController.
+ *
+ * Tracks network configurations fetched from the config registry API,
+ * along with metadata about the fetch status and caching.
+ */
+export type ConfigRegistryControllerState = {
+    /**
+     * Network configurations organized by chain ID.
+     * Stores the full API response including isFeatured, isTestnet, etc.
+     * Use selectors (e.g. selectFeaturedNetworks) to filter when needed.
+     */
+    configs: {
+        networks: Record<CaipChainId, RegistryNetworkConfig>;
+    };
+    /**
+     * Semantic version string of the configuration data from the API.
+     * Indicates the version/schema of the configuration structure itself
+     * (e.g., "v1.0.0", "1.0.0").
+     * This is different from `etag` which is used for HTTP cache validation.
+     */
+    version: string | null;
+    /**
+     * Timestamp (milliseconds since epoch) of when the configuration
+     * was last successfully fetched from the API.
+     */
+    lastFetched: number | null;
+    /**
+     * HTTP entity tag (ETag) used for cache validation.
+     * Sent as `If-None-Match` header in subsequent requests to check
+     * if the content has changed. If the server returns 304 Not Modified,
+     * the full response body is not downloaded, improving efficiency.
+     * This is different from `version` which is a semantic version string
+     * indicating the schema/version of the configuration data itself.
+     */
+    etag: string | null;
+};
+/**
+ * Published when the state of {@link ConfigRegistryController} changes.
+ */
+export type ConfigRegistryControllerStateChangedEvent = ControllerStateChangedEvent<typeof controllerName, ConfigRegistryControllerState>;
+/**
+ * Retrieves the state of the {@link ConfigRegistryController}.
+ */
+export type ConfigRegistryControllerGetStateAction = ControllerGetStateAction<typeof controllerName, ConfigRegistryControllerState>;
+/**
+ * Actions that {@link ConfigRegistryControllerMessenger} exposes to other consumers.
+ */
+export type ConfigRegistryControllerActions = ConfigRegistryControllerGetStateAction | ConfigRegistryControllerMethodActions;
+/**
+ * Actions from other messengers that {@link ConfigRegistryControllerMessenger}
+ * calls.
+ */
+type AllowedActions = KeyringControllerGetStateAction | RemoteFeatureFlagControllerGetStateAction | ConfigRegistryApiServiceFetchConfigAction;
+/**
+ * Events that {@link ConfigRegistryControllerMessenger} exposes to other consumers.
+ */
+export type ConfigRegistryControllerEvents = ConfigRegistryControllerStateChangedEvent;
+/**
+ * Events from other messengers that {@link ConfigRegistryControllerMessenger}
+ * subscribes to.
+ */
+type AllowedEvents = KeyringControllerUnlockEvent | KeyringControllerLockEvent | RemoteFeatureFlagControllerStateChangeEvent;
+/**
+ * The messenger restricted to actions and events accessed by
+ * {@link ConfigRegistryController}.
+ */
+export type ConfigRegistryControllerMessenger = Messenger<typeof controllerName, ConfigRegistryControllerActions | AllowedActions, ConfigRegistryControllerEvents | AllowedEvents>;
+export type ConfigRegistryControllerOptions = {
+    messenger: ConfigRegistryControllerMessenger;
+    state?: Partial<ConfigRegistryControllerState>;
+    pollingInterval?: number;
+    fallbackConfig?: Record<string, RegistryNetworkConfig>;
+};
+declare const ConfigRegistryController_base: (abstract new (...args: any[]) => {
+    readonly "__#6@#intervalIds": Record<string, NodeJS.Timeout>;
+    "__#6@#intervalLength": number | undefined;
+    setIntervalLength(intervalLength: number): void;
+    getIntervalLength(): number | undefined;
+    _startPolling(input: null): void;
+    _stopPollingByPollingTokenSetId(key: string): void;
+    readonly "__#3@#pollingTokenSets": Map<string, Set<string>>;
+    readonly "__#3@#callbacks": Map<string, Set<(input: null) => void>>;
+    _executePoll(input: null): Promise<void>;
+    startPolling(input: null): string;
+    stopAllPolling(): void;
+    stopPollingByPollingToken(pollingToken: string): void;
+    onPollingComplete(input: null, callback: (input: null) => void): void;
+}) & typeof import("@metamask/base-controller").BaseController;
+export declare class ConfigRegistryController extends ConfigRegistryController_base<typeof controllerName, ConfigRegistryControllerState, ConfigRegistryControllerMessenger> {
+    #private;
+    /**
+     * @param options - The controller options.
+     * @param options.messenger - The controller messenger. Must have
+     *   `ConfigRegistryApiService:fetchConfig` action handler registered
+     *   (e.g. by instantiating {@link ConfigRegistryApiService} with the same
+     *   messenger).
+     * @param options.state - Initial state.
+     * @param options.pollingInterval - Polling interval in milliseconds.
+     * @param options.fallbackConfig - Fallback configuration.
+     */
+    constructor({ messenger, state, pollingInterval, fallbackConfig, }: ConfigRegistryControllerOptions);
+    /**
+     * Get the network configuration for a given CAIP-2 chain ID.
+     *
+     * @param caip2ChainId - The CAIP-2 chain ID (e.g., "eip155:1").
+     * @returns The network configuration if found, otherwise undefined.
+     */
+    getNetworkConfigByCaip2ChainId(caip2ChainId: CaipChainId): RegistryNetworkConfig | undefined;
+    _executePoll(_input: null): Promise<void>;
+    /**
+     * Stop all polling.
+     */
+    stopPolling(): void;
+}
+export {};
+//# sourceMappingURL=ConfigRegistryController.d.mts.map

package/dist/ConfigRegistryController.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigRegistryController.d.mts","sourceRoot":"","sources":["../src/ConfigRegistryController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,2BAA2B,EAE5B,kCAAkC;AACnC,OAAO,KAAK,EACV,+BAA+B,EAC/B,0BAA0B,EAC1B,4BAA4B,EAC7B,qCAAqC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,KAAK,EAAE,yCAAyC,EAAE,iDAAiD;AAC1G,OAAO,KAAK,EAAE,2CAA2C,EAAE,iDAAiD;AAC5G,OAAO,EAAE,WAAW,EAAkC,wBAAwB;AAE9E,OAAO,KAAK,EAAE,yCAAyC,EAAE,0FAAyF;AAClJ,OAAO,KAAK,EAAE,qBAAqB,EAAE,gDAA+C;AACpF,OAAO,KAAK,EAAE,qCAAqC,EAAE,2DAA0D;AAE/G,QAAA,MAAM,cAAc,6BAA6B,CAAC;AAElD,eAAO,MAAM,wBAAwB,QAAkC,CAAC;AAIxE;;;;;GAKG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;;OAIG;IACH,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;KACtD,CAAC;IACF;;;;;OAKG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAwCF;;GAEG;AACH,MAAM,MAAM,yCAAyC,GACnD,2BAA2B,CACzB,OAAO,cAAc,EACrB,6BAA6B,CAC9B,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,sCAAsC,GAAG,wBAAwB,CAC3E,OAAO,cAAc,EACrB,6BAA6B,CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACvC,sCAAsC,GACtC,qCAAqC,CAAC;AAE1C;;;GAGG;AACH,KAAK,cAAc,GACf,+BAA+B,GAC/B,yCAAyC,GACzC,yCAAyC,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,8BAA8B,GACxC,yCAAyC,CAAC;AAE5C;;;GAGG;AACH,KAAK,aAAa,GACd,4BAA4B,GAC5B,0BAA0B,GAC1B,2CAA2C,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,SAAS,CACvD,OAAO,cAAc,EACrB,+BAA+B,GAAG,cAAc,EAChD,8BAA8B,GAAG,aAAa,CAC/C,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,SAAS,EAAE,iCAAiC,CAAC;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACxD,CAAC;;;;;;;;;;;;;;;;AAEF,qBAAa,wBAAyB,SAAQ,8BAC5C,OAAO,cAAc,EACrB,6BAA6B,EAC7B,iCAAiC,CAClC;;IACC;;;;;;;;;OASG;gBACS,EACV,SAAS,EACT,KAAU,EACV,eAA0C,EAC1C,cAAwC,GACzC,EAAE,+BAA+B;IAwBlC;;;;;OAKG;IACH,8BAA8B,CAC5B,YAAY,EAAE,WAAW,GACxB,qBAAqB,GAAG,SAAS;IAI9B,YAAY,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC/C;;OAEG;IACH,WAAW,IAAI,IAAI;CA6EpB"}

package/dist/{ConfigRegistryController.js → ConfigRegistryController.mjs}

@@ -4,8 +4,8 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _ConfigRegistryController_instances, _ConfigRegistryController_setupEventListeners, _ConfigRegistryController_onUnlock, _ConfigRegistryController_onLock, _ConfigRegistryController_onFeatureFlagChange, _ConfigRegistryController_isFeatureFlagEnabled;
-import { StaticIntervalPollingController } from '@metamask/polling-controller';
-import { Duration, inMilliseconds } from '@metamask/utils';
+import { StaticIntervalPollingController } from "@metamask/polling-controller";
+import { Duration, inMilliseconds } from "@metamask/utils";
 const controllerName = 'ConfigRegistryController';
 export const DEFAULT_POLLING_INTERVAL = inMilliseconds(1, Duration.Day);
 const FEATURE_FLAG_KEY = 'configRegistryApiEnabled';
@@ -153,4 +153,4 @@ _ConfigRegistryController_instances = new WeakSet(), _ConfigRegistryController_s
     }
     return featureFlagValue;
 };
-//# sourceMappingURL=ConfigRegistryController.js.map
+//# sourceMappingURL=ConfigRegistryController.mjs.map

package/dist/ConfigRegistryController.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigRegistryController.mjs","sourceRoot":"","sources":["../src/ConfigRegistryController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangedEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport type {\n  KeyringControllerGetStateAction,\n  KeyringControllerLockEvent,\n  KeyringControllerUnlockEvent,\n} from '@metamask/keyring-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport { StaticIntervalPollingController } from '@metamask/polling-controller';\nimport type { RemoteFeatureFlagControllerGetStateAction } from '@metamask/remote-feature-flag-controller';\nimport type { RemoteFeatureFlagControllerStateChangeEvent } from '@metamask/remote-feature-flag-controller';\nimport { CaipChainId, Duration, inMilliseconds, Json } from '@metamask/utils';\n\nimport type { ConfigRegistryApiServiceFetchConfigAction } from './config-registry-api-service/config-registry-api-service-method-action-types.js';\nimport type { RegistryNetworkConfig } from './config-registry-api-service/types.js';\nimport type { ConfigRegistryControllerMethodActions } from './ConfigRegistryController-method-action-types.js';\n\nconst controllerName = 'ConfigRegistryController';\n\nexport const DEFAULT_POLLING_INTERVAL = inMilliseconds(1, Duration.Day);\n\nconst FEATURE_FLAG_KEY = 'configRegistryApiEnabled';\n\n/**\n * State for the ConfigRegistryController.\n *\n * Tracks network configurations fetched from the config registry API,\n * along with metadata about the fetch status and caching.\n */\nexport type ConfigRegistryControllerState = {\n  /**\n   * Network configurations organized by chain ID.\n   * Stores the full API response including isFeatured, isTestnet, etc.\n   * Use selectors (e.g. selectFeaturedNetworks) to filter when needed.\n   */\n  configs: {\n    networks: Record<CaipChainId, RegistryNetworkConfig>;\n  };\n  /**\n   * Semantic version string of the configuration data from the API.\n   * Indicates the version/schema of the configuration structure itself\n   * (e.g., \"v1.0.0\", \"1.0.0\").\n   * This is different from `etag` which is used for HTTP cache validation.\n   */\n  version: string | null;\n  /**\n   * Timestamp (milliseconds since epoch) of when the configuration\n   * was last successfully fetched from the API.\n   */\n  lastFetched: number | null;\n  /**\n   * HTTP entity tag (ETag) used for cache validation.\n   * Sent as `If-None-Match` header in subsequent requests to check\n   * if the content has changed. If the server returns 304 Not Modified,\n   * the full response body is not downloaded, improving efficiency.\n   * This is different from `version` which is a semantic version string\n   * indicating the schema/version of the configuration data itself.\n   */\n  etag: string | null;\n};\n\nconst stateMetadata = {\n  configs: {\n    persist: true,\n    includeInStateLogs: false,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  version: {\n    persist: true,\n    includeInStateLogs: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  lastFetched: {\n    persist: true,\n    includeInStateLogs: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  etag: {\n    persist: true,\n    includeInStateLogs: false,\n    includeInDebugSnapshot: false,\n    usedInUi: false,\n  },\n} satisfies StateMetadata<ConfigRegistryControllerState>;\n\n/**\n * Default fallback configuration when no configs are available.\n */\nconst DEFAULT_FALLBACK_CONFIG: Record<string, RegistryNetworkConfig> = {};\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'startPolling',\n  'stopPolling',\n  'getNetworkConfigByCaip2ChainId',\n] as const;\n\n/**\n * Published when the state of {@link ConfigRegistryController} changes.\n */\nexport type ConfigRegistryControllerStateChangedEvent =\n  ControllerStateChangedEvent<\n    typeof controllerName,\n    ConfigRegistryControllerState\n  >;\n\n/**\n * Retrieves the state of the {@link ConfigRegistryController}.\n */\nexport type ConfigRegistryControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  ConfigRegistryControllerState\n>;\n\n/**\n * Actions that {@link ConfigRegistryControllerMessenger} exposes to other consumers.\n */\nexport type ConfigRegistryControllerActions =\n  | ConfigRegistryControllerGetStateAction\n  | ConfigRegistryControllerMethodActions;\n\n/**\n * Actions from other messengers that {@link ConfigRegistryControllerMessenger}\n * calls.\n */\ntype AllowedActions =\n  | KeyringControllerGetStateAction\n  | RemoteFeatureFlagControllerGetStateAction\n  | ConfigRegistryApiServiceFetchConfigAction;\n\n/**\n * Events that {@link ConfigRegistryControllerMessenger} exposes to other consumers.\n */\nexport type ConfigRegistryControllerEvents =\n  ConfigRegistryControllerStateChangedEvent;\n\n/**\n * Events from other messengers that {@link ConfigRegistryControllerMessenger}\n * subscribes to.\n */\ntype AllowedEvents =\n  | KeyringControllerUnlockEvent\n  | KeyringControllerLockEvent\n  | RemoteFeatureFlagControllerStateChangeEvent;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link ConfigRegistryController}.\n */\nexport type ConfigRegistryControllerMessenger = Messenger<\n  typeof controllerName,\n  ConfigRegistryControllerActions | AllowedActions,\n  ConfigRegistryControllerEvents | AllowedEvents\n>;\n\nexport type ConfigRegistryControllerOptions = {\n  messenger: ConfigRegistryControllerMessenger;\n  state?: Partial<ConfigRegistryControllerState>;\n  pollingInterval?: number;\n  fallbackConfig?: Record<string, RegistryNetworkConfig>;\n};\n\nexport class ConfigRegistryController extends StaticIntervalPollingController<null>()<\n  typeof controllerName,\n  ConfigRegistryControllerState,\n  ConfigRegistryControllerMessenger\n> {\n  /**\n   * @param options - The controller options.\n   * @param options.messenger - The controller messenger. Must have\n   *   `ConfigRegistryApiService:fetchConfig` action handler registered\n   *   (e.g. by instantiating {@link ConfigRegistryApiService} with the same\n   *   messenger).\n   * @param options.state - Initial state.\n   * @param options.pollingInterval - Polling interval in milliseconds.\n   * @param options.fallbackConfig - Fallback configuration.\n   */\n  constructor({\n    messenger,\n    state = {},\n    pollingInterval = DEFAULT_POLLING_INTERVAL,\n    fallbackConfig = DEFAULT_FALLBACK_CONFIG,\n  }: ConfigRegistryControllerOptions) {\n    super({\n      name: controllerName,\n      metadata: stateMetadata,\n      messenger,\n      state: {\n        configs: {\n          networks: state.configs?.networks ?? { ...fallbackConfig },\n        },\n        version: state.version ?? null,\n        lastFetched: state.lastFetched ?? null,\n        etag: state.etag ?? null,\n      },\n    });\n\n    this.setIntervalLength(pollingInterval);\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n    this.#setupEventListeners();\n  }\n\n  /**\n   * Get the network configuration for a given CAIP-2 chain ID.\n   *\n   * @param caip2ChainId - The CAIP-2 chain ID (e.g., \"eip155:1\").\n   * @returns The network configuration if found, otherwise undefined.\n   */\n  getNetworkConfigByCaip2ChainId(\n    caip2ChainId: CaipChainId,\n  ): RegistryNetworkConfig | undefined {\n    return this.state.configs.networks[caip2ChainId];\n  }\n\n  async _executePoll(_input: null): Promise<void> {\n    try {\n      const result = await this.messenger.call(\n        'ConfigRegistryApiService:fetchConfig',\n        {\n          etag: this.state.etag ?? undefined,\n        },\n      );\n\n      if (!result.modified) {\n        this.update((state) => {\n          state.lastFetched = Date.now();\n          if (result.etag !== undefined) {\n            state.etag = result.etag ?? null;\n          }\n        });\n        return;\n      }\n\n      const apiChains = result.data.data.chains;\n      const newConfigs: Record<string, RegistryNetworkConfig> = {};\n      // duplicate chainIds from API response are not expected\n      apiChains.forEach((chainConfig) => {\n        const { chainId } = chainConfig;\n        newConfigs[chainId] = chainConfig;\n      });\n\n      this.update((state) => {\n        state.configs.networks = newConfigs;\n        state.version = result.data.data.version;\n        state.lastFetched = Date.now();\n        state.etag = result.etag ?? null;\n      });\n    } catch (error) {\n      const errorInstance =\n        error instanceof Error ? error : new Error(String(error));\n\n      this.messenger.captureException?.(errorInstance);\n    }\n  }\n\n  /**\n   * Stop all polling.\n   */\n  stopPolling(): void {\n    // This is a wrapper around `super.stopAllPolling()` for backwards\n    // compatibility, while allowing this method to be exposed via the messenger\n    // using the `MESSENGER_EXPOSED_METHODS` array.\n    super.stopAllPolling();\n  }\n\n  /**\n   * Setup messenger event listeners necessary for the controller lifecycle\n   */\n  #setupEventListeners(): void {\n    this.messenger.subscribe(\n      'KeyringController:unlock',\n      this.#onUnlock.bind(this),\n    );\n\n    this.messenger.subscribe('KeyringController:lock', this.#onLock.bind(this));\n\n    this.messenger.subscribe(\n      'RemoteFeatureFlagController:stateChange',\n      this.#onFeatureFlagChange.bind(this),\n      (stateSelector) => stateSelector.remoteFeatureFlags[FEATURE_FLAG_KEY],\n    );\n  }\n\n  /**\n   * Handle wallet unlock event by starting polling if the config registry API is enabled.\n   */\n  #onUnlock(): void {\n    if (this.#isFeatureFlagEnabled()) {\n      this.startPolling(null);\n    }\n  }\n\n  /**\n   * Handle wallet lock event by stopping all polling to prevent unnecessary API calls.\n   */\n  #onLock(): void {\n    this.stopAllPolling();\n  }\n\n  /**\n   * Handle changes to the config registry API feature flag by\n   * starting or stopping polling accordingly.\n   *\n   * @param featureFlagValue - The new value of the feature flag.\n   */\n  #onFeatureFlagChange(featureFlagValue: Json): void {\n    const { isUnlocked } = this.messenger.call('KeyringController:getState');\n\n    if (\n      typeof featureFlagValue === 'boolean' &&\n      featureFlagValue &&\n      isUnlocked\n    ) {\n      this.startPolling(null);\n    } else {\n      this.stopAllPolling();\n    }\n  }\n\n  /**\n   * Get the current status of the config registry feature flag.\n   *\n   * @returns Whether the config registry API is enabled.\n   */\n  #isFeatureFlagEnabled(): boolean {\n    const featureFlagValue = this.messenger.call(\n      'RemoteFeatureFlagController:getState',\n    ).remoteFeatureFlags[FEATURE_FLAG_KEY];\n\n    if (typeof featureFlagValue !== 'boolean') {\n      return false;\n    }\n\n    return featureFlagValue;\n  }\n}\n"]}

package/dist/config-registry-api-service/config-registry-api-service-method-action-types.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config-registry-api-service-method-action-types.cjs.map

package/dist/config-registry-api-service/config-registry-api-service-method-action-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-registry-api-service-method-action-types.cjs","sourceRoot":"","sources":["../../src/config-registry-api-service/config-registry-api-service-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ConfigRegistryApiService } from './config-registry-api-service.js';\n\nexport type ConfigRegistryApiServiceFetchConfigAction = {\n  type: `ConfigRegistryApiService:fetchConfig`;\n  handler: ConfigRegistryApiService['fetchConfig'];\n};\n\n/**\n * Union of all ConfigRegistryApiService action types.\n */\nexport type ConfigRegistryApiServiceMethodActions =\n  ConfigRegistryApiServiceFetchConfigAction;\n"]}

package/dist/config-registry-api-service/{config-registry-api-service-method-action-types.d.ts → config-registry-api-service-method-action-types.d.cts}

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { ConfigRegistryApiService } from './config-registry-api-service.js';
+import type { ConfigRegistryApiService } from "./config-registry-api-service.cjs";
 export type ConfigRegistryApiServiceFetchConfigAction = {
     type: `ConfigRegistryApiService:fetchConfig`;
     handler: ConfigRegistryApiService['fetchConfig'];
@@ -11,4 +11,4 @@ export type ConfigRegistryApiServiceFetchConfigAction = {
  * Union of all ConfigRegistryApiService action types.
  */
 export type ConfigRegistryApiServiceMethodActions = ConfigRegistryApiServiceFetchConfigAction;
-//# sourceMappingURL=config-registry-api-service-method-action-types.d.ts.map
+//# sourceMappingURL=config-registry-api-service-method-action-types.d.cts.map

package/dist/config-registry-api-service/config-registry-api-service-method-action-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-registry-api-service-method-action-types.d.cts","sourceRoot":"","sources":["../../src/config-registry-api-service/config-registry-api-service-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,0CAAyC;AAEjF,MAAM,MAAM,yCAAyC,GAAG;IACtD,IAAI,EAAE,sCAAsC,CAAC;IAC7C,OAAO,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAC;CAClD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAC/C,yCAAyC,CAAC"}

package/dist/config-registry-api-service/config-registry-api-service-method-action-types.d.mts

@@ -0,0 +1,14 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { ConfigRegistryApiService } from "./config-registry-api-service.mjs";
+export type ConfigRegistryApiServiceFetchConfigAction = {
+    type: `ConfigRegistryApiService:fetchConfig`;
+    handler: ConfigRegistryApiService['fetchConfig'];
+};
+/**
+ * Union of all ConfigRegistryApiService action types.
+ */
+export type ConfigRegistryApiServiceMethodActions = ConfigRegistryApiServiceFetchConfigAction;
+//# sourceMappingURL=config-registry-api-service-method-action-types.d.mts.map

package/dist/config-registry-api-service/config-registry-api-service-method-action-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-registry-api-service-method-action-types.d.mts","sourceRoot":"","sources":["../../src/config-registry-api-service/config-registry-api-service-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,0CAAyC;AAEjF,MAAM,MAAM,yCAAyC,GAAG;IACtD,IAAI,EAAE,sCAAsC,CAAC;IAC7C,OAAO,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAC;CAClD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAC/C,yCAAyC,CAAC"}

package/dist/config-registry-api-service/{config-registry-api-service-method-action-types.js → config-registry-api-service-method-action-types.mjs}

@@ -3,4 +3,4 @@
  * Do not edit manually.
  */
 export {};
-//# sourceMappingURL=config-registry-api-service-method-action-types.js.map
+//# sourceMappingURL=config-registry-api-service-method-action-types.mjs.map

package/dist/config-registry-api-service/config-registry-api-service-method-action-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-registry-api-service-method-action-types.mjs","sourceRoot":"","sources":["../../src/config-registry-api-service/config-registry-api-service-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ConfigRegistryApiService } from './config-registry-api-service.js';\n\nexport type ConfigRegistryApiServiceFetchConfigAction = {\n  type: `ConfigRegistryApiService:fetchConfig`;\n  handler: ConfigRegistryApiService['fetchConfig'];\n};\n\n/**\n * Union of all ConfigRegistryApiService action types.\n */\nexport type ConfigRegistryApiServiceMethodActions =\n  ConfigRegistryApiServiceFetchConfigAction;\n"]}