@metamask/keyring-api 21.2.0 → 21.4.0

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

@@ -0,0 +1,129 @@
+import { type Infer } from "@metamask/superstruct";
+/**
+ * Struct for {@link CreateAccountBip44DerivePathOptions}.
+ */
+export declare const CreateAccountBip44DerivePathOptionsStruct: import("@metamask/superstruct").Struct<{
+    type: "bip44:derive-path";
+    derivationPath: `m/${string}`;
+    entropySource: string;
+}, {
+    /**
+     * Type of the options.
+     */
+    type: import("@metamask/superstruct").Struct<"bip44:derive-path", "bip44:derive-path">;
+    /**
+     * ID of the entropy source to be used to derive the account.
+     */
+    entropySource: import("@metamask/superstruct").Struct<string, null>;
+    /**
+     * BIP-44 derivation path to be used to derive the account.
+     */
+    derivationPath: import("@metamask/superstruct").Struct<`m/${string}`, null>;
+}>;
+/**
+ * Options for creating an account using the given BIP-44 derivation path.
+ */
+export type CreateAccountBip44DerivePathOptions = Infer<typeof CreateAccountBip44DerivePathOptionsStruct>;
+/**
+ * Struct for {@link CreateAccountBip44DeriveIndexOptions}.
+ */
+export declare const CreateAccountBip44DeriveIndexOptionsStruct: import("@metamask/superstruct").Struct<{
+    type: "bip44:derive-index";
+    groupIndex: number;
+    entropySource: string;
+}, {
+    /**
+     * The type of the options.
+     */
+    type: import("@metamask/superstruct").Struct<"bip44:derive-index", "bip44:derive-index">;
+    /**
+     * ID of the entropy source to be used to derive the account.
+     */
+    entropySource: import("@metamask/superstruct").Struct<string, null>;
+    /**
+     * The index of the account group to be derived.
+     */
+    groupIndex: import("@metamask/superstruct").Struct<number, null>;
+}>;
+/**
+ * Options for creating an account using the given BIP-44 account group index.
+ *
+ * Note that the keyring can support non-standard BIP-44 paths for
+ * compatibility with other wallets.
+ */
+export type CreateAccountBip44DeriveIndexOptions = Infer<typeof CreateAccountBip44DeriveIndexOptionsStruct>;
+/**
+ * Struct for {@link CreateAccountBip44DiscoverOptions}.
+ */
+export declare const CreateAccountBip44DiscoverOptionsStruct: import("@metamask/superstruct").Struct<{
+    type: "bip44:discover";
+    groupIndex: number;
+    entropySource: string;
+}, {
+    /**
+     * The type of the options.
+     */
+    type: import("@metamask/superstruct").Struct<"bip44:discover", "bip44:discover">;
+    /**
+     * ID of the entropy source to be used to derive the account.
+     */
+    entropySource: import("@metamask/superstruct").Struct<string, null>;
+    /**
+     * The index of the account group to be derived.
+     */
+    groupIndex: import("@metamask/superstruct").Struct<number, null>;
+}>;
+/**
+ * Options for creating accounts by performing a BIP-44 account discovery.
+ *
+ * Note that the keyring can support non-standard BIP-44 paths for
+ * compatibility with other wallets.
+ */
+export type CreateAccountBip44DiscoverOptions = Infer<typeof CreateAccountBip44DiscoverOptionsStruct>;
+/**
+ * Struct for {@link CreateAccountBip44DeriveIndexRangeOptions}.
+ */
+export declare const CreateAccountBip44DeriveIndexRangeOptionsStruct: import("@metamask/superstruct").Struct<{
+    type: "bip44:derive-index-range";
+    range: {
+        from: number;
+        to: number;
+    };
+    entropySource: string;
+}, {
+    /**
+     * The type of the options.
+     */
+    type: import("@metamask/superstruct").Struct<"bip44:derive-index-range", "bip44:derive-index-range">;
+    /**
+     * ID of the entropy source to be used to derive the accounts.
+     */
+    entropySource: import("@metamask/superstruct").Struct<string, null>;
+    /**
+     * The range of account group indices to derive (inclusive on both ends).
+     */
+    range: import("@metamask/superstruct").Struct<{
+        from: number;
+        to: number;
+    }, {
+        /**
+         * The starting index of the account group range (inclusive).
+         */
+        from: import("@metamask/superstruct").Struct<number, null>;
+        /**
+         * The ending index of the account group range (inclusive).
+         */
+        to: import("@metamask/superstruct").Struct<number, null>;
+    }>;
+}>;
+/**
+ * Options for creating accounts by deriving a range of BIP-44 account indices.
+ *
+ * The range is inclusive on both ends, meaning range.from=0 and range.to=5
+ * will create accounts for group indices 0, 1, 2, 3, 4, and 5.
+ *
+ * Note that the keyring can support non-standard BIP-44 paths for
+ * compatibility with other wallets.
+ */
+export type CreateAccountBip44DeriveIndexRangeOptions = Infer<typeof CreateAccountBip44DeriveIndexRangeOptionsStruct>;
+//# sourceMappingURL=bip44.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bip44.d.mts","sourceRoot":"","sources":["../../../../src/api/v2/create-account/bip44.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,KAAK,EACX,8BAA8B;AAI/B;;GAEG;AACH,eAAO,MAAM,yCAAyC;;;;;IACpD;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;EAEH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG,KAAK,CACrD,OAAO,yCAAyC,CACjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0CAA0C;;;;;IACrD;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;EAEH,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,oCAAoC,GAAG,KAAK,CACtD,OAAO,0CAA0C,CAClD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uCAAuC;;;;;IAClD;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;EAEH,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,iCAAiC,GAAG,KAAK,CACnD,OAAO,uCAAuC,CAC/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,+CAA+C;;;;;;;;IAC1D;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;;;;QAED;;WAEG;;QAEH;;WAEG;;;EAGL,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,yCAAyC,GAAG,KAAK,CAC3D,OAAO,+CAA+C,CACvD,CAAC"}

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

@@ -0,0 +1,80 @@
+import { literal, number, object, string } from "@metamask/superstruct";
+import { DerivationPathStruct } from "../../derivation.mjs";
+/**
+ * Struct for {@link CreateAccountBip44DerivePathOptions}.
+ */
+export const CreateAccountBip44DerivePathOptionsStruct = object({
+    /**
+     * Type of the options.
+     */
+    type: literal('bip44:derive-path'),
+    /**
+     * ID of the entropy source to be used to derive the account.
+     */
+    entropySource: string(),
+    /**
+     * BIP-44 derivation path to be used to derive the account.
+     */
+    derivationPath: DerivationPathStruct,
+});
+/**
+ * Struct for {@link CreateAccountBip44DeriveIndexOptions}.
+ */
+export const CreateAccountBip44DeriveIndexOptionsStruct = object({
+    /**
+     * The type of the options.
+     */
+    type: literal('bip44:derive-index'),
+    /**
+     * ID of the entropy source to be used to derive the account.
+     */
+    entropySource: string(),
+    /**
+     * The index of the account group to be derived.
+     */
+    groupIndex: number(),
+});
+/**
+ * Struct for {@link CreateAccountBip44DiscoverOptions}.
+ */
+export const CreateAccountBip44DiscoverOptionsStruct = object({
+    /**
+     * The type of the options.
+     */
+    type: literal('bip44:discover'),
+    /**
+     * ID of the entropy source to be used to derive the account.
+     */
+    entropySource: string(),
+    /**
+     * The index of the account group to be derived.
+     */
+    groupIndex: number(),
+});
+/**
+ * Struct for {@link CreateAccountBip44DeriveIndexRangeOptions}.
+ */
+export const CreateAccountBip44DeriveIndexRangeOptionsStruct = object({
+    /**
+     * The type of the options.
+     */
+    type: literal('bip44:derive-index-range'),
+    /**
+     * ID of the entropy source to be used to derive the accounts.
+     */
+    entropySource: string(),
+    /**
+     * The range of account group indices to derive (inclusive on both ends).
+     */
+    range: object({
+        /**
+         * The starting index of the account group range (inclusive).
+         */
+        from: number(),
+        /**
+         * The ending index of the account group range (inclusive).
+         */
+        to: number(),
+    }),
+});
+//# sourceMappingURL=bip44.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bip44.mjs","sourceRoot":"","sources":["../../../../src/api/v2/create-account/bip44.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,MAAM,EACN,MAAM,EACN,MAAM,EAEP,8BAA8B;AAE/B,OAAO,EAAE,oBAAoB,EAAE,6BAAyB;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,yCAAyC,GAAG,MAAM,CAAC;IAC9D;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAClC;;OAEG;IACH,aAAa,EAAE,MAAM,EAAE;IACvB;;OAEG;IACH,cAAc,EAAE,oBAAoB;CACrC,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAG,MAAM,CAAC;IAC/D;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC,oBAAoB,CAAC;IACnC;;OAEG;IACH,aAAa,EAAE,MAAM,EAAE;IACvB;;OAEG;IACH,UAAU,EAAE,MAAM,EAAE;CACrB,CAAC,CAAC;AAYH;;GAEG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAG,MAAM,CAAC;IAC5D;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAC/B;;OAEG;IACH,aAAa,EAAE,MAAM,EAAE;IACvB;;OAEG;IACH,UAAU,EAAE,MAAM,EAAE;CACrB,CAAC,CAAC;AAYH;;GAEG;AACH,MAAM,CAAC,MAAM,+CAA+C,GAAG,MAAM,CAAC;IACpE;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC,0BAA0B,CAAC;IACzC;;OAEG;IACH,aAAa,EAAE,MAAM,EAAE;IACvB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;QACZ;;WAEG;QACH,IAAI,EAAE,MAAM,EAAE;QACd;;WAEG;QACH,EAAE,EAAE,MAAM,EAAE;KACb,CAAC;CACH,CAAC,CAAC","sourcesContent":["import {\n  literal,\n  number,\n  object,\n  string,\n  type Infer,\n} from '@metamask/superstruct';\n\nimport { DerivationPathStruct } from '../../derivation';\n\n/**\n * Struct for {@link CreateAccountBip44DerivePathOptions}.\n */\nexport const CreateAccountBip44DerivePathOptionsStruct = object({\n  /**\n   * Type of the options.\n   */\n  type: literal('bip44:derive-path'),\n  /**\n   * ID of the entropy source to be used to derive the account.\n   */\n  entropySource: string(),\n  /**\n   * BIP-44 derivation path to be used to derive the account.\n   */\n  derivationPath: DerivationPathStruct,\n});\n\n/**\n * Options for creating an account using the given BIP-44 derivation path.\n */\nexport type CreateAccountBip44DerivePathOptions = Infer<\n  typeof CreateAccountBip44DerivePathOptionsStruct\n>;\n\n/**\n * Struct for {@link CreateAccountBip44DeriveIndexOptions}.\n */\nexport const CreateAccountBip44DeriveIndexOptionsStruct = object({\n  /**\n   * The type of the options.\n   */\n  type: literal('bip44:derive-index'),\n  /**\n   * ID of the entropy source to be used to derive the account.\n   */\n  entropySource: string(),\n  /**\n   * The index of the account group to be derived.\n   */\n  groupIndex: number(),\n});\n\n/**\n * Options for creating an account using the given BIP-44 account group index.\n *\n * Note that the keyring can support non-standard BIP-44 paths for\n * compatibility with other wallets.\n */\nexport type CreateAccountBip44DeriveIndexOptions = Infer<\n  typeof CreateAccountBip44DeriveIndexOptionsStruct\n>;\n\n/**\n * Struct for {@link CreateAccountBip44DiscoverOptions}.\n */\nexport const CreateAccountBip44DiscoverOptionsStruct = object({\n  /**\n   * The type of the options.\n   */\n  type: literal('bip44:discover'),\n  /**\n   * ID of the entropy source to be used to derive the account.\n   */\n  entropySource: string(),\n  /**\n   * The index of the account group to be derived.\n   */\n  groupIndex: number(),\n});\n\n/**\n * Options for creating accounts by performing a BIP-44 account discovery.\n *\n * Note that the keyring can support non-standard BIP-44 paths for\n * compatibility with other wallets.\n */\nexport type CreateAccountBip44DiscoverOptions = Infer<\n  typeof CreateAccountBip44DiscoverOptionsStruct\n>;\n\n/**\n * Struct for {@link CreateAccountBip44DeriveIndexRangeOptions}.\n */\nexport const CreateAccountBip44DeriveIndexRangeOptionsStruct = object({\n  /**\n   * The type of the options.\n   */\n  type: literal('bip44:derive-index-range'),\n  /**\n   * ID of the entropy source to be used to derive the accounts.\n   */\n  entropySource: string(),\n  /**\n   * The range of account group indices to derive (inclusive on both ends).\n   */\n  range: object({\n    /**\n     * The starting index of the account group range (inclusive).\n     */\n    from: number(),\n    /**\n     * The ending index of the account group range (inclusive).\n     */\n    to: number(),\n  }),\n});\n\n/**\n * Options for creating accounts by deriving a range of BIP-44 account indices.\n *\n * The range is inclusive on both ends, meaning range.from=0 and range.to=5\n * will create accounts for group indices 0, 1, 2, 3, 4, and 5.\n *\n * Note that the keyring can support non-standard BIP-44 paths for\n * compatibility with other wallets.\n */\nexport type CreateAccountBip44DeriveIndexRangeOptions = Infer<\n  typeof CreateAccountBip44DeriveIndexRangeOptionsStruct\n>;\n"]}

package/dist/api/v2/create-account/custom.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateAccountCustomOptionsStruct = void 0;
+const superstruct_1 = require("@metamask/superstruct");
+/**
+ * Struct for {@link CreateAccountCustomOptions}.
+ */
+exports.CreateAccountCustomOptionsStruct = (0, superstruct_1.type)({
+    /**
+     * The type of the options.
+     */
+    type: (0, superstruct_1.literal)('custom'),
+});
+//# sourceMappingURL=custom.cjs.map

package/dist/api/v2/create-account/custom.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.cjs","sourceRoot":"","sources":["../../../../src/api/v2/create-account/custom.ts"],"names":[],"mappings":";;;AAAA,uDAAkE;AAElE;;GAEG;AACU,QAAA,gCAAgC,GAAG,IAAA,kBAAI,EAAC;IACnD;;OAEG;IACH,IAAI,EAAE,IAAA,qBAAO,EAAC,QAAQ,CAAC;CACxB,CAAC,CAAC","sourcesContent":["import { literal, type, type Infer } from '@metamask/superstruct';\n\n/**\n * Struct for {@link CreateAccountCustomOptions}.\n */\nexport const CreateAccountCustomOptionsStruct = type({\n  /**\n   * The type of the options.\n   */\n  type: literal('custom'),\n});\n\n/**\n * Options for creating an account using a custom, keyring-specific method.\n *\n * This is an opaque type that allows keyrings with non-standard account\n * creation flows to define their own options. Keyrings using this type\n * should declare `custom.createAccounts: true` in their capabilities.\n *\n * The actual options accepted by the keyring are implementation-specific\n * and not validated by this struct beyond the `type` field. Adaptors should\n * handle any additional options as needed and add type intersections as necessary.\n */\nexport type CreateAccountCustomOptions = Infer<\n  typeof CreateAccountCustomOptionsStruct\n>;\n"]}

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

@@ -0,0 +1,25 @@
+import { type Infer } from "@metamask/superstruct";
+/**
+ * Struct for {@link CreateAccountCustomOptions}.
+ */
+export declare const CreateAccountCustomOptionsStruct: import("@metamask/superstruct").Struct<{
+    type: "custom";
+}, {
+    /**
+     * The type of the options.
+     */
+    type: import("@metamask/superstruct").Struct<"custom", "custom">;
+}>;
+/**
+ * Options for creating an account using a custom, keyring-specific method.
+ *
+ * This is an opaque type that allows keyrings with non-standard account
+ * creation flows to define their own options. Keyrings using this type
+ * should declare `custom.createAccounts: true` in their capabilities.
+ *
+ * The actual options accepted by the keyring are implementation-specific
+ * and not validated by this struct beyond the `type` field. Adaptors should
+ * handle any additional options as needed and add type intersections as necessary.
+ */
+export type CreateAccountCustomOptions = Infer<typeof CreateAccountCustomOptionsStruct>;
+//# sourceMappingURL=custom.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.cts","sourceRoot":"","sources":["../../../../src/api/v2/create-account/custom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,KAAK,EAAE,8BAA8B;AAElE;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;IAC3C;;OAEG;;EAEH,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,0BAA0B,GAAG,KAAK,CAC5C,OAAO,gCAAgC,CACxC,CAAC"}

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

@@ -0,0 +1,25 @@
+import { type Infer } from "@metamask/superstruct";
+/**
+ * Struct for {@link CreateAccountCustomOptions}.
+ */
+export declare const CreateAccountCustomOptionsStruct: import("@metamask/superstruct").Struct<{
+    type: "custom";
+}, {
+    /**
+     * The type of the options.
+     */
+    type: import("@metamask/superstruct").Struct<"custom", "custom">;
+}>;
+/**
+ * Options for creating an account using a custom, keyring-specific method.
+ *
+ * This is an opaque type that allows keyrings with non-standard account
+ * creation flows to define their own options. Keyrings using this type
+ * should declare `custom.createAccounts: true` in their capabilities.
+ *
+ * The actual options accepted by the keyring are implementation-specific
+ * and not validated by this struct beyond the `type` field. Adaptors should
+ * handle any additional options as needed and add type intersections as necessary.
+ */
+export type CreateAccountCustomOptions = Infer<typeof CreateAccountCustomOptionsStruct>;
+//# sourceMappingURL=custom.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.mts","sourceRoot":"","sources":["../../../../src/api/v2/create-account/custom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,KAAK,EAAE,8BAA8B;AAElE;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;IAC3C;;OAEG;;EAEH,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,0BAA0B,GAAG,KAAK,CAC5C,OAAO,gCAAgC,CACxC,CAAC"}

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

@@ -0,0 +1,11 @@
+import { literal, type } from "@metamask/superstruct";
+/**
+ * Struct for {@link CreateAccountCustomOptions}.
+ */
+export const CreateAccountCustomOptionsStruct = type({
+    /**
+     * The type of the options.
+     */
+    type: literal('custom'),
+});
+//# sourceMappingURL=custom.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"custom.mjs","sourceRoot":"","sources":["../../../../src/api/v2/create-account/custom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAc,8BAA8B;AAElE;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,CAAC;IACnD;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC;CACxB,CAAC,CAAC","sourcesContent":["import { literal, type, type Infer } from '@metamask/superstruct';\n\n/**\n * Struct for {@link CreateAccountCustomOptions}.\n */\nexport const CreateAccountCustomOptionsStruct = type({\n  /**\n   * The type of the options.\n   */\n  type: literal('custom'),\n});\n\n/**\n * Options for creating an account using a custom, keyring-specific method.\n *\n * This is an opaque type that allows keyrings with non-standard account\n * creation flows to define their own options. Keyrings using this type\n * should declare `custom.createAccounts: true` in their capabilities.\n *\n * The actual options accepted by the keyring are implementation-specific\n * and not validated by this struct beyond the `type` field. Adaptors should\n * handle any additional options as needed and add type intersections as necessary.\n */\nexport type CreateAccountCustomOptions = Infer<\n  typeof CreateAccountCustomOptionsStruct\n>;\n"]}

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

@@ -0,0 +1,93 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateAccountOptionsStruct = exports.AccountCreationType = void 0;
+const keyring_utils_1 = require("@metamask/keyring-utils");
+const bip44_1 = require("./bip44.cjs");
+const custom_1 = require("./custom.cjs");
+const private_key_1 = require("./private-key.cjs");
+__exportStar(require("./bip44.cjs"), exports);
+__exportStar(require("./custom.cjs"), exports);
+__exportStar(require("./private-key.cjs"), exports);
+/**
+ * Enum representing the different ways an account can be created.
+ */
+var AccountCreationType;
+(function (AccountCreationType) {
+    /**
+     * Represents an account created using a BIP-44 derivation path.
+     */
+    AccountCreationType["Bip44DerivePath"] = "bip44:derive-path";
+    /**
+     * Represents accounts created using a BIP-44 account index.
+     *
+     * More than one account can be created, for example, the keyring can create
+     * multiple account types (e.g., P2PKH, P2TR, P2WPKH) for the same account
+     * 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.
+     *
+     * More than one account can be created, for example, the keyring can create
+     * multiple account types (e.g., P2PKH, P2TR, P2WPKH) for the same account
+     * index.
+     */
+    AccountCreationType["Bip44Discover"] = "bip44:discover";
+    /**
+     * 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 || (exports.AccountCreationType = AccountCreationType = {}));
+/**
+ * Struct for {@link CreateAccountOptions}.
+ */
+exports.CreateAccountOptionsStruct = (0, keyring_utils_1.selectiveUnion)((value) => {
+    const accountCreationType = value?.type;
+    switch (accountCreationType) {
+        case AccountCreationType.Bip44DerivePath:
+            return bip44_1.CreateAccountBip44DerivePathOptionsStruct;
+        case AccountCreationType.Bip44DeriveIndex:
+            return bip44_1.CreateAccountBip44DeriveIndexOptionsStruct;
+        case AccountCreationType.Bip44DeriveIndexRange:
+            return bip44_1.CreateAccountBip44DeriveIndexRangeOptionsStruct;
+        case AccountCreationType.Bip44Discover:
+            return bip44_1.CreateAccountBip44DiscoverOptionsStruct;
+        case AccountCreationType.PrivateKeyImport:
+            return private_key_1.CreateAccountPrivateKeyOptionsStruct;
+        case AccountCreationType.Custom:
+            return custom_1.CreateAccountCustomOptionsStruct;
+        default:
+            // Return first struct as fallback - validation will fail with proper error indicating the type mismatch
+            return bip44_1.CreateAccountBip44DerivePathOptionsStruct;
+    }
+});
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../../src/api/v2/create-account/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2DAAyD;AAGzD,uCAKiB;AACjB,yCAA4D;AAC5D,mDAAqE;AAErE,8CAAwB;AACxB,+CAAyB;AACzB,oDAA8B;AAE9B;;GAEG;AACH,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,mCAAnB,mBAAmB,QA6C9B;AAED;;GAEG;AACU,QAAA,0BAA0B,GAAG,IAAA,8BAAc,EAAC,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,iDAAyC,CAAC;QACnD,KAAK,mBAAmB,CAAC,gBAAgB;YACvC,OAAO,kDAA0C,CAAC;QACpD,KAAK,mBAAmB,CAAC,qBAAqB;YAC5C,OAAO,uDAA+C,CAAC;QACzD,KAAK,mBAAmB,CAAC,aAAa;YACpC,OAAO,+CAAuC,CAAC;QACjD,KAAK,mBAAmB,CAAC,gBAAgB;YACvC,OAAO,kDAAoC,CAAC;QAC9C,KAAK,mBAAmB,CAAC,MAAM;YAC7B,OAAO,yCAAgC,CAAC;QAC1C;YACE,wGAAwG;YACxG,OAAO,iDAAyC,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  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"]}

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

@@ -0,0 +1,83 @@
+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.
+ */
+export declare enum AccountCreationType {
+    /**
+     * Represents an account created using a BIP-44 derivation path.
+     */
+    Bip44DerivePath = "bip44:derive-path",
+    /**
+     * Represents accounts created using a BIP-44 account index.
+     *
+     * More than one account can be created, for example, the keyring can create
+     * multiple account types (e.g., P2PKH, P2TR, P2WPKH) for the same account
+     * 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.
+     *
+     * More than one account can be created, for example, the keyring can create
+     * multiple account types (e.g., P2PKH, P2TR, P2WPKH) for the same account
+     * index.
+     */
+    Bip44Discover = "bip44:discover",
+    /**
+     * Represents an account imported from a private key.
+     */
+    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}.
+ */
+export declare const CreateAccountOptionsStruct: import("@metamask/superstruct").Struct<{
+    type: "bip44:derive-path";
+    derivationPath: `m/${string}`;
+    entropySource: string;
+} | {
+    type: "bip44:derive-index";
+    groupIndex: number;
+    entropySource: string;
+} | {
+    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";
+    privateKey: string;
+    accountType?: "eip155:eoa" | "eip155:erc4337" | "bip122:p2pkh" | "bip122:p2sh" | "bip122:p2wpkh" | "bip122:p2tr" | "solana:data-account" | "tron:eoa" | "any:account";
+}, null>;
+/**
+ * Represents the available options for creating a new account.
+ */
+export type CreateAccountOptions = Infer<typeof CreateAccountOptionsStruct>;
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +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;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"}

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

@@ -0,0 +1,83 @@
+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.
+ */
+export declare enum AccountCreationType {
+    /**
+     * Represents an account created using a BIP-44 derivation path.
+     */
+    Bip44DerivePath = "bip44:derive-path",
+    /**
+     * Represents accounts created using a BIP-44 account index.
+     *
+     * More than one account can be created, for example, the keyring can create
+     * multiple account types (e.g., P2PKH, P2TR, P2WPKH) for the same account
+     * 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.
+     *
+     * More than one account can be created, for example, the keyring can create
+     * multiple account types (e.g., P2PKH, P2TR, P2WPKH) for the same account
+     * index.
+     */
+    Bip44Discover = "bip44:discover",
+    /**
+     * Represents an account imported from a private key.
+     */
+    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}.
+ */
+export declare const CreateAccountOptionsStruct: import("@metamask/superstruct").Struct<{
+    type: "bip44:derive-path";
+    derivationPath: `m/${string}`;
+    entropySource: string;
+} | {
+    type: "bip44:derive-index";
+    groupIndex: number;
+    entropySource: string;
+} | {
+    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";
+    privateKey: string;
+    accountType?: "eip155:eoa" | "eip155:erc4337" | "bip122:p2pkh" | "bip122:p2sh" | "bip122:p2wpkh" | "bip122:p2tr" | "solana:data-account" | "tron:eoa" | "any:account";
+}, null>;
+/**
+ * Represents the available options for creating a new account.
+ */
+export type CreateAccountOptions = Infer<typeof CreateAccountOptionsStruct>;
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +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;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"}