@metamask-previews/account-api 0.2.0-e017e7a → 0.5.0-0e28ac0

package/dist/api/wallet.cjs

@@ -1,33 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AccountWalletCategory = void 0;
+exports.AccountWalletType = void 0;
 exports.toAccountWalletId = toAccountWalletId;
-var AccountWalletCategory;
-(function (AccountWalletCategory) {
-    /**
-     * Category for wallets that group accounts based on their
-     * entropy source.
-     */
-    AccountWalletCategory["Entropy"] = "entropy";
-    /**
-     * Category for wallets that group accounts based on their
-     * keyring's type.
-     */
-    AccountWalletCategory["Keyring"] = "keyring";
-    /**
-     * Category for wallets that group accounts associated with an
-     * account management Snap.
-     */
-    AccountWalletCategory["Snap"] = "snap";
-})(AccountWalletCategory || (exports.AccountWalletCategory = AccountWalletCategory = {}));
 /**
- * Convert a unique ID to a wallet ID for a given category.
+ * Wallet type.
  *
- * @param category - A wallet category.
+ * Each wallet types groups accounts using different criterias.
+ */
+var AccountWalletType;
+(function (AccountWalletType) {
+    /** Wallet grouping accounts based on their entropy source. */
+    AccountWalletType["Entropy"] = "entropy";
+    /** Wallet grouping accounts based on their keyring's type. */
+    AccountWalletType["Keyring"] = "keyring";
+    /** Wallet grouping accounts associated with an account management Snap. */
+    AccountWalletType["Snap"] = "snap";
+})(AccountWalletType || (exports.AccountWalletType = AccountWalletType = {}));
+/**
+ * Convert a unique ID to a wallet ID for a given type.
+ *
+ * @param type - A wallet type.
  * @param id - A unique ID.
  * @returns A wallet ID.
  */
-function toAccountWalletId(category, id) {
-    return `${category}:${id}`;
+function toAccountWalletId(type, id) {
+    return `${type}:${id}`;
 }
 //# sourceMappingURL=wallet.cjs.map

package/dist/api/wallet.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.cjs","sourceRoot":"","sources":["../../src/api/wallet.ts"],"names":[],"mappings":";;;AAmEA,8CAKC;AAnED,IAAY,qBAkBX;AAlBD,WAAY,qBAAqB;IAC/B;;;OAGG;IACH,4CAAmB,CAAA;IAEnB;;;OAGG;IACH,4CAAmB,CAAA;IAEnB;;;OAGG;IACH,sCAAa,CAAA;AACf,CAAC,EAlBW,qBAAqB,qCAArB,qBAAqB,QAkBhC;AAqCD;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,QAA+B,EAC/B,EAAU;IAEV,OAAO,GAAG,QAAQ,IAAI,EAAE,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\n\n// Circular import are allowed when using `import type`.\nimport type { AccountGroup, AccountGroupId } from './group';\n\nexport enum AccountWalletCategory {\n  /**\n   * Category for wallets that group accounts based on their\n   * entropy source.\n   */\n  Entropy = 'entropy',\n\n  /**\n   * Category for wallets that group accounts based on their\n   * keyring's type.\n   */\n  Keyring = 'keyring',\n\n  /**\n   * Category for wallets that group accounts associated with an\n   * account management Snap.\n   */\n  Snap = 'snap',\n}\n\n/**\n * Account wallet ID.\n */\nexport type AccountWalletId = `${AccountWalletCategory}:${string}`;\n\n/**\n * Account wallet that can hold multiple account groups.\n */\nexport type AccountWallet<Account extends KeyringAccount> = {\n  /**\n   * Account wallet ID.\n   */\n  get id(): AccountWalletId;\n\n  /**\n   * Account wallet category.\n   */\n  get category(): AccountWalletCategory;\n\n  /**\n   * Gets account group for a given ID.\n   *\n   * @param id - Account group ID.\n   * @returns Account group.\n   */\n  getAccountGroup(id: AccountGroupId): AccountGroup<Account> | undefined;\n\n  /**\n   * Gets all account groups.\n   *\n   * @returns Account groups.\n   */\n  getAccountGroups(): AccountGroup<Account>[];\n};\n\n/**\n * Convert a unique ID to a wallet ID for a given category.\n *\n * @param category - A wallet category.\n * @param id - A unique ID.\n * @returns A wallet ID.\n */\nexport function toAccountWalletId(\n  category: AccountWalletCategory,\n  id: string,\n): AccountWalletId {\n  return `${category}:${id}`;\n}\n"]}
+{"version":3,"file":"wallet.cjs","sourceRoot":"","sources":["../../src/api/wallet.ts"],"names":[],"mappings":";;;AAsEA,8CAKC;AAtED;;;;GAIG;AACH,IAAY,iBASX;AATD,WAAY,iBAAiB;IAC3B,8DAA8D;IAC9D,wCAAmB,CAAA;IAEnB,8DAA8D;IAC9D,wCAAmB,CAAA;IAEnB,2EAA2E;IAC3E,kCAAa,CAAA;AACf,CAAC,EATW,iBAAiB,iCAAjB,iBAAiB,QAS5B;AA4CD;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,IAAgB,EAChB,EAAU;IAEV,OAAO,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;AACzB,CAAC","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\n\n// Circular import are allowed when using `import type`.\nimport type { AccountGroup, AccountGroupId } from './group';\n\n/**\n * Wallet type.\n *\n * Each wallet types groups accounts using different criterias.\n */\nexport enum AccountWalletType {\n  /** Wallet grouping accounts based on their entropy source. */\n  Entropy = 'entropy',\n\n  /** Wallet grouping accounts based on their keyring's type. */\n  Keyring = 'keyring',\n\n  /** Wallet grouping accounts associated with an account management Snap. */\n  Snap = 'snap',\n}\n\n/**\n * Account wallet ID.\n */\nexport type AccountWalletId = `${AccountWalletType}:${string}`;\n\n/**\n * Account wallet that can hold multiple account groups.\n */\nexport type AccountWallet<Account extends KeyringAccount> = {\n  /**\n   * Account wallet ID.\n   */\n  get id(): AccountWalletId;\n\n  /**\n   * Account wallet type.\n   */\n  get type(): AccountWalletType;\n\n  /**\n   * Gets account group for a given ID.\n   *\n   * @param id - Account group ID.\n   * @returns Account group.\n   */\n  getAccountGroup(id: AccountGroupId): AccountGroup<Account> | undefined;\n\n  /**\n   * Gets all account groups.\n   *\n   * @returns Account groups.\n   */\n  getAccountGroups(): AccountGroup<Account>[];\n};\n\n/**\n * Type utility to compute a constrained {@link AccountWalletId} type given a\n * specifc {@link AccountWalletType}.\n */\nexport type AccountWalletIdOf<WalletType extends AccountWalletType> =\n  `${WalletType}:${string}`;\n\n/**\n * Convert a unique ID to a wallet ID for a given type.\n *\n * @param type - A wallet type.\n * @param id - A unique ID.\n * @returns A wallet ID.\n */\nexport function toAccountWalletId<WalletType extends AccountWalletType>(\n  type: WalletType,\n  id: string,\n): AccountWalletIdOf<WalletType> {\n  return `${type}:${id}`;\n}\n"]}

package/dist/api/wallet.d.cts

@@ -1,26 +1,22 @@
 import type { KeyringAccount } from "@metamask/keyring-api";
 import type { AccountGroup, AccountGroupId } from "./group.cjs";
-export declare enum AccountWalletCategory {
-    /**
-     * Category for wallets that group accounts based on their
-     * entropy source.
-     */
+/**
+ * Wallet type.
+ *
+ * Each wallet types groups accounts using different criterias.
+ */
+export declare enum AccountWalletType {
+    /** Wallet grouping accounts based on their entropy source. */
     Entropy = "entropy",
-    /**
-     * Category for wallets that group accounts based on their
-     * keyring's type.
-     */
+    /** Wallet grouping accounts based on their keyring's type. */
     Keyring = "keyring",
-    /**
-     * Category for wallets that group accounts associated with an
-     * account management Snap.
-     */
+    /** Wallet grouping accounts associated with an account management Snap. */
     Snap = "snap"
 }
 /**
  * Account wallet ID.
  */
-export type AccountWalletId = `${AccountWalletCategory}:${string}`;
+export type AccountWalletId = `${AccountWalletType}:${string}`;
 /**
  * Account wallet that can hold multiple account groups.
  */
@@ -30,9 +26,9 @@ export type AccountWallet<Account extends KeyringAccount> = {
      */
     get id(): AccountWalletId;
     /**
-     * Account wallet category.
+     * Account wallet type.
      */
-    get category(): AccountWalletCategory;
+    get type(): AccountWalletType;
     /**
      * Gets account group for a given ID.
      *
@@ -48,11 +44,16 @@ export type AccountWallet<Account extends KeyringAccount> = {
     getAccountGroups(): AccountGroup<Account>[];
 };
 /**
- * Convert a unique ID to a wallet ID for a given category.
+ * Type utility to compute a constrained {@link AccountWalletId} type given a
+ * specifc {@link AccountWalletType}.
+ */
+export type AccountWalletIdOf<WalletType extends AccountWalletType> = `${WalletType}:${string}`;
+/**
+ * Convert a unique ID to a wallet ID for a given type.
  *
- * @param category - A wallet category.
+ * @param type - A wallet type.
  * @param id - A unique ID.
  * @returns A wallet ID.
  */
-export declare function toAccountWalletId(category: AccountWalletCategory, id: string): AccountWalletId;
+export declare function toAccountWalletId<WalletType extends AccountWalletType>(type: WalletType, id: string): AccountWalletIdOf<WalletType>;
 //# sourceMappingURL=wallet.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"wallet.d.cts","sourceRoot":"","sources":["../../src/api/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAgB;AAE5D,oBAAY,qBAAqB;IAC/B;;;OAGG;IACH,OAAO,YAAY;IAEnB;;;OAGG;IACH,OAAO,YAAY;IAEnB;;;OAGG;IACH,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,qBAAqB,IAAI,MAAM,EAAE,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,cAAc,IAAI;IAC1D;;OAEG;IACH,IAAI,EAAE,IAAI,eAAe,CAAC;IAE1B;;OAEG;IACH,IAAI,QAAQ,IAAI,qBAAqB,CAAC;IAEtC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAEvE;;;;OAIG;IACH,gBAAgB,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,qBAAqB,EAC/B,EAAE,EAAE,MAAM,GACT,eAAe,CAEjB"}
+{"version":3,"file":"wallet.d.cts","sourceRoot":"","sources":["../../src/api/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAgB;AAE5D;;;;GAIG;AACH,oBAAY,iBAAiB;IAC3B,8DAA8D;IAC9D,OAAO,YAAY;IAEnB,8DAA8D;IAC9D,OAAO,YAAY;IAEnB,2EAA2E;IAC3E,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,iBAAiB,IAAI,MAAM,EAAE,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,cAAc,IAAI;IAC1D;;OAEG;IACH,IAAI,EAAE,IAAI,eAAe,CAAC;IAE1B;;OAEG;IACH,IAAI,IAAI,IAAI,iBAAiB,CAAC;IAE9B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAEvE;;;;OAIG;IACH,gBAAgB,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,UAAU,SAAS,iBAAiB,IAChE,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,SAAS,iBAAiB,EACpE,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,GACT,iBAAiB,CAAC,UAAU,CAAC,CAE/B"}

package/dist/api/wallet.d.mts

@@ -1,26 +1,22 @@
 import type { KeyringAccount } from "@metamask/keyring-api";
 import type { AccountGroup, AccountGroupId } from "./group.mjs";
-export declare enum AccountWalletCategory {
-    /**
-     * Category for wallets that group accounts based on their
-     * entropy source.
-     */
+/**
+ * Wallet type.
+ *
+ * Each wallet types groups accounts using different criterias.
+ */
+export declare enum AccountWalletType {
+    /** Wallet grouping accounts based on their entropy source. */
     Entropy = "entropy",
-    /**
-     * Category for wallets that group accounts based on their
-     * keyring's type.
-     */
+    /** Wallet grouping accounts based on their keyring's type. */
     Keyring = "keyring",
-    /**
-     * Category for wallets that group accounts associated with an
-     * account management Snap.
-     */
+    /** Wallet grouping accounts associated with an account management Snap. */
     Snap = "snap"
 }
 /**
  * Account wallet ID.
  */
-export type AccountWalletId = `${AccountWalletCategory}:${string}`;
+export type AccountWalletId = `${AccountWalletType}:${string}`;
 /**
  * Account wallet that can hold multiple account groups.
  */
@@ -30,9 +26,9 @@ export type AccountWallet<Account extends KeyringAccount> = {
      */
     get id(): AccountWalletId;
     /**
-     * Account wallet category.
+     * Account wallet type.
      */
-    get category(): AccountWalletCategory;
+    get type(): AccountWalletType;
     /**
      * Gets account group for a given ID.
      *
@@ -48,11 +44,16 @@ export type AccountWallet<Account extends KeyringAccount> = {
     getAccountGroups(): AccountGroup<Account>[];
 };
 /**
- * Convert a unique ID to a wallet ID for a given category.
+ * Type utility to compute a constrained {@link AccountWalletId} type given a
+ * specifc {@link AccountWalletType}.
+ */
+export type AccountWalletIdOf<WalletType extends AccountWalletType> = `${WalletType}:${string}`;
+/**
+ * Convert a unique ID to a wallet ID for a given type.
  *
- * @param category - A wallet category.
+ * @param type - A wallet type.
  * @param id - A unique ID.
  * @returns A wallet ID.
  */
-export declare function toAccountWalletId(category: AccountWalletCategory, id: string): AccountWalletId;
+export declare function toAccountWalletId<WalletType extends AccountWalletType>(type: WalletType, id: string): AccountWalletIdOf<WalletType>;
 //# sourceMappingURL=wallet.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"wallet.d.mts","sourceRoot":"","sources":["../../src/api/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAgB;AAE5D,oBAAY,qBAAqB;IAC/B;;;OAGG;IACH,OAAO,YAAY;IAEnB;;;OAGG;IACH,OAAO,YAAY;IAEnB;;;OAGG;IACH,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,qBAAqB,IAAI,MAAM,EAAE,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,cAAc,IAAI;IAC1D;;OAEG;IACH,IAAI,EAAE,IAAI,eAAe,CAAC;IAE1B;;OAEG;IACH,IAAI,QAAQ,IAAI,qBAAqB,CAAC;IAEtC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAEvE;;;;OAIG;IACH,gBAAgB,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,qBAAqB,EAC/B,EAAE,EAAE,MAAM,GACT,eAAe,CAEjB"}
+{"version":3,"file":"wallet.d.mts","sourceRoot":"","sources":["../../src/api/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAgB;AAE5D;;;;GAIG;AACH,oBAAY,iBAAiB;IAC3B,8DAA8D;IAC9D,OAAO,YAAY;IAEnB,8DAA8D;IAC9D,OAAO,YAAY;IAEnB,2EAA2E;IAC3E,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,iBAAiB,IAAI,MAAM,EAAE,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,cAAc,IAAI;IAC1D;;OAEG;IACH,IAAI,EAAE,IAAI,eAAe,CAAC;IAE1B;;OAEG;IACH,IAAI,IAAI,IAAI,iBAAiB,CAAC;IAE9B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAEvE;;;;OAIG;IACH,gBAAgB,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,UAAU,SAAS,iBAAiB,IAChE,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,SAAS,iBAAiB,EACpE,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,GACT,iBAAiB,CAAC,UAAU,CAAC,CAE/B"}

package/dist/api/wallet.mjs

@@ -1,29 +1,25 @@
-export var AccountWalletCategory;
-(function (AccountWalletCategory) {
-    /**
-     * Category for wallets that group accounts based on their
-     * entropy source.
-     */
-    AccountWalletCategory["Entropy"] = "entropy";
-    /**
-     * Category for wallets that group accounts based on their
-     * keyring's type.
-     */
-    AccountWalletCategory["Keyring"] = "keyring";
-    /**
-     * Category for wallets that group accounts associated with an
-     * account management Snap.
-     */
-    AccountWalletCategory["Snap"] = "snap";
-})(AccountWalletCategory || (AccountWalletCategory = {}));
 /**
- * Convert a unique ID to a wallet ID for a given category.
+ * Wallet type.
  *
- * @param category - A wallet category.
+ * Each wallet types groups accounts using different criterias.
+ */
+export var AccountWalletType;
+(function (AccountWalletType) {
+    /** Wallet grouping accounts based on their entropy source. */
+    AccountWalletType["Entropy"] = "entropy";
+    /** Wallet grouping accounts based on their keyring's type. */
+    AccountWalletType["Keyring"] = "keyring";
+    /** Wallet grouping accounts associated with an account management Snap. */
+    AccountWalletType["Snap"] = "snap";
+})(AccountWalletType || (AccountWalletType = {}));
+/**
+ * Convert a unique ID to a wallet ID for a given type.
+ *
+ * @param type - A wallet type.
  * @param id - A unique ID.
  * @returns A wallet ID.
  */
-export function toAccountWalletId(category, id) {
-    return `${category}:${id}`;
+export function toAccountWalletId(type, id) {
+    return `${type}:${id}`;
 }
 //# sourceMappingURL=wallet.mjs.map

package/dist/api/wallet.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.mjs","sourceRoot":"","sources":["../../src/api/wallet.ts"],"names":[],"mappings":"AAKA,MAAM,CAAN,IAAY,qBAkBX;AAlBD,WAAY,qBAAqB;IAC/B;;;OAGG;IACH,4CAAmB,CAAA;IAEnB;;;OAGG;IACH,4CAAmB,CAAA;IAEnB;;;OAGG;IACH,sCAAa,CAAA;AACf,CAAC,EAlBW,qBAAqB,KAArB,qBAAqB,QAkBhC;AAqCD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAA+B,EAC/B,EAAU;IAEV,OAAO,GAAG,QAAQ,IAAI,EAAE,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\n\n// Circular import are allowed when using `import type`.\nimport type { AccountGroup, AccountGroupId } from './group';\n\nexport enum AccountWalletCategory {\n  /**\n   * Category for wallets that group accounts based on their\n   * entropy source.\n   */\n  Entropy = 'entropy',\n\n  /**\n   * Category for wallets that group accounts based on their\n   * keyring's type.\n   */\n  Keyring = 'keyring',\n\n  /**\n   * Category for wallets that group accounts associated with an\n   * account management Snap.\n   */\n  Snap = 'snap',\n}\n\n/**\n * Account wallet ID.\n */\nexport type AccountWalletId = `${AccountWalletCategory}:${string}`;\n\n/**\n * Account wallet that can hold multiple account groups.\n */\nexport type AccountWallet<Account extends KeyringAccount> = {\n  /**\n   * Account wallet ID.\n   */\n  get id(): AccountWalletId;\n\n  /**\n   * Account wallet category.\n   */\n  get category(): AccountWalletCategory;\n\n  /**\n   * Gets account group for a given ID.\n   *\n   * @param id - Account group ID.\n   * @returns Account group.\n   */\n  getAccountGroup(id: AccountGroupId): AccountGroup<Account> | undefined;\n\n  /**\n   * Gets all account groups.\n   *\n   * @returns Account groups.\n   */\n  getAccountGroups(): AccountGroup<Account>[];\n};\n\n/**\n * Convert a unique ID to a wallet ID for a given category.\n *\n * @param category - A wallet category.\n * @param id - A unique ID.\n * @returns A wallet ID.\n */\nexport function toAccountWalletId(\n  category: AccountWalletCategory,\n  id: string,\n): AccountWalletId {\n  return `${category}:${id}`;\n}\n"]}
+{"version":3,"file":"wallet.mjs","sourceRoot":"","sources":["../../src/api/wallet.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,CAAN,IAAY,iBASX;AATD,WAAY,iBAAiB;IAC3B,8DAA8D;IAC9D,wCAAmB,CAAA;IAEnB,8DAA8D;IAC9D,wCAAmB,CAAA;IAEnB,2EAA2E;IAC3E,kCAAa,CAAA;AACf,CAAC,EATW,iBAAiB,KAAjB,iBAAiB,QAS5B;AA4CD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAgB,EAChB,EAAU;IAEV,OAAO,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;AACzB,CAAC","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\n\n// Circular import are allowed when using `import type`.\nimport type { AccountGroup, AccountGroupId } from './group';\n\n/**\n * Wallet type.\n *\n * Each wallet types groups accounts using different criterias.\n */\nexport enum AccountWalletType {\n  /** Wallet grouping accounts based on their entropy source. */\n  Entropy = 'entropy',\n\n  /** Wallet grouping accounts based on their keyring's type. */\n  Keyring = 'keyring',\n\n  /** Wallet grouping accounts associated with an account management Snap. */\n  Snap = 'snap',\n}\n\n/**\n * Account wallet ID.\n */\nexport type AccountWalletId = `${AccountWalletType}:${string}`;\n\n/**\n * Account wallet that can hold multiple account groups.\n */\nexport type AccountWallet<Account extends KeyringAccount> = {\n  /**\n   * Account wallet ID.\n   */\n  get id(): AccountWalletId;\n\n  /**\n   * Account wallet type.\n   */\n  get type(): AccountWalletType;\n\n  /**\n   * Gets account group for a given ID.\n   *\n   * @param id - Account group ID.\n   * @returns Account group.\n   */\n  getAccountGroup(id: AccountGroupId): AccountGroup<Account> | undefined;\n\n  /**\n   * Gets all account groups.\n   *\n   * @returns Account groups.\n   */\n  getAccountGroups(): AccountGroup<Account>[];\n};\n\n/**\n * Type utility to compute a constrained {@link AccountWalletId} type given a\n * specifc {@link AccountWalletType}.\n */\nexport type AccountWalletIdOf<WalletType extends AccountWalletType> =\n  `${WalletType}:${string}`;\n\n/**\n * Convert a unique ID to a wallet ID for a given type.\n *\n * @param type - A wallet type.\n * @param id - A unique ID.\n * @returns A wallet ID.\n */\nexport function toAccountWalletId<WalletType extends AccountWalletType>(\n  type: WalletType,\n  id: string,\n): AccountWalletIdOf<WalletType> {\n  return `${type}:${id}`;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/account-api",
-  "version": "0.2.0-e017e7a",
+  "version": "0.5.0-0e28ac0",
   "description": "MetaMask Account API",
   "keywords": [
     "metamask",
@@ -46,7 +46,7 @@
     "test:watch": "jest --watch"
   },
   "dependencies": {
-    "@metamask/keyring-api": "19.0.0",
+    "@metamask/keyring-api": "19.1.0",
     "@metamask/keyring-utils": "3.1.0",
     "@metamask/superstruct": "^3.1.0"
   },
@@ -54,7 +54,7 @@
     "@lavamoat/allow-scripts": "^3.2.1",
     "@lavamoat/preinstall-always-fail": "^2.1.0",
     "@metamask/auto-changelog": "^3.4.4",
-    "@metamask/keyring-internal-api": "7.0.0",
+    "@metamask/keyring-internal-api": "7.1.0",
     "@ts-bridge/cli": "^0.6.3",
     "@types/jest": "^29.5.12",
     "@types/node": "^20.12.12",

package/dist/api/multichain/account.cjs

@@ -1,213 +0,0 @@
-"use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _MultichainAccount_id, _MultichainAccount_wallet, _MultichainAccount_index, _MultichainAccount_providers, _MultichainAccount_accounts, _MultichainAccount_reverse;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MultichainAccount = void 0;
-exports.toMultichainAccountId = toMultichainAccountId;
-exports.isMultichainAccountId = isMultichainAccountId;
-exports.getGroupIndexFromMultichainAccountId = getGroupIndexFromMultichainAccountId;
-const keyring_utils_1 = require("@metamask/keyring-utils");
-const wallet_1 = require("../wallet.cjs");
-const MULTICHAIN_ACCOUNT_ID_REGEX = new RegExp(`^${wallet_1.AccountWalletCategory.Entropy}:.*/(?<groupIndex>\\d+)$`, 'u');
-/**
- * A multichain account that holds multiple accounts.
- */
-class MultichainAccount {
-    constructor({ groupIndex, wallet, providers, }) {
-        _MultichainAccount_id.set(this, void 0);
-        _MultichainAccount_wallet.set(this, void 0);
-        _MultichainAccount_index.set(this, void 0);
-        _MultichainAccount_providers.set(this, void 0);
-        _MultichainAccount_accounts.set(this, void 0);
-        _MultichainAccount_reverse.set(this, void 0);
-        __classPrivateFieldSet(this, _MultichainAccount_id, toMultichainAccountId(wallet.id, groupIndex), "f");
-        __classPrivateFieldSet(this, _MultichainAccount_index, groupIndex, "f");
-        __classPrivateFieldSet(this, _MultichainAccount_wallet, wallet, "f");
-        __classPrivateFieldSet(this, _MultichainAccount_providers, providers, "f");
-        __classPrivateFieldSet(this, _MultichainAccount_accounts, new Map(), "f");
-        __classPrivateFieldSet(this, _MultichainAccount_reverse, new Map(), "f");
-        this.sync();
-    }
-    /**
-     * Force multichain account synchronization.
-     *
-     * This can be used if account providers got new accounts that the multichain
-     * account doesn't know about.
-     */
-    sync() {
-        // Clear reverse mapping and re-construct it entirely based on the refreshed
-        // list of accounts from each providers.
-        __classPrivateFieldGet(this, _MultichainAccount_reverse, "f").clear();
-        for (const provider of __classPrivateFieldGet(this, _MultichainAccount_providers, "f")) {
-            // Filter account only for that index.
-            const accounts = [];
-            for (const account of provider.getAccounts()) {
-                if (account.options.entropy.id === this.wallet.entropySource &&
-                    account.options.entropy.groupIndex === this.index) {
-                    // We only use IDs to always fetch the latest version of accounts.
-                    accounts.push(account.id);
-                }
-            }
-            __classPrivateFieldGet(this, _MultichainAccount_accounts, "f").set(provider, accounts);
-            // Reverse-mapping for fast indexing.
-            for (const id of accounts) {
-                __classPrivateFieldGet(this, _MultichainAccount_reverse, "f").set(id, provider);
-            }
-        }
-    }
-    /**
-     * Gets the multichain account ID.
-     *
-     * @returns The multichain account ID.
-     */
-    get id() {
-        return __classPrivateFieldGet(this, _MultichainAccount_id, "f");
-    }
-    /**
-     * Gets the multichain account's wallet reference (parent).
-     *
-     * @returns The multichain account's wallet.
-     */
-    get wallet() {
-        return __classPrivateFieldGet(this, _MultichainAccount_wallet, "f");
-    }
-    /**
-     * Gets the multichain account group index.
-     *
-     * @returns The multichain account group index.
-     */
-    get index() {
-        return __classPrivateFieldGet(this, _MultichainAccount_index, "f");
-    }
-    /**
-     * Checks if there's any underlying accounts for this multichain accounts.
-     *
-     * @returns True if there's any underlying accounts, false otherwise.
-     */
-    hasAccounts() {
-        // If there's anything in the reverse-map, it means we have some accounts.
-        return __classPrivateFieldGet(this, _MultichainAccount_reverse, "f").size > 0;
-    }
-    /**
-     * Gets the accounts for this multichain account.
-     *
-     * @returns The accounts.
-     */
-    getAccounts() {
-        let allAccounts = [];
-        for (const [provider, accounts] of __classPrivateFieldGet(this, _MultichainAccount_accounts, "f").entries()) {
-            allAccounts = allAccounts.concat(accounts.map((id) => provider.getAccount(id)));
-        }
-        return allAccounts;
-    }
-    /**
-     * Gets the account for a given account ID.
-     *
-     * @param id - Account ID.
-     * @returns The account or undefined if not found.
-     */
-    getAccount(id) {
-        const provider = __classPrivateFieldGet(this, _MultichainAccount_reverse, "f").get(id);
-        // If there's nothing in the map, it means we tried to get an account
-        // that does not belong to this multichain account.
-        if (!provider) {
-            return undefined;
-        }
-        return provider.getAccount(id);
-    }
-    /**
-     * Query an account matching the selector.
-     *
-     * @param selector - Query selector.
-     * @returns The account matching the selector or undefined if not matching.
-     * @throws If multiple accounts match the selector.
-     */
-    get(selector) {
-        const accounts = this.select(selector);
-        if (accounts.length > 1) {
-            throw new Error(`Too many account candidates, expected 1, got: ${accounts.length}`);
-        }
-        if (accounts.length === 0) {
-            return undefined;
-        }
-        return accounts[0]; // This is safe, see checks above.
-    }
-    /**
-     * Query accounts matching the selector.
-     *
-     * @param selector - Query selector.
-     * @returns The accounts matching the selector.
-     */
-    select(selector) {
-        return this.getAccounts().filter((account) => {
-            let selected = true;
-            if (selector.id) {
-                selected && (selected = account.id === selector.id);
-            }
-            if (selector.address) {
-                selected && (selected = account.address === selector.address);
-            }
-            if (selector.type) {
-                selected && (selected = account.type === selector.type);
-            }
-            if (selector.methods !== undefined) {
-                selected && (selected = selector.methods.some((method) => account.methods.includes(method)));
-            }
-            if (selector.scopes !== undefined) {
-                selected && (selected = selector.scopes.some((scope) => {
-                    return (
-                    // This will cover specific EVM EOA scopes as well.
-                    (0, keyring_utils_1.isScopeEqualToAny)(scope, account.scopes));
-                }));
-            }
-            return selected;
-        });
-    }
-}
-exports.MultichainAccount = MultichainAccount;
-_MultichainAccount_id = new WeakMap(), _MultichainAccount_wallet = new WeakMap(), _MultichainAccount_index = new WeakMap(), _MultichainAccount_providers = new WeakMap(), _MultichainAccount_accounts = new WeakMap(), _MultichainAccount_reverse = new WeakMap();
-/**
- * Gets the multichain account ID from its multichain account wallet ID and its index.
- *
- * @param walletId - Multichain account wallet ID.
- * @param groupIndex - Index of that multichain account.
- * @returns The multichain account ID.
- */
-function toMultichainAccountId(walletId, groupIndex) {
-    return `${walletId}/${groupIndex}`;
-}
-/**
- * Checks if the given value is {@link MultichainAccountId}.
- *
- * @param value - The value to check.
- * @returns Whether the value is a {@link MultichainAccountId}.
- */
-function isMultichainAccountId(value) {
-    return MULTICHAIN_ACCOUNT_ID_REGEX.test(value);
-}
-/**
- * Gets the multichain account index from an account group ID.
- *
- * @param id - Multichain account ID.
- * @returns The multichain account index if extractable, undefined otherwise.
- */
-function getGroupIndexFromMultichainAccountId(id) {
-    const matched = id.match(MULTICHAIN_ACCOUNT_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);
-}
-//# sourceMappingURL=account.cjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"account.cjs","sourceRoot":"","sources":["../../../src/api/multichain/account.ts"],"names":[],"mappings":"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","sourcesContent":["import { type KeyringAccount } from '@metamask/keyring-api';\nimport { isScopeEqualToAny } from '@metamask/keyring-utils';\n\nimport type {\n  MultichainAccountWallet,\n  MultichainAccountWalletId,\n} from './wallet';\nimport type { Bip44Account } from '../bip44';\nimport type { AccountGroup } from '../group';\nimport type { AccountProvider } from '../provider';\nimport type { AccountSelector } from '../selector';\nimport { AccountWalletCategory } from '../wallet';\n\nconst MULTICHAIN_ACCOUNT_ID_REGEX = new RegExp(\n  `^${AccountWalletCategory.Entropy}:.*/(?<groupIndex>\\\\d+)$`,\n  'u',\n);\n\n/**\n * Multichain account ID.\n */\nexport type MultichainAccountId = `${MultichainAccountWalletId}/${number}`; // Use number for the account group index.\n\n/**\n * A multichain account that holds multiple accounts.\n */\nexport class MultichainAccount<Account extends Bip44Account<KeyringAccount>>\n  implements AccountGroup<Account>\n{\n  readonly #id: MultichainAccountId;\n\n  readonly #wallet: MultichainAccountWallet<Account>;\n\n  readonly #index: number;\n\n  readonly #providers: AccountProvider<Account>[];\n\n  readonly #accounts: Map<AccountProvider<Account>, Account['id'][]>;\n\n  readonly #reverse: Map<Account['id'], AccountProvider<Account>>;\n\n  constructor({\n    groupIndex,\n    wallet,\n    providers,\n  }: {\n    groupIndex: number;\n    wallet: MultichainAccountWallet<Account>;\n    providers: AccountProvider<Account>[];\n  }) {\n    this.#id = toMultichainAccountId(wallet.id, groupIndex);\n    this.#index = groupIndex;\n    this.#wallet = wallet;\n    this.#providers = providers;\n    this.#accounts = new Map();\n    this.#reverse = new Map();\n\n    this.sync();\n  }\n\n  /**\n   * Force multichain account synchronization.\n   *\n   * This can be used if account providers got new accounts that the multichain\n   * account doesn't know about.\n   */\n  sync(): void {\n    // Clear reverse mapping and re-construct it entirely based on the refreshed\n    // list of accounts from each providers.\n    this.#reverse.clear();\n\n    for (const provider of this.#providers) {\n      // Filter account only for that index.\n      const accounts = [];\n      for (const account of provider.getAccounts()) {\n        if (\n          account.options.entropy.id === this.wallet.entropySource &&\n          account.options.entropy.groupIndex === this.index\n        ) {\n          // We only use IDs to always fetch the latest version of accounts.\n          accounts.push(account.id);\n        }\n      }\n      this.#accounts.set(provider, accounts);\n\n      // Reverse-mapping for fast indexing.\n      for (const id of accounts) {\n        this.#reverse.set(id, provider);\n      }\n    }\n  }\n\n  /**\n   * Gets the multichain account ID.\n   *\n   * @returns The multichain account ID.\n   */\n  get id(): MultichainAccountId {\n    return this.#id;\n  }\n\n  /**\n   * Gets the multichain account's wallet reference (parent).\n   *\n   * @returns The multichain account's wallet.\n   */\n  get wallet(): MultichainAccountWallet<Account> {\n    return this.#wallet;\n  }\n\n  /**\n   * Gets the multichain account group index.\n   *\n   * @returns The multichain account group index.\n   */\n  get index(): number {\n    return this.#index;\n  }\n\n  /**\n   * Checks if there's any underlying accounts for this multichain accounts.\n   *\n   * @returns True if there's any underlying accounts, false otherwise.\n   */\n  hasAccounts(): boolean {\n    // If there's anything in the reverse-map, it means we have some accounts.\n    return this.#reverse.size > 0;\n  }\n\n  /**\n   * Gets the accounts for this multichain account.\n   *\n   * @returns The accounts.\n   */\n  getAccounts(): Account[] {\n    let allAccounts: Account[] = [];\n\n    for (const [provider, accounts] of this.#accounts.entries()) {\n      allAccounts = allAccounts.concat(\n        accounts.map((id) => provider.getAccount(id)),\n      );\n    }\n\n    return allAccounts;\n  }\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    const provider = this.#reverse.get(id);\n\n    // If there's nothing in the map, it means we tried to get an account\n    // that does not belong to this multichain account.\n    if (!provider) {\n      return undefined;\n    }\n    return provider.getAccount(id);\n  }\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    const accounts = this.select(selector);\n\n    if (accounts.length > 1) {\n      throw new Error(\n        `Too many account candidates, expected 1, got: ${accounts.length}`,\n      );\n    }\n\n    if (accounts.length === 0) {\n      return undefined;\n    }\n\n    return accounts[0]; // This is safe, see checks above.\n  }\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    return this.getAccounts().filter((account) => {\n      let selected = true;\n\n      if (selector.id) {\n        selected &&= account.id === selector.id;\n      }\n      if (selector.address) {\n        selected &&= account.address === selector.address;\n      }\n      if (selector.type) {\n        selected &&= account.type === selector.type;\n      }\n      if (selector.methods !== undefined) {\n        selected &&= selector.methods.some((method) =>\n          account.methods.includes(method),\n        );\n      }\n      if (selector.scopes !== undefined) {\n        selected &&= selector.scopes.some((scope) => {\n          return (\n            // This will cover specific EVM EOA scopes as well.\n            isScopeEqualToAny(scope, account.scopes)\n          );\n        });\n      }\n\n      return selected;\n    });\n  }\n}\n\n/**\n * Gets the multichain account 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 toMultichainAccountId(\n  walletId: MultichainAccountWalletId,\n  groupIndex: number,\n): MultichainAccountId {\n  return `${walletId}/${groupIndex}`;\n}\n\n/**\n * Checks if the given value is {@link MultichainAccountId}.\n *\n * @param value - The value to check.\n * @returns Whether the value is a {@link MultichainAccountId}.\n */\nexport function isMultichainAccountId(\n  value: string,\n): value is MultichainAccountId {\n  return MULTICHAIN_ACCOUNT_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 getGroupIndexFromMultichainAccountId(\n  id: MultichainAccountId,\n): number {\n  const matched = id.match(MULTICHAIN_ACCOUNT_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"]}

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

@@ -1,103 +0,0 @@
-import { type KeyringAccount } from "@metamask/keyring-api";
-import type { MultichainAccountWallet, MultichainAccountWalletId } from "./wallet.cjs";
-import type { Bip44Account } from "../bip44.cjs";
-import type { AccountGroup } from "../group.cjs";
-import type { AccountProvider } from "../provider.cjs";
-import type { AccountSelector } from "../selector.cjs";
-/**
- * Multichain account ID.
- */
-export type MultichainAccountId = `${MultichainAccountWalletId}/${number}`;
-/**
- * A multichain account that holds multiple accounts.
- */
-export declare class MultichainAccount<Account extends Bip44Account<KeyringAccount>> implements AccountGroup<Account> {
-    #private;
-    constructor({ groupIndex, wallet, providers, }: {
-        groupIndex: number;
-        wallet: MultichainAccountWallet<Account>;
-        providers: AccountProvider<Account>[];
-    });
-    /**
-     * Force multichain account synchronization.
-     *
-     * This can be used if account providers got new accounts that the multichain
-     * account doesn't know about.
-     */
-    sync(): void;
-    /**
-     * Gets the multichain account ID.
-     *
-     * @returns The multichain account ID.
-     */
-    get id(): MultichainAccountId;
-    /**
-     * Gets the multichain account's wallet reference (parent).
-     *
-     * @returns The multichain account's wallet.
-     */
-    get wallet(): MultichainAccountWallet<Account>;
-    /**
-     * Gets the multichain account group index.
-     *
-     * @returns The multichain account group index.
-     */
-    get index(): number;
-    /**
-     * Checks if there's any underlying accounts for this multichain accounts.
-     *
-     * @returns True if there's any underlying accounts, false otherwise.
-     */
-    hasAccounts(): boolean;
-    /**
-     * Gets the accounts for this multichain account.
-     *
-     * @returns The accounts.
-     */
-    getAccounts(): Account[];
-    /**
-     * Gets the account for a given account ID.
-     *
-     * @param id - Account ID.
-     * @returns The account or undefined if not found.
-     */
-    getAccount(id: Account['id']): Account | undefined;
-    /**
-     * Query an account matching the selector.
-     *
-     * @param selector - Query selector.
-     * @returns The account matching the selector or undefined if not matching.
-     * @throws If multiple accounts match the selector.
-     */
-    get(selector: AccountSelector<Account>): Account | undefined;
-    /**
-     * Query accounts matching the selector.
-     *
-     * @param selector - Query selector.
-     * @returns The accounts matching the selector.
-     */
-    select(selector: AccountSelector<Account>): Account[];
-}
-/**
- * Gets the multichain account ID from its multichain account wallet ID and its index.
- *
- * @param walletId - Multichain account wallet ID.
- * @param groupIndex - Index of that multichain account.
- * @returns The multichain account ID.
- */
-export declare function toMultichainAccountId(walletId: MultichainAccountWalletId, groupIndex: number): MultichainAccountId;
-/**
- * Checks if the given value is {@link MultichainAccountId}.
- *
- * @param value - The value to check.
- * @returns Whether the value is a {@link MultichainAccountId}.
- */
-export declare function isMultichainAccountId(value: string): value is MultichainAccountId;
-/**
- * Gets the multichain account index from an account group ID.
- *
- * @param id - Multichain account ID.
- * @returns The multichain account index if extractable, undefined otherwise.
- */
-export declare function getGroupIndexFromMultichainAccountId(id: MultichainAccountId): number;
-//# sourceMappingURL=account.d.cts.map