@steve02081504/fount-p2p 0.0.4 → 0.0.6

package/governance/join_pow.mjs

@@ -85,40 +85,40 @@ export function powVoluntaryBonus(achievedBits, floorBits, tunables = admissionT
 
 /**
  * @param {object} powSolution 客户端 solution
- * @param {object} opts 校验上下文
- * @param {string} opts.groupId 群 ID
- * @param {string} opts.senderNodeHash 签名者 nodeHash（须与 joiner 绑定）
- * @param {string[]} opts.knownAnchors 近期 tip / checkpoint root 列表
- * @param {number} [opts.now=Date.now()] 当前时间
- * @param {number} [opts.difficultyBits=0] 准入 floor（前导零 bit）
- * @param {number} [opts.epochMs=JOIN_POW_DEFAULT_EPOCH_MS] epoch 长度
- * @param {number} [opts.epochSkew=JOIN_POW_DEFAULT_EPOCH_SKEW] 允许 epoch 偏移
+ * @param {object} options 校验上下文
+ * @param {string} options.groupId 群 ID
+ * @param {string} options.senderNodeHash 签名者 nodeHash（须与 joiner 绑定）
+ * @param {string[]} options.knownAnchors 近期 tip / checkpoint root 列表
+ * @param {number} [options.now=Date.now()] 当前时间
+ * @param {number} [options.difficultyBits=0] 准入 floor（前导零 bit）
+ * @param {number} [options.epochMs=JOIN_POW_DEFAULT_EPOCH_MS] epoch 长度
+ * @param {number} [options.epochSkew=JOIN_POW_DEFAULT_EPOCH_SKEW] 允许 epoch 偏移
  * @returns {{ ok: boolean, achievedBits: number }} 校验结果与实际达成 bit
  */
-export function verifyJoinPow(powSolution, opts) {
-	const floorBits = Math.max(0, Math.floor(Number(opts.difficultyBits) || 0))
+export function verifyJoinPow(powSolution, options) {
+	const floorBits = Math.max(0, Math.floor(Number(options.difficultyBits) || 0))
 	if (floorBits <= 0) return { ok: true, achievedBits: 0 }
 	if (!powSolution || typeof powSolution !== 'object') return { ok: false, achievedBits: 0 }
 
 	const anchorRef = String(powSolution.anchorRef ?? '').trim()
 	const { nonce } = powSolution
 	const epoch = Number(powSolution.epoch)
-	const joinerNodeHash = String(powSolution.joinerNodeHash ?? opts.senderNodeHash ?? '').trim().toLowerCase()
-	const senderNodeHash = String(opts.senderNodeHash ?? '').trim().toLowerCase()
+	const joinerNodeHash = String(powSolution.joinerNodeHash ?? options.senderNodeHash ?? '').trim().toLowerCase()
+	const senderNodeHash = String(options.senderNodeHash ?? '').trim().toLowerCase()
 
 	if (!anchorRef || nonce == null || !Number.isFinite(epoch)) return { ok: false, achievedBits: 0 }
 	if (!joinerNodeHash || joinerNodeHash !== senderNodeHash) return { ok: false, achievedBits: 0 }
 
-	const anchors = (opts.knownAnchors ?? []).map(a => String(a).trim()).filter(Boolean)
+	const anchors = (options.knownAnchors ?? []).map(a => String(a).trim()).filter(Boolean)
 	if (!anchors.length || !anchors.includes(anchorRef)) return { ok: false, achievedBits: 0 }
 
-	const epochMs = Math.max(60_000, Number(opts.epochMs) || JOIN_POW_DEFAULT_EPOCH_MS)
-	const skew = Math.max(0, Math.floor(Number(opts.epochSkew) ?? JOIN_POW_DEFAULT_EPOCH_SKEW))
-	const nowEpoch = Math.floor((opts.now ?? Date.now()) / epochMs)
+	const epochMs = Math.max(60_000, Number(options.epochMs) || JOIN_POW_DEFAULT_EPOCH_MS)
+	const skew = Math.max(0, Math.floor(Number(options.epochSkew) ?? JOIN_POW_DEFAULT_EPOCH_SKEW))
+	const nowEpoch = Math.floor((options.now ?? Date.now()) / epochMs)
 	if (Math.abs(epoch - nowEpoch) > skew) return { ok: false, achievedBits: 0 }
 
 	const hash = computeJoinPowHash({
-		groupId: opts.groupId,
+		groupId: options.groupId,
 		anchorRef,
 		joinerNodeHash,
 		epoch,

package/link/channel_mux.mjs

@@ -38,6 +38,8 @@ const DEFAULT_ACTION_PRIORITIES = Object.freeze({
 	discovery_query_response: 3,
 	part_invoke: 3,
 	part_invoke_response: 3,
+	part_query_req: 5,
+	part_query_res: 5,
 	char_rpc: 3,
 	fed_chunk_put: 5,
 	fed_chunk_get: 5,
@@ -108,15 +110,15 @@ export function configureBufferedAmountLowThreshold(channel, thresholdBytes = CH
 /**
  * 订阅 bufferedamountlow 事件，返回取消订阅函数。
  * @param {RTCDataChannel} channel RTC 数据通道
- * @param {() => void} cb 低水位回调
+ * @param {() => void} callback 低水位回调
  * @returns {() => void} 取消订阅函数
  */
-export function onBufferedAmountLow(channel, cb) {
+export function onBufferedAmountLow(channel, callback) {
 	/**
 	 * bufferedamountlow 事件处理函数。
 	 * @returns {void}
 	 */
-	const handler = () => cb()
+	const handler = () => callback()
 	channel.addEventListener?.('bufferedamountlow', handler)
 	channel.onbufferedamountlow = handler
 	if (channel.bufferedAmountLow?.subscribe)
@@ -129,12 +131,12 @@ export function onBufferedAmountLow(channel, cb) {
 
 /**
  * 创建带优先级队列的双通道发送器（control/bulk）。
- * @param {{ getChannel: (name: 'control' | 'bulk') => RTCDataChannel | null | undefined, highWatermarkBytes?: number }} opts 通道访问与高水位配置
+ * @param {{ getChannel: (name: 'control' | 'bulk') => RTCDataChannel | null | undefined, highWatermarkBytes?: number }} options 通道访问与高水位配置
  * @returns {{ enqueue: (action: string, bytes: Uint8Array, preferredChannel?: 'control' | 'bulk') => void, flush: (channelName?: 'control' | 'bulk') => void, pending: () => { control: number, bulk: number }, clear: () => void }} 发送队列 API
  */
-export function createChannelSendQueues(opts) {
-	const { getChannel } = opts
-	const highWatermarkBytes = Math.max(CHANNEL_LOW_THRESHOLD_BYTES, Number(opts.highWatermarkBytes) || CHANNEL_HIGH_WATERMARK_BYTES)
+export function createChannelSendQueues(options) {
+	const { getChannel } = options
+	const highWatermarkBytes = Math.max(CHANNEL_LOW_THRESHOLD_BYTES, Number(options.highWatermarkBytes) || CHANNEL_HIGH_WATERMARK_BYTES)
 	/** @type {{ control: Array<{ priority: number, seq: number, bytes: Uint8Array }>, bulk: Array<{ priority: number, seq: number, bytes: Uint8Array }> }} */
 	const queues = { control: [], bulk: [] }
 	/** @type {{ control: boolean, bulk: boolean }} */

package/link/frame.mjs

@@ -150,13 +150,13 @@ function concatChunks(chunks) {
 
 /**
  * 创建分片消息重组器。
- * @param {{ maxMessageBytes?: number, maxPartials?: number, partialTimeoutMs?: number }} [opts] 大小、并发分片数与超时配置
+ * @param {{ maxMessageBytes?: number, maxPartials?: number, partialTimeoutMs?: number }} [options] 大小、并发分片数与超时配置
  * @returns {{ push: (frame: Uint8Array | ArrayBuffer | ArrayBufferView, now?: number) => Uint8Array | null, prune: (now?: number) => string[], clear: () => void, size: () => number }} 重组器 API
  */
-export function createReassembler(opts = {}) {
-	const maxMessageBytes = Math.max(1024, Number(opts.maxMessageBytes) || DEFAULT_MAX_MESSAGE_BYTES)
-	const maxPartials = Math.max(1, Number(opts.maxPartials) || DEFAULT_MAX_PARTIAL_MESSAGES)
-	const partialTimeoutMs = Math.max(1000, Number(opts.partialTimeoutMs) || DEFAULT_PARTIAL_TIMEOUT_MS)
+export function createReassembler(options = {}) {
+	const maxMessageBytes = Math.max(1024, Number(options.maxMessageBytes) || DEFAULT_MAX_MESSAGE_BYTES)
+	const maxPartials = Math.max(1, Number(options.maxPartials) || DEFAULT_MAX_PARTIAL_MESSAGES)
+	const partialTimeoutMs = Math.max(1000, Number(options.partialTimeoutMs) || DEFAULT_PARTIAL_TIMEOUT_MS)
 	/** @type {Map<string, { total: number, chunks: Uint8Array[], seen: boolean[], bytes: number, firstSeenAt: number, lastSeenAt: number }>} */
 	const partials = new Map()
 

package/link/handshake.mjs

@@ -34,18 +34,18 @@ export function buildAuthMessage(peerNonce, localFingerprint, localNodeHash) {
 
 /**
  * 构造 link hello 握手包。
- * @param {{ nodeHash?: string, nodePubKey?: string, nonce?: string }} [opts] 可选身份字段，省略则从本地节点种子推导
+ * @param {{ nodeHash?: string, nodePubKey?: string, nonce?: string }} [options] 可选身份字段，省略则从本地节点种子推导
  * @returns {{ v: 1, nodeHash: string, nodePubKey: string, nonce: string }} hello 对象
  */
-export function buildHello(opts = {}) {
+export function buildHello(options = {}) {
 	let publicKey = null
-	if (!opts.nodeHash || !opts.nodePubKey) {
+	if (!options.nodeHash || !options.nodePubKey) {
 		const derived = keyPairFromSeed(Buffer.from(ensureNodeSeed(), 'hex'))
 		publicKey = derived.publicKey
 	}
-	const nodeHash = normalizeHex64(opts.nodeHash || getNodeHash())
-	const nodePubKey = normalizeHex64(opts.nodePubKey || Buffer.from(publicKey).toString('hex'))
-	const nonce = normalizeHex64(opts.nonce || randomBytes(32).toString('hex'))
+	const nodeHash = normalizeHex64(options.nodeHash || getNodeHash())
+	const nodePubKey = normalizeHex64(options.nodePubKey || Buffer.from(publicKey).toString('hex'))
+	const nonce = normalizeHex64(options.nonce || randomBytes(32).toString('hex'))
 	if (!isHex64(nodeHash) || !isHex64(nodePubKey) || !isHex64(nonce))
 		throw new Error('p2p: invalid hello fields')
 	if (pubKeyHash(Buffer.from(nodePubKey, 'hex')) !== nodeHash)
@@ -57,15 +57,15 @@ export function buildHello(opts = {}) {
  * 对 link auth 消息签名。
  * @param {string} peerNonce 对端 hello 中的 nonce
  * @param {string} localFingerprint 本地 DTLS fingerprint
- * @param {{ secretKey?: Uint8Array, nodeHash?: string }} [opts] 签名密钥与 nodeHash 覆盖
+ * @param {{ secretKey?: Uint8Array, nodeHash?: string }} [options] 签名密钥与 nodeHash 覆盖
  * @returns {Promise<{ sig: string }>} hex 签名
  */
-export async function buildAuth(peerNonce, localFingerprint, opts = {}) {
-	const seed = opts.secretKey
-		? Buffer.from(opts.secretKey)
+export async function buildAuth(peerNonce, localFingerprint, options = {}) {
+	const seed = options.secretKey
+		? Buffer.from(options.secretKey)
 		: Buffer.from(ensureNodeSeed(), 'hex')
 	const { publicKey, secretKey } = keyPairFromSeed(seed)
-	const nodeHash = normalizeHex64(opts.nodeHash || pubKeyHash(publicKey))
+	const nodeHash = normalizeHex64(options.nodeHash || pubKeyHash(publicKey))
 	if (nodeHash !== pubKeyHash(publicKey))
 		throw new Error('p2p: auth nodeHash does not match secretKey')
 	const message = buildAuthMessage(peerNonce, localFingerprint, nodeHash)
@@ -133,16 +133,16 @@ export function buildAdvertMessage(topic, ts, nodeHash) {
  * 构造带签名的 discovery advert。
  * @param {string} topic 广播主题
  * @param {number} [ts=Date.now()] 时间戳（毫秒）
- * @param {{ secretKey?: Uint8Array, nodeHash?: string, nodePubKey?: string } | null} [opts] 签名身份，省略则用本地节点
+ * @param {{ secretKey?: Uint8Array, nodeHash?: string, nodePubKey?: string } | null} [options] 签名身份，省略则用本地节点
  * @returns {Promise<{ nodeHash: string, nodePubKey: string, ts: number, sig: string }>} 签名 advert
  */
-export async function buildSignedAdvert(topic, ts = Date.now(), opts = null) {
-	const seed = opts?.secretKey
-		? Buffer.from(opts.secretKey)
+export async function buildSignedAdvert(topic, ts = Date.now(), options = null) {
+	const seed = options?.secretKey
+		? Buffer.from(options.secretKey)
 		: Buffer.from(ensureNodeSeed(), 'hex')
 	const { publicKey, secretKey } = keyPairFromSeed(seed)
-	const nodeHash = normalizeHex64(opts?.nodeHash || pubKeyHash(publicKey))
-	const nodePubKey = normalizeHex64(opts?.nodePubKey || Buffer.from(publicKey).toString('hex'))
+	const nodeHash = normalizeHex64(options?.nodeHash || pubKeyHash(publicKey))
+	const nodePubKey = normalizeHex64(options?.nodePubKey || Buffer.from(publicKey).toString('hex'))
 	if (pubKeyHash(Buffer.from(nodePubKey, 'hex')) !== nodeHash)
 		throw new Error('p2p: advert nodePubKey does not match nodeHash')
 	const message = buildAdvertMessage(topic, ts, nodeHash)

package/link/link.mjs

@@ -73,27 +73,27 @@ function formatErrorReason(error) {
 
 /**
  * 建立 P2P link：WebRTC 双通道、握手、分帧收发与心跳。
- * @param {object} opts link 配置
- * @param {string | null} [opts.nodeHash] 期望的对端 nodeHash，省略则不校验
- * @param {boolean} opts.initiator 是否为连接发起方
- * @param {{ send: (message: unknown) => void | Promise<void>, onRemote: (handler: (message: unknown) => void) => (() => void) | void }} opts.signal 信令收发接口
- * @param {RTCConfiguration['iceServers']} [opts.iceServers] ICE 服务器列表
- * @param {number} [opts.heartbeatMs] 心跳间隔（毫秒）
- * @param {number} [opts.idleTimeoutMs] 无入站流量超时（毫秒）
- * @param {number} [opts.handshakeTimeoutMs] 握手超时（毫秒）
- * @param {{ RTCPeerConnection: typeof RTCPeerConnection } | null} [opts.rtc] RTC 构造器，省略则加载 polyfill
- * @param {{ nodeHash?: string, nodePubKey?: string, secretKey?: Uint8Array, nonce?: string } | null} [opts.localIdentity] 本地握手身份
- * @returns {Promise<{ ready: Promise<void>, get nodeHash(): string | null, send: (envelope: { scope: string, action: string, payload: unknown }) => Promise<boolean>, onEnvelope: (cb: (envelope: { scope: string, action: string, payload: unknown }, remoteNodeHash: string) => void) => () => void, onDown: (cb: (reason: string) => void) => () => void, close: (reason?: string) => Promise<void>, stats: () => object }>} link 句柄
+ * @param {object} options link 配置
+ * @param {string | null} [options.nodeHash] 期望的对端 nodeHash，省略则不校验
+ * @param {boolean} options.initiator 是否为连接发起方
+ * @param {{ send: (message: unknown) => void | Promise<void>, onRemote: (handler: (message: unknown) => void) => (() => void) | void }} options.signal 信令收发接口
+ * @param {RTCConfiguration['iceServers']} [options.iceServers] ICE 服务器列表
+ * @param {number} [options.heartbeatMs] 心跳间隔（毫秒）
+ * @param {number} [options.idleTimeoutMs] 无入站流量超时（毫秒）
+ * @param {number} [options.handshakeTimeoutMs] 握手超时（毫秒）
+ * @param {{ RTCPeerConnection: typeof RTCPeerConnection } | null} [options.rtc] RTC 构造器，省略则加载 polyfill
+ * @param {{ nodeHash?: string, nodePubKey?: string, secretKey?: Uint8Array, nonce?: string } | null} [options.localIdentity] 本地握手身份
+ * @returns {Promise<{ ready: Promise<void>, get nodeHash(): string | null, send: (envelope: { scope: string, action: string, payload: unknown }) => Promise<boolean>, onEnvelope: (callback: (envelope: { scope: string, action: string, payload: unknown }, remoteNodeHash: string) => void) => () => void, onDown: (callback: (reason: string) => void) => () => void, close: (reason?: string) => Promise<void>, stats: () => object }>} link 句柄
  */
-export async function createLink(opts) {
-	const heartbeatMs = Number(opts.heartbeatMs) || ms('15s')
-	const idleTimeoutMs = Number(opts.idleTimeoutMs) || ms('45s')
-	const handshakeTimeoutMs = Number(opts.handshakeTimeoutMs) || ms('10s')
+export async function createLink(options) {
+	const heartbeatMs = Number(options.heartbeatMs) || ms('15s')
+	const idleTimeoutMs = Number(options.idleTimeoutMs) || ms('45s')
+	const handshakeTimeoutMs = Number(options.handshakeTimeoutMs) || ms('10s')
 	const channelOpenTimeoutMs = Math.max(handshakeTimeoutMs, ms('30s'))
 	const trickleIceOff = getSignalingRuntimeConfig().trickleIceOff === true
-	const rtc = opts.rtc ?? await loadNodeRtcPolyfill()
-	const pc = new rtc.RTCPeerConnection(opts.iceServers?.length ? { iceServers: opts.iceServers } : undefined)
-	const targetNodeHash = normalizeHex64(opts.nodeHash || '')
+	const rtc = options.rtc ?? await loadNodeRtcPolyfill()
+	const pc = new rtc.RTCPeerConnection(options.iceServers?.length ? { iceServers: options.iceServers } : undefined)
+	const targetNodeHash = normalizeHex64(options.nodeHash || '')
 	const remoteSignalQueue = []
 	const seenRemoteSignals = createLruMap(1024)
 	let remoteDescriptionSet = false
@@ -142,7 +142,7 @@ export async function createLink(opts) {
 	 * @returns {Promise<void>}
 	 */
 	async function sendSignal(message) {
-		await Promise.resolve(opts.signal.send(message))
+		await Promise.resolve(options.signal.send(message))
 	}
 
 	/**
@@ -185,7 +185,7 @@ export async function createLink(opts) {
 		const fingerprint = localFingerprint()
 		if (!fingerprint) return
 		authSent = true
-		await sendRawControl(await buildAuth(remoteHello.nonce, fingerprint, opts.localIdentity ?? {}))
+		await sendRawControl(await buildAuth(remoteHello.nonce, fingerprint, options.localIdentity ?? {}))
 	}
 
 	/**
@@ -446,7 +446,7 @@ export async function createLink(opts) {
 		if (!helloSent) {
 			handshakeTimer = setTimeout(() => { void close('handshake-timeout') }, handshakeTimeoutMs)
 			helloSent = true
-			localHello = buildHello(opts.localIdentity ?? {})
+			localHello = buildHello(options.localIdentity ?? {})
 			await sendRawControl(localHello)
 		}
 		await maybeSendAuth()
@@ -507,7 +507,7 @@ export async function createLink(opts) {
 		emitListeners(downListeners, reason)
 	}
 
-	unlistenRemote = opts.signal.onRemote(message => {
+	unlistenRemote = options.signal.onRemote(message => {
 		void handleRemoteSignal(message).catch(error => close(`signal-error:${formatErrorReason(error)}`))
 	}) ?? null
 
@@ -535,7 +535,7 @@ export async function createLink(opts) {
 		}
 	}
 
-	if (opts.initiator) {
+	if (options.initiator) {
 		await attachChannel(pc.createDataChannel(CHANNEL_CONTROL))
 		await attachChannel(pc.createDataChannel(CHANNEL_BULK))
 		const offer = await pc.createOffer()
@@ -559,25 +559,25 @@ export async function createLink(opts) {
 		 * 本端是否为连接发起方。
 		 * @returns {boolean} 发起方标志
 		 */
-		get initiator() { return !!opts.initiator },
+		get initiator() { return !!options.initiator },
 		send,
 		/**
 		 * 订阅业务 envelope 入站。
-		 * @param {(envelope: { scope: string, action: string, payload: unknown }, remoteNodeHash: string) => void} cb 回调
+		 * @param {(envelope: { scope: string, action: string, payload: unknown }, remoteNodeHash: string) => void} callback 回调
 		 * @returns {() => void} 取消订阅函数
 		 */
-		onEnvelope(cb) {
-			envelopeListeners.add(cb)
-			return () => envelopeListeners.delete(cb)
+		onEnvelope(callback) {
+			envelopeListeners.add(callback)
+			return () => envelopeListeners.delete(callback)
 		},
 		/**
 		 * 订阅 link 断开事件。
-		 * @param {(reason: string) => void} cb 回调
+		 * @param {(reason: string) => void} callback 回调
 		 * @returns {() => void} 取消订阅函数
 		 */
-		onDown(cb) {
-			downListeners.add(cb)
-			return () => downListeners.delete(cb)
+		onDown(callback) {
+			downListeners.add(callback)
+			return () => downListeners.delete(callback)
 		},
 		close,
 		/**
@@ -597,7 +597,7 @@ export async function createLink(opts) {
 				ready,
 				nodeHash: remoteNodeHash,
 				targetNodeHash: targetNodeHash || null,
-				initiator: !!opts.initiator,
+				initiator: !!options.initiator,
 				connectionState: pc.connectionState,
 				iceConnectionState: pc.iceConnectionState,
 				lastInboundAt,

package/mailbox/deliver_or_store.mjs

@@ -59,26 +59,26 @@ async function resolveRouting(username) {
 
 /**
  * @param {string} username 副本用户名（trust graph 投递上下文）
- * @param {object} opts 投递选项
+ * @param {object} options 投递选项
  * @returns {Promise<{ stored: boolean, delivered: boolean, relayed: number }>} 存转结果
  */
-export async function deliverOrStoreMailboxPut(username, opts) {
+export async function deliverOrStoreMailboxPut(username, options) {
 	const routing = await resolveRouting(username)
-	const toPubKeyHash = normalizeHex64(opts.toPubKeyHash)
+	const toPubKeyHash = normalizeHex64(options.toPubKeyHash)
 	if (!toPubKeyHash) return { stored: false, delivered: false, relayed: 0 }
-	const hop = normalizeMailboxHop(opts.hop)
+	const hop = normalizeMailboxHop(options.hop)
 	if (hop >= routing.maxHop) return { stored: false, delivered: false, relayed: 0 }
 	const tier = mailboxTierFromHop(hop)
 	const nodeHash = getNodeHash()
 	const record = {
-		...opts.record,
+		...options.record,
 		toPubKeyHash,
 		hop,
 		tier,
-		fromNodeHash: opts.record?.fromNodeHash || nodeHash,
+		fromNodeHash: options.record?.fromNodeHash || nodeHash,
 	}
 	const stored = await storeMailboxRecord(record)
-	const toNodeHash = opts.toNodeHash?.trim().toLowerCase()
+	const toNodeHash = options.toNodeHash?.trim().toLowerCase()
 	const delivered = toNodeHash && isMailboxRecordWithinSizeLimit(record)
 		? await requireTrustGraphProvider(DEFAULT_TRUST_GRAPH_OWNER).sendToNode(username, toNodeHash, 'mailbox_put', { nodeHash, record })
 		: false
@@ -108,17 +108,17 @@ export async function publishMailboxRecord(username, toPubKeyHash, record, toNod
 }
 
 /**
- * @param {{ replicaUsername?: string }} ctx 入站上下文
+ * @param {{ replicaUsername?: string }} wireContext 入站上下文
  * @param {object} put 入站 mailbox_put
  * @param {string} [peerId] Trystero 对端 id（有则校验 nodeHash 绑定）
  * @returns {Promise<void>}
  */
-export async function ingestMailboxPut(ctx, put, peerId = '') {
+export async function ingestMailboxPut(wireContext, put, peerId = '') {
 	const { record } = put
 	if (!record?.envelope || !record?.toPubKeyHash) return
 	const fromNode = normalizeHex64(put.nodeHash)
 	if (!fromNode || !takeIncomingMailboxPutSlot(fromNode)) return
-	const username = String(ctx?.replicaUsername || '').trim()
+	const username = String(wireContext.replicaUsername || '').trim()
 	if (!username) return
 	if (peerId) {
 		const remote = await resolveRemoteNodeHashForPeer(username, peerId)
@@ -157,14 +157,14 @@ export async function respondMailboxWant(want, sendGive, peerId) {
 }
 
 /**
- * @param {{ replicaUsername?: string }} ctx 入站上下文
+ * @param {{ replicaUsername?: string }} wireContext 入站上下文
  * @param {object} give mailbox_give 载荷
  * @returns {Promise<number>} 投递给消费者的记录数
  */
-export async function ingestMailboxGive(ctx, give) {
+export async function ingestMailboxGive(wireContext, give) {
 	const records = (give.records || []).filter(isDeliverableMailboxRecord)
 	if (!records.length) return 0
-	const username = String(ctx?.replicaUsername || '').trim()
+	const username = String(wireContext.replicaUsername || '').trim()
 	if (!username) return 0
 	const { dispatchMailboxRecordsToConsumers } = await import('./consumer_registry.mjs')
 	const { deleteMailboxRecords } = await import('./store.mjs')

package/mailbox/importance.mjs

@@ -6,39 +6,6 @@
 
 const TIER_ORDER = { quarantine: 0, normal: 1, trusted: 2 }
 
-/**
- * @param {number} score 信誉分
- * @returns {MailboxTier} 分层
- */
-export function mailboxTierFromScore(score) {
-	const numericScore = Number(score)
-	if (!Number.isFinite(numericScore)) return 'quarantine'
-	if (numericScore >= 0.45) return 'trusted'
-	if (numericScore >= 0.12) return 'normal'
-	return 'quarantine'
-}
-
-/**
- * @param {object} opts 参数
- * @param {number} [opts.senderScore] 发件方信誉
- * @param {number} [opts.recipientScore] 收件方关系信誉（可选）
- * @param {boolean} [opts.knownMember] 是否本地已知成员/节点
- * @param {number} [opts.hop] 转发跳数
- * @returns {{ tier: MailboxTier, score: number }} 分层与分数
- */
-export function scoreMailboxImportance(opts = {}) {
-	const sender = Number(opts.senderScore ?? 0)
-	const recipient = Number(opts.recipientScore ?? sender)
-	const known = !!opts.knownMember
-	const hop = Math.max(0, Number(opts.hop) || 0)
-	let score = sender * 0.65 + recipient * 0.35
-	if (known) score += 0.15
-	score -= hop * 0.08
-	if (score < 0) score = 0
-	if (score > 1) score = 1
-	return { tier: mailboxTierFromScore(score), score }
-}
-
 /**
  * 按 tier 与 storedAt 排序（低 tier 先淘汰）。
  * @param {object[]} rows 记录

package/mailbox/settings.mjs

@@ -1,4 +1,3 @@
-import { getNodeTransportSettings } from '../node/identity.mjs'
 import {
 	resolveMailboxRelayFanout,
 	resolveMailboxWantFanout,
@@ -43,11 +42,3 @@ export function resolveMailboxRoutingForPeerCount(peerCount, raw = {}, batterySa
 		batterySaver: true,
 	}
 }
-
-/**
- * @returns {{ maxHop: number, relayFanoutTrusted: number, relayFanoutNormal: number, wantFanout: number, batterySaver: boolean }} mailbox 路由配置
- */
-export function getMailboxRoutingSettings() {
-	const { batterySaver, mailbox } = getNodeTransportSettings()
-	return resolveMailboxRoutingForPeerCount(0, mailbox, batterySaver)
-}

package/mailbox/wire.mjs

@@ -10,15 +10,15 @@ import { parseMailboxGive, parseMailboxPut, parseMailboxWant } from './parse.mjs
  */
 
 /**
- * @param {MailboxWireContext} ctx 入站上下文
+ * @param {MailboxWireContext} wireContext 入站上下文
  * @param {{ on: (name: string, handler: (payload: unknown, peerId: string) => void) => void, send: (name: string, payload: unknown, peerId: string | null) => void }} wire Trystero 适配器
  * @returns {void}
  */
-export function attachMailboxWire(ctx, wire) {
+export function attachMailboxWire(wireContext, wire) {
 	wire.on('mailbox_put', (payload, peerId) => {
 		const put = parseMailboxPut(payload)
 		if (!put.ok) return
-		void ingestMailboxPut(ctx, put.value, peerId).catch(err => console.error('mailbox: put ingest failed', err))
+		void ingestMailboxPut(wireContext, put.value, peerId).catch(err => console.error('mailbox: put ingest failed', err))
 	})
 
 	wire.on('mailbox_want', (payload, peerId) => {
@@ -35,6 +35,6 @@ export function attachMailboxWire(ctx, wire) {
 	wire.on('mailbox_give', payload => {
 		const give = parseMailboxGive(payload)
 		if (!give.ok) return
-		void ingestMailboxGive(ctx, give.value).catch(err => console.error('mailbox: give ingest failed', err))
+		void ingestMailboxGive(wireContext, give.value).catch(err => console.error('mailbox: give ingest failed', err))
 	})
 }

package/node/denylist.mjs

@@ -56,13 +56,6 @@ function buildDenylistIndex(blocked) {
 	return index
 }
 
-/**
- * @returns {void}
- */
-export function invalidateDenylistIndex() {
-	cachedIndex = null
-}
-
 /**
  * @returns {DenylistIndex} 缓存索引
  */
@@ -244,23 +237,6 @@ export async function addDenylistFromBanContent(banContent, groupId) {
 		await addDenylistEntry({ scope: 'subject', value: pk, ...sourceGroupId ? { groupId: sourceGroupId } : {} })
 }
 
-/**
- * @param {string} entityHash 128 位十六进制
- * @param {boolean} block true=拉黑
- * @returns {Promise<boolean>} 当前是否拉黑
- */
-export async function setEntityBlocked(entityHash, block) {
-	const id = String(entityHash || '').trim().toLowerCase()
-	if (!isEntityHash128(id)) throw new Error('invalid entityHash')
-	await mutateDenylist(() => {
-		const list = loadDenylist()
-		const without = list.blocked.filter(e => !(e.scope === 'entity' && e.value === id))
-		if (block) without.push({ scope: 'entity', value: id })
-		saveDenylist({ blocked: without })
-	})
-	return block
-}
-
 /**
  * 追加群 scope 拉黑项。
  * @param {string} groupId 群 ID

package/node/network.mjs

@@ -121,20 +121,6 @@ export function saveNetwork(data) {
 	invalidateTrustGraphCache()
 }
 
-/**
- * @param {string} nodeHash 64 位十六进制
- * @param {'trusted' | 'explore'} tier 池档位
- * @returns {void}
- */
-export function addNetworkPeer(nodeHash, tier = 'explore') {
-	const id = normalizeHex64(nodeHash)
-	if (!isHex64(id)) return
-	const net = loadNetwork()
-	const list = tier === 'trusted' ? net.trustedPeers : net.explorePeers
-	if (!list.includes(id)) list.push(id)
-	saveNetwork(net)
-}
-
 /**
  * @param {{ nodeHash: string, source: string, kind: string, weight?: number, expiresAt?: number, ttlMs?: number, groupId?: string }} hint 扩边 hint
  * @returns {void}
@@ -165,35 +151,6 @@ export function applyNetworkHint(hint) {
 	saveNetwork(net)
 }
 
-/**
- * @param {{ remoteNodeHash?: string }[]} roster Trystero roster
- * @param {string} [groupId] 来源群
- * @param {string} [source='roster'] hint 来源标签
- * @returns {void}
- */
-export function recordExplorePeersFromRoster(roster, groupId = '', source = 'roster') {
-	if (!roster?.length) return
-	const net = loadNetwork()
-	const now = Date.now()
-	for (const peer of roster) {
-		const nodeHash = normalizeHex64(peer?.remoteNodeHash)
-		if (!isHex64(nodeHash)) continue
-		if (!net.explorePeers.includes(nodeHash))
-			net.explorePeers.push(nodeHash)
-		net.hints.push({
-			nodeHash,
-			source: String(source || 'roster'),
-			kind: 'roster',
-			weight: 0.1,
-			expiresAt: now + 24 * 60 * 60 * 1000,
-			...groupId ? { groupId: String(groupId).trim() } : {},
-		})
-	}
-	net.hints = capHintsBySource(net.hints).slice(-MAX_HINTS)
-	net.lastRosterAt = now
-	saveNetwork(net)
-}
-
 /**
  * 疑似分区/eclipse 后：用 trusted 锚点加宽 explore，便于恢复联邦可达。
  * @returns {void}
@@ -239,14 +196,6 @@ export function mergeNetworkPeerPools(patch = {}) {
 	saveNetwork(net)
 }
 
-/**
- * @param {string[]} nodeHashes trusted 候选
- * @returns {void}
- */
-export function mergeTrustedPeers(nodeHashes) {
-	mergeNetworkPeerPools({ trustedPeers: nodeHashes })
-}
-
 /**
  * @param {string} groupId 群 scope
  * @param {'node' | 'subject' | 'entity'} scope denylist 作用域

package/node/personal_block.mjs

@@ -104,41 +104,6 @@ export async function loadPersonalBlockEntries(viewerEntityHash) {
 	return normalizePersonalListEntries(data?.blocked || [])
 }
 
-/**
- * @param {string} viewerEntityHash 观看者实体
- * @param {object} subject 待检主体
- * @returns {Promise<boolean>} 是否被隐藏
- */
-export async function isHiddenBy(viewerEntityHash, subject) {
-	return matchesPersonalListEntries(await loadPersonalHideEntries(viewerEntityHash), subject)
-}
-
-/**
- * @param {string} viewerEntityHash 观看者实体
- * @param {object} subject 待检主体
- * @returns {Promise<boolean>} 是否被拉黑
- */
-export async function isBlockedBy(viewerEntityHash, subject) {
-	return matchesPersonalListEntries(await loadPersonalBlockEntries(viewerEntityHash), subject)
-}
-
-/**
- * @param {string} viewerEntityHash 观看者实体
- * @param {object} subject 待检主体
- * @returns {Promise<boolean>} 是否应过滤
- */
-export async function isFilteredByPersonalLists(viewerEntityHash, subject) {
-	if (!viewerEntityHash) return false
-	const [blocked, hidden, muted] = await Promise.all([
-		loadPersonalBlockEntries(viewerEntityHash),
-		loadPersonalHideEntries(viewerEntityHash),
-		loadPersonalMuteEntries(viewerEntityHash),
-	])
-	return matchesPersonalListEntries(blocked, subject)
-		|| matchesPersonalListEntries(hidden, subject)
-		|| matchesPersonalListEntries(muted, subject)
-}
-
 /**
  * @param {string} viewerEntityHash 本地可写实体
  * @param {string} targetEntityHash 目标