@metamask-previews/account-api 0.9.0-a621908 → 0.10.0-9fbf2ff

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add wallet `status` ([#367](https://github.com/MetaMask/accounts/pull/367))
+
+## [0.10.0]
+
+### Added
+
+- Add group/wallet ID parsing/validation support ([#360](https://github.com/MetaMask/accounts/pull/360))
+- Add `Bip44AccountProvider` type alias ([#361](https://github.com/MetaMask/accounts/pull/361))
+
+### Changed
+
+- **BREAKING:** Bump `@metamask/keyring-api` to `^21.0.0` ([#362](https://github.com/MetaMask/accounts/pull/362))
+
 ## [0.9.0]
 
 ### Changed
@@ -100,7 +115,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Add `AccountGroup` and `AccountWallet` ([#307](https://github.com/MetaMask/accounts/pull/307))
 
-[Unreleased]: https://github.com/MetaMask/accounts/compare/@metamask/account-api@0.9.0...HEAD
+[Unreleased]: https://github.com/MetaMask/accounts/compare/@metamask/account-api@0.10.0...HEAD
+[0.10.0]: https://github.com/MetaMask/accounts/compare/@metamask/account-api@0.9.0...@metamask/account-api@0.10.0
 [0.9.0]: https://github.com/MetaMask/accounts/compare/@metamask/account-api@0.8.0...@metamask/account-api@0.9.0
 [0.8.0]: https://github.com/MetaMask/accounts/compare/@metamask/account-api@0.7.0...@metamask/account-api@0.8.0
 [0.7.0]: https://github.com/MetaMask/accounts/compare/@metamask/account-api@0.6.0...@metamask/account-api@0.7.0

package/dist/api/group.cjs

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AccountGroupType = exports.DEFAULT_ACCOUNT_GROUP_UNIQUE_ID = void 0;
+exports.ACCOUNT_GROUP_ID_REGEX = exports.AccountGroupType = exports.DEFAULT_ACCOUNT_GROUP_UNIQUE_ID = void 0;
 exports.toAccountGroupId = toAccountGroupId;
 exports.toDefaultAccountGroupId = toDefaultAccountGroupId;
+exports.isAccountGroupId = isAccountGroupId;
+exports.parseAccountGroupId = parseAccountGroupId;
+exports.stripAccountWalletId = stripAccountWalletId;
 /**
  * Default account group unique ID.
  *
@@ -22,6 +25,10 @@ var AccountGroupType;
     /** Group that represents a single account. */
     AccountGroupType["SingleAccount"] = "single-account";
 })(AccountGroupType || (exports.AccountGroupType = AccountGroupType = {}));
+/**
+ * Regex to validate a valid account group ID.
+ */
+exports.ACCOUNT_GROUP_ID_REGEX = /^(?<walletId>(?<walletType>entropy|snap|keyring):(?<walletSubId>.+))\/(?<groupSubId>[^/]+)$/u;
 /**
  * Convert a wallet ID and a unique ID, to a group ID.
  *
@@ -41,4 +48,49 @@ function toAccountGroupId(walletId, id) {
 function toDefaultAccountGroupId(walletId) {
     return toAccountGroupId(walletId, exports.DEFAULT_ACCOUNT_GROUP_UNIQUE_ID);
 }
+/**
+ * Checks if the given value is {@link AccountGroupId}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link AccountGroupId}.
+ */
+function isAccountGroupId(value) {
+    return exports.ACCOUNT_GROUP_ID_REGEX.test(value);
+}
+/**
+ * Parse a multichain account group ID to an object containing a wallet ID
+ * information (wallet type and wallet sub-ID), as well as account group ID
+ * information (group sub-ID).
+ *
+ * @param groupId - The account group ID to validate and parse.
+ * @returns The parsed account group ID.
+ * @throws When the group ID format is invalid.
+ */
+function parseAccountGroupId(groupId) {
+    const match = exports.ACCOUNT_GROUP_ID_REGEX.exec(groupId);
+    if (!match?.groups) {
+        throw new Error(`Invalid account group ID: "${groupId}"`);
+    }
+    const walletId = match.groups.walletId;
+    const walletType = match.groups.walletType;
+    const walletSubId = match.groups.walletSubId;
+    return {
+        wallet: {
+            id: walletId,
+            type: walletType,
+            subId: walletSubId,
+        },
+        subId: match.groups.groupSubId,
+    };
+}
+/**
+ * Strip the account wallet ID from an account group ID.
+ *
+ * @param groupId - Account group ID.
+ * @returns Account group sub-ID.
+ * @throws When the group ID format is invalid.
+ */
+function stripAccountWalletId(groupId) {
+    return parseAccountGroupId(groupId).subId;
+}
 //# sourceMappingURL=group.cjs.map

package/dist/api/group.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"group.cjs","sourceRoot":"","sources":["../../src/api/group.ts"],"names":[],"mappings":";;;AAuGA,4CAKC;AAQD,0DAOC;AAhHD;;;;;GAKG;AACU,QAAA,+BAA+B,GAAW,SAAS,CAAC;AAEjE;;;;GAIG;AACH,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,kDAAkD;IAClD,4DAAwC,CAAA;IAExC,8CAA8C;IAC9C,oDAAgC,CAAA;AAClC,CAAC,EANW,gBAAgB,gCAAhB,gBAAgB,QAM3B;AAkED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,QAAuC,EACvC,EAAU;IAEV,OAAO,GAAG,QAAQ,IAAI,EAAE,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CACrC,QAAuC;IAEvC,OAAO,gBAAgB,CACrB,QAAQ,EACR,uCAA+B,CAChC,CAAC;AACJ,CAAC","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\n\n// Circular import are allowed when using `import type`.\nimport type { AccountSelector } from './selector';\nimport type {\n  AccountWallet,\n  AccountWalletId,\n  AccountWalletIdOf,\n  AccountWalletType,\n} from './wallet';\n\n/**\n * Default account group unique ID.\n *\n * This constant can be used to reference the \"default\" group from\n * an account wallet.\n */\nexport const DEFAULT_ACCOUNT_GROUP_UNIQUE_ID: string = 'default';\n\n/**\n * Account group object.\n *\n * Each group types groups accounts using different criterias.\n */\nexport enum AccountGroupType {\n  /** Group that represents a multichain account. */\n  MultichainAccount = 'multichain-account',\n\n  /** Group that represents a single account. */\n  SingleAccount = 'single-account',\n}\n\n/**\n * Account group ID.\n */\nexport type AccountGroupId = `${AccountWalletId}/${string}`;\n\n/**\n * Account group that can hold multiple accounts.\n */\nexport type AccountGroup<Account extends KeyringAccount> = {\n  /**\n   * Account group ID.\n   */\n  get id(): AccountGroupId;\n\n  /**\n   * Account group type.\n   */\n  get type(): AccountGroupType;\n\n  /**\n   * Account wallet (parent).\n   */\n  get wallet(): AccountWallet<Account>;\n\n  /**\n   * Gets the accounts for this account group.\n   *\n   * @returns The accounts.\n   */\n  getAccounts(): Account[];\n\n  /**\n   * Gets the account for a given account ID.\n   *\n   * @param id - Account ID.\n   * @returns The account or undefined if not found.\n   */\n  getAccount(id: Account['id']): Account | undefined;\n\n  /**\n   * Query an account matching the selector.\n   *\n   * @param selector - Query selector.\n   * @returns The account matching the selector or undefined if not matching.\n   * @throws If multiple accounts match the selector.\n   */\n  get(selector: AccountSelector<Account>): Account | undefined;\n\n  /**\n   * Query accounts matching the selector.\n   *\n   * @param selector - Query selector.\n   * @returns The accounts matching the selector.\n   */\n  select(selector: AccountSelector<Account>): Account[];\n};\n\n/**\n * Type utility to compute a constrained {@link AccountGroupId} type given a\n * specifc {@link AccountWalletType}.\n */\nexport type AccountGroupIdOf<WalletType extends AccountWalletType> =\n  `${AccountWalletIdOf<WalletType>}/${string}`;\n\n/**\n * Convert a wallet ID and a unique ID, to a group ID.\n *\n * @param walletId - A wallet ID.\n * @param id - A unique ID.\n * @returns A group ID.\n */\nexport function toAccountGroupId<WalletType extends AccountWalletType>(\n  walletId: AccountWalletIdOf<WalletType>,\n  id: string,\n): AccountGroupIdOf<WalletType> {\n  return `${walletId}/${id}`;\n}\n\n/**\n * Convert a wallet ID to the default group ID.\n *\n * @param walletId - A wallet ID.\n * @returns The default group ID.\n */\nexport function toDefaultAccountGroupId<WalletType extends AccountWalletType>(\n  walletId: AccountWalletIdOf<WalletType>,\n): AccountGroupIdOf<WalletType> {\n  return toAccountGroupId<WalletType>(\n    walletId,\n    DEFAULT_ACCOUNT_GROUP_UNIQUE_ID,\n  );\n}\n"]}
+{"version":3,"file":"group.cjs","sourceRoot":"","sources":["../../src/api/group.ts"],"names":[],"mappings":";;;AAyHA,4CAKC;AAQD,0DAOC;AAQD,4CAEC;AAWD,kDAkBC;AASD,oDAEC;AApLD;;;;;GAKG;AACU,QAAA,+BAA+B,GAAW,SAAS,CAAC;AAEjE;;;;GAIG;AACH,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,kDAAkD;IAClD,4DAAwC,CAAA;IAExC,8CAA8C;IAC9C,oDAAgC,CAAA;AAClC,CAAC,EANW,gBAAgB,gCAAhB,gBAAgB,QAM3B;AAOD;;GAEG;AACU,QAAA,sBAAsB,GACjC,8FAA8F,CAAC;AAyEjG;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,QAAuC,EACvC,EAAU;IAEV,OAAO,GAAG,QAAQ,IAAI,EAAE,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CACrC,QAAuC;IAEvC,OAAO,gBAAgB,CACrB,QAAQ,EACR,uCAA+B,CAChC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,KAAa;IAC5C,OAAO,8BAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,OAAe;IACjD,MAAM,KAAK,GAAG,8BAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,QAA2B,CAAC;IAC1D,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,UAA+B,CAAC;IAChE,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,WAAqB,CAAC;IAEvD,OAAO;QACL,MAAM,EAAE;YACN,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,WAAW;SACnB;QACD,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,UAAoB;KACzC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAAC,OAAe;IAClD,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\n\n// Circular import are allowed when using `import type`.\nimport type { AccountSelector } from './selector';\nimport {\n  type AccountWallet,\n  type AccountWalletId,\n  type AccountWalletIdOf,\n  type AccountWalletType,\n} from './wallet';\n\n/**\n * Default account group unique ID.\n *\n * This constant can be used to reference the \"default\" group from\n * an account wallet.\n */\nexport const DEFAULT_ACCOUNT_GROUP_UNIQUE_ID: string = 'default';\n\n/**\n * Account group object.\n *\n * Each group types groups accounts using different criterias.\n */\nexport enum AccountGroupType {\n  /** Group that represents a multichain account. */\n  MultichainAccount = 'multichain-account',\n\n  /** Group that represents a single account. */\n  SingleAccount = 'single-account',\n}\n\n/**\n * Account group ID.\n */\nexport type AccountGroupId = `${AccountWalletId}/${string}`;\n\n/**\n * Regex to validate a valid account group ID.\n */\nexport const ACCOUNT_GROUP_ID_REGEX =\n  /^(?<walletId>(?<walletType>entropy|snap|keyring):(?<walletSubId>.+))\\/(?<groupSubId>[^/]+)$/u;\n\n/**\n * Parsed account group ID with its parsed wallet component and its sub-ID.\n */\nexport type ParsedAccountGroupId = {\n  wallet: {\n    id: AccountWalletId;\n    type: AccountWalletType;\n    subId: string;\n  };\n  subId: string;\n};\n\n/**\n * Account group that can hold multiple accounts.\n */\nexport type AccountGroup<Account extends KeyringAccount> = {\n  /**\n   * Account group ID.\n   */\n  get id(): AccountGroupId;\n\n  /**\n   * Account group type.\n   */\n  get type(): AccountGroupType;\n\n  /**\n   * Account wallet (parent).\n   */\n  get wallet(): AccountWallet<Account>;\n\n  /**\n   * Gets the accounts for this account group.\n   *\n   * @returns The accounts.\n   */\n  getAccounts(): Account[];\n\n  /**\n   * Gets the account for a given account ID.\n   *\n   * @param id - Account ID.\n   * @returns The account or undefined if not found.\n   */\n  getAccount(id: Account['id']): Account | undefined;\n\n  /**\n   * Query an account matching the selector.\n   *\n   * @param selector - Query selector.\n   * @returns The account matching the selector or undefined if not matching.\n   * @throws If multiple accounts match the selector.\n   */\n  get(selector: AccountSelector<Account>): Account | undefined;\n\n  /**\n   * Query accounts matching the selector.\n   *\n   * @param selector - Query selector.\n   * @returns The accounts matching the selector.\n   */\n  select(selector: AccountSelector<Account>): Account[];\n};\n\n/**\n * Type utility to compute a constrained {@link AccountGroupId} type given a\n * specifc {@link AccountWalletType}.\n */\nexport type AccountGroupIdOf<WalletType extends AccountWalletType> =\n  `${AccountWalletIdOf<WalletType>}/${string}`;\n\n/**\n * Convert a wallet ID and a unique ID, to a group ID.\n *\n * @param walletId - A wallet ID.\n * @param id - A unique ID.\n * @returns A group ID.\n */\nexport function toAccountGroupId<WalletType extends AccountWalletType>(\n  walletId: AccountWalletIdOf<WalletType>,\n  id: string,\n): AccountGroupIdOf<WalletType> {\n  return `${walletId}/${id}`;\n}\n\n/**\n * Convert a wallet ID to the default group ID.\n *\n * @param walletId - A wallet ID.\n * @returns The default group ID.\n */\nexport function toDefaultAccountGroupId<WalletType extends AccountWalletType>(\n  walletId: AccountWalletIdOf<WalletType>,\n): AccountGroupIdOf<WalletType> {\n  return toAccountGroupId<WalletType>(\n    walletId,\n    DEFAULT_ACCOUNT_GROUP_UNIQUE_ID,\n  );\n}\n\n/**\n * Checks if the given value is {@link AccountGroupId}.\n *\n * @param value - The value to check.\n * @returns Whether the value is a {@link AccountGroupId}.\n */\nexport function isAccountGroupId(value: string): value is AccountGroupId {\n  return ACCOUNT_GROUP_ID_REGEX.test(value);\n}\n\n/**\n * Parse a multichain account group ID to an object containing a wallet ID\n * information (wallet type and wallet sub-ID), as well as account group ID\n * information (group sub-ID).\n *\n * @param groupId - The account group ID to validate and parse.\n * @returns The parsed account group ID.\n * @throws When the group ID format is invalid.\n */\nexport function parseAccountGroupId(groupId: string): ParsedAccountGroupId {\n  const match = ACCOUNT_GROUP_ID_REGEX.exec(groupId);\n  if (!match?.groups) {\n    throw new Error(`Invalid account group ID: \"${groupId}\"`);\n  }\n\n  const walletId = match.groups.walletId as AccountWalletId;\n  const walletType = match.groups.walletType as AccountWalletType;\n  const walletSubId = match.groups.walletSubId as string;\n\n  return {\n    wallet: {\n      id: walletId,\n      type: walletType,\n      subId: walletSubId,\n    },\n    subId: match.groups.groupSubId as string,\n  };\n}\n\n/**\n * Strip the account wallet ID from an account group ID.\n *\n * @param groupId - Account group ID.\n * @returns Account group sub-ID.\n * @throws When the group ID format is invalid.\n */\nexport function stripAccountWalletId(groupId: string): string {\n  return parseAccountGroupId(groupId).subId;\n}\n"]}

package/dist/api/group.d.cts

@@ -1,6 +1,6 @@
 import type { KeyringAccount } from "@metamask/keyring-api";
 import type { AccountSelector } from "./selector.cjs";
-import type { AccountWallet, AccountWalletId, AccountWalletIdOf, AccountWalletType } from "./wallet.cjs";
+import { type AccountWallet, type AccountWalletId, type AccountWalletIdOf, type AccountWalletType } from "./wallet.cjs";
 /**
  * Default account group unique ID.
  *
@@ -23,6 +23,21 @@ export declare enum AccountGroupType {
  * Account group ID.
  */
 export type AccountGroupId = `${AccountWalletId}/${string}`;
+/**
+ * Regex to validate a valid account group ID.
+ */
+export declare const ACCOUNT_GROUP_ID_REGEX: RegExp;
+/**
+ * Parsed account group ID with its parsed wallet component and its sub-ID.
+ */
+export type ParsedAccountGroupId = {
+    wallet: {
+        id: AccountWalletId;
+        type: AccountWalletType;
+        subId: string;
+    };
+    subId: string;
+};
 /**
  * Account group that can hold multiple accounts.
  */
@@ -88,4 +103,29 @@ export declare function toAccountGroupId<WalletType extends AccountWalletType>(w
  * @returns The default group ID.
  */
 export declare function toDefaultAccountGroupId<WalletType extends AccountWalletType>(walletId: AccountWalletIdOf<WalletType>): AccountGroupIdOf<WalletType>;
+/**
+ * Checks if the given value is {@link AccountGroupId}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link AccountGroupId}.
+ */
+export declare function isAccountGroupId(value: string): value is AccountGroupId;
+/**
+ * Parse a multichain account group ID to an object containing a wallet ID
+ * information (wallet type and wallet sub-ID), as well as account group ID
+ * information (group sub-ID).
+ *
+ * @param groupId - The account group ID to validate and parse.
+ * @returns The parsed account group ID.
+ * @throws When the group ID format is invalid.
+ */
+export declare function parseAccountGroupId(groupId: string): ParsedAccountGroupId;
+/**
+ * Strip the account wallet ID from an account group ID.
+ *
+ * @param groupId - Account group ID.
+ * @returns Account group sub-ID.
+ * @throws When the group ID format is invalid.
+ */
+export declare function stripAccountWalletId(groupId: string): string;
 //# sourceMappingURL=group.d.cts.map

package/dist/api/group.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"group.d.cts","sourceRoot":"","sources":["../../src/api/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAmB;AAClD,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EAClB,qBAAiB;AAElB;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAkB,CAAC;AAEjE;;;;GAIG;AACH,oBAAY,gBAAgB;IAC1B,kDAAkD;IAClD,iBAAiB,uBAAuB;IAExC,8CAA8C;IAC9C,aAAa,mBAAmB;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,eAAe,IAAI,MAAM,EAAE,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,OAAO,SAAS,cAAc,IAAI;IACzD;;OAEG;IACH,IAAI,EAAE,IAAI,cAAc,CAAC;IAEzB;;OAEG;IACH,IAAI,IAAI,IAAI,gBAAgB,CAAC;IAE7B;;OAEG;IACH,IAAI,MAAM,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAErC;;;;OAIG;IACH,WAAW,IAAI,OAAO,EAAE,CAAC;IAEzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC;IAEnD;;;;;;OAMG;IACH,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC;IAE7D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;CACvD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,UAAU,SAAS,iBAAiB,IAC/D,GAAG,iBAAiB,CAAC,UAAU,CAAC,IAAI,MAAM,EAAE,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,SAAS,iBAAiB,EACnE,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,EACvC,EAAE,EAAE,MAAM,GACT,gBAAgB,CAAC,UAAU,CAAC,CAE9B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,SAAS,iBAAiB,EAC1E,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,GACtC,gBAAgB,CAAC,UAAU,CAAC,CAK9B"}
+{"version":3,"file":"group.d.cts","sourceRoot":"","sources":["../../src/api/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAmB;AAClD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,qBAAiB;AAElB;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAkB,CAAC;AAEjE;;;;GAIG;AACH,oBAAY,gBAAgB;IAC1B,kDAAkD;IAClD,iBAAiB,uBAAuB;IAExC,8CAA8C;IAC9C,aAAa,mBAAmB;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,eAAe,IAAI,MAAM,EAAE,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAC6D,CAAC;AAEjG;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE;QACN,EAAE,EAAE,eAAe,CAAC;QACpB,IAAI,EAAE,iBAAiB,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,OAAO,SAAS,cAAc,IAAI;IACzD;;OAEG;IACH,IAAI,EAAE,IAAI,cAAc,CAAC;IAEzB;;OAEG;IACH,IAAI,IAAI,IAAI,gBAAgB,CAAC;IAE7B;;OAEG;IACH,IAAI,MAAM,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAErC;;;;OAIG;IACH,WAAW,IAAI,OAAO,EAAE,CAAC;IAEzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC;IAEnD;;;;;;OAMG;IACH,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC;IAE7D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;CACvD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,UAAU,SAAS,iBAAiB,IAC/D,GAAG,iBAAiB,CAAC,UAAU,CAAC,IAAI,MAAM,EAAE,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,SAAS,iBAAiB,EACnE,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,EACvC,EAAE,EAAE,MAAM,GACT,gBAAgB,CAAC,UAAU,CAAC,CAE9B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,SAAS,iBAAiB,EAC1E,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,GACtC,gBAAgB,CAAC,UAAU,CAAC,CAK9B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAkBzE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/api/group.d.mts

@@ -1,6 +1,6 @@
 import type { KeyringAccount } from "@metamask/keyring-api";
 import type { AccountSelector } from "./selector.mjs";
-import type { AccountWallet, AccountWalletId, AccountWalletIdOf, AccountWalletType } from "./wallet.mjs";
+import { type AccountWallet, type AccountWalletId, type AccountWalletIdOf, type AccountWalletType } from "./wallet.mjs";
 /**
  * Default account group unique ID.
  *
@@ -23,6 +23,21 @@ export declare enum AccountGroupType {
  * Account group ID.
  */
 export type AccountGroupId = `${AccountWalletId}/${string}`;
+/**
+ * Regex to validate a valid account group ID.
+ */
+export declare const ACCOUNT_GROUP_ID_REGEX: RegExp;
+/**
+ * Parsed account group ID with its parsed wallet component and its sub-ID.
+ */
+export type ParsedAccountGroupId = {
+    wallet: {
+        id: AccountWalletId;
+        type: AccountWalletType;
+        subId: string;
+    };
+    subId: string;
+};
 /**
  * Account group that can hold multiple accounts.
  */
@@ -88,4 +103,29 @@ export declare function toAccountGroupId<WalletType extends AccountWalletType>(w
  * @returns The default group ID.
  */
 export declare function toDefaultAccountGroupId<WalletType extends AccountWalletType>(walletId: AccountWalletIdOf<WalletType>): AccountGroupIdOf<WalletType>;
+/**
+ * Checks if the given value is {@link AccountGroupId}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link AccountGroupId}.
+ */
+export declare function isAccountGroupId(value: string): value is AccountGroupId;
+/**
+ * Parse a multichain account group ID to an object containing a wallet ID
+ * information (wallet type and wallet sub-ID), as well as account group ID
+ * information (group sub-ID).
+ *
+ * @param groupId - The account group ID to validate and parse.
+ * @returns The parsed account group ID.
+ * @throws When the group ID format is invalid.
+ */
+export declare function parseAccountGroupId(groupId: string): ParsedAccountGroupId;
+/**
+ * Strip the account wallet ID from an account group ID.
+ *
+ * @param groupId - Account group ID.
+ * @returns Account group sub-ID.
+ * @throws When the group ID format is invalid.
+ */
+export declare function stripAccountWalletId(groupId: string): string;
 //# sourceMappingURL=group.d.mts.map

package/dist/api/group.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"group.d.mts","sourceRoot":"","sources":["../../src/api/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAmB;AAClD,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EAClB,qBAAiB;AAElB;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAkB,CAAC;AAEjE;;;;GAIG;AACH,oBAAY,gBAAgB;IAC1B,kDAAkD;IAClD,iBAAiB,uBAAuB;IAExC,8CAA8C;IAC9C,aAAa,mBAAmB;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,eAAe,IAAI,MAAM,EAAE,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,OAAO,SAAS,cAAc,IAAI;IACzD;;OAEG;IACH,IAAI,EAAE,IAAI,cAAc,CAAC;IAEzB;;OAEG;IACH,IAAI,IAAI,IAAI,gBAAgB,CAAC;IAE7B;;OAEG;IACH,IAAI,MAAM,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAErC;;;;OAIG;IACH,WAAW,IAAI,OAAO,EAAE,CAAC;IAEzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC;IAEnD;;;;;;OAMG;IACH,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC;IAE7D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;CACvD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,UAAU,SAAS,iBAAiB,IAC/D,GAAG,iBAAiB,CAAC,UAAU,CAAC,IAAI,MAAM,EAAE,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,SAAS,iBAAiB,EACnE,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,EACvC,EAAE,EAAE,MAAM,GACT,gBAAgB,CAAC,UAAU,CAAC,CAE9B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,SAAS,iBAAiB,EAC1E,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,GACtC,gBAAgB,CAAC,UAAU,CAAC,CAK9B"}
+{"version":3,"file":"group.d.mts","sourceRoot":"","sources":["../../src/api/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAmB;AAClD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,qBAAiB;AAElB;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAkB,CAAC;AAEjE;;;;GAIG;AACH,oBAAY,gBAAgB;IAC1B,kDAAkD;IAClD,iBAAiB,uBAAuB;IAExC,8CAA8C;IAC9C,aAAa,mBAAmB;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,eAAe,IAAI,MAAM,EAAE,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAC6D,CAAC;AAEjG;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE;QACN,EAAE,EAAE,eAAe,CAAC;QACpB,IAAI,EAAE,iBAAiB,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,OAAO,SAAS,cAAc,IAAI;IACzD;;OAEG;IACH,IAAI,EAAE,IAAI,cAAc,CAAC;IAEzB;;OAEG;IACH,IAAI,IAAI,IAAI,gBAAgB,CAAC;IAE7B;;OAEG;IACH,IAAI,MAAM,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAErC;;;;OAIG;IACH,WAAW,IAAI,OAAO,EAAE,CAAC;IAEzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC;IAEnD;;;;;;OAMG;IACH,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC;IAE7D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;CACvD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,UAAU,SAAS,iBAAiB,IAC/D,GAAG,iBAAiB,CAAC,UAAU,CAAC,IAAI,MAAM,EAAE,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,SAAS,iBAAiB,EACnE,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,EACvC,EAAE,EAAE,MAAM,GACT,gBAAgB,CAAC,UAAU,CAAC,CAE9B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,SAAS,iBAAiB,EAC1E,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,GACtC,gBAAgB,CAAC,UAAU,CAAC,CAK9B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAkBzE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/api/group.mjs

@@ -17,6 +17,10 @@ export var AccountGroupType;
     /** Group that represents a single account. */
     AccountGroupType["SingleAccount"] = "single-account";
 })(AccountGroupType || (AccountGroupType = {}));
+/**
+ * Regex to validate a valid account group ID.
+ */
+export const ACCOUNT_GROUP_ID_REGEX = /^(?<walletId>(?<walletType>entropy|snap|keyring):(?<walletSubId>.+))\/(?<groupSubId>[^/]+)$/u;
 /**
  * Convert a wallet ID and a unique ID, to a group ID.
  *
@@ -36,4 +40,49 @@ export function toAccountGroupId(walletId, id) {
 export function toDefaultAccountGroupId(walletId) {
     return toAccountGroupId(walletId, DEFAULT_ACCOUNT_GROUP_UNIQUE_ID);
 }
+/**
+ * Checks if the given value is {@link AccountGroupId}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link AccountGroupId}.
+ */
+export function isAccountGroupId(value) {
+    return ACCOUNT_GROUP_ID_REGEX.test(value);
+}
+/**
+ * Parse a multichain account group ID to an object containing a wallet ID
+ * information (wallet type and wallet sub-ID), as well as account group ID
+ * information (group sub-ID).
+ *
+ * @param groupId - The account group ID to validate and parse.
+ * @returns The parsed account group ID.
+ * @throws When the group ID format is invalid.
+ */
+export function parseAccountGroupId(groupId) {
+    const match = ACCOUNT_GROUP_ID_REGEX.exec(groupId);
+    if (!match?.groups) {
+        throw new Error(`Invalid account group ID: "${groupId}"`);
+    }
+    const walletId = match.groups.walletId;
+    const walletType = match.groups.walletType;
+    const walletSubId = match.groups.walletSubId;
+    return {
+        wallet: {
+            id: walletId,
+            type: walletType,
+            subId: walletSubId,
+        },
+        subId: match.groups.groupSubId,
+    };
+}
+/**
+ * Strip the account wallet ID from an account group ID.
+ *
+ * @param groupId - Account group ID.
+ * @returns Account group sub-ID.
+ * @throws When the group ID format is invalid.
+ */
+export function stripAccountWalletId(groupId) {
+    return parseAccountGroupId(groupId).subId;
+}
 //# sourceMappingURL=group.mjs.map

package/dist/api/group.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"group.mjs","sourceRoot":"","sources":["../../src/api/group.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAW,SAAS,CAAC;AAEjE;;;;GAIG;AACH,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,kDAAkD;IAClD,4DAAwC,CAAA;IAExC,8CAA8C;IAC9C,oDAAgC,CAAA;AAClC,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B;AAkED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAuC,EACvC,EAAU;IAEV,OAAO,GAAG,QAAQ,IAAI,EAAE,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAuC;IAEvC,OAAO,gBAAgB,CACrB,QAAQ,EACR,+BAA+B,CAChC,CAAC;AACJ,CAAC","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\n\n// Circular import are allowed when using `import type`.\nimport type { AccountSelector } from './selector';\nimport type {\n  AccountWallet,\n  AccountWalletId,\n  AccountWalletIdOf,\n  AccountWalletType,\n} from './wallet';\n\n/**\n * Default account group unique ID.\n *\n * This constant can be used to reference the \"default\" group from\n * an account wallet.\n */\nexport const DEFAULT_ACCOUNT_GROUP_UNIQUE_ID: string = 'default';\n\n/**\n * Account group object.\n *\n * Each group types groups accounts using different criterias.\n */\nexport enum AccountGroupType {\n  /** Group that represents a multichain account. */\n  MultichainAccount = 'multichain-account',\n\n  /** Group that represents a single account. */\n  SingleAccount = 'single-account',\n}\n\n/**\n * Account group ID.\n */\nexport type AccountGroupId = `${AccountWalletId}/${string}`;\n\n/**\n * Account group that can hold multiple accounts.\n */\nexport type AccountGroup<Account extends KeyringAccount> = {\n  /**\n   * Account group ID.\n   */\n  get id(): AccountGroupId;\n\n  /**\n   * Account group type.\n   */\n  get type(): AccountGroupType;\n\n  /**\n   * Account wallet (parent).\n   */\n  get wallet(): AccountWallet<Account>;\n\n  /**\n   * Gets the accounts for this account group.\n   *\n   * @returns The accounts.\n   */\n  getAccounts(): Account[];\n\n  /**\n   * Gets the account for a given account ID.\n   *\n   * @param id - Account ID.\n   * @returns The account or undefined if not found.\n   */\n  getAccount(id: Account['id']): Account | undefined;\n\n  /**\n   * Query an account matching the selector.\n   *\n   * @param selector - Query selector.\n   * @returns The account matching the selector or undefined if not matching.\n   * @throws If multiple accounts match the selector.\n   */\n  get(selector: AccountSelector<Account>): Account | undefined;\n\n  /**\n   * Query accounts matching the selector.\n   *\n   * @param selector - Query selector.\n   * @returns The accounts matching the selector.\n   */\n  select(selector: AccountSelector<Account>): Account[];\n};\n\n/**\n * Type utility to compute a constrained {@link AccountGroupId} type given a\n * specifc {@link AccountWalletType}.\n */\nexport type AccountGroupIdOf<WalletType extends AccountWalletType> =\n  `${AccountWalletIdOf<WalletType>}/${string}`;\n\n/**\n * Convert a wallet ID and a unique ID, to a group ID.\n *\n * @param walletId - A wallet ID.\n * @param id - A unique ID.\n * @returns A group ID.\n */\nexport function toAccountGroupId<WalletType extends AccountWalletType>(\n  walletId: AccountWalletIdOf<WalletType>,\n  id: string,\n): AccountGroupIdOf<WalletType> {\n  return `${walletId}/${id}`;\n}\n\n/**\n * Convert a wallet ID to the default group ID.\n *\n * @param walletId - A wallet ID.\n * @returns The default group ID.\n */\nexport function toDefaultAccountGroupId<WalletType extends AccountWalletType>(\n  walletId: AccountWalletIdOf<WalletType>,\n): AccountGroupIdOf<WalletType> {\n  return toAccountGroupId<WalletType>(\n    walletId,\n    DEFAULT_ACCOUNT_GROUP_UNIQUE_ID,\n  );\n}\n"]}
+{"version":3,"file":"group.mjs","sourceRoot":"","sources":["../../src/api/group.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAW,SAAS,CAAC;AAEjE;;;;GAIG;AACH,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,kDAAkD;IAClD,4DAAwC,CAAA;IAExC,8CAA8C;IAC9C,oDAAgC,CAAA;AAClC,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B;AAOD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GACjC,8FAA8F,CAAC;AAyEjG;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAuC,EACvC,EAAU;IAEV,OAAO,GAAG,QAAQ,IAAI,EAAE,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAuC;IAEvC,OAAO,gBAAgB,CACrB,QAAQ,EACR,+BAA+B,CAChC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,QAA2B,CAAC;IAC1D,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,UAA+B,CAAC;IAChE,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,WAAqB,CAAC;IAEvD,OAAO;QACL,MAAM,EAAE;YACN,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,WAAW;SACnB;QACD,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,UAAoB;KACzC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\n\n// Circular import are allowed when using `import type`.\nimport type { AccountSelector } from './selector';\nimport {\n  type AccountWallet,\n  type AccountWalletId,\n  type AccountWalletIdOf,\n  type AccountWalletType,\n} from './wallet';\n\n/**\n * Default account group unique ID.\n *\n * This constant can be used to reference the \"default\" group from\n * an account wallet.\n */\nexport const DEFAULT_ACCOUNT_GROUP_UNIQUE_ID: string = 'default';\n\n/**\n * Account group object.\n *\n * Each group types groups accounts using different criterias.\n */\nexport enum AccountGroupType {\n  /** Group that represents a multichain account. */\n  MultichainAccount = 'multichain-account',\n\n  /** Group that represents a single account. */\n  SingleAccount = 'single-account',\n}\n\n/**\n * Account group ID.\n */\nexport type AccountGroupId = `${AccountWalletId}/${string}`;\n\n/**\n * Regex to validate a valid account group ID.\n */\nexport const ACCOUNT_GROUP_ID_REGEX =\n  /^(?<walletId>(?<walletType>entropy|snap|keyring):(?<walletSubId>.+))\\/(?<groupSubId>[^/]+)$/u;\n\n/**\n * Parsed account group ID with its parsed wallet component and its sub-ID.\n */\nexport type ParsedAccountGroupId = {\n  wallet: {\n    id: AccountWalletId;\n    type: AccountWalletType;\n    subId: string;\n  };\n  subId: string;\n};\n\n/**\n * Account group that can hold multiple accounts.\n */\nexport type AccountGroup<Account extends KeyringAccount> = {\n  /**\n   * Account group ID.\n   */\n  get id(): AccountGroupId;\n\n  /**\n   * Account group type.\n   */\n  get type(): AccountGroupType;\n\n  /**\n   * Account wallet (parent).\n   */\n  get wallet(): AccountWallet<Account>;\n\n  /**\n   * Gets the accounts for this account group.\n   *\n   * @returns The accounts.\n   */\n  getAccounts(): Account[];\n\n  /**\n   * Gets the account for a given account ID.\n   *\n   * @param id - Account ID.\n   * @returns The account or undefined if not found.\n   */\n  getAccount(id: Account['id']): Account | undefined;\n\n  /**\n   * Query an account matching the selector.\n   *\n   * @param selector - Query selector.\n   * @returns The account matching the selector or undefined if not matching.\n   * @throws If multiple accounts match the selector.\n   */\n  get(selector: AccountSelector<Account>): Account | undefined;\n\n  /**\n   * Query accounts matching the selector.\n   *\n   * @param selector - Query selector.\n   * @returns The accounts matching the selector.\n   */\n  select(selector: AccountSelector<Account>): Account[];\n};\n\n/**\n * Type utility to compute a constrained {@link AccountGroupId} type given a\n * specifc {@link AccountWalletType}.\n */\nexport type AccountGroupIdOf<WalletType extends AccountWalletType> =\n  `${AccountWalletIdOf<WalletType>}/${string}`;\n\n/**\n * Convert a wallet ID and a unique ID, to a group ID.\n *\n * @param walletId - A wallet ID.\n * @param id - A unique ID.\n * @returns A group ID.\n */\nexport function toAccountGroupId<WalletType extends AccountWalletType>(\n  walletId: AccountWalletIdOf<WalletType>,\n  id: string,\n): AccountGroupIdOf<WalletType> {\n  return `${walletId}/${id}`;\n}\n\n/**\n * Convert a wallet ID to the default group ID.\n *\n * @param walletId - A wallet ID.\n * @returns The default group ID.\n */\nexport function toDefaultAccountGroupId<WalletType extends AccountWalletType>(\n  walletId: AccountWalletIdOf<WalletType>,\n): AccountGroupIdOf<WalletType> {\n  return toAccountGroupId<WalletType>(\n    walletId,\n    DEFAULT_ACCOUNT_GROUP_UNIQUE_ID,\n  );\n}\n\n/**\n * Checks if the given value is {@link AccountGroupId}.\n *\n * @param value - The value to check.\n * @returns Whether the value is a {@link AccountGroupId}.\n */\nexport function isAccountGroupId(value: string): value is AccountGroupId {\n  return ACCOUNT_GROUP_ID_REGEX.test(value);\n}\n\n/**\n * Parse a multichain account group ID to an object containing a wallet ID\n * information (wallet type and wallet sub-ID), as well as account group ID\n * information (group sub-ID).\n *\n * @param groupId - The account group ID to validate and parse.\n * @returns The parsed account group ID.\n * @throws When the group ID format is invalid.\n */\nexport function parseAccountGroupId(groupId: string): ParsedAccountGroupId {\n  const match = ACCOUNT_GROUP_ID_REGEX.exec(groupId);\n  if (!match?.groups) {\n    throw new Error(`Invalid account group ID: \"${groupId}\"`);\n  }\n\n  const walletId = match.groups.walletId as AccountWalletId;\n  const walletType = match.groups.walletType as AccountWalletType;\n  const walletSubId = match.groups.walletSubId as string;\n\n  return {\n    wallet: {\n      id: walletId,\n      type: walletType,\n      subId: walletSubId,\n    },\n    subId: match.groups.groupSubId as string,\n  };\n}\n\n/**\n * Strip the account wallet ID from an account group ID.\n *\n * @param groupId - Account group ID.\n * @returns Account group sub-ID.\n * @throws When the group ID format is invalid.\n */\nexport function stripAccountWalletId(groupId: string): string {\n  return parseAccountGroupId(groupId).subId;\n}\n"]}

package/dist/api/multichain/group.cjs

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MULTICHAIN_ACCOUNT_GROUP_ID_REGEX = void 0;
 exports.toMultichainAccountGroupId = toMultichainAccountGroupId;
 exports.isMultichainAccountGroupId = isMultichainAccountGroupId;
+exports.parseMultichainAccountGroupId = parseMultichainAccountGroupId;
 exports.getGroupIndexFromMultichainAccountGroupId = getGroupIndexFromMultichainAccountGroupId;
-const wallet_1 = require("../wallet.cjs");
-const MULTICHAIN_ACCOUNT_GROUP_ID_REGEX = new RegExp(`^${wallet_1.AccountWalletType.Entropy}:.*/(?<groupIndex>\\d+)$`, 'u');
+/**
+ * Regex to validate a valid multichain account group ID.
+ */
+exports.MULTICHAIN_ACCOUNT_GROUP_ID_REGEX = /^(?<walletId>(?<walletType>entropy):(?<walletSubId>.+))\/(?<groupIndex>[0-9]+)$/u;
 /**
  * Gets the multichain account group ID from its multichain account wallet ID and its index.
  *
@@ -22,21 +26,42 @@ function toMultichainAccountGroupId(walletId, groupIndex) {
  * @returns Whether the value is a {@link MultichainAccountGroupId}.
  */
 function isMultichainAccountGroupId(value) {
-    return MULTICHAIN_ACCOUNT_GROUP_ID_REGEX.test(value);
+    return exports.MULTICHAIN_ACCOUNT_GROUP_ID_REGEX.test(value);
+}
+/**
+ * Parse a multichain account group ID to an object containing a multichain
+ * wallet ID information (wallet type and wallet sub-ID), as well as
+ * multichain account group ID information (group index).
+ *
+ * @param groupId - The multichain account group ID to validate and parse.
+ * @returns The parsed multichain account group ID.
+ * @throws When the group ID format is invalid.
+ */
+function parseMultichainAccountGroupId(groupId) {
+    const match = exports.MULTICHAIN_ACCOUNT_GROUP_ID_REGEX.exec(groupId);
+    if (!match?.groups) {
+        throw new Error(`Invalid multichain account group ID: "${groupId}"`);
+    }
+    const walletId = match.groups.walletId;
+    const walletType = match.groups.walletType;
+    const walletSubId = match.groups.walletSubId;
+    return {
+        wallet: {
+            id: walletId,
+            type: walletType,
+            subId: walletSubId,
+        },
+        groupIndex: Number(match.groups.groupIndex),
+    };
 }
 /**
  * Gets the multichain account index from an account group ID.
  *
  * @param id - Multichain account ID.
  * @returns The multichain account index if extractable, undefined otherwise.
+ * @throws When the group ID format is invalid.
  */
 function getGroupIndexFromMultichainAccountGroupId(id) {
-    const matched = id.match(MULTICHAIN_ACCOUNT_GROUP_ID_REGEX);
-    if (matched?.groups?.groupIndex === undefined) {
-        // Unable to extract group index, even though, type wise, this should not
-        // be possible!
-        throw new Error('Unable to extract group index');
-    }
-    return Number(matched.groups.groupIndex);
+    return parseMultichainAccountGroupId(id).groupIndex;
 }
 //# sourceMappingURL=group.cjs.map

package/dist/api/multichain/group.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"group.cjs","sourceRoot":"","sources":["../../../src/api/multichain/group.ts"],"names":[],"mappings":";;AAsDA,gEAKC;AAQD,gEAIC;AAQD,8FAWC;AAlFD,0CAA8C;AAE9C,MAAM,iCAAiC,GAAG,IAAI,MAAM,CAClD,IAAI,0BAAiB,CAAC,OAAO,0BAA0B,EACvD,GAAG,CACJ,CAAC;AAkCF;;;;;;GAMG;AACH,SAAgB,0BAA0B,CACxC,QAAmC,EACnC,UAAkB;IAElB,OAAO,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,0BAA0B,CACxC,KAAa;IAEb,OAAO,iCAAiC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,yCAAyC,CACvD,EAA4B;IAE5B,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC5D,IAAI,OAAO,EAAE,MAAM,EAAE,UAAU,KAAK,SAAS,EAAE,CAAC;QAC9C,yEAAyE;QACzE,eAAe;QACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["import { type KeyringAccount } from '@metamask/keyring-api';\n\nimport type {\n  MultichainAccountWallet,\n  MultichainAccountWalletId,\n} from './wallet';\nimport type { Bip44Account } from '../bip44';\nimport type { AccountGroup, AccountGroupType } from '../group';\nimport { AccountWalletType } from '../wallet';\n\nconst MULTICHAIN_ACCOUNT_GROUP_ID_REGEX = new RegExp(\n  `^${AccountWalletType.Entropy}:.*/(?<groupIndex>\\\\d+)$`,\n  'u',\n);\n\n/**\n * Multichain account ID.\n */\nexport type MultichainAccountGroupId = `${MultichainAccountWalletId}/${number}`; // Use number for the account group index.\n\n/**\n * A multichain account that holds multiple accounts.\n */\nexport type MultichainAccountGroup<\n  Account extends Bip44Account<KeyringAccount>,\n> = AccountGroup<Account> & {\n  /**\n   * Multichain account group ID.\n   */\n  get id(): MultichainAccountGroupId;\n\n  /**\n   * Multichain account type.\n   */\n  get type(): AccountGroupType.MultichainAccount;\n\n  /**\n   * Multichain account's wallet reference (parent).\n   */\n  get wallet(): MultichainAccountWallet<Account>;\n\n  /**\n   * Multichain account group index.\n   */\n  get groupIndex(): number;\n};\n\n/**\n * Gets the multichain account group ID from its multichain account wallet ID and its index.\n *\n * @param walletId - Multichain account wallet ID.\n * @param groupIndex - Index of that multichain account.\n * @returns The multichain account ID.\n */\nexport function toMultichainAccountGroupId(\n  walletId: MultichainAccountWalletId,\n  groupIndex: number,\n): MultichainAccountGroupId {\n  return `${walletId}/${groupIndex}`;\n}\n\n/**\n * Checks if the given value is {@link MultichainAccountGroupId}.\n *\n * @param value - The value to check.\n * @returns Whether the value is a {@link MultichainAccountGroupId}.\n */\nexport function isMultichainAccountGroupId(\n  value: string,\n): value is MultichainAccountGroupId {\n  return MULTICHAIN_ACCOUNT_GROUP_ID_REGEX.test(value);\n}\n\n/**\n * Gets the multichain account index from an account group ID.\n *\n * @param id - Multichain account ID.\n * @returns The multichain account index if extractable, undefined otherwise.\n */\nexport function getGroupIndexFromMultichainAccountGroupId(\n  id: MultichainAccountGroupId,\n): number {\n  const matched = id.match(MULTICHAIN_ACCOUNT_GROUP_ID_REGEX);\n  if (matched?.groups?.groupIndex === undefined) {\n    // Unable to extract group index, even though, type wise, this should not\n    // be possible!\n    throw new Error('Unable to extract group index');\n  }\n\n  return Number(matched.groups.groupIndex);\n}\n"]}
+{"version":3,"file":"group.cjs","sourceRoot":"","sources":["../../../src/api/multichain/group.ts"],"names":[],"mappings":";;;AAmEA,gEAKC;AAQD,gEAIC;AAWD,sEAoBC;AASD,8FAIC;AAjHD;;GAEG;AACU,QAAA,iCAAiC,GAC5C,kFAAkF,CAAC;AAyCrF;;;;;;GAMG;AACH,SAAgB,0BAA0B,CACxC,QAAmC,EACnC,UAAkB;IAElB,OAAO,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,0BAA0B,CACxC,KAAa;IAEb,OAAO,yCAAiC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,6BAA6B,CAC3C,OAAe;IAEf,MAAM,KAAK,GAAG,yCAAiC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,GAAG,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,QAAqC,CAAC;IACpE,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,UAAuC,CAAC;IACxE,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,WAAqB,CAAC;IAEvD,OAAO;QACL,MAAM,EAAE;YACN,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,WAAW;SACnB;QACD,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,yCAAyC,CACvD,EAA4B;IAE5B,OAAO,6BAA6B,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;AACtD,CAAC","sourcesContent":["import { type KeyringAccount } from '@metamask/keyring-api';\n\nimport type {\n  MultichainAccountWallet,\n  MultichainAccountWalletId,\n} from './wallet';\nimport type { Bip44Account } from '../bip44';\nimport type { AccountGroup, AccountGroupType } from '../group';\nimport type { AccountWalletType } from '../wallet';\n\n/**\n * Multichain account ID.\n */\nexport type MultichainAccountGroupId = `${MultichainAccountWalletId}/${number}`; // Use number for the account group index.\n\n/**\n * Regex to validate a valid multichain account group ID.\n */\nexport const MULTICHAIN_ACCOUNT_GROUP_ID_REGEX =\n  /^(?<walletId>(?<walletType>entropy):(?<walletSubId>.+))\\/(?<groupIndex>[0-9]+)$/u;\n\n/**\n * Parsed account group ID with its parsed wallet component and its sub-ID.\n */\nexport type ParsedMultichainAccountGroupId = {\n  wallet: {\n    id: MultichainAccountWalletId;\n    type: AccountWalletType.Entropy;\n    subId: string;\n  };\n  groupIndex: number;\n};\n\n/**\n * A multichain account that holds multiple accounts.\n */\nexport type MultichainAccountGroup<\n  Account extends Bip44Account<KeyringAccount>,\n> = AccountGroup<Account> & {\n  /**\n   * Multichain account group ID.\n   */\n  get id(): MultichainAccountGroupId;\n\n  /**\n   * Multichain account type.\n   */\n  get type(): AccountGroupType.MultichainAccount;\n\n  /**\n   * Multichain account's wallet reference (parent).\n   */\n  get wallet(): MultichainAccountWallet<Account>;\n\n  /**\n   * Multichain account group index.\n   */\n  get groupIndex(): number;\n};\n\n/**\n * Gets the multichain account group ID from its multichain account wallet ID and its index.\n *\n * @param walletId - Multichain account wallet ID.\n * @param groupIndex - Index of that multichain account.\n * @returns The multichain account ID.\n */\nexport function toMultichainAccountGroupId(\n  walletId: MultichainAccountWalletId,\n  groupIndex: number,\n): MultichainAccountGroupId {\n  return `${walletId}/${groupIndex}`;\n}\n\n/**\n * Checks if the given value is {@link MultichainAccountGroupId}.\n *\n * @param value - The value to check.\n * @returns Whether the value is a {@link MultichainAccountGroupId}.\n */\nexport function isMultichainAccountGroupId(\n  value: string,\n): value is MultichainAccountGroupId {\n  return MULTICHAIN_ACCOUNT_GROUP_ID_REGEX.test(value);\n}\n\n/**\n * Parse a multichain account group ID to an object containing a multichain\n * wallet ID information (wallet type and wallet sub-ID), as well as\n * multichain account group ID information (group index).\n *\n * @param groupId - The multichain account group ID to validate and parse.\n * @returns The parsed multichain account group ID.\n * @throws When the group ID format is invalid.\n */\nexport function parseMultichainAccountGroupId(\n  groupId: string,\n): ParsedMultichainAccountGroupId {\n  const match = MULTICHAIN_ACCOUNT_GROUP_ID_REGEX.exec(groupId);\n  if (!match?.groups) {\n    throw new Error(`Invalid multichain account group ID: \"${groupId}\"`);\n  }\n\n  const walletId = match.groups.walletId as MultichainAccountWalletId;\n  const walletType = match.groups.walletType as AccountWalletType.Entropy;\n  const walletSubId = match.groups.walletSubId as string;\n\n  return {\n    wallet: {\n      id: walletId,\n      type: walletType,\n      subId: walletSubId,\n    },\n    groupIndex: Number(match.groups.groupIndex),\n  };\n}\n\n/**\n * Gets the multichain account index from an account group ID.\n *\n * @param id - Multichain account ID.\n * @returns The multichain account index if extractable, undefined otherwise.\n * @throws When the group ID format is invalid.\n */\nexport function getGroupIndexFromMultichainAccountGroupId(\n  id: MultichainAccountGroupId,\n): number {\n  return parseMultichainAccountGroupId(id).groupIndex;\n}\n"]}

package/dist/api/multichain/group.d.cts

@@ -2,10 +2,26 @@ import { type KeyringAccount } from "@metamask/keyring-api";
 import type { MultichainAccountWallet, MultichainAccountWalletId } from "./wallet.cjs";
 import type { Bip44Account } from "../bip44.cjs";
 import type { AccountGroup, AccountGroupType } from "../group.cjs";
+import type { AccountWalletType } from "../wallet.cjs";
 /**
  * Multichain account ID.
  */
 export type MultichainAccountGroupId = `${MultichainAccountWalletId}/${number}`;
+/**
+ * Regex to validate a valid multichain account group ID.
+ */
+export declare const MULTICHAIN_ACCOUNT_GROUP_ID_REGEX: RegExp;
+/**
+ * Parsed account group ID with its parsed wallet component and its sub-ID.
+ */
+export type ParsedMultichainAccountGroupId = {
+    wallet: {
+        id: MultichainAccountWalletId;
+        type: AccountWalletType.Entropy;
+        subId: string;
+    };
+    groupIndex: number;
+};
 /**
  * A multichain account that holds multiple accounts.
  */
@@ -42,11 +58,22 @@ export declare function toMultichainAccountGroupId(walletId: MultichainAccountWa
  * @returns Whether the value is a {@link MultichainAccountGroupId}.
  */
 export declare function isMultichainAccountGroupId(value: string): value is MultichainAccountGroupId;
+/**
+ * Parse a multichain account group ID to an object containing a multichain
+ * wallet ID information (wallet type and wallet sub-ID), as well as
+ * multichain account group ID information (group index).
+ *
+ * @param groupId - The multichain account group ID to validate and parse.
+ * @returns The parsed multichain account group ID.
+ * @throws When the group ID format is invalid.
+ */
+export declare function parseMultichainAccountGroupId(groupId: string): ParsedMultichainAccountGroupId;
 /**
  * Gets the multichain account index from an account group ID.
  *
  * @param id - Multichain account ID.
  * @returns The multichain account index if extractable, undefined otherwise.
+ * @throws When the group ID format is invalid.
  */
 export declare function getGroupIndexFromMultichainAccountGroupId(id: MultichainAccountGroupId): number;
 //# sourceMappingURL=group.d.cts.map

package/dist/api/multichain/group.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"group.d.cts","sourceRoot":"","sources":["../../../src/api/multichain/group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,8BAA8B;AAE5D,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,qBAAiB;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAiB;AAQ/D;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,GAAG,yBAAyB,IAAI,MAAM,EAAE,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAChC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,IAC1C,YAAY,CAAC,OAAO,CAAC,GAAG;IAC1B;;OAEG;IACH,IAAI,EAAE,IAAI,wBAAwB,CAAC;IAEnC;;OAEG;IACH,IAAI,IAAI,IAAI,gBAAgB,CAAC,iBAAiB,CAAC;IAE/C;;OAEG;IACH,IAAI,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAE/C;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,yBAAyB,EACnC,UAAU,EAAE,MAAM,GACjB,wBAAwB,CAE1B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,wBAAwB,CAEnC;AAED;;;;;GAKG;AACH,wBAAgB,yCAAyC,CACvD,EAAE,EAAE,wBAAwB,GAC3B,MAAM,CASR"}
+{"version":3,"file":"group.d.cts","sourceRoot":"","sources":["../../../src/api/multichain/group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,8BAA8B;AAE5D,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,qBAAiB;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAiB;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAkB;AAEnD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,GAAG,yBAAyB,IAAI,MAAM,EAAE,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,iCAAiC,QACsC,CAAC;AAErF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,MAAM,EAAE;QACN,EAAE,EAAE,yBAAyB,CAAC;QAC9B,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAChC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,IAC1C,YAAY,CAAC,OAAO,CAAC,GAAG;IAC1B;;OAEG;IACH,IAAI,EAAE,IAAI,wBAAwB,CAAC;IAEnC;;OAEG;IACH,IAAI,IAAI,IAAI,gBAAgB,CAAC,iBAAiB,CAAC;IAE/C;;OAEG;IACH,IAAI,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAE/C;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,yBAAyB,EACnC,UAAU,EAAE,MAAM,GACjB,wBAAwB,CAE1B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,wBAAwB,CAEnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,GACd,8BAA8B,CAkBhC;AAED;;;;;;GAMG;AACH,wBAAgB,yCAAyC,CACvD,EAAE,EAAE,wBAAwB,GAC3B,MAAM,CAER"}

package/dist/api/multichain/group.d.mts

@@ -2,10 +2,26 @@ import { type KeyringAccount } from "@metamask/keyring-api";
 import type { MultichainAccountWallet, MultichainAccountWalletId } from "./wallet.mjs";
 import type { Bip44Account } from "../bip44.mjs";
 import type { AccountGroup, AccountGroupType } from "../group.mjs";
+import type { AccountWalletType } from "../wallet.mjs";
 /**
  * Multichain account ID.
  */
 export type MultichainAccountGroupId = `${MultichainAccountWalletId}/${number}`;
+/**
+ * Regex to validate a valid multichain account group ID.
+ */
+export declare const MULTICHAIN_ACCOUNT_GROUP_ID_REGEX: RegExp;
+/**
+ * Parsed account group ID with its parsed wallet component and its sub-ID.
+ */
+export type ParsedMultichainAccountGroupId = {
+    wallet: {
+        id: MultichainAccountWalletId;
+        type: AccountWalletType.Entropy;
+        subId: string;
+    };
+    groupIndex: number;
+};
 /**
  * A multichain account that holds multiple accounts.
  */
@@ -42,11 +58,22 @@ export declare function toMultichainAccountGroupId(walletId: MultichainAccountWa
  * @returns Whether the value is a {@link MultichainAccountGroupId}.
  */
 export declare function isMultichainAccountGroupId(value: string): value is MultichainAccountGroupId;
+/**
+ * Parse a multichain account group ID to an object containing a multichain
+ * wallet ID information (wallet type and wallet sub-ID), as well as
+ * multichain account group ID information (group index).
+ *
+ * @param groupId - The multichain account group ID to validate and parse.
+ * @returns The parsed multichain account group ID.
+ * @throws When the group ID format is invalid.
+ */
+export declare function parseMultichainAccountGroupId(groupId: string): ParsedMultichainAccountGroupId;
 /**
  * Gets the multichain account index from an account group ID.
  *
  * @param id - Multichain account ID.
  * @returns The multichain account index if extractable, undefined otherwise.
+ * @throws When the group ID format is invalid.
  */
 export declare function getGroupIndexFromMultichainAccountGroupId(id: MultichainAccountGroupId): number;
 //# sourceMappingURL=group.d.mts.map

package/dist/api/multichain/group.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"group.d.mts","sourceRoot":"","sources":["../../../src/api/multichain/group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,8BAA8B;AAE5D,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,qBAAiB;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAiB;AAQ/D;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,GAAG,yBAAyB,IAAI,MAAM,EAAE,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAChC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,IAC1C,YAAY,CAAC,OAAO,CAAC,GAAG;IAC1B;;OAEG;IACH,IAAI,EAAE,IAAI,wBAAwB,CAAC;IAEnC;;OAEG;IACH,IAAI,IAAI,IAAI,gBAAgB,CAAC,iBAAiB,CAAC;IAE/C;;OAEG;IACH,IAAI,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAE/C;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,yBAAyB,EACnC,UAAU,EAAE,MAAM,GACjB,wBAAwB,CAE1B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,wBAAwB,CAEnC;AAED;;;;;GAKG;AACH,wBAAgB,yCAAyC,CACvD,EAAE,EAAE,wBAAwB,GAC3B,MAAM,CASR"}
+{"version":3,"file":"group.d.mts","sourceRoot":"","sources":["../../../src/api/multichain/group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,8BAA8B;AAE5D,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,qBAAiB;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAiB;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAkB;AAEnD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,GAAG,yBAAyB,IAAI,MAAM,EAAE,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,iCAAiC,QACsC,CAAC;AAErF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,MAAM,EAAE;QACN,EAAE,EAAE,yBAAyB,CAAC;QAC9B,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAChC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,IAC1C,YAAY,CAAC,OAAO,CAAC,GAAG;IAC1B;;OAEG;IACH,IAAI,EAAE,IAAI,wBAAwB,CAAC;IAEnC;;OAEG;IACH,IAAI,IAAI,IAAI,gBAAgB,CAAC,iBAAiB,CAAC;IAE/C;;OAEG;IACH,IAAI,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAE/C;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,yBAAyB,EACnC,UAAU,EAAE,MAAM,GACjB,wBAAwB,CAE1B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,wBAAwB,CAEnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,GACd,8BAA8B,CAkBhC;AAED;;;;;;GAMG;AACH,wBAAgB,yCAAyC,CACvD,EAAE,EAAE,wBAAwB,GAC3B,MAAM,CAER"}

package/dist/api/multichain/group.mjs

@@ -1,5 +1,7 @@
-import { AccountWalletType } from "../wallet.mjs";
-const MULTICHAIN_ACCOUNT_GROUP_ID_REGEX = new RegExp(`^${AccountWalletType.Entropy}:.*/(?<groupIndex>\\d+)$`, 'u');
+/**
+ * Regex to validate a valid multichain account group ID.
+ */
+export const MULTICHAIN_ACCOUNT_GROUP_ID_REGEX = /^(?<walletId>(?<walletType>entropy):(?<walletSubId>.+))\/(?<groupIndex>[0-9]+)$/u;
 /**
  * Gets the multichain account group ID from its multichain account wallet ID and its index.
  *
@@ -19,19 +21,40 @@ export function toMultichainAccountGroupId(walletId, groupIndex) {
 export function isMultichainAccountGroupId(value) {
     return MULTICHAIN_ACCOUNT_GROUP_ID_REGEX.test(value);
 }
+/**
+ * Parse a multichain account group ID to an object containing a multichain
+ * wallet ID information (wallet type and wallet sub-ID), as well as
+ * multichain account group ID information (group index).
+ *
+ * @param groupId - The multichain account group ID to validate and parse.
+ * @returns The parsed multichain account group ID.
+ * @throws When the group ID format is invalid.
+ */
+export function parseMultichainAccountGroupId(groupId) {
+    const match = MULTICHAIN_ACCOUNT_GROUP_ID_REGEX.exec(groupId);
+    if (!match?.groups) {
+        throw new Error(`Invalid multichain account group ID: "${groupId}"`);
+    }
+    const walletId = match.groups.walletId;
+    const walletType = match.groups.walletType;
+    const walletSubId = match.groups.walletSubId;
+    return {
+        wallet: {
+            id: walletId,
+            type: walletType,
+            subId: walletSubId,
+        },
+        groupIndex: Number(match.groups.groupIndex),
+    };
+}
 /**
  * Gets the multichain account index from an account group ID.
  *
  * @param id - Multichain account ID.
  * @returns The multichain account index if extractable, undefined otherwise.
+ * @throws When the group ID format is invalid.
  */
 export function getGroupIndexFromMultichainAccountGroupId(id) {
-    const matched = id.match(MULTICHAIN_ACCOUNT_GROUP_ID_REGEX);
-    if (matched?.groups?.groupIndex === undefined) {
-        // Unable to extract group index, even though, type wise, this should not
-        // be possible!
-        throw new Error('Unable to extract group index');
-    }
-    return Number(matched.groups.groupIndex);
+    return parseMultichainAccountGroupId(id).groupIndex;
 }
 //# sourceMappingURL=group.mjs.map