@serfab/cadre-core 1.8.0 → 1.9.0

package/dist/types.d.ts

@@ -11,7 +11,7 @@ import type { SeedTrustPolicy } from './seed-trust-policy.js';
 import type { KeyStore, KeyId } from './key-store.js';
 import type { TrustedOwnerStore, TrustSource } from './trusted-owner-store.js';
 import type { BootstrapPeerStore } from './bootstrap-peer-store.js';
-import type { StrandPeerBookStore } from './strand-peer-book.js';
+import type { StrandNetworkStateStore } from './strand-network-state.js';
 import type { EnrolledMachineStore } from './enrolled-machine-store.js';
 import type { JoinedStrandStore } from './joined-strand-store.js';
 import type { PushNotifier } from './push-notifier.js';
@@ -955,32 +955,29 @@ export interface CadreNodeConfig {
         store?: JoinedStrandStore;
     };
     /**
-     * Node-local strand peer book (see `strand-peer-book.ts`): per strand, the strand
-     * peers this node has met — the other parties' strand transport peers a formation
-     * carried back, and every strand peer observed on a live connection — with their
-     * last-known addresses. Read on every launch, hibernation resume and periodic
-     * address refresh, so a restarted machine dials the peers it was talking to before
-     * anything else, instead of coming back up alone (gotchoices/sereus#18). Sibling
-     * of {@link bootstrapPeers} — same NON-replicated, per-party, injected-backend
-     * shape — and, like it, nothing here is trust-bearing: dial hints only, each
-     * bound to its peer id. Entries age out after 14 days (`STRAND_PEER_MAX_AGE_MS`,
-     * overridable per store via `StrandPeerBookOptions.maxAgeMs`).
-     *
-     * Absent ⇒ an in-memory store is created at start() (ephemeral: the book dies
-     * with the process, and a cross-party strand whose only contact was the other
-     * party does not re-mesh after a restart until a fresh formation). Every
-     * reference embedder injects a durable backend over the same slot kind as its
-     * bootstrap-peer store. A new platform needs no new store class: supply a
-     * `DurableSlot` and inject `PersistentStrandPeerBookStore.open(slot, partyId)`.
-     */
-    strandPeers?: {
+     * Node-local strand network state (see `strand-network-state.ts`): per strand, the
+     * state Optimystic's db-p2p saves for the strand's libp2p node — its FRET routing
+     * table, each entry carrying the peer's signed address record. A strand node reads
+     * it back when it is built and re-imports the table, so a restarted machine already
+     * holds addresses for the strand peers it was talking to (gotchoices/sereus#18).
+     * Sibling of {@link bootstrapPeers} — same NON-replicated, per-party,
+     * injected-backend shape — and, like it, nothing here is trust-bearing: FRET
+     * verifies every record at import.
+     *
+     * Absent ⇒ an in-memory store is created at start() (ephemeral: a restarted process
+     * starts every strand with an empty routing table). Every reference embedder
+     * injects a durable backend over the same slot kind as its bootstrap-peer store. A
+     * new platform needs no new store class: supply a `DurableSlot` and inject
+     * `PersistentStrandNetworkStateStore.open(slot, partyId)`.
+     */
+    strandNetworkState?: {
         /**
-         * Injected store instance — e.g. a `FileStrandPeerBookStore` from the
-         * Node-only subpath `@serfab/cadre-core/strand-peer-book-file`, persisted in
+         * Injected store instance — e.g. a `FileStrandNetworkStateStore` from the
+         * Node-only subpath `@serfab/cadre-core/strand-network-state-file`, persisted in
          * the node's state directory. Its `partyId` must match
          * `controlNetwork.partyId`; start() fails closed on a mismatch.
          */
-        store?: StrandPeerBookStore;
+        store?: StrandNetworkStateStore;
     };
     /**
      * Platform push-delivery for suspended mobile peers. When present, the node's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serfab/cadre-core",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "type": "module",
   "description": "Core library for Sereus cadre nodes - manages control networks and strand participation",
   "main": "dist/index.js",
@@ -36,9 +36,9 @@
       "types": "./dist/enrolled-machine-store-file.d.ts",
       "import": "./dist/enrolled-machine-store-file.js"
     },
-    "./strand-peer-book-file": {
-      "types": "./dist/strand-peer-book-file.d.ts",
-      "import": "./dist/strand-peer-book-file.js"
+    "./strand-network-state-file": {
+      "types": "./dist/strand-network-state-file.d.ts",
+      "import": "./dist/strand-network-state-file.js"
     },
     "./push-node": {
       "types": "./dist/push-node.d.ts",
@@ -77,7 +77,7 @@
     "@libp2p/tcp": "^11.0.10",
     "@libp2p/webrtc": "6.0.14",
     "@libp2p/websockets": "^10.1.3",
-    "@optimystic/db-p2p-storage-fs": "^1.8.0",
+    "@optimystic/db-p2p-storage-fs": "^1.8.1",
     "@types/debug": "^4.1.12",
     "@types/node": "^25.0.10",
     "@vitest/coverage-v8": "^4.0.17",
@@ -91,13 +91,14 @@
     "@libp2p/crypto": "^5.1.13",
     "@libp2p/interface": "^3.1.0",
     "@libp2p/peer-id": "^6.0.4",
+    "@libp2p/peer-record": "^9.0.5",
     "@multiformats/multiaddr": "^12.5.1",
-    "@optimystic/db-core": "^1.8.0",
-    "@optimystic/db-p2p": "^1.8.0",
-    "@optimystic/quereus-plugin-crypto": "^1.8.0",
-    "@optimystic/quereus-plugin-optimystic": "^1.8.0",
+    "@optimystic/db-core": "^1.8.1",
+    "@optimystic/db-p2p": "^1.8.1",
+    "@optimystic/quereus-plugin-crypto": "^1.8.1",
+    "@optimystic/quereus-plugin-optimystic": "^1.8.1",
     "@quereus/quereus": "^4.20.0",
-    "@serfab/quereus-plugin-sereus": "^1.8.0",
+    "@serfab/quereus-plugin-sereus": "^1.9.0",
     "debug": "^4.4.3",
     "libp2p": "^3.1.3",
     "uint8arrays": "^5.1.0"