@peerbit/shared-log 13.2.30 → 13.2.32

package/src/replication.ts

@@ -1,12 +1,13 @@
 import {
 	deserialize,
 	field,
+	fixedArray,
 	option,
 	serialize,
 	variant,
 	vec,
 } from "@dao-xyz/borsh";
-import { randomBytes } from "@peerbit/crypto";
+import { PublicSignKey, randomBytes } from "@peerbit/crypto";
 import { type Index } from "@peerbit/indexer-interface";
 import { TransportMessage } from "./message.js";
 import {
@@ -124,6 +125,142 @@ export class ReplicationPingMessage extends TransportMessage {
 	}
 }
 
+/**
+ * Challenge-bound replication-info V2 messages. Their `receiverChallenge`
+ * field carries a derived receiver binding, not the request's raw nonce. The
+ * binding covers both authenticated identities and signed transport sessions.
+ * Sender-ready nodes may emit them only after a signed, session-bound receiver
+ * request. Receive/apply activation remains separately capability-gated.
+ */
+@variant([1, 6])
+export class FullReplicationInfoV2Message extends TransportMessage {
+	@field({ type: fixedArray("u8", 32) })
+	receiverChallenge: Uint8Array;
+
+	@field({ type: fixedArray("u8", 32) })
+	senderEpoch: Uint8Array;
+
+	@field({ type: "u64" })
+	sequence: bigint;
+
+	@field({ type: vec(ReplicationRangeMessage) })
+	segments: ReplicationRangeMessage<any>[];
+
+	constructor(properties: {
+		receiverChallenge: Uint8Array;
+		senderEpoch: Uint8Array;
+		sequence: bigint;
+		segments: ReplicationRangeMessage<any>[];
+	}) {
+		super();
+		this.receiverChallenge = properties.receiverChallenge;
+		this.senderEpoch = properties.senderEpoch;
+		this.sequence = properties.sequence;
+		this.segments = properties.segments;
+	}
+}
+
+@variant([1, 7])
+export class AddedReplicationInfoV2Message extends TransportMessage {
+	@field({ type: fixedArray("u8", 32) })
+	receiverChallenge: Uint8Array;
+
+	@field({ type: fixedArray("u8", 32) })
+	senderEpoch: Uint8Array;
+
+	@field({ type: "u64" })
+	sequence: bigint;
+
+	@field({ type: vec(ReplicationRangeMessage) })
+	segments: ReplicationRangeMessage<any>[];
+
+	constructor(properties: {
+		receiverChallenge: Uint8Array;
+		senderEpoch: Uint8Array;
+		sequence: bigint;
+		segments: ReplicationRangeMessage<any>[];
+	}) {
+		super();
+		this.receiverChallenge = properties.receiverChallenge;
+		this.senderEpoch = properties.senderEpoch;
+		this.sequence = properties.sequence;
+		this.segments = properties.segments;
+	}
+}
+
+@variant([1, 8])
+export class StoppedReplicationInfoV2Message extends TransportMessage {
+	@field({ type: fixedArray("u8", 32) })
+	receiverChallenge: Uint8Array;
+
+	@field({ type: fixedArray("u8", 32) })
+	senderEpoch: Uint8Array;
+
+	@field({ type: "u64" })
+	sequence: bigint;
+
+	@field({ type: vec(Uint8Array) })
+	segmentIds: Uint8Array[];
+
+	constructor(properties: {
+		receiverChallenge: Uint8Array;
+		senderEpoch: Uint8Array;
+		sequence: bigint;
+		segmentIds: Uint8Array[];
+	}) {
+		super();
+		this.receiverChallenge = properties.receiverChallenge;
+		this.senderEpoch = properties.senderEpoch;
+		this.sequence = properties.sequence;
+		this.segmentIds = properties.segmentIds;
+	}
+}
+
+/**
+ * Signed, receiver-led permission for one sender to start a V2 stream.
+ *
+ * The transport delivery target is deliberately unsigned because relays may
+ * rewrite it. Carry the intended sender in the signed payload so a valid
+ * request cannot be retargeted to another peer. `senderSession` is copied from
+ * the sender's signed capability envelope and binds the request to that exact
+ * transport incarnation.
+ */
+@variant([1, 9])
+export class RequestReplicationInfoV2Message extends TransportMessage {
+	/** Random receiver nonce used as input to the V2 receiver-binding hash. */
+	@field({ type: fixedArray("u8", 32) })
+	receiverChallenge: Uint8Array;
+
+	@field({ type: PublicSignKey })
+	intendedSender: PublicSignKey;
+
+	@field({ type: "u64" })
+	senderSession: bigint;
+
+	constructor(properties: {
+		receiverChallenge: Uint8Array;
+		intendedSender: PublicSignKey;
+		senderSession: bigint;
+	}) {
+		super();
+		this.receiverChallenge = properties.receiverChallenge;
+		this.intendedSender = properties.intendedSender;
+		this.senderSession = properties.senderSession;
+	}
+}
+
+export type ReplicationInfoV2Message =
+	| FullReplicationInfoV2Message
+	| AddedReplicationInfoV2Message
+	| StoppedReplicationInfoV2Message;
+
+export const isReplicationInfoV2Message = (
+	message: TransportMessage,
+): message is ReplicationInfoV2Message =>
+	message instanceof FullReplicationInfoV2Message ||
+	message instanceof AddedReplicationInfoV2Message ||
+	message instanceof StoppedReplicationInfoV2Message;
+
 /* 
 @variant(1)
 export class RelativeMinReplicas extends MinReplicas {