@metamask/keyring-api 21.3.0 → 21.5.0

package/dist/api/v2/create-account/index.d.cts

@@ -1,5 +1,6 @@
 import { type Infer } from "@metamask/superstruct";
 export * from "./bip44.cjs";
+export * from "./custom.cjs";
 export * from "./private-key.cjs";
 /**
  * Enum representing the different ways an account can be created.
@@ -17,6 +18,14 @@ export declare enum AccountCreationType {
      * index.
      */
     Bip44DeriveIndex = "bip44:derive-index",
+    /**
+     * Represents accounts created by deriving a range of BIP-44 account indices.
+     *
+     * More than one account can be created per index, for example, the keyring
+     * can create multiple account types (e.g., P2PKH, P2TR, P2WPKH) for each
+     * account index in the range.
+     */
+    Bip44DeriveIndexRange = "bip44:derive-index-range",
     /**
      * Represents accounts created through BIP-44 account discovery.
      *
@@ -28,7 +37,14 @@ export declare enum AccountCreationType {
     /**
      * Represents an account imported from a private key.
      */
-    PrivateKeyImport = "private-key:import"
+    PrivateKeyImport = "private-key:import",
+    /**
+     * Represents an account created using a custom, keyring-specific method.
+     *
+     * This is used by keyrings that have non-standard account creation flows
+     * and declare `custom.createAccounts: true` in their capabilities.
+     */
+    Custom = "custom"
 }
 /**
  * Struct for {@link CreateAccountOptions}.
@@ -45,6 +61,15 @@ export declare const CreateAccountOptionsStruct: import("@metamask/superstruct")
     type: "bip44:discover";
     groupIndex: number;
     entropySource: string;
+} | {
+    type: "bip44:derive-index-range";
+    range: {
+        from: number;
+        to: number;
+    };
+    entropySource: string;
+} | {
+    type: "custom";
 } | {
     type: "private-key:import";
     encoding: "hexadecimal" | "base58";
@@ -55,4 +80,33 @@ export declare const CreateAccountOptionsStruct: import("@metamask/superstruct")
  * Represents the available options for creating a new account.
  */
 export type CreateAccountOptions = Infer<typeof CreateAccountOptionsStruct>;
+/**
+ * Asserts that a given create account option type is supported by the keyring.
+ *
+ * @example
+ * ```ts
+ * createAccounts(options: CreateAccountOptions) {
+ *   assertCreateAccountOptionIsSupported(options, [
+ *     ${AccountCreationType.Bip44DeriveIndex},
+ *     ${AccountCreationType.Bip44DeriveIndexRange},
+ *   ] as const);
+ *
+ *   // At this point, TypeScript knows that options.type is either Bip44DeriveIndex or Bip44DeriveIndexRange.
+ *   if (options.type === AccountCreationType.Bip44DeriveIndex) {
+ *     ... // Handle Bip44DeriveIndex case.
+ *   } else {
+ *     ... // Handle Bip44DeriveIndexRange case.
+ *   }
+ *   ...
+ *   return accounts;
+ * }
+ * ```
+ *
+ * @param options - The create account option object to check.
+ * @param supportedTypes - The list of supported create account option types for this keyring.
+ * @throws Will throw an error if the provided options are not supported.
+ */
+export declare function assertCreateAccountOptionIsSupported<Options extends CreateAccountOptions, Type extends `${CreateAccountOptions['type']}`>(options: Options, supportedTypes: readonly `${Type}`[]): asserts options is Options & {
+    type: `${Type}` & `${Options['type']}`;
+};
 //# sourceMappingURL=index.d.cts.map

package/dist/api/v2/create-account/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../../src/api/v2/create-account/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,KAAK,EAAE,8BAA8B;AASnD,4BAAwB;AACxB,kCAA8B;AAE9B;;GAEG;AACH,oBAAY,mBAAmB;IAC7B;;OAEG;IACH,eAAe,sBAAsB;IAErC;;;;;;OAMG;IACH,gBAAgB,uBAAuB;IAEvC;;;;;;OAMG;IACH,aAAa,mBAAmB;IAEhC;;OAEG;IACH,gBAAgB,uBAAuB;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;QAerC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../../src/api/v2/create-account/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,KAAK,EAAE,8BAA8B;AAWnD,4BAAwB;AACxB,6BAAyB;AACzB,kCAA8B;AAE9B;;GAEG;AACH,oBAAY,mBAAmB;IAC7B;;OAEG;IACH,eAAe,sBAAsB;IAErC;;;;;;OAMG;IACH,gBAAgB,uBAAuB;IAEvC;;;;;;OAMG;IACH,qBAAqB,6BAA6B;IAElD;;;;;;OAMG;IACH,aAAa,mBAAmB;IAEhC;;OAEG;IACH,gBAAgB,uBAAuB;IAEvC;;;;;OAKG;IACH,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;QAmBrC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,SAAS,oBAAoB,EAEpC,IAAI,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC,EAAE,EAE9C,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,SAAS,GAAG,IAAI,EAAE,EAAE,GAEnC,OAAO,CAAC,OAAO,IAAI,OAAO,GAAG;IAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAA;CAAE,CAOzE"}

package/dist/api/v2/create-account/index.d.mts

@@ -1,5 +1,6 @@
 import { type Infer } from "@metamask/superstruct";
 export * from "./bip44.mjs";
+export * from "./custom.mjs";
 export * from "./private-key.mjs";
 /**
  * Enum representing the different ways an account can be created.
@@ -17,6 +18,14 @@ export declare enum AccountCreationType {
      * index.
      */
     Bip44DeriveIndex = "bip44:derive-index",
+    /**
+     * Represents accounts created by deriving a range of BIP-44 account indices.
+     *
+     * More than one account can be created per index, for example, the keyring
+     * can create multiple account types (e.g., P2PKH, P2TR, P2WPKH) for each
+     * account index in the range.
+     */
+    Bip44DeriveIndexRange = "bip44:derive-index-range",
     /**
      * Represents accounts created through BIP-44 account discovery.
      *
@@ -28,7 +37,14 @@ export declare enum AccountCreationType {
     /**
      * Represents an account imported from a private key.
      */
-    PrivateKeyImport = "private-key:import"
+    PrivateKeyImport = "private-key:import",
+    /**
+     * Represents an account created using a custom, keyring-specific method.
+     *
+     * This is used by keyrings that have non-standard account creation flows
+     * and declare `custom.createAccounts: true` in their capabilities.
+     */
+    Custom = "custom"
 }
 /**
  * Struct for {@link CreateAccountOptions}.
@@ -45,6 +61,15 @@ export declare const CreateAccountOptionsStruct: import("@metamask/superstruct")
     type: "bip44:discover";
     groupIndex: number;
     entropySource: string;
+} | {
+    type: "bip44:derive-index-range";
+    range: {
+        from: number;
+        to: number;
+    };
+    entropySource: string;
+} | {
+    type: "custom";
 } | {
     type: "private-key:import";
     encoding: "hexadecimal" | "base58";
@@ -55,4 +80,33 @@ export declare const CreateAccountOptionsStruct: import("@metamask/superstruct")
  * Represents the available options for creating a new account.
  */
 export type CreateAccountOptions = Infer<typeof CreateAccountOptionsStruct>;
+/**
+ * Asserts that a given create account option type is supported by the keyring.
+ *
+ * @example
+ * ```ts
+ * createAccounts(options: CreateAccountOptions) {
+ *   assertCreateAccountOptionIsSupported(options, [
+ *     ${AccountCreationType.Bip44DeriveIndex},
+ *     ${AccountCreationType.Bip44DeriveIndexRange},
+ *   ] as const);
+ *
+ *   // At this point, TypeScript knows that options.type is either Bip44DeriveIndex or Bip44DeriveIndexRange.
+ *   if (options.type === AccountCreationType.Bip44DeriveIndex) {
+ *     ... // Handle Bip44DeriveIndex case.
+ *   } else {
+ *     ... // Handle Bip44DeriveIndexRange case.
+ *   }
+ *   ...
+ *   return accounts;
+ * }
+ * ```
+ *
+ * @param options - The create account option object to check.
+ * @param supportedTypes - The list of supported create account option types for this keyring.
+ * @throws Will throw an error if the provided options are not supported.
+ */
+export declare function assertCreateAccountOptionIsSupported<Options extends CreateAccountOptions, Type extends `${CreateAccountOptions['type']}`>(options: Options, supportedTypes: readonly `${Type}`[]): asserts options is Options & {
+    type: `${Type}` & `${Options['type']}`;
+};
 //# sourceMappingURL=index.d.mts.map

package/dist/api/v2/create-account/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../src/api/v2/create-account/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,KAAK,EAAE,8BAA8B;AASnD,4BAAwB;AACxB,kCAA8B;AAE9B;;GAEG;AACH,oBAAY,mBAAmB;IAC7B;;OAEG;IACH,eAAe,sBAAsB;IAErC;;;;;;OAMG;IACH,gBAAgB,uBAAuB;IAEvC;;;;;;OAMG;IACH,aAAa,mBAAmB;IAEhC;;OAEG;IACH,gBAAgB,uBAAuB;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;QAerC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../src/api/v2/create-account/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,KAAK,EAAE,8BAA8B;AAWnD,4BAAwB;AACxB,6BAAyB;AACzB,kCAA8B;AAE9B;;GAEG;AACH,oBAAY,mBAAmB;IAC7B;;OAEG;IACH,eAAe,sBAAsB;IAErC;;;;;;OAMG;IACH,gBAAgB,uBAAuB;IAEvC;;;;;;OAMG;IACH,qBAAqB,6BAA6B;IAElD;;;;;;OAMG;IACH,aAAa,mBAAmB;IAEhC;;OAEG;IACH,gBAAgB,uBAAuB;IAEvC;;;;;OAKG;IACH,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;QAmBrC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,SAAS,oBAAoB,EAEpC,IAAI,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC,EAAE,EAE9C,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,SAAS,GAAG,IAAI,EAAE,EAAE,GAEnC,OAAO,CAAC,OAAO,IAAI,OAAO,GAAG;IAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAA;CAAE,CAOzE"}

package/dist/api/v2/create-account/index.mjs

@@ -1,7 +1,9 @@
 import { selectiveUnion } from "@metamask/keyring-utils";
-import { CreateAccountBip44DiscoverOptionsStruct, CreateAccountBip44DeriveIndexOptionsStruct, CreateAccountBip44DerivePathOptionsStruct } from "./bip44.mjs";
+import { CreateAccountBip44DiscoverOptionsStruct, CreateAccountBip44DeriveIndexOptionsStruct, CreateAccountBip44DeriveIndexRangeOptionsStruct, CreateAccountBip44DerivePathOptionsStruct } from "./bip44.mjs";
+import { CreateAccountCustomOptionsStruct } from "./custom.mjs";
 import { CreateAccountPrivateKeyOptionsStruct } from "./private-key.mjs";
 export * from "./bip44.mjs";
+export * from "./custom.mjs";
 export * from "./private-key.mjs";
 /**
  * Enum representing the different ways an account can be created.
@@ -20,6 +22,14 @@ export var AccountCreationType;
      * index.
      */
     AccountCreationType["Bip44DeriveIndex"] = "bip44:derive-index";
+    /**
+     * Represents accounts created by deriving a range of BIP-44 account indices.
+     *
+     * More than one account can be created per index, for example, the keyring
+     * can create multiple account types (e.g., P2PKH, P2TR, P2WPKH) for each
+     * account index in the range.
+     */
+    AccountCreationType["Bip44DeriveIndexRange"] = "bip44:derive-index-range";
     /**
      * Represents accounts created through BIP-44 account discovery.
      *
@@ -32,6 +42,13 @@ export var AccountCreationType;
      * Represents an account imported from a private key.
      */
     AccountCreationType["PrivateKeyImport"] = "private-key:import";
+    /**
+     * Represents an account created using a custom, keyring-specific method.
+     *
+     * This is used by keyrings that have non-standard account creation flows
+     * and declare `custom.createAccounts: true` in their capabilities.
+     */
+    AccountCreationType["Custom"] = "custom";
 })(AccountCreationType || (AccountCreationType = {}));
 /**
  * Struct for {@link CreateAccountOptions}.
@@ -43,13 +60,50 @@ export const CreateAccountOptionsStruct = selectiveUnion((value) => {
             return CreateAccountBip44DerivePathOptionsStruct;
         case AccountCreationType.Bip44DeriveIndex:
             return CreateAccountBip44DeriveIndexOptionsStruct;
+        case AccountCreationType.Bip44DeriveIndexRange:
+            return CreateAccountBip44DeriveIndexRangeOptionsStruct;
         case AccountCreationType.Bip44Discover:
             return CreateAccountBip44DiscoverOptionsStruct;
         case AccountCreationType.PrivateKeyImport:
             return CreateAccountPrivateKeyOptionsStruct;
+        case AccountCreationType.Custom:
+            return CreateAccountCustomOptionsStruct;
         default:
             // Return first struct as fallback - validation will fail with proper error indicating the type mismatch
             return CreateAccountBip44DerivePathOptionsStruct;
     }
 });
+/**
+ * Asserts that a given create account option type is supported by the keyring.
+ *
+ * @example
+ * ```ts
+ * createAccounts(options: CreateAccountOptions) {
+ *   assertCreateAccountOptionIsSupported(options, [
+ *     ${AccountCreationType.Bip44DeriveIndex},
+ *     ${AccountCreationType.Bip44DeriveIndexRange},
+ *   ] as const);
+ *
+ *   // At this point, TypeScript knows that options.type is either Bip44DeriveIndex or Bip44DeriveIndexRange.
+ *   if (options.type === AccountCreationType.Bip44DeriveIndex) {
+ *     ... // Handle Bip44DeriveIndex case.
+ *   } else {
+ *     ... // Handle Bip44DeriveIndexRange case.
+ *   }
+ *   ...
+ *   return accounts;
+ * }
+ * ```
+ *
+ * @param options - The create account option object to check.
+ * @param supportedTypes - The list of supported create account option types for this keyring.
+ * @throws Will throw an error if the provided options are not supported.
+ */
+export function assertCreateAccountOptionIsSupported(options, supportedTypes) {
+    const { type } = options;
+    const types = supportedTypes;
+    if (!types.includes(type)) {
+        throw new Error(`Unsupported create account option type: ${type}`);
+    }
+}
 //# sourceMappingURL=index.mjs.map

package/dist/api/v2/create-account/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/api/v2/create-account/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gCAAgC;AAGzD,OAAO,EACL,uCAAuC,EACvC,0CAA0C,EAC1C,yCAAyC,EAC1C,oBAAgB;AACjB,OAAO,EAAE,oCAAoC,EAAE,0BAAsB;AAErE,4BAAwB;AACxB,kCAA8B;AAE9B;;GAEG;AACH,MAAM,CAAN,IAAY,mBA4BX;AA5BD,WAAY,mBAAmB;IAC7B;;OAEG;IACH,4DAAqC,CAAA;IAErC;;;;;;OAMG;IACH,8DAAuC,CAAA;IAEvC;;;;;;OAMG;IACH,uDAAgC,CAAA;IAEhC;;OAEG;IACH,8DAAuC,CAAA;AACzC,CAAC,EA5BW,mBAAmB,KAAnB,mBAAmB,QA4B9B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC,CAAC,KAAU,EAAE,EAAE;IACtE,MAAM,mBAAmB,GAAG,KAAK,EAAE,IAA2B,CAAC;IAC/D,QAAQ,mBAAmB,EAAE,CAAC;QAC5B,KAAK,mBAAmB,CAAC,eAAe;YACtC,OAAO,yCAAyC,CAAC;QACnD,KAAK,mBAAmB,CAAC,gBAAgB;YACvC,OAAO,0CAA0C,CAAC;QACpD,KAAK,mBAAmB,CAAC,aAAa;YACpC,OAAO,uCAAuC,CAAC;QACjD,KAAK,mBAAmB,CAAC,gBAAgB;YACvC,OAAO,oCAAoC,CAAC;QAC9C;YACE,wGAAwG;YACxG,OAAO,yCAAyC,CAAC;IACrD,CAAC;AACH,CAAC,CAAC,CAAC","sourcesContent":["import { selectiveUnion } from '@metamask/keyring-utils';\nimport { type Infer } from '@metamask/superstruct';\n\nimport {\n  CreateAccountBip44DiscoverOptionsStruct,\n  CreateAccountBip44DeriveIndexOptionsStruct,\n  CreateAccountBip44DerivePathOptionsStruct,\n} from './bip44';\nimport { CreateAccountPrivateKeyOptionsStruct } from './private-key';\n\nexport * from './bip44';\nexport * from './private-key';\n\n/**\n * Enum representing the different ways an account can be created.\n */\nexport enum AccountCreationType {\n  /**\n   * Represents an account created using a BIP-44 derivation path.\n   */\n  Bip44DerivePath = 'bip44:derive-path',\n\n  /**\n   * Represents accounts created using a BIP-44 account index.\n   *\n   * More than one account can be created, for example, the keyring can create\n   * multiple account types (e.g., P2PKH, P2TR, P2WPKH) for the same account\n   * index.\n   */\n  Bip44DeriveIndex = 'bip44:derive-index',\n\n  /**\n   * Represents accounts created through BIP-44 account discovery.\n   *\n   * More than one account can be created, for example, the keyring can create\n   * multiple account types (e.g., P2PKH, P2TR, P2WPKH) for the same account\n   * index.\n   */\n  Bip44Discover = 'bip44:discover',\n\n  /**\n   * Represents an account imported from a private key.\n   */\n  PrivateKeyImport = 'private-key:import',\n}\n\n/**\n * Struct for {@link CreateAccountOptions}.\n */\nexport const CreateAccountOptionsStruct = selectiveUnion((value: any) => {\n  const accountCreationType = value?.type as AccountCreationType;\n  switch (accountCreationType) {\n    case AccountCreationType.Bip44DerivePath:\n      return CreateAccountBip44DerivePathOptionsStruct;\n    case AccountCreationType.Bip44DeriveIndex:\n      return CreateAccountBip44DeriveIndexOptionsStruct;\n    case AccountCreationType.Bip44Discover:\n      return CreateAccountBip44DiscoverOptionsStruct;\n    case AccountCreationType.PrivateKeyImport:\n      return CreateAccountPrivateKeyOptionsStruct;\n    default:\n      // Return first struct as fallback - validation will fail with proper error indicating the type mismatch\n      return CreateAccountBip44DerivePathOptionsStruct;\n  }\n});\n\n/**\n * Represents the available options for creating a new account.\n */\nexport type CreateAccountOptions = Infer<typeof CreateAccountOptionsStruct>;\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/api/v2/create-account/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gCAAgC;AAGzD,OAAO,EACL,uCAAuC,EACvC,0CAA0C,EAC1C,+CAA+C,EAC/C,yCAAyC,EAC1C,oBAAgB;AACjB,OAAO,EAAE,gCAAgC,EAAE,qBAAiB;AAC5D,OAAO,EAAE,oCAAoC,EAAE,0BAAsB;AAErE,4BAAwB;AACxB,6BAAyB;AACzB,kCAA8B;AAE9B;;GAEG;AACH,MAAM,CAAN,IAAY,mBA6CX;AA7CD,WAAY,mBAAmB;IAC7B;;OAEG;IACH,4DAAqC,CAAA;IAErC;;;;;;OAMG;IACH,8DAAuC,CAAA;IAEvC;;;;;;OAMG;IACH,yEAAkD,CAAA;IAElD;;;;;;OAMG;IACH,uDAAgC,CAAA;IAEhC;;OAEG;IACH,8DAAuC,CAAA;IAEvC;;;;;OAKG;IACH,wCAAiB,CAAA;AACnB,CAAC,EA7CW,mBAAmB,KAAnB,mBAAmB,QA6C9B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC,CAAC,KAAU,EAAE,EAAE;IACtE,MAAM,mBAAmB,GAAG,KAAK,EAAE,IAA2B,CAAC;IAC/D,QAAQ,mBAAmB,EAAE,CAAC;QAC5B,KAAK,mBAAmB,CAAC,eAAe;YACtC,OAAO,yCAAyC,CAAC;QACnD,KAAK,mBAAmB,CAAC,gBAAgB;YACvC,OAAO,0CAA0C,CAAC;QACpD,KAAK,mBAAmB,CAAC,qBAAqB;YAC5C,OAAO,+CAA+C,CAAC;QACzD,KAAK,mBAAmB,CAAC,aAAa;YACpC,OAAO,uCAAuC,CAAC;QACjD,KAAK,mBAAmB,CAAC,gBAAgB;YACvC,OAAO,oCAAoC,CAAC;QAC9C,KAAK,mBAAmB,CAAC,MAAM;YAC7B,OAAO,gCAAgC,CAAC;QAC1C;YACE,wGAAwG;YACxG,OAAO,yCAAyC,CAAC;IACrD,CAAC;AACH,CAAC,CAAC,CAAC;AAOH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,oCAAoC,CAKlD,OAAgB,EAChB,cAAoC;IAGpC,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,MAAM,KAAK,GAA4C,cAAc,CAAC;IAEtE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,2CAA2C,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC","sourcesContent":["import { selectiveUnion } from '@metamask/keyring-utils';\nimport { type Infer } from '@metamask/superstruct';\n\nimport {\n  CreateAccountBip44DiscoverOptionsStruct,\n  CreateAccountBip44DeriveIndexOptionsStruct,\n  CreateAccountBip44DeriveIndexRangeOptionsStruct,\n  CreateAccountBip44DerivePathOptionsStruct,\n} from './bip44';\nimport { CreateAccountCustomOptionsStruct } from './custom';\nimport { CreateAccountPrivateKeyOptionsStruct } from './private-key';\n\nexport * from './bip44';\nexport * from './custom';\nexport * from './private-key';\n\n/**\n * Enum representing the different ways an account can be created.\n */\nexport enum AccountCreationType {\n  /**\n   * Represents an account created using a BIP-44 derivation path.\n   */\n  Bip44DerivePath = 'bip44:derive-path',\n\n  /**\n   * Represents accounts created using a BIP-44 account index.\n   *\n   * More than one account can be created, for example, the keyring can create\n   * multiple account types (e.g., P2PKH, P2TR, P2WPKH) for the same account\n   * index.\n   */\n  Bip44DeriveIndex = 'bip44:derive-index',\n\n  /**\n   * Represents accounts created by deriving a range of BIP-44 account indices.\n   *\n   * More than one account can be created per index, for example, the keyring\n   * can create multiple account types (e.g., P2PKH, P2TR, P2WPKH) for each\n   * account index in the range.\n   */\n  Bip44DeriveIndexRange = 'bip44:derive-index-range',\n\n  /**\n   * Represents accounts created through BIP-44 account discovery.\n   *\n   * More than one account can be created, for example, the keyring can create\n   * multiple account types (e.g., P2PKH, P2TR, P2WPKH) for the same account\n   * index.\n   */\n  Bip44Discover = 'bip44:discover',\n\n  /**\n   * Represents an account imported from a private key.\n   */\n  PrivateKeyImport = 'private-key:import',\n\n  /**\n   * Represents an account created using a custom, keyring-specific method.\n   *\n   * This is used by keyrings that have non-standard account creation flows\n   * and declare `custom.createAccounts: true` in their capabilities.\n   */\n  Custom = 'custom',\n}\n\n/**\n * Struct for {@link CreateAccountOptions}.\n */\nexport const CreateAccountOptionsStruct = selectiveUnion((value: any) => {\n  const accountCreationType = value?.type as AccountCreationType;\n  switch (accountCreationType) {\n    case AccountCreationType.Bip44DerivePath:\n      return CreateAccountBip44DerivePathOptionsStruct;\n    case AccountCreationType.Bip44DeriveIndex:\n      return CreateAccountBip44DeriveIndexOptionsStruct;\n    case AccountCreationType.Bip44DeriveIndexRange:\n      return CreateAccountBip44DeriveIndexRangeOptionsStruct;\n    case AccountCreationType.Bip44Discover:\n      return CreateAccountBip44DiscoverOptionsStruct;\n    case AccountCreationType.PrivateKeyImport:\n      return CreateAccountPrivateKeyOptionsStruct;\n    case AccountCreationType.Custom:\n      return CreateAccountCustomOptionsStruct;\n    default:\n      // Return first struct as fallback - validation will fail with proper error indicating the type mismatch\n      return CreateAccountBip44DerivePathOptionsStruct;\n  }\n});\n\n/**\n * Represents the available options for creating a new account.\n */\nexport type CreateAccountOptions = Infer<typeof CreateAccountOptionsStruct>;\n\n/**\n * Asserts that a given create account option type is supported by the keyring.\n *\n * @example\n * ```ts\n * createAccounts(options: CreateAccountOptions) {\n *   assertCreateAccountOptionIsSupported(options, [\n *     ${AccountCreationType.Bip44DeriveIndex},\n *     ${AccountCreationType.Bip44DeriveIndexRange},\n *   ] as const);\n *\n *   // At this point, TypeScript knows that options.type is either Bip44DeriveIndex or Bip44DeriveIndexRange.\n *   if (options.type === AccountCreationType.Bip44DeriveIndex) {\n *     ... // Handle Bip44DeriveIndex case.\n *   } else {\n *     ... // Handle Bip44DeriveIndexRange case.\n *   }\n *   ...\n *   return accounts;\n * }\n * ```\n *\n * @param options - The create account option object to check.\n * @param supportedTypes - The list of supported create account option types for this keyring.\n * @throws Will throw an error if the provided options are not supported.\n */\nexport function assertCreateAccountOptionIsSupported<\n  Options extends CreateAccountOptions,\n  // We use template literal types to enforce string-literal over strict enum values.\n  Type extends `${CreateAccountOptions['type']}`,\n>(\n  options: Options,\n  supportedTypes: readonly `${Type}`[],\n  // Use intersection to avoid widening `type` beyond `Options['type']`.\n): asserts options is Options & { type: `${Type}` & `${Options['type']}` } {\n  const { type } = options;\n  const types: readonly CreateAccountOptions['type'][] = supportedTypes;\n\n  if (!types.includes(type)) {\n    throw new Error(`Unsupported create account option type: ${type}`);\n  }\n}\n"]}

package/dist/api/v2/index.cjs

@@ -19,4 +19,5 @@ __exportStar(require("./keyring-type.cjs"), exports);
 __exportStar(require("./create-account/index.cjs"), exports);
 __exportStar(require("./export-account/index.cjs"), exports);
 __exportStar(require("./private-key.cjs"), exports);
+__exportStar(require("./wrapper/index.cjs"), exports);
 //# sourceMappingURL=index.cjs.map

package/dist/api/v2/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/api/v2/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,6DAAuC;AACvC,qDAA+B;AAC/B,6DAAiC;AACjC,6DAAiC;AACjC,oDAA8B","sourcesContent":["export type * from './keyring';\nexport * from './keyring-capabilities';\nexport * from './keyring-type';\nexport * from './create-account';\nexport * from './export-account';\nexport * from './private-key';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/api/v2/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,6DAAuC;AACvC,qDAA+B;AAC/B,6DAAiC;AACjC,6DAAiC;AACjC,oDAA8B;AAC9B,sDAA0B","sourcesContent":["export type * from './keyring';\nexport * from './keyring-capabilities';\nexport * from './keyring-type';\nexport * from './create-account';\nexport * from './export-account';\nexport * from './private-key';\nexport * from './wrapper';\n"]}

package/dist/api/v2/index.d.cts

@@ -4,4 +4,5 @@ export * from "./keyring-type.cjs";
 export * from "./create-account/index.cjs";
 export * from "./export-account/index.cjs";
 export * from "./private-key.cjs";
+export * from "./wrapper/index.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/api/v2/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/api/v2/index.ts"],"names":[],"mappings":"AAAA,mCAA+B;AAC/B,2CAAuC;AACvC,mCAA+B;AAC/B,2CAAiC;AACjC,2CAAiC;AACjC,kCAA8B"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/api/v2/index.ts"],"names":[],"mappings":"AAAA,mCAA+B;AAC/B,2CAAuC;AACvC,mCAA+B;AAC/B,2CAAiC;AACjC,2CAAiC;AACjC,kCAA8B;AAC9B,oCAA0B"}

package/dist/api/v2/index.d.mts

@@ -4,4 +4,5 @@ export * from "./keyring-type.mjs";
 export * from "./create-account/index.mjs";
 export * from "./export-account/index.mjs";
 export * from "./private-key.mjs";
+export * from "./wrapper/index.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/api/v2/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/api/v2/index.ts"],"names":[],"mappings":"AAAA,mCAA+B;AAC/B,2CAAuC;AACvC,mCAA+B;AAC/B,2CAAiC;AACjC,2CAAiC;AACjC,kCAA8B"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/api/v2/index.ts"],"names":[],"mappings":"AAAA,mCAA+B;AAC/B,2CAAuC;AACvC,mCAA+B;AAC/B,2CAAiC;AACjC,2CAAiC;AACjC,kCAA8B;AAC9B,oCAA0B"}

package/dist/api/v2/index.mjs

@@ -3,4 +3,5 @@ export * from "./keyring-type.mjs";
 export * from "./create-account/index.mjs";
 export * from "./export-account/index.mjs";
 export * from "./private-key.mjs";
+export * from "./wrapper/index.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/api/v2/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/api/v2/index.ts"],"names":[],"mappings":"AACA,2CAAuC;AACvC,mCAA+B;AAC/B,2CAAiC;AACjC,2CAAiC;AACjC,kCAA8B","sourcesContent":["export type * from './keyring';\nexport * from './keyring-capabilities';\nexport * from './keyring-type';\nexport * from './create-account';\nexport * from './export-account';\nexport * from './private-key';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/api/v2/index.ts"],"names":[],"mappings":"AACA,2CAAuC;AACvC,mCAA+B;AAC/B,2CAAiC;AACjC,2CAAiC;AACjC,kCAA8B;AAC9B,oCAA0B","sourcesContent":["export type * from './keyring';\nexport * from './keyring-capabilities';\nexport * from './keyring-type';\nexport * from './create-account';\nexport * from './export-account';\nexport * from './private-key';\nexport * from './wrapper';\n"]}

package/dist/api/v2/keyring-capabilities.cjs

@@ -19,15 +19,19 @@ exports.KeyringCapabilitiesStruct = (0, superstruct_1.object)({
         /**
          * Whether the keyring supports deriving accounts from a specific BIP-44 path.
          */
-        derivePath: (0, superstruct_1.boolean)(),
+        derivePath: (0, superstruct_1.exactOptional)((0, superstruct_1.boolean)()),
         /**
          * Whether the keyring supports deriving accounts from a BIP-44 account index.
          */
-        deriveIndex: (0, superstruct_1.boolean)(),
+        deriveIndex: (0, superstruct_1.exactOptional)((0, superstruct_1.boolean)()),
+        /**
+         * Whether the keyring supports deriving accounts from a range of BIP-44 account indices.
+         */
+        deriveIndexRange: (0, superstruct_1.exactOptional)((0, superstruct_1.boolean)()),
         /**
          * Whether the keyring supports BIP-44 account discovery.
          */
-        discover: (0, superstruct_1.boolean)(),
+        discover: (0, superstruct_1.exactOptional)((0, superstruct_1.boolean)()),
     })),
     /**
      * Private key capabilities supported by this keyring.
@@ -42,5 +46,15 @@ exports.KeyringCapabilitiesStruct = (0, superstruct_1.object)({
          */
         exportFormats: (0, superstruct_1.exactOptional)((0, superstruct_1.array)(private_key_1.ExportPrivateKeyFormatStruct)),
     })),
+    /**
+     * Indicates which KeyringV2 methods accept non-standard options.
+     *
+     * When a method is set to `true`, it signals that the keyring implementation
+     * accepts custom options for that method, different from the standard API.
+     * This is a workaround for keyrings with very specific requirements.
+     */
+    custom: (0, superstruct_1.exactOptional)((0, superstruct_1.partial)((0, superstruct_1.object)({
+        createAccounts: (0, superstruct_1.boolean)(),
+    }))),
 });
 //# sourceMappingURL=keyring-capabilities.cjs.map

package/dist/api/v2/keyring-capabilities.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"keyring-capabilities.cjs","sourceRoot":"","sources":["../../../src/api/v2/keyring-capabilities.ts"],"names":[],"mappings":";;;AAAA,uDAO+B;AAE/B,mDAGuB;AACvB,sCAA4C;AAE5C;;GAEG;AACU,QAAA,yBAAyB,GAAG,IAAA,oBAAM,EAAC;IAC9C;;OAEG;IACH,MAAM,EAAE,IAAA,sBAAQ,EAAC,IAAA,mBAAK,EAAC,wBAAiB,CAAC,CAAC;IAC1C;;OAEG;IACH,KAAK,EAAE,IAAA,2BAAa,EAClB,IAAA,oBAAM,EAAC;QACL;;WAEG;QACH,UAAU,EAAE,IAAA,qBAAO,GAAE;QACrB;;WAEG;QACH,WAAW,EAAE,IAAA,qBAAO,GAAE;QACtB;;WAEG;QACH,QAAQ,EAAE,IAAA,qBAAO,GAAE;KACpB,CAAC,CACH;IACD;;OAEG;IACH,UAAU,EAAE,IAAA,2BAAa,EACvB,IAAA,oBAAM,EAAC;QACL;;WAEG;QACH,aAAa,EAAE,IAAA,2BAAa,EAAC,IAAA,mBAAK,EAAC,0CAA4B,CAAC,CAAC;QACjE;;WAEG;QACH,aAAa,EAAE,IAAA,2BAAa,EAAC,IAAA,mBAAK,EAAC,0CAA4B,CAAC,CAAC;KAClE,CAAC,CACH;CACF,CAAC,CAAC","sourcesContent":["import {\n  array,\n  boolean,\n  exactOptional,\n  nonempty,\n  object,\n  type Infer,\n} from '@metamask/superstruct';\n\nimport {\n  ExportPrivateKeyFormatStruct,\n  ImportPrivateKeyFormatStruct,\n} from './private-key';\nimport { CaipChainIdStruct } from '../caip';\n\n/**\n * Struct for {@link KeyringCapabilities}.\n */\nexport const KeyringCapabilitiesStruct = object({\n  /**\n   * List of CAIP-2 chain IDs that this keyring supports.\n   */\n  scopes: nonempty(array(CaipChainIdStruct)),\n  /**\n   * BIP-44 capabilities supported by this keyring.\n   */\n  bip44: exactOptional(\n    object({\n      /**\n       * Whether the keyring supports deriving accounts from a specific BIP-44 path.\n       */\n      derivePath: boolean(),\n      /**\n       * Whether the keyring supports deriving accounts from a BIP-44 account index.\n       */\n      deriveIndex: boolean(),\n      /**\n       * Whether the keyring supports BIP-44 account discovery.\n       */\n      discover: boolean(),\n    }),\n  ),\n  /**\n   * Private key capabilities supported by this keyring.\n   */\n  privateKey: exactOptional(\n    object({\n      /**\n       * List of supported formats for importing private keys.\n       */\n      importFormats: exactOptional(array(ImportPrivateKeyFormatStruct)),\n      /**\n       * List of supported formats for exporting private keys.\n       */\n      exportFormats: exactOptional(array(ExportPrivateKeyFormatStruct)),\n    }),\n  ),\n});\n\n/**\n * Type representing the capabilities supported by a keyring.\n *\n * @example\n * ```ts\n * const capabilities: KeyringCapabilities = {\n *   scopes: ['bip122:_'],\n *   bip44: {\n *     derivePath: true,\n *     deriveIndex: true,\n *     discover: true,\n *   },\n *   privateKey: {\n *     importFormats: [\n *       { encoding: 'base58', type: 'bip122:p2sh' },\n *       { encoding: 'base58', type: 'bip122:p2tr' },\n *       { encoding: 'base58', type: 'bip122:p2pkh' },\n *       { encoding: 'base58', type: 'bip122:p2wpkh' },\n *     ],\n *     exportFormats: [\n *       { encoding: 'base58' },\n *       { encoding: 'base58' },\n *     ],\n *   },\n * };\n * ```\n */\nexport type KeyringCapabilities = Infer<typeof KeyringCapabilitiesStruct>;\n"]}
+{"version":3,"file":"keyring-capabilities.cjs","sourceRoot":"","sources":["../../../src/api/v2/keyring-capabilities.ts"],"names":[],"mappings":";;;AAAA,uDAQ+B;AAE/B,mDAGuB;AACvB,sCAA4C;AAE5C;;GAEG;AACU,QAAA,yBAAyB,GAAG,IAAA,oBAAM,EAAC;IAC9C;;OAEG;IACH,MAAM,EAAE,IAAA,sBAAQ,EAAC,IAAA,mBAAK,EAAC,wBAAiB,CAAC,CAAC;IAC1C;;OAEG;IACH,KAAK,EAAE,IAAA,2BAAa,EAClB,IAAA,oBAAM,EAAC;QACL;;WAEG;QACH,UAAU,EAAE,IAAA,2BAAa,EAAC,IAAA,qBAAO,GAAE,CAAC;QACpC;;WAEG;QACH,WAAW,EAAE,IAAA,2BAAa,EAAC,IAAA,qBAAO,GAAE,CAAC;QACrC;;WAEG;QACH,gBAAgB,EAAE,IAAA,2BAAa,EAAC,IAAA,qBAAO,GAAE,CAAC;QAC1C;;WAEG;QACH,QAAQ,EAAE,IAAA,2BAAa,EAAC,IAAA,qBAAO,GAAE,CAAC;KACnC,CAAC,CACH;IACD;;OAEG;IACH,UAAU,EAAE,IAAA,2BAAa,EACvB,IAAA,oBAAM,EAAC;QACL;;WAEG;QACH,aAAa,EAAE,IAAA,2BAAa,EAAC,IAAA,mBAAK,EAAC,0CAA4B,CAAC,CAAC;QACjE;;WAEG;QACH,aAAa,EAAE,IAAA,2BAAa,EAAC,IAAA,mBAAK,EAAC,0CAA4B,CAAC,CAAC;KAClE,CAAC,CACH;IACD;;;;;;OAMG;IACH,MAAM,EAAE,IAAA,2BAAa,EACnB,IAAA,qBAAO,EACL,IAAA,oBAAM,EAAC;QACL,cAAc,EAAE,IAAA,qBAAO,GAAE;KAC1B,CAAC,CACH,CACF;CACF,CAAC,CAAC","sourcesContent":["import {\n  array,\n  boolean,\n  exactOptional,\n  nonempty,\n  object,\n  partial,\n  type Infer,\n} from '@metamask/superstruct';\n\nimport {\n  ExportPrivateKeyFormatStruct,\n  ImportPrivateKeyFormatStruct,\n} from './private-key';\nimport { CaipChainIdStruct } from '../caip';\n\n/**\n * Struct for {@link KeyringCapabilities}.\n */\nexport const KeyringCapabilitiesStruct = object({\n  /**\n   * List of CAIP-2 chain IDs that this keyring supports.\n   */\n  scopes: nonempty(array(CaipChainIdStruct)),\n  /**\n   * BIP-44 capabilities supported by this keyring.\n   */\n  bip44: exactOptional(\n    object({\n      /**\n       * Whether the keyring supports deriving accounts from a specific BIP-44 path.\n       */\n      derivePath: exactOptional(boolean()),\n      /**\n       * Whether the keyring supports deriving accounts from a BIP-44 account index.\n       */\n      deriveIndex: exactOptional(boolean()),\n      /**\n       * Whether the keyring supports deriving accounts from a range of BIP-44 account indices.\n       */\n      deriveIndexRange: exactOptional(boolean()),\n      /**\n       * Whether the keyring supports BIP-44 account discovery.\n       */\n      discover: exactOptional(boolean()),\n    }),\n  ),\n  /**\n   * Private key capabilities supported by this keyring.\n   */\n  privateKey: exactOptional(\n    object({\n      /**\n       * List of supported formats for importing private keys.\n       */\n      importFormats: exactOptional(array(ImportPrivateKeyFormatStruct)),\n      /**\n       * List of supported formats for exporting private keys.\n       */\n      exportFormats: exactOptional(array(ExportPrivateKeyFormatStruct)),\n    }),\n  ),\n  /**\n   * Indicates which KeyringV2 methods accept non-standard options.\n   *\n   * When a method is set to `true`, it signals that the keyring implementation\n   * accepts custom options for that method, different from the standard API.\n   * This is a workaround for keyrings with very specific requirements.\n   */\n  custom: exactOptional(\n    partial(\n      object({\n        createAccounts: boolean(),\n      }),\n    ),\n  ),\n});\n\n/**\n * Type representing the capabilities supported by a keyring.\n *\n * @example\n * ```ts\n * const capabilities: KeyringCapabilities = {\n *   scopes: ['bip122:_'],\n *   bip44: {\n *     derivePath: true,\n *     deriveIndex: true,\n *     deriveIndexRange: true,\n *     discover: true,\n *   },\n *   privateKey: {\n *     importFormats: [\n *       { encoding: 'base58', type: 'bip122:p2sh' },\n *       { encoding: 'base58', type: 'bip122:p2tr' },\n *       { encoding: 'base58', type: 'bip122:p2pkh' },\n *       { encoding: 'base58', type: 'bip122:p2wpkh' },\n *     ],\n *     exportFormats: [\n *       { encoding: 'base58' },\n *       { encoding: 'base58' },\n *     ],\n *   },\n * };\n * ```\n */\nexport type KeyringCapabilities = Infer<typeof KeyringCapabilitiesStruct>;\n"]}

package/dist/api/v2/keyring-capabilities.d.cts

@@ -4,10 +4,14 @@ import { type Infer } from "@metamask/superstruct";
  */
 export declare const KeyringCapabilitiesStruct: import("@metamask/superstruct").Struct<{
     scopes: `${string}:${string}`[];
+    custom?: {
+        createAccounts?: boolean | undefined;
+    };
     bip44?: {
-        derivePath: boolean;
-        deriveIndex: boolean;
-        discover: boolean;
+        derivePath?: boolean;
+        deriveIndex?: boolean;
+        deriveIndexRange?: boolean;
+        discover?: boolean;
     };
     privateKey?: {
         importFormats?: {
@@ -27,22 +31,27 @@ export declare const KeyringCapabilitiesStruct: import("@metamask/superstruct").
      * BIP-44 capabilities supported by this keyring.
      */
     bip44: import("@metamask/superstruct").ExactOptionalStruct<{
-        derivePath: boolean;
-        deriveIndex: boolean;
-        discover: boolean;
+        derivePath?: boolean;
+        deriveIndex?: boolean;
+        deriveIndexRange?: boolean;
+        discover?: boolean;
     }, {
         /**
          * Whether the keyring supports deriving accounts from a specific BIP-44 path.
          */
-        derivePath: import("@metamask/superstruct").Struct<boolean, null>;
+        derivePath: import("@metamask/superstruct").ExactOptionalStruct<boolean, null>;
         /**
          * Whether the keyring supports deriving accounts from a BIP-44 account index.
          */
-        deriveIndex: import("@metamask/superstruct").Struct<boolean, null>;
+        deriveIndex: import("@metamask/superstruct").ExactOptionalStruct<boolean, null>;
+        /**
+         * Whether the keyring supports deriving accounts from a range of BIP-44 account indices.
+         */
+        deriveIndexRange: import("@metamask/superstruct").ExactOptionalStruct<boolean, null>;
         /**
          * Whether the keyring supports BIP-44 account discovery.
          */
-        discover: import("@metamask/superstruct").Struct<boolean, null>;
+        discover: import("@metamask/superstruct").ExactOptionalStruct<boolean, null>;
     }>;
     /**
      * Private key capabilities supported by this keyring.
@@ -96,6 +105,18 @@ export declare const KeyringCapabilitiesStruct: import("@metamask/superstruct").
             }>;
         }>>;
     }>;
+    /**
+     * Indicates which KeyringV2 methods accept non-standard options.
+     *
+     * When a method is set to `true`, it signals that the keyring implementation
+     * accepts custom options for that method, different from the standard API.
+     * This is a workaround for keyrings with very specific requirements.
+     */
+    custom: import("@metamask/superstruct").ExactOptionalStruct<{
+        createAccounts?: boolean | undefined;
+    }, import("@metamask/superstruct").PartialObjectSchema<{
+        createAccounts: import("@metamask/superstruct").Struct<boolean, null>;
+    }>>;
 }>;
 /**
  * Type representing the capabilities supported by a keyring.
@@ -107,6 +128,7 @@ export declare const KeyringCapabilitiesStruct: import("@metamask/superstruct").
  *   bip44: {
  *     derivePath: true,
  *     deriveIndex: true,
+ *     deriveIndexRange: true,
  *     discover: true,
  *   },
  *   privateKey: {

package/dist/api/v2/keyring-capabilities.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"keyring-capabilities.d.cts","sourceRoot":"","sources":["../../../src/api/v2/keyring-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,KAAK,EACX,8BAA8B;AAQ/B;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;IACpC;;OAEG;;IAEH;;OAEG;;;;;;QAGC;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;;IAIP;;OAEG;;;;;;;;;;QAGC;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;QAEH;;WAEG;;;;;;;;;;;;EAIP,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"keyring-capabilities.d.cts","sourceRoot":"","sources":["../../../src/api/v2/keyring-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,KAAK,EACX,8BAA8B;AAQ/B;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;IACpC;;OAEG;;IAEH;;OAEG;;;;;;;QAGC;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;;IAIP;;OAEG;;;;;;;;;;QAGC;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;QAEH;;WAEG;;;;;;;;;;;;IAIP;;;;;;OAMG;;;;;;EAQH,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/api/v2/keyring-capabilities.d.mts

@@ -4,10 +4,14 @@ import { type Infer } from "@metamask/superstruct";
  */
 export declare const KeyringCapabilitiesStruct: import("@metamask/superstruct").Struct<{
     scopes: `${string}:${string}`[];
+    custom?: {
+        createAccounts?: boolean | undefined;
+    };
     bip44?: {
-        derivePath: boolean;
-        deriveIndex: boolean;
-        discover: boolean;
+        derivePath?: boolean;
+        deriveIndex?: boolean;
+        deriveIndexRange?: boolean;
+        discover?: boolean;
     };
     privateKey?: {
         importFormats?: {
@@ -27,22 +31,27 @@ export declare const KeyringCapabilitiesStruct: import("@metamask/superstruct").
      * BIP-44 capabilities supported by this keyring.
      */
     bip44: import("@metamask/superstruct").ExactOptionalStruct<{
-        derivePath: boolean;
-        deriveIndex: boolean;
-        discover: boolean;
+        derivePath?: boolean;
+        deriveIndex?: boolean;
+        deriveIndexRange?: boolean;
+        discover?: boolean;
     }, {
         /**
          * Whether the keyring supports deriving accounts from a specific BIP-44 path.
          */
-        derivePath: import("@metamask/superstruct").Struct<boolean, null>;
+        derivePath: import("@metamask/superstruct").ExactOptionalStruct<boolean, null>;
         /**
          * Whether the keyring supports deriving accounts from a BIP-44 account index.
          */
-        deriveIndex: import("@metamask/superstruct").Struct<boolean, null>;
+        deriveIndex: import("@metamask/superstruct").ExactOptionalStruct<boolean, null>;
+        /**
+         * Whether the keyring supports deriving accounts from a range of BIP-44 account indices.
+         */
+        deriveIndexRange: import("@metamask/superstruct").ExactOptionalStruct<boolean, null>;
         /**
          * Whether the keyring supports BIP-44 account discovery.
          */
-        discover: import("@metamask/superstruct").Struct<boolean, null>;
+        discover: import("@metamask/superstruct").ExactOptionalStruct<boolean, null>;
     }>;
     /**
      * Private key capabilities supported by this keyring.
@@ -96,6 +105,18 @@ export declare const KeyringCapabilitiesStruct: import("@metamask/superstruct").
             }>;
         }>>;
     }>;
+    /**
+     * Indicates which KeyringV2 methods accept non-standard options.
+     *
+     * When a method is set to `true`, it signals that the keyring implementation
+     * accepts custom options for that method, different from the standard API.
+     * This is a workaround for keyrings with very specific requirements.
+     */
+    custom: import("@metamask/superstruct").ExactOptionalStruct<{
+        createAccounts?: boolean | undefined;
+    }, import("@metamask/superstruct").PartialObjectSchema<{
+        createAccounts: import("@metamask/superstruct").Struct<boolean, null>;
+    }>>;
 }>;
 /**
  * Type representing the capabilities supported by a keyring.
@@ -107,6 +128,7 @@ export declare const KeyringCapabilitiesStruct: import("@metamask/superstruct").
  *   bip44: {
  *     derivePath: true,
  *     deriveIndex: true,
+ *     deriveIndexRange: true,
  *     discover: true,
  *   },
  *   privateKey: {

package/dist/api/v2/keyring-capabilities.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"keyring-capabilities.d.mts","sourceRoot":"","sources":["../../../src/api/v2/keyring-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,KAAK,EACX,8BAA8B;AAQ/B;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;IACpC;;OAEG;;IAEH;;OAEG;;;;;;QAGC;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;;IAIP;;OAEG;;;;;;;;;;QAGC;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;QAEH;;WAEG;;;;;;;;;;;;EAIP,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"keyring-capabilities.d.mts","sourceRoot":"","sources":["../../../src/api/v2/keyring-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,KAAK,EACX,8BAA8B;AAQ/B;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;IACpC;;OAEG;;IAEH;;OAEG;;;;;;;QAGC;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;;IAIP;;OAEG;;;;;;;;;;QAGC;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;QAEH;;WAEG;;;;;;;;;;;;IAIP;;;;;;OAMG;;;;;;EAQH,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/api/v2/keyring-capabilities.mjs

@@ -1,4 +1,4 @@
-import { array, boolean, exactOptional, nonempty, object } from "@metamask/superstruct";
+import { array, boolean, exactOptional, nonempty, object, partial } from "@metamask/superstruct";
 import { ExportPrivateKeyFormatStruct, ImportPrivateKeyFormatStruct } from "./private-key.mjs";
 import { CaipChainIdStruct } from "../caip.mjs";
 /**
@@ -16,15 +16,19 @@ export const KeyringCapabilitiesStruct = object({
         /**
          * Whether the keyring supports deriving accounts from a specific BIP-44 path.
          */
-        derivePath: boolean(),
+        derivePath: exactOptional(boolean()),
         /**
          * Whether the keyring supports deriving accounts from a BIP-44 account index.
          */
-        deriveIndex: boolean(),
+        deriveIndex: exactOptional(boolean()),
+        /**
+         * Whether the keyring supports deriving accounts from a range of BIP-44 account indices.
+         */
+        deriveIndexRange: exactOptional(boolean()),
         /**
          * Whether the keyring supports BIP-44 account discovery.
          */
-        discover: boolean(),
+        discover: exactOptional(boolean()),
     })),
     /**
      * Private key capabilities supported by this keyring.
@@ -39,5 +43,15 @@ export const KeyringCapabilitiesStruct = object({
          */
         exportFormats: exactOptional(array(ExportPrivateKeyFormatStruct)),
     })),
+    /**
+     * Indicates which KeyringV2 methods accept non-standard options.
+     *
+     * When a method is set to `true`, it signals that the keyring implementation
+     * accepts custom options for that method, different from the standard API.
+     * This is a workaround for keyrings with very specific requirements.
+     */
+    custom: exactOptional(partial(object({
+        createAccounts: boolean(),
+    }))),
 });
 //# sourceMappingURL=keyring-capabilities.mjs.map