@metamask-previews/network-enablement-controller 6.0.5-preview-3866c0ff1 → 6.0.5-preview-e3275932a

package/CHANGELOG.md

@@ -20,7 +20,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
-- **BREAKING:** Bump minimum Node.js version to 22 ([#9168](https://github.com/MetaMask/core/pull/9168))
 - Bump `@metamask/transaction-controller` from `^69.5.0` to `^69.5.2` ([#9798](https://github.com/MetaMask/core/pull/9798), [#9823](https://github.com/MetaMask/core/pull/9823))
 - Bump `@metamask/config-registry-controller` from `^2.0.1` to `^3.0.0` ([#9923](https://github.com/MetaMask/core/pull/9923))
 

package/dist/NetworkEnablementController-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=NetworkEnablementController-method-action-types.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkEnablementController-method-action-types.cjs","sourceRoot":"","sources":["../src/NetworkEnablementController-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { NetworkEnablementController } from './NetworkEnablementController.js';\n\n/**\n * Enables or disables a network for the user.\n *\n * This method accepts either a Hex chain ID (for EVM networks) or a CAIP-2 chain ID\n * (for any blockchain network). The method will automatically convert Hex chain IDs\n * to CAIP-2 format internally. This dual parameter support allows for backward\n * compatibility with existing EVM chain ID formats while supporting newer\n * multi-chain standards.\n *\n * When enabling a non-popular network, this method will disable all other networks\n * to ensure only one network is active at a time (exclusive mode).\n *\n * @param chainId - The chain ID of the network to enable or disable. Can be either:\n * - A Hex string (e.g., '0x1' for Ethereum mainnet) for EVM networks\n * - A CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet, 'solana:mainnet' for Solana)\n */\nexport type NetworkEnablementControllerEnableNetworkAction = {\n  type: `NetworkEnablementController:enableNetwork`;\n  handler: NetworkEnablementController['enableNetwork'];\n};\n\n/**\n * Enables a network for the user within a specific namespace.\n *\n * This method accepts either a Hex chain ID (for EVM networks) or a CAIP-2 chain ID\n * (for any blockchain network) and enables it within the specified namespace.\n * The method validates that the chainId belongs to the specified namespace for safety.\n *\n * Before enabling the target network, this method disables all other networks\n * in the same namespace to ensure exclusive behavior within the namespace.\n *\n * @param chainId - The chain ID of the network to enable. Can be either:\n * - A Hex string (e.g., '0x1' for Ethereum mainnet) for EVM networks\n * - A CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet, 'solana:mainnet' for Solana)\n * @param namespace - The CAIP namespace where the network should be enabled\n * @throws Error if the chainId's derived namespace doesn't match the provided namespace\n */\nexport type NetworkEnablementControllerEnableNetworkInNamespaceAction = {\n  type: `NetworkEnablementController:enableNetworkInNamespace`;\n  handler: NetworkEnablementController['enableNetworkInNamespace'];\n};\n\n/**\n * Enables all popular networks and Solana mainnet.\n *\n * This method first disables all networks across all namespaces, then enables\n * all networks defined in POPULAR_NETWORKS (EVM networks), Solana mainnet, and\n * Bitcoin mainnet. This provides exclusive behavior - only popular networks will\n * be enabled after calling this method.\n *\n * Popular networks that don't exist in NetworkController or MultichainNetworkController configurations will be skipped silently.\n */\nexport type NetworkEnablementControllerEnableAllPopularNetworksAction = {\n  type: `NetworkEnablementController:enableAllPopularNetworks`;\n  handler: NetworkEnablementController['enableAllPopularNetworks'];\n};\n\n/**\n * Initializes the network enablement state from network controller configurations.\n *\n * This method reads the current network configurations from both NetworkController\n * and MultichainNetworkController and syncs the enabled network map and nativeAssetIdentifiers accordingly.\n * It ensures proper namespace buckets exist for all configured networks and only\n * adds missing networks with a default value of false, preserving existing user settings.\n *\n * This method should be called after the NetworkController and MultichainNetworkController\n * have been initialized and their configurations are available.\n */\nexport type NetworkEnablementControllerInitAction = {\n  type: `NetworkEnablementController:init`;\n  handler: NetworkEnablementController['init'];\n};\n\n/**\n * Initializes the native asset identifiers from network configurations.\n * This method should be called from the client during controller initialization\n * to populate the nativeAssetIdentifiers state based on actual network configurations.\n *\n * @param networks - Array of network configurations with chainId and nativeCurrency\n * @example\n * ```typescript\n * const evmNetworks = Object.values(networkControllerState.networkConfigurationsByChainId)\n * .map(config => ({\n * chainId: toEvmCaipChainId(config.chainId),\n * nativeCurrency: config.nativeCurrency,\n * }));\n *\n * const multichainNetworks = Object.values(multichainState.multichainNetworkConfigurationsByChainId)\n * .map(config => ({\n * chainId: config.chainId,\n * nativeCurrency: config.nativeCurrency,\n * }));\n *\n * await controller.initNativeAssetIdentifiers([...evmNetworks, ...multichainNetworks]);\n * ```\n */\nexport type NetworkEnablementControllerInitNativeAssetIdentifiersAction = {\n  type: `NetworkEnablementController:initNativeAssetIdentifiers`;\n  handler: NetworkEnablementController['initNativeAssetIdentifiers'];\n};\n\n/**\n * Disables a network for the user.\n *\n * This method accepts either a Hex chain ID (for EVM networks) or a CAIP-2 chain ID\n * (for any blockchain network). The method will automatically convert Hex chain IDs\n * to CAIP-2 format internally.\n *\n * Note: This method will prevent disabling the last remaining enabled network\n * to ensure at least one network is always available.\n *\n * @param chainId - The chain ID of the network to disable. Can be either:\n * - A Hex string (e.g., '0x1' for Ethereum mainnet) for EVM networks\n * - A CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet, 'solana:mainnet' for Solana)\n */\nexport type NetworkEnablementControllerDisableNetworkAction = {\n  type: `NetworkEnablementController:disableNetwork`;\n  handler: NetworkEnablementController['disableNetwork'];\n};\n\n/**\n * Restores the enabled network map to a previously snapshotted state.\n *\n * Not a general merge API: only updates keys already present in the current\n * map. Missing snapshot values default to `false`. Intended for callers with\n * direct controller access (e.g. extension) to undo `#onAddNetwork` filter\n * switches when adding a network without changing the active selection.\n *\n * @param enabledNetworkMap - Previously snapshotted enabledNetworkMap.\n */\nexport type NetworkEnablementControllerRestoreEnabledNetworkMapAction = {\n  type: `NetworkEnablementController:restoreEnabledNetworkMap`;\n  handler: NetworkEnablementController['restoreEnabledNetworkMap'];\n};\n\n/**\n * Checks if a network is enabled.\n *\n * @param chainId - The chain ID of the network to check. Can be either:\n * - A Hex string (e.g., '0x1' for Ethereum mainnet) for EVM networks\n * - A CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet, 'solana:mainnet' for Solana)\n * @returns True if the network is enabled, false otherwise\n */\nexport type NetworkEnablementControllerIsNetworkEnabledAction = {\n  type: `NetworkEnablementController:isNetworkEnabled`;\n  handler: NetworkEnablementController['isNetworkEnabled'];\n};\n\n/**\n * Returns popular EVM network chain IDs in hex form, restricted to networks\n * that exist in NetworkController (networkConfigurationsByChainId). Source is\n * the bundled `POPULAR_NETWORKS` unioned with registry-featured EVM chains.\n *\n * @returns Hex chain IDs for popular EVM networks that are configured.\n */\nexport type NetworkEnablementControllerListPopularEvmNetworksAction = {\n  type: `NetworkEnablementController:listPopularEvmNetworks`;\n  handler: NetworkEnablementController['listPopularEvmNetworks'];\n};\n\n/**\n * Returns popular multichain (Bitcoin, Solana, Tron, Stellar) mainnet chain IDs in\n * CAIP-2 form, restricted to networks that exist in MultichainNetworkController\n * (multichainNetworkConfigurationsByChainId).\n *\n * @returns CAIP-2 chain IDs for Bitcoin, Solana, Tron, and Stellar mainnets that are configured.\n */\nexport type NetworkEnablementControllerListPopularMultichainNetworksAction = {\n  type: `NetworkEnablementController:listPopularMultichainNetworks`;\n  handler: NetworkEnablementController['listPopularMultichainNetworks'];\n};\n\n/**\n * Returns the list of popular network chain IDs in CAIP-2 form, restricted to\n * networks that exist in NetworkController (networkConfigurationsByChainId) and\n * MultichainNetworkController (multichainNetworkConfigurationsByChainId). EVM\n * popular networks come from POPULAR_NETWORKS; multichain popular are Bitcoin,\n * Solana, Tron, and Stellar mainnets.\n *\n * @returns CAIP-2 chain IDs for popular EVM networks and multichain mainnets that are configured.\n */\nexport type NetworkEnablementControllerListPopularNetworksAction = {\n  type: `NetworkEnablementController:listPopularNetworks`;\n  handler: NetworkEnablementController['listPopularNetworks'];\n};\n\n/**\n * Union of all NetworkEnablementController action types.\n */\nexport type NetworkEnablementControllerMethodActions =\n  | NetworkEnablementControllerEnableNetworkAction\n  | NetworkEnablementControllerEnableNetworkInNamespaceAction\n  | NetworkEnablementControllerEnableAllPopularNetworksAction\n  | NetworkEnablementControllerInitAction\n  | NetworkEnablementControllerInitNativeAssetIdentifiersAction\n  | NetworkEnablementControllerDisableNetworkAction\n  | NetworkEnablementControllerRestoreEnabledNetworkMapAction\n  | NetworkEnablementControllerIsNetworkEnabledAction\n  | NetworkEnablementControllerListPopularEvmNetworksAction\n  | NetworkEnablementControllerListPopularMultichainNetworksAction\n  | NetworkEnablementControllerListPopularNetworksAction;\n"]}

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

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { NetworkEnablementController } from './NetworkEnablementController.js';
+import type { NetworkEnablementController } from "./NetworkEnablementController.cjs";
 /**
  * Enables or disables a network for the user.
  *
@@ -182,4 +182,4 @@ export type NetworkEnablementControllerListPopularNetworksAction = {
  * Union of all NetworkEnablementController action types.
  */
 export type NetworkEnablementControllerMethodActions = NetworkEnablementControllerEnableNetworkAction | NetworkEnablementControllerEnableNetworkInNamespaceAction | NetworkEnablementControllerEnableAllPopularNetworksAction | NetworkEnablementControllerInitAction | NetworkEnablementControllerInitNativeAssetIdentifiersAction | NetworkEnablementControllerDisableNetworkAction | NetworkEnablementControllerRestoreEnabledNetworkMapAction | NetworkEnablementControllerIsNetworkEnabledAction | NetworkEnablementControllerListPopularEvmNetworksAction | NetworkEnablementControllerListPopularMultichainNetworksAction | NetworkEnablementControllerListPopularNetworksAction;
-//# sourceMappingURL=NetworkEnablementController-method-action-types.d.ts.map
+//# sourceMappingURL=NetworkEnablementController-method-action-types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkEnablementController-method-action-types.d.cts","sourceRoot":"","sources":["../src/NetworkEnablementController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,0CAAyC;AAEpF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,8CAA8C,GAAG;IAC3D,IAAI,EAAE,2CAA2C,CAAC;IAClD,OAAO,EAAE,2BAA2B,CAAC,eAAe,CAAC,CAAC;CACvD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,yDAAyD,GAAG;IACtE,IAAI,EAAE,sDAAsD,CAAC;IAC7D,OAAO,EAAE,2BAA2B,CAAC,0BAA0B,CAAC,CAAC;CAClE,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,yDAAyD,GAAG;IACtE,IAAI,EAAE,sDAAsD,CAAC;IAC7D,OAAO,EAAE,2BAA2B,CAAC,0BAA0B,CAAC,CAAC;CAClE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,2BAA2B,CAAC,MAAM,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,2DAA2D,GAAG;IACxE,IAAI,EAAE,wDAAwD,CAAC;IAC/D,OAAO,EAAE,2BAA2B,CAAC,4BAA4B,CAAC,CAAC;CACpE,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,+CAA+C,GAAG;IAC5D,IAAI,EAAE,4CAA4C,CAAC;IACnD,OAAO,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,CAAC;CACxD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,yDAAyD,GAAG;IACtE,IAAI,EAAE,sDAAsD,CAAC;IAC7D,OAAO,EAAE,2BAA2B,CAAC,0BAA0B,CAAC,CAAC;CAClE,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,iDAAiD,GAAG;IAC9D,IAAI,EAAE,8CAA8C,CAAC;IACrD,OAAO,EAAE,2BAA2B,CAAC,kBAAkB,CAAC,CAAC;CAC1D,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,uDAAuD,GAAG;IACpE,IAAI,EAAE,oDAAoD,CAAC;IAC3D,OAAO,EAAE,2BAA2B,CAAC,wBAAwB,CAAC,CAAC;CAChE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,8DAA8D,GAAG;IAC3E,IAAI,EAAE,2DAA2D,CAAC;IAClE,OAAO,EAAE,2BAA2B,CAAC,+BAA+B,CAAC,CAAC;CACvE,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,oDAAoD,GAAG;IACjE,IAAI,EAAE,iDAAiD,CAAC;IACxD,OAAO,EAAE,2BAA2B,CAAC,qBAAqB,CAAC,CAAC;CAC7D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAChD,8CAA8C,GAC9C,yDAAyD,GACzD,yDAAyD,GACzD,qCAAqC,GACrC,2DAA2D,GAC3D,+CAA+C,GAC/C,yDAAyD,GACzD,iDAAiD,GACjD,uDAAuD,GACvD,8DAA8D,GAC9D,oDAAoD,CAAC"}

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

@@ -0,0 +1,185 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { NetworkEnablementController } from "./NetworkEnablementController.mjs";
+/**
+ * Enables or disables a network for the user.
+ *
+ * This method accepts either a Hex chain ID (for EVM networks) or a CAIP-2 chain ID
+ * (for any blockchain network). The method will automatically convert Hex chain IDs
+ * to CAIP-2 format internally. This dual parameter support allows for backward
+ * compatibility with existing EVM chain ID formats while supporting newer
+ * multi-chain standards.
+ *
+ * When enabling a non-popular network, this method will disable all other networks
+ * to ensure only one network is active at a time (exclusive mode).
+ *
+ * @param chainId - The chain ID of the network to enable or disable. Can be either:
+ * - A Hex string (e.g., '0x1' for Ethereum mainnet) for EVM networks
+ * - A CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet, 'solana:mainnet' for Solana)
+ */
+export type NetworkEnablementControllerEnableNetworkAction = {
+    type: `NetworkEnablementController:enableNetwork`;
+    handler: NetworkEnablementController['enableNetwork'];
+};
+/**
+ * Enables a network for the user within a specific namespace.
+ *
+ * This method accepts either a Hex chain ID (for EVM networks) or a CAIP-2 chain ID
+ * (for any blockchain network) and enables it within the specified namespace.
+ * The method validates that the chainId belongs to the specified namespace for safety.
+ *
+ * Before enabling the target network, this method disables all other networks
+ * in the same namespace to ensure exclusive behavior within the namespace.
+ *
+ * @param chainId - The chain ID of the network to enable. Can be either:
+ * - A Hex string (e.g., '0x1' for Ethereum mainnet) for EVM networks
+ * - A CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet, 'solana:mainnet' for Solana)
+ * @param namespace - The CAIP namespace where the network should be enabled
+ * @throws Error if the chainId's derived namespace doesn't match the provided namespace
+ */
+export type NetworkEnablementControllerEnableNetworkInNamespaceAction = {
+    type: `NetworkEnablementController:enableNetworkInNamespace`;
+    handler: NetworkEnablementController['enableNetworkInNamespace'];
+};
+/**
+ * Enables all popular networks and Solana mainnet.
+ *
+ * This method first disables all networks across all namespaces, then enables
+ * all networks defined in POPULAR_NETWORKS (EVM networks), Solana mainnet, and
+ * Bitcoin mainnet. This provides exclusive behavior - only popular networks will
+ * be enabled after calling this method.
+ *
+ * Popular networks that don't exist in NetworkController or MultichainNetworkController configurations will be skipped silently.
+ */
+export type NetworkEnablementControllerEnableAllPopularNetworksAction = {
+    type: `NetworkEnablementController:enableAllPopularNetworks`;
+    handler: NetworkEnablementController['enableAllPopularNetworks'];
+};
+/**
+ * Initializes the network enablement state from network controller configurations.
+ *
+ * This method reads the current network configurations from both NetworkController
+ * and MultichainNetworkController and syncs the enabled network map and nativeAssetIdentifiers accordingly.
+ * It ensures proper namespace buckets exist for all configured networks and only
+ * adds missing networks with a default value of false, preserving existing user settings.
+ *
+ * This method should be called after the NetworkController and MultichainNetworkController
+ * have been initialized and their configurations are available.
+ */
+export type NetworkEnablementControllerInitAction = {
+    type: `NetworkEnablementController:init`;
+    handler: NetworkEnablementController['init'];
+};
+/**
+ * Initializes the native asset identifiers from network configurations.
+ * This method should be called from the client during controller initialization
+ * to populate the nativeAssetIdentifiers state based on actual network configurations.
+ *
+ * @param networks - Array of network configurations with chainId and nativeCurrency
+ * @example
+ * ```typescript
+ * const evmNetworks = Object.values(networkControllerState.networkConfigurationsByChainId)
+ * .map(config => ({
+ * chainId: toEvmCaipChainId(config.chainId),
+ * nativeCurrency: config.nativeCurrency,
+ * }));
+ *
+ * const multichainNetworks = Object.values(multichainState.multichainNetworkConfigurationsByChainId)
+ * .map(config => ({
+ * chainId: config.chainId,
+ * nativeCurrency: config.nativeCurrency,
+ * }));
+ *
+ * await controller.initNativeAssetIdentifiers([...evmNetworks, ...multichainNetworks]);
+ * ```
+ */
+export type NetworkEnablementControllerInitNativeAssetIdentifiersAction = {
+    type: `NetworkEnablementController:initNativeAssetIdentifiers`;
+    handler: NetworkEnablementController['initNativeAssetIdentifiers'];
+};
+/**
+ * Disables a network for the user.
+ *
+ * This method accepts either a Hex chain ID (for EVM networks) or a CAIP-2 chain ID
+ * (for any blockchain network). The method will automatically convert Hex chain IDs
+ * to CAIP-2 format internally.
+ *
+ * Note: This method will prevent disabling the last remaining enabled network
+ * to ensure at least one network is always available.
+ *
+ * @param chainId - The chain ID of the network to disable. Can be either:
+ * - A Hex string (e.g., '0x1' for Ethereum mainnet) for EVM networks
+ * - A CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet, 'solana:mainnet' for Solana)
+ */
+export type NetworkEnablementControllerDisableNetworkAction = {
+    type: `NetworkEnablementController:disableNetwork`;
+    handler: NetworkEnablementController['disableNetwork'];
+};
+/**
+ * Restores the enabled network map to a previously snapshotted state.
+ *
+ * Not a general merge API: only updates keys already present in the current
+ * map. Missing snapshot values default to `false`. Intended for callers with
+ * direct controller access (e.g. extension) to undo `#onAddNetwork` filter
+ * switches when adding a network without changing the active selection.
+ *
+ * @param enabledNetworkMap - Previously snapshotted enabledNetworkMap.
+ */
+export type NetworkEnablementControllerRestoreEnabledNetworkMapAction = {
+    type: `NetworkEnablementController:restoreEnabledNetworkMap`;
+    handler: NetworkEnablementController['restoreEnabledNetworkMap'];
+};
+/**
+ * Checks if a network is enabled.
+ *
+ * @param chainId - The chain ID of the network to check. Can be either:
+ * - A Hex string (e.g., '0x1' for Ethereum mainnet) for EVM networks
+ * - A CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet, 'solana:mainnet' for Solana)
+ * @returns True if the network is enabled, false otherwise
+ */
+export type NetworkEnablementControllerIsNetworkEnabledAction = {
+    type: `NetworkEnablementController:isNetworkEnabled`;
+    handler: NetworkEnablementController['isNetworkEnabled'];
+};
+/**
+ * Returns popular EVM network chain IDs in hex form, restricted to networks
+ * that exist in NetworkController (networkConfigurationsByChainId). Source is
+ * the bundled `POPULAR_NETWORKS` unioned with registry-featured EVM chains.
+ *
+ * @returns Hex chain IDs for popular EVM networks that are configured.
+ */
+export type NetworkEnablementControllerListPopularEvmNetworksAction = {
+    type: `NetworkEnablementController:listPopularEvmNetworks`;
+    handler: NetworkEnablementController['listPopularEvmNetworks'];
+};
+/**
+ * Returns popular multichain (Bitcoin, Solana, Tron, Stellar) mainnet chain IDs in
+ * CAIP-2 form, restricted to networks that exist in MultichainNetworkController
+ * (multichainNetworkConfigurationsByChainId).
+ *
+ * @returns CAIP-2 chain IDs for Bitcoin, Solana, Tron, and Stellar mainnets that are configured.
+ */
+export type NetworkEnablementControllerListPopularMultichainNetworksAction = {
+    type: `NetworkEnablementController:listPopularMultichainNetworks`;
+    handler: NetworkEnablementController['listPopularMultichainNetworks'];
+};
+/**
+ * Returns the list of popular network chain IDs in CAIP-2 form, restricted to
+ * networks that exist in NetworkController (networkConfigurationsByChainId) and
+ * MultichainNetworkController (multichainNetworkConfigurationsByChainId). EVM
+ * popular networks come from POPULAR_NETWORKS; multichain popular are Bitcoin,
+ * Solana, Tron, and Stellar mainnets.
+ *
+ * @returns CAIP-2 chain IDs for popular EVM networks and multichain mainnets that are configured.
+ */
+export type NetworkEnablementControllerListPopularNetworksAction = {
+    type: `NetworkEnablementController:listPopularNetworks`;
+    handler: NetworkEnablementController['listPopularNetworks'];
+};
+/**
+ * Union of all NetworkEnablementController action types.
+ */
+export type NetworkEnablementControllerMethodActions = NetworkEnablementControllerEnableNetworkAction | NetworkEnablementControllerEnableNetworkInNamespaceAction | NetworkEnablementControllerEnableAllPopularNetworksAction | NetworkEnablementControllerInitAction | NetworkEnablementControllerInitNativeAssetIdentifiersAction | NetworkEnablementControllerDisableNetworkAction | NetworkEnablementControllerRestoreEnabledNetworkMapAction | NetworkEnablementControllerIsNetworkEnabledAction | NetworkEnablementControllerListPopularEvmNetworksAction | NetworkEnablementControllerListPopularMultichainNetworksAction | NetworkEnablementControllerListPopularNetworksAction;
+//# sourceMappingURL=NetworkEnablementController-method-action-types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkEnablementController-method-action-types.d.mts","sourceRoot":"","sources":["../src/NetworkEnablementController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,0CAAyC;AAEpF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,8CAA8C,GAAG;IAC3D,IAAI,EAAE,2CAA2C,CAAC;IAClD,OAAO,EAAE,2BAA2B,CAAC,eAAe,CAAC,CAAC;CACvD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,yDAAyD,GAAG;IACtE,IAAI,EAAE,sDAAsD,CAAC;IAC7D,OAAO,EAAE,2BAA2B,CAAC,0BAA0B,CAAC,CAAC;CAClE,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,yDAAyD,GAAG;IACtE,IAAI,EAAE,sDAAsD,CAAC;IAC7D,OAAO,EAAE,2BAA2B,CAAC,0BAA0B,CAAC,CAAC;CAClE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,2BAA2B,CAAC,MAAM,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,2DAA2D,GAAG;IACxE,IAAI,EAAE,wDAAwD,CAAC;IAC/D,OAAO,EAAE,2BAA2B,CAAC,4BAA4B,CAAC,CAAC;CACpE,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,+CAA+C,GAAG;IAC5D,IAAI,EAAE,4CAA4C,CAAC;IACnD,OAAO,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,CAAC;CACxD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,yDAAyD,GAAG;IACtE,IAAI,EAAE,sDAAsD,CAAC;IAC7D,OAAO,EAAE,2BAA2B,CAAC,0BAA0B,CAAC,CAAC;CAClE,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,iDAAiD,GAAG;IAC9D,IAAI,EAAE,8CAA8C,CAAC;IACrD,OAAO,EAAE,2BAA2B,CAAC,kBAAkB,CAAC,CAAC;CAC1D,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,uDAAuD,GAAG;IACpE,IAAI,EAAE,oDAAoD,CAAC;IAC3D,OAAO,EAAE,2BAA2B,CAAC,wBAAwB,CAAC,CAAC;CAChE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,8DAA8D,GAAG;IAC3E,IAAI,EAAE,2DAA2D,CAAC;IAClE,OAAO,EAAE,2BAA2B,CAAC,+BAA+B,CAAC,CAAC;CACvE,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,oDAAoD,GAAG;IACjE,IAAI,EAAE,iDAAiD,CAAC;IACxD,OAAO,EAAE,2BAA2B,CAAC,qBAAqB,CAAC,CAAC;CAC7D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAChD,8CAA8C,GAC9C,yDAAyD,GACzD,yDAAyD,GACzD,qCAAqC,GACrC,2DAA2D,GAC3D,+CAA+C,GAC/C,yDAAyD,GACzD,iDAAiD,GACjD,uDAAuD,GACvD,8DAA8D,GAC9D,oDAAoD,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkEnablementController-method-action-types.mjs","sourceRoot":"","sources":["../src/NetworkEnablementController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { NetworkEnablementController } from './NetworkEnablementController.js';\n\n/**\n * Enables or disables a network for the user.\n *\n * This method accepts either a Hex chain ID (for EVM networks) or a CAIP-2 chain ID\n * (for any blockchain network). The method will automatically convert Hex chain IDs\n * to CAIP-2 format internally. This dual parameter support allows for backward\n * compatibility with existing EVM chain ID formats while supporting newer\n * multi-chain standards.\n *\n * When enabling a non-popular network, this method will disable all other networks\n * to ensure only one network is active at a time (exclusive mode).\n *\n * @param chainId - The chain ID of the network to enable or disable. Can be either:\n * - A Hex string (e.g., '0x1' for Ethereum mainnet) for EVM networks\n * - A CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet, 'solana:mainnet' for Solana)\n */\nexport type NetworkEnablementControllerEnableNetworkAction = {\n  type: `NetworkEnablementController:enableNetwork`;\n  handler: NetworkEnablementController['enableNetwork'];\n};\n\n/**\n * Enables a network for the user within a specific namespace.\n *\n * This method accepts either a Hex chain ID (for EVM networks) or a CAIP-2 chain ID\n * (for any blockchain network) and enables it within the specified namespace.\n * The method validates that the chainId belongs to the specified namespace for safety.\n *\n * Before enabling the target network, this method disables all other networks\n * in the same namespace to ensure exclusive behavior within the namespace.\n *\n * @param chainId - The chain ID of the network to enable. Can be either:\n * - A Hex string (e.g., '0x1' for Ethereum mainnet) for EVM networks\n * - A CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet, 'solana:mainnet' for Solana)\n * @param namespace - The CAIP namespace where the network should be enabled\n * @throws Error if the chainId's derived namespace doesn't match the provided namespace\n */\nexport type NetworkEnablementControllerEnableNetworkInNamespaceAction = {\n  type: `NetworkEnablementController:enableNetworkInNamespace`;\n  handler: NetworkEnablementController['enableNetworkInNamespace'];\n};\n\n/**\n * Enables all popular networks and Solana mainnet.\n *\n * This method first disables all networks across all namespaces, then enables\n * all networks defined in POPULAR_NETWORKS (EVM networks), Solana mainnet, and\n * Bitcoin mainnet. This provides exclusive behavior - only popular networks will\n * be enabled after calling this method.\n *\n * Popular networks that don't exist in NetworkController or MultichainNetworkController configurations will be skipped silently.\n */\nexport type NetworkEnablementControllerEnableAllPopularNetworksAction = {\n  type: `NetworkEnablementController:enableAllPopularNetworks`;\n  handler: NetworkEnablementController['enableAllPopularNetworks'];\n};\n\n/**\n * Initializes the network enablement state from network controller configurations.\n *\n * This method reads the current network configurations from both NetworkController\n * and MultichainNetworkController and syncs the enabled network map and nativeAssetIdentifiers accordingly.\n * It ensures proper namespace buckets exist for all configured networks and only\n * adds missing networks with a default value of false, preserving existing user settings.\n *\n * This method should be called after the NetworkController and MultichainNetworkController\n * have been initialized and their configurations are available.\n */\nexport type NetworkEnablementControllerInitAction = {\n  type: `NetworkEnablementController:init`;\n  handler: NetworkEnablementController['init'];\n};\n\n/**\n * Initializes the native asset identifiers from network configurations.\n * This method should be called from the client during controller initialization\n * to populate the nativeAssetIdentifiers state based on actual network configurations.\n *\n * @param networks - Array of network configurations with chainId and nativeCurrency\n * @example\n * ```typescript\n * const evmNetworks = Object.values(networkControllerState.networkConfigurationsByChainId)\n * .map(config => ({\n * chainId: toEvmCaipChainId(config.chainId),\n * nativeCurrency: config.nativeCurrency,\n * }));\n *\n * const multichainNetworks = Object.values(multichainState.multichainNetworkConfigurationsByChainId)\n * .map(config => ({\n * chainId: config.chainId,\n * nativeCurrency: config.nativeCurrency,\n * }));\n *\n * await controller.initNativeAssetIdentifiers([...evmNetworks, ...multichainNetworks]);\n * ```\n */\nexport type NetworkEnablementControllerInitNativeAssetIdentifiersAction = {\n  type: `NetworkEnablementController:initNativeAssetIdentifiers`;\n  handler: NetworkEnablementController['initNativeAssetIdentifiers'];\n};\n\n/**\n * Disables a network for the user.\n *\n * This method accepts either a Hex chain ID (for EVM networks) or a CAIP-2 chain ID\n * (for any blockchain network). The method will automatically convert Hex chain IDs\n * to CAIP-2 format internally.\n *\n * Note: This method will prevent disabling the last remaining enabled network\n * to ensure at least one network is always available.\n *\n * @param chainId - The chain ID of the network to disable. Can be either:\n * - A Hex string (e.g., '0x1' for Ethereum mainnet) for EVM networks\n * - A CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet, 'solana:mainnet' for Solana)\n */\nexport type NetworkEnablementControllerDisableNetworkAction = {\n  type: `NetworkEnablementController:disableNetwork`;\n  handler: NetworkEnablementController['disableNetwork'];\n};\n\n/**\n * Restores the enabled network map to a previously snapshotted state.\n *\n * Not a general merge API: only updates keys already present in the current\n * map. Missing snapshot values default to `false`. Intended for callers with\n * direct controller access (e.g. extension) to undo `#onAddNetwork` filter\n * switches when adding a network without changing the active selection.\n *\n * @param enabledNetworkMap - Previously snapshotted enabledNetworkMap.\n */\nexport type NetworkEnablementControllerRestoreEnabledNetworkMapAction = {\n  type: `NetworkEnablementController:restoreEnabledNetworkMap`;\n  handler: NetworkEnablementController['restoreEnabledNetworkMap'];\n};\n\n/**\n * Checks if a network is enabled.\n *\n * @param chainId - The chain ID of the network to check. Can be either:\n * - A Hex string (e.g., '0x1' for Ethereum mainnet) for EVM networks\n * - A CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet, 'solana:mainnet' for Solana)\n * @returns True if the network is enabled, false otherwise\n */\nexport type NetworkEnablementControllerIsNetworkEnabledAction = {\n  type: `NetworkEnablementController:isNetworkEnabled`;\n  handler: NetworkEnablementController['isNetworkEnabled'];\n};\n\n/**\n * Returns popular EVM network chain IDs in hex form, restricted to networks\n * that exist in NetworkController (networkConfigurationsByChainId). Source is\n * the bundled `POPULAR_NETWORKS` unioned with registry-featured EVM chains.\n *\n * @returns Hex chain IDs for popular EVM networks that are configured.\n */\nexport type NetworkEnablementControllerListPopularEvmNetworksAction = {\n  type: `NetworkEnablementController:listPopularEvmNetworks`;\n  handler: NetworkEnablementController['listPopularEvmNetworks'];\n};\n\n/**\n * Returns popular multichain (Bitcoin, Solana, Tron, Stellar) mainnet chain IDs in\n * CAIP-2 form, restricted to networks that exist in MultichainNetworkController\n * (multichainNetworkConfigurationsByChainId).\n *\n * @returns CAIP-2 chain IDs for Bitcoin, Solana, Tron, and Stellar mainnets that are configured.\n */\nexport type NetworkEnablementControllerListPopularMultichainNetworksAction = {\n  type: `NetworkEnablementController:listPopularMultichainNetworks`;\n  handler: NetworkEnablementController['listPopularMultichainNetworks'];\n};\n\n/**\n * Returns the list of popular network chain IDs in CAIP-2 form, restricted to\n * networks that exist in NetworkController (networkConfigurationsByChainId) and\n * MultichainNetworkController (multichainNetworkConfigurationsByChainId). EVM\n * popular networks come from POPULAR_NETWORKS; multichain popular are Bitcoin,\n * Solana, Tron, and Stellar mainnets.\n *\n * @returns CAIP-2 chain IDs for popular EVM networks and multichain mainnets that are configured.\n */\nexport type NetworkEnablementControllerListPopularNetworksAction = {\n  type: `NetworkEnablementController:listPopularNetworks`;\n  handler: NetworkEnablementController['listPopularNetworks'];\n};\n\n/**\n * Union of all NetworkEnablementController action types.\n */\nexport type NetworkEnablementControllerMethodActions =\n  | NetworkEnablementControllerEnableNetworkAction\n  | NetworkEnablementControllerEnableNetworkInNamespaceAction\n  | NetworkEnablementControllerEnableAllPopularNetworksAction\n  | NetworkEnablementControllerInitAction\n  | NetworkEnablementControllerInitNativeAssetIdentifiersAction\n  | NetworkEnablementControllerDisableNetworkAction\n  | NetworkEnablementControllerRestoreEnabledNetworkMapAction\n  | NetworkEnablementControllerIsNetworkEnabledAction\n  | NetworkEnablementControllerListPopularEvmNetworksAction\n  | NetworkEnablementControllerListPopularMultichainNetworksAction\n  | NetworkEnablementControllerListPopularNetworksAction;\n"]}