@steve02081504/fount-p2p 0.0.4 → 0.0.6

package/node/reputation_store.mjs

@@ -7,7 +7,6 @@ import {
 	bumpChunkStorageReputationPure,
 	bumpReputationOnRelayPure,
 	ensureReputationShape,
-	isQuarantinedPure,
 	observeBehaviorSamplePure,
 	penalizeArchiveServeMismatchPure,
 	penalizeChunkStorageFailurePure,
@@ -27,12 +26,12 @@ import { readNodeJsonSync, writeNodeJsonSync } from './storage.mjs'
 
 const DATA_NAME = 'reputation'
 
-/** @type {((opts: object) => Promise<boolean>) | null} */
+/** @type {((options: object) => Promise<boolean>) | null} */
 let blockReputationHandler = null
 
 /**
  * Shell Load 时注册：公开 block/unblock → 信誉传导。
- * @param {(opts: object) => Promise<boolean>} handler block/unblock 信誉传导回调
+ * @param {(options: object) => Promise<boolean>} handler block/unblock 信誉传导回调
  * @returns {void}
  */
 export function registerBlockReputationHandler(handler) {
@@ -145,14 +144,6 @@ export async function observePeerBehavior(peerNodeHash, sample) {
 	return anomaly
 }
 
-/**
- * @param {string} peerNodeHash 对端
- * @returns {boolean} 是否处于本地隔离
- */
-export function isPeerQuarantined(peerNodeHash) {
-	return isQuarantinedPure(loadReputation(), peerNodeHash)
-}
-
 /**
  * @param {string} storagePeerKey 责任方
  * @returns {void}
@@ -317,10 +308,10 @@ export function pickNodeScore(nodeId) {
 }
 
 /**
- * @param {object} opts applyFollowedBlockSignal 参数
+ * @param {object} options applyFollowedBlockSignal 参数
  * @returns {Promise<boolean>} 是否已应用
  */
-export async function applyBlockReputationSignal(opts) {
+export async function applyBlockReputationSignal(options) {
 	if (!blockReputationHandler) return false
-	return blockReputationHandler(opts)
+	return blockReputationHandler(options)
 }

package/node/retention_policy.mjs

@@ -3,36 +3,21 @@ import {
 	authzFoldOrderIds,
 	descendantClosureFromTip,
 } from '../governance/branch.mjs'
-import { getPermissionAnchorTypes } from '../registries/event_type.mjs'
-
-/**
- * @param {string[]} order 拓扑序 id 列表
- * @param {Map<string, object>} byId id → 事件
- * @returns {number} 最早须保留的事件下标
- */
-export function permissionAnchorStartIndex(order, byId) {
-	let anchor = order.length
-	for (let index = order.length - 1; index >= 0; index--) {
-		const ev = byId.get(order[index])
-		if (ev && getPermissionAnchorTypes().has(ev.type)) anchor = index
-	}
-	return anchor
-}
 
 /**
  * 在共识分支上计算须保留的事件 id（连通子图，不用拓扑下标切片）。
  * @param {string[]} order 规范拓扑序
  * @param {Map<string, object>} byId id → 事件
- * @param {object} opts 保留策略
- * @param {number} opts.maxDepth 分支上最大事件深度
- * @param {number} opts.cutoffWall 最早保留的 HLC wall
- * @param {Set<string>} opts.anchorTypes 权限锚点事件类型
- * @param {string | null} [opts.checkpointTipId] checkpoint 尖
- * @param {string | null} [opts.branchTipId] 共识分支尖
+ * @param {object} options 保留策略
+ * @param {number} options.maxDepth 分支上最大事件深度
+ * @param {number} options.cutoffWall 最早保留的 HLC wall
+ * @param {Set<string>} options.anchorTypes 权限锚点事件类型
+ * @param {string | null} [options.checkpointTipId] checkpoint 尖
+ * @param {string | null} [options.branchTipId] 共识分支尖
  * @returns {Set<string>} 保留 id
  */
-export function computeRetentionKeepIds(order, byId, opts) {
-	const { maxDepth, cutoffWall, anchorTypes, checkpointTipId, branchTipId } = opts
+export function computeRetentionKeepIds(order, byId, options) {
+	const { maxDepth, cutoffWall, anchorTypes, checkpointTipId, branchTipId } = options
 	const branchOrder = authzFoldOrderIds(order, byId, branchTipId)
 	const branchSet = new Set(branchOrder)
 	if (!branchSet.size) return new Set()

package/overlay/index.mjs

@@ -131,15 +131,15 @@ export function createOverlayRouter(registry, ttl = 3) {
 		/**
 		 * 发现到目标节点的签名路由路径。
 		 * @param {string} targetNodeHash 目标节点 64 hex
-		 * @param {object} [opts] 选项
-		 * @param {number} [opts.ttl] 路由 TTL
-		 * @param {number} [opts.timeoutMs] 超时毫秒
+		 * @param {object} [options] 选项
+		 * @param {number} [options.ttl] 路由 TTL
+		 * @param {number} [options.timeoutMs] 超时毫秒
 		 * @returns {Promise<string[]>} 从本节点到目标的 nodeHash 路径
 		 */
-		async discoverRoute(targetNodeHash, opts = {}) {
+		async discoverRoute(targetNodeHash, options = {}) {
 			const reqId = randomMsgIdHex()
-			const maxTtl = Number(opts.ttl) || ttl
-			const timeoutMs = Number(opts.timeoutMs) || 10_000
+			const maxTtl = Number(options.ttl) || ttl
+			const timeoutMs = Number(options.timeoutMs) || 10_000
 			const promise = new Promise((resolve, reject) => {
 				const timer = setTimeout(() => {
 					pendingRoutes.delete(reqId)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@steve02081504/fount-p2p",
-	"version": "0.0.4",
+	"version": "0.0.6",
 	"description": "fount federation P2P layer — link, trust graph, mailbox, DAG, EVFS.",
 	"keywords": [
 		"network",

package/registries/event_type.mjs

@@ -56,18 +56,6 @@ export function getGovernanceAuthzTypes() {
 	return typesWithFlag('governance')
 }
 
-/** 联邦入站/中继前须物化 ACL 门控的类型。 */
-/** @returns {Set<string>} ACL 门控事件 type 集合 */
-export function getFederationAclGatedEventTypes() {
-	return typesWithFlag('aclGated')
-}
-
-/** §6.2 频道 GC 沉寂计时排除的类型。 */
-/** @returns {Set<string>} GC 排除事件 type 集合 */
-export function getChannelGcExcludedEventTypes() {
-	return typesWithFlag('gcExclude')
-}
-
 /** 裁剪时不得早于最早一条权限锚点事件（§7.1）。 */
 /** @returns {Set<string>} 权限锚点事件 type 集合 */
 export function getPermissionAnchorTypes() {

package/registries/inbound.mjs

@@ -10,11 +10,11 @@
  */
 
 /**
- * @typedef {(ctx: InboundContext, message: object) => Promise<PartInvokeResponse | null>} RpcInboundHandler
+ * @typedef {(inboundContext: InboundContext, message: object) => Promise<PartInvokeResponse | null>} RpcInboundHandler
  */
 
 /**
- * @typedef {(ctx: InboundContext, message: object) => Promise<void>} DeliveryInboundHandler
+ * @typedef {(inboundContext: InboundContext, message: object) => Promise<void>} DeliveryInboundHandler
  */
 
 /** @type {Map<string, RpcInboundHandler>} */
@@ -42,49 +42,27 @@ export function registerDeliveryInboundHandler(type, handler) {
 }
 
 /**
- * @param {string} type 入站类型
- * @returns {void}
- */
-export function unregisterRpcInboundHandler(type) {
-	rpcHandlers.delete(String(type || '').trim())
-}
-
-/**
- * @param {string} type 入站类型
- * @returns {void}
- */
-export function unregisterDeliveryInboundHandler(type) {
-	deliveryHandlers.delete(String(type || '').trim())
-}
-
-/**
- * @param {InboundContext} ctx 入站上下文
+ * @param {InboundContext} inboundContext 入站上下文
  * @param {object} message 已校验的线载荷（含 type）
  * @returns {Promise<PartInvokeResponse | null>} 处理器返回值
  */
-export async function dispatchRpcInbound(ctx, message) {
+export async function dispatchRpcInbound(inboundContext, message) {
 	const type = String(message?.type || '').trim()
 	if (!type) return null
 	const handler = rpcHandlers.get(type)
 	if (!handler) return null
-	return handler(ctx, message)
+	return handler(inboundContext, message)
 }
 
 /**
- * @param {InboundContext} ctx 入站上下文
+ * @param {InboundContext} inboundContext 入站上下文
  * @param {object} message 已校验的线载荷（含 type）
  * @returns {Promise<void>}
  */
-export async function dispatchDeliveryInbound(ctx, message) {
+export async function dispatchDeliveryInbound(inboundContext, message) {
 	const type = String(message?.type || '').trim()
 	if (!type) return
 	const handler = deliveryHandlers.get(type)
 	if (!handler) return
-	await handler(ctx, message)
-}
-
-/** @returns {void} 测试用 */
-export function clearInboundHandlers() {
-	rpcHandlers.clear()
-	deliveryHandlers.clear()
+	await handler(inboundContext, message)
 }

package/reputation/engine.mjs

@@ -445,14 +445,3 @@ export function isQuarantinedPure(data, peerNodeHash, now = Date.now()) {
 	const until = Number(data.byNodeHash?.[id]?.quarantinedUntil ?? 0)
 	return Number.isFinite(until) && until > now
 }
-
-/**
- * @param {ReputationFile} data 信誉表
- * @param {string} peerNodeHash 对端
- * @param {number} [now] 当前时间
- * @param {typeof reputationTunables} [tunables] tunables
- * @returns {boolean} 是否检测到异常并触发隔离
- */
-export function detectAnomalyPure(data, peerNodeHash, now = Date.now(), tunables = reputationTunables) {
-	return isQuarantinedPure(data, peerNodeHash, now)
-}

package/rooms/scoped_link.mjs

@@ -9,17 +9,17 @@ import {
 
 /**
  * 在指定 scope 与 roomSecret 下创建 link 层房间（discovery + registry 转发）。
- * @param {object} opts 房间选项
- * @param {string} opts.scope link registry scope（如 `group:{id}`）
- * @param {string} opts.roomSecret 房间 rendezvous 密钥
- * @param {(nodeHash: string) => boolean} [opts.allowNode] 是否允许与某 nodeHash 通信
- * @returns {{ start: () => Promise<void>, leave: () => Promise<void>, makeAction: (name: string) => [(payload: unknown, peerId?: string | string[] | null) => Promise<void>, (handler: (payload: unknown, peerId: string) => void) => void], onPeerJoin: (cb: (peerId: string) => void) => () => void, onPeerLeave: (cb: (peerId: string) => void) => () => void, getPeers: () => Record<string, true> }} 房间句柄
+ * @param {object} options 房间选项
+ * @param {string} options.scope link registry scope（如 `group:{id}`）
+ * @param {string} options.roomSecret 房间 rendezvous 密钥
+ * @param {(nodeHash: string) => boolean} [options.allowNode] 是否允许与某 nodeHash 通信
+ * @returns {{ start: () => Promise<void>, leave: () => Promise<void>, makeAction: (name: string) => [(payload: unknown, peerId?: string | string[] | null) => Promise<void>, (handler: (payload: unknown, peerId: string) => void) => void], onPeerJoin: (callback: (peerId: string) => void) => () => void, onPeerLeave: (callback: (peerId: string) => void) => () => void, getPeers: () => Record<string, true> }} 房间句柄
  */
-export function createScopedLinkRoom(opts) {
+export function createScopedLinkRoom(options) {
 	const registry = getLinkRegistry()
-	const scope = String(opts.scope)
-	const topic = groupRendezvousTopic(opts.roomSecret)
-	const allowNode = typeof opts.allowNode === 'function' ? opts.allowNode : () => true
+	const scope = String(options.scope)
+	const topic = groupRendezvousTopic(options.roomSecret)
+	const allowNode = typeof options.allowNode === 'function' ? options.allowNode : () => true
 	/** @type {Set<string>} */
 	const discoveredPeers = new Set()
 	/** @type {Set<string>} */
@@ -156,24 +156,24 @@ export function createScopedLinkRoom(opts) {
 			]
 		},
 		/**
-		 * @param {(peerId: string) => void} cb 新 peer 上线回调
+		 * @param {(peerId: string) => void} callback 新 peer 上线回调
 		 * @returns {() => void} 取消订阅
 		 */
-		onPeerJoin(cb) {
-			joinListeners.add(cb)
+		onPeerJoin(callback) {
+			joinListeners.add(callback)
 			for (const peerId of activePeerIds())
 				announcedPeers.add(peerId)
 			for (const peerId of announcedPeers)
-				try { cb(peerId) } catch { /* ignore */ }
-			return () => joinListeners.delete(cb)
+				try { callback(peerId) } catch { /* ignore */ }
+			return () => joinListeners.delete(callback)
 		},
 		/**
-		 * @param {(peerId: string) => void} cb peer 离线回调
+		 * @param {(peerId: string) => void} callback peer 离线回调
 		 * @returns {() => void} 取消订阅
 		 */
-		onPeerLeave(cb) {
-			leaveListeners.add(cb)
-			return () => leaveListeners.delete(cb)
+		onPeerLeave(callback) {
+			leaveListeners.add(callback)
+			return () => leaveListeners.delete(callback)
 		},
 		/**
 		 * @returns {Record<string, true>} 当前活跃 peer 的 nodeHash 集合

package/schemas/part_query.mjs

@@ -0,0 +1,156 @@
+import { Buffer } from 'node:buffer'
+
+import { canonicalStringify } from '../core/canonical_json.mjs'
+import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
+import { isPlainObject } from '../wire/ingress.mjs'
+import { normalizePartpath } from '../wire/part_invoke.mjs'
+import partQueryTunables from '../wire/part_query.tunables.json' with { type: 'json' }
+
+/**
+ * @typedef {{
+ *   requestId: string
+ *   originNodeHash: string
+ *   partpath: string
+ *   kind: string
+ *   query: unknown
+ *   ttl: number
+ *   budget: { maxHits: number }
+ * }} PartQueryReq
+ */
+
+/**
+ * @typedef {{
+ *   requestId: string
+ *   fromNodeHash: string
+ *   rows: unknown[]
+ * }} PartQueryRes
+ */
+
+/**
+ * @param {unknown} value 任意 JSON
+ * @returns {number} UTF-8 序列化字节数；不可序列化时 Infinity
+ */
+export function measureJsonBytes(value) {
+	try {
+		return Buffer.byteLength(JSON.stringify(value), 'utf8')
+	}
+	catch {
+		return Number.POSITIVE_INFINITY
+	}
+}
+
+/**
+ * @param {unknown} budget 请求预算
+ * @param {number} [maxHits=partQueryTunables.maxHits] 上限
+ * @returns {{ maxHits: number }} 钳制后的预算
+ */
+export function clampPartQueryBudget(budget, maxHits = partQueryTunables.maxHits) {
+	const cap = Math.max(1, Math.floor(Number(maxHits) || partQueryTunables.maxHits))
+	const raw = isPlainObject(budget) ? Number(budget.maxHits) : NaN
+	const hits = Number.isFinite(raw) ? Math.floor(raw) : cap
+	return { maxHits: Math.max(1, Math.min(cap, hits)) }
+}
+
+/**
+ * @param {unknown} ttl 跳数预算
+ * @param {number} [maxTtl=partQueryTunables.maxTtl] 上限
+ * @returns {number | null} 钳制后的 ttl；非法为 null
+ */
+export function clampPartQueryTtl(ttl, maxTtl = partQueryTunables.maxTtl) {
+	const cap = Math.max(1, Math.floor(Number(maxTtl) || partQueryTunables.maxTtl))
+	const n = Math.floor(Number(ttl))
+	if (!Number.isFinite(n) || n < 1) return null
+	return Math.min(cap, n)
+}
+
+/**
+ * @param {unknown} rows 行数组
+ * @param {number} maxHits 条数上限
+ * @param {number} [maxRowsBytes=partQueryTunables.maxRowsBytes] 总尺寸上限
+ * @returns {unknown[] | null} 通过校验的 rows；失败 null
+ */
+export function clampPartQueryRows(rows, maxHits, maxRowsBytes = partQueryTunables.maxRowsBytes) {
+	if (!Array.isArray(rows)) return null
+	const limited = rows.slice(0, Math.max(0, Math.floor(Number(maxHits) || 0)))
+	if (measureJsonBytes(limited) > maxRowsBytes) return null
+	return limited
+}
+
+/** requestId 上限（randomUUID 36 字符；防超长键灌爆 dedupe/pending 表） */
+const REQUEST_ID_MAX_LENGTH = 128
+
+/**
+ * @param {unknown} value 原始 requestId
+ * @returns {string | null} 修剪后的 requestId；非法 null
+ */
+function normalizeRequestId(value) {
+	const requestId = String(value || '').trim()
+	if (!requestId || requestId.length > REQUEST_ID_MAX_LENGTH) return null
+	return requestId
+}
+
+/**
+ * @param {unknown} value 入站 req
+ * @param {typeof partQueryTunables} [tunables] 可调参数
+ * @returns {PartQueryReq | null} 校验通过的 req
+ */
+export function parsePartQueryReq(value, tunables = partQueryTunables) {
+	if (!isPlainObject(value)) return null
+	const requestId = normalizeRequestId(value.requestId)
+	if (!requestId) return null
+	const originNodeHash = normalizeHex64(value.originNodeHash)
+	if (!isHex64(originNodeHash)) return null
+	const partpath = normalizePartpath(value.partpath)
+	if (!partpath) return null
+	const kind = String(value.kind || '').trim()
+	if (!kind) return null
+	if (!Object.prototype.hasOwnProperty.call(value, 'query')) return null
+	if (measureJsonBytes(value.query) > (tunables.maxQueryBytes ?? 2048)) return null
+	const ttl = clampPartQueryTtl(value.ttl, tunables.maxTtl)
+	if (ttl == null) return null
+	const budget = clampPartQueryBudget(value.budget, tunables.maxHits)
+	return {
+		requestId,
+		originNodeHash,
+		partpath,
+		kind,
+		query: value.query,
+		ttl,
+		budget,
+	}
+}
+
+/**
+ * @param {unknown} value 入站 res
+ * @param {typeof partQueryTunables} [tunables] 可调参数
+ * @returns {PartQueryRes | null} 校验通过的 res
+ */
+export function parsePartQueryRes(value, tunables = partQueryTunables) {
+	if (!isPlainObject(value)) return null
+	const requestId = normalizeRequestId(value.requestId)
+	if (!requestId) return null
+	const fromNodeHash = normalizeHex64(value.fromNodeHash)
+	if (!isHex64(fromNodeHash)) return null
+	const rows = clampPartQueryRows(value.rows, tunables.maxHits, tunables.maxRowsBytes)
+	if (!rows) return null
+	return { requestId, fromNodeHash, rows }
+}
+
+/**
+ * @param {unknown} partpath part 路径
+ * @param {unknown} kind 查询标签
+ * @param {unknown} query 不透明查询
+ * @returns {string | null} 规范化三元组的缓存材料；非法 null
+ */
+export function normalizePartQueryCacheMaterial(partpath, kind, query) {
+	const path = normalizePartpath(partpath)
+	const k = String(kind || '').trim()
+	if (!path || !k) return null
+	if (measureJsonBytes(query) > partQueryTunables.maxQueryBytes) return null
+	try {
+		return canonicalStringify({ partpath: path, kind: k, query })
+	}
+	catch {
+		return null
+	}
+}

package/timeline/append_core.mjs

@@ -14,17 +14,17 @@ import { computeDagTipIdsFromEvents } from '../governance/branch.mjs'
  * 为追加事件计算 HLC 与 DAG 前驱（chat 群与 social 时间线共用）。
  * @param {object[]} previous 已有事件
  * @param {object} event 待追加事件
- * @param {{ multiTip?: boolean }} [opts] chat 在多 tip 时连接全部 tip
+ * @param {{ multiTip?: boolean }} [options] chat 在多 tip 时连接全部 tip
  * @returns {{ hlc: object, prev_event_ids: string[], last: object | undefined }} HLC、前驱与末条事件
  */
-export function computeAppendHlcAndPrev(previous, event, opts = {}) {
+export function computeAppendHlcAndPrev(previous, event, options = {}) {
 	const last = previous[previous.length - 1]
 	const hlc = nextHlc(last?.hlc, event.timestamp ?? Date.now())
 	const tips = computeDagTipIdsFromEvents(previous)
 	let prev_event_ids
 	if (event.prev_event_ids?.length)
 		prev_event_ids = sortedPrevEventIds(event.prev_event_ids)
-	else if (opts.multiTip && tips.length > 1)
+	else if (options.multiTip && tips.length > 1)
 		prev_event_ids = sortedPrevEventIds(tips)
 	else if (tips.length)
 		prev_event_ids = sortedPrevEventIds(tips)

package/transport/group_link_set.mjs

@@ -14,22 +14,22 @@ import { resolveFederationPoolLimits, selectLinkTargetsFromMembers } from './pee
 
 /**
  * 创建基于 link registry 的群组联邦房间。
- * @param {object} opts 选项
- * @param {string} opts.groupId 群组 id
- * @param {string} opts.roomSecret 房间密钥（用于 rendezvous topic）
- * @param {string[]} opts.members 初始成员 nodeHash 列表
- * @param {object} [opts.groupSettings] 群设置（连接预算：trustedPeerSlots/explorePeerSlots/maxPeers 等）
- * @returns {{ groupId: string, scope: string, start: () => Promise<void>, leave: () => Promise<void>, getRoster: () => Array<{ peerId: string, remoteNodeHash: string }>, getPeerIdByNodeHash: (nodeHash: string) => string | null, sendToPeer: (peerId: string, actionName: string, payload: unknown) => Promise<boolean>, send: (actionName: string, payload: unknown, peerId?: string | null) => Promise<number>, onEnvelope: (cb: (senderNodeHash: string, envelope: object) => void) => () => void, onPeerJoin: (cb: (peerId: string) => void) => () => void, onPeerLeave: (cb: (peerId: string) => void) => () => void, getPeers: () => Record<string, true>, makeAction: (name: string) => [(payload: unknown, peerId?: string | string[] | null) => Promise<void>, (handler: (payload: unknown, peerId: string) => void) => void], registerCleanup: (fn: () => void) => void, isActive: () => boolean }} 群组 link set 接口
+ * @param {object} options 选项
+ * @param {string} options.groupId 群组 id
+ * @param {string} options.roomSecret 房间密钥（用于 rendezvous topic）
+ * @param {string[]} options.members 初始成员 nodeHash 列表
+ * @param {object} [options.groupSettings] 群设置（连接预算：trustedPeerSlots/explorePeerSlots/maxPeers 等）
+ * @returns {{ groupId: string, scope: string, start: () => Promise<void>, leave: () => Promise<void>, getRoster: () => Array<{ peerId: string, remoteNodeHash: string }>, getPeerIdByNodeHash: (nodeHash: string) => string | null, sendToPeer: (peerId: string, actionName: string, payload: unknown) => Promise<boolean>, send: (actionName: string, payload: unknown, peerId?: string | null) => Promise<number>, onEnvelope: (callback: (senderNodeHash: string, envelope: object) => void) => () => void, onPeerJoin: (callback: (peerId: string) => void) => () => void, onPeerLeave: (callback: (peerId: string) => void) => () => void, getPeers: () => Record<string, true>, makeAction: (name: string) => [(payload: unknown, peerId?: string | string[] | null) => Promise<void>, (handler: (payload: unknown, peerId: string) => void) => void], registerCleanup: (cleanup: () => void) => void, isActive: () => boolean }} 群组 link set 接口
  */
-export function createGroupLinkSet(opts) {
-	const registry = opts.registry ?? getLinkRegistry()
-	const autoconnect = opts.autoconnect !== false
-	const groupId = String(opts.groupId)
+export function createGroupLinkSet(options) {
+	const registry = options.registry ?? getLinkRegistry()
+	const autoconnect = options.autoconnect !== false
+	const groupId = String(options.groupId)
 	const scope = `group:${groupId}`
-	const topic = groupRendezvousTopic(opts.roomSecret)
-	const members = new Set((Array.isArray(opts.members) ? opts.members : []).map(String))
+	const topic = groupRendezvousTopic(options.roomSecret)
+	const members = new Set((Array.isArray(options.members) ? options.members : []).map(String))
 	const selfNodeHash = registry.localIdentity.nodeHash
-	const groupSettings = opts.groupSettings ?? {}
+	const groupSettings = options.groupSettings ?? {}
 	// 初始成员是调用方明确知道的引导集合（如 introducer/creator/seed），作为必连锚点保证引导期连通。
 	const initialAnchors = new Set(members)
 	/** @type {ReturnType<typeof setTimeout> | null} */
@@ -50,12 +50,12 @@ export function createGroupLinkSet(opts) {
 
 	/**
 	 * 注册 leave 时执行的清理回调。
-	 * @param {() => void} fn 清理函数
+	 * @param {() => void} cleanup 清理函数
 	 * @returns {void}
 	 */
-	function registerCleanup(fn) {
-		if (typeof fn !== 'function') return
-		cleanups.add(fn)
+	function registerCleanup(cleanup) {
+		if (typeof cleanup !== 'function') return
+		cleanups.add(cleanup)
 	}
 
 	/**
@@ -255,34 +255,34 @@ export function createGroupLinkSet(opts) {
 		},
 		/**
 		 * 订阅入站 envelope。
-		 * @param {(senderNodeHash: string, envelope: object) => void} cb 回调
+		 * @param {(senderNodeHash: string, envelope: object) => void} callback 回调
 		 * @returns {() => void} 取消订阅函数
 		 */
-		onEnvelope(cb) {
-			envelopeListeners.add(cb)
-			return () => envelopeListeners.delete(cb)
+		onEnvelope(callback) {
+			envelopeListeners.add(callback)
+			return () => envelopeListeners.delete(callback)
 		},
 		/**
 		 * 订阅 peer 加入事件（含当前已在线 peer 的即时回调）。
-		 * @param {(peerId: string) => void} cb 回调
+		 * @param {(peerId: string) => void} callback 回调
 		 * @returns {() => void} 取消订阅函数
 		 */
-		onPeerJoin(cb) {
-			peerJoinListeners.add(cb)
+		onPeerJoin(callback) {
+			peerJoinListeners.add(callback)
 			for (const { peerId } of activeRoster())
 				if (peerId) announcedPeers.add(peerId)
 			for (const peerId of announcedPeers)
-				try { cb(peerId) } catch { /* ignore */ }
-			return () => peerJoinListeners.delete(cb)
+				try { callback(peerId) } catch { /* ignore */ }
+			return () => peerJoinListeners.delete(callback)
 		},
 		/**
 		 * 订阅 peer 离开事件。
-		 * @param {(peerId: string) => void} cb 回调
+		 * @param {(peerId: string) => void} callback 回调
 		 * @returns {() => void} 取消订阅函数
 		 */
-		onPeerLeave(cb) {
-			peerLeaveListeners.add(cb)
-			return () => peerLeaveListeners.delete(cb)
+		onPeerLeave(callback) {
+			peerLeaveListeners.add(callback)
+			return () => peerLeaveListeners.delete(callback)
 		},
 		/**
 		 * 返回当前在线 peer 的 Record 映射。

package/transport/ice_servers.mjs

@@ -47,14 +47,6 @@ export function resolveIceServers(groupSettings) {
 	return out.length ? out : [...DEFAULT_ICE_SERVERS]
 }
 
-/**
- * @param {unknown} groupSettings 物化群设置
- * @returns {{ iceServers: ReturnType<typeof resolveIceServers> }} Trystero rtcConfig 片段
- */
-export function resolveIceServersForTrystero(groupSettings) {
-	return { iceServers: resolveIceServers(groupSettings) }
-}
-
 /**
  * 校验并规范化待写入 DAG 的 iceServers 数组。
  * @param {unknown} raw 请求体字段

package/transport/link_registry.mjs

@@ -187,20 +187,20 @@ function subscribeBucket(buckets, key, listener) {
 
 /**
  * 创建 P2P 链路注册表（discovery、信令、直连与 overlay relay）。
- * @param {object} [opts] 选项
- * @param {{ nodeHash?: string, nodePubKey?: string, secretKey?: Uint8Array }} [opts.localIdentity] 本地身份
- * @param {typeof createLink} [opts.createLink] 链路工厂（可注入 mock）
- * @param {RTCConfiguration['iceServers']} [opts.iceServers] ICE 服务器列表
- * @param {number} [opts.maxActive] 最大并发活跃链路数
- * @param {boolean} [opts.autoRegisterDiscoveryProviders] 是否自动注册 discovery provider
+ * @param {object} [options] 选项
+ * @param {{ nodeHash?: string, nodePubKey?: string, secretKey?: Uint8Array }} [options.localIdentity] 本地身份
+ * @param {typeof createLink} [options.createLink] 链路工厂（可注入 mock）
+ * @param {RTCConfiguration['iceServers']} [options.iceServers] ICE 服务器列表
+ * @param {number} [options.maxActive] 最大并发活跃链路数
+ * @param {boolean} [options.autoRegisterDiscoveryProviders] 是否自动注册 discovery provider
  * @returns {object} link registry 接口
  */
-export function createLinkRegistry(opts = {}) {
-	const localIdentity = resolveLocalIdentity(opts.localIdentity)
-	const createLinkImpl = opts.createLink ?? createLink
-	const iceServers = opts.iceServers?.length ? opts.iceServers : DEFAULT_ICE_SERVERS
-	const maxActive = Math.max(4, Number(opts.maxActive) || 32)
-	const autoRegisterDiscoveryProviders = opts.autoRegisterDiscoveryProviders !== false
+export function createLinkRegistry(options = {}) {
+	const localIdentity = resolveLocalIdentity(options.localIdentity)
+	const createLinkImpl = options.createLink ?? createLink
+	const iceServers = options.iceServers?.length ? options.iceServers : DEFAULT_ICE_SERVERS
+	const maxActive = Math.max(4, Number(options.maxActive) || 32)
+	const autoRegisterDiscoveryProviders = options.autoRegisterDiscoveryProviders !== false
 	const selfTopic = nodeRendezvousTopic(localIdentity.nodeHash)
 	/** @type {Map<string, Awaited<ReturnType<typeof createLinkImpl>>>} */
 	const links = new Map()
@@ -348,7 +348,7 @@ export function createLinkRegistry(opts = {}) {
 	/**
 	 * 为一条 connId 会话建 PC 并走 glare 择一：建 link → 绑 onDown 清 session → ready → registerResolvedLink。
 	 * initiator 侧建链前先 trimToBudget 腾预算。出错则清理该 connId 会话。
-	 * @param {{ remoteNodeHash: string, connId: string, session: ReturnType<typeof createBufferedSignalSession>, initiator: boolean }} opts 建链参数
+	 * @param {{ remoteNodeHash: string, connId: string, session: ReturnType<typeof createBufferedSignalSession>, initiator: boolean }} options 建链参数
 	 * @returns {Promise<Awaited<ReturnType<typeof createLinkImpl>> | null>} 当前规范链（本条可能因 glare 被关，取 links 现值）；失败 null
 	 */
 	async function buildConnLink({ remoteNodeHash, connId, session, initiator }) {