@metamask-previews/network-enablement-controller 6.0.5-preview-8bfa290fb → 7.0.0-preview-0a30e47

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

@@ -1,6 +1,6 @@
-import { toHex } from "@metamask/controller-utils";
-import { toEvmCaipChainId } from "@metamask/multichain-network-controller";
-import { isCaipChainId, isHexString, KnownCaipNamespace, parseCaipChainId } from "@metamask/utils";
+import { toHex } from '@metamask/controller-utils';
+import { toEvmCaipChainId } from '@metamask/multichain-network-controller';
+import { isCaipChainId, isHexString, KnownCaipNamespace, parseCaipChainId, } from '@metamask/utils';
 /**
  * Derives the namespace, storage key, and CAIP chain ID from a given chain ID.
  *
@@ -54,4 +54,4 @@ export function isOnlyNetworkEnabledInNamespace(state, derivedKeys) {
     // Return false if there are zero or multiple enabled networks
     return false;
 }
-//# sourceMappingURL=utils.mjs.map
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAE3E,OAAO,EACL,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAczB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,OAA0B;IACnD,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC;QACxC,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE9B,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC/D,IAAI,UAAU,CAAC;IACf,IAAI,SAAS,KAAM,kBAAkB,CAAC,MAAiB,EAAE,CAAC;QACxD,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,WAAW,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAAuC,EACvC,WAAwB;IAExB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC;IAE9C,0CAA0C;IAC1C,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAEpD,6CAA6C;IAC7C,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CACrD,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAC1B,CAAC;IAEF,yEAAyE;IACzE,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QAC5C,OAAO,cAAc,KAAK,UAAU,CAAC;IACvC,CAAC;IAED,8DAA8D;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import { toHex } from '@metamask/controller-utils';\nimport { toEvmCaipChainId } from '@metamask/multichain-network-controller';\nimport type { CaipChainId, CaipNamespace, Hex } from '@metamask/utils';\nimport {\n  isCaipChainId,\n  isHexString,\n  KnownCaipNamespace,\n  parseCaipChainId,\n} from '@metamask/utils';\n\nimport type { NetworkEnablementControllerState } from './NetworkEnablementController.js';\n\n/**\n * Represents the parsed keys derived from a chain ID.\n */\nexport type DerivedKeys = {\n  namespace: CaipNamespace;\n  storageKey: Hex | CaipChainId;\n  caipChainId: CaipChainId;\n  reference: string;\n};\n\n/**\n * Derives the namespace, storage key, and CAIP chain ID from a given chain ID.\n *\n * This utility function handles the conversion between different chain ID formats.\n * For EVM networks, it converts Hex chain IDs to CAIP-2 format and determines\n * the appropriate storage key. For non-EVM networks, it parses the CAIP-2 chain ID\n * and uses the full chain ID as the storage key.\n *\n * @param chainId - The chain ID to derive keys from (Hex or CAIP-2 format)\n * @returns An object containing namespace, storageKey, and caipId\n * @throws Error if the chain ID cannot be parsed\n */\nexport function deriveKeys(chainId: Hex | CaipChainId): DerivedKeys {\n  const caipChainId = isCaipChainId(chainId)\n    ? chainId\n    : toEvmCaipChainId(chainId);\n\n  const { namespace, reference } = parseCaipChainId(caipChainId);\n  let storageKey;\n  if (namespace === (KnownCaipNamespace.Eip155 as string)) {\n    storageKey = isHexString(chainId) ? chainId : toHex(reference);\n  } else {\n    storageKey = caipChainId;\n  }\n  return { namespace, storageKey, caipChainId, reference };\n}\n\n/**\n * Checks if the specified network is the only enabled network in its namespace.\n *\n * This function is used to prevent unnecessary state updates when trying to enable\n * This method is used to prevent the last network in a namespace from being removed.\n *\n * @param state - The current controller state\n * @param derivedKeys - The parsed keys object containing namespace and storageKey\n * @returns True if the network is the only enabled network in the namespace, false otherwise\n */\nexport function isOnlyNetworkEnabledInNamespace(\n  state: NetworkEnablementControllerState,\n  derivedKeys: DerivedKeys,\n): boolean {\n  const { namespace, storageKey } = derivedKeys;\n\n  // Early return if namespace doesn't exist\n  if (!state.enabledNetworkMap[namespace]) {\n    return false;\n  }\n\n  const networks = state.enabledNetworkMap[namespace];\n\n  // Get all enabled networks in this namespace\n  const enabledNetworks = Object.entries(networks).filter(\n    ([_, enabled]) => enabled,\n  );\n\n  // Check if there's exactly one enabled network and it matches our target\n  if (enabledNetworks.length === 1) {\n    const [onlyEnabledKey] = enabledNetworks[0];\n    return onlyEnabledKey === storageKey;\n  }\n\n  // Return false if there are zero or multiple enabled networks\n  return false;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/network-enablement-controller",
-  "version": "6.0.5-preview-8bfa290fb",
+  "version": "7.0.0-preview-0a30e47",
   "description": "Provides an interface to the currently enabled network using a MetaMask-compatible provider object",
   "keywords": [
     "Ethereum",
@@ -18,19 +18,12 @@
   "files": [
     "dist/"
   ],
+  "type": "module",
   "sideEffects": false,
-  "main": "./dist/index.cjs",
-  "types": "./dist/index.d.cts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.mts",
-        "default": "./dist/index.mjs"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     },
     "./package.json": "./package.json"
   },
@@ -39,9 +32,11 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build": "ts-bridge --project tsconfig.build.json --verbose --clean --no-references",
-    "build:all": "ts-bridge --project tsconfig.build.json --verbose --clean",
+    "build": "tsc --project tsconfig.build.json",
+    "build:all": "tsc --build tsconfig.build.json --verbose",
+    "build:clean": "yarn build:only-clean && yarn build",
     "build:docs": "typedoc",
+    "build:only-clean": "rimraf './dist' './tsconfig.build.tsbuildinfo'",
     "changelog:update": "../../scripts/update-changelog.sh @metamask/network-enablement-controller",
     "changelog:validate": "../../scripts/validate-changelog.sh @metamask/network-enablement-controller",
     "lint:tsconfigs": "tsx ../../scripts/lint-tsconfigs/lint-tsconfigs.mts",
@@ -55,31 +50,32 @@
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch"
   },
   "dependencies": {
-    "@metamask/base-controller": "^9.1.0",
-    "@metamask/config-registry-controller": "^3.1.0",
-    "@metamask/controller-utils": "^12.3.0",
+    "@metamask/base-controller": "^10.0.0",
+    "@metamask/config-registry-controller": "^4.0.0",
+    "@metamask/controller-utils": "^13.0.0",
     "@metamask/keyring-api": "^24.0.0",
-    "@metamask/messenger": "^2.0.0",
-    "@metamask/multichain-network-controller": "^3.2.4",
-    "@metamask/network-controller": "^36.0.0",
+    "@metamask/messenger": "^3.0.0",
+    "@metamask/multichain-network-controller": "^4.0.0",
+    "@metamask/network-controller": "^37.0.0",
     "@metamask/slip44": "^4.3.0",
-    "@metamask/transaction-controller": "^69.7.0",
+    "@metamask/transaction-controller": "^70.0.0",
     "@metamask/utils": "^11.12.0",
     "reselect": "^5.1.1"
   },
   "devDependencies": {
     "@metamask/auto-changelog": "^6.1.0",
-    "@ts-bridge/cli": "^0.6.4",
     "@types/jest": "^30.0.0",
+    "@typescript/native": "npm:typescript@^7.0.2",
     "deepmerge": "^4.2.2",
     "jest": "^30.4.2",
+    "rimraf": "^5.0.5",
     "ts-jest": "^29.4.11",
     "tsx": "^4.20.5",
     "typedoc": "^0.25.13",
     "typedoc-plugin-missing-exports": "^2.0.0",
-    "typescript": "~5.3.3"
+    "typescript": "npm:@typescript/typescript6@^6.0.2"
   },
   "engines": {
-    "node": "^18.18 || >=20"
+    "node": "^22.14.0 || ^24"
   }
 }

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

@@ -1,7 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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.cts

@@ -1,185 +0,0 @@
-/**
- * This file is auto generated.
- * Do not edit manually.
- */
-import type { NetworkEnablementController } from "./NetworkEnablementController.cjs";
-/**
- * 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.cts.map

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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.mjs.map

@@ -1 +0,0 @@
-{"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"]}