@interop/wallet-core 0.109.0 → 0.110.0

package/dist/clientAnnex/log.d.ts

@@ -630,6 +630,139 @@ export declare function generationDelegationServiceEntry({ clientAnnexDid, deleg
 export declare function embeddedGenerationDelegation({ doc }: {
     doc: DIDDoc;
 }): IZcap | undefined;
+/**
+ * The type IRI of the annex document's replica pointer entries: one entry per
+ * replica server the account registers, each naming that server's DID. The
+ * term is the PWS companion spec's, since replication is its domain.
+ * Wire-level and permanent (app-connect-spec decision 0001): the source
+ * server gates a ladder-signed pull on it, and readers dispatch on this IRI
+ * rather than on the entry's fragment id.
+ */
+export declare const REPLICA_SERVER_SERVICE_TYPE = "https://w3id.org/pws#ReplicaServer";
+/**
+ * Refuses, with a `TypeError`, a replica server DID that is not a did:webvh
+ * whose path is `space:server:id` (app-connect-spec decision 0003, predicate
+ * 6: the source server checks the grantee's shape beside the pointer). A
+ * malformed value would land permanently in a hash-chained annex entry the
+ * server refuses anyway, so the wallet refuses it before minting the entry.
+ *
+ * @param options {object}
+ * @param options.serverDid {string}
+ */
+export declare function assertReplicaServerDid({ serverDid }: {
+    serverDid: string;
+}): void;
+/**
+ * The fragment id of a replica pointer entry: `replica-` followed by the
+ * SHA-256 multihash of the replica server's DID string (its UTF-8 bytes),
+ * base64url with no padding. Derived rather than random, so one server's
+ * entry has the same id on every restate. Wire-level and permanent; readers
+ * still dispatch on {@link REPLICA_SERVER_SERVICE_TYPE}.
+ *
+ * @param options {object}
+ * @param options.serverDid {string}   the replica server's DID
+ * @returns {string}   the fragment, without the `#`
+ */
+export declare function replicaServerServiceFragment({ serverDid }: {
+    serverDid: string;
+}): string;
+/**
+ * Builds a replica pointer entry for an annex document. The
+ * `serviceEndpoint` is the replica server's bare DID STRING, and the entry
+ * carries nothing beside it. Refuses a malformed `serverDid`
+ * ({@link assertReplicaServerDid}).
+ *
+ * @param options {object}
+ * @param options.clientAnnexDid {string}   the generation's annex DID
+ * @param options.serverDid {string}   the replica server's DID
+ * @returns {ServiceEndpoint}
+ */
+export declare function replicaServerServiceEntry({ clientAnnexDid, serverDid }: {
+    clientAnnexDid: string;
+    serverDid: string;
+}): ServiceEndpoint;
+/**
+ * The replica servers an annex document points at: the `serviceEndpoint` of
+ * every entry whose `type` names (or includes)
+ * {@link REPLICA_SERVER_SERVICE_TYPE}, in document order, each DID once.
+ * Only a bare DID-string endpoint counts, the same predicate the server's
+ * replica-pointer clause evaluates, so wallet and server read the same
+ * pointer set off one document.
+ *
+ * @param options {object}
+ * @param options.doc {DIDDoc}   the resolved (and verified) annex document
+ * @returns {string[]}
+ */
+export declare function replicaServerPointers({ doc }: {
+    doc: DIDDoc;
+}): string[];
+/**
+ * Whether an annex document carries a replica pointer at `serverDid`: a
+ * replica pointer entry whose endpoint is the server's DID. The match is by
+ * endpoint alone, the one the server's replica-pointer clause makes; an
+ * entry's fragment id is a selector and names no server.
+ *
+ * @param options {object}
+ * @param options.doc {DIDDoc}   the resolved (and verified) annex document
+ * @param options.serverDid {string}   the replica server's DID
+ * @returns {boolean}
+ */
+export declare function replicaServerPointerStands({ doc, serverDid }: {
+    doc: DIDDoc;
+    serverDid: string;
+}): boolean;
+/**
+ * The replica servers of `serverDids`, each once, that an annex document
+ * carries no pointer at ({@link replicaServerPointerStands}). The set the
+ * installing entry adds, and what a caller whose install pass published
+ * nothing reads off the head that pass stood on.
+ *
+ * @param options {object}
+ * @param options.doc {DIDDoc}
+ * @param options.serverDids {string[]}
+ * @returns {string[]}
+ */
+export declare function replicaServersMissing({ doc, serverDids }: {
+    doc: DIDDoc;
+    serverDids: string[];
+}): string[];
+/**
+ * The service entries the entry installing a generation delegation writes
+ * beside it, computed over the document as published so an installer can
+ * skip what the document already carries and refuse what collides. The one
+ * hook every installing writer forwards, so an install-time convention (the
+ * replica pointers, {@link replicaPointerInstaller}) is wired once rather
+ * than once per layer, and the layers between the caller and the install
+ * entry learn nothing about it. Invoked only by the entry that installs the
+ * delegation; every other entry ignores it.
+ */
+export type InstalledServices = (options: {
+    doc: DIDDoc;
+    clientAnnexDid: string;
+}) => ServiceEndpoint[];
+/**
+ * An {@link InstalledServices} hook that points the generation at
+ * `serverDids`: a replica pointer entry for each one the document does not
+ * already carry ({@link replicaServerPointerStands}). Every standing entry,
+ * replica pointers among them, is carried through untouched: the hook only
+ * adds, since dropping a pointer is the replica pass's decision, made against
+ * the connections directory.
+ *
+ * The hook refuses, before any entry is minted, a malformed server DID
+ * ({@link assertReplicaServerDid}) with a `TypeError`, standing ones
+ * included, and with an `Error` a document that already carries a service
+ * entry under the id an added pointer would take (one of another type,
+ * another endpoint, or an endpoint that is not a DID string): a second entry
+ * under one id is a document no resolver admits, and the entry standing
+ * there was not written by this hook.
+ *
+ * @param options {object}
+ * @param options.serverDids {string[]}   the replica servers to point at
+ * @returns {InstalledServices}
+ */
+export declare function replicaPointerInstaller({ serverDids }: {
+    serverDids: string[];
+}): InstalledServices;
 /**
  * Every generation delegation a generation's log has ever embedded, in log
  * order and deduplicated by zcap id -- the annex-log HISTORY WALK the
@@ -896,9 +1029,13 @@ export declare function readClientAnnexLogOrAbsent({ store, expectedDid }: {
  *   delegation this entry installs when it publishes the generation's FIRST
  *   transient verification method (and the document carries no delegation
  *   entry yet). Never invoked otherwise: the delegation is installed with
- *   the first transient VM or by the GC ceremony's own install stage, never
- *   by genesis (a genesis-embedded signed zcap can never verify -- its
+ *   the first transient VM or by the GC ceremony's own install stage, and
+ *   not by genesis (a genesis-embedded signed zcap can never verify -- its
  *   `controller` embeds the SCID the genesis hash derives from)
+ * @param [options.installedServices] {InstalledServices}   the service
+ *   entries the installing entry writes beside the delegation (the replica
+ *   pointers, {@link replicaPointerInstaller}). Invoked only by the entry
+ *   that installs the delegation; ignored on every other entry
  * @param [options.expectedDid] {string}   the annex DID the log must
  *   resolve to, from the account document's pointer. The read and the publish
  *   run under the store's own chain-head pin
@@ -920,6 +1057,7 @@ export declare function enrollClientAnnexTransientClient({ published: threadedHe
     mintGenerationDelegation?: (options: {
         clientAnnexDid: string;
     }) => Promise<IZcap>;
+    installedServices?: InstalledServices;
     expectedDid?: string;
     published?: PublishedWebvhLog;
 }): Promise<{
@@ -1083,6 +1221,9 @@ export declare function setDelegatedClientsPointerOnce({ idStore, signer, client
  *   {@link enrollClientAnnexTransientClient}). The closure receives whichever
  *   annex DID the round enrolls into, so a GC-race re-enroll mints for
  *   the fresh generation
+ * @param [options.installedServices] {InstalledServices}   forwarded to
+ *   the enrollment entry: what the installing entry writes beside the
+ *   delegation
  * @param [options.maxRounds] {number}   how many pointer moves to chase
  *   before giving up (a GC pass is quarterly, so more than one mid-ceremony
  *   move means something else is wrong)
@@ -1094,7 +1235,7 @@ export declare function setDelegatedClientsPointerOnce({ idStore, signer, client
  *   every later round does
  * @returns {Promise<{ clientAnnexDid: string, doc: DIDDoc, log: DIDLog }>}
  */
-export declare function enrollTransientClient({ readAccountDocument, storeForGenerationId, ladderSeed, transientKeyMultibase, mintGenerationDelegation: mintDelegation, maxRounds, published: threadedHead }: {
+export declare function enrollTransientClient({ readAccountDocument, storeForGenerationId, ladderSeed, transientKeyMultibase, mintGenerationDelegation: mintDelegation, installedServices, maxRounds, published: threadedHead }: {
     readAccountDocument: () => Promise<DIDDoc>;
     storeForGenerationId: (generationId: string) => ClientAnnexWriteStore;
     ladderSeed: Uint8Array;
@@ -1102,6 +1243,7 @@ export declare function enrollTransientClient({ readAccountDocument, storeForGen
     mintGenerationDelegation?: (options: {
         clientAnnexDid: string;
     }) => Promise<IZcap>;
+    installedServices?: InstalledServices;
     maxRounds?: number;
     published?: PublishedWebvhLog;
 }): Promise<{
@@ -1150,6 +1292,10 @@ export declare function enrollTransientClient({ readAccountDocument, storeForGen
  *   generation's standing set, restated in the fresh genesis (see
  *   {@link mintCredentialClientAnnexGeneration}); absent on a first
  *   generation and wherever no superseded log was readable
+ * @param [options.installedServices] {InstalledServices}   what the
+ *   install entry writes beside the delegation, the restated replica pointers
+ *   ({@link replicaPointerInstaller}); absent on a first generation and
+ *   wherever the caller holds no list
  * @param [options.beforePointerEntry] {Function}
  *   `({ minted }) => Promise<void>` -- runs after the install and before the
  *   pointer entry, with the mint's published head (its `spaceDescription`
@@ -1158,7 +1304,7 @@ export declare function enrollTransientClient({ readAccountDocument, storeForGen
  * @returns {Promise<{ clientAnnexDid: string, generationDelegation: IZcap,
  *   pointed: T }>}
  */
-export declare function mintPointedClientAnnexGeneration<T>({ was, baseServerUrl, spaceId, controller, ladderSeed, mintGenerationDelegation, point, pinStore, capability, standingRungHashes, beforePointerEntry, now }: {
+export declare function mintPointedClientAnnexGeneration<T>({ was, baseServerUrl, spaceId, controller, ladderSeed, mintGenerationDelegation, point, pinStore, capability, standingRungHashes, installedServices, beforePointerEntry, now }: {
     was: WasClient;
     baseServerUrl: string;
     spaceId: string;
@@ -1171,6 +1317,7 @@ export declare function mintPointedClientAnnexGeneration<T>({ was, baseServerUrl
     pinStore: ResourceLogPinStore;
     capability?: IZcap;
     standingRungHashes?: string[];
+    installedServices?: InstalledServices;
     beforePointerEntry?: (options: {
         minted: Awaited<ReturnType<typeof mintCredentialClientAnnexGeneration>>;
     }) => Promise<void>;
@@ -1237,6 +1384,14 @@ export declare function mintPointedClientAnnexGeneration<T>({ was, baseServerUrl
  *   its own ladder VM (whose delegations it revokes server-side in the next
  *   breath, a state no client-side predicate can read) and the client its
  *   removal entry has yet to strike
+ * @param [options.installedServices] {InstalledServices}   the service
+ *   entries the installing entry writes beside the delegation, the replica
+ *   pointers ({@link replicaPointerInstaller}): a fresh generation's install
+ *   stage writes them beside the delegation, and a renewal on a live
+ *   generation adds what the document lacks and keeps every standing entry
+ *   through the prior-state clone. A pass that publishes nothing never
+ *   invokes the hook; the caller reads what the head still lacks off the
+ *   `published` it hands back ({@link replicaServersMissing})
  * @param [options.now] {number}   epoch milliseconds, for tests
  * @param [options.published] {PublishedWebvhLog}   a head the caller already
  *   read and verified under this same pin slot, so the stage builds on it
@@ -1265,6 +1420,7 @@ export declare function ensureGenerationDelegationCurrent({ published: threadedH
     expectedDid?: string;
     accountDoc?: PublishedKeyDocument;
     retiringKeyMultibases?: string[];
+    installedServices?: InstalledServices;
     now?: number;
     published?: PublishedWebvhLog;
 }): Promise<{

package/dist/clientAnnex/log.d.ts.map

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

package/dist/clientAnnex/log.js

@@ -27,10 +27,13 @@
  *   portability move.
  * - The genesis document is bare -- no verification methods, no service
  *   entries, the DID core context only. Transient verification methods are
- *   published per visit by later entries, and the generation delegation's
- *   service entry is installed by the entry publishing the generation's first
- *   transient method, never by genesis (its bytes would have to name the SCID
- *   the genesis hash derives from).
+ *   published per visit by later entries. The entry that installs the
+ *   generation delegation (the swap's install stage, or the entry publishing
+ *   the generation's first transient method) also carries the generation's
+ *   replica pointers, one entry per replica server the caller restates.
+ *   Genesis carries neither: the delegation's bytes would have to name the
+ *   SCID the genesis hash derives from, and the pointers ride the same entry
+ *   so a generation with no delegation points at no replica.
  * - No `did:web` projection exists: the generation collection holds only its
  *   `did.jsonl`, capability-gated rather than world-readable.
  *
@@ -47,9 +50,12 @@
  * generation collection's name, and the annex DID string embeds it.
  */
 import { createDID, deriveNextKeyHash, updateDID } from '@interop/did-method-webvh';
+import { createMultihash, MultihashAlgorithm } from '@interop/data-integrity-core/multihash';
 import { rootCapabilityId, spaceUrlById } from '@interop/was-client/paths';
+import { sha256 } from '@noble/hashes/sha2.js';
 import { base64urlnopad } from '@scure/base';
 import { isJsonObject } from '../jsonObject.js';
+import { ID_COLLECTION } from '../space/collections.js';
 import { plaintextCollection } from '../space/plaintextCollection.js';
 import { clientAnnexRung } from './generationRung.js';
 import { ladderRung } from '../webvh/ladderDerivation.js';
@@ -1018,6 +1024,187 @@ export function embeddedGenerationDelegation({ doc }) {
         endpoint: 'map'
     });
 }
+/**
+ * The type IRI of the annex document's replica pointer entries: one entry per
+ * replica server the account registers, each naming that server's DID. The
+ * term is the PWS companion spec's, since replication is its domain.
+ * Wire-level and permanent (app-connect-spec decision 0001): the source
+ * server gates a ladder-signed pull on it, and readers dispatch on this IRI
+ * rather than on the entry's fragment id.
+ */
+export const REPLICA_SERVER_SERVICE_TYPE = 'https://w3id.org/pws#ReplicaServer';
+/**
+ * The Space id a replica server publishes its own did:webvh log under.
+ */
+const REPLICA_SERVER_SPACE_ID = 'server';
+/**
+ * Refuses, with a `TypeError`, a replica server DID that is not a did:webvh
+ * whose path is `space:server:id` (app-connect-spec decision 0003, predicate
+ * 6: the source server checks the grantee's shape beside the pointer). A
+ * malformed value would land permanently in a hash-chained annex entry the
+ * server refuses anyway, so the wallet refuses it before minting the entry.
+ *
+ * @param options {object}
+ * @param options.serverDid {string}
+ */
+export function assertReplicaServerDid({ serverDid }) {
+    let location;
+    try {
+        location = didWebvhLogLocation({ did: serverDid });
+    }
+    catch {
+        location = undefined;
+    }
+    if (location === undefined ||
+        location.spaceId !== REPLICA_SERVER_SPACE_ID ||
+        location.collectionId !== ID_COLLECTION.id) {
+        throw new TypeError('A replica server DID is a did:webvh whose path is ' +
+            `space:${REPLICA_SERVER_SPACE_ID}:${ID_COLLECTION.id}; got ` +
+            `"${serverDid}".`);
+    }
+}
+/**
+ * The fragment id of a replica pointer entry: `replica-` followed by the
+ * SHA-256 multihash of the replica server's DID string (its UTF-8 bytes),
+ * base64url with no padding. Derived rather than random, so one server's
+ * entry has the same id on every restate. Wire-level and permanent; readers
+ * still dispatch on {@link REPLICA_SERVER_SERVICE_TYPE}.
+ *
+ * @param options {object}
+ * @param options.serverDid {string}   the replica server's DID
+ * @returns {string}   the fragment, without the `#`
+ */
+export function replicaServerServiceFragment({ serverDid }) {
+    const digest = sha256(new TextEncoder().encode(serverDid));
+    const multihash = createMultihash(digest, MultihashAlgorithm.SHA2_256);
+    return `replica-${base64urlnopad.encode(multihash)}`;
+}
+/**
+ * Builds a replica pointer entry for an annex document. The
+ * `serviceEndpoint` is the replica server's bare DID STRING, and the entry
+ * carries nothing beside it. Refuses a malformed `serverDid`
+ * ({@link assertReplicaServerDid}).
+ *
+ * @param options {object}
+ * @param options.clientAnnexDid {string}   the generation's annex DID
+ * @param options.serverDid {string}   the replica server's DID
+ * @returns {ServiceEndpoint}
+ */
+export function replicaServerServiceEntry({ clientAnnexDid, serverDid }) {
+    assertReplicaServerDid({ serverDid });
+    return {
+        id: `${clientAnnexDid}#${replicaServerServiceFragment({ serverDid })}`,
+        type: REPLICA_SERVER_SERVICE_TYPE,
+        serviceEndpoint: serverDid
+    };
+}
+/**
+ * The replica servers an annex document points at: the `serviceEndpoint` of
+ * every entry whose `type` names (or includes)
+ * {@link REPLICA_SERVER_SERVICE_TYPE}, in document order, each DID once.
+ * Only a bare DID-string endpoint counts, the same predicate the server's
+ * replica-pointer clause evaluates, so wallet and server read the same
+ * pointer set off one document.
+ *
+ * @param options {object}
+ * @param options.doc {DIDDoc}   the resolved (and verified) annex document
+ * @returns {string[]}
+ */
+export function replicaServerPointers({ doc }) {
+    return [
+        ...new Set(serviceEntriesWith({
+            doc,
+            type: REPLICA_SERVER_SERVICE_TYPE,
+            endpoint: 'string'
+        }).map(entry => entry.serviceEndpoint))
+    ];
+}
+/**
+ * Whether an annex document carries a replica pointer at `serverDid`: a
+ * replica pointer entry whose endpoint is the server's DID. The match is by
+ * endpoint alone, the one the server's replica-pointer clause makes; an
+ * entry's fragment id is a selector and names no server.
+ *
+ * @param options {object}
+ * @param options.doc {DIDDoc}   the resolved (and verified) annex document
+ * @param options.serverDid {string}   the replica server's DID
+ * @returns {boolean}
+ */
+export function replicaServerPointerStands({ doc, serverDid }) {
+    return replicaServerPointers({ doc }).includes(serverDid);
+}
+/**
+ * The replica servers of `serverDids`, each once, that an annex document
+ * carries no pointer at ({@link replicaServerPointerStands}). The set the
+ * installing entry adds, and what a caller whose install pass published
+ * nothing reads off the head that pass stood on.
+ *
+ * @param options {object}
+ * @param options.doc {DIDDoc}
+ * @param options.serverDids {string[]}
+ * @returns {string[]}
+ */
+export function replicaServersMissing({ doc, serverDids }) {
+    const standing = new Set(replicaServerPointers({ doc }));
+    return [...new Set(serverDids)].filter(serverDid => !standing.has(serverDid));
+}
+/**
+ * An {@link InstalledServices} hook that points the generation at
+ * `serverDids`: a replica pointer entry for each one the document does not
+ * already carry ({@link replicaServerPointerStands}). Every standing entry,
+ * replica pointers among them, is carried through untouched: the hook only
+ * adds, since dropping a pointer is the replica pass's decision, made against
+ * the connections directory.
+ *
+ * The hook refuses, before any entry is minted, a malformed server DID
+ * ({@link assertReplicaServerDid}) with a `TypeError`, standing ones
+ * included, and with an `Error` a document that already carries a service
+ * entry under the id an added pointer would take (one of another type,
+ * another endpoint, or an endpoint that is not a DID string): a second entry
+ * under one id is a document no resolver admits, and the entry standing
+ * there was not written by this hook.
+ *
+ * @param options {object}
+ * @param options.serverDids {string[]}   the replica servers to point at
+ * @returns {InstalledServices}
+ */
+export function replicaPointerInstaller({ serverDids }) {
+    return ({ doc, clientAnnexDid }) => {
+        for (const serverDid of serverDids) {
+            assertReplicaServerDid({ serverDid });
+        }
+        const added = replicaServersMissing({ doc, serverDids }).map(serverDid => replicaServerServiceEntry({ clientAnnexDid, serverDid }));
+        const taken = new Set((doc.service ?? []).map(entry => entry.id));
+        for (const entry of added) {
+            if (taken.has(entry.id)) {
+                throw new Error(`client annex: the document already carries a service entry at ` +
+                    `"${entry.id}" that is not the replica pointer at ` +
+                    `"${entry.serviceEndpoint}"; nothing was written.`);
+            }
+        }
+        return added;
+    };
+}
+/**
+ * The service list the entry installing a generation delegation publishes:
+ * the delegation entry ({@link withGenerationDelegationEntry}) followed by
+ * whatever the caller's {@link InstalledServices} hook adds. The one
+ * composition both installing writers run, so an install-time entry can
+ * never land in an entry other than the delegation's.
+ *
+ * @param options {object}
+ * @param options.doc {DIDDoc}   the annex document as published
+ * @param options.clientAnnexDid {string}
+ * @param options.delegation {IZcap}
+ * @param [options.installedServices] {InstalledServices}
+ * @returns {ServiceEndpoint[]}
+ */
+function withInstalledEntries({ doc, clientAnnexDid, delegation, installedServices }) {
+    return [
+        ...withGenerationDelegationEntry({ doc, clientAnnexDid, delegation }),
+        ...(installedServices?.({ doc, clientAnnexDid }) ?? [])
+    ];
+}
 /**
  * Every generation delegation a generation's log has ever embedded, in log
  * order and deduplicated by zcap id -- the annex-log HISTORY WALK the
@@ -1393,9 +1580,13 @@ export async function readClientAnnexLogOrAbsent({ store, expectedDid }) {
  *   delegation this entry installs when it publishes the generation's FIRST
  *   transient verification method (and the document carries no delegation
  *   entry yet). Never invoked otherwise: the delegation is installed with
- *   the first transient VM or by the GC ceremony's own install stage, never
- *   by genesis (a genesis-embedded signed zcap can never verify -- its
+ *   the first transient VM or by the GC ceremony's own install stage, and
+ *   not by genesis (a genesis-embedded signed zcap can never verify -- its
  *   `controller` embeds the SCID the genesis hash derives from)
+ * @param [options.installedServices] {InstalledServices}   the service
+ *   entries the installing entry writes beside the delegation (the replica
+ *   pointers, {@link replicaPointerInstaller}). Invoked only by the entry
+ *   that installs the delegation; ignored on every other entry
  * @param [options.expectedDid] {string}   the annex DID the log must
  *   resolve to, from the account document's pointer. The read and the publish
  *   run under the store's own chain-head pin
@@ -1423,7 +1614,7 @@ export async function enrollClientAnnexTransientClient({ published: threadedHead
  * @param options {object}   see {@link enrollClientAnnexTransientClient}
  * @returns {Promise<{ did: string, doc: DIDDoc, log: DIDLog }>}
  */
-async function enrollClientAnnexTransientClientOnce({ store, ladderSeed, transientKeyMultibase, services, mintGenerationDelegation: mintDelegation, expectedDid, published: alreadyRead }) {
+async function enrollClientAnnexTransientClientOnce({ store, ladderSeed, transientKeyMultibase, services, mintGenerationDelegation: mintDelegation, installedServices, expectedDid, published: alreadyRead }) {
     const published = alreadyRead !== undefined
         ? assertPublishedLogDid({
             published: alreadyRead,
@@ -1457,16 +1648,18 @@ async function enrollClientAnnexTransientClientOnce({ store, ladderSeed, transie
     // The generation delegation installs with the first transient VM (never at
     // genesis): a delegation-less document about to receive its first method
     // gets the entry minted and appended here, so a generation with no visits
-    // never carries a delegation and stays authorization-inert.
+    // never carries a delegation and stays authorization-inert. The replica
+    // pointers ride the same entry.
     if (services === undefined &&
         mintDelegation !== undefined &&
         existingMethods.length === 0 &&
         embeddedGenerationDelegation({ doc }) === undefined) {
         const delegation = await mintDelegation({ clientAnnexDid: did });
-        services = withGenerationDelegationEntry({
+        services = withInstalledEntries({
             doc,
             clientAnnexDid: did,
-            delegation
+            delegation,
+            ...(installedServices !== undefined ? { installedServices } : {})
         });
     }
     const transientMethod = {
@@ -1712,6 +1905,9 @@ export async function setDelegatedClientsPointerOnce({ idStore, signer, clientAn
  *   {@link enrollClientAnnexTransientClient}). The closure receives whichever
  *   annex DID the round enrolls into, so a GC-race re-enroll mints for
  *   the fresh generation
+ * @param [options.installedServices] {InstalledServices}   forwarded to
+ *   the enrollment entry: what the installing entry writes beside the
+ *   delegation
  * @param [options.maxRounds] {number}   how many pointer moves to chase
  *   before giving up (a GC pass is quarterly, so more than one mid-ceremony
  *   move means something else is wrong)
@@ -1723,7 +1919,7 @@ export async function setDelegatedClientsPointerOnce({ idStore, signer, clientAn
  *   every later round does
  * @returns {Promise<{ clientAnnexDid: string, doc: DIDDoc, log: DIDLog }>}
  */
-export async function enrollTransientClient({ readAccountDocument, storeForGenerationId, ladderSeed, transientKeyMultibase, mintGenerationDelegation: mintDelegation, maxRounds = 3, published: threadedHead }) {
+export async function enrollTransientClient({ readAccountDocument, storeForGenerationId, ladderSeed, transientKeyMultibase, mintGenerationDelegation: mintDelegation, installedServices, maxRounds = 3, published: threadedHead }) {
     let accountDoc = await readAccountDocument();
     for (let round = 0; round < maxRounds; round++) {
         const clientAnnexDid = delegatedClientsPointer({ doc: accountDoc });
@@ -1746,7 +1942,8 @@ export async function enrollTransientClient({ readAccountDocument, storeForGener
             ...(head !== undefined ? { published: head } : {}),
             ...(mintDelegation !== undefined
                 ? { mintGenerationDelegation: mintDelegation }
-                : {})
+                : {}),
+            ...(installedServices !== undefined ? { installedServices } : {})
         });
         // The GC-race re-read: an unchanged pointer means the enrollment stands
         // in the pointed generation; a moved one means a concurrent GC abandoned
@@ -1800,6 +1997,10 @@ export async function enrollTransientClient({ readAccountDocument, storeForGener
  *   generation's standing set, restated in the fresh genesis (see
  *   {@link mintCredentialClientAnnexGeneration}); absent on a first
  *   generation and wherever no superseded log was readable
+ * @param [options.installedServices] {InstalledServices}   what the
+ *   install entry writes beside the delegation, the restated replica pointers
+ *   ({@link replicaPointerInstaller}); absent on a first generation and
+ *   wherever the caller holds no list
  * @param [options.beforePointerEntry] {Function}
  *   `({ minted }) => Promise<void>` -- runs after the install and before the
  *   pointer entry, with the mint's published head (its `spaceDescription`
@@ -1808,7 +2009,7 @@ export async function enrollTransientClient({ readAccountDocument, storeForGener
  * @returns {Promise<{ clientAnnexDid: string, generationDelegation: IZcap,
  *   pointed: T }>}
  */
-export async function mintPointedClientAnnexGeneration({ was, baseServerUrl, spaceId, controller, ladderSeed, mintGenerationDelegation, point, pinStore, capability, standingRungHashes, beforePointerEntry, now }) {
+export async function mintPointedClientAnnexGeneration({ was, baseServerUrl, spaceId, controller, ladderSeed, mintGenerationDelegation, point, pinStore, capability, standingRungHashes, installedServices, beforePointerEntry, now }) {
     const minted = await mintCredentialClientAnnexGeneration({
         was,
         baseServerUrl,
@@ -1829,6 +2030,7 @@ export async function mintPointedClientAnnexGeneration({ was, baseServerUrl, spa
         }),
         ladderSeed,
         mintGenerationDelegation,
+        ...(installedServices !== undefined ? { installedServices } : {}),
         expectedDid: minted.did,
         ...(minted.etag !== undefined ? { published: minted } : {}),
         ...(now !== undefined ? { now } : {})
@@ -1900,6 +2102,14 @@ export async function mintPointedClientAnnexGeneration({ was, baseServerUrl, spa
  *   its own ladder VM (whose delegations it revokes server-side in the next
  *   breath, a state no client-side predicate can read) and the client its
  *   removal entry has yet to strike
+ * @param [options.installedServices] {InstalledServices}   the service
+ *   entries the installing entry writes beside the delegation, the replica
+ *   pointers ({@link replicaPointerInstaller}): a fresh generation's install
+ *   stage writes them beside the delegation, and a renewal on a live
+ *   generation adds what the document lacks and keeps every standing entry
+ *   through the prior-state clone. A pass that publishes nothing never
+ *   invokes the hook; the caller reads what the head still lacks off the
+ *   `published` it hands back ({@link replicaServersMissing})
  * @param [options.now] {number}   epoch milliseconds, for tests
  * @param [options.published] {PublishedWebvhLog}   a head the caller already
  *   read and verified under this same pin slot, so the stage builds on it
@@ -1934,7 +2144,7 @@ export async function ensureGenerationDelegationCurrent({ published: threadedHea
  * @returns {Promise<{ delegation: IZcap, renewed: boolean,
  *   published?: PublishedWebvhLog }>}
  */
-async function ensureGenerationDelegationCurrentOnce({ store, ladderSeed, mintGenerationDelegation: mintDelegation, expectedDid, accountDoc, retiringKeyMultibases = [], now, published: alreadyRead }) {
+async function ensureGenerationDelegationCurrentOnce({ store, ladderSeed, mintGenerationDelegation: mintDelegation, expectedDid, accountDoc, retiringKeyMultibases = [], installedServices, now, published: alreadyRead }) {
     const published = alreadyRead !== undefined
         ? assertPublishedLogDid({
             published: alreadyRead,
@@ -1975,13 +2185,15 @@ async function ensureGenerationDelegationCurrentOnce({ store, ladderSeed, mintGe
         // The writer's rung-0 key reveals at its first annex write, exactly
         // as the enrollment entry does; `nextKeyHashes` is re-stated verbatim,
         // never inherited. Verification methods, relationship arrays, and every
-        // other service entry ride the library's prior-state clone untouched.
+        // other service entry (the standing replica pointers among them) ride
+        // the library's prior-state clone untouched.
         updateKeys: [...new Set([...published.updateKeys, rung.keyMultibase])],
         nextKeyHashes: [...published.nextKeyHashes],
-        services: withGenerationDelegationEntry({
+        services: withInstalledEntries({
             doc,
             clientAnnexDid: did,
-            delegation: fresh
+            delegation: fresh,
+            ...(installedServices !== undefined ? { installedServices } : {})
         })
     });
     // The publish advances the store's chain-head pin to what it just wrote, so