@metamask-previews/chain-agnostic-permission 0.2.0-preview-57dc1075 → 0.3.0-preview-b0b2930

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0]
+
+### Added
+
+- Export `KnownSessionProperties` enum ([#5522](https://github.com/MetaMask/core/pull/5522))
+- Add more chain agnostic utility functions for interfacing w/ caip25 permission ([#5536](https://github.com/MetaMask/core/pull/5536))
+  - New `setPermittedAccounts` function that allows setting accounts for any CAIP namespace, not just EVM scopes.
+  - New `addPermittedChainId` and `setPermittedChainIds` functions for managing permitted chains across any CAIP namespace.
+  - New `generateCaip25Caveat` function to generate a valid `endowment:caip25` permission caveat from given accounts and chains of any CAIP namespace.
+  - New `isWalletScope` utility function to detect wallet-related scopes.
+
+### Changed
+
+- **BREAKING:** An error is now thrown in the caveat validator when a `caip25:endowment` permission caveat has no scopes in either `requiredScopes` or `optionalScopes` ([#5548](https://github.com/MetaMask/core/pull/5548))
+
 ## [0.2.0]
 
 ### Added
@@ -28,6 +43,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial release
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/chain-agnostic-permission@0.2.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/chain-agnostic-permission@0.3.0...HEAD
+[0.3.0]: https://github.com/MetaMask/core/compare/@metamask/chain-agnostic-permission@0.2.0...@metamask/chain-agnostic-permission@0.3.0
 [0.2.0]: https://github.com/MetaMask/core/compare/@metamask/chain-agnostic-permission@0.1.0...@metamask/chain-agnostic-permission@0.2.0
 [0.1.0]: https://github.com/MetaMask/core/releases/tag/@metamask/chain-agnostic-permission@0.1.0

package/dist/adapters/{caip-permission-adapter-eth-accounts.cjs → caip-permission-adapter-accounts.cjs}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setEthAccounts = exports.getEthAccounts = void 0;
+exports.setPermittedAccounts = exports.setEthAccounts = exports.getEthAccounts = void 0;
 const utils_1 = require("@metamask/utils");
 const constants_1 = require("../scope/constants.cjs");
 const transform_1 = require("../scope/transform.cjs");
@@ -100,4 +100,52 @@ const setEthAccounts = (caip25CaveatValue, accounts) => {
     };
 };
 exports.setEthAccounts = setEthAccounts;
-//# sourceMappingURL=caip-permission-adapter-eth-accounts.cjs.map
+/**
+ * Sets the permitted accounts to scopes with matching namespaces in the given scopes object.
+ *
+ * @param scopesObject - The scopes object to set the permitted accounts for.
+ * @param accounts - The permitted accounts to add to the appropriate scopes.
+ * @returns The updated scopes object with the permitted accounts set.
+ */
+const setPermittedAccountsForScopesObject = (scopesObject, accounts) => {
+    const updatedScopesObject = {};
+    Object.entries(scopesObject).forEach(([key, scopeObject]) => {
+        // Cast needed because index type is returned as `string` by `Object.entries`
+        const scopeString = key;
+        const { namespace, reference } = (0, types_1.parseScopeString)(scopeString);
+        let caipAccounts = [];
+        if (namespace && reference) {
+            caipAccounts = accounts.reduce((acc, account) => {
+                const { chain: { namespace: accountNamespace }, address: accountAddress, } = (0, utils_1.parseCaipAccountId)(account);
+                // If the account namespace is the same as the scope namespace, add the account to the scope
+                // This will, for example, distribute all EIP155 accounts, regardless of reference, to all EIP155 scopes
+                if (namespace === accountNamespace) {
+                    acc.push(`${namespace}:${reference}:${accountAddress}`);
+                }
+                return acc;
+            }, []);
+        }
+        const uniqueCaipAccounts = (0, transform_1.getUniqueArrayItems)(caipAccounts);
+        updatedScopesObject[scopeString] = {
+            ...scopeObject,
+            accounts: uniqueCaipAccounts,
+        };
+    });
+    return updatedScopesObject;
+};
+/**
+ * Sets the permitted accounts to scopes with matching namespaces in the given CAIP-25 caveat value.
+ *
+ * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted accounts for.
+ * @param accounts - The permitted accounts to add to the appropriate scopes.
+ * @returns The updated CAIP-25 caveat value with the permitted accounts set.
+ */
+const setPermittedAccounts = (caip25CaveatValue, accounts) => {
+    return {
+        ...caip25CaveatValue,
+        requiredScopes: setPermittedAccountsForScopesObject(caip25CaveatValue.requiredScopes, accounts),
+        optionalScopes: setPermittedAccountsForScopesObject(caip25CaveatValue.optionalScopes, accounts),
+    };
+};
+exports.setPermittedAccounts = setPermittedAccounts;
+//# sourceMappingURL=caip-permission-adapter-accounts.cjs.map

package/dist/adapters/caip-permission-adapter-accounts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip-permission-adapter-accounts.cjs","sourceRoot":"","sources":["../../src/adapters/caip-permission-adapter-accounts.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  assertIsStrictHexString,\n  type CaipAccountId,\n  type Hex,\n  KnownCaipNamespace,\n  parseCaipAccountId,\n} from '@metamask/utils';\n\nimport type { Caip25CaveatValue } from '../caip25Permission';\nimport { KnownWalletScopeString } from '../scope/constants';\nimport { getUniqueArrayItems } from '../scope/transform';\nimport type { InternalScopeString, InternalScopesObject } from '../scope/types';\nimport { parseScopeString } from '../scope/types';\n\n/**\n * Checks if a scope string is either an EIP155 or wallet namespaced scope string.\n *\n * @param scopeString - The scope string to check.\n * @returns True if the scope string is an EIP155 or wallet namespaced scope string, false otherwise.\n */\nconst isEip155ScopeString = (scopeString: InternalScopeString) => {\n  const { namespace } = parseScopeString(scopeString);\n\n  return (\n    namespace === KnownCaipNamespace.Eip155 ||\n    // We are trying to discern the type of `scopeString`.\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-enum-comparison\n    scopeString === KnownWalletScopeString.Eip155\n  );\n};\n\n/**\n * Gets the Ethereum (EIP155 namespaced) accounts from internal scopes.\n *\n * @param scopes - The internal scopes from which to get the Ethereum accounts.\n * @returns An array of Ethereum accounts.\n */\nconst getEthAccountsFromScopes = (scopes: InternalScopesObject) => {\n  const ethAccounts: Hex[] = [];\n\n  Object.entries(scopes).forEach(([_, { accounts }]) => {\n    accounts?.forEach((account) => {\n      const { address, chainId } = parseCaipAccountId(account);\n\n      if (isEip155ScopeString(chainId)) {\n        // This address should always be a valid Hex string because\n        // it's an EIP155/Ethereum account\n        assertIsStrictHexString(address);\n        ethAccounts.push(address);\n      }\n    });\n  });\n\n  return ethAccounts;\n};\n\n/**\n * Gets the Ethereum (EIP155 namespaced) accounts from the required and optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to get the Ethereum accounts from.\n * @returns An array of Ethereum accounts.\n */\nexport const getEthAccounts = (\n  caip25CaveatValue: Pick<\n    Caip25CaveatValue,\n    'requiredScopes' | 'optionalScopes'\n  >,\n): Hex[] => {\n  const { requiredScopes, optionalScopes } = caip25CaveatValue;\n\n  const ethAccounts: Hex[] = [\n    ...getEthAccountsFromScopes(requiredScopes),\n    ...getEthAccountsFromScopes(optionalScopes),\n  ];\n\n  return getUniqueArrayItems(ethAccounts);\n};\n\n/**\n * Sets the Ethereum (EIP155 namespaced) accounts for the given scopes object.\n *\n * @param scopesObject - The scopes object to set the Ethereum accounts for.\n * @param accounts - The Ethereum accounts to set.\n * @returns The updated scopes object with the Ethereum accounts set.\n */\nconst setEthAccountsForScopesObject = (\n  scopesObject: InternalScopesObject,\n  accounts: Hex[],\n) => {\n  const updatedScopesObject: InternalScopesObject = {};\n  Object.entries(scopesObject).forEach(([key, scopeObject]) => {\n    // Cast needed because index type is returned as `string` by `Object.entries`\n    const scopeString = key as keyof typeof scopesObject;\n    const isWalletNamespace = scopeString === KnownCaipNamespace.Wallet;\n    const { namespace, reference } = parseScopeString(scopeString);\n    if (!isEip155ScopeString(scopeString) && !isWalletNamespace) {\n      updatedScopesObject[scopeString] = scopeObject;\n      return;\n    }\n\n    let caipAccounts: CaipAccountId[] = [];\n    if (namespace && reference) {\n      caipAccounts = accounts.map<CaipAccountId>(\n        (account) => `${namespace}:${reference}:${account}`,\n      );\n    }\n\n    updatedScopesObject[scopeString] = {\n      ...scopeObject,\n      accounts: caipAccounts,\n    };\n  });\n\n  return updatedScopesObject;\n};\n\n/**\n * Sets the Ethereum (EIP155 namespaced) accounts for the given CAIP-25 caveat value.\n * We set the same accounts for all the scopes that are EIP155 or Wallet namespaced because\n * we do not provide UI/UX flows for selecting different accounts across different chains.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to set the Ethereum accounts for.\n * @param accounts - The Ethereum accounts to set.\n * @returns The updated CAIP-25 caveat value with the Ethereum accounts set.\n */\nexport const setEthAccounts = (\n  caip25CaveatValue: Caip25CaveatValue,\n  accounts: Hex[],\n): Caip25CaveatValue => {\n  return {\n    ...caip25CaveatValue,\n    requiredScopes: setEthAccountsForScopesObject(\n      caip25CaveatValue.requiredScopes,\n      accounts,\n    ),\n    optionalScopes: setEthAccountsForScopesObject(\n      caip25CaveatValue.optionalScopes,\n      accounts,\n    ),\n  };\n};\n\n/**\n * Sets the permitted accounts to scopes with matching namespaces in the given scopes object.\n *\n * @param scopesObject - The scopes object to set the permitted accounts for.\n * @param accounts - The permitted accounts to add to the appropriate scopes.\n * @returns The updated scopes object with the permitted accounts set.\n */\nconst setPermittedAccountsForScopesObject = (\n  scopesObject: InternalScopesObject,\n  accounts: CaipAccountId[],\n) => {\n  const updatedScopesObject: InternalScopesObject = {};\n  Object.entries(scopesObject).forEach(([key, scopeObject]) => {\n    // Cast needed because index type is returned as `string` by `Object.entries`\n    const scopeString = key as keyof typeof scopesObject;\n    const { namespace, reference } = parseScopeString(scopeString);\n\n    let caipAccounts: CaipAccountId[] = [];\n    if (namespace && reference) {\n      caipAccounts = accounts.reduce<CaipAccountId[]>((acc, account) => {\n        const {\n          chain: { namespace: accountNamespace },\n          address: accountAddress,\n        } = parseCaipAccountId(account);\n        // If the account namespace is the same as the scope namespace, add the account to the scope\n        // This will, for example, distribute all EIP155 accounts, regardless of reference, to all EIP155 scopes\n        if (namespace === accountNamespace) {\n          acc.push(`${namespace}:${reference}:${accountAddress}`);\n        }\n        return acc;\n      }, []);\n    }\n\n    const uniqueCaipAccounts = getUniqueArrayItems(caipAccounts);\n\n    updatedScopesObject[scopeString] = {\n      ...scopeObject,\n      accounts: uniqueCaipAccounts,\n    };\n  });\n\n  return updatedScopesObject;\n};\n\n/**\n * Sets the permitted accounts to scopes with matching namespaces in the given CAIP-25 caveat value.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted accounts for.\n * @param accounts - The permitted accounts to add to the appropriate scopes.\n * @returns The updated CAIP-25 caveat value with the permitted accounts set.\n */\nexport const setPermittedAccounts = (\n  caip25CaveatValue: Caip25CaveatValue,\n  accounts: CaipAccountId[],\n): Caip25CaveatValue => {\n  return {\n    ...caip25CaveatValue,\n    requiredScopes: setPermittedAccountsForScopesObject(\n      caip25CaveatValue.requiredScopes,\n      accounts,\n    ),\n    optionalScopes: setPermittedAccountsForScopesObject(\n      caip25CaveatValue.optionalScopes,\n      accounts,\n    ),\n  };\n};\n"]}

package/dist/adapters/{caip-permission-adapter-eth-accounts.d.cts → caip-permission-adapter-accounts.d.cts}

@@ -1,4 +1,4 @@
-import { type Hex } from "@metamask/utils";
+import { type CaipAccountId, type Hex } from "@metamask/utils";
 import type { Caip25CaveatValue } from "../caip25Permission.cjs";
 /**
  * Gets the Ethereum (EIP155 namespaced) accounts from the required and optional scopes.
@@ -17,4 +17,12 @@ export declare const getEthAccounts: (caip25CaveatValue: Pick<Caip25CaveatValue,
  * @returns The updated CAIP-25 caveat value with the Ethereum accounts set.
  */
 export declare const setEthAccounts: (caip25CaveatValue: Caip25CaveatValue, accounts: Hex[]) => Caip25CaveatValue;
-//# sourceMappingURL=caip-permission-adapter-eth-accounts.d.cts.map
+/**
+ * Sets the permitted accounts to scopes with matching namespaces in the given CAIP-25 caveat value.
+ *
+ * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted accounts for.
+ * @param accounts - The permitted accounts to add to the appropriate scopes.
+ * @returns The updated CAIP-25 caveat value with the permitted accounts set.
+ */
+export declare const setPermittedAccounts: (caip25CaveatValue: Caip25CaveatValue, accounts: CaipAccountId[]) => Caip25CaveatValue;
+//# sourceMappingURL=caip-permission-adapter-accounts.d.cts.map

package/dist/adapters/caip-permission-adapter-accounts.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip-permission-adapter-accounts.d.cts","sourceRoot":"","sources":["../../src/adapters/caip-permission-adapter-accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,GAAG,EAGT,wBAAwB;AAEzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,gCAA4B;AAgD7D;;;;;GAKG;AACH,eAAO,MAAM,cAAc,sBACN,KACjB,iBAAiB,EACjB,gBAAgB,GAAG,gBAAgB,CACpC,KACA,GAAG,EASL,CAAC;AAwCF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,sBACN,iBAAiB,YAC1B,GAAG,EAAE,KACd,iBAYF,CAAC;AA8CF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,sBACZ,iBAAiB,YAC1B,aAAa,EAAE,KACxB,iBAYF,CAAC"}

package/dist/adapters/{caip-permission-adapter-eth-accounts.d.mts → caip-permission-adapter-accounts.d.mts}

@@ -1,4 +1,4 @@
-import { type Hex } from "@metamask/utils";
+import { type CaipAccountId, type Hex } from "@metamask/utils";
 import type { Caip25CaveatValue } from "../caip25Permission.mjs";
 /**
  * Gets the Ethereum (EIP155 namespaced) accounts from the required and optional scopes.
@@ -17,4 +17,12 @@ export declare const getEthAccounts: (caip25CaveatValue: Pick<Caip25CaveatValue,
  * @returns The updated CAIP-25 caveat value with the Ethereum accounts set.
  */
 export declare const setEthAccounts: (caip25CaveatValue: Caip25CaveatValue, accounts: Hex[]) => Caip25CaveatValue;
-//# sourceMappingURL=caip-permission-adapter-eth-accounts.d.mts.map
+/**
+ * Sets the permitted accounts to scopes with matching namespaces in the given CAIP-25 caveat value.
+ *
+ * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted accounts for.
+ * @param accounts - The permitted accounts to add to the appropriate scopes.
+ * @returns The updated CAIP-25 caveat value with the permitted accounts set.
+ */
+export declare const setPermittedAccounts: (caip25CaveatValue: Caip25CaveatValue, accounts: CaipAccountId[]) => Caip25CaveatValue;
+//# sourceMappingURL=caip-permission-adapter-accounts.d.mts.map

package/dist/adapters/caip-permission-adapter-accounts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip-permission-adapter-accounts.d.mts","sourceRoot":"","sources":["../../src/adapters/caip-permission-adapter-accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,GAAG,EAGT,wBAAwB;AAEzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,gCAA4B;AAgD7D;;;;;GAKG;AACH,eAAO,MAAM,cAAc,sBACN,KACjB,iBAAiB,EACjB,gBAAgB,GAAG,gBAAgB,CACpC,KACA,GAAG,EASL,CAAC;AAwCF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,sBACN,iBAAiB,YAC1B,GAAG,EAAE,KACd,iBAYF,CAAC;AA8CF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,sBACZ,iBAAiB,YAC1B,aAAa,EAAE,KACxB,iBAYF,CAAC"}

package/dist/adapters/{caip-permission-adapter-eth-accounts.mjs → caip-permission-adapter-accounts.mjs}

@@ -95,4 +95,51 @@ export const setEthAccounts = (caip25CaveatValue, accounts) => {
         optionalScopes: setEthAccountsForScopesObject(caip25CaveatValue.optionalScopes, accounts),
     };
 };
-//# sourceMappingURL=caip-permission-adapter-eth-accounts.mjs.map
+/**
+ * Sets the permitted accounts to scopes with matching namespaces in the given scopes object.
+ *
+ * @param scopesObject - The scopes object to set the permitted accounts for.
+ * @param accounts - The permitted accounts to add to the appropriate scopes.
+ * @returns The updated scopes object with the permitted accounts set.
+ */
+const setPermittedAccountsForScopesObject = (scopesObject, accounts) => {
+    const updatedScopesObject = {};
+    Object.entries(scopesObject).forEach(([key, scopeObject]) => {
+        // Cast needed because index type is returned as `string` by `Object.entries`
+        const scopeString = key;
+        const { namespace, reference } = parseScopeString(scopeString);
+        let caipAccounts = [];
+        if (namespace && reference) {
+            caipAccounts = accounts.reduce((acc, account) => {
+                const { chain: { namespace: accountNamespace }, address: accountAddress, } = parseCaipAccountId(account);
+                // If the account namespace is the same as the scope namespace, add the account to the scope
+                // This will, for example, distribute all EIP155 accounts, regardless of reference, to all EIP155 scopes
+                if (namespace === accountNamespace) {
+                    acc.push(`${namespace}:${reference}:${accountAddress}`);
+                }
+                return acc;
+            }, []);
+        }
+        const uniqueCaipAccounts = getUniqueArrayItems(caipAccounts);
+        updatedScopesObject[scopeString] = {
+            ...scopeObject,
+            accounts: uniqueCaipAccounts,
+        };
+    });
+    return updatedScopesObject;
+};
+/**
+ * Sets the permitted accounts to scopes with matching namespaces in the given CAIP-25 caveat value.
+ *
+ * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted accounts for.
+ * @param accounts - The permitted accounts to add to the appropriate scopes.
+ * @returns The updated CAIP-25 caveat value with the permitted accounts set.
+ */
+export const setPermittedAccounts = (caip25CaveatValue, accounts) => {
+    return {
+        ...caip25CaveatValue,
+        requiredScopes: setPermittedAccountsForScopesObject(caip25CaveatValue.requiredScopes, accounts),
+        optionalScopes: setPermittedAccountsForScopesObject(caip25CaveatValue.optionalScopes, accounts),
+    };
+};
+//# sourceMappingURL=caip-permission-adapter-accounts.mjs.map

package/dist/adapters/caip-permission-adapter-accounts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip-permission-adapter-accounts.mjs","sourceRoot":"","sources":["../../src/adapters/caip-permission-adapter-accounts.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  assertIsStrictHexString,\n  type CaipAccountId,\n  type Hex,\n  KnownCaipNamespace,\n  parseCaipAccountId,\n} from '@metamask/utils';\n\nimport type { Caip25CaveatValue } from '../caip25Permission';\nimport { KnownWalletScopeString } from '../scope/constants';\nimport { getUniqueArrayItems } from '../scope/transform';\nimport type { InternalScopeString, InternalScopesObject } from '../scope/types';\nimport { parseScopeString } from '../scope/types';\n\n/**\n * Checks if a scope string is either an EIP155 or wallet namespaced scope string.\n *\n * @param scopeString - The scope string to check.\n * @returns True if the scope string is an EIP155 or wallet namespaced scope string, false otherwise.\n */\nconst isEip155ScopeString = (scopeString: InternalScopeString) => {\n  const { namespace } = parseScopeString(scopeString);\n\n  return (\n    namespace === KnownCaipNamespace.Eip155 ||\n    // We are trying to discern the type of `scopeString`.\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-enum-comparison\n    scopeString === KnownWalletScopeString.Eip155\n  );\n};\n\n/**\n * Gets the Ethereum (EIP155 namespaced) accounts from internal scopes.\n *\n * @param scopes - The internal scopes from which to get the Ethereum accounts.\n * @returns An array of Ethereum accounts.\n */\nconst getEthAccountsFromScopes = (scopes: InternalScopesObject) => {\n  const ethAccounts: Hex[] = [];\n\n  Object.entries(scopes).forEach(([_, { accounts }]) => {\n    accounts?.forEach((account) => {\n      const { address, chainId } = parseCaipAccountId(account);\n\n      if (isEip155ScopeString(chainId)) {\n        // This address should always be a valid Hex string because\n        // it's an EIP155/Ethereum account\n        assertIsStrictHexString(address);\n        ethAccounts.push(address);\n      }\n    });\n  });\n\n  return ethAccounts;\n};\n\n/**\n * Gets the Ethereum (EIP155 namespaced) accounts from the required and optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to get the Ethereum accounts from.\n * @returns An array of Ethereum accounts.\n */\nexport const getEthAccounts = (\n  caip25CaveatValue: Pick<\n    Caip25CaveatValue,\n    'requiredScopes' | 'optionalScopes'\n  >,\n): Hex[] => {\n  const { requiredScopes, optionalScopes } = caip25CaveatValue;\n\n  const ethAccounts: Hex[] = [\n    ...getEthAccountsFromScopes(requiredScopes),\n    ...getEthAccountsFromScopes(optionalScopes),\n  ];\n\n  return getUniqueArrayItems(ethAccounts);\n};\n\n/**\n * Sets the Ethereum (EIP155 namespaced) accounts for the given scopes object.\n *\n * @param scopesObject - The scopes object to set the Ethereum accounts for.\n * @param accounts - The Ethereum accounts to set.\n * @returns The updated scopes object with the Ethereum accounts set.\n */\nconst setEthAccountsForScopesObject = (\n  scopesObject: InternalScopesObject,\n  accounts: Hex[],\n) => {\n  const updatedScopesObject: InternalScopesObject = {};\n  Object.entries(scopesObject).forEach(([key, scopeObject]) => {\n    // Cast needed because index type is returned as `string` by `Object.entries`\n    const scopeString = key as keyof typeof scopesObject;\n    const isWalletNamespace = scopeString === KnownCaipNamespace.Wallet;\n    const { namespace, reference } = parseScopeString(scopeString);\n    if (!isEip155ScopeString(scopeString) && !isWalletNamespace) {\n      updatedScopesObject[scopeString] = scopeObject;\n      return;\n    }\n\n    let caipAccounts: CaipAccountId[] = [];\n    if (namespace && reference) {\n      caipAccounts = accounts.map<CaipAccountId>(\n        (account) => `${namespace}:${reference}:${account}`,\n      );\n    }\n\n    updatedScopesObject[scopeString] = {\n      ...scopeObject,\n      accounts: caipAccounts,\n    };\n  });\n\n  return updatedScopesObject;\n};\n\n/**\n * Sets the Ethereum (EIP155 namespaced) accounts for the given CAIP-25 caveat value.\n * We set the same accounts for all the scopes that are EIP155 or Wallet namespaced because\n * we do not provide UI/UX flows for selecting different accounts across different chains.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to set the Ethereum accounts for.\n * @param accounts - The Ethereum accounts to set.\n * @returns The updated CAIP-25 caveat value with the Ethereum accounts set.\n */\nexport const setEthAccounts = (\n  caip25CaveatValue: Caip25CaveatValue,\n  accounts: Hex[],\n): Caip25CaveatValue => {\n  return {\n    ...caip25CaveatValue,\n    requiredScopes: setEthAccountsForScopesObject(\n      caip25CaveatValue.requiredScopes,\n      accounts,\n    ),\n    optionalScopes: setEthAccountsForScopesObject(\n      caip25CaveatValue.optionalScopes,\n      accounts,\n    ),\n  };\n};\n\n/**\n * Sets the permitted accounts to scopes with matching namespaces in the given scopes object.\n *\n * @param scopesObject - The scopes object to set the permitted accounts for.\n * @param accounts - The permitted accounts to add to the appropriate scopes.\n * @returns The updated scopes object with the permitted accounts set.\n */\nconst setPermittedAccountsForScopesObject = (\n  scopesObject: InternalScopesObject,\n  accounts: CaipAccountId[],\n) => {\n  const updatedScopesObject: InternalScopesObject = {};\n  Object.entries(scopesObject).forEach(([key, scopeObject]) => {\n    // Cast needed because index type is returned as `string` by `Object.entries`\n    const scopeString = key as keyof typeof scopesObject;\n    const { namespace, reference } = parseScopeString(scopeString);\n\n    let caipAccounts: CaipAccountId[] = [];\n    if (namespace && reference) {\n      caipAccounts = accounts.reduce<CaipAccountId[]>((acc, account) => {\n        const {\n          chain: { namespace: accountNamespace },\n          address: accountAddress,\n        } = parseCaipAccountId(account);\n        // If the account namespace is the same as the scope namespace, add the account to the scope\n        // This will, for example, distribute all EIP155 accounts, regardless of reference, to all EIP155 scopes\n        if (namespace === accountNamespace) {\n          acc.push(`${namespace}:${reference}:${accountAddress}`);\n        }\n        return acc;\n      }, []);\n    }\n\n    const uniqueCaipAccounts = getUniqueArrayItems(caipAccounts);\n\n    updatedScopesObject[scopeString] = {\n      ...scopeObject,\n      accounts: uniqueCaipAccounts,\n    };\n  });\n\n  return updatedScopesObject;\n};\n\n/**\n * Sets the permitted accounts to scopes with matching namespaces in the given CAIP-25 caveat value.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted accounts for.\n * @param accounts - The permitted accounts to add to the appropriate scopes.\n * @returns The updated CAIP-25 caveat value with the permitted accounts set.\n */\nexport const setPermittedAccounts = (\n  caip25CaveatValue: Caip25CaveatValue,\n  accounts: CaipAccountId[],\n): Caip25CaveatValue => {\n  return {\n    ...caip25CaveatValue,\n    requiredScopes: setPermittedAccountsForScopesObject(\n      caip25CaveatValue.requiredScopes,\n      accounts,\n    ),\n    optionalScopes: setPermittedAccountsForScopesObject(\n      caip25CaveatValue.optionalScopes,\n      accounts,\n    ),\n  };\n};\n"]}

package/dist/adapters/caip-permission-adapter-permittedChains.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setPermittedEthChainIds = exports.addPermittedEthChainId = exports.getPermittedEthChainIds = void 0;
+exports.setPermittedChainIds = exports.addPermittedChainId = exports.setPermittedEthChainIds = exports.addPermittedEthChainId = exports.getPermittedEthChainIds = void 0;
 const controller_utils_1 = require("@metamask/controller-utils");
 const utils_1 = require("@metamask/utils");
 const transform_1 = require("../scope/transform.cjs");
@@ -112,4 +112,67 @@ const setPermittedEthChainIds = (caip25CaveatValue, chainIds) => {
     return updatedCaveatValue;
 };
 exports.setPermittedEthChainIds = setPermittedEthChainIds;
+/**
+ * Filters the scopes object to only include:
+ * - Scopes without references (e.g. "wallet:")
+ * - CAIP-2 ChainId scopes for the given chainIDs
+ *
+ * @param scopesObject - The scopes object to filter.
+ * @param chainIds - The CAIP-2 chainIDs to filter for.
+ * @returns The filtered scopes object.
+ */
+const filterChainScopesObjectByChainId = (scopesObject, chainIds) => {
+    const updatedScopesObject = {};
+    Object.entries(scopesObject).forEach(([key, scopeObject]) => {
+        // Cast needed because index type is returned as `string` by `Object.entries`
+        const scopeString = key;
+        if ((0, types_1.isWalletScope)(scopeString) || chainIds.includes(scopeString)) {
+            updatedScopesObject[scopeString] = scopeObject;
+        }
+    });
+    return updatedScopesObject;
+};
+/**
+ * Adds a chainID to the optional scopes if it is not already present
+ * in either the pre-existing required or optional scopes.
+ *
+ * @param caip25CaveatValue - The CAIP-25 caveat value to add the chainID to.
+ * @param chainId - The chainID to add.
+ * @returns The updated CAIP-25 caveat value with the added chainID.
+ */
+const addPermittedChainId = (caip25CaveatValue, chainId) => {
+    if (Object.keys(caip25CaveatValue.requiredScopes).includes(chainId) ||
+        Object.keys(caip25CaveatValue.optionalScopes).includes(chainId)) {
+        return caip25CaveatValue;
+    }
+    return {
+        ...caip25CaveatValue,
+        optionalScopes: {
+            ...caip25CaveatValue.optionalScopes,
+            [chainId]: {
+                accounts: [],
+            },
+        },
+    };
+};
+exports.addPermittedChainId = addPermittedChainId;
+/**
+ * Sets the permitted CAIP-2 chainIDs for the required and optional scopes.
+ *
+ * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted CAIP-2 chainIDs for.
+ * @param chainIds - The CAIP-2 chainIDs to set as permitted.
+ * @returns The updated CAIP-25 caveat value with the permitted CAIP-2 chainIDs.
+ */
+const setPermittedChainIds = (caip25CaveatValue, chainIds) => {
+    let updatedCaveatValue = {
+        ...caip25CaveatValue,
+        requiredScopes: filterChainScopesObjectByChainId(caip25CaveatValue.requiredScopes, chainIds),
+        optionalScopes: filterChainScopesObjectByChainId(caip25CaveatValue.optionalScopes, chainIds),
+    };
+    chainIds.forEach((chainId) => {
+        updatedCaveatValue = (0, exports.addPermittedChainId)(updatedCaveatValue, chainId);
+    });
+    return updatedCaveatValue;
+};
+exports.setPermittedChainIds = setPermittedChainIds;
 //# sourceMappingURL=caip-permission-adapter-permittedChains.cjs.map

package/dist/adapters/caip-permission-adapter-permittedChains.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"caip-permission-adapter-permittedChains.cjs","sourceRoot":"","sources":["../../src/adapters/caip-permission-adapter-permittedChains.ts"],"names":[],"mappings":"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","sourcesContent":["import { toHex } from '@metamask/controller-utils';\nimport type { Hex } from '@metamask/utils';\nimport { hexToBigInt, KnownCaipNamespace } from '@metamask/utils';\n\nimport type { Caip25CaveatValue } from '../caip25Permission';\nimport { getUniqueArrayItems } from '../scope/transform';\nimport type { InternalScopesObject } from '../scope/types';\nimport { parseScopeString } from '../scope/types';\n\n/**\n * Gets the Ethereum (EIP155 namespaced) chainIDs from internal scopes.\n *\n * @param scopes - The internal scopes from which to get the Ethereum chainIDs.\n * @returns An array of Ethereum chainIDs.\n */\nconst getPermittedEthChainIdsFromScopes = (scopes: InternalScopesObject) => {\n  const ethChainIds: Hex[] = [];\n\n  Object.keys(scopes).forEach((scopeString) => {\n    const { namespace, reference } = parseScopeString(scopeString);\n    if (namespace === KnownCaipNamespace.Eip155 && reference) {\n      ethChainIds.push(toHex(reference));\n    }\n  });\n\n  return ethChainIds;\n};\n\n/**\n * Gets the Ethereum (EIP155 namespaced) chainIDs from the required and optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value from which to get the Ethereum chainIDs.\n * @returns An array of Ethereum chainIDs.\n */\nexport const getPermittedEthChainIds = (\n  caip25CaveatValue: Pick<\n    Caip25CaveatValue,\n    'requiredScopes' | 'optionalScopes'\n  >,\n) => {\n  const { requiredScopes, optionalScopes } = caip25CaveatValue;\n\n  const ethChainIds: Hex[] = [\n    ...getPermittedEthChainIdsFromScopes(requiredScopes),\n    ...getPermittedEthChainIdsFromScopes(optionalScopes),\n  ];\n\n  return getUniqueArrayItems(ethChainIds);\n};\n\n/**\n * Adds an Ethereum (EIP155 namespaced) chainID to the optional scopes if it is not already present\n * in either the pre-existing required or optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to add the Ethereum chainID to.\n * @param chainId - The Ethereum chainID to add.\n * @returns The updated CAIP-25 caveat value with the added Ethereum chainID.\n */\nexport const addPermittedEthChainId = (\n  caip25CaveatValue: Caip25CaveatValue,\n  chainId: Hex,\n): Caip25CaveatValue => {\n  const scopeString = `eip155:${hexToBigInt(chainId).toString(10)}`;\n  if (\n    Object.keys(caip25CaveatValue.requiredScopes).includes(scopeString) ||\n    Object.keys(caip25CaveatValue.optionalScopes).includes(scopeString)\n  ) {\n    return caip25CaveatValue;\n  }\n\n  return {\n    ...caip25CaveatValue,\n    optionalScopes: {\n      ...caip25CaveatValue.optionalScopes,\n      [scopeString]: {\n        accounts: [],\n      },\n    },\n  };\n};\n\n/**\n * Filters the scopes object to only include:\n * - Scopes without references (e.g. \"wallet:\")\n * - EIP155 scopes for the given chainIDs\n * - Non EIP155 scopes (e.g. \"bip122:\" or any other non ethereum namespaces)\n *\n * @param scopesObject - The scopes object to filter.\n * @param chainIds - The chainIDs to filter EIP155 scopes by.\n * @returns The filtered scopes object.\n */\nconst filterEthScopesObjectByChainId = (\n  scopesObject: InternalScopesObject,\n  chainIds: Hex[],\n): InternalScopesObject => {\n  const updatedScopesObject: InternalScopesObject = {};\n\n  Object.entries(scopesObject).forEach(([key, scopeObject]) => {\n    // Cast needed because index type is returned as `string` by `Object.entries`\n    const scopeString = key as keyof typeof scopesObject;\n    const { namespace, reference } = parseScopeString(scopeString);\n    if (!reference) {\n      updatedScopesObject[scopeString] = scopeObject;\n      return;\n    }\n    if (namespace === KnownCaipNamespace.Eip155) {\n      const chainId = toHex(reference);\n      if (chainIds.includes(chainId)) {\n        updatedScopesObject[scopeString] = scopeObject;\n      }\n    } else {\n      updatedScopesObject[scopeString] = scopeObject;\n    }\n  });\n\n  return updatedScopesObject;\n};\n\n/**\n * Sets the permitted Ethereum (EIP155 namespaced) chainIDs for the required and optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted Ethereum chainIDs for.\n * @param chainIds - The Ethereum chainIDs to set as permitted.\n * @returns The updated CAIP-25 caveat value with the permitted Ethereum chainIDs.\n */\nexport const setPermittedEthChainIds = (\n  caip25CaveatValue: Caip25CaveatValue,\n  chainIds: Hex[],\n): Caip25CaveatValue => {\n  let updatedCaveatValue: Caip25CaveatValue = {\n    ...caip25CaveatValue,\n    requiredScopes: filterEthScopesObjectByChainId(\n      caip25CaveatValue.requiredScopes,\n      chainIds,\n    ),\n    optionalScopes: filterEthScopesObjectByChainId(\n      caip25CaveatValue.optionalScopes,\n      chainIds,\n    ),\n  };\n\n  chainIds.forEach((chainId) => {\n    updatedCaveatValue = addPermittedEthChainId(updatedCaveatValue, chainId);\n  });\n\n  return updatedCaveatValue;\n};\n"]}
+{"version":3,"file":"caip-permission-adapter-permittedChains.cjs","sourceRoot":"","sources":["../../src/adapters/caip-permission-adapter-permittedChains.ts"],"names":[],"mappings":"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","sourcesContent":["import { toHex } from '@metamask/controller-utils';\nimport type { Hex, CaipChainId } from '@metamask/utils';\nimport { hexToBigInt, KnownCaipNamespace } from '@metamask/utils';\n\nimport type { Caip25CaveatValue } from '../caip25Permission';\nimport { getUniqueArrayItems } from '../scope/transform';\nimport type { InternalScopesObject } from '../scope/types';\nimport { isWalletScope, parseScopeString } from '../scope/types';\n\n/**\n * Gets the Ethereum (EIP155 namespaced) chainIDs from internal scopes.\n *\n * @param scopes - The internal scopes from which to get the Ethereum chainIDs.\n * @returns An array of Ethereum chainIDs.\n */\nconst getPermittedEthChainIdsFromScopes = (scopes: InternalScopesObject) => {\n  const ethChainIds: Hex[] = [];\n\n  Object.keys(scopes).forEach((scopeString) => {\n    const { namespace, reference } = parseScopeString(scopeString);\n    if (namespace === KnownCaipNamespace.Eip155 && reference) {\n      ethChainIds.push(toHex(reference));\n    }\n  });\n\n  return ethChainIds;\n};\n\n/**\n * Gets the Ethereum (EIP155 namespaced) chainIDs from the required and optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value from which to get the Ethereum chainIDs.\n * @returns An array of Ethereum chainIDs.\n */\nexport const getPermittedEthChainIds = (\n  caip25CaveatValue: Pick<\n    Caip25CaveatValue,\n    'requiredScopes' | 'optionalScopes'\n  >,\n) => {\n  const { requiredScopes, optionalScopes } = caip25CaveatValue;\n\n  const ethChainIds: Hex[] = [\n    ...getPermittedEthChainIdsFromScopes(requiredScopes),\n    ...getPermittedEthChainIdsFromScopes(optionalScopes),\n  ];\n\n  return getUniqueArrayItems(ethChainIds);\n};\n\n/**\n * Adds an Ethereum (EIP155 namespaced) chainID to the optional scopes if it is not already present\n * in either the pre-existing required or optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to add the Ethereum chainID to.\n * @param chainId - The Ethereum chainID to add.\n * @returns The updated CAIP-25 caveat value with the added Ethereum chainID.\n */\nexport const addPermittedEthChainId = (\n  caip25CaveatValue: Caip25CaveatValue,\n  chainId: Hex,\n): Caip25CaveatValue => {\n  const scopeString = `eip155:${hexToBigInt(chainId).toString(10)}`;\n  if (\n    Object.keys(caip25CaveatValue.requiredScopes).includes(scopeString) ||\n    Object.keys(caip25CaveatValue.optionalScopes).includes(scopeString)\n  ) {\n    return caip25CaveatValue;\n  }\n\n  return {\n    ...caip25CaveatValue,\n    optionalScopes: {\n      ...caip25CaveatValue.optionalScopes,\n      [scopeString]: {\n        accounts: [],\n      },\n    },\n  };\n};\n\n/**\n * Filters the scopes object to only include:\n * - Scopes without references (e.g. \"wallet:\")\n * - EIP155 scopes for the given chainIDs\n * - Non EIP155 scopes (e.g. \"bip122:\" or any other non ethereum namespaces)\n *\n * @param scopesObject - The scopes object to filter.\n * @param chainIds - The chainIDs to filter EIP155 scopes by.\n * @returns The filtered scopes object.\n */\nconst filterEthScopesObjectByChainId = (\n  scopesObject: InternalScopesObject,\n  chainIds: Hex[],\n): InternalScopesObject => {\n  const updatedScopesObject: InternalScopesObject = {};\n\n  Object.entries(scopesObject).forEach(([key, scopeObject]) => {\n    // Cast needed because index type is returned as `string` by `Object.entries`\n    const scopeString = key as keyof typeof scopesObject;\n    const { namespace, reference } = parseScopeString(scopeString);\n    if (!reference) {\n      updatedScopesObject[scopeString] = scopeObject;\n      return;\n    }\n    if (namespace === KnownCaipNamespace.Eip155) {\n      const chainId = toHex(reference);\n      if (chainIds.includes(chainId)) {\n        updatedScopesObject[scopeString] = scopeObject;\n      }\n    } else {\n      updatedScopesObject[scopeString] = scopeObject;\n    }\n  });\n\n  return updatedScopesObject;\n};\n\n/**\n * Sets the permitted Ethereum (EIP155 namespaced) chainIDs for the required and optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted Ethereum chainIDs for.\n * @param chainIds - The Ethereum chainIDs to set as permitted.\n * @returns The updated CAIP-25 caveat value with the permitted Ethereum chainIDs.\n */\nexport const setPermittedEthChainIds = (\n  caip25CaveatValue: Caip25CaveatValue,\n  chainIds: Hex[],\n): Caip25CaveatValue => {\n  let updatedCaveatValue: Caip25CaveatValue = {\n    ...caip25CaveatValue,\n    requiredScopes: filterEthScopesObjectByChainId(\n      caip25CaveatValue.requiredScopes,\n      chainIds,\n    ),\n    optionalScopes: filterEthScopesObjectByChainId(\n      caip25CaveatValue.optionalScopes,\n      chainIds,\n    ),\n  };\n\n  chainIds.forEach((chainId) => {\n    updatedCaveatValue = addPermittedEthChainId(updatedCaveatValue, chainId);\n  });\n\n  return updatedCaveatValue;\n};\n\n/**\n * Filters the scopes object to only include:\n * - Scopes without references (e.g. \"wallet:\")\n * - CAIP-2 ChainId scopes for the given chainIDs\n *\n * @param scopesObject - The scopes object to filter.\n * @param chainIds - The CAIP-2 chainIDs to filter for.\n * @returns The filtered scopes object.\n */\nconst filterChainScopesObjectByChainId = (\n  scopesObject: InternalScopesObject,\n  chainIds: CaipChainId[],\n): InternalScopesObject => {\n  const updatedScopesObject: InternalScopesObject = {};\n\n  Object.entries(scopesObject).forEach(([key, scopeObject]) => {\n    // Cast needed because index type is returned as `string` by `Object.entries`\n    const scopeString = key as keyof typeof scopesObject;\n    if (isWalletScope(scopeString) || chainIds.includes(scopeString)) {\n      updatedScopesObject[scopeString] = scopeObject;\n    }\n  });\n\n  return updatedScopesObject;\n};\n\n/**\n * Adds a chainID to the optional scopes if it is not already present\n * in either the pre-existing required or optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to add the chainID to.\n * @param chainId - The chainID to add.\n * @returns The updated CAIP-25 caveat value with the added chainID.\n */\nexport const addPermittedChainId = (\n  caip25CaveatValue: Caip25CaveatValue,\n  chainId: CaipChainId,\n): Caip25CaveatValue => {\n  if (\n    Object.keys(caip25CaveatValue.requiredScopes).includes(chainId) ||\n    Object.keys(caip25CaveatValue.optionalScopes).includes(chainId)\n  ) {\n    return caip25CaveatValue;\n  }\n\n  return {\n    ...caip25CaveatValue,\n    optionalScopes: {\n      ...caip25CaveatValue.optionalScopes,\n      [chainId]: {\n        accounts: [],\n      },\n    },\n  };\n};\n\n/**\n * Sets the permitted CAIP-2 chainIDs for the required and optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted CAIP-2 chainIDs for.\n * @param chainIds - The CAIP-2 chainIDs to set as permitted.\n * @returns The updated CAIP-25 caveat value with the permitted CAIP-2 chainIDs.\n */\nexport const setPermittedChainIds = (\n  caip25CaveatValue: Caip25CaveatValue,\n  chainIds: CaipChainId[],\n): Caip25CaveatValue => {\n  let updatedCaveatValue: Caip25CaveatValue = {\n    ...caip25CaveatValue,\n    requiredScopes: filterChainScopesObjectByChainId(\n      caip25CaveatValue.requiredScopes,\n      chainIds,\n    ),\n    optionalScopes: filterChainScopesObjectByChainId(\n      caip25CaveatValue.optionalScopes,\n      chainIds,\n    ),\n  };\n\n  chainIds.forEach((chainId) => {\n    updatedCaveatValue = addPermittedChainId(updatedCaveatValue, chainId);\n  });\n\n  return updatedCaveatValue;\n};\n"]}

package/dist/adapters/caip-permission-adapter-permittedChains.d.cts

@@ -1,4 +1,4 @@
-import type { Hex } from "@metamask/utils";
+import type { Hex, CaipChainId } from "@metamask/utils";
 import type { Caip25CaveatValue } from "../caip25Permission.cjs";
 /**
  * Gets the Ethereum (EIP155 namespaced) chainIDs from the required and optional scopes.
@@ -24,4 +24,21 @@ export declare const addPermittedEthChainId: (caip25CaveatValue: Caip25CaveatVal
  * @returns The updated CAIP-25 caveat value with the permitted Ethereum chainIDs.
  */
 export declare const setPermittedEthChainIds: (caip25CaveatValue: Caip25CaveatValue, chainIds: Hex[]) => Caip25CaveatValue;
+/**
+ * Adds a chainID to the optional scopes if it is not already present
+ * in either the pre-existing required or optional scopes.
+ *
+ * @param caip25CaveatValue - The CAIP-25 caveat value to add the chainID to.
+ * @param chainId - The chainID to add.
+ * @returns The updated CAIP-25 caveat value with the added chainID.
+ */
+export declare const addPermittedChainId: (caip25CaveatValue: Caip25CaveatValue, chainId: CaipChainId) => Caip25CaveatValue;
+/**
+ * Sets the permitted CAIP-2 chainIDs for the required and optional scopes.
+ *
+ * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted CAIP-2 chainIDs for.
+ * @param chainIds - The CAIP-2 chainIDs to set as permitted.
+ * @returns The updated CAIP-25 caveat value with the permitted CAIP-2 chainIDs.
+ */
+export declare const setPermittedChainIds: (caip25CaveatValue: Caip25CaveatValue, chainIds: CaipChainId[]) => Caip25CaveatValue;
 //# sourceMappingURL=caip-permission-adapter-permittedChains.d.cts.map

package/dist/adapters/caip-permission-adapter-permittedChains.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"caip-permission-adapter-permittedChains.d.cts","sourceRoot":"","sources":["../../src/adapters/caip-permission-adapter-permittedChains.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAG3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,gCAA4B;AAwB7D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,sBACf,KACjB,iBAAiB,EACjB,gBAAgB,GAAG,gBAAgB,CACpC,oBAUF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,sBACd,iBAAiB,WAC3B,GAAG,KACX,iBAkBF,CAAC;AAuCF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,sBACf,iBAAiB,YAC1B,GAAG,EAAE,KACd,iBAkBF,CAAC"}
+{"version":3,"file":"caip-permission-adapter-permittedChains.d.cts","sourceRoot":"","sources":["../../src/adapters/caip-permission-adapter-permittedChains.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,wBAAwB;AAGxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,gCAA4B;AAwB7D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,sBACf,KACjB,iBAAiB,EACjB,gBAAgB,GAAG,gBAAgB,CACpC,oBAUF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,sBACd,iBAAiB,WAC3B,GAAG,KACX,iBAkBF,CAAC;AAuCF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,sBACf,iBAAiB,YAC1B,GAAG,EAAE,KACd,iBAkBF,CAAC;AA4BF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,sBACX,iBAAiB,WAC3B,WAAW,KACnB,iBAiBF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,sBACZ,iBAAiB,YAC1B,WAAW,EAAE,KACtB,iBAkBF,CAAC"}

package/dist/adapters/caip-permission-adapter-permittedChains.d.mts

@@ -1,4 +1,4 @@
-import type { Hex } from "@metamask/utils";
+import type { Hex, CaipChainId } from "@metamask/utils";
 import type { Caip25CaveatValue } from "../caip25Permission.mjs";
 /**
  * Gets the Ethereum (EIP155 namespaced) chainIDs from the required and optional scopes.
@@ -24,4 +24,21 @@ export declare const addPermittedEthChainId: (caip25CaveatValue: Caip25CaveatVal
  * @returns The updated CAIP-25 caveat value with the permitted Ethereum chainIDs.
  */
 export declare const setPermittedEthChainIds: (caip25CaveatValue: Caip25CaveatValue, chainIds: Hex[]) => Caip25CaveatValue;
+/**
+ * Adds a chainID to the optional scopes if it is not already present
+ * in either the pre-existing required or optional scopes.
+ *
+ * @param caip25CaveatValue - The CAIP-25 caveat value to add the chainID to.
+ * @param chainId - The chainID to add.
+ * @returns The updated CAIP-25 caveat value with the added chainID.
+ */
+export declare const addPermittedChainId: (caip25CaveatValue: Caip25CaveatValue, chainId: CaipChainId) => Caip25CaveatValue;
+/**
+ * Sets the permitted CAIP-2 chainIDs for the required and optional scopes.
+ *
+ * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted CAIP-2 chainIDs for.
+ * @param chainIds - The CAIP-2 chainIDs to set as permitted.
+ * @returns The updated CAIP-25 caveat value with the permitted CAIP-2 chainIDs.
+ */
+export declare const setPermittedChainIds: (caip25CaveatValue: Caip25CaveatValue, chainIds: CaipChainId[]) => Caip25CaveatValue;
 //# sourceMappingURL=caip-permission-adapter-permittedChains.d.mts.map

package/dist/adapters/caip-permission-adapter-permittedChains.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"caip-permission-adapter-permittedChains.d.mts","sourceRoot":"","sources":["../../src/adapters/caip-permission-adapter-permittedChains.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAG3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,gCAA4B;AAwB7D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,sBACf,KACjB,iBAAiB,EACjB,gBAAgB,GAAG,gBAAgB,CACpC,oBAUF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,sBACd,iBAAiB,WAC3B,GAAG,KACX,iBAkBF,CAAC;AAuCF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,sBACf,iBAAiB,YAC1B,GAAG,EAAE,KACd,iBAkBF,CAAC"}
+{"version":3,"file":"caip-permission-adapter-permittedChains.d.mts","sourceRoot":"","sources":["../../src/adapters/caip-permission-adapter-permittedChains.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,wBAAwB;AAGxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,gCAA4B;AAwB7D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,sBACf,KACjB,iBAAiB,EACjB,gBAAgB,GAAG,gBAAgB,CACpC,oBAUF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,sBACd,iBAAiB,WAC3B,GAAG,KACX,iBAkBF,CAAC;AAuCF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,sBACf,iBAAiB,YAC1B,GAAG,EAAE,KACd,iBAkBF,CAAC;AA4BF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,sBACX,iBAAiB,WAC3B,WAAW,KACnB,iBAiBF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,sBACZ,iBAAiB,YAC1B,WAAW,EAAE,KACtB,iBAkBF,CAAC"}

package/dist/adapters/caip-permission-adapter-permittedChains.mjs

@@ -1,7 +1,7 @@
 import { toHex } from "@metamask/controller-utils";
 import { hexToBigInt, KnownCaipNamespace } from "@metamask/utils";
 import { getUniqueArrayItems } from "../scope/transform.mjs";
-import { parseScopeString } from "../scope/types.mjs";
+import { isWalletScope, parseScopeString } from "../scope/types.mjs";
 /**
  * Gets the Ethereum (EIP155 namespaced) chainIDs from internal scopes.
  *
@@ -106,4 +106,65 @@ export const setPermittedEthChainIds = (caip25CaveatValue, chainIds) => {
     });
     return updatedCaveatValue;
 };
+/**
+ * Filters the scopes object to only include:
+ * - Scopes without references (e.g. "wallet:")
+ * - CAIP-2 ChainId scopes for the given chainIDs
+ *
+ * @param scopesObject - The scopes object to filter.
+ * @param chainIds - The CAIP-2 chainIDs to filter for.
+ * @returns The filtered scopes object.
+ */
+const filterChainScopesObjectByChainId = (scopesObject, chainIds) => {
+    const updatedScopesObject = {};
+    Object.entries(scopesObject).forEach(([key, scopeObject]) => {
+        // Cast needed because index type is returned as `string` by `Object.entries`
+        const scopeString = key;
+        if (isWalletScope(scopeString) || chainIds.includes(scopeString)) {
+            updatedScopesObject[scopeString] = scopeObject;
+        }
+    });
+    return updatedScopesObject;
+};
+/**
+ * Adds a chainID to the optional scopes if it is not already present
+ * in either the pre-existing required or optional scopes.
+ *
+ * @param caip25CaveatValue - The CAIP-25 caveat value to add the chainID to.
+ * @param chainId - The chainID to add.
+ * @returns The updated CAIP-25 caveat value with the added chainID.
+ */
+export const addPermittedChainId = (caip25CaveatValue, chainId) => {
+    if (Object.keys(caip25CaveatValue.requiredScopes).includes(chainId) ||
+        Object.keys(caip25CaveatValue.optionalScopes).includes(chainId)) {
+        return caip25CaveatValue;
+    }
+    return {
+        ...caip25CaveatValue,
+        optionalScopes: {
+            ...caip25CaveatValue.optionalScopes,
+            [chainId]: {
+                accounts: [],
+            },
+        },
+    };
+};
+/**
+ * Sets the permitted CAIP-2 chainIDs for the required and optional scopes.
+ *
+ * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted CAIP-2 chainIDs for.
+ * @param chainIds - The CAIP-2 chainIDs to set as permitted.
+ * @returns The updated CAIP-25 caveat value with the permitted CAIP-2 chainIDs.
+ */
+export const setPermittedChainIds = (caip25CaveatValue, chainIds) => {
+    let updatedCaveatValue = {
+        ...caip25CaveatValue,
+        requiredScopes: filterChainScopesObjectByChainId(caip25CaveatValue.requiredScopes, chainIds),
+        optionalScopes: filterChainScopesObjectByChainId(caip25CaveatValue.optionalScopes, chainIds),
+    };
+    chainIds.forEach((chainId) => {
+        updatedCaveatValue = addPermittedChainId(updatedCaveatValue, chainId);
+    });
+    return updatedCaveatValue;
+};
 //# sourceMappingURL=caip-permission-adapter-permittedChains.mjs.map

package/dist/adapters/caip-permission-adapter-permittedChains.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"caip-permission-adapter-permittedChains.mjs","sourceRoot":"","sources":["../../src/adapters/caip-permission-adapter-permittedChains.ts"],"names":[],"mappings":"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","sourcesContent":["import { toHex } from '@metamask/controller-utils';\nimport type { Hex } from '@metamask/utils';\nimport { hexToBigInt, KnownCaipNamespace } from '@metamask/utils';\n\nimport type { Caip25CaveatValue } from '../caip25Permission';\nimport { getUniqueArrayItems } from '../scope/transform';\nimport type { InternalScopesObject } from '../scope/types';\nimport { parseScopeString } from '../scope/types';\n\n/**\n * Gets the Ethereum (EIP155 namespaced) chainIDs from internal scopes.\n *\n * @param scopes - The internal scopes from which to get the Ethereum chainIDs.\n * @returns An array of Ethereum chainIDs.\n */\nconst getPermittedEthChainIdsFromScopes = (scopes: InternalScopesObject) => {\n  const ethChainIds: Hex[] = [];\n\n  Object.keys(scopes).forEach((scopeString) => {\n    const { namespace, reference } = parseScopeString(scopeString);\n    if (namespace === KnownCaipNamespace.Eip155 && reference) {\n      ethChainIds.push(toHex(reference));\n    }\n  });\n\n  return ethChainIds;\n};\n\n/**\n * Gets the Ethereum (EIP155 namespaced) chainIDs from the required and optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value from which to get the Ethereum chainIDs.\n * @returns An array of Ethereum chainIDs.\n */\nexport const getPermittedEthChainIds = (\n  caip25CaveatValue: Pick<\n    Caip25CaveatValue,\n    'requiredScopes' | 'optionalScopes'\n  >,\n) => {\n  const { requiredScopes, optionalScopes } = caip25CaveatValue;\n\n  const ethChainIds: Hex[] = [\n    ...getPermittedEthChainIdsFromScopes(requiredScopes),\n    ...getPermittedEthChainIdsFromScopes(optionalScopes),\n  ];\n\n  return getUniqueArrayItems(ethChainIds);\n};\n\n/**\n * Adds an Ethereum (EIP155 namespaced) chainID to the optional scopes if it is not already present\n * in either the pre-existing required or optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to add the Ethereum chainID to.\n * @param chainId - The Ethereum chainID to add.\n * @returns The updated CAIP-25 caveat value with the added Ethereum chainID.\n */\nexport const addPermittedEthChainId = (\n  caip25CaveatValue: Caip25CaveatValue,\n  chainId: Hex,\n): Caip25CaveatValue => {\n  const scopeString = `eip155:${hexToBigInt(chainId).toString(10)}`;\n  if (\n    Object.keys(caip25CaveatValue.requiredScopes).includes(scopeString) ||\n    Object.keys(caip25CaveatValue.optionalScopes).includes(scopeString)\n  ) {\n    return caip25CaveatValue;\n  }\n\n  return {\n    ...caip25CaveatValue,\n    optionalScopes: {\n      ...caip25CaveatValue.optionalScopes,\n      [scopeString]: {\n        accounts: [],\n      },\n    },\n  };\n};\n\n/**\n * Filters the scopes object to only include:\n * - Scopes without references (e.g. \"wallet:\")\n * - EIP155 scopes for the given chainIDs\n * - Non EIP155 scopes (e.g. \"bip122:\" or any other non ethereum namespaces)\n *\n * @param scopesObject - The scopes object to filter.\n * @param chainIds - The chainIDs to filter EIP155 scopes by.\n * @returns The filtered scopes object.\n */\nconst filterEthScopesObjectByChainId = (\n  scopesObject: InternalScopesObject,\n  chainIds: Hex[],\n): InternalScopesObject => {\n  const updatedScopesObject: InternalScopesObject = {};\n\n  Object.entries(scopesObject).forEach(([key, scopeObject]) => {\n    // Cast needed because index type is returned as `string` by `Object.entries`\n    const scopeString = key as keyof typeof scopesObject;\n    const { namespace, reference } = parseScopeString(scopeString);\n    if (!reference) {\n      updatedScopesObject[scopeString] = scopeObject;\n      return;\n    }\n    if (namespace === KnownCaipNamespace.Eip155) {\n      const chainId = toHex(reference);\n      if (chainIds.includes(chainId)) {\n        updatedScopesObject[scopeString] = scopeObject;\n      }\n    } else {\n      updatedScopesObject[scopeString] = scopeObject;\n    }\n  });\n\n  return updatedScopesObject;\n};\n\n/**\n * Sets the permitted Ethereum (EIP155 namespaced) chainIDs for the required and optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted Ethereum chainIDs for.\n * @param chainIds - The Ethereum chainIDs to set as permitted.\n * @returns The updated CAIP-25 caveat value with the permitted Ethereum chainIDs.\n */\nexport const setPermittedEthChainIds = (\n  caip25CaveatValue: Caip25CaveatValue,\n  chainIds: Hex[],\n): Caip25CaveatValue => {\n  let updatedCaveatValue: Caip25CaveatValue = {\n    ...caip25CaveatValue,\n    requiredScopes: filterEthScopesObjectByChainId(\n      caip25CaveatValue.requiredScopes,\n      chainIds,\n    ),\n    optionalScopes: filterEthScopesObjectByChainId(\n      caip25CaveatValue.optionalScopes,\n      chainIds,\n    ),\n  };\n\n  chainIds.forEach((chainId) => {\n    updatedCaveatValue = addPermittedEthChainId(updatedCaveatValue, chainId);\n  });\n\n  return updatedCaveatValue;\n};\n"]}
+{"version":3,"file":"caip-permission-adapter-permittedChains.mjs","sourceRoot":"","sources":["../../src/adapters/caip-permission-adapter-permittedChains.ts"],"names":[],"mappings":"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","sourcesContent":["import { toHex } from '@metamask/controller-utils';\nimport type { Hex, CaipChainId } from '@metamask/utils';\nimport { hexToBigInt, KnownCaipNamespace } from '@metamask/utils';\n\nimport type { Caip25CaveatValue } from '../caip25Permission';\nimport { getUniqueArrayItems } from '../scope/transform';\nimport type { InternalScopesObject } from '../scope/types';\nimport { isWalletScope, parseScopeString } from '../scope/types';\n\n/**\n * Gets the Ethereum (EIP155 namespaced) chainIDs from internal scopes.\n *\n * @param scopes - The internal scopes from which to get the Ethereum chainIDs.\n * @returns An array of Ethereum chainIDs.\n */\nconst getPermittedEthChainIdsFromScopes = (scopes: InternalScopesObject) => {\n  const ethChainIds: Hex[] = [];\n\n  Object.keys(scopes).forEach((scopeString) => {\n    const { namespace, reference } = parseScopeString(scopeString);\n    if (namespace === KnownCaipNamespace.Eip155 && reference) {\n      ethChainIds.push(toHex(reference));\n    }\n  });\n\n  return ethChainIds;\n};\n\n/**\n * Gets the Ethereum (EIP155 namespaced) chainIDs from the required and optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value from which to get the Ethereum chainIDs.\n * @returns An array of Ethereum chainIDs.\n */\nexport const getPermittedEthChainIds = (\n  caip25CaveatValue: Pick<\n    Caip25CaveatValue,\n    'requiredScopes' | 'optionalScopes'\n  >,\n) => {\n  const { requiredScopes, optionalScopes } = caip25CaveatValue;\n\n  const ethChainIds: Hex[] = [\n    ...getPermittedEthChainIdsFromScopes(requiredScopes),\n    ...getPermittedEthChainIdsFromScopes(optionalScopes),\n  ];\n\n  return getUniqueArrayItems(ethChainIds);\n};\n\n/**\n * Adds an Ethereum (EIP155 namespaced) chainID to the optional scopes if it is not already present\n * in either the pre-existing required or optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to add the Ethereum chainID to.\n * @param chainId - The Ethereum chainID to add.\n * @returns The updated CAIP-25 caveat value with the added Ethereum chainID.\n */\nexport const addPermittedEthChainId = (\n  caip25CaveatValue: Caip25CaveatValue,\n  chainId: Hex,\n): Caip25CaveatValue => {\n  const scopeString = `eip155:${hexToBigInt(chainId).toString(10)}`;\n  if (\n    Object.keys(caip25CaveatValue.requiredScopes).includes(scopeString) ||\n    Object.keys(caip25CaveatValue.optionalScopes).includes(scopeString)\n  ) {\n    return caip25CaveatValue;\n  }\n\n  return {\n    ...caip25CaveatValue,\n    optionalScopes: {\n      ...caip25CaveatValue.optionalScopes,\n      [scopeString]: {\n        accounts: [],\n      },\n    },\n  };\n};\n\n/**\n * Filters the scopes object to only include:\n * - Scopes without references (e.g. \"wallet:\")\n * - EIP155 scopes for the given chainIDs\n * - Non EIP155 scopes (e.g. \"bip122:\" or any other non ethereum namespaces)\n *\n * @param scopesObject - The scopes object to filter.\n * @param chainIds - The chainIDs to filter EIP155 scopes by.\n * @returns The filtered scopes object.\n */\nconst filterEthScopesObjectByChainId = (\n  scopesObject: InternalScopesObject,\n  chainIds: Hex[],\n): InternalScopesObject => {\n  const updatedScopesObject: InternalScopesObject = {};\n\n  Object.entries(scopesObject).forEach(([key, scopeObject]) => {\n    // Cast needed because index type is returned as `string` by `Object.entries`\n    const scopeString = key as keyof typeof scopesObject;\n    const { namespace, reference } = parseScopeString(scopeString);\n    if (!reference) {\n      updatedScopesObject[scopeString] = scopeObject;\n      return;\n    }\n    if (namespace === KnownCaipNamespace.Eip155) {\n      const chainId = toHex(reference);\n      if (chainIds.includes(chainId)) {\n        updatedScopesObject[scopeString] = scopeObject;\n      }\n    } else {\n      updatedScopesObject[scopeString] = scopeObject;\n    }\n  });\n\n  return updatedScopesObject;\n};\n\n/**\n * Sets the permitted Ethereum (EIP155 namespaced) chainIDs for the required and optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted Ethereum chainIDs for.\n * @param chainIds - The Ethereum chainIDs to set as permitted.\n * @returns The updated CAIP-25 caveat value with the permitted Ethereum chainIDs.\n */\nexport const setPermittedEthChainIds = (\n  caip25CaveatValue: Caip25CaveatValue,\n  chainIds: Hex[],\n): Caip25CaveatValue => {\n  let updatedCaveatValue: Caip25CaveatValue = {\n    ...caip25CaveatValue,\n    requiredScopes: filterEthScopesObjectByChainId(\n      caip25CaveatValue.requiredScopes,\n      chainIds,\n    ),\n    optionalScopes: filterEthScopesObjectByChainId(\n      caip25CaveatValue.optionalScopes,\n      chainIds,\n    ),\n  };\n\n  chainIds.forEach((chainId) => {\n    updatedCaveatValue = addPermittedEthChainId(updatedCaveatValue, chainId);\n  });\n\n  return updatedCaveatValue;\n};\n\n/**\n * Filters the scopes object to only include:\n * - Scopes without references (e.g. \"wallet:\")\n * - CAIP-2 ChainId scopes for the given chainIDs\n *\n * @param scopesObject - The scopes object to filter.\n * @param chainIds - The CAIP-2 chainIDs to filter for.\n * @returns The filtered scopes object.\n */\nconst filterChainScopesObjectByChainId = (\n  scopesObject: InternalScopesObject,\n  chainIds: CaipChainId[],\n): InternalScopesObject => {\n  const updatedScopesObject: InternalScopesObject = {};\n\n  Object.entries(scopesObject).forEach(([key, scopeObject]) => {\n    // Cast needed because index type is returned as `string` by `Object.entries`\n    const scopeString = key as keyof typeof scopesObject;\n    if (isWalletScope(scopeString) || chainIds.includes(scopeString)) {\n      updatedScopesObject[scopeString] = scopeObject;\n    }\n  });\n\n  return updatedScopesObject;\n};\n\n/**\n * Adds a chainID to the optional scopes if it is not already present\n * in either the pre-existing required or optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to add the chainID to.\n * @param chainId - The chainID to add.\n * @returns The updated CAIP-25 caveat value with the added chainID.\n */\nexport const addPermittedChainId = (\n  caip25CaveatValue: Caip25CaveatValue,\n  chainId: CaipChainId,\n): Caip25CaveatValue => {\n  if (\n    Object.keys(caip25CaveatValue.requiredScopes).includes(chainId) ||\n    Object.keys(caip25CaveatValue.optionalScopes).includes(chainId)\n  ) {\n    return caip25CaveatValue;\n  }\n\n  return {\n    ...caip25CaveatValue,\n    optionalScopes: {\n      ...caip25CaveatValue.optionalScopes,\n      [chainId]: {\n        accounts: [],\n      },\n    },\n  };\n};\n\n/**\n * Sets the permitted CAIP-2 chainIDs for the required and optional scopes.\n *\n * @param caip25CaveatValue - The CAIP-25 caveat value to set the permitted CAIP-2 chainIDs for.\n * @param chainIds - The CAIP-2 chainIDs to set as permitted.\n * @returns The updated CAIP-25 caveat value with the permitted CAIP-2 chainIDs.\n */\nexport const setPermittedChainIds = (\n  caip25CaveatValue: Caip25CaveatValue,\n  chainIds: CaipChainId[],\n): Caip25CaveatValue => {\n  let updatedCaveatValue: Caip25CaveatValue = {\n    ...caip25CaveatValue,\n    requiredScopes: filterChainScopesObjectByChainId(\n      caip25CaveatValue.requiredScopes,\n      chainIds,\n    ),\n    optionalScopes: filterChainScopesObjectByChainId(\n      caip25CaveatValue.optionalScopes,\n      chainIds,\n    ),\n  };\n\n  chainIds.forEach((chainId) => {\n    updatedCaveatValue = addPermittedChainId(updatedCaveatValue, chainId);\n  });\n\n  return updatedCaveatValue;\n};\n"]}

package/dist/caip25Permission.cjs

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Caip25CaveatMutators = exports.caip25EndowmentBuilder = exports.caip25CaveatBuilder = exports.diffScopesForCaip25CaveatValue = exports.createCaip25Caveat = exports.Caip25EndowmentPermissionName = exports.Caip25CaveatType = void 0;
+exports.generateCaip25Caveat = exports.Caip25CaveatMutators = exports.caip25EndowmentBuilder = exports.caip25CaveatBuilder = exports.diffScopesForCaip25CaveatValue = exports.createCaip25Caveat = exports.Caip25EndowmentPermissionName = exports.Caip25CaveatType = void 0;
 const permission_controller_1 = require("@metamask/permission-controller");
 const utils_1 = require("@metamask/utils");
 const lodash_1 = require("lodash");
+const caip_permission_adapter_accounts_1 = require("./adapters/caip-permission-adapter-accounts.cjs");
+const caip_permission_adapter_permittedChains_1 = require("./adapters/caip-permission-adapter-permittedChains.cjs");
 const assert_1 = require("./scope/assert.cjs");
 const supported_1 = require("./scope/supported.cjs");
 const transform_1 = require("./scope/transform.cjs");
@@ -106,6 +108,10 @@ const caip25CaveatBuilder = ({ findNetworkClientIdByChainId, listAccounts, isNon
             }
             (0, assert_1.assertIsInternalScopesObject)(requiredScopes);
             (0, assert_1.assertIsInternalScopesObject)(optionalScopes);
+            if (Object.keys(requiredScopes).length === 0 &&
+                Object.keys(optionalScopes).length === 0) {
+                throw new Error(`${exports.Caip25EndowmentPermissionName} error: Received no scopes for caveat of type "${exports.Caip25CaveatType}".`);
+            }
             const isEvmChainIdSupported = (chainId) => {
                 try {
                     findNetworkClientIdByChainId(chainId);
@@ -293,4 +299,27 @@ function removeScope(caip25CaveatValue, targetScopeString) {
         operation: permission_controller_1.CaveatMutatorOperation.RevokePermission,
     };
 }
+/**
+ * Modifies the requested CAIP-25 permissions object after UI confirmation.
+ *
+ * @param caip25CaveatValue - The requested CAIP-25 caveat value to modify.
+ * @param accountAddresses - The list of permitted eth addresses.
+ * @param chainIds - The list of permitted eth chainIds.
+ * @returns The updated CAIP-25 caveat value with the permitted accounts and chainIds set.
+ */
+const generateCaip25Caveat = (caip25CaveatValue, accountAddresses, chainIds) => {
+    const caveatValueWithChains = (0, caip_permission_adapter_permittedChains_1.setPermittedChainIds)(caip25CaveatValue, chainIds);
+    const caveatValueWithAccounts = (0, caip_permission_adapter_accounts_1.setPermittedAccounts)(caveatValueWithChains, accountAddresses);
+    return {
+        [exports.Caip25EndowmentPermissionName]: {
+            caveats: [
+                {
+                    type: exports.Caip25CaveatType,
+                    value: caveatValueWithAccounts,
+                },
+            ],
+        },
+    };
+};
+exports.generateCaip25Caveat = generateCaip25Caveat;
 //# sourceMappingURL=caip25Permission.cjs.map