@steve02081504/fount-p2p 0.0.0

package/wire/volatile_signature.mjs

@@ -0,0 +1,76 @@
+/**
+ * VOLATILE 流式分片签名域（§6.4）：`pendingStreamId + chunkSeq + slices`。
+ */
+import { Buffer } from 'node:buffer'
+import { createHash } from 'node:crypto'
+
+import { isHex64, isSignatureHex128 } from '../core/hexIds.mjs'
+import { keyPairFromSeed, sign, verify } from '../crypto/crypto.mjs'
+
+const CHUNK_DOMAIN = 'fount-volatile-chunk'
+
+/** 入站 stream_chunk 切片数量上限。 */
+export const MAX_STREAM_VOLATILE_SLICES = 256
+
+/**
+ * @param {unknown} slices 入站切片
+ * @returns {object[] | null} 合法切片或 null
+ */
+export function boundStreamSlices(slices) {
+	if (!Array.isArray(slices) || slices.length > MAX_STREAM_VOLATILE_SLICES) return null
+	return slices
+}
+
+/**
+ * @param {string} pendingStreamId 逻辑流 id
+ * @param {number} chunkSeq 分片序号（从 1 递增）
+ * @param {object[]} slices 差异切片数组
+ * @returns {Uint8Array} 验签消息字节
+ */
+export function streamChunkSignBytes(pendingStreamId, chunkSeq, slices) {
+	const streamId = String(pendingStreamId ?? '')
+	const sequence = Number.isFinite(Number(chunkSeq)) ? String(chunkSeq) : '0'
+	const body = JSON.stringify(slices ?? [])
+	return new TextEncoder().encode(`${CHUNK_DOMAIN}\0${streamId}\0${sequence}\0${body}`)
+}
+
+/**
+ * @param {Uint8Array} bytes 签名域
+ * @param {Uint8Array} secretKey 私钥种子（32 字节）
+ * @returns {Promise<string>} 128 位 hex 签名
+ */
+export async function signStreamSignatureHex(bytes, secretKey) {
+	const signatureBytes = await sign(bytes, secretKey)
+	return Buffer.from(signatureBytes).toString('hex')
+}
+
+/**
+ * @param {Uint8Array} bytes 签名域
+ * @param {string} signatureHex 128 位十六进制 签名
+ * @param {string} publicKeyHex 64 位十六进制 公钥
+ * @returns {Promise<boolean>} 验签是否通过
+ */
+export async function verifyStreamSignatureHex(bytes, signatureHex, publicKeyHex) {
+	const signature = String(signatureHex || '').trim().toLowerCase()
+	const publicKey = String(publicKeyHex || '').trim().toLowerCase()
+	if (!isSignatureHex128(signature) || !isHex64(publicKey)) return false
+	try {
+		return await verify(Buffer.from(signature, 'hex'), bytes, Buffer.from(publicKey, 'hex'))
+	}
+	catch {
+		return false
+	}
+}
+
+/**
+ * 本节点出站 VOLATILE 签名密钥（由用户名 + 联邦口令材料确定性派生）。
+ * @param {string} username 用户
+ * @param {string} seedMaterial 口令或回退材料
+ * @returns {{ publicKey: Uint8Array, secretKey: Uint8Array }} 密钥对
+ */
+export function streamKeyPairFromUserSeed(username, seedMaterial) {
+	const user = String(username ?? '')
+	const material = String(seedMaterial ?? '')
+	const seed = createHash('sha256').update(`fount-stream-sign\0${user}\0${material}`).digest()
+	return keyPairFromSeed(seed)
+}

package/wire/wait.mjs

@@ -0,0 +1,127 @@
+/**
+ * Trystero 请求-响应等待表（gossip、channel history 等共用）。
+ */
+
+/**
+ * @typedef {{ resolve: (value?: unknown) => void, timer: ReturnType<typeof setTimeout> }} WireWaiter
+ */
+
+/**
+ * @param {Map<string, unknown>} pending 等待表
+ * @param {string} key 等待键
+ * @param {number} timeoutMs 超时毫秒
+ * @param {() => unknown} onTimeout 超时回调值
+ * @returns {{ resolve: (value: unknown) => void, promise: Promise<unknown> }} 等待句柄
+ */
+export function registerWireWait(pending, key, timeoutMs, onTimeout) {
+	const waitPromise = new Promise(resolve => {
+		const timer = setTimeout(() => {
+			pending.delete(key)
+			resolve(onTimeout())
+		}, timeoutMs)
+		pending.set(key, {
+			/** @param {unknown} value 应答值 */
+			resolve: value => {
+				clearTimeout(timer)
+				pending.delete(key)
+				resolve(value)
+			},
+			timer,
+		})
+	})
+	const entry = pending.get(key)
+	return {
+		resolve: entry.resolve,
+		promise: waitPromise,
+	}
+}
+
+/**
+ * @param {Map<string, Map<string, WireWaiter[]>>} pending 按前缀分桶的多 waiter 表
+ * @param {string} keyPrefix 键前缀（如 `user\0group\0`）
+ * @param {string} suffixKey 后缀键
+ * @returns {Map<string, WireWaiter[]>} 后缀桶
+ */
+function ensurePrefixBucket(pending, keyPrefix, suffixKey) {
+	let bucket = pending.get(keyPrefix)
+	if (!bucket) {
+		bucket = new Map()
+		pending.set(keyPrefix, bucket)
+	}
+	return bucket
+}
+
+/**
+ * 多 waiter 注册（gossip 等同键并发等待）。
+ * @param {Map<string, Map<string, WireWaiter[]>>} pending 多 waiter 表
+ * @param {string} keyPrefix 键前缀
+ * @param {string} suffixKey 后缀键
+ * @param {number} timeoutMs 超时毫秒
+ * @param {() => unknown} [onTimeout] 超时返回值
+ * @returns {Promise<unknown>} 完成 promise
+ */
+export function registerMultiWireWait(pending, keyPrefix, suffixKey, timeoutMs, onTimeout = () => undefined) {
+	return new Promise(resolve => {
+		const timer = setTimeout(() => {
+			finishMultiWireWaiters(pending, keyPrefix, suffixKey)
+			resolve(onTimeout())
+		}, timeoutMs)
+		const bucket = ensurePrefixBucket(pending, keyPrefix, suffixKey)
+		let waiters = bucket.get(suffixKey)
+		if (!waiters) {
+			waiters = []
+			bucket.set(suffixKey, waiters)
+		}
+		waiters.push({ resolve, timer })
+	})
+}
+
+/**
+ * @param {Map<string, Map<string, WireWaiter[]>>} pending 多 waiter 表
+ * @param {string} keyPrefix 键前缀
+ * @param {string} suffixKey 后缀键
+ * @returns {void}
+ */
+export function finishMultiWireWaiters(pending, keyPrefix, suffixKey) {
+	const bucket = pending.get(keyPrefix)
+	const waiters = bucket?.get(suffixKey)
+	if (!waiters?.length) return
+	bucket.delete(suffixKey)
+	if (!bucket.size) pending.delete(keyPrefix)
+	for (const waiter of waiters) {
+		clearTimeout(waiter.timer)
+		waiter.resolve()
+	}
+}
+
+/**
+ * 前缀桶内按 want id 命中唤醒 waiter。
+ * @param {Map<string, Map<string, WireWaiter[]>>} pending 多 waiter 表
+ * @param {string} keyPrefix 键前缀
+ * @param {ReadonlySet<string>} hitIds 命中 id 集合
+ * @param {(suffixKey: string) => string[] | null} parseWantIds 从后缀键解析 want id 列表
+ * @returns {void}
+ */
+export function notifyMultiWireWaitersByPrefix(pending, keyPrefix, hitIds, parseWantIds) {
+	if (!hitIds.size) return
+	const bucket = pending.get(keyPrefix)
+	if (!bucket) return
+	for (const [suffixKey, waiters] of bucket) {
+		const wanted = parseWantIds(suffixKey)
+		if (!wanted?.length) continue
+		let hit = false
+		for (const id of hitIds)
+			if (wanted.includes(id)) {
+				hit = true
+				break
+			}
+
+		if (!hit) continue
+		bucket.delete(suffixKey)
+		for (const waiter of waiters) {
+			clearTimeout(waiter.timer)
+			waiter.resolve()
+		}
+	}
+	if (!bucket.size) pending.delete(keyPrefix)
+}