@metamask-previews/network-enablement-controller 0.1.0-preview-037d305

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,8DAAkD,CAAA;IAClD,+DAAmD,CAAA;IACnD,+DAAmD,CAAA;AACrD,CAAC,EAJW,QAAQ,wBAAR,QAAQ,QAInB","sourcesContent":["/**\n * Scopes for Solana account type. See {@link KeyringAccount.scopes}.\n */\nexport enum SolScope {\n  Devnet = 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',\n  Mainnet = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n  Testnet = 'solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z',\n}\n"]}

package/dist/types.d.cts

@@ -0,0 +1,9 @@
+/**
+ * Scopes for Solana account type. See {@link KeyringAccount.scopes}.
+ */
+export declare enum SolScope {
+    Devnet = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
+    Mainnet = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+    Testnet = "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z"
+}
+//# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAClB,MAAM,4CAA4C;IAClD,OAAO,4CAA4C;IACnD,OAAO,4CAA4C;CACpD"}

package/dist/types.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Scopes for Solana account type. See {@link KeyringAccount.scopes}.
+ */
+export declare enum SolScope {
+    Devnet = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
+    Mainnet = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+    Testnet = "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z"
+}
+//# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAClB,MAAM,4CAA4C;IAClD,OAAO,4CAA4C;IACnD,OAAO,4CAA4C;CACpD"}

package/dist/types.mjs

@@ -0,0 +1,10 @@
+/**
+ * Scopes for Solana account type. See {@link KeyringAccount.scopes}.
+ */
+export var SolScope;
+(function (SolScope) {
+    SolScope["Devnet"] = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
+    SolScope["Mainnet"] = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+    SolScope["Testnet"] = "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z";
+})(SolScope || (SolScope = {}));
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,8DAAkD,CAAA;IAClD,+DAAmD,CAAA;IACnD,+DAAmD,CAAA;AACrD,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB","sourcesContent":["/**\n * Scopes for Solana account type. See {@link KeyringAccount.scopes}.\n */\nexport enum SolScope {\n  Devnet = 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',\n  Mainnet = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n  Testnet = 'solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z',\n}\n"]}

package/dist/utils.cjs

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPopularNetwork = exports.isOnlyNetworkEnabledInNamespace = exports.deriveKeys = void 0;
+const controller_utils_1 = require("@metamask/controller-utils");
+const multichain_network_controller_1 = require("@metamask/multichain-network-controller");
+const utils_1 = require("@metamask/utils");
+const constants_1 = require("./constants.cjs");
+/**
+ * Derives the namespace, storage key, and CAIP chain ID from a given chain ID.
+ *
+ * This utility function handles the conversion between different chain ID formats.
+ * For EVM networks, it converts Hex chain IDs to CAIP-2 format and determines
+ * the appropriate storage key. For non-EVM networks, it parses the CAIP-2 chain ID
+ * and uses the full chain ID as the storage key.
+ *
+ * @param chainId - The chain ID to derive keys from (Hex or CAIP-2 format)
+ * @returns An object containing namespace, storageKey, and caipId
+ * @throws Error if the chain ID cannot be parsed
+ */
+function deriveKeys(chainId) {
+    const caipChainId = (0, utils_1.isCaipChainId)(chainId)
+        ? chainId
+        : (0, multichain_network_controller_1.toEvmCaipChainId)(chainId);
+    const { namespace, reference } = (0, utils_1.parseCaipChainId)(caipChainId);
+    let storageKey;
+    if (namespace === utils_1.KnownCaipNamespace.Eip155) {
+        storageKey = (0, utils_1.isHexString)(chainId) ? chainId : (0, controller_utils_1.toHex)(reference);
+    }
+    else {
+        storageKey = caipChainId;
+    }
+    return { namespace, storageKey, caipChainId, reference };
+}
+exports.deriveKeys = deriveKeys;
+/**
+ * Checks if the specified network is the only enabled network in its namespace.
+ *
+ * This function is used to prevent unnecessary state updates when trying to enable
+ * This method is used to prevent the last network in a namespace from being removed.
+ *
+ * @param state - The current controller state
+ * @param derivedKeys - The parsed keys object containing namespace and storageKey
+ * @returns True if the network is the only enabled network in the namespace, false otherwise
+ */
+function isOnlyNetworkEnabledInNamespace(state, derivedKeys) {
+    const { namespace, storageKey } = derivedKeys;
+    // Early return if namespace doesn't exist
+    if (!state.enabledNetworkMap[namespace]) {
+        return false;
+    }
+    const networks = state.enabledNetworkMap[namespace];
+    // Get all enabled networks in this namespace
+    const enabledNetworks = Object.entries(networks).filter(([_, enabled]) => enabled);
+    // Check if there's exactly one enabled network and it matches our target
+    if (enabledNetworks.length === 1) {
+        const [onlyEnabledKey] = enabledNetworks[0];
+        return onlyEnabledKey === storageKey;
+    }
+    // Return false if there are zero or multiple enabled networks
+    return false;
+}
+exports.isOnlyNetworkEnabledInNamespace = isOnlyNetworkEnabledInNamespace;
+/**
+ * Checks if a network is considered popular based on its reference.
+ *
+ * @param reference - The network reference (typically the chain ID reference part)
+ * @returns True if the network is popular, false otherwise
+ */
+function isPopularNetwork(reference) {
+    try {
+        return constants_1.POPULAR_NETWORKS.includes((0, controller_utils_1.toHex)(reference));
+    }
+    catch {
+        // If toHex fails (e.g., for non-decimal references like Bitcoin hashes),
+        // the network is not popular
+        return false;
+    }
+}
+exports.isPopularNetwork = isPopularNetwork;
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;AAAA,iEAAmD;AACnD,2FAA2E;AAE3E,2CAKyB;AAEzB,+CAA+C;AAa/C;;;;;;;;;;;GAWG;AACH,SAAgB,UAAU,CAAC,OAA0B;IACnD,MAAM,WAAW,GAAG,IAAA,qBAAa,EAAC,OAAO,CAAC;QACxC,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,IAAA,gDAAgB,EAAC,OAAO,CAAC,CAAC;IAE9B,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAA,wBAAgB,EAAC,WAAW,CAAC,CAAC;IAC/D,IAAI,UAAU,CAAC;IACf,IAAI,SAAS,KAAM,0BAAkB,CAAC,MAAiB,EAAE;QACvD,UAAU,GAAG,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAA,wBAAK,EAAC,SAAS,CAAC,CAAC;KAChE;SAAM;QACL,UAAU,GAAG,WAAW,CAAC;KAC1B;IACD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAC3D,CAAC;AAbD,gCAaC;AAED;;;;;;;;;GASG;AACH,SAAgB,+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;QACvC,OAAO,KAAK,CAAC;KACd;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;QAChC,MAAM,CAAC,cAAc,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QAC5C,OAAO,cAAc,KAAK,UAAU,CAAC;KACtC;IAED,8DAA8D;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC;AA1BD,0EA0BC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,SAAiB;IAChD,IAAI;QACF,OAAO,4BAAgB,CAAC,QAAQ,CAAC,IAAA,wBAAK,EAAC,SAAS,CAAC,CAAC,CAAC;KACpD;IAAC,MAAM;QACN,yEAAyE;QACzE,6BAA6B;QAC7B,OAAO,KAAK,CAAC;KACd;AACH,CAAC;AARD,4CAQC","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 { POPULAR_NETWORKS } from './constants';\nimport type { NetworkEnablementControllerState } from './NetworkEnablementController';\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\n/**\n * Checks if a network is considered popular based on its reference.\n *\n * @param reference - The network reference (typically the chain ID reference part)\n * @returns True if the network is popular, false otherwise\n */\nexport function isPopularNetwork(reference: string): boolean {\n  try {\n    return POPULAR_NETWORKS.includes(toHex(reference));\n  } catch {\n    // If toHex fails (e.g., for non-decimal references like Bitcoin hashes),\n    // the network is not popular\n    return false;\n  }\n}\n"]}

package/dist/utils.d.cts

@@ -0,0 +1,43 @@
+import type { CaipChainId, CaipNamespace, Hex } from "@metamask/utils";
+import type { NetworkEnablementControllerState } from "./NetworkEnablementController.cjs";
+/**
+ * Represents the parsed keys derived from a chain ID.
+ */
+export type DerivedKeys = {
+    namespace: CaipNamespace;
+    storageKey: Hex | CaipChainId;
+    caipChainId: CaipChainId;
+    reference: string;
+};
+/**
+ * Derives the namespace, storage key, and CAIP chain ID from a given chain ID.
+ *
+ * This utility function handles the conversion between different chain ID formats.
+ * For EVM networks, it converts Hex chain IDs to CAIP-2 format and determines
+ * the appropriate storage key. For non-EVM networks, it parses the CAIP-2 chain ID
+ * and uses the full chain ID as the storage key.
+ *
+ * @param chainId - The chain ID to derive keys from (Hex or CAIP-2 format)
+ * @returns An object containing namespace, storageKey, and caipId
+ * @throws Error if the chain ID cannot be parsed
+ */
+export declare function deriveKeys(chainId: Hex | CaipChainId): DerivedKeys;
+/**
+ * Checks if the specified network is the only enabled network in its namespace.
+ *
+ * This function is used to prevent unnecessary state updates when trying to enable
+ * This method is used to prevent the last network in a namespace from being removed.
+ *
+ * @param state - The current controller state
+ * @param derivedKeys - The parsed keys object containing namespace and storageKey
+ * @returns True if the network is the only enabled network in the namespace, false otherwise
+ */
+export declare function isOnlyNetworkEnabledInNamespace(state: NetworkEnablementControllerState, derivedKeys: DerivedKeys): boolean;
+/**
+ * Checks if a network is considered popular based on its reference.
+ *
+ * @param reference - The network reference (typically the chain ID reference part)
+ * @returns True if the network is popular, false otherwise
+ */
+export declare function isPopularNetwork(reference: string): boolean;
+//# sourceMappingURL=utils.d.cts.map

package/dist/utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,EAAE,wBAAwB;AASvE,OAAO,KAAK,EAAE,gCAAgC,EAAE,0CAAsC;AAEtF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,GAAG,GAAG,WAAW,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,WAAW,GAAG,WAAW,CAalE;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,gCAAgC,EACvC,WAAW,EAAE,WAAW,GACvB,OAAO,CAuBT;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAQ3D"}

package/dist/utils.d.mts

@@ -0,0 +1,43 @@
+import type { CaipChainId, CaipNamespace, Hex } from "@metamask/utils";
+import type { NetworkEnablementControllerState } from "./NetworkEnablementController.mjs";
+/**
+ * Represents the parsed keys derived from a chain ID.
+ */
+export type DerivedKeys = {
+    namespace: CaipNamespace;
+    storageKey: Hex | CaipChainId;
+    caipChainId: CaipChainId;
+    reference: string;
+};
+/**
+ * Derives the namespace, storage key, and CAIP chain ID from a given chain ID.
+ *
+ * This utility function handles the conversion between different chain ID formats.
+ * For EVM networks, it converts Hex chain IDs to CAIP-2 format and determines
+ * the appropriate storage key. For non-EVM networks, it parses the CAIP-2 chain ID
+ * and uses the full chain ID as the storage key.
+ *
+ * @param chainId - The chain ID to derive keys from (Hex or CAIP-2 format)
+ * @returns An object containing namespace, storageKey, and caipId
+ * @throws Error if the chain ID cannot be parsed
+ */
+export declare function deriveKeys(chainId: Hex | CaipChainId): DerivedKeys;
+/**
+ * Checks if the specified network is the only enabled network in its namespace.
+ *
+ * This function is used to prevent unnecessary state updates when trying to enable
+ * This method is used to prevent the last network in a namespace from being removed.
+ *
+ * @param state - The current controller state
+ * @param derivedKeys - The parsed keys object containing namespace and storageKey
+ * @returns True if the network is the only enabled network in the namespace, false otherwise
+ */
+export declare function isOnlyNetworkEnabledInNamespace(state: NetworkEnablementControllerState, derivedKeys: DerivedKeys): boolean;
+/**
+ * Checks if a network is considered popular based on its reference.
+ *
+ * @param reference - The network reference (typically the chain ID reference part)
+ * @returns True if the network is popular, false otherwise
+ */
+export declare function isPopularNetwork(reference: string): boolean;
+//# sourceMappingURL=utils.d.mts.map

package/dist/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,EAAE,wBAAwB;AASvE,OAAO,KAAK,EAAE,gCAAgC,EAAE,0CAAsC;AAEtF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,GAAG,GAAG,WAAW,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,WAAW,GAAG,WAAW,CAalE;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,gCAAgC,EACvC,WAAW,EAAE,WAAW,GACvB,OAAO,CAuBT;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAQ3D"}

package/dist/utils.mjs

@@ -0,0 +1,74 @@
+import { toHex } from "@metamask/controller-utils";
+import { toEvmCaipChainId } from "@metamask/multichain-network-controller";
+import { isCaipChainId, isHexString, KnownCaipNamespace, parseCaipChainId } from "@metamask/utils";
+import { POPULAR_NETWORKS } from "./constants.mjs";
+/**
+ * Derives the namespace, storage key, and CAIP chain ID from a given chain ID.
+ *
+ * This utility function handles the conversion between different chain ID formats.
+ * For EVM networks, it converts Hex chain IDs to CAIP-2 format and determines
+ * the appropriate storage key. For non-EVM networks, it parses the CAIP-2 chain ID
+ * and uses the full chain ID as the storage key.
+ *
+ * @param chainId - The chain ID to derive keys from (Hex or CAIP-2 format)
+ * @returns An object containing namespace, storageKey, and caipId
+ * @throws Error if the chain ID cannot be parsed
+ */
+export function deriveKeys(chainId) {
+    const caipChainId = isCaipChainId(chainId)
+        ? chainId
+        : toEvmCaipChainId(chainId);
+    const { namespace, reference } = parseCaipChainId(caipChainId);
+    let storageKey;
+    if (namespace === KnownCaipNamespace.Eip155) {
+        storageKey = isHexString(chainId) ? chainId : toHex(reference);
+    }
+    else {
+        storageKey = caipChainId;
+    }
+    return { namespace, storageKey, caipChainId, reference };
+}
+/**
+ * Checks if the specified network is the only enabled network in its namespace.
+ *
+ * This function is used to prevent unnecessary state updates when trying to enable
+ * This method is used to prevent the last network in a namespace from being removed.
+ *
+ * @param state - The current controller state
+ * @param derivedKeys - The parsed keys object containing namespace and storageKey
+ * @returns True if the network is the only enabled network in the namespace, false otherwise
+ */
+export function isOnlyNetworkEnabledInNamespace(state, derivedKeys) {
+    const { namespace, storageKey } = derivedKeys;
+    // Early return if namespace doesn't exist
+    if (!state.enabledNetworkMap[namespace]) {
+        return false;
+    }
+    const networks = state.enabledNetworkMap[namespace];
+    // Get all enabled networks in this namespace
+    const enabledNetworks = Object.entries(networks).filter(([_, enabled]) => enabled);
+    // Check if there's exactly one enabled network and it matches our target
+    if (enabledNetworks.length === 1) {
+        const [onlyEnabledKey] = enabledNetworks[0];
+        return onlyEnabledKey === storageKey;
+    }
+    // Return false if there are zero or multiple enabled networks
+    return false;
+}
+/**
+ * Checks if a network is considered popular based on its reference.
+ *
+ * @param reference - The network reference (typically the chain ID reference part)
+ * @returns True if the network is popular, false otherwise
+ */
+export function isPopularNetwork(reference) {
+    try {
+        return POPULAR_NETWORKS.includes(toHex(reference));
+    }
+    catch {
+        // If toHex fails (e.g., for non-decimal references like Bitcoin hashes),
+        // the network is not popular
+        return false;
+    }
+}
+//# sourceMappingURL=utils.mjs.map

package/dist/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,mCAAmC;AACnD,OAAO,EAAE,gBAAgB,EAAE,gDAAgD;AAE3E,OAAO,EACL,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EACjB,wBAAwB;AAEzB,OAAO,EAAE,gBAAgB,EAAE,wBAAoB;AAa/C;;;;;;;;;;;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;QACvD,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;KAChE;SAAM;QACL,UAAU,GAAG,WAAW,CAAC;KAC1B;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;QACvC,OAAO,KAAK,CAAC;KACd;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;QAChC,MAAM,CAAC,cAAc,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QAC5C,OAAO,cAAc,KAAK,UAAU,CAAC;KACtC;IAED,8DAA8D;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,IAAI;QACF,OAAO,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;KACpD;IAAC,MAAM;QACN,yEAAyE;QACzE,6BAA6B;QAC7B,OAAO,KAAK,CAAC;KACd;AACH,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 { POPULAR_NETWORKS } from './constants';\nimport type { NetworkEnablementControllerState } from './NetworkEnablementController';\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\n/**\n * Checks if a network is considered popular based on its reference.\n *\n * @param reference - The network reference (typically the chain ID reference part)\n * @returns True if the network is popular, false otherwise\n */\nexport function isPopularNetwork(reference: string): boolean {\n  try {\n    return POPULAR_NETWORKS.includes(toHex(reference));\n  } catch {\n    // If toHex fails (e.g., for non-decimal references like Bitcoin hashes),\n    // the network is not popular\n    return false;\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@metamask-previews/network-enablement-controller",
+  "version": "0.1.0-preview-037d305",
+  "description": "Provides an interface to the currently enabled network using a MetaMask-compatible provider object",
+  "keywords": [
+    "MetaMask",
+    "Ethereum"
+  ],
+  "homepage": "https://github.com/MetaMask/core/tree/main/packages/network-enablement-controller#readme",
+  "bugs": {
+    "url": "https://github.com/MetaMask/core/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MetaMask/core.git"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "ts-bridge --project tsconfig.build.json --verbose --clean --no-references",
+    "build:docs": "typedoc",
+    "changelog:update": "../../scripts/update-changelog.sh @metamask/network-enablement-controller",
+    "changelog:validate": "../../scripts/validate-changelog.sh @metamask/network-enablement-controller",
+    "publish:preview": "yarn npm publish --tag preview",
+    "since-latest-release": "../../scripts/since-latest-release.sh",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest --reporters=jest-silent-reporter",
+    "test:clean": "NODE_OPTIONS=--experimental-vm-modules jest --clearCache",
+    "test:verbose": "NODE_OPTIONS=--experimental-vm-modules jest --verbose",
+    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch"
+  },
+  "devDependencies": {
+    "@metamask/auto-changelog": "^3.4.4",
+    "@metamask/multichain-network-controller": "^0.11.0",
+    "@metamask/network-controller": "^24.0.1",
+    "@types/jest": "^27.4.1",
+    "deepmerge": "^4.2.2",
+    "jest": "^27.5.1",
+    "sinon": "^9.2.4",
+    "ts-jest": "^27.1.4",
+    "typedoc": "^0.24.8",
+    "typedoc-plugin-missing-exports": "^2.0.0",
+    "typescript": "~5.2.2"
+  },
+  "dependencies": {
+    "@metamask/base-controller": "^8.0.1",
+    "@metamask/controller-utils": "^11.11.0",
+    "@metamask/utils": "^11.4.2",
+    "reselect": "^5.1.1"
+  },
+  "peerDependencies": {
+    "@metamask/multichain-network-controller": "^0.11.0",
+    "@metamask/network-controller": "^24.0.0"
+  },
+  "engines": {
+    "node": "^18.18 || >=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}