@interop/wallet-core 0.62.0 → 0.66.0

package/dist/keys/userKeyRoster.js

@@ -1,7 +1,7 @@
 import { addRecipient, initRecipients, ownerRecipient, removeRecipient, replaceRecipient, unwrapEpochSecret } from '@interop/was-client/edv';
 import { vmFragmentOf } from '@interop/vh-resource-log';
-import { commitmentMatcher, MULTIKEY_COMMITMENT_VM_TYPE } from '../webvh/didWebvh.js';
-import { resolvedKeyAgreementMethods } from '../webvh/keyAgreement.js';
+import { clientKeyAgreementController, commitmentMatcher, MULTIKEY_COMMITMENT_VM_TYPE } from '../webvh/didWebvh.js';
+import { resolvedKeyAgreementMethods } from '../resourceLog/document.js';
 import { clientSigningKeyMultibase } from '../webvh/zcap.js';
 /**
  * Thrown when a served roster fails its client-side consistency checks: a
@@ -15,6 +15,46 @@ export class UserKeyRosterIntegrityError extends Error {
         this.name = 'UserKeyRosterIntegrityError';
     }
 }
+/**
+ * Resolves a descriptor's current epoch, refusing a descriptor whose
+ * `currentEpoch` names no epoch in its own list -- the shape no enrolled
+ * client authenticated. Every site that resolves a current epoch goes
+ * through here, so the refusal has one implementation and one class.
+ *
+ * @param options {object}
+ * @param options.descriptor {CollectionEncryption}
+ * @param options.label {string}   names the descriptor in the refusal, e.g.
+ *   'The user key roster' or 'The collection descriptor'
+ * @returns {CollectionEncryptionEpoch}   the current epoch
+ * @throws {UserKeyRosterIntegrityError}
+ */
+export function currentEpochOf({ descriptor, label }) {
+    const currentEpoch = (descriptor.epochs ?? []).find(epoch => epoch.id === descriptor.currentEpoch);
+    if (!currentEpoch) {
+        throw new UserKeyRosterIntegrityError(`${label} names no current epoch in its own epoch list.`);
+    }
+    return currentEpoch;
+}
+/**
+ * Whether a roster's CURRENT epoch wraps to the named recipient -- the probe
+ * the enrollment wrap asks before adding, and the recipient-retiring cascade
+ * tail asks before rotating (a recipient with no current-epoch wrap has
+ * nothing to rotate off). Resolves the current epoch through
+ * {@link currentEpochOf}, so a roster whose `currentEpoch` names no epoch in
+ * its own list is refused rather than read as "not wrapped".
+ *
+ * @param options {object}
+ * @param options.descriptor {CollectionEncryption}   the roster descriptor
+ * @param options.recipientId {string}   the roster kid
+ * @returns {boolean}
+ * @throws {UserKeyRosterIntegrityError}
+ */
+export function rosterWrapsRecipient({ descriptor, recipientId }) {
+    return currentEpochOf({
+        descriptor,
+        label: 'The user key roster'
+    }).recipients.some(entry => entry.header.kid === recipientId);
+}
 /**
  * Thrown when a served roster conflicts with the locally pinned latest-seen
  * epoch -- the epochs list no longer contains the pinned epoch, or
@@ -205,6 +245,8 @@ export async function ensureUserKeyRoster({ store, userKey, clientKeyAgreementKe
  *   client's own (identity) key-agreement key, unwrapping each epoch for
  *   re-wrapping
  * @returns {Promise<CollectionEncryption>}   the refreshed roster descriptor
+ * @throws {UserKeyRosterIntegrityError}   the descriptor's `currentEpoch`
+ *   names no epoch in its own list
  */
 export async function addUserKeyRosterRecipient({ store, recipient, ownerKeyAgreementKey }) {
     const current = await store.read();
@@ -213,9 +255,7 @@ export async function addUserKeyRosterRecipient({ store, recipient, ownerKeyAgre
             'provisioning before a client can be enrolled.');
     }
     const descriptor = current.descriptor;
-    const currentEpoch = (descriptor.epochs ?? []).find(epoch => epoch.id === descriptor.currentEpoch);
-    const wrapped = currentEpoch?.recipients.some(entry => entry.header.kid === recipient.id);
-    if (wrapped) {
+    if (rosterWrapsRecipient({ descriptor, recipientId: recipient.id })) {
         // A completed (or torn-after-the-wrap) earlier run: addRecipient writes
         // every epoch's wrap in one descriptor write, so the current epoch
         // standing means the escrow set is complete.
@@ -256,6 +296,83 @@ export async function rotateUserKeyRoster({ store, document, retireRecipientId }
         pull: async () => { }
     });
 }
+/**
+ * The error name a lost descriptor compare-and-swap surfaces as --
+ * was-client's `PreconditionFailedError`, and whatever an alternative store
+ * implementation throws under that name (the `EncryptionDescriptorStore` port
+ * documents the class).
+ */
+const PRECONDITION_FAILED_ERROR_NAME = 'PreconditionFailedError';
+/**
+ * How many times the batched escrow re-reads and re-applies after losing the
+ * compare-and-swap. Matches was-client's own recipient-operation budget: a
+ * lost race means nothing was appended, so the license shot the append would
+ * spend is still standing.
+ */
+const ESCROW_CAS_ATTEMPTS = 3;
+/**
+ * Escrows several recipients into every epoch in ONE descriptor write.
+ *
+ * was-client's `addRecipient` takes one recipient and does its own read,
+ * mutate and compare-and-swap, so a loop over it costs one write per
+ * recipient. On a log-governed store a write IS a log append, and a
+ * ladder-signed append is one-shot per licensed version, so the second
+ * recipient's append would be refused after the caller's pivot. The escrow
+ * crypto stays was-client's: `addRecipient` runs against a buffering store
+ * whose reads serve the staged descriptor and whose writes stay in memory,
+ * and the staged result is written back through the real store once, under
+ * the compare-and-swap token of the read the whole batch was built on.
+ *
+ * @param options {object}
+ * @param options.store {EncryptionDescriptorStore}   the roster's descriptor
+ *   store
+ * @param options.recipients {RecipientPublicKey[]}   the incoming readers'
+ *   public key-agreement keys; at least one
+ * @param options.ownerKeyAgreementKey {IKeyAgreementKey}   a key-agreement
+ *   key holding a wrap in every epoch, unwrapping each one for the escrow
+ * @returns {Promise<CollectionEncryption>}   the roster as this write leaves
+ *   it
+ */
+async function escrowRosterRecipients({ store, recipients, ownerKeyAgreementKey }) {
+    let lastError;
+    for (let attempt = 0; attempt < ESCROW_CAS_ATTEMPTS; attempt++) {
+        const read = await store.read();
+        if (read === null) {
+            throw new UserKeyRosterIntegrityError('The user key roster does not exist; there is nothing to escrow into.');
+        }
+        let staged = read.descriptor;
+        const buffer = {
+            read: async () => ({ descriptor: staged }),
+            replace: async (next) => {
+                staged = next;
+            }
+        };
+        for (const recipient of recipients) {
+            staged = await addRecipient({
+                store: buffer,
+                recipient,
+                owner: { keyAgreementKey: ownerKeyAgreementKey }
+            });
+        }
+        try {
+            await store.replace(staged, {
+                ...(read.etag !== undefined ? { ifMatch: read.etag } : {})
+            });
+            return staged;
+        }
+        catch (err) {
+            if (err?.name === PRECONDITION_FAILED_ERROR_NAME) {
+                // A concurrent writer landed first: nothing of this batch was
+                // written, so re-read and re-apply.
+                lastError = err;
+                continue;
+            }
+            throw err;
+        }
+    }
+    throw new Error('The user key roster escrow lost the compare-and-swap race after ' +
+        `${ESCROW_CAS_ATTEMPTS} attempts. Retry the convergence.`, { cause: lastError });
+}
 /**
  * Rotates the roster off one or more recipients while escrowing incoming ones,
  * in ONE descriptor write -- the transient-recovery continuation's mandatory
@@ -325,10 +442,10 @@ export async function replaceUserKeyRosterRecipients({ store, document, retireRe
  * @returns {string[]}   the current epoch's other kids, in epoch order
  */
 export function rosterRecipientsToRetire({ descriptor, keepRecipientIds }) {
-    const currentEpoch = (descriptor.epochs ?? []).find(epoch => epoch.id === descriptor.currentEpoch);
-    if (!currentEpoch) {
-        throw new UserKeyRosterIntegrityError('The user key roster names no current epoch in its own epoch list.');
-    }
+    const currentEpoch = currentEpochOf({
+        descriptor,
+        label: 'The user key roster'
+    });
     const keep = new Set(keepRecipientIds);
     return [
         ...new Set(currentEpoch.recipients
@@ -336,6 +453,53 @@ export function rosterRecipientsToRetire({ descriptor, keepRecipientIds }) {
             .filter(kid => !keep.has(kid)))
     ];
 }
+/**
+ * The enrolled clients the account document keys, as roster recipients. A
+ * client's `keyAgreement` twin carries the controller marker
+ * `did:key:<its signing multibase>` (`clientKeyAgreementController` is the one
+ * write-side builder), so the marker names the signing half and the method
+ * carries the key-agreement half -- together, exactly the pair
+ * {@link rosterRecipientKid} takes. That is what makes the escrow direction of
+ * the convergence possible from the document alone.
+ *
+ * A standing unlock credential is deliberately not here, and not because it is
+ * unwanted. Its roster kid names its standing client's SIGNING key, which the
+ * document never publishes: the document carries the credential's
+ * key-agreement key (or a commitment to it) and nothing else, so no reader can
+ * rebuild the kid its own roster reads look for. A credential's missing wrap
+ * is therefore mended by the ceremony that holds the credential, never here.
+ *
+ * @param options {object}
+ * @param options.document {KeyAgreementDocument}   the locally verified
+ *   did:webvh document
+ * @returns {RecipientPublicKey[]}   in document order
+ */
+export function enrolledClientRosterRecipients({ document }) {
+    const recipients = [];
+    for (const method of resolvedKeyAgreementMethods({ doc: document })) {
+        const controller = method.controller;
+        const keyAgreementKeyMultibase = method.publicKeyMultibase;
+        if (method.type === MULTIKEY_COMMITMENT_VM_TYPE ||
+            typeof controller !== 'string' ||
+            typeof keyAgreementKeyMultibase !== 'string') {
+            continue;
+        }
+        // The marker is read by rebuilding it: whatever the third segment holds is
+        // a candidate signing multibase, and the marker matches only when the one
+        // write-side builder produces the controller verbatim.
+        const [, , signingKeyMultibase] = controller.split(':');
+        if (signingKeyMultibase === undefined ||
+            signingKeyMultibase === '' ||
+            clientKeyAgreementController({ signingKeyMultibase }) !== controller) {
+            continue;
+        }
+        recipients.push({
+            id: rosterRecipientKid({ signingKeyMultibase, keyAgreementKeyMultibase }),
+            publicKeyMultibase: keyAgreementKeyMultibase
+        });
+    }
+    return recipients;
+}
 /**
  * Converges the roster onto the account document: the standing detector for a
  * revocation cascade torn between its two halves. The cascade edits the
@@ -348,9 +512,30 @@ export function rosterRecipientsToRetire({ descriptor, keepRecipientIds }) {
  * 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 rotateUserKeyRoster} suffices,
- * because the resolver drops every unbacked entry from the fresh epoch, not
- * just the one named as retiring.
+ * from ALL of them at once, because the resolver drops every unbacked entry
+ * from the fresh epoch, not just the one named as retiring.
+ *
+ * The convergence runs in TWO directions, in one append. The retire direction
+ * is above. The escrow direction is its mirror: an enrolled client the
+ * document keys that holds no wrap in the current epoch is escrowed into every
+ * epoch ({@link enrolledClientRosterRecipients} names the candidates). That is
+ * the mender for a ceremony torn between the entry that published a client and
+ * the append that was to wrap the user key to it -- the one-request window a
+ * ladder-signed enrollment approval leaves, where the ladder's append is
+ * licensed only as the tail of its own entry and cannot precede it. A standing
+ * unlock credential is not a candidate: its roster kid names a signing key the
+ * document does not publish (see the helper), so its missing wrap is mended by
+ * the ceremony holding the credential.
+ *
+ * Either direction, and both together, cost exactly ONE descriptor write. A
+ * convergence needing both rides `replaceRecipient`; a pure escrow rides
+ * {@link escrowRosterRecipients}, which stages every missing recipient's
+ * wraps through was-client's `addRecipient` and writes once, so the user key
+ * is not rotated for a missing wrap and a ladder-signed convergence never
+ * needs a second append it has no license for. A healthy roster writes
+ * nothing at all. The escrow direction needs a key that unwraps every epoch,
+ * so it runs only for a caller that supplies `ownerKeyAgreementKey`; without
+ * one the retire direction runs alone.
  *
  * Rotating onto nobody is refused: a current epoch in which NO recipient is
  * backed by the document is a mismatched pair (a stale document, the wrong
@@ -370,29 +555,38 @@ export function rosterRecipientsToRetire({ descriptor, keepRecipientIds }) {
  * @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.ownerKeyAgreementKey] {IKeyAgreementKey}   a key-agreement
+ *   key holding a wrap in every epoch, unwrapping each one for the escrow
+ *   direction; omitted, only the retire direction runs
  * @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)
+ *   stale recipient kids found, the kids escrowed, and the roster descriptor
+ *   as it now stands (`null` when the account has no roster yet)
  */
-export async function convergeUserKeyRosterToDocument({ store, document, descriptor }) {
+export async function convergeUserKeyRosterToDocument({ store, document, descriptor, ownerKeyAgreementKey }) {
     let roster = descriptor;
     if (!roster) {
         const read = await store.read();
         if (read === null) {
-            return { rotated: false, staleRecipientIds: [], descriptor: null };
+            return {
+                rotated: false,
+                staleRecipientIds: [],
+                escrowedRecipientIds: [],
+                descriptor: null
+            };
         }
         roster = read.descriptor;
     }
-    const currentEpochId = roster.currentEpoch;
-    const currentEpoch = (roster.epochs ?? []).find(epoch => epoch.id === currentEpochId);
-    if (!currentEpoch) {
-        throw new UserKeyRosterIntegrityError('The user key roster names no current epoch in its own epoch list.');
-    }
+    const currentEpoch = currentEpochOf({
+        descriptor: roster,
+        label: 'The user key roster'
+    });
     const resolveRecipientKey = userKeyRosterRecipientResolver({ document });
     const staleRecipientIds = [];
     let backed = 0;
+    const wrappedKids = new Set();
     for (const entry of currentEpoch.recipients) {
         const kid = entry.header.kid;
+        wrappedKids.add(kid);
         if ((await resolveRecipientKey(kid)) === null) {
             staleRecipientIds.push(kid);
         }
@@ -400,21 +594,71 @@ export async function convergeUserKeyRosterToDocument({ store, document, descrip
             backed++;
         }
     }
-    if (staleRecipientIds.length === 0) {
-        return { rotated: false, staleRecipientIds, descriptor: roster };
+    const escrow = ownerKeyAgreementKey
+        ? {
+            ownerKeyAgreementKey,
+            recipients: enrolledClientRosterRecipients({ document }).filter(recipient => !wrappedKids.has(recipient.id))
+        }
+        : undefined;
+    const escrowedRecipientIds = (escrow?.recipients ?? []).map(recipient => recipient.id);
+    if (staleRecipientIds.length === 0 && escrowedRecipientIds.length === 0) {
+        return {
+            rotated: false,
+            staleRecipientIds,
+            escrowedRecipientIds,
+            descriptor: roster
+        };
     }
-    if (backed === 0) {
+    if (staleRecipientIds.length > 0 && backed === 0) {
         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 rotateUserKeyRoster({
+    // A pure removal is `removeRecipient`'s shape and a pure escrow is
+    // `addRecipient`'s; was-client refuses `replaceRecipient` for either, and
+    // that is also where the append counts differ. One direction at a time:
+    if (escrow === undefined || escrow.recipients.length === 0) {
+        const rotated = await rotateUserKeyRoster({
+            store,
+            document,
+            retireRecipientId: staleRecipientIds[0]
+        });
+        return {
+            rotated: true,
+            staleRecipientIds,
+            escrowedRecipientIds,
+            descriptor: rotated
+        };
+    }
+    // One append for every incoming recipient together, and no fresh epoch, so
+    // a ladder-signed convergence spends exactly one licensed append whatever
+    // the tear left missing.
+    if (staleRecipientIds.length === 0) {
+        return {
+            rotated: false,
+            staleRecipientIds,
+            escrowedRecipientIds,
+            descriptor: await escrowRosterRecipients({
+                store,
+                recipients: escrow.recipients,
+                ownerKeyAgreementKey: escrow.ownerKeyAgreementKey
+            })
+        };
+    }
+    const converged = await replaceUserKeyRosterRecipients({
         store,
         document,
-        retireRecipientId: staleRecipientIds[0]
+        retireRecipientIds: staleRecipientIds,
+        recipients: escrow.recipients,
+        ownerKeyAgreementKey: escrow.ownerKeyAgreementKey
     });
-    return { rotated: true, staleRecipientIds, descriptor: rotated };
+    return {
+        // An escrow-only convergence writes wraps without minting an epoch, so
+        // the fresh epoch id is what says whether the user key rotated.
+        rotated: converged.currentEpoch !== roster.currentEpoch,
+        staleRecipientIds,
+        escrowedRecipientIds,
+        descriptor: converged
+    };
 }
 export async function readUserKeyRoster({ store, descriptor: knownDescriptor, userKey, clientKeyAgreementKey, pinnedEpochId }) {
     let descriptor = knownDescriptor;
@@ -425,13 +669,12 @@ export async function readUserKeyRoster({ store, descriptor: knownDescriptor, us
         }
         descriptor = current.descriptor;
     }
+    const currentEpoch = currentEpochOf({
+        descriptor,
+        label: 'The user key roster'
+    });
     const epochIds = (descriptor.epochs ?? []).map(epoch => epoch.id);
-    const currentIndex = descriptor.currentEpoch
-        ? epochIds.indexOf(descriptor.currentEpoch)
-        : -1;
-    if (currentIndex === -1) {
-        throw new UserKeyRosterIntegrityError('The user key roster names no current epoch in its own epoch list.');
-    }
+    const currentIndex = epochIds.indexOf(currentEpoch.id);
     if (pinnedEpochId) {
         const pinnedIndex = epochIds.indexOf(pinnedEpochId);
         if (pinnedIndex === -1 || currentIndex < pinnedIndex) {

package/dist/keys/userKeyRoster.js.map

@@ -1 +1 @@
-{"version":3,"file":"userKeyRoster.js","sourceRoot":"","sources":["../../src/keys/userKeyRoster.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"userKeyRoster.js","sourceRoot":"","sources":["../../src/keys/userKeyRoster.ts"],"names":[],"mappings":"AAsDA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EAGlB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,YAAY,EAA0B,MAAM,0BAA0B,CAAA;AAC/E,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,EACjB,2BAA2B,EAC5B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AAExE,OAAO,EACL,yBAAyB,EAE1B,MAAM,kBAAkB,CAAA;AAGzB;;;;;GAKG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAA;IAC3C,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,UAAU,EACV,KAAK,EAIN;IACC,MAAM,YAAY,GAAG,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CACjD,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,YAAY,CAC9C,CAAA;IACD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,2BAA2B,CACnC,GAAG,KAAK,gDAAgD,CACzD,CAAA;IACH,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAAC,EACnC,UAAU,EACV,WAAW,EAIZ;IACC,OAAO,cAAc,CAAC;QACpB,UAAU;QACV,KAAK,EAAE,qBAAqB;KAC7B,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,WAAW,CAAC,CAAA;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,aAAa,CAAQ;IACrB,YAAY,EAAE,aAAa,EAA6B;QACtD,KAAK,CACH,4EAA4E;YAC1E,mCAAmC,CACtC,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAA;QAC1C,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;IACpC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;IACxC,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,QAAQ,EAGT;IACC,MAAM,YAAY,GAAG,yBAAyB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAA;IACnC,OAAO;QACL,YAAY;QACZ,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAwB;YACvC,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;YAC7C,uEAAuE;YACvE,qEAAqE;YACrE,OAAO,IAAI,UAAU,CACnB,SAAS,CAAC,MAAM,EAChB,SAAS,CAAC,UAAU,EACpB,SAAS,CAAC,UAAU,CACrB,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,mBAAmB,EACnB,wBAAwB,EAIzB;IACC,OAAO,WAAW,mBAAmB,IAAI,wBAAwB,EAAE,CAAA;AACrE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,8BAA8B,CAAC,EAC7C,QAAQ,EAGT;IACC,MAAM,OAAO,GAAG,2BAA2B,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC9D,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CACpC,MAAM,CAAC,EAAE,CACP,MAAM,CAAC,IAAI,KAAK,2BAA2B;QAC3C,OAAO,MAAM,CAAC,kBAAkB,KAAK,QAAQ,CAChD,CAAA;IACD,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;QACzC,WAAW,EAAE,OAAO;aACjB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,2BAA2B,CAAC;aAC7D,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC;aACzC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;KACjE,CAAC,CAAA;IACF,OAAO,KAAK,UAAU,mBAAmB,CACvC,GAAW;QAEX,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAChC,MAAM,CAAC,EAAE,CACP,MAAM,CAAC,kBAAkB,KAAK,QAAQ;YACtC,CAAC,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,QAAQ,CAAC,CAC1E,CAAA;QACD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,CAAC,kBAAmB,EAAE,CAAA;QACnE,CAAC;QACD,yEAAyE;QACzE,mEAAmE;QACnE,iEAAiE;QACjE,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAA;QAClD,CAAC;QACD,oEAAoE;QACpE,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EACxC,KAAK,EACL,OAAO,EACP,qBAAqB,EAKtB;IACC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAA;IAClC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC,UAAU,CAAA;IAC3B,CAAC;IACD,OAAO,cAAc,CAAC;QACpB,KAAK;QACL,UAAU,EAAE,CAAC,cAAc,CAAC,EAAE,eAAe,EAAE,qBAAqB,EAAE,CAAC,CAAC;QACxE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;KACvD,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,EAC9C,KAAK,EACL,SAAS,EACT,oBAAoB,EAKrB;IACC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAA;IAClC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,kEAAkE;YAChE,+CAA+C,CAClD,CAAA;IACH,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;IACrC,IAAI,oBAAoB,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACpE,wEAAwE;QACxE,mEAAmE;QACnE,6CAA6C;QAC7C,OAAO,UAAU,CAAA;IACnB,CAAC;IACD,OAAO,YAAY,CAAC;QAClB,KAAK;QACL,SAAS;QACT,KAAK,EAAE,EAAE,eAAe,EAAE,oBAAoB,EAAE;KACjD,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EACxC,KAAK,EACL,QAAQ,EACR,iBAAiB,EAKlB;IACC,OAAO,eAAe,CAAC;QACrB,KAAK;QACL,WAAW,EAAE,iBAAiB;QAC9B,mBAAmB,EAAE,8BAA8B,CAAC,EAAE,QAAQ,EAAE,CAAC;QACjE,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACrB,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,8BAA8B,GAAG,yBAAyB,CAAA;AAEhE;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG,CAAC,CAAA;AAE7B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,KAAK,UAAU,sBAAsB,CAAC,EACpC,KAAK,EACL,UAAU,EACV,oBAAoB,EAKrB;IACC,IAAI,SAAkB,CAAA;IACtB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,mBAAmB,EAAE,OAAO,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAA;QAC/B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,2BAA2B,CACnC,sEAAsE,CACvE,CAAA;QACH,CAAC;QACD,IAAI,MAAM,GAAG,IAAI,CAAC,UAAU,CAAA;QAC5B,MAAM,MAAM,GAA8B;YACxC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;YAC1C,OAAO,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;gBACpB,MAAM,GAAG,IAAI,CAAA;YACf,CAAC;SACF,CAAA;QACD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,GAAG,MAAM,YAAY,CAAC;gBAC1B,KAAK,EAAE,MAAM;gBACb,SAAS;gBACT,KAAK,EAAE,EAAE,eAAe,EAAE,oBAAoB,EAAE;aACjD,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;gBAC1B,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3D,CAAC,CAAA;YACF,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAAa,EAAE,IAAI,KAAK,8BAA8B,EAAE,CAAC;gBAC5D,8DAA8D;gBAC9D,oCAAoC;gBACpC,SAAS,GAAG,GAAG,CAAA;gBACf,SAAQ;YACV,CAAC;YACD,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,kEAAkE;QAChE,GAAG,mBAAmB,mCAAmC,EAC3D,EAAE,KAAK,EAAE,SAAS,EAAE,CACrB,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,EACnD,KAAK,EACL,QAAQ,EACR,kBAAkB,EAClB,UAAU,EACV,oBAAoB,EAOrB;IACC,OAAO,gBAAgB,CAAC;QACtB,KAAK;QACL,MAAM,EAAE,kBAAkB;QAC1B,SAAS,EAAE,UAAU;QACrB,KAAK,EAAE,EAAE,eAAe,EAAE,oBAAoB,EAAE;QAChD,mBAAmB,EAAE,8BAA8B,CAAC,EAAE,QAAQ,EAAE,CAAC;QACjE,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACrB,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,wBAAwB,CAAC,EACvC,UAAU,EACV,gBAAgB,EAIjB;IACC,MAAM,YAAY,GAAG,cAAc,CAAC;QAClC,UAAU;QACV,KAAK,EAAE,qBAAqB;KAC7B,CAAC,CAAA;IACF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAA;IACtC,OAAO;QACL,GAAG,IAAI,GAAG,CACR,YAAY,CAAC,UAAU;aACpB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;aAC9B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CACjC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,8BAA8B,CAAC,EAC7C,QAAQ,EAGT;IACC,MAAM,UAAU,GAAyB,EAAE,CAAA;IAC3C,KAAK,MAAM,MAAM,IAAI,2BAA2B,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAA;QACpC,MAAM,wBAAwB,GAAG,MAAM,CAAC,kBAAkB,CAAA;QAC1D,IACE,MAAM,CAAC,IAAI,KAAK,2BAA2B;YAC3C,OAAO,UAAU,KAAK,QAAQ;YAC9B,OAAO,wBAAwB,KAAK,QAAQ,EAC5C,CAAC;YACD,SAAQ;QACV,CAAC;QACD,2EAA2E;QAC3E,0EAA0E;QAC1E,uDAAuD;QACvD,MAAM,CAAC,EAAE,AAAD,EAAG,mBAAmB,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACvD,IACE,mBAAmB,KAAK,SAAS;YACjC,mBAAmB,KAAK,EAAE;YAC1B,4BAA4B,CAAC,EAAE,mBAAmB,EAAE,CAAC,KAAK,UAAU,EACpE,CAAC;YACD,SAAQ;QACV,CAAC;QACD,UAAU,CAAC,IAAI,CAAC;YACd,EAAE,EAAE,kBAAkB,CAAC,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,CAAC;YACzE,kBAAkB,EAAE,wBAAwB;SAC7C,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,EACpD,KAAK,EACL,QAAQ,EACR,UAAU,EACV,oBAAoB,EAMrB;IAMC,IAAI,MAAM,GAAG,UAAU,CAAA;IACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAA;QAC/B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,iBAAiB,EAAE,EAAE;gBACrB,oBAAoB,EAAE,EAAE;gBACxB,UAAU,EAAE,IAAI;aACjB,CAAA;QACH,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,UAAU,CAAA;IAC1B,CAAC;IACD,MAAM,YAAY,GAAG,cAAc,CAAC;QAClC,UAAU,EAAE,MAAM;QAClB,KAAK,EAAE,qBAAqB;KAC7B,CAAC,CAAA;IAEF,MAAM,mBAAmB,GAAG,8BAA8B,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;IACxE,MAAM,iBAAiB,GAAa,EAAE,CAAA;IACtC,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAA;IACrC,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAA;QAC5B,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACpB,IAAI,CAAC,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9C,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAA;QACV,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,oBAAoB;QACjC,CAAC,CAAC;YACE,oBAAoB;YACpB,UAAU,EAAE,8BAA8B,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAC7D,SAAS,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAC5C;SACF;QACH,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CACzD,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAC1B,CAAA;IACD,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,iBAAiB;YACjB,oBAAoB;YACpB,UAAU,EAAE,MAAM;SACnB,CAAA;IACH,CAAC;IACD,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,2BAA2B,CACnC,0EAA0E;YACxE,mCAAmC,CACtC,CAAA;IACH,CAAC;IAED,mEAAmE;IACnE,0EAA0E;IAC1E,wEAAwE;IACxE,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC;YACxC,KAAK;YACL,QAAQ;YACR,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAE;SACzC,CAAC,CAAA;QACF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,iBAAiB;YACjB,oBAAoB;YACpB,UAAU,EAAE,OAAO;SACpB,CAAA;IACH,CAAC;IACD,2EAA2E;IAC3E,0EAA0E;IAC1E,yBAAyB;IACzB,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,iBAAiB;YACjB,oBAAoB;YACpB,UAAU,EAAE,MAAM,sBAAsB,CAAC;gBACvC,KAAK;gBACL,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;aAClD,CAAC;SACH,CAAA;IACH,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,8BAA8B,CAAC;QACrD,KAAK;QACL,QAAQ;QACR,kBAAkB,EAAE,iBAAiB;QACrC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;KAClD,CAAC,CAAA;IACF,OAAO;QACL,uEAAuE;QACvE,gEAAgE;QAChE,OAAO,EAAE,SAAS,CAAC,YAAY,KAAK,MAAM,CAAC,YAAY;QACvD,iBAAiB;QACjB,oBAAoB;QACpB,UAAU,EAAE,SAAS;KACtB,CAAA;AACH,CAAC;AA8ED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EACtC,KAAK,EACL,UAAU,EAAE,eAAe,EAC3B,OAAO,EACP,qBAAqB,EACrB,aAAa,EAOd;IACC,IAAI,UAAU,GAAG,eAAe,CAAA;IAChC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAA;QAClC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,IAAI,CAAA;QACb,CAAC;QACD,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;IACjC,CAAC;IAED,MAAM,YAAY,GAAG,cAAc,CAAC;QAClC,UAAU;QACV,KAAK,EAAE,qBAAqB;KAC7B,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACjE,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;IACtD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;QACnD,IAAI,WAAW,KAAK,CAAC,CAAC,IAAI,YAAY,GAAG,WAAW,EAAE,CAAC;YACrD,MAAM,IAAI,4BAA4B,CAAC,EAAE,aAAa,EAAE,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;IAED,IAAI,cAAuB,CAAA;IAC3B,IAAI,OAAgB,CAAA;IACpB,IAAI,OAAO,IAAI,UAAU,CAAC,YAAY,KAAK,OAAO,CAAC,EAAE,EAAE,CAAC;QACtD,cAAc,GAAG,OAAO,CAAA;QACxB,OAAO,GAAG,KAAK,CAAA;IACjB,CAAC;SAAM,CAAC;QACN,qEAAqE;QACrE,yEAAyE;QACzE,uEAAuE;QACvE,kEAAkE;QAClE,+DAA+D;QAC/D,yCAAyC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAO,CAAC,YAAY,CAAE,CAAC,UAAU,CAAC,IAAI,CAC7D,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,KAAK,qBAAqB,CAAC,EAAE,CAC/D,CAAA;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,wBAAwB,CAChC,oEAAoE,CACrE,CAAA;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;YACrC,KAAK;YACL,eAAe,EAAE,qBAAqB;SACvC,CAAC,CAAA;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,wBAAwB,CAChC,uDAAuD,CACxD,CAAA;QACH,CAAC;QACD,cAAc,GAAG,EAAE,EAAE,EAAE,UAAU,CAAC,YAAa,EAAE,MAAM,EAAE,CAAA;QACzD,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC;IAED,OAAO;QACL,UAAU;QACV,OAAO,EAAE,cAAc;QACvB,OAAO;QACP,aAAa,EAAE,UAAU,CAAC,YAAa;KACxC,CAAA;AACH,CAAC"}

package/dist/keys/userKeyRosterCascade.d.ts

@@ -11,10 +11,11 @@
  *    from the document the edit itself just resolved to (no re-fetch of the
  *    log the ceremony just extended). On a log-governed roster store this
  *    function itself guarantees post-edit anchoring: the controller view built
- *    from the edit's own post-edit log is set as the store's freshness floor
- *    (`setControllerFloor`) before anything roster-side runs, so the rotation
- *    and the seal backstop anchor at or past the edit even where the app's
- *    injected controller resolution still serves a cached pre-edit view. The
+ *    from the edit's own post-edit log is set as the store's minimum controller
+ *    version (`setMinimumControllerVersion`) before anything roster-side
+ *    runs, so the rotation and the seal backstop anchor at or past the edit
+ *    even where the app's injected controller resolution still serves a
+ *    cached pre-edit view. The
  *    roster delivers, never sources, so the stage names no recipient at all:
  *    it converges the roster onto that document (the login sweep's own path),
  *    retiring every current-epoch recipient the document no longer keys in one
@@ -35,6 +36,20 @@
  * epoch names a non-current key generation -- so a mid-cascade crash strands
  * nothing permanently and a naive full re-run finishes it (the login-time
  * completion sweep is the standing backstop).
+ *
+ * The tail has two entry points over the same preamble and fan-out.
+ * `rotateRosterToDocumentAndCascade` is the document-converging one above,
+ * for a ceremony whose document edit has already landed.
+ * `retireRosterRecipientAndCascade` is the recipient-naming one: for a
+ * ceremony that must rotate BEFORE its own document edit -- the two forget
+ * ceremonies, where the forgetting client can sign nothing after its removal
+ * entry -- the document still lists the retiring recipient, so convergence
+ * would retire nothing, and the caller names the roster kid to retire
+ * instead. That entry point reads the fresh key back through a key the
+ * caller names (the standing credential's, whose wrap survives the rotation)
+ * and runs no seal backstop: with the document edit still ahead, there is no
+ * removal to seal against, and on the last-client transition the rotation
+ * itself is the one ladder-signed append its anchor licenses.
  */
 import type { DIDDoc, DIDLog } from '@interop/did-method-webvh';
 import type { IKeyAgreementKey } from '@interop/data-integrity-core';
@@ -67,8 +82,11 @@ export interface CascadeCollections {
     isEncrypted?: (collectionId: string) => Promise<boolean>;
 }
 /**
- * What the shared tail reports: whether the roster actually rotated on this
- * run (a re-run of an already-complete ceremony reports `false`), the roster's
+ * What the shared tail reports: whether the roster rotated on this run -- a
+ * re-run of an already-complete ceremony reports `false`; the
+ * document-converging entry point reads it off the adopting read, so a
+ * caller holding no cached key sees `true` on its first read either way,
+ * while the recipient-retiring one reports whether THIS call appended -- the roster's
  * seal-backstop report (present when the roster store is sealable and the
  * roster stage ran), the per-collection fan-out result, and the rotated key
  * with the roster descriptor it was read from.
@@ -80,6 +98,41 @@ export interface RosterCascadeResult {
     userKey?: UserKey;
     rosterDescriptor?: CollectionEncryption;
 }
+/**
+ * The post-edit anchoring guarantee, shared by both entry points: the roster
+ * appends -- and the seal backstop's removal detection -- must run under a
+ * controller view that includes the log the ceremony is anchoring at, or the
+ * rotation anchors before it (a revocation's rotation leaves the log
+ * unsealed with the seal blind to the removal; the last-client transition's
+ * ladder-signed rotation lands before its reinstall version and the
+ * ceremony-tail license refuses it). Rather than leaving that to the
+ * injected store's own controller wiring, the view built from the ceremony's
+ * log is set as the store's minimum controller version; a fresher resolved
+ * view still wins. A store that is not log-governed has no controller view
+ * to anchor and is left alone. Exported for the one caller that reads the
+ * roster before its anchoring entry exists (the last-client transition's
+ * pre-pair probe, anchored at the pre-transition head it verified).
+ *
+ * @param options {object}
+ * @param options.rosterStore {EncryptionDescriptorStore}
+ * @param options.did {string}
+ * @param options.log {DIDLog}
+ */
+export declare function anchorRosterStoreAt({ rosterStore, did, log }: {
+    rosterStore: EncryptionDescriptorStore;
+    did: string;
+    log: DIDLog;
+}): void;
+/**
+ * Persists a rotated key: called with `{ userKey, latestEpochId, descriptor }`
+ * after the roster read and BEFORE the fan-out. The key and the epoch pin
+ * must persist atomically.
+ */
+export type UserKeyAdoptedHook = (adopted: {
+    userKey: UserKey;
+    latestEpochId: string;
+    descriptor: CollectionEncryption;
+}) => Promise<void>;
 /**
  * Runs the roster rotation (with its seal backstop) and the collection
  * fan-out over the document a ceremony's own edit just published. See the
@@ -90,16 +143,15 @@ export interface RosterCascadeResult {
  *   `key-map/user-key.jsonl` roster store
  * @param options.did {string}   the account's did:webvh
  * @param options.doc {DIDDoc}   the document as the ceremony's edit left it
- * @param options.log {DIDLog}   the post-edit log, which the controller floor
- *   is built from
+ * @param options.log {DIDLog}   the post-edit log, which the minimum
+ *   controller version is built from
  * @param [options.userKey] {UserKey}   this client's cached user key
  * @param options.clientKeyAgreementKey {IKeyAgreementKey}   this client's own
  *   (identity) key-agreement key -- its roster entry
  * @param [options.pinnedEpochId] {string}   the locally pinned latest-seen
  *   roster epoch
- * @param [options.onUserKeyAdopted] {Function}   persists a rotated key:
- *   called with `{ userKey, latestEpochId, descriptor }` after the roster read
- *   and BEFORE the fan-out. The key and the epoch pin must persist atomically
+ * @param [options.onUserKeyAdopted] {UserKeyAdoptedHook}   persists a
+ *   rotated key
  * @param options.collections {CascadeCollections}   the fan-out's work
  * @returns {Promise<RosterCascadeResult>}
  */
@@ -111,11 +163,60 @@ export declare function rotateRosterToDocumentAndCascade({ rosterStore, did, doc
     userKey?: UserKey;
     clientKeyAgreementKey: IKeyAgreementKey;
     pinnedEpochId?: string | null;
-    onUserKeyAdopted?: (adopted: {
-        userKey: UserKey;
-        latestEpochId: string;
-        descriptor: CollectionEncryption;
-    }) => Promise<void>;
+    onUserKeyAdopted?: UserKeyAdoptedHook;
+    collections: CascadeCollections;
+}): Promise<RosterCascadeResult>;
+/**
+ * The recipient-naming entry point: retires ONE named roster recipient and
+ * runs the collection fan-out, for a ceremony that rotates BEFORE its own
+ * document edit (see the module doc). The document handed in still keys the
+ * retiring recipient, so the rotation names its kid explicitly; the fresh key
+ * is read back through `readBackKeyAgreementKey`, a recipient whose wrap
+ * survives the rotation (the standing credential's, on both forgets). No
+ * seal backstop runs here.
+ *
+ * Every stage detects its own completion from durable state: a recipient the
+ * current epoch no longer wraps to skips the append (so a re-run of a
+ * torn-after-rotation ceremony attempts no second append at the same anchor,
+ * which on a ladder-signed roster the one-shot license would refuse), the
+ * read-back adopts whatever the roster now delivers, and the fan-out is
+ * staleness-driven. An account with no roster yet reports `rotated: false`
+ * with an empty fan-out and no key.
+ *
+ * @param options {object}
+ * @param options.rosterStore {EncryptionDescriptorStore}   the
+ *   `key-map/user-key.jsonl` roster store
+ * @param options.did {string}   the account's did:webvh
+ * @param options.doc {DIDDoc}   the document the rotation's recipients are
+ *   resolved from -- the one `log` resolves to
+ * @param options.log {DIDLog}   the log the rotation anchors at, which the
+ *   minimum controller version is built from: the pre-edit head for a plain
+ *   forget, the post-reinstall head for the last-client transition
+ * @param options.retireRecipientId {string}   the roster kid to retire
+ * @param [options.userKey] {UserKey}   this client's cached user key
+ * @param options.readBackKeyAgreementKey {IKeyAgreementKey}   the recipient
+ *   whose wrap survives the rotation, reading the fresh key back and
+ *   unwrapping the generations for the fan-out
+ * @param [options.pinnedEpochId] {string}   the locally pinned latest-seen
+ *   roster epoch
+ * @param [options.onUserKeyAdopted] {UserKeyAdoptedHook}   persists a
+ *   rotated key
+ * @param options.collections {CascadeCollections}   the fan-out's work
+ * @returns {Promise<RosterCascadeResult>}   `rotated` says whether THIS run
+ *   retired the recipient's wrap; `rosterSeal` is never present
+ * @throws {UserKeyRosterIntegrityError}   the roster's `currentEpoch` names
+ *   no epoch in its own list
+ */
+export declare function retireRosterRecipientAndCascade({ rosterStore, did, doc, log, retireRecipientId, userKey, readBackKeyAgreementKey, pinnedEpochId, onUserKeyAdopted, collections }: {
+    rosterStore: EncryptionDescriptorStore;
+    did: string;
+    doc: DIDDoc;
+    log: DIDLog;
+    retireRecipientId: string;
+    userKey?: UserKey;
+    readBackKeyAgreementKey: IKeyAgreementKey;
+    pinnedEpochId?: string | null;
+    onUserKeyAdopted?: UserKeyAdoptedHook;
     collections: CascadeCollections;
 }): Promise<RosterCascadeResult>;
 //# sourceMappingURL=userKeyRosterCascade.d.ts.map

package/dist/keys/userKeyRosterCascade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"userKeyRosterCascade.d.ts","sourceRoot":"","sources":["../../src/keys/userKeyRosterCascade.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AAExE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAA;AAM5B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;IACrC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACnD,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,yBAAyB,CAAA;IAC7D,WAAW,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACzD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,WAAW,EAAE,oBAAoB,CAAA;IACjC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,gBAAgB,CAAC,EAAE,oBAAoB,CAAA;CACxC;AAqBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,gCAAgC,CAAC,EACrD,WAAW,EACX,GAAG,EACH,GAAG,EACH,GAAG,EACH,OAAO,EACP,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACZ,EAAE;IACD,WAAW,EAAE,yBAAyB,CAAA;IACtC,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qBAAqB,EAAE,gBAAgB,CAAA;IACvC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE;QAC3B,OAAO,EAAE,OAAO,CAAA;QAChB,aAAa,EAAE,MAAM,CAAA;QACrB,UAAU,EAAE,oBAAoB,CAAA;KACjC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnB,WAAW,EAAE,kBAAkB,CAAA;CAChC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqF/B"}
+{"version":3,"file":"userKeyRosterCascade.d.ts","sourceRoot":"","sources":["../../src/keys/userKeyRosterCascade.ts"],"names":[],"mappings":"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"}