@optimystic/db-p2p 0.14.1 → 0.16.3

package/dist/src/storage/restoration-coordinator-v2.js.map

@@ -1 +1 @@
-{"version":3,"file":"restoration-coordinator-v2.js","sourceRoot":"","sources":["../../../src/storage/restoration-coordinator-v2.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IAShB;IACA;IACA;IAEA;IAZD,OAAO,GAAG;QAC1B,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,IAAI,GAAG,EAAkB;QACxC,aAAa,EAAE,IAAI,GAAG,EAAkB;QACxC,iBAAiB,EAAE,CAAC;KACpB,CAAC;IAEF,YACkB,WAAiC,EACjC,WAAyB,EACzB,cAAsB;IACvC,iFAAiF;IAChE,UAAmB;QAJnB,gBAAW,GAAX,WAAW,CAAsB;QACjC,gBAAW,GAAX,WAAW,CAAc;QACzB,mBAAc,GAAd,cAAc,CAAQ;QAEtB,eAAU,GAAV,UAAU,CAAS;IAClC,CAAC;IAEa,GAAG,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;IAE1D;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAgB,EAAE,GAAY;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAE7B,yCAAyC;QACzC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAE1C,iFAAiF;QACjF,mFAAmF;QACnF,2DAA2D;QAC3D,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU;YACrC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC;YAC5C,CAAC,CAAC,OAAO,CAAC;QACX,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,GAAG,CAAC,mCAAmC,EAAE,OAAO,CAAC,CAAC;YACvD,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YAC3D,IAAI,OAAO,EAAE,CAAC;gBACb,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;gBACjE,OAAO,OAAO,CAAC;YAChB,CAAC;QACF,CAAC;QAED,gDAAgD;QAChD,KAAK,IAAI,SAAS,GAAG,WAAW,GAAG,CAAC,EAAE,SAAS,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC;YACnE,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAEjE,yFAAyF;YACzF,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC;iBAC/E,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC;YAEzD,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;gBAC1C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;gBAC9D,IAAI,OAAO,EAAE,CAAC;oBACb,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;oBAC/D,OAAO,OAAO,CAAC;gBAChB,CAAC;YACF,CAAC;QACF,CAAC;QAED,uBAAuB;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,wCAAwC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;QACrE,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,qBAAqB;QACpB,OAAO,KAAK,EAAE,OAAgB,EAAE,GAAY,EAAE,EAAE;YAC/C,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACzC,CAAC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,OAAgB;QAC5C,MAAM,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACK,cAAc;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC;QACrD,OAAO,MAAM,EAAE,SAAS,IAAI,CAAC,CAAC,CAAC,oBAAoB;IACpD,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,KAAe,EAAE,OAAgB,EAAE,SAAiB;QAC7E,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC,CAAC,2BAA2B;QAC1C,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAEhE,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACvD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAC;YAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,KAAK,WAAW,CAAC;QACnD,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,OAAgB,EAAE,IAAY;QACxD,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChD,gDAAgD;QAChD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9D,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACrB,CAAC;QAED,uBAAuB;QACvB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7B,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,CAAE,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC/C,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;QAC5B,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,OAAgB,EAAE,GAAY;QACxE,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,UAAU,CAC5B,MAAM,EACN,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,cAAc,CACnB,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;YAC7D,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,8BAA8B,EAAE,SAAS,EAAE,KAAK,CAAC,CAAA;YAC1D,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,SAAiB,EAAE,OAAgB,EAAE,UAAkB;QAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAErD,kCAAkC;QAClC,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;aACpE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,OAAO,CAAC,iBAAiB,GAAG,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,cAAc,CAAC;QAE3E,OAAO,CAAC,GAAG,CACV,SAAS,SAAS,iCAAiC,OAAO,OAAO,UAAU,IAAI,CAC/E,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QAMT,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;CACD"}
+{"version":3,"file":"restoration-coordinator-v2.js","sourceRoot":"","sources":["../../../src/storage/restoration-coordinator-v2.ts"],"names":[],"mappings":"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"}

package/dist/src/storage/restoration-coordinator.d.ts

@@ -0,0 +1,73 @@
+import type { BlockId } from '@optimystic/db-core';
+import type { BlockArchive, RestoreCallback } from './struct.js';
+import type { IPeerNetwork } from '@optimystic/db-core';
+import type { ArachnodeFretAdapter } from './arachnode-fret-adapter.js';
+/**
+ * Coordinates block restoration across discovered Arachnode storage rings.
+ *
+ * Queries rings in order of broader coverage (inner rings first):
+ * 1. Transaction ring peers (my ring)
+ * 2. Inner storage rings (Ring N-1, N-2, ..., Ring 0)
+ *
+ * Each ring is discovered dynamically via FRET neighbor snapshots.
+ */
+export declare class RestorationCoordinator {
+    private readonly fretAdapter;
+    private readonly peerNetwork;
+    private readonly protocolPrefix;
+    /** Optional self peer id — used to skip dialing self on solo/bootstrap nodes. */
+    private readonly selfPeerId?;
+    private readonly metrics;
+    constructor(fretAdapter: ArachnodeFretAdapter, peerNetwork: IPeerNetwork, protocolPrefix: string, 
+    /** Optional self peer id — used to skip dialing self on solo/bootstrap nodes. */
+    selfPeerId?: string | undefined);
+    private readonly log;
+    /**
+     * Restore a block by querying discovered storage rings.
+     */
+    restore(blockId: BlockId, rev?: number): Promise<BlockArchive | undefined>;
+    /**
+     * Create a RestoreCallback function that uses this coordinator.
+     */
+    createRestoreCallback(): RestoreCallback;
+    /**
+     * Get peers in my transaction ring for a given block.
+     * @param blockCoord the block id already hashed into the shared coordinate space.
+     */
+    private getMyRingPeers;
+    /**
+     * Get my own ring depth from Arachnode info.
+     */
+    private getMyRingDepth;
+    /**
+     * Filter peers by partition responsibility.
+     * @param blockCoord the block id hashed into the shared coordinate space (same space
+     *   RingSelector.calculatePartition uses for peer partitions).
+     */
+    private filterByPartition;
+    /**
+     * Query a specific peer for a block.
+     */
+    private queryPeer;
+    /**
+     * Record successful restoration from a ring.
+     */
+    private recordSuccess;
+    /**
+     * Record that a ring was queried during a restore but did not yield the block.
+     * Counterpart to {@link recordSuccess}: the ring — not the individual peer query — is the
+     * failure unit, so this increments once per exhausted ring at the points where the peer
+     * loops in {@link restore} complete without returning an archive.
+     */
+    private recordFailure;
+    /**
+     * Get restoration metrics for monitoring.
+     */
+    getMetrics(): {
+        totalRequests: number;
+        successByRing: Map<number, number>;
+        failureByRing: Map<number, number>;
+        averageDurationMs: number;
+    };
+}
+//# sourceMappingURL=restoration-coordinator.d.ts.map

package/dist/src/storage/restoration-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoration-coordinator.d.ts","sourceRoot":"","sources":["../../../src/storage/restoration-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAIxE;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IASjC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAZ7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAKtB;gBAGgB,WAAW,EAAE,oBAAoB,EACjC,WAAW,EAAE,YAAY,EACzB,cAAc,EAAE,MAAM;IACvC,iFAAiF;IAChE,UAAU,CAAC,EAAE,MAAM,YAAA;IAGrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsC;IAE1D;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IA4DhF;;OAEG;IACH,qBAAqB,IAAI,eAAe;IAMxC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;YACW,SAAS;IAiBvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,UAAU,IAAI;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,iBAAiB,EAAE,MAAM,CAAC;KAC1B;CAWD"}

package/dist/src/storage/restoration-coordinator.js

@@ -0,0 +1,181 @@
+import { hashKey } from 'p2p-fret';
+import { peerIdFromString } from '@libp2p/peer-id';
+import { SyncClient } from '../sync/client.js';
+import { partitionCovers } from './arachnode-partition.js';
+import { createLogger } from '../logger.js';
+/**
+ * Coordinates block restoration across discovered Arachnode storage rings.
+ *
+ * Queries rings in order of broader coverage (inner rings first):
+ * 1. Transaction ring peers (my ring)
+ * 2. Inner storage rings (Ring N-1, N-2, ..., Ring 0)
+ *
+ * Each ring is discovered dynamically via FRET neighbor snapshots.
+ */
+export class RestorationCoordinator {
+    fretAdapter;
+    peerNetwork;
+    protocolPrefix;
+    selfPeerId;
+    metrics = {
+        totalRequests: 0,
+        successByRing: new Map(),
+        failureByRing: new Map(),
+        averageDurationMs: 0
+    };
+    constructor(fretAdapter, peerNetwork, protocolPrefix, 
+    /** Optional self peer id — used to skip dialing self on solo/bootstrap nodes. */
+    selfPeerId) {
+        this.fretAdapter = fretAdapter;
+        this.peerNetwork = peerNetwork;
+        this.protocolPrefix = protocolPrefix;
+        this.selfPeerId = selfPeerId;
+    }
+    log = createLogger('storage:restoration');
+    /**
+     * Restore a block by querying discovered storage rings.
+     */
+    async restore(blockId, rev) {
+        const startTime = Date.now();
+        this.metrics.totalRequests++;
+        // Hash the block id once into the shared coordinate space. Peer responsibility
+        // (RingSelector.calculatePartition) and cohort assembly both operate on hashed
+        // coords, so restoration must filter in the same space — see getMyRingPeers and
+        // filterByPartition below, which reuse this value.
+        const blockCoord = await hashKey(new TextEncoder().encode(blockId));
+        // 1. Try my transaction ring peers first
+        const myPeers = this.getMyRingPeers(blockCoord);
+        const myRingDepth = this.getMyRingDepth();
+        // Avoid dialing self: on a solo/bootstrap node with no listenAddrs, dialing self
+        // either hangs or fails noisily. Filter self out of the ring-peer list so the loop
+        // below can no-op cleanly when self is the only candidate.
+        const nonSelfMyPeers = this.selfPeerId
+            ? myPeers.filter(p => p !== this.selfPeerId)
+            : myPeers;
+        if (nonSelfMyPeers.length === 0 && myRingDepth <= 0) {
+            this.log('restore:solo-node-skip blockId=%s', blockId);
+            return undefined;
+        }
+        for (const peerId of nonSelfMyPeers) {
+            const archive = await this.queryPeer(peerId, blockId, rev);
+            if (archive) {
+                this.recordSuccess(myRingDepth, blockId, Date.now() - startTime);
+                return archive;
+            }
+        }
+        // My transaction ring was queried and yielded nothing — count it as one ring failure.
+        this.recordFailure(myRingDepth);
+        // 2. Try inner storage rings (broader coverage)
+        for (let ringDepth = myRingDepth - 1; ringDepth >= 0; ringDepth--) {
+            const storagePeers = this.fretAdapter.findPeersAtRing(ringDepth);
+            // Filter to peers responsible for this block's partition (skip self — cannot dial self).
+            const responsiblePeers = this.filterByPartition(storagePeers, blockCoord, ringDepth)
+                .filter(p => !this.selfPeerId || p !== this.selfPeerId);
+            for (const peerIdStr of responsiblePeers) {
+                const archive = await this.queryPeer(peerIdStr, blockId, rev);
+                if (archive) {
+                    this.recordSuccess(ringDepth, blockId, Date.now() - startTime);
+                    return archive;
+                }
+            }
+            // This inner ring was queried and yielded nothing — count it as one ring failure.
+            this.recordFailure(ringDepth);
+        }
+        // No ring had the data
+        const duration = Date.now() - startTime;
+        this.log('restore failed for block %s after %dms', blockId, duration);
+        return undefined;
+    }
+    /**
+     * Create a RestoreCallback function that uses this coordinator.
+     */
+    createRestoreCallback() {
+        return async (blockId, rev) => {
+            return await this.restore(blockId, rev);
+        };
+    }
+    /**
+     * Get peers in my transaction ring for a given block.
+     * @param blockCoord the block id already hashed into the shared coordinate space.
+     */
+    getMyRingPeers(blockCoord) {
+        return this.fretAdapter.getFret().assembleCohort(blockCoord, 10);
+    }
+    /**
+     * Get my own ring depth from Arachnode info.
+     */
+    getMyRingDepth() {
+        const myInfo = this.fretAdapter.getMyArachnodeInfo();
+        return myInfo?.ringDepth ?? 8; // Default to Ring 8
+    }
+    /**
+     * Filter peers by partition responsibility.
+     * @param blockCoord the block id hashed into the shared coordinate space (same space
+     *   RingSelector.calculatePartition uses for peer partitions).
+     */
+    filterByPartition(peers, blockCoord, ringDepth) {
+        if (ringDepth === 0) {
+            return peers; // Ring 0 covers all blocks
+        }
+        return peers.filter(peerId => {
+            const info = this.fretAdapter.getArachnodeInfo(peerId);
+            if (!info || !info.partition)
+                return false;
+            // Compare block prefix vs peer partition via the shared responsibility derivation.
+            return partitionCovers(info.partition, blockCoord);
+        });
+    }
+    /**
+     * Query a specific peer for a block.
+     */
+    async queryPeer(peerIdStr, blockId, rev) {
+        try {
+            const peerId = peerIdFromString(peerIdStr);
+            const client = new SyncClient(peerId, this.peerNetwork, this.protocolPrefix);
+            const response = await client.requestBlock({ blockId, rev });
+            return response.success ? response.archive : undefined;
+        }
+        catch (error) {
+            this.log('queryPeer failed for %s - %o', peerIdStr, error);
+            return undefined;
+        }
+    }
+    /**
+     * Record successful restoration from a ring.
+     */
+    recordSuccess(ringDepth, blockId, durationMs) {
+        const count = this.metrics.successByRing.get(ringDepth) ?? 0;
+        this.metrics.successByRing.set(ringDepth, count + 1);
+        // Update rolling average duration
+        const totalSuccesses = Array.from(this.metrics.successByRing.values())
+            .reduce((sum, c) => sum + c, 0);
+        const prevTotal = this.metrics.averageDurationMs * (totalSuccesses - 1);
+        this.metrics.averageDurationMs = (prevTotal + durationMs) / totalSuccesses;
+        this.log('[Ring %d] Successfully restored block %s in %dms', ringDepth, blockId, durationMs);
+    }
+    /**
+     * Record that a ring was queried during a restore but did not yield the block.
+     * Counterpart to {@link recordSuccess}: the ring — not the individual peer query — is the
+     * failure unit, so this increments once per exhausted ring at the points where the peer
+     * loops in {@link restore} complete without returning an archive.
+     */
+    recordFailure(ringDepth) {
+        const count = this.metrics.failureByRing.get(ringDepth) ?? 0;
+        this.metrics.failureByRing.set(ringDepth, count + 1);
+    }
+    /**
+     * Get restoration metrics for monitoring.
+     */
+    getMetrics() {
+        // Copy the Maps: a bare `{ ...this.metrics }` spreads only the top level, handing the
+        // caller the SAME Map instances this coordinator keeps mutating — the snapshot would
+        // then change under the caller's feet, and a caller mutation would corrupt internal state.
+        return {
+            totalRequests: this.metrics.totalRequests,
+            successByRing: new Map(this.metrics.successByRing),
+            failureByRing: new Map(this.metrics.failureByRing),
+            averageDurationMs: this.metrics.averageDurationMs
+        };
+    }
+}
+//# sourceMappingURL=restoration-coordinator.js.map

package/dist/src/storage/restoration-coordinator.js.map

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

package/dist/src/storage/ring-selector.d.ts

@@ -10,6 +10,29 @@ export interface RingSelectorConfig {
         /** Move to inner ring when used < this % */
         moveIn: number;
     };
+    /**
+     * EWMA weight (0..1) applied to the demand inputs (available capacity and estimated network
+     * data) each sample tick. A single noisy sample only moves the smoothed depth by this fraction.
+     * Default {@link DEFAULT_SMOOTHING_ALPHA} (0.2).
+     */
+    smoothingAlpha?: number;
+    /**
+     * Hysteresis dead-band half-width `h`, in rings. A move only fires when the smoothed depth is
+     * past the ring boundary by `h`, so the region of width `2h` around each integer produces no
+     * move. Default {@link DEFAULT_DEADBAND} (0.5) — a full ring between the move-out and move-in
+     * triggers, so a node can never satisfy both at once.
+     */
+    deadband?: number;
+    /**
+     * Minimum dwell in ms: no new move may be triggered within this window of the last one. Bounds
+     * shift frequency independent of signal noise. Default {@link DEFAULT_MIN_DWELL_MS} (10 min).
+     */
+    minDwellMs?: number;
+    /**
+     * Injectable clock (Unix ms), used only for the dwell timer. Defaults to `Date.now`; tests
+     * inject a fake clock so dwell can be exercised without sleeping on wall time.
+     */
+    now?: () => number;
 }
 /**
  * Determines appropriate ring depth based on storage capacity and network demand.
@@ -19,16 +42,57 @@ export interface RingSelectorConfig {
  * - Ring N: 2^N partitions
  *
  * A node selects its ring based on: available_capacity / estimated_neighborhood_demand
+ *
+ * The transition decision ({@link shouldTransition}) is damped so it does not thrash near a ring
+ * boundary: the demand signal is smoothed with an EWMA, a dead-band keeps a hovering ratio from
+ * moving, and a minimum-dwell timer + single-step rule bound how often and how far it moves. See
+ * `docs/arachnode-ring-handoff.md` § Part 1.
  */
 export declare class RingSelector {
     private readonly fretAdapter;
     private readonly storageMonitor;
     private readonly config;
+    /** EWMA of available capacity (bytes). Undefined until the first sample seeds it. */
+    private smoothedAvailable;
+    /** EWMA of estimated total network data (bytes). Undefined until the first sample seeds it. */
+    private smoothedTotalData;
+    /** Clock time (ms) a move was last triggered; undefined = no move yet, so dwell does not block. */
+    private lastMoveAt;
+    private readonly now;
     constructor(fretAdapter: ArachnodeFretAdapter, storageMonitor: StorageMonitor, config: RingSelectorConfig);
     /**
-     * Determine appropriate ring depth based on capacity and demand.
+     * Determine appropriate ring depth from an instantaneous capacity + demand snapshot.
+     *
+     * This is the *undamped* reading used for the deterministic first-boot ring and anywhere a
+     * one-shot estimate is wanted. The damped transition logic lives in {@link shouldTransition};
+     * this method intentionally does not touch the EWMA state so its result is a pure function of
+     * the current snapshot.
      */
     determineRing(): Promise<number>;
+    /**
+     * Estimate total network spare capacity (bytes) by aggregating observed per-ring stats.
+     *
+     * See docs/arachnode.md §"Capacity Management and Ring Adjustment": ring selection should
+     * reflect observed network demand, not a hard-coded constant. We treat Σ (peerCount ×
+     * avgCapacity) over known rings as a proxy for total network spare capacity, so `coverage`
+     * becomes our share of it. More peers (or richer peers) → smaller share → higher ring depth
+     * (more specialization). On bootstrap, when no ring stats are observed yet, we fall back to a
+     * conservative fixed estimate so first-boot behavior is deterministic.
+     *
+     * @param availableForFallback local available bytes, used only for the pathological
+     * zero-aggregate case (e.g. all peers report 0 available) so coverage collapses to 1.0 (ring 0).
+     */
+    private estimateNetworkData;
+    /**
+     * Fold one sample into the EWMA of each demand input. Seeds from the first real sample rather
+     * than from 0 — a 0 seed would drag the smoothed depth for many ticks.
+     */
+    private updateSmoothing;
+    /**
+     * Continuous smoothed ring depth `d = clamp(-log2(smoothedCoverage), 0, 16)` from the current
+     * EWMA state. Returns 0 (ring 0) if no sample has been folded in yet.
+     */
+    private smoothedDepth;
     /**
      * Calculate partition for a given ring depth and peer ID.
      */
@@ -38,10 +102,28 @@ export declare class RingSelector {
     } | undefined>;
     /**
      * Create Arachnode info for this node.
+     *
+     * @param ringDepthOverride when supplied (e.g. the single-step target from
+     * {@link shouldTransition}), the node advertises exactly this ring instead of a freshly
+     * recomputed {@link determineRing}. The transition site passes it so the advertised ring can
+     * never disagree with the ring the transition decision just chose.
      */
-    createArachnodeInfo(peerId: string): Promise<ArachnodeInfo>;
+    createArachnodeInfo(peerId: string, ringDepthOverride?: number): Promise<ArachnodeInfo>;
     /**
-     * Monitor capacity and determine if ring transition is needed.
+     * Decide whether a damped ring transition should start.
+     *
+     * Damping (see `docs/arachnode-ring-handoff.md` § Part 1):
+     * - **Smoothing** — every call folds the current sample into an EWMA of the demand inputs and
+     *   works off the smoothed continuous depth `d`, so a single noisy sample cannot trigger a move.
+     * - **Hysteresis** — anchored on the node's *currently-advertised* ring `R` (not a freshly
+     *   recomputed one). A move only fires when `d` is past the boundary by the dead-band `h`, so a
+     *   ratio hovering around an integer produces no move.
+     * - **Dwell + single-step** — no new move within `minDwellMs` of the last, no move while a shift
+     *   is already in flight (`status === 'moving'`), and each move steps by exactly ±1 ring even
+     *   when `d` implies a larger jump.
+     *
+     * Return shape (`{ shouldMove, direction, newRingDepth }`) is the *trigger* the handoff protocol
+     * consumes; it is kept stable so that consumer is unaffected.
      */
     shouldTransition(): Promise<{
         shouldMove: boolean;
@@ -49,8 +131,13 @@ export declare class RingSelector {
         newRingDepth?: number;
     }>;
     /**
-     * Extract first N bits from byte array as a number.
+     * Re-stamp the dwell timer at the moment a ring shift *settles* — the driver
+     * (`RingShiftCoordinator` via `libp2p-node-base`) calls this once `executeShift` resolves, for a
+     * completed OR a rolled-back move. So the minimum dwell is measured from the settled shift rather
+     * than only from the trigger (`shouldTransition`): a completed shift dwells `minDwellMs` before the
+     * next move (spec §1.3, "after a *completed* shift"), and a shift that keeps failing is rate-limited
+     * rather than retried every tick. No-op-safe to call when no shift ran.
      */
-    private extractPrefix;
+    recordShiftSettled(): void;
 }
 //# sourceMappingURL=ring-selector.d.ts.map

package/dist/src/storage/ring-selector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ring-selector.d.ts","sourceRoot":"","sources":["../../../src/storage/ring-selector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IAClC,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,UAAU,EAAE;QACX,4CAA4C;QAC5C,OAAO,EAAE,MAAM,CAAC;QAChB,4CAA4C;QAC5C,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,WAAW,EAAE,oBAAoB,EACjC,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,kBAAkB;IAG5C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IA8CtC;;OAEG;IACG,kBAAkB,CACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAenE;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAmBjE;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC;QACjC,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAA;KACrB,CAAC;IA6BF;;OAEG;IACH,OAAO,CAAC,aAAa;CAUrB"}
+{"version":3,"file":"ring-selector.d.ts","sourceRoot":"","sources":["../../../src/storage/ring-selector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAYvF,MAAM,WAAW,kBAAkB;IAClC,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,UAAU,EAAE;QACX,4CAA4C;QAC5C,OAAO,EAAE,MAAM,CAAC;QAChB,4CAA4C;QAC5C,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;IAEF;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY;IAUvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXxB,qFAAqF;IACrF,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,+FAA+F;IAC/F,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,mGAAmG;IACnG,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAGjB,WAAW,EAAE,oBAAoB,EACjC,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,kBAAkB;IAK5C;;;;;;;OAOG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAwBtC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAUvB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACG,kBAAkB,CACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAkBnE;;;;;;;OAOG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAmB7F;;;;;;;;;;;;;;;OAeG;IACG,gBAAgB,IAAI,OAAO,CAAC;QACjC,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAA;KACrB,CAAC;IAwDF;;;;;;;OAOG;IACH,kBAAkB,IAAI,IAAI;CAG1B"}