@metamask/keyring-api 21.2.0 → 21.4.0

package/dist/api/v2/index.cjs

@@ -0,0 +1,23 @@
+"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 });
+__exportStar(require("./keyring-capabilities.cjs"), exports);
+__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

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

@@ -0,0 +1,8 @@
+export type * from "./keyring.cjs";
+export * from "./keyring-capabilities.cjs";
+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

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

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

@@ -0,0 +1,8 @@
+export type * from "./keyring.mjs";
+export * from "./keyring-capabilities.mjs";
+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

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

package/dist/api/v2/index.mjs

@@ -0,0 +1,7 @@
+export * from "./keyring-capabilities.mjs";
+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

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

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyringCapabilitiesStruct = void 0;
+const superstruct_1 = require("@metamask/superstruct");
+const private_key_1 = require("./private-key.cjs");
+const caip_1 = require("../caip.cjs");
+/**
+ * Struct for {@link KeyringCapabilities}.
+ */
+exports.KeyringCapabilitiesStruct = (0, superstruct_1.object)({
+    /**
+     * List of CAIP-2 chain IDs that this keyring supports.
+     */
+    scopes: (0, superstruct_1.nonempty)((0, superstruct_1.array)(caip_1.CaipChainIdStruct)),
+    /**
+     * BIP-44 capabilities supported by this keyring.
+     */
+    bip44: (0, superstruct_1.exactOptional)((0, superstruct_1.object)({
+        /**
+         * Whether the keyring supports deriving accounts from a specific BIP-44 path.
+         */
+        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.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.exactOptional)((0, superstruct_1.boolean)()),
+    })),
+    /**
+     * Private key capabilities supported by this keyring.
+     */
+    privateKey: (0, superstruct_1.exactOptional)((0, superstruct_1.object)({
+        /**
+         * List of supported formats for importing private keys.
+         */
+        importFormats: (0, superstruct_1.exactOptional)((0, superstruct_1.array)(private_key_1.ImportPrivateKeyFormatStruct)),
+        /**
+         * List of supported formats for exporting private keys.
+         */
+        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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,150 @@
+import { type Infer } from "@metamask/superstruct";
+/**
+ * Struct for {@link KeyringCapabilities}.
+ */
+export declare const KeyringCapabilitiesStruct: import("@metamask/superstruct").Struct<{
+    scopes: `${string}:${string}`[];
+    custom?: {
+        createAccounts?: boolean | undefined;
+    };
+    bip44?: {
+        derivePath?: boolean;
+        deriveIndex?: boolean;
+        deriveIndexRange?: boolean;
+        discover?: boolean;
+    };
+    privateKey?: {
+        importFormats?: {
+            encoding: "hexadecimal" | "base58";
+            type?: "eip155:eoa" | "eip155:erc4337" | "bip122:p2pkh" | "bip122:p2sh" | "bip122:p2wpkh" | "bip122:p2tr" | "solana:data-account" | "tron:eoa" | "any:account";
+        }[];
+        exportFormats?: {
+            encoding: "hexadecimal" | "base58";
+        }[];
+    };
+}, {
+    /**
+     * List of CAIP-2 chain IDs that this keyring supports.
+     */
+    scopes: import("@metamask/superstruct").Struct<`${string}:${string}`[], import("@metamask/superstruct").Struct<`${string}:${string}`, null>>;
+    /**
+     * BIP-44 capabilities supported by this keyring.
+     */
+    bip44: import("@metamask/superstruct").ExactOptionalStruct<{
+        derivePath?: boolean;
+        deriveIndex?: boolean;
+        deriveIndexRange?: boolean;
+        discover?: boolean;
+    }, {
+        /**
+         * Whether the keyring supports deriving accounts from a specific BIP-44 path.
+         */
+        derivePath: import("@metamask/superstruct").ExactOptionalStruct<boolean, null>;
+        /**
+         * Whether the keyring supports deriving accounts from a BIP-44 account index.
+         */
+        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").ExactOptionalStruct<boolean, null>;
+    }>;
+    /**
+     * Private key capabilities supported by this keyring.
+     */
+    privateKey: import("@metamask/superstruct").ExactOptionalStruct<{
+        importFormats?: {
+            encoding: "hexadecimal" | "base58";
+            type?: "eip155:eoa" | "eip155:erc4337" | "bip122:p2pkh" | "bip122:p2sh" | "bip122:p2wpkh" | "bip122:p2tr" | "solana:data-account" | "tron:eoa" | "any:account";
+        }[];
+        exportFormats?: {
+            encoding: "hexadecimal" | "base58";
+        }[];
+    }, {
+        /**
+         * List of supported formats for importing private keys.
+         */
+        importFormats: import("@metamask/superstruct").ExactOptionalStruct<{
+            encoding: "hexadecimal" | "base58";
+            type?: "eip155:eoa" | "eip155:erc4337" | "bip122:p2pkh" | "bip122:p2sh" | "bip122:p2wpkh" | "bip122:p2tr" | "solana:data-account" | "tron:eoa" | "any:account";
+        }[], import("@metamask/superstruct").Struct<{
+            encoding: "hexadecimal" | "base58";
+            type?: "eip155:eoa" | "eip155:erc4337" | "bip122:p2pkh" | "bip122:p2sh" | "bip122:p2wpkh" | "bip122:p2tr" | "solana:data-account" | "tron:eoa" | "any:account";
+        }, {
+            encoding: import("@metamask/superstruct").Struct<"hexadecimal" | "base58", {
+                hexadecimal: "hexadecimal";
+                base58: "base58";
+            }>;
+            type: import("@metamask/superstruct").ExactOptionalStruct<"eip155:eoa" | "eip155:erc4337" | "bip122:p2pkh" | "bip122:p2sh" | "bip122:p2wpkh" | "bip122:p2tr" | "solana:data-account" | "tron:eoa" | "any:account", {
+                "eip155:eoa": "eip155:eoa";
+                "eip155:erc4337": "eip155:erc4337";
+                "bip122:p2pkh": "bip122:p2pkh";
+                "bip122:p2sh": "bip122:p2sh";
+                "bip122:p2wpkh": "bip122:p2wpkh";
+                "bip122:p2tr": "bip122:p2tr";
+                "solana:data-account": "solana:data-account";
+                "tron:eoa": "tron:eoa";
+                "any:account": "any:account";
+            }>;
+        }>>;
+        /**
+         * List of supported formats for exporting private keys.
+         */
+        exportFormats: import("@metamask/superstruct").ExactOptionalStruct<{
+            encoding: "hexadecimal" | "base58";
+        }[], import("@metamask/superstruct").Struct<{
+            encoding: "hexadecimal" | "base58";
+        }, {
+            encoding: import("@metamask/superstruct").Struct<"hexadecimal" | "base58", {
+                hexadecimal: "hexadecimal";
+                base58: "base58";
+            }>;
+        }>>;
+    }>;
+    /**
+     * 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.
+ *
+ * @example
+ * ```ts
+ * const capabilities: KeyringCapabilities = {
+ *   scopes: ['bip122:_'],
+ *   bip44: {
+ *     derivePath: true,
+ *     deriveIndex: true,
+ *     deriveIndexRange: true,
+ *     discover: true,
+ *   },
+ *   privateKey: {
+ *     importFormats: [
+ *       { encoding: 'base58', type: 'bip122:p2sh' },
+ *       { encoding: 'base58', type: 'bip122:p2tr' },
+ *       { encoding: 'base58', type: 'bip122:p2pkh' },
+ *       { encoding: 'base58', type: 'bip122:p2wpkh' },
+ *     ],
+ *     exportFormats: [
+ *       { encoding: 'base58' },
+ *       { encoding: 'base58' },
+ *     ],
+ *   },
+ * };
+ * ```
+ */
+export type KeyringCapabilities = Infer<typeof KeyringCapabilitiesStruct>;
+//# sourceMappingURL=keyring-capabilities.d.cts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,150 @@
+import { type Infer } from "@metamask/superstruct";
+/**
+ * Struct for {@link KeyringCapabilities}.
+ */
+export declare const KeyringCapabilitiesStruct: import("@metamask/superstruct").Struct<{
+    scopes: `${string}:${string}`[];
+    custom?: {
+        createAccounts?: boolean | undefined;
+    };
+    bip44?: {
+        derivePath?: boolean;
+        deriveIndex?: boolean;
+        deriveIndexRange?: boolean;
+        discover?: boolean;
+    };
+    privateKey?: {
+        importFormats?: {
+            encoding: "hexadecimal" | "base58";
+            type?: "eip155:eoa" | "eip155:erc4337" | "bip122:p2pkh" | "bip122:p2sh" | "bip122:p2wpkh" | "bip122:p2tr" | "solana:data-account" | "tron:eoa" | "any:account";
+        }[];
+        exportFormats?: {
+            encoding: "hexadecimal" | "base58";
+        }[];
+    };
+}, {
+    /**
+     * List of CAIP-2 chain IDs that this keyring supports.
+     */
+    scopes: import("@metamask/superstruct").Struct<`${string}:${string}`[], import("@metamask/superstruct").Struct<`${string}:${string}`, null>>;
+    /**
+     * BIP-44 capabilities supported by this keyring.
+     */
+    bip44: import("@metamask/superstruct").ExactOptionalStruct<{
+        derivePath?: boolean;
+        deriveIndex?: boolean;
+        deriveIndexRange?: boolean;
+        discover?: boolean;
+    }, {
+        /**
+         * Whether the keyring supports deriving accounts from a specific BIP-44 path.
+         */
+        derivePath: import("@metamask/superstruct").ExactOptionalStruct<boolean, null>;
+        /**
+         * Whether the keyring supports deriving accounts from a BIP-44 account index.
+         */
+        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").ExactOptionalStruct<boolean, null>;
+    }>;
+    /**
+     * Private key capabilities supported by this keyring.
+     */
+    privateKey: import("@metamask/superstruct").ExactOptionalStruct<{
+        importFormats?: {
+            encoding: "hexadecimal" | "base58";
+            type?: "eip155:eoa" | "eip155:erc4337" | "bip122:p2pkh" | "bip122:p2sh" | "bip122:p2wpkh" | "bip122:p2tr" | "solana:data-account" | "tron:eoa" | "any:account";
+        }[];
+        exportFormats?: {
+            encoding: "hexadecimal" | "base58";
+        }[];
+    }, {
+        /**
+         * List of supported formats for importing private keys.
+         */
+        importFormats: import("@metamask/superstruct").ExactOptionalStruct<{
+            encoding: "hexadecimal" | "base58";
+            type?: "eip155:eoa" | "eip155:erc4337" | "bip122:p2pkh" | "bip122:p2sh" | "bip122:p2wpkh" | "bip122:p2tr" | "solana:data-account" | "tron:eoa" | "any:account";
+        }[], import("@metamask/superstruct").Struct<{
+            encoding: "hexadecimal" | "base58";
+            type?: "eip155:eoa" | "eip155:erc4337" | "bip122:p2pkh" | "bip122:p2sh" | "bip122:p2wpkh" | "bip122:p2tr" | "solana:data-account" | "tron:eoa" | "any:account";
+        }, {
+            encoding: import("@metamask/superstruct").Struct<"hexadecimal" | "base58", {
+                hexadecimal: "hexadecimal";
+                base58: "base58";
+            }>;
+            type: import("@metamask/superstruct").ExactOptionalStruct<"eip155:eoa" | "eip155:erc4337" | "bip122:p2pkh" | "bip122:p2sh" | "bip122:p2wpkh" | "bip122:p2tr" | "solana:data-account" | "tron:eoa" | "any:account", {
+                "eip155:eoa": "eip155:eoa";
+                "eip155:erc4337": "eip155:erc4337";
+                "bip122:p2pkh": "bip122:p2pkh";
+                "bip122:p2sh": "bip122:p2sh";
+                "bip122:p2wpkh": "bip122:p2wpkh";
+                "bip122:p2tr": "bip122:p2tr";
+                "solana:data-account": "solana:data-account";
+                "tron:eoa": "tron:eoa";
+                "any:account": "any:account";
+            }>;
+        }>>;
+        /**
+         * List of supported formats for exporting private keys.
+         */
+        exportFormats: import("@metamask/superstruct").ExactOptionalStruct<{
+            encoding: "hexadecimal" | "base58";
+        }[], import("@metamask/superstruct").Struct<{
+            encoding: "hexadecimal" | "base58";
+        }, {
+            encoding: import("@metamask/superstruct").Struct<"hexadecimal" | "base58", {
+                hexadecimal: "hexadecimal";
+                base58: "base58";
+            }>;
+        }>>;
+    }>;
+    /**
+     * 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.
+ *
+ * @example
+ * ```ts
+ * const capabilities: KeyringCapabilities = {
+ *   scopes: ['bip122:_'],
+ *   bip44: {
+ *     derivePath: true,
+ *     deriveIndex: true,
+ *     deriveIndexRange: true,
+ *     discover: true,
+ *   },
+ *   privateKey: {
+ *     importFormats: [
+ *       { encoding: 'base58', type: 'bip122:p2sh' },
+ *       { encoding: 'base58', type: 'bip122:p2tr' },
+ *       { encoding: 'base58', type: 'bip122:p2pkh' },
+ *       { encoding: 'base58', type: 'bip122:p2wpkh' },
+ *     ],
+ *     exportFormats: [
+ *       { encoding: 'base58' },
+ *       { encoding: 'base58' },
+ *     ],
+ *   },
+ * };
+ * ```
+ */
+export type KeyringCapabilities = Infer<typeof KeyringCapabilitiesStruct>;
+//# sourceMappingURL=keyring-capabilities.d.mts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,57 @@
+import { array, boolean, exactOptional, nonempty, object, partial } from "@metamask/superstruct";
+import { ExportPrivateKeyFormatStruct, ImportPrivateKeyFormatStruct } from "./private-key.mjs";
+import { CaipChainIdStruct } from "../caip.mjs";
+/**
+ * Struct for {@link KeyringCapabilities}.
+ */
+export const KeyringCapabilitiesStruct = object({
+    /**
+     * List of CAIP-2 chain IDs that this keyring supports.
+     */
+    scopes: nonempty(array(CaipChainIdStruct)),
+    /**
+     * BIP-44 capabilities supported by this keyring.
+     */
+    bip44: exactOptional(object({
+        /**
+         * Whether the keyring supports deriving accounts from a specific BIP-44 path.
+         */
+        derivePath: exactOptional(boolean()),
+        /**
+         * Whether the keyring supports deriving accounts from a BIP-44 account index.
+         */
+        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: exactOptional(boolean()),
+    })),
+    /**
+     * Private key capabilities supported by this keyring.
+     */
+    privateKey: exactOptional(object({
+        /**
+         * List of supported formats for importing private keys.
+         */
+        importFormats: exactOptional(array(ImportPrivateKeyFormatStruct)),
+        /**
+         * List of supported formats for exporting private keys.
+         */
+        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

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyring-capabilities.mjs","sourceRoot":"","sources":["../../../src/api/v2/keyring-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,OAAO,EACP,aAAa,EACb,QAAQ,EACR,MAAM,EACN,OAAO,EAER,8BAA8B;AAE/B,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC7B,0BAAsB;AACvB,OAAO,EAAE,iBAAiB,EAAE,oBAAgB;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;IAC9C;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC1C;;OAEG;IACH,KAAK,EAAE,aAAa,CAClB,MAAM,CAAC;QACL;;WAEG;QACH,UAAU,EAAE,aAAa,CAAC,OAAO,EAAE,CAAC;QACpC;;WAEG;QACH,WAAW,EAAE,aAAa,CAAC,OAAO,EAAE,CAAC;QACrC;;WAEG;QACH,gBAAgB,EAAE,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1C;;WAEG;QACH,QAAQ,EAAE,aAAa,CAAC,OAAO,EAAE,CAAC;KACnC,CAAC,CACH;IACD;;OAEG;IACH,UAAU,EAAE,aAAa,CACvB,MAAM,CAAC;QACL;;WAEG;QACH,aAAa,EAAE,aAAa,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACjE;;WAEG;QACH,aAAa,EAAE,aAAa,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;KAClE,CAAC,CACH;IACD;;;;;;OAMG;IACH,MAAM,EAAE,aAAa,CACnB,OAAO,CACL,MAAM,CAAC;QACL,cAAc,EAAE,OAAO,EAAE;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-type.cjs

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyringType = void 0;
+/**
+ * Enum representing the different types of keyrings supported.
+ */
+var KeyringType;
+(function (KeyringType) {
+    /**
+     * Represents a hierarchical deterministic (HD) keyring.
+     */
+    KeyringType["Hd"] = "hd";
+    /**
+     * Represents a keyring that directly stores private keys.
+     */
+    KeyringType["PrivateKey"] = "private-key";
+    /**
+     * Represents a keyring that implements the QR protocol.
+     *
+     * See: https://eips.ethereum.org/EIPS/eip-4527
+     */
+    KeyringType["Qr"] = "qr";
+    /**
+     * Represents keyring backed by a Snap.
+     */
+    KeyringType["Snap"] = "snap";
+    /**
+     * Represents keyring backed by a Ledger hardware wallet.
+     */
+    KeyringType["Ledger"] = "ledger";
+    /**
+     * Represents keyring backed by a Lattice hardware wallet.
+     */
+    KeyringType["Lattice"] = "lattice";
+    /**
+     * Represents keyring backed by a Trezor hardware wallet.
+     */
+    KeyringType["Trezor"] = "trezor";
+    /**
+     * Represents keyring backed by a OneKey hardware wallet.
+     */
+    KeyringType["OneKey"] = "onekey";
+})(KeyringType || (exports.KeyringType = KeyringType = {}));
+//# sourceMappingURL=keyring-type.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyring-type.cjs","sourceRoot":"","sources":["../../../src/api/v2/keyring-type.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,WA0CX;AA1CD,WAAY,WAAW;IACrB;;OAEG;IACH,wBAAS,CAAA;IAET;;OAEG;IACH,yCAA0B,CAAA;IAE1B;;;;OAIG;IACH,wBAAS,CAAA;IAET;;OAEG;IACH,4BAAa,CAAA;IAEb;;OAEG;IACH,gCAAiB,CAAA;IAEjB;;OAEG;IACH,kCAAmB,CAAA;IAEnB;;OAEG;IACH,gCAAiB,CAAA;IAEjB;;OAEG;IACH,gCAAiB,CAAA;AACnB,CAAC,EA1CW,WAAW,2BAAX,WAAW,QA0CtB","sourcesContent":["/**\n * Enum representing the different types of keyrings supported.\n */\nexport enum KeyringType {\n  /**\n   * Represents a hierarchical deterministic (HD) keyring.\n   */\n  Hd = 'hd',\n\n  /**\n   * Represents a keyring that directly stores private keys.\n   */\n  PrivateKey = 'private-key',\n\n  /**\n   * Represents a keyring that implements the QR protocol.\n   *\n   * See: https://eips.ethereum.org/EIPS/eip-4527\n   */\n  Qr = 'qr',\n\n  /**\n   * Represents keyring backed by a Snap.\n   */\n  Snap = 'snap',\n\n  /**\n   * Represents keyring backed by a Ledger hardware wallet.\n   */\n  Ledger = 'ledger',\n\n  /**\n   * Represents keyring backed by a Lattice hardware wallet.\n   */\n  Lattice = 'lattice',\n\n  /**\n   * Represents keyring backed by a Trezor hardware wallet.\n   */\n  Trezor = 'trezor',\n\n  /**\n   * Represents keyring backed by a OneKey hardware wallet.\n   */\n  OneKey = 'onekey',\n}\n"]}

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

@@ -0,0 +1,40 @@
+/**
+ * Enum representing the different types of keyrings supported.
+ */
+export declare enum KeyringType {
+    /**
+     * Represents a hierarchical deterministic (HD) keyring.
+     */
+    Hd = "hd",
+    /**
+     * Represents a keyring that directly stores private keys.
+     */
+    PrivateKey = "private-key",
+    /**
+     * Represents a keyring that implements the QR protocol.
+     *
+     * See: https://eips.ethereum.org/EIPS/eip-4527
+     */
+    Qr = "qr",
+    /**
+     * Represents keyring backed by a Snap.
+     */
+    Snap = "snap",
+    /**
+     * Represents keyring backed by a Ledger hardware wallet.
+     */
+    Ledger = "ledger",
+    /**
+     * Represents keyring backed by a Lattice hardware wallet.
+     */
+    Lattice = "lattice",
+    /**
+     * Represents keyring backed by a Trezor hardware wallet.
+     */
+    Trezor = "trezor",
+    /**
+     * Represents keyring backed by a OneKey hardware wallet.
+     */
+    OneKey = "onekey"
+}
+//# sourceMappingURL=keyring-type.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyring-type.d.cts","sourceRoot":"","sources":["../../../src/api/v2/keyring-type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,WAAW;IACrB;;OAEG;IACH,EAAE,OAAO;IAET;;OAEG;IACH,UAAU,gBAAgB;IAE1B;;;;OAIG;IACH,EAAE,OAAO;IAET;;OAEG;IACH,IAAI,SAAS;IAEb;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,OAAO,YAAY;IAEnB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,MAAM,WAAW;CAClB"}

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

@@ -0,0 +1,40 @@
+/**
+ * Enum representing the different types of keyrings supported.
+ */
+export declare enum KeyringType {
+    /**
+     * Represents a hierarchical deterministic (HD) keyring.
+     */
+    Hd = "hd",
+    /**
+     * Represents a keyring that directly stores private keys.
+     */
+    PrivateKey = "private-key",
+    /**
+     * Represents a keyring that implements the QR protocol.
+     *
+     * See: https://eips.ethereum.org/EIPS/eip-4527
+     */
+    Qr = "qr",
+    /**
+     * Represents keyring backed by a Snap.
+     */
+    Snap = "snap",
+    /**
+     * Represents keyring backed by a Ledger hardware wallet.
+     */
+    Ledger = "ledger",
+    /**
+     * Represents keyring backed by a Lattice hardware wallet.
+     */
+    Lattice = "lattice",
+    /**
+     * Represents keyring backed by a Trezor hardware wallet.
+     */
+    Trezor = "trezor",
+    /**
+     * Represents keyring backed by a OneKey hardware wallet.
+     */
+    OneKey = "onekey"
+}
+//# sourceMappingURL=keyring-type.d.mts.map