@interop/wallet-core 0.16.0 → 0.18.0

package/dist/keys/{pukRoster.js → userKeyRoster.js}

@@ -1,14 +1,17 @@
-import { addRecipient, initRecipients, ownerRecipient, removeRecipient, unwrapEpochSecret, verifyEpochsMac } from '@interop/was-client/edv';
+import { addRecipient, epochsSigPayload, initRecipients, ownerRecipient, removeRecipient, unwrapEpochSecret, verifyEpochsMac } from '@interop/was-client/edv';
+import { Ed25519VerificationKey } from '@interop/ed25519-verification-key';
+import { base64urlnopad } from '@scure/base';
+import { clientSigningKeyMultibase } from '../webvh/zcap.js';
 /**
  * Thrown when a served roster fails its client-side authentication: a
  * missing/unsupported/invalid `epochsMac`, or a descriptor whose `currentEpoch`
  * names no epoch in its own list. The server (or whoever can write to it) has
  * produced a configuration no enrolled client authenticated.
  */
-export class PukRosterIntegrityError extends Error {
+export class UserKeyRosterIntegrityError extends Error {
     constructor(message) {
         super(message);
-        this.name = 'PukRosterIntegrityError';
+        this.name = 'UserKeyRosterIntegrityError';
     }
 }
 /**
@@ -18,25 +21,105 @@ export class PukRosterIntegrityError extends Error {
  * an older consistent configuration, which a valid `epochsMac` alone cannot
  * catch; refused rather than followed.
  */
-export class PukRosterContinuityError extends Error {
+export class UserKeyRosterContinuityError extends Error {
     pinnedEpochId;
     constructor({ pinnedEpochId }) {
-        super('The PUK roster no longer carries the epoch this client has pinned -- ' +
+        super('The user key roster no longer carries the epoch this client has pinned -- ' +
             'a rolled-back or replayed roster.');
-        this.name = 'PukRosterContinuityError';
+        this.name = 'UserKeyRosterContinuityError';
         this.pinnedEpochId = pinnedEpochId;
     }
 }
 /**
  * Thrown when this client holds no usable wrap in the roster's current epoch
  * (no recipient entry for its key-agreement key, or the entry fails to
- * unwrap). The client cannot obtain the current PUK -- it may have been
+ * unwrap). The client cannot obtain the current user key -- it may have been
  * rotated off the roster.
  */
-export class PukRosterUnwrapError extends Error {
+export class UserKeyRosterUnwrapError extends Error {
     constructor(message) {
         super(message);
-        this.name = 'PukRosterUnwrapError';
+        this.name = 'UserKeyRosterUnwrapError';
+    }
+}
+/**
+ * The `epochsSig` construction this module mints and accepts: version 1,
+ * Ed25519 (`EdDSA`), `kid` the signer's public-key multibase (`z6Mk...`) --
+ * the same string that names the client's verification method in the
+ * did:webvh document.
+ */
+const EPOCHS_SIG_V = 1;
+const EPOCHS_SIG_ALG = 'EdDSA';
+/**
+ * The roster's epoch-configuration signer: signs each roster write's epoch
+ * configuration with this client's own Ed25519 signing key, under a `kid`
+ * that is the key's public multibase -- exactly the string enrolled as this
+ * client's verification method in the did:webvh document, so a reader
+ * resolves the signature against the document rather than anything the
+ * roster (or the server) supplies.
+ *
+ * @param options {object}
+ * @param options.keyAgent {ICapabilityAgent}   this client's signing key
+ *   agent (the `keyAgent` of `agentsFromSeed`)
+ * @returns {EpochsSigner}   the `signEpochs` hook for roster writes
+ */
+export function userKeyRosterEpochsSigner({ keyAgent }) {
+    const kid = clientSigningKeyMultibase({ keyAgent });
+    const signer = keyAgent.getSigner();
+    return async function signEpochs({ payload }) {
+        const signature = await signer.sign({ data: payload });
+        return {
+            v: EPOCHS_SIG_V,
+            alg: EPOCHS_SIG_ALG,
+            kid,
+            sig: base64urlnopad.encode(signature)
+        };
+    };
+}
+/**
+ * Verifies a served roster's `epochsSig` against the locally verified
+ * did:webvh document -- the root of trust the server cannot mint. The
+ * signature must be present and supported, its `kid` must be the public
+ * multibase of one of the document's verification methods (an enrolled
+ * client's signing key), and it must verify over the canonical
+ * epoch-configuration payload. Throws {@link UserKeyRosterIntegrityError}
+ * otherwise: a configuration no enrolled client signed.
+ *
+ * @param options {object}
+ * @param options.descriptor {CollectionEncryption}   the served roster
+ * @param options.document {RosterRecipientDocument}   the locally verified
+ *   did:webvh document (never a server-supplied roster field)
+ * @returns {Promise<void>}
+ */
+export async function verifyUserKeyRosterEpochsSig({ descriptor, document }) {
+    const epochsSig = descriptor.epochsSig;
+    if (!epochsSig ||
+        epochsSig.v !== EPOCHS_SIG_V ||
+        epochsSig.alg !== EPOCHS_SIG_ALG) {
+        throw new UserKeyRosterIntegrityError('The user key roster carries no supported epoch-configuration signature.');
+    }
+    const backed = (document.verificationMethod ?? []).some(method => method.publicKeyMultibase === epochsSig.kid);
+    if (!backed) {
+        throw new UserKeyRosterIntegrityError('The user key roster epoch configuration is signed by a key the account ' +
+            'document does not back.');
+    }
+    let signature;
+    try {
+        signature = base64urlnopad.decode(epochsSig.sig);
+    }
+    catch {
+        throw new UserKeyRosterIntegrityError('The user key roster epoch-configuration signature is malformed.');
+    }
+    const verifier = new Ed25519VerificationKey({
+        controller: `did:key:${epochsSig.kid}`,
+        publicKeyMultibase: epochsSig.kid
+    }).verifier();
+    const verified = await verifier.verify({
+        data: epochsSigPayload(descriptor),
+        signature
+    });
+    if (!verified) {
+        throw new UserKeyRosterIntegrityError('The user key roster epoch-configuration signature failed verification.');
     }
 }
 /**
@@ -84,7 +167,7 @@ function multibaseFragmentOf(id) {
  *   did:webvh document (never a server-supplied roster field)
  * @returns {function}   a `resolveRecipientKey` for `removeRecipient`
  */
-export function pukRosterRecipientResolver({ document }) {
+export function userKeyRosterRecipientResolver({ document }) {
     // Materialize the document's keyAgreement VMs once: embedded VMs verbatim,
     // string references resolved against `verificationMethod`.
     const byId = new Map();
@@ -116,22 +199,25 @@ export function pukRosterRecipientResolver({ document }) {
     };
 }
 /**
- * Ensures the roster exists, create-if-absent: an absent roster is
- * initialized with the account's existing PUK installed as the first epoch,
- * wrapped to this client's key-agreement key; an existing roster is returned
- * as-is (authentication is the read path's job, and provisioning must never
- * clobber an established roster). Idempotent -- losing the guarded-create
- * race to a concurrent first init converges on the winner's roster.
+ * Ensures the roster exists, create-if-absent: an absent roster is initialized
+ * with the account's existing user key installed as the first epoch, wrapped to
+ * this client's key-agreement key; an existing roster is returned as-is
+ * (authentication is the read path's job, and provisioning must never clobber
+ * an established roster). Idempotent -- losing the guarded-create race to a
+ * concurrent first init converges on the winner's roster.
  *
  * @param options {object}
  * @param options.store {EncryptionDescriptorStore}   the roster's descriptor
  *   store
- * @param options.puk {Puk}   the account's per-user key
+ * @param options.userKey {UserKey}   the account's user key
  * @param options.clientKeyAgreementKey {IKeyAgreementKey}   this client's own
  *   (identity) key-agreement key -- the roster recipient
+ * @param options.signEpochs {EpochsSigner}   this client's epoch-configuration
+ *   signer ({@link userKeyRosterEpochsSigner}), so the first configuration is
+ *   vouched for by an enrollable key rather than only its own MAC
  * @returns {Promise<CollectionEncryption>}   the roster descriptor
  */
-export async function ensurePukRoster({ store, puk, clientKeyAgreementKey }) {
+export async function ensureUserKeyRoster({ store, userKey, clientKeyAgreementKey, signEpochs }) {
     const current = await store.read();
     if (current !== null) {
         return current.descriptor;
@@ -139,11 +225,12 @@ export async function ensurePukRoster({ store, puk, clientKeyAgreementKey }) {
     return initRecipients({
         store,
         recipients: [ownerRecipient({ keyAgreementKey: clientKeyAgreementKey })],
-        epoch: { epochId: puk.id, secret: puk.secret }
+        epoch: { epochId: userKey.id, secret: userKey.secret },
+        signEpochs
     });
 }
 /**
- * Wraps the PUK to a client being enrolled -- the roster half of the
+ * Wraps the user key to a client being enrolled -- the roster half of the
  * enrollment ceremony, and deliberately its FIRST write (decryption material
  * before authorization, the push order): the wrap lands before the did:webvh
  * log entries, so no enrolled client is ever authorized but blind, and a tear
@@ -168,10 +255,10 @@ export async function ensurePukRoster({ store, puk, clientKeyAgreementKey }) {
  *   re-wrapping
  * @returns {Promise<CollectionEncryption>}   the refreshed roster descriptor
  */
-export async function addPukRosterRecipient({ store, recipient, ownerKeyAgreementKey }) {
+export async function addUserKeyRosterRecipient({ store, recipient, ownerKeyAgreementKey }) {
     const current = await store.read();
     if (current === null) {
-        throw new Error('The PUK roster does not exist yet; the account must finish ' +
+        throw new Error('The user key roster does not exist yet; the account must finish ' +
             'provisioning before a client can be enrolled.');
     }
     const descriptor = current.descriptor;
@@ -190,16 +277,16 @@ export async function addPukRosterRecipient({ store, recipient, ownerKeyAgreemen
     });
 }
 /**
- * Rotates the PUK roster off one recipient -- the roster half of revoking an
- * enrolled wallet client or a recovery code. A thin, deliberate composition
+ * Rotates the user key roster off one recipient -- the roster half of revoking
+ * an enrolled wallet client or a recovery code. A thin, deliberate composition
  * of was-client's `removeRecipient` with the two roster-specific choices
- * spelled once: the remaining recipients are resolved from the locally
- * verified did:webvh document ("the roster delivers, never sources" -- an
- * entry with no matching `keyAgreement` verification method is dropped and
- * never receives a wrap), and the pull axis is a no-op, because for a roster
- * recipient the pull axis IS the document edit the caller performed first --
- * under the current-key-set rule the removed party's server-side access died
- * the moment its verification method left the document.
+ * spelled once: the remaining recipients are resolved from the locally verified
+ * did:webvh document ("the roster delivers, never sources" -- an entry with no
+ * matching `keyAgreement` verification method is dropped and never receives a
+ * wrap), and the pull axis is a no-op, because for a roster recipient the pull
+ * axis IS the document edit the caller performed first -- under the
+ * current-key-set rule the removed party's server-side access died the moment
+ * its verification method left the document.
  *
  * @param options {object}
  * @param options.store {EncryptionDescriptorStore}   the roster's descriptor
@@ -208,21 +295,25 @@ export async function addPukRosterRecipient({ store, recipient, ownerKeyAgreemen
  *   did:webvh document, AFTER the removal edit
  * @param options.retireRecipientId {string}   the removed recipient's roster
  *   kid
+ * @param options.signEpochs {EpochsSigner}   the rotating client's
+ *   epoch-configuration signer ({@link userKeyRosterEpochsSigner}), vouching for
+ *   the fresh epoch so other clients' rotated reads accept it
  * @returns {Promise<CollectionEncryption>}   the rotated roster descriptor
  */
-export async function rotatePukRoster({ store, document, retireRecipientId }) {
+export async function rotateUserKeyRoster({ store, document, retireRecipientId, signEpochs }) {
     return removeRecipient({
         store,
         recipientId: retireRecipientId,
-        resolveRecipientKey: pukRosterRecipientResolver({ document }),
-        pull: async () => { }
+        resolveRecipientKey: userKeyRosterRecipientResolver({ document }),
+        pull: async () => { },
+        signEpochs
     });
 }
 /**
  * Converges the roster onto the account document: the standing detector for a
  * revocation cascade torn between its two halves. The cascade edits the
  * document first and rotates the roster second, so a client that crashes in
- * between leaves a roster that keeps wrapping the CURRENT per-user key to a
+ * between leaves a roster that keeps wrapping the CURRENT user key to a
  * recipient the document no longer keys -- durable, silent, and permanent,
  * since the revoked client's document edit will never be re-run.
  *
@@ -230,7 +321,7 @@ export async function rotatePukRoster({ store, document, retireRecipientId }) {
  * document-backed resolver cannot answer for is exactly a recipient the
  * document no longer keys, so a healthy account reads the descriptor and
  * writes nothing. When any such recipient is found the roster is rotated away
- * from ALL of them at once -- a single {@link rotatePukRoster} suffices,
+ * from ALL of them at once -- a single {@link rotateUserKeyRoster} suffices,
  * because the resolver drops every unbacked entry from the fresh epoch, not
  * just the one named as retiring.
  *
@@ -239,8 +330,8 @@ export async function rotatePukRoster({ store, document, retireRecipientId }) {
  * account), not a cascade to finish, and completing it would lock every
  * client out of the account.
  *
- * The fresh per-user key itself is not returned: the caller adopts it the
- * ordinary way, by re-reading the roster ({@link readPukRoster}) once
+ * The fresh user key itself is not returned: the caller adopts it the
+ * ordinary way, by re-reading the roster ({@link readUserKeyRoster}) once
  * `rotated` says there is something to adopt, and then runs the collection
  * fan-out.
  *
@@ -252,11 +343,14 @@ export async function rotatePukRoster({ store, document, retireRecipientId }) {
  * @param [options.descriptor] {CollectionEncryption}   a descriptor the caller
  *   has just read (a login-time roster read), to save a re-read; omitted, the
  *   roster is read fresh
+ * @param options.signEpochs {EpochsSigner}   the converging client's
+ *   epoch-configuration signer ({@link userKeyRosterEpochsSigner}), for the
+ *   rotation this call may perform
  * @returns {Promise<object>}   whether the roster rotated on this call, the
  *   stale recipient kids found, and the roster descriptor as it now stands
  *   (`null` when the account has no roster yet)
  */
-export async function convergePukRosterToDocument({ store, document, descriptor }) {
+export async function convergeUserKeyRosterToDocument({ store, document, descriptor, signEpochs }) {
     let roster = descriptor;
     if (!roster) {
         const read = await store.read();
@@ -268,9 +362,9 @@ export async function convergePukRosterToDocument({ store, document, descriptor
     const currentEpochId = roster.currentEpoch;
     const currentEpoch = (roster.epochs ?? []).find(epoch => epoch.id === currentEpochId);
     if (!currentEpoch) {
-        throw new PukRosterIntegrityError('The PUK roster names no current epoch in its own epoch list.');
+        throw new UserKeyRosterIntegrityError('The user key roster names no current epoch in its own epoch list.');
     }
-    const resolveRecipientKey = pukRosterRecipientResolver({ document });
+    const resolveRecipientKey = userKeyRosterRecipientResolver({ document });
     const staleRecipientIds = [];
     let backed = 0;
     for (const entry of currentEpoch.recipients) {
@@ -286,15 +380,16 @@ export async function convergePukRosterToDocument({ store, document, descriptor
         return { rotated: false, staleRecipientIds, descriptor: roster };
     }
     if (backed === 0) {
-        throw new PukRosterIntegrityError('No PUK roster recipient is keyed by the account document; refusing ' +
+        throw new UserKeyRosterIntegrityError('No user key roster recipient is keyed by the account document; refusing ' +
             'to rotate the roster onto no one.');
     }
     // One rotation retires them all: the fresh epoch is wrapped only to the
     // recipients the resolver answers for.
-    const rotated = await rotatePukRoster({
+    const rotated = await rotateUserKeyRoster({
         store,
         document,
-        retireRecipientId: staleRecipientIds[0]
+        retireRecipientId: staleRecipientIds[0],
+        signEpochs
     });
     return { rotated: true, staleRecipientIds, descriptor: rotated };
 }
@@ -305,34 +400,51 @@ export async function convergePukRosterToDocument({ store, document, descriptor
  *
  * 1. **Continuity**: the served epochs must contain the pinned latest-seen
  *    epoch, and `currentEpoch` must not precede it in the append-only list
- *    (`PukRosterContinuityError` -- the rollback/replay refusal).
- * 2. **Possession**: `currentEpoch === puk.id` confirms the cached PUK
+ *    (`UserKeyRosterContinuityError` -- the rollback/replay refusal).
+ * 2. **Possession**: `currentEpoch === userKey.id` confirms the cached user key
  *    current; otherwise the current epoch was rotated by another client and
  *    this client's wrap is unwrapped with its own key-agreement key
- *    (`PukRosterUnwrapError` when it holds none).
- * 3. **Authentication**: the descriptor's `epochsMac` is verified under the
- *    current epoch's secret (`PukRosterIntegrityError` on any mismatch -- a
+ *    (`UserKeyRosterUnwrapError` when it holds none).
+ * 3. **Provenance** (the rotated/first-read path only): the epoch
+ *    configuration's `epochsSig` is verified against the locally verified
+ *    did:webvh document ({@link verifyUserKeyRosterEpochsSig}) BEFORE the epoch
+ *    it delivers is adopted. On this path the `epochsMac` alone proves
+ *    nothing against the host -- its key is unwrapped from the served
+ *    descriptor itself -- so an epoch no enrolled client signed is refused
+ *    (`UserKeyRosterIntegrityError`). The cached-current path needs no signature:
+ *    there the MAC is keyed by a secret this client already trusts.
+ * 4. **Authentication**: the descriptor's `epochsMac` is verified under the
+ *    current epoch's secret (`UserKeyRosterIntegrityError` on any mismatch -- a
  *    fabricated configuration).
  *
- * A rotated read returns the fresh PUK; its Ed25519 signing seed does not
+ * A rotated read returns the fresh user key; its Ed25519 signing seed does not
  * travel through the roster (the roster wraps the key-agreement secret
- * alone), so the returned PUK carries none.
+ * alone), so the returned user key carries none.
  *
- * A caller with no cached PUK at all -- a freshly enrolled client making its
- * first post-enrollment read -- omits `puk` and always takes the unwrap path;
- * the result's `rotated` is then true (the PUK was adopted from the roster).
+ * A caller with no cached user key at all -- a freshly enrolled client making
+ * its first post-enrollment read -- omits `userKey` and always takes the unwrap
+ * path; the result's `rotated` is then true (the user key was adopted from the
+ * roster). Every unwrap-path caller must therefore supply the account document
+ * (or a way to resolve it): `document` when it already holds a verified copy,
+ * or `resolveDocument` to fetch-and-verify lazily, only when the read actually
+ * rotates.
  *
  * @param options {object}
  * @param options.store {EncryptionDescriptorStore}   the roster's descriptor
  *   store
- * @param [options.puk] {Puk}   this client's cached PUK, when it holds one
+ * @param [options.userKey] {UserKey}   this client's cached user key, when it holds one
  * @param options.clientKeyAgreementKey {IKeyAgreementKey}   this client's own
  *   (identity) key-agreement key, unwrapping a rotated epoch
  * @param [options.pinnedEpochId] {string}   the locally pinned latest-seen
  *   roster epoch, when this client has seen the roster before
- * @returns {Promise<PukRosterReadResult | null>}
+ * @param [options.document] {RosterRecipientDocument}   the locally verified
+ *   did:webvh document, when the caller already holds one
+ * @param [options.resolveDocument] {function}   resolves the locally verified
+ *   did:webvh document on demand; called only when the read takes the
+ *   rotated/first-read path
+ * @returns {Promise<UserKeyRosterReadResult | null>}
  */
-export async function readPukRoster({ store, puk, clientKeyAgreementKey, pinnedEpochId }) {
+export async function readUserKeyRoster({ store, userKey, clientKeyAgreementKey, pinnedEpochId, document, resolveDocument }) {
     const current = await store.read();
     if (current === null) {
         return null;
@@ -343,50 +455,66 @@ export async function readPukRoster({ store, puk, clientKeyAgreementKey, pinnedE
         ? epochIds.indexOf(descriptor.currentEpoch)
         : -1;
     if (currentIndex === -1) {
-        throw new PukRosterIntegrityError('The PUK roster names no current epoch in its own epoch list.');
+        throw new UserKeyRosterIntegrityError('The user key roster names no current epoch in its own epoch list.');
     }
     if (pinnedEpochId) {
         const pinnedIndex = epochIds.indexOf(pinnedEpochId);
         if (pinnedIndex === -1 || currentIndex < pinnedIndex) {
-            throw new PukRosterContinuityError({ pinnedEpochId });
+            throw new UserKeyRosterContinuityError({ pinnedEpochId });
         }
     }
     // The epochsMac construction's own version/alg are the caller's to check.
     const epochsMac = descriptor.epochsMac;
     if (!epochsMac || epochsMac.v !== 1 || epochsMac.alg !== 'HS256') {
-        throw new PukRosterIntegrityError('The PUK roster carries no supported epoch-configuration MAC.');
+        throw new UserKeyRosterIntegrityError('The user key roster carries no supported epoch-configuration MAC.');
     }
-    let currentPuk;
+    let currentUserKey;
     let rotated;
-    if (puk && descriptor.currentEpoch === puk.id) {
-        currentPuk = puk;
+    if (userKey && descriptor.currentEpoch === userKey.id) {
+        currentUserKey = userKey;
         rotated = false;
     }
     else {
-        // Rotated by another client: unwrap this client's entry in the current
-        // epoch with its own key-agreement key (rotation delivery).
+        // Rotated by another client (or this client's first read): before
+        // adopting the delivered epoch, trace it to a root of trust the server
+        // cannot mint -- the epoch configuration must be signed by a key the
+        // locally verified account document backs. The epochsMac below cannot
+        // carry this: on this path its key comes out of the served descriptor
+        // itself.
+        const accountDocument = document ?? (resolveDocument ? await resolveDocument() : undefined);
+        if (!accountDocument) {
+            throw new Error('A user key roster read that adopts an epoch from the roster needs the ' +
+                'account document (pass `document` or `resolveDocument`) to verify ' +
+                'the epoch configuration signature.');
+        }
+        await verifyUserKeyRosterEpochsSig({
+            descriptor,
+            document: accountDocument
+        });
+        // Unwrap this client's entry in the current epoch with its own
+        // key-agreement key (rotation delivery).
         const entry = descriptor.epochs[currentIndex].recipients.find(recipient => recipient.header.kid === clientKeyAgreementKey.id);
         if (!entry) {
-            throw new PukRosterUnwrapError('The PUK roster current epoch carries no wrap for this client.');
+            throw new UserKeyRosterUnwrapError('The user key roster current epoch carries no wrap for this client.');
         }
         const secret = await unwrapEpochSecret({
             entry,
             keyAgreementKey: clientKeyAgreementKey
         });
         if (!secret) {
-            throw new PukRosterUnwrapError("This client's PUK roster entry failed to unwrap.");
+            throw new UserKeyRosterUnwrapError("This client's user key roster entry failed to unwrap.");
         }
-        currentPuk = { id: descriptor.currentEpoch, secret };
+        currentUserKey = { id: descriptor.currentEpoch, secret };
         rotated = true;
     }
-    if (!(await verifyEpochsMac({ descriptor, epochSecret: currentPuk.secret }))) {
-        throw new PukRosterIntegrityError('The PUK roster epoch configuration failed authentication.');
+    if (!(await verifyEpochsMac({ descriptor, epochSecret: currentUserKey.secret }))) {
+        throw new UserKeyRosterIntegrityError('The user key roster epoch configuration failed authentication.');
     }
     return {
         descriptor,
-        puk: currentPuk,
+        userKey: currentUserKey,
         rotated,
         latestEpochId: descriptor.currentEpoch
     };
 }
-//# sourceMappingURL=pukRoster.js.map
+//# sourceMappingURL=userKeyRoster.js.map

package/dist/keys/userKeyRoster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userKeyRoster.js","sourceRoot":"","sources":["../../src/keys/userKeyRoster.ts"],"names":[],"mappings":"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"}

package/dist/recovery/index.d.ts

@@ -14,7 +14,7 @@
  *   single did:webvh update key whose hash stands pre-committed.
  * - `wrapRecoveryRecord` / `unwrapRecoveryRecord` -- the keyring-record
  *   sibling carrying the account pointer plus the pre-minted
- *   PUT-on-`did.jsonl` delegation (never a seed, never a PUK wrap).
+ *   PUT-on-`did.jsonl` delegation (never a seed, never a user key wrap).
  * - `publishRecoveryKey` / `removeRecoveryKey` / `recoverWebvhClient` -- the
  *   document half: issuance's split posture, revocation's removal, and the
  *   self-enrolling recovery continuation.

package/dist/recovery/index.js

@@ -14,7 +14,7 @@
  *   single did:webvh update key whose hash stands pre-committed.
  * - `wrapRecoveryRecord` / `unwrapRecoveryRecord` -- the keyring-record
  *   sibling carrying the account pointer plus the pre-minted
- *   PUT-on-`did.jsonl` delegation (never a seed, never a PUK wrap).
+ *   PUT-on-`did.jsonl` delegation (never a seed, never a user key wrap).
  * - `publishRecoveryKey` / `removeRecoveryKey` / `recoverWebvhClient` -- the
  *   document half: issuance's split posture, revocation's removal, and the
  *   self-enrolling recovery continuation.

package/dist/recovery/recoveryCode.d.ts

@@ -83,7 +83,7 @@ export interface RecoveryClient {
     keyAgreementKeyMultibase: string;
     updateKeyMultibase: string;
     /**
-     * The kid of the code's PUK-roster entry -- its key-agreement key's id
+     * The kid of the code's user-key-roster entry -- its key-agreement key's id
      * exactly as `agentsFromSeed` derives it (`did:key:<ed>#<x>`), so the wrap
      * minted at issuance is the one the recovery flow's roster read looks for.
      */

package/dist/recovery/recoveryCode.js

@@ -5,12 +5,12 @@
  * The recovery-code format layer and its deterministic derivations. A recovery
  * code is 16 random bytes rendered as base58 (Bitcoin alphabet), shown to the
  * user exactly once at issuance. Under the roster identity model the code is a
- * **minimal always-enrolled wallet client**: everything the code needs to
- * act -- the unlock identity that locates its keyring record, the client
- * key set behind its `keyAgreement` verification method and PUK-roster wrap,
- * and the did:webvh update key whose hash stands pre-committed in
- * `nextKeyHashes` -- derives deterministically from the code's bytes, so the
- * key material exists nowhere until the code is typed.
+ * **minimal always-enrolled wallet client**: everything the code needs to act
+ * -- the unlock identity that locates its keyring record, the client key set
+ * behind its `keyAgreement` verification method and user-key-roster wrap, and
+ * the did:webvh update key whose hash stands pre-committed in `nextKeyHashes`
+ * -- derives deterministically from the code's bytes, so the key material
+ * exists nowhere until the code is typed.
  *
  * The derivations are wire-level: two wallet apps must produce byte-identical
  * output for the same code, or a code issued in one could not recover in the

package/dist/recovery/recoveryRecord.d.ts

@@ -7,7 +7,7 @@
  * is the ordinary keyring record's (controller, email, account pointer) PLUS
  * the pre-minted PUT-on-`did.jsonl` delegation -- the narrow zcap bridge that
  * lets the code-derived client write its self-enrolling log continuation. It
- * carries **no key material of any kind**: never a seed, never a PUK wrap
+ * carries **no key material of any kind**: never a seed, never a user key wrap
  * (wraps live doc-and-roster only), so the record stays a pure pointer.
  *
  * The wrap reuses the keyring cipher context verbatim, so a recovery record

package/dist/recovery/recoveryWebvh.d.ts

@@ -64,7 +64,7 @@ export declare function publishRecoveryKey({ idStore, updateKeys, recovery }: {
  * REVOCATION (run by an enrolled client, root authority): removes a recovery
  * code's posture from the document -- its `keyAgreement` verification method
  * and its committed update-key hash -- in one entry. Idempotent. The
- * roster-side half (rotating the PUK epoch off the code's wrap) is the
+ * roster-side half (rotating the user key epoch off the code's wrap) is the
  * caller's, and runs after this so the resolver's document no longer backs
  * the removed entry.
  *

package/dist/recovery/recoveryWebvh.js

@@ -165,7 +165,7 @@ export async function publishRecoveryKey({ idStore, updateKeys, recovery }) {
  * REVOCATION (run by an enrolled client, root authority): removes a recovery
  * code's posture from the document -- its `keyAgreement` verification method
  * and its committed update-key hash -- in one entry. Idempotent. The
- * roster-side half (rotating the PUK epoch off the code's wrap) is the
+ * roster-side half (rotating the user key epoch off the code's wrap) is the
  * caller's, and runs after this so the resolver's document no longer backs
  * the removed entry.
  *

package/dist/request/classify.d.ts

@@ -14,6 +14,17 @@
  */
 import type { CHAPIStoreEvent, ICapabilityQueryDetail, ICredentialQuery, IQueryByExample, IVPOffer, IVPRequest, IVPRDetails, IVPRQuery, IVerifiableCredential, IVerifiablePresentation, WalletRequestProfile } from './types.js';
 import type { CHAPIGetEvent } from './types.js';
+/**
+ * The VC data model version a presentation carrying the given credentials must
+ * use, so its `@context` stays coherent with what it carries: `2.0` when any
+ * credential is a VC 2.0 one, else `1.0`. Shared by the bare-credential
+ * wrapping below and by the unsigned branch of `composeVp` (the signed branch
+ * takes its version from the negotiated cryptosuite instead).
+ *
+ * @param credentials {IVerifiableCredential[]}
+ * @returns {number}
+ */
+export declare function presentationVersionFor(credentials: IVerifiableCredential[]): number;
 /**
  * The Verifiable Credentials carried by a presentation, normalized to an array.
  *
@@ -103,7 +114,10 @@ export declare function isDidAuthOnly(profile: WalletRequestProfile): boolean;
 /**
  * Returns true if the wallet can satisfy the DID method a `DIDAuthentication`
  * query constrains to. A wallet holding only `did:key` can satisfy a request
- * that lists `key` among `acceptedMethods` or omits the constraint entirely.
+ * that lists `key` among `acceptedMethods` or omits the constraint entirely. A
+ * malformed `acceptedMethods` (not an array, or holding non-object entries) is
+ * read for the entries it does have rather than dereferenced blindly: an
+ * `acceptedMethods` that is not a list of constraints at all imposes none.
  *
  * @param queries {IVPRQuery[]}
  * @returns {boolean}

package/dist/request/classify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/request/classify.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAEhB,eAAe,EACf,QAAQ,EACR,UAAU,EACV,WAAW,EACX,SAAS,EACT,qBAAqB,EACrB,uBAAuB,EAEvB,oBAAoB,EACrB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AA4D/C;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,uBAAuB,GACpC,qBAAqB,EAAE,CAQzB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,CAKxE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACR,EAAE;IACD,OAAO,EAAE,SAAS,EAAE,CAAA;CACrB,GAAG,OAAO,CAMV;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,CAS3D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,GACrB,gBAAgB,EAAE,CAMpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,sBAAsB,EAAE,CAoB5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,oBAAoB,CAS1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAMpE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAQpE"}
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/request/classify.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAEhB,eAAe,EACf,QAAQ,EACR,UAAU,EACV,WAAW,EACX,SAAS,EACT,qBAAqB,EACrB,uBAAuB,EAEvB,oBAAoB,EACrB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAO/C;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,qBAAqB,EAAE,GACnC,MAAM,CAOR;AA0DD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,uBAAuB,GACpC,qBAAqB,EAAE,CAQzB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,CAKxE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACR,EAAE;IACD,OAAO,EAAE,SAAS,EAAE,CAAA;CACrB,GAAG,OAAO,CAQV;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,CAS3D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,GACrB,gBAAgB,EAAE,CAMpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,sBAAsB,EAAE,CAoB5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,oBAAoB,CAS1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAMpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAQpE"}