feat: add KeyringVersion + KeyringCapabilites.versions

packages/keyring-api/CHANGELOG.md

@@ -16,6 +16,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Add `EthKeyringWrapper` abstract class for Ethereum-based `KeyringV2` implementations ([#404](https://github.com/MetaMask/accounts/pull/404))
   - Provides common Ethereum signing method routing (`submitRequest`) for all Ethereum-based keyrings.
 - Add `KeyringWrapper` base class to adapt legacy keyrings to `KeyringV2` ([#398](https://github.com/MetaMask/accounts/pull/398)), ([#410](https://github.com/MetaMask/accounts/pull/410))
+- Add `KeyringVersion` enum and required `versions` field to `KeyringCapabilities` ([#439](https://github.com/MetaMask/accounts/pull/439))
+  - `KeyringVersion` enum represents keyring API versions: `V1 = 1`, `V2 = 2`.
+  - Keyrings must now declare which API versions they support via the `versions` field.
+  - The `versions` field is a non-empty array of `KeyringVersion` values.
 
 ### Changed
 

packages/keyring-api/src/api/v2/keyring-capabilities.ts

@@ -1,6 +1,7 @@
 import {
   array,
   boolean,
+  enums,
   exactOptional,
   nonempty,
   object,
@@ -14,10 +15,31 @@ import {
 } from './private-key';
 import { CaipChainIdStruct } from '../caip';
 
+/**
+ * Enum representing keyring API versions.
+ */
+export enum KeyringVersion {
+  /**
+   * Initial Keyring API.
+   */
+  V1 = 1,
+
+  /**
+   * Unified keyring API introducing the new capabilities system.
+   *
+   * Requires Snap platform: TBD (TODO)
+   */
+  V2 = 2,
+}
+
 /**
  * Struct for {@link KeyringCapabilities}.
  */
 export const KeyringCapabilitiesStruct = object({
+  /**
+   * List of keyring API versions that this keyring supports.
+   */
+  versions: nonempty(array(enums([KeyringVersion.V1, KeyringVersion.V2]))),
   /**
    * List of CAIP-2 chain IDs that this keyring supports.
    */
@@ -78,6 +100,7 @@ export const KeyringCapabilitiesStruct = object({
  * @example
  * ```ts
  * const capabilities: KeyringCapabilities = {
+ *   versions: [KeyringVersion.V2],
  *   scopes: ['bip122:_'],
  *   bip44: {
  *     derivePath: true,

packages/keyring-api/src/api/v2/wrapper/keyring-wrapper.test.ts

@@ -5,6 +5,7 @@ import { v4 as uuidv4 } from 'uuid';
 import { KeyringWrapper } from './keyring-wrapper';
 import type { KeyringAccount } from '../../account';
 import type { KeyringCapabilities } from '../keyring-capabilities';
+import { KeyringVersion } from '../keyring-capabilities';
 import { KeyringType } from '../keyring-type';
 
 class TestKeyringWrapper extends KeyringWrapper<TestKeyring> {
@@ -127,6 +128,7 @@ class TestKeyring implements Keyring {
 }
 
 const capabilities: KeyringCapabilities = {
+  versions: [KeyringVersion.V2],
   scopes: ['eip155:10'],
 };
 

packages/keyring-eth-hd/src/hd-keyring-v2.ts

@@ -13,6 +13,7 @@ import {
   type KeyringCapabilities,
   type KeyringV2,
   KeyringType,
+  KeyringVersion,
   PrivateKeyEncoding,
   type EntropySourceId,
 } from '@metamask/keyring-api';
@@ -39,6 +40,7 @@ const HD_KEYRING_METHODS = [
 ];
 
 const hdKeyringV2Capabilities: KeyringCapabilities = {
+  versions: [KeyringVersion.V2],
   scopes: [EthScope.Eoa],
   bip44: {
     deriveIndex: true,

packages/keyring-eth-ledger-bridge/src/ledger-keyring-v2.ts

@@ -10,6 +10,7 @@ import {
   type KeyringCapabilities,
   type KeyringV2,
   KeyringType,
+  KeyringVersion,
   type EntropySourceId,
 } from '@metamask/keyring-api';
 import type { AccountId, EthKeyring } from '@metamask/keyring-utils';
@@ -28,6 +29,7 @@ const LEDGER_KEYRING_METHODS = [
 ];
 
 const ledgerKeyringV2Capabilities: KeyringCapabilities = {
+  versions: [KeyringVersion.V2],
   scopes: [EthScope.Eoa],
   bip44: {
     deriveIndex: true,

packages/keyring-eth-simple/src/simple-keyring-v2.ts

@@ -12,6 +12,7 @@ import {
   type KeyringCapabilities,
   type KeyringV2,
   KeyringType,
+  KeyringVersion,
   PrivateKeyEncoding,
 } from '@metamask/keyring-api';
 import type { AccountId } from '@metamask/keyring-utils';
@@ -38,6 +39,7 @@ const SIMPLE_KEYRING_METHODS = [
 ];
 
 const simpleKeyringV2Capabilities: KeyringCapabilities = {
+  versions: [KeyringVersion.V2],
   scopes: [EthScope.Eoa],
   privateKey: {
     importFormats: [

packages/keyring-eth-trezor/src/trezor-keyring-v2.ts

@@ -10,6 +10,7 @@ import {
   type KeyringCapabilities,
   type KeyringV2,
   KeyringType,
+  KeyringVersion,
   type EntropySourceId,
 } from '@metamask/keyring-api';
 import type { AccountId, EthKeyring } from '@metamask/keyring-utils';
@@ -29,6 +30,7 @@ const TREZOR_KEYRING_METHODS = [
 ];
 
 const trezorKeyringV2Capabilities: KeyringCapabilities = {
+  versions: [KeyringVersion.V2],
   scopes: [EthScope.Eoa],
   bip44: {
     deriveIndex: true,