@steve02081504/fount-p2p 0.0.26 → 0.0.27

package/reputation/engine.mjs

@@ -1,6 +1,8 @@
 /**
  * 信誉纯内存算子（模拟器与磁盘 store 共用）。
  */
+import { normalizeHex64 } from '../core/hexIds.mjs'
+
 import {
 	clampReputationScore,
 	computeRepMaxEff,
@@ -176,9 +178,9 @@ export function pruneReputationFile(data, tunables = reputationTunables, now = D
  * @returns {boolean} 是否已加分
  */
 export function bumpReputationOnRelayPure(data, peerNodeHash, dedupeKey, now = Date.now(), tunables = reputationTunables) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	if (!id) return false
-	const key = String(dedupeKey || `conn:${id}`).trim()
+	const key = dedupeKey || `conn:${id}`
 	data.relayBumpSeen = data.relayBumpSeen.filter(hit => now - hit.t <= tunables.relayBumpDedupeMs)
 	if (relayBumpIsDuplicate(data.relayBumpSeen, id, key, now, tunables.relayBumpDedupeMs)) return false
 	data.relayBumpSeen.push({ peerNodeHash: id, key, t: now })
@@ -213,7 +215,7 @@ export function recordGossipAllUnknownWantPure(data, peerNodeHash, now = Date.no
  * @returns {void}
  */
 export function recordMessageRateViolationPure(data, peerNodeHash, tunables = reputationTunables, excessRatio = 1) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	if (!id) return
 	const ratio = Math.max(0, Math.min(1, Number(excessRatio) || 0))
 	if (ratio <= 0) return
@@ -227,7 +229,7 @@ export function recordMessageRateViolationPure(data, peerNodeHash, tunables = re
  * @returns {void}
  */
 export function bumpChunkStorageReputationPure(data, storagePeerKey, tunables = reputationTunables) {
-	const id = String(storagePeerKey || '').trim()
+	const id = normalizeHex64(storagePeerKey)
 	if (!id) return
 	adjustNodeReputation(data, id, tunables.chunkStoreRepBump)
 }
@@ -239,7 +241,7 @@ export function bumpChunkStorageReputationPure(data, storagePeerKey, tunables =
  * @returns {void}
  */
 export function penalizeChunkStorageFailurePure(data, blamePeerKey, tunables = reputationTunables) {
-	const id = String(blamePeerKey || '').trim()
+	const id = normalizeHex64(blamePeerKey)
 	if (!id) return
 	adjustNodeReputation(data, id, -tunables.chunkFetchFailPenalty)
 }
@@ -251,7 +253,7 @@ export function penalizeChunkStorageFailurePure(data, blamePeerKey, tunables = r
  * @returns {void}
  */
 export function penalizeArchiveServeMismatchPure(data, peerNodeHash, tunables = reputationTunables) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	if (!id) return
 	adjustNodeReputation(data, id, -tunables.archiveServeMismatchPenalty)
 }
@@ -280,7 +282,7 @@ export function applySubjectiveSlashPure(data, target, sender, claim, verified,
  * @returns {Array<{ hop: number, node: string, dRep: number }>} 已应用的上游惩罚
  */
 export function applyDecayCollusionAfterSlashPure(data, targetPubKeyHash, inviteEdges, tunables = reputationTunables) {
-	const target = targetPubKeyHash.trim().toLowerCase()
+	const target = normalizeHex64(targetPubKeyHash)
 	/** @type {Array<{ hop: number, node: string, dRep: number }>} */
 	const applied = []
 	let frontier = new Set([target])
@@ -301,8 +303,8 @@ export function applyDecayCollusionAfterSlashPure(data, targetPubKeyHash, invite
 	for (let hop = 1; hop <= effectiveMaxHop(); hop++) {
 		const upstream = new Set()
 		for (const edge of inviteEdges) {
-			const to = String(edge.to ?? '').trim().toLowerCase()
-			const from = String(edge.from ?? '').trim().toLowerCase()
+			const to = normalizeHex64(edge.to)
+			const from = normalizeHex64(edge.from)
 			if (frontier.has(to) && from) upstream.add(from)
 		}
 		if (!upstream.size) break
@@ -331,7 +333,7 @@ export function applyDecayCollusionAfterSlashPure(data, targetPubKeyHash, invite
  * @returns {void}
  */
 export function applyReputationResetToScoresPure(data, targetPubKeyHash) {
-	const t = targetPubKeyHash.trim().toLowerCase()
+	const t = normalizeHex64(targetPubKeyHash)
 	const row = repRow(data, t)
 	row.score = 0
 	delete row.offenseStreak
@@ -351,8 +353,8 @@ export function applyReputationResetToScoresPure(data, targetPubKeyHash) {
  * @returns {void}
  */
 export function seedMemberReputationFromIntroducerPure(data, memberPubKeyHash, introducerPubKeyHash, repEdge, tunables = reputationTunables, powBonus = 0) {
-	const memberKey = memberPubKeyHash.trim().toLowerCase()
-	const introducerKey = introducerPubKeyHash?.trim().toLowerCase() || ''
+	const memberKey = normalizeHex64(memberPubKeyHash)
+	const introducerKey = normalizeHex64(introducerPubKeyHash)
 	if (data.byNodeHash[memberKey]) return
 	const introducerReputation = introducerKey
 		? Number(data.byNodeHash[introducerKey]?.score ?? 0)
@@ -392,7 +394,7 @@ function baselineRow(row) {
  * @returns {{ z: number, anomaly: boolean }} 偏离度
  */
 export function observeBehaviorSamplePure(data, peerNodeHash, sample, now = Date.now(), tunables = reputationTunables) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	if (!id) return { z: 0, anomaly: false }
 	const row = repRow(data, id)
 	const baseline = baselineRow(row)
@@ -427,7 +429,7 @@ export function observeBehaviorSamplePure(data, peerNodeHash, sample, now = Date
  * @returns {void}
  */
 export function applyQuarantinePure(data, peerNodeHash, now = Date.now(), tunables = reputationTunables) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	if (!id) return
 	const row = repRow(data, id)
 	row.quarantinedUntil = now + Number(tunables.quarantineTtlMs ?? 900_000)
@@ -441,7 +443,7 @@ export function applyQuarantinePure(data, peerNodeHash, now = Date.now(), tunabl
  * @returns {boolean} 是否处于本地隔离
  */
 export function isQuarantinedPure(data, peerNodeHash, now = Date.now()) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	const until = Number(data.byNodeHash?.[id]?.quarantinedUntil ?? 0)
 	return Number.isFinite(until) && until > now
 }

package/schemas/discovery.mjs

@@ -9,9 +9,9 @@ const MAX_DISCOVERY_ADS = 64
  */
 function sanitizeDiscoveryAdvertisement(ad) {
 	if (!isPlainObject(ad)) return null
-	const groupId = String(ad.groupId || '').trim()
+	const groupId = String(ad.groupId || '')
 	const advertiserPubKeyHash = normalizeHex64(ad.advertiserPubKeyHash)
-	const signature = String(ad.signature || '').trim().toLowerCase()
+	const signature = String(ad.signature || '')
 	if (!groupId || !isHex64(advertiserPubKeyHash) || !isSignatureHex128(signature)) return null
 	const advertiserNodeHash = normalizeHex64(ad.advertiserNodeHash)
 	const body = {
@@ -19,7 +19,7 @@ function sanitizeDiscoveryAdvertisement(ad) {
 		title: String(ad.title || '').slice(0, 200),
 		blurb: String(ad.blurb || '').slice(0, 500),
 		advertiserPubKeyHash,
-		advertiserNodeHash: isHex64(advertiserNodeHash) ? advertiserNodeHash : String(ad.advertiserNodeHash || '').trim(),
+		advertiserNodeHash: isHex64(advertiserNodeHash) ? advertiserNodeHash : String(ad.advertiserNodeHash || ''),
 		observedAt: Number(ad.observedAt) || 0,
 		signature,
 	}
@@ -47,10 +47,10 @@ export function assertDiscoveryNodeHash(nodeHash) {
 
 /**
  * @param {unknown} requestId 请求 id
- * @returns {string} 非空 trimmed 字符串
+ * @returns {string} 非空字符串
  */
 export function assertDiscoveryRequestId(requestId) {
-	const id = String(requestId ?? '').trim()
+	const id = String(requestId ?? '')
 	if (!id) throw new Error('discovery.requestId required')
 	return id
 }

package/schemas/federation_pull.mjs

@@ -14,7 +14,7 @@ const ENVELOPE_BLOB_MIN_LEN = 2
  * @returns {boolean} 是否像合法 ECIES blob 段
  */
 function isEnvelopeBlob(value) {
-	return String(value ?? '').trim().length >= ENVELOPE_BLOB_MIN_LEN
+	return String(value ?? '').length >= ENVELOPE_BLOB_MIN_LEN
 }
 
 /**
@@ -24,14 +24,14 @@ function isEnvelopeBlob(value) {
 export function parsePullAttestation(attestation) {
 	if (!isPlainObject(attestation)) return null
 	const requesterPubKeyHash = normalizeHex64(attestation.requesterPubKeyHash)
-	const groupId = String(attestation.groupId || '').trim()
-	const requestId = String(attestation.requestId || '').trim()
+	const groupId = String(attestation.groupId || '')
+	const requestId = String(attestation.requestId || '')
 	const timestamp = Number(attestation.timestamp)
-	const signature = String(attestation.signature || '').trim().toLowerCase()
+	const signature = String(attestation.signature || '')
 	if (!isHex64(requesterPubKeyHash) || !groupId || !Number.isFinite(timestamp) || !isSignatureHex128(signature))
 		return null
 	const wantIds = attestation.wantIds?.length
-		? [...new Set(attestation.wantIds.map(id => id.trim().toLowerCase()).filter(id => EVENT_ID_HEX.test(id)))]
+		? [...new Set(attestation.wantIds.map(id => normalizeHex64(id)).filter(id => EVENT_ID_HEX.test(id)))]
 		: undefined
 	return {
 		requesterPubKeyHash,
@@ -49,13 +49,13 @@ export function parsePullAttestation(attestation) {
  */
 export function parsePullResponseEnvelope(envelope) {
 	if (!isPlainObject(envelope)) return null
-	const requestId = String(envelope.requestId || '').trim()
+	const requestId = String(envelope.requestId || '')
 	const requesterPubKeyHash = normalizeHex64(envelope.requesterPubKeyHash)
-	const requesterNodeHash = String(envelope.requesterNodeHash || '').trim()
-	const ephemPub = String(envelope.ephemPub || '').trim()
-	const iv = String(envelope.iv || '').trim()
-	const ciphertext = String(envelope.ciphertext || '').trim()
-	const authTag = String(envelope.authTag || '').trim()
+	const requesterNodeHash = String(envelope.requesterNodeHash || '')
+	const ephemPub = String(envelope.ephemPub || '')
+	const iv = String(envelope.iv || '')
+	const ciphertext = String(envelope.ciphertext || '')
+	const authTag = String(envelope.authTag || '')
 	if (!requestId || !isHex64(requesterPubKeyHash) || !requesterNodeHash) return null
 	if (!isEnvelopeBlob(ephemPub) || !isEnvelopeBlob(iv) || !isEnvelopeBlob(ciphertext) || !isEnvelopeBlob(authTag))
 		return null
@@ -76,27 +76,19 @@ export function parsePullResponseEnvelope(envelope) {
  */
 export function parseJoinSnapshotRequest(data) {
 	if (!isPlainObject(data)) return null
-	const requestId = String(data.requestId || '').trim()
-	const requesterNodeHash = String(data.requesterNodeHash || '').trim()
-	const groupId = String(data.groupId || '').trim()
+	const requestId = String(data.requestId || '')
+	const requesterNodeHash = String(data.requesterNodeHash || '')
+	const groupId = String(data.groupId || '')
 	const attestation = parsePullAttestation(data.attestation)
 	if (!requestId || !requesterNodeHash || !groupId || !attestation) return null
 	if (attestation.groupId !== groupId || attestation.requestId !== requestId) return null
-	const tipsHash = String(data.tipsHash || '').trim()
+	const tipsHash = String(data.tipsHash || '')
 	return {
 		requestId,
 		requesterNodeHash,
 		requesterPubKeyHash: attestation.requesterPubKeyHash,
 		groupId,
-		tipsHash: tipsHash ? tipsHash.toLowerCase() : undefined,
+		tipsHash: tipsHash || undefined,
 		attestation,
 	}
 }
-
-/**
- * @param {unknown} data 入群快照响应载荷
- * @returns {object | null} 解析结果
- */
-export function parseJoinSnapshotResponse(data) {
-	return parsePullResponseEnvelope(data)
-}

package/schemas/part_query.mjs

@@ -82,10 +82,10 @@ const REQUEST_ID_MAX_LENGTH = 128
 
 /**
  * @param {unknown} value 原始 requestId
- * @returns {string | null} 修剪后的 requestId；非法 null
+ * @returns {string | null} 合法 requestId；非法 null
  */
 function normalizeRequestId(value) {
-	const requestId = String(value || '').trim()
+	const requestId = String(value || '')
 	if (!requestId || requestId.length > REQUEST_ID_MAX_LENGTH) return null
 	return requestId
 }
@@ -103,7 +103,7 @@ export function parsePartQueryReq(value, tunables = partQueryTunables) {
 	if (!isHex64(originNodeHash)) return null
 	const partpath = parsePartpath(value.partpath)
 	if (!partpath) return null
-	const kind = String(value.kind || '').trim()
+	const kind = String(value.kind || '')
 	if (!kind) return null
 	if (!Object.prototype.hasOwnProperty.call(value, 'query')) return null
 	if (measureJsonBytes(value.query) > (tunables.maxQueryBytes ?? 2048)) return null
@@ -145,7 +145,7 @@ export function parsePartQueryRes(value, tunables = partQueryTunables) {
  */
 export function normalizePartQueryCacheMaterial(partpath, kind, query) {
 	const path = parsePartpath(partpath)
-	const k = String(kind || '').trim()
+	const k = String(kind || '')
 	if (!path || !k) return null
 	if (measureJsonBytes(query) > partQueryTunables.maxQueryBytes) return null
 	try {

package/timeline/verify_remote.mjs

@@ -3,7 +3,7 @@
  */
 import { Buffer } from 'node:buffer'
 
-import { isHex64, isSignatureHex128 } from '../core/hexIds.mjs'
+import { isHex64, isSignatureHex128, normalizeHex64 } from '../core/hexIds.mjs'
 import { pubKeyHash, verify } from '../crypto/crypto.mjs'
 import { eventBodyForSign, signPayloadBytes } from '../dag/index.mjs'
 
@@ -12,11 +12,11 @@ import { eventBodyForSign, signPayloadBytes } from '../dag/index.mjs'
  * @returns {Promise<boolean>} 验签是否通过
  */
 export async function verifyTimelineRemoteSignature(event) {
-	const sender = String(event?.sender || '').trim().toLowerCase()
+	const sender = normalizeHex64(event?.sender)
 	if (!isHex64(sender)) return false
-	const signatureHex = String(event?.signature || '').trim()
+	const signatureHex = String(event?.signature || '')
 	if (!isSignatureHex128(signatureHex)) return false
-	const pubKeyHex = String(event?.senderPubKey || '').trim().toLowerCase()
+	const pubKeyHex = normalizeHex64(event?.senderPubKey)
 	if (!isHex64(pubKeyHex)) return false
 	const publicKeyBytes = new Uint8Array(Buffer.from(pubKeyHex, 'hex'))
 	if (pubKeyHash(publicKeyBytes) !== sender) return false

package/transport/group_link_set.mjs

@@ -59,7 +59,7 @@ export function createGroupLinkSet(options) {
 	 * @returns {void}
 	 */
 	function registerCleanup(cleanup) {
-		if (typeof cleanup !== 'function') return
+		if (!cleanup) return
 		cleanups.add(cleanup)
 	}
 
@@ -182,7 +182,7 @@ export function createGroupLinkSet(options) {
 		}
 		started = true
 		active = true
-		if (typeof registry.ensureRuntime === 'function')
+		if (registry.ensureRuntime)
 			await registry.ensureRuntime()
 		registry.registerScopeInterest(scope, [...members])
 		registerCleanup(registry.subscribeScope(scope, (senderNodeHash, envelope) => {

package/transport/ice_servers.mjs

@@ -27,8 +27,8 @@ function normalizeIceEntry(raw) {
 	if (!raw || typeof raw !== 'object') return null
 	const urlsRaw = raw.urls
 	const urlsList = Array.isArray(urlsRaw)
-		? urlsRaw.map(u => String(u).trim()).filter(Boolean)
-		: [String(urlsRaw || '').trim()].filter(Boolean)
+		? urlsRaw.map(u => String(u || '')).filter(Boolean)
+		: [String(urlsRaw || '')].filter(Boolean)
 	if (!urlsList.length) return null
 	for (const u of urlsList)
 		if (!ICE_URL_RE.test(u)) return null

package/transport/link_registry.mjs

@@ -293,14 +293,14 @@ export function createLinkRegistry(options = {}) {
 			const providers = listLinkProviders()
 			for (const provider of providers)
 				try {
-					if (typeof provider.canReach === 'function') {
+					if (provider.canReach) {
 						const reachable = await Promise.resolve(provider.canReach({ nodeHash: normalized }))
 						if (!reachable) {
 							nodeDebug('p2p:dial skip', { peer: shortHash(normalized), provider: provider.id, reason: 'canReach=false' })
 							continue
 						}
 					}
-					if (typeof provider.isAvailable === 'function') {
+					if (provider.isAvailable) {
 						const available = await Promise.resolve(provider.isAvailable())
 						if (!available) {
 							nodeDebug('p2p:dial skip', { peer: shortHash(normalized), provider: provider.id, reason: 'isAvailable=false' })
@@ -470,17 +470,6 @@ export function createLinkRegistry(options = {}) {
 			|| await relayEnvelopeToNode(remoteNodeHash, envelope)
 	}
 
-	/**
-	 * 同步结果直接返回；thenable 才 await（避免每条 envelope 造 microtask）。
-	 * @param {unknown} value 可能为 Promise 的返回值
-	 * @returns {Promise<unknown>} 已 resolve 的值
-	 */
-	async function maybeAwait(value) {
-		if (value != null && typeof /** @type {{ then?: unknown }} */ value.then === 'function')
-			return await value
-		return value
-	}
-
 	/**
 	 * 将入站 envelope 派发到 scope 监听器（经 authorizer 校验）。
 	 * @param {string} senderNodeHash 发送方节点 64 hex
@@ -489,16 +478,15 @@ export function createLinkRegistry(options = {}) {
 	 * @returns {Promise<void>}
 	 */
 	async function dispatchEnvelope(senderNodeHash, envelope, link) {
-		const scope = envelope.scope || ''
+		const { scope } = envelope
 		for (const [prefix, authorizer] of scopeAuthorizers.entries())
 			if (scope.startsWith(prefix)) {
-				const allowed = await maybeAwait(authorizer(scope, senderNodeHash, envelope, link))
-				if (!allowed) return
+				if (!await authorizer(scope, senderNodeHash, envelope, link)) return
 			}
 		for (const [prefix, listeners] of scopeListeners.entries())
 			if (scope.startsWith(prefix))
 				for (const listener of listeners)
-					await maybeAwait(listener(senderNodeHash, envelope, link))
+					await listener(senderNodeHash, envelope, link)
 	}
 
 	/**
@@ -567,7 +555,7 @@ export function createLinkRegistry(options = {}) {
 		 * @returns {void}
 		 */
 		setPriorityWeightFunction(weightFunction) {
-			priorityWeightFunction = typeof weightFunction === 'function' ? weightFunction : null
+			priorityWeightFunction = weightFunction || null
 		},
 		/**
 		 * @param {string} nodeHash - 节点 64-hex hash

package/transport/mesh_keepalive.mjs

@@ -21,7 +21,7 @@ const INTENTIONAL_CLOSE = new Set([
  * @returns {boolean} 是否为本机主动关链（不重拨）
  */
 export function isMeshIntentionalClose(reason) {
-	return INTENTIONAL_CLOSE.has(String(reason || ''))
+	return INTENTIONAL_CLOSE.has(reason || '')
 }
 
 /**

package/transport/node_scope/wire.mjs

@@ -103,7 +103,7 @@ export function getNodeScopeContext() {
  */
 export function ensureNodeScope(options = {}) {
 	if (options.replicaUsername != null)
-		nodeScopeContext.replicaUsername = String(options.replicaUsername)
+		nodeScopeContext.replicaUsername = options.replicaUsername
 	if (nodeScopeSubscribeCleanup) return nodeScopeSubscribeCleanup
 	nodeScopeSubscribeCleanup = subscribeScope('node', (senderNodeHash, envelope) => {
 		const handlers = nodeActionHandlers.get(envelope.action)

package/transport/remote_user_room.mjs

@@ -23,21 +23,19 @@ registerFederationRoomProvider('remote-user-room', () => {
 
 /**
  * 加入目标节点的用户房间（幂等）。
- * @param {string} username 本地 replica 用户名
  * @param {string} targetNodeHash 目标节点 64 hex
  * @returns {Promise<RemoteUserRoomSlot>} 房间槽
  */
-export async function ensureRemoteUserRoom(username, targetNodeHash) {
-	const key = targetNodeHash.toLowerCase()
-	const existing = slots.get(key)
+export async function ensureRemoteUserRoom(targetNodeHash) {
+	const existing = slots.get(targetNodeHash)
 	if (existing) return existing
-	const inflight = inflights.get(key)
+	const inflight = inflights.get(targetNodeHash)
 	if (inflight) return await inflight
 
 	const task = (async () => {
 		try {
-			if (!await ensureLinkToNode(key))
-				throw new Error(`p2p: ensureRemoteUserRoom link failed for ${key}`)
+			if (!await ensureLinkToNode(targetNodeHash))
+				throw new Error(`p2p: ensureRemoteUserRoom link failed for ${targetNodeHash}`)
 
 			/** @type {import('../registries/room_provider.mjs').FederationRoomSlot} */
 			const roomSlot = {
@@ -46,13 +44,13 @@ export async function ensureRemoteUserRoom(username, targetNodeHash) {
 				 * 返回远端用户房间 roster（链路存在时含目标节点）。
 				 * @returns {Array<{ peerId: string, remoteNodeHash: string }>} roster 列表
 				 */
-				getRoster: () => getLink(key) ? [{ peerId: key, remoteNodeHash: key }] : [],
+				getRoster: () => getLink(targetNodeHash) ? [{ peerId: targetNodeHash, remoteNodeHash: targetNodeHash }] : [],
 				/**
 				 * 按 nodeHash 查找 peer id。
 				 * @param {string} nh 目标节点 64 hex
 				 * @returns {string | null} 对端 id；无链路时为 null
 				 */
-				getPeerIdByNodeHash: nh => getLink(nh) ? String(nh) : null,
+				getPeerIdByNodeHash: nh => getLink(nh) ? nh : null,
 				/**
 				 * 经 node scope 向远端 peer 发送 action。始终走当前规范链路（`getLink`），
 				 * 因为 glare 双 PC 择一后最初返回的链路可能已被关闭，规范链在 registry 内。
@@ -62,7 +60,7 @@ export async function ensureRemoteUserRoom(username, targetNodeHash) {
 				 * @returns {void}
 				 */
 				sendToPeer(peerId, actionName, payload) {
-					void getLink(key)?.send({ scope: 'node', action: actionName, payload }).catch(() => { })
+					void getLink(targetNodeHash)?.send({ scope: 'node', action: actionName, payload }).catch(() => { })
 				},
 			}
 
@@ -73,19 +71,19 @@ export async function ensureRemoteUserRoom(username, targetNodeHash) {
 				 * @returns {Promise<void>} 关闭完成
 				 */
 				leave() {
-					slots.delete(key)
-					return closeLink(key, 'remote-user-room-release')
+					slots.delete(targetNodeHash)
+					return closeLink(targetNodeHash, 'remote-user-room-release')
 				},
 			}
-			slots.set(key, slot)
+			slots.set(targetNodeHash, slot)
 			bumpLocalDataRevision()
 			return slot
 		}
 		finally {
-			inflights.delete(key)
+			inflights.delete(targetNodeHash)
 		}
 	})()
 
-	inflights.set(key, task)
+	inflights.set(targetNodeHash, task)
 	return await task
 }

package/transport/rtc_connection_budget.mjs

@@ -48,7 +48,7 @@ function bucketFor(roomKey, limits = {}) {
 		budgets.set(roomKey, bucket)
 	}
 	for (const id of resolveRtcBudgetLimits(limits).trustedPeers || [])
-		bucket.trustedPeers.add(String(id))
+		bucket.trustedPeers.add(id)
 	return bucket
 }
 
@@ -89,7 +89,7 @@ export function takeRtcJoinSlot(roomKey, peerId, limits = {}, sourceId = 'peer')
 	for (const id of bucket.active)
 		if (!bucket.trustedPeers.has(id)) nonTrustedCount++
 	if (!isTrusted) {
-		const source = String(sourceId || 'peer')
+		const source = sourceId || 'peer'
 		let sameSource = 0
 		for (const peerSource of bucket.sourceByPeer.values())
 			if (peerSource === source) sameSource++
@@ -108,7 +108,7 @@ export function takeRtcJoinSlot(roomKey, peerId, limits = {}, sourceId = 'peer')
 	bucket.joinTimestamps.push(now)
 	if (peerId) {
 		bucket.active.add(peerId)
-		bucket.sourceByPeer.set(peerId, String(sourceId || 'peer'))
+		bucket.sourceByPeer.set(peerId, sourceId || 'peer')
 	}
 	return true
 }
@@ -123,9 +123,9 @@ export function takeRtcJoinSlot(roomKey, peerId, limits = {}, sourceId = 'peer')
 export function annotateRtcPeerNodeHash(roomKey, peerId, nodeHash, limits = {}) {
 	const bucket = budgets.get(roomKey)
 	if (!bucket || !peerId || !nodeHash) return
-	bucket.peerNodeHash.set(peerId, String(nodeHash).trim())
+	bucket.peerNodeHash.set(peerId, nodeHash)
 	for (const trusted of resolveRtcBudgetLimits(limits).trustedPeers || [])
-		if (String(trusted).trim() === String(nodeHash).trim())
+		if (trusted === nodeHash)
 			bucket.trustedPeers.add(peerId)
 
 }
@@ -139,7 +139,7 @@ export function annotateRtcPeerNodeHash(roomKey, peerId, nodeHash, limits = {})
 export function setRtcPeerSource(roomKey, peerId, sourceId) {
 	const bucket = budgets.get(roomKey)
 	if (!bucket || !peerId) return
-	bucket.sourceByPeer.set(peerId, String(sourceId || 'peer'))
+	bucket.sourceByPeer.set(peerId, sourceId || 'peer')
 }
 
 /**

package/transport/runtime_bootstrap.mjs

@@ -41,14 +41,14 @@ export function collectFastListenProviders(ownedLanTcp) {
 	const listenProviders = []
 	if (ownedLanTcp) listenProviders.push(ownedLanTcp)
 	for (const provider of listLinkProviders()) {
-		const id = String(provider.id)
+		const id = provider.id
 		if (id.startsWith('lan_tcp') || id.startsWith('ble_gatt')) continue
-		if (typeof provider.ensureListening !== 'function') continue
+		if (!provider.ensureListening) continue
 		if (providerHasNativeProbe(provider)) continue
-		if (typeof provider.isAvailable === 'function')
+		if (provider.isAvailable)
 			try {
 				const available = provider.isAvailable()
-				if (available && typeof available.then === 'function') continue
+				if (available?.then) continue
 				if (!available) continue
 			}
 			catch { continue }
@@ -166,7 +166,7 @@ export function createRuntimeBootstrap(deps) {
 	 * @returns {number | null} 本机 lan_tcp 监听端口，未就绪为 null
 	 */
 	function lanTcpPort() {
-		const endpoint = typeof ownedLanTcp?.localEndpoint === 'function' ? ownedLanTcp.localEndpoint() : null
+		const endpoint = ownedLanTcp?.localEndpoint ? ownedLanTcp.localEndpoint() : null
 		return normalizeTcpPort(endpoint?.port)
 	}
 
@@ -199,13 +199,13 @@ export function createRuntimeBootstrap(deps) {
 	 * @returns {Promise<void>}
 	 */
 	async function startProviderListening(provider) {
-		if (typeof provider.ensureListening !== 'function') return
+		if (!provider.ensureListening) return
 		try {
 			const stop = await provider.ensureListening({
 				localIdentity,
 				onInbound: onInboundLink,
 			})
-			if (typeof stop === 'function') stopLinkListeners.push(stop)
+			if (stop) stopLinkListeners.push(stop)
 		}
 		catch { /* provider listen unavailable */ }
 	}
@@ -228,18 +228,18 @@ export function createRuntimeBootstrap(deps) {
 			if (!providerIds.has('bt')) {
 				const bt = await import('../discovery/bt/index.mjs').catch(() => null)
 				if (generation !== gen || !isLive()) return
-				if (await bt?.canUseBluetoothDiscovery?.()) {
+				if (await bt?.canUseBluetoothRuntime?.()) {
 					if (generation !== gen || !isLive()) return
 					const provider = bt.createBluetoothDiscoveryProvider()
 					registerDiscoveryProvider(provider)
 					if (generation !== gen || !isLive()) return
-					if (typeof provider.startPresence === 'function')
+					if (provider.startPresence)
 						try {
 							const stop = await provider.startPresence(async () => ({
 								nodeHash: localIdentity.nodeHash,
 								advertBytes: await buildNetworkAdvertBytes(),
 							}))
-							if (typeof stop === 'function' && generation === gen && isLive()) {
+							if (stop && generation === gen && isLive()) {
 								const prev = stopPresence
 								/**
 								 * 停止 presence 广播并链式调用上一轮清理。
@@ -248,12 +248,12 @@ export function createRuntimeBootstrap(deps) {
 							}
 						}
 						catch { /* ignore */ }
-					if (provider.caps?.canSignal && typeof provider.listenNodeSignals === 'function')
+					if (provider.caps?.canSignal && provider.listenNodeSignals)
 						try {
 							const stop = await provider.listenNodeSignals(localIdentity.nodeHash, bytes => {
 								void handleIncomingSignal(bytes).catch(() => { })
 							})
-							if (typeof stop === 'function' && generation === gen && isLive()) {
+							if (stop && generation === gen && isLive()) {
 								const prev = stopSignalListener
 								/**
 								 * 停止信令监听并链式调用上一轮清理。

package/trust_graph/cache.mjs

@@ -22,10 +22,9 @@ export function invalidateTrustGraphCache() {
  * @returns {Promise<Map<string, object>>} 合并后的信任图
  */
 export async function getCachedTrustGraph(username, build, ttlMs = DEFAULT_TTL_MS) {
-	const key = String(username || '')
 	const now = Date.now()
 	const dataRevision = getLocalDataRevision()
-	const cached = cacheByUsername.get(key)
+	const cached = cacheByUsername.get(username)
 	if (
 		cached
 		&& cached.revision === revision
@@ -35,6 +34,6 @@ export async function getCachedTrustGraph(username, build, ttlMs = DEFAULT_TTL_M
 		return cached.graph
 
 	const graph = await build()
-	cacheByUsername.set(key, { graph, builtAt: now, revision, dataRevision })
+	cacheByUsername.set(username, { graph, builtAt: now, revision, dataRevision })
 	return graph
 }

package/trust_graph/engine.mjs

@@ -89,7 +89,7 @@ export function mergeGraph(inputs, tunables = trustGraphTunables) {
 		const rawWeight = Number(hint.weight ?? tunables.hintDefaultWeight)
 		if (Number.isFinite(rawWeight) && rawWeight > 0)
 			ev.hintWeightSum += rawWeight
-		ev.hintSources.add(String(hint.source ?? 'unknown'))
+		ev.hintSources.add(hint.source ?? 'unknown')
 	}
 
 	for (const room of inputs.roomRosters || [])

package/trust_graph/registry.mjs

@@ -13,7 +13,7 @@ export const DEFAULT_TRUST_GRAPH_OWNER = 'default'
  * @returns {void}
  */
 export function registerTrustGraphProvider(ownerId, implementation) {
-	providersByOwner.set(String(ownerId), implementation)
+	providersByOwner.set(ownerId, implementation)
 }
 
 /** @returns {void} */
@@ -26,7 +26,7 @@ export function clearTrustGraphProvider() {
  * @returns {import('./registry.mjs').TrustGraphProvider} 已注册实现
  */
 export function requireTrustGraphProvider(ownerId = DEFAULT_TRUST_GRAPH_OWNER) {
-	const implementation = providersByOwner.get(String(ownerId))
+	const implementation = providersByOwner.get(ownerId)
 	if (!implementation)
 		throw new Error(`p2p: registerTrustGraphProvider('${ownerId}') must run before trust graph fanout`)
 	return implementation