Add spec links.

Signed-off-by: Dmitri Zagidulin <[email protected]>

Author: dmitrizagidulin

src/DID.ts

@@ -1,7 +1,8 @@
 /*!
  * Copyright (c) 2025 Digital Credentials Consortium. All rights reserved.
  */
-import { ILdType } from './LD';
+import { ILdType } from './LD'
+import { IPublicKey } from './KeyPair'
 
 /**
  * A Decentralized Identifier (DID) URL
@@ -11,8 +12,10 @@ export type IDID = `did:${string}`
 
 export type IDidDocument = IDidDocument_v1_0 | IDidDocument_v1_1
 
-export type IKeyIdOrObject = string | object
+export type KeyId = string
+export type IKeyIdOrObject = KeyId | IPublicKey
 
+// @see https://www.w3.org/TR/cid-1.0/#services
 export interface IServiceObject {
   id?: string // a URL
   type: ILdType

src/KeyPair.ts

@@ -2,10 +2,10 @@
  * Copyright (c) 2025 Digital Credentials Consortium.
  */
 export type IKeyPair = IVerificationKeyPair2018 | IVerificationKeyPair2020 |
-  IMultikeyPair | IJsonWebKeyPair2020
+  IMultikeyPair | IJsonWebKeyPair2020 | IJsonWebKeyPair
 
 export type IPublicKey = IPublicKey2018 | IPublicKey2020 | IPublicMultikey
-  | IJsonWebPublicKey2020
+  | IJsonWebPublicKey
 
 export interface IKeyPairCore {
   '@context'?: string
@@ -33,27 +33,38 @@ export interface IVerificationKeyPair2020 extends IPublicKey2020 {
   privateKeyMultibase?: string
 }
 
+/**
+ * @see https://www.w3.org/TR/cid-1.0/#Multikey
+ */
 export interface IPublicMultikey extends IKeyPairCore {
   publicKeyMultibase?: string
 }
 export interface IMultikeyPair extends IPublicMultikey {
   secretKeyMultibase?: string
 }
 
-export interface IJsonWebPublicKey2020 {
+export interface IJsonWebPublicKey {
   // Used by JsonWebKey2020
   publicKeyJwk?: IJsonWebKey
 }
-export interface IJsonWebKeyPair2020 extends IJsonWebPublicKey2020 {
+export interface IJsonWebKeyPair2020 extends IJsonWebPublicKey {
   privateKeyJwk?: IJsonWebKey
 }
+// @see https://www.w3.org/TR/cid-1.0/#JsonWebKey
+export interface IJsonWebKeyPair extends IJsonWebPublicKey {
+  secretKeyJwk?: IJsonWebKey
+}
+
 export interface IJsonWebKey {
   // Key type, e.g. 'RSA' or 'OKP'
   kty?: string
 
   // Curve, used by elliptic cryptography keys (kty: 'OKP'), e.g. 'Ed25519'
   crv?: string
 
+  // Algorithm, e.g. 'ES384'
+  alg?: string
+
   // Public key, typically base64url encoded
   x?: string