@optimystic/db-p2p 0.24.1 → 0.25.0

package/src/storage/cached-raw-storage.ts

@@ -4,6 +4,7 @@ import type { RawStoreDriver } from "./raw-store-driver.js";
 import { KvRawStorage } from "./kv-raw-storage.js";
 import { CachedStoreDriver } from "./cached-store-driver.js";
 import type { SharedCachePool } from "./shared-cache-pool.js";
+import type { StoreIdentity } from "./store-identity.js";
 import { encodeJson, decodeJson, encodeActionId, decodeActionId } from "./raw-store-codec.js";
 
 /**
@@ -27,8 +28,12 @@ export class RawStorageDriverAdapter implements RawStoreDriver {
 	 */
 	listBlockIds?: () => AsyncIterable<BlockId>;
 	approximateBytesUsed?: () => Promise<number>;
+	storeIdentity?: () => StoreIdentity;
 
 	constructor(private readonly inner: IRawStorage) {
+		if (inner.getStoreIdentity) {
+			this.storeIdentity = () => inner.getStoreIdentity!();
+		}
 		if (inner.listBlockIds) {
 			this.listBlockIds = () => inner.listBlockIds!();
 		}
@@ -107,6 +112,21 @@ export class RawStorageDriverAdapter implements RawStoreDriver {
 		await this.inner.saveTransaction(blockId, actionId, decodeJson(value));
 	}
 
+	// --- proofs ---
+
+	// The inner storage owns the proofs keyspace (`IRawStorage.getBlockProof` /
+	// `saveBlockProof`), so this adapter only re-encodes across the byte boundary the
+	// way its sibling methods do. Deliberately no delete — see RawStoreDriver.getProof.
+
+	async getProof(blockId: BlockId, rev: number): Promise<Uint8Array | undefined> {
+		const proof = await this.inner.getBlockProof(blockId, rev);
+		return proof === undefined ? undefined : encodeJson(proof);
+	}
+
+	async putProof(blockId: BlockId, rev: number, value: Uint8Array): Promise<void> {
+		await this.inner.saveBlockProof(blockId, rev, decodeJson(value));
+	}
+
 	// --- materialized ---
 
 	async getMaterialized(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined> {
@@ -139,7 +159,7 @@ export class RawStorageDriverAdapter implements RawStoreDriver {
  *
  * All caching semantics (write-through coherence, proven-absence negatives, list
  * completeness, promote mirroring) live in {@link CachedStoreDriver}; see its class doc
- * and docs/storage.md "Write-through raw-storage cache" for the invariants this relies
+ * and `packages/db-p2p/docs/storage.md` § "Write-through raw-storage cache" for the invariants this relies
  * on — including the single-process-owner precondition.
  *
  * Prefer wrapping the backend's driver directly — `new KvRawStorage(new