@steve02081504/fount-p2p 0.0.26 → 0.0.28

package/README.md

@@ -69,7 +69,7 @@ Reputation pull/apply is separate: `pullReputationFromNode` → JSON; `setReputa
 ## Layout
 
 | Layer | Directory | Role |
-|---|---|---|
+| --- | --- | --- |
 | L0 | `core/` | Pure primitives: `hexIds`, `entity_id*`, `canonical_json` |
 | L1 | `crypto/`, `wire/`, `schemas/` | Cryptography, wire protocol, canonical validation |
 | L2 | `node/` | Node runtime: `identity`, `entity_store`, `denylist`, `reputation_store` |
@@ -83,7 +83,7 @@ Facade entry: `index.mjs` (`startNode`, `createGroupLinkSet`, `registerDiscovery
 **Public transport modules:**
 
 | Module | Role |
-|---|---|
+| --- | --- |
 | `link_registry.mjs` | fount-network facade: dial fallback, scope/overlay |
 | `user_room.mjs` / `group_link_set.mjs` / `node_scope/wire` + `node_scope/features` | rooms + composable node-scope wires (`registerNodeScopeWireHook`, attaches) |
 | `room_scopes.mjs` / `remote_user_room.mjs` | scope constants / remote user slot |
@@ -123,3 +123,4 @@ Group chunk remote storage (S3, etc.) is implemented by the shell as `GroupStora
 - Infra relay / node-scope attaches: [`docs/infra.md`](./docs/infra.md)
 - Wire part / fanout attaches: [`docs/wire.md`](./docs/wire.md)
 - EVFS public manifests / fetch: [`docs/evfs.md`](./docs/evfs.md)
+- Subjective reputation: [`docs/reputation.md`](./docs/reputation.md)

package/core/bytes_codec.mjs

@@ -29,16 +29,15 @@ export function bytesToHex(bytes) {
 }
 
 /**
- * @param {string} hex hex 文本（可含空白；大小写不敏感）
+ * @param {string} hex hex 文本（偶数字符；大小写均可）
  * @returns {Uint8Array} 解码后的字节
  */
 export function hexToBytes(hex) {
-	const text = hex.trim().toLowerCase()
-	if (text.length % 2) throw new Error('p2p: hex length must be even')
-	const out = new Uint8Array(text.length / 2)
+	if (hex.length % 2) throw new Error('p2p: hex length must be even')
+	const out = new Uint8Array(hex.length / 2)
 	for (let index = 0; index < out.length; index++) {
-		const high = hexNibble(text.charCodeAt(index * 2))
-		const low = hexNibble(text.charCodeAt(index * 2 + 1))
+		const high = hexNibble(hex.charCodeAt(index * 2))
+		const low = hexNibble(hex.charCodeAt(index * 2 + 1))
 		if (high < 0 || low < 0) throw new Error('p2p: invalid hex')
 		out[index] = (high << 4) | low
 	}

package/core/composite_key.mjs

@@ -10,82 +10,3 @@ export function compositeKey(...parts) {
 	if (!parts.length) throw new Error('compositeKey: at least one part required')
 	return parts.join(SEP)
 }
-
-/**
- * @param {...string} prefixParts 前缀段（可为空，表示整表）
- * @returns {string} 带尾部分隔符的前缀（用于子树匹配）
- */
-function compositePrefix(...prefixParts) {
-	return prefixParts.length ? `${compositeKey(...prefixParts)}${SEP}` : ''
-}
-
-/**
- * @template V
- * @param {Map<string, V>} map 根表
- * @param {...string} parts 键段
- * @returns {V | undefined} 命中值
- */
-export function mapGet(map, ...parts) {
-	return map.get(compositeKey(...parts))
-}
-
-/**
- * @template V
- * @param {Map<string, V>} map 根表
- * @param {...string} partsAndValue 键段 + 末尾值
- * @returns {void}
- */
-export function mapSet(map, ...partsAndValue) {
-	const value = partsAndValue.pop()
-	map.set(compositeKey(...partsAndValue), value)
-}
-
-/**
- * @template V
- * @param {Map<string, V>} map 根表
- * @param {...string} parts 键段
- * @returns {boolean} 是否存在
- */
-export function mapHas(map, ...parts) {
-	return map.has(compositeKey(...parts))
-}
-
-/**
- * @template V
- * @param {Map<string, V>} map 根表
- * @param {...string} parts 键段
- * @returns {void}
- */
-export function mapDelete(map, ...parts) {
-	map.delete(compositeKey(...parts))
-}
-
-/**
- * 删除以 `prefixParts` 为前缀的所有条目（含更深层级）。
- * @template V
- * @param {Map<string, V>} map 根表
- * @param {...string} prefixParts 前缀段（空则清空整表）
- * @returns {void}
- */
-export function mapDeleteByPrefix(map, ...prefixParts) {
-	const prefix = compositePrefix(...prefixParts)
-	for (const k of [...map.keys()])
-		if (!prefix || k.startsWith(prefix)) map.delete(k)
-}
-
-/**
- * 遍历前缀子树；回调收到前缀之后的各段与值。
- * @template V
- * @param {Map<string, V>} map 根表
- * @param {...(string | ((tail: string[], value: V) => void))} prefixPartsAndCallback 前缀段 + 末尾回调
- * @returns {void}
- */
-export function mapForEachUnder(map, ...prefixPartsAndCallback) {
-	const callback = prefixPartsAndCallback.pop()
-	const prefix = compositePrefix(...prefixPartsAndCallback)
-	for (const [k, value] of map) {
-		if (!k.startsWith(prefix)) continue
-		const tail = k.slice(prefix.length).split(SEP).filter(Boolean)
-		callback(tail, value)
-	}
-}

package/core/entity_id_parse.mjs

@@ -8,8 +8,7 @@ export const ENTITY_HASH_RE = /^[\da-f]{128}$/u
  * @returns {boolean} 是否为合法 128 位 hex
  */
 export function isEntityHash128(value) {
-	const raw = String(value ?? '').trim().toLowerCase().replace(/^0x/iu, '')
-	return ENTITY_HASH_RE.test(raw)
+	return ENTITY_HASH_RE.test(String(value ?? '').replace(/^0x/iu, ''))
 }
 
 /**
@@ -17,7 +16,7 @@ export function isEntityHash128(value) {
  * @returns {{ entityHash: string, nodeHash: string, subjectHash: string } | null} 解析结果；非法时 null
  */
 export function parseEntityHash(entityHash) {
-	const raw = String(entityHash ?? '').trim().toLowerCase().replace(/^0x/iu, '')
+	const raw = String(entityHash ?? '').replace(/^0x/iu, '')
 	if (!ENTITY_HASH_RE.test(raw)) return null
 	return {
 		entityHash: raw,

package/core/evfs_logical_path.mjs

@@ -3,10 +3,9 @@
  * @returns {string} 规范化后的相对路径
  */
 export function assertSafeEvfsLogicalPath(logicalPath) {
-	const raw = String(logicalPath || '').trim()
-	if (!raw || raw.includes('\0'))
+	if (!logicalPath || logicalPath.includes('\0'))
 		throw new Error('invalid EVFS path')
-	const segments = raw.split(/[/\\]+/).map(s => s.trim()).filter(Boolean)
+	const segments = logicalPath.split(/[/\\]+/).filter(Boolean)
 	if (!segments.length) throw new Error('invalid EVFS path')
 	for (const segment of segments)
 		if (segment === '.' || segment === '..')

package/core/hexIds.mjs

@@ -12,15 +12,15 @@ export const LOCAL_CHUNK_FILE_RE = /^local:[^/]+\/chunks\/([\da-f]{64})\.bin$/u
 
 /**
  * @param {unknown} value 原始字符串
- * @returns {string} trim + 去 0x + 小写
+ * @returns {string} 去可选 0x 前缀后的字符串（不修大小写/空白）
  */
 export function normalizeHex64(value) {
-	return String(value ?? '').trim().toLowerCase().replace(/^0x/iu, '')
+	return String(value ?? '').replace(/^0x/iu, '')
 }
 
 /**
  * @param {unknown} value 待校验值
- * @returns {boolean} 是否为 64 位 hex
+ * @returns {boolean} 是否为 64 位小写 hex
  */
 export function isHex64(value) {
 	return HEX_ID_64.test(normalizeHex64(value))
@@ -39,7 +39,7 @@ export function compareHex64Asc(a, b) {
 }
 
 /**
- * 外部入站专用：规范化并断言 64 位 hex。
+ * 外部入站专用：规范化并断言 64 位小写 hex。
  * @param {unknown} value 原始值
  * @param {string} [label='hex64'] 字段名（错误信息）
  * @returns {string} 小写 64 位 hex
@@ -56,5 +56,5 @@ export function assertHex64(value, label = 'hex64') {
  * @returns {boolean} 是否为 128 位签名 hex
  */
 export function isSignatureHex128(value) {
-	return SIGNATURE_HEX_128.test(String(value ?? '').trim())
+	return SIGNATURE_HEX_128.test(String(value ?? ''))
 }

package/core/logical_entity.mjs

@@ -1,4 +1,4 @@
-import { sha256TextHex } from '../crypto/crypto.mjs'
+import { sha256Hex } from '../crypto/crypto.mjs'
 
 import { encodeEntityHash, parseEntityHash } from './entity_id_parse.mjs'
 
@@ -10,9 +10,8 @@ export const LOGICAL_ENTITY_SENTINEL_NODE_HASH = '0'.repeat(64)
  * @returns {string} 128 位 logical entityHash
  */
 export function logicalEntityHash(subject) {
-	const s = String(subject || '').trim()
-	if (!s) throw new Error('subject required')
-	return encodeEntityHash(LOGICAL_ENTITY_SENTINEL_NODE_HASH, sha256TextHex(s))
+	if (!subject) throw new Error('subject required')
+	return encodeEntityHash(LOGICAL_ENTITY_SENTINEL_NODE_HASH, sha256Hex(subject))
 }
 
 /**

package/crypto/channel.mjs

@@ -5,13 +5,9 @@
 import { Buffer } from 'node:buffer'
 import { createCipheriv, createDecipheriv, hkdfSync, randomBytes } from 'node:crypto'
 
-import { unwrapKeyEcies, wrapKeyEcies } from './key.mjs'
-
 /** @type {'channel-key'} 频道消息 content 加密 scheme */
 export const CHANNEL_KEY_SCHEME = 'channel-key'
 
-/** @typedef {{ ephemPub: string, iv: string, ciphertext: string, authTag: string }} EciesWrapBlob */
-
 /**
  * 生成随机 32 字节频道密钥（hex）。
  * @returns {string} 32 字节 hex 频道密钥
@@ -20,25 +16,6 @@ export function generateChannelKey() {
 	return randomBytes(32).toString('hex')
 }
 
-/**
- * X25519 ECIES 包装 K_ch 给成员 Ed25519 公钥。
- * @param {string} channelKeyHex 32 字节 hex
- * @param {string} memberEdPubKeyHex 64 位十六进制
- * @returns {EciesWrapBlob} ECIES 包装结果
- */
-export function wrapChannelKey(channelKeyHex, memberEdPubKeyHex) {
-	return wrapKeyEcies(channelKeyHex, memberEdPubKeyHex)
-}
-
-/**
- * @param {EciesWrapBlob} wrap ECIES 密文
- * @param {Uint8Array} myEdPrivKeySeed 32 字节 Ed25519 种子
- * @returns {string | null} K_ch hex
- */
-export function unwrapChannelKey(wrap, myEdPrivKeySeed) {
-	return unwrapKeyEcies(wrap, myEdPrivKeySeed)
-}
-
 /**
  * @param {string} channelKeyHex K_ch
  * @param {string} channelId 频道 id（AAD 盐）
@@ -49,7 +26,7 @@ function messageAesKey(channelKeyHex, channelId, generation) {
 	return Buffer.from(hkdfSync(
 		'sha256',
 		Buffer.from(channelKeyHex, 'hex'),
-		`${CHANNEL_KEY_SCHEME}:${String(channelId)}:${String(generation)}`,
+		`${CHANNEL_KEY_SCHEME}:${channelId}:${generation}`,
 		'',
 		32,
 	))
@@ -71,7 +48,7 @@ export function encryptWithChannelKey(plaintext, channelKeyHex, channelId, gener
 	const authTag = cipher.getAuthTag()
 	return {
 		scheme: CHANNEL_KEY_SCHEME,
-		channelId: String(channelId),
+		channelId,
 		generation: Number(generation) || 0,
 		payload: `${iv.toString('base64')}.${ciphertext.toString('base64')}.${authTag.toString('base64')}`,
 	}

package/crypto/checkpoint_sign.mjs

@@ -1,6 +1,7 @@
 import { Buffer } from 'node:buffer'
 
 import { canonicalStringify } from '../core/canonical_json.mjs'
+import { isHex64, isSignatureHex128 } from '../core/hexIds.mjs'
 import { merkleRoot } from '../dag/index.mjs'
 
 import { sign, verify } from './crypto.mjs'
@@ -26,8 +27,8 @@ export async function signCheckpoint(payload, secretKey) {
  * @returns {Promise<boolean>} 合法为 true
  */
 export async function verifyCheckpointSignature(checkpoint, ownerPublicKey) {
-	const raw = checkpoint.checkpoint_signature.trim()
-	if (!/^[\da-f]{128}$/iu.test(raw)) return false
+	const raw = String(checkpoint.checkpoint_signature || '')
+	if (!isSignatureHex128(raw)) return false
 	const body = { ...checkpoint }
 	delete body.checkpoint_signature
 	const messageBytes = Buffer.from(canonicalStringify(body), 'utf8')
@@ -40,7 +41,7 @@ export async function verifyCheckpointSignature(checkpoint, ownerPublicKey) {
  * @returns {boolean} 签名格式合法为 true
  */
 export function isSignedCheckpoint(checkpoint) {
-	return /^[\da-f]{128}$/iu.test(String(checkpoint?.checkpoint_signature || '').trim())
+	return isSignatureHex128(String(checkpoint?.checkpoint_signature || ''))
 }
 
 /**
@@ -59,7 +60,7 @@ export async function verifyRemoteCheckpoint(checkpoint) {
 	const ownerHash = checkpoint.members_record?.delegatedOwnerPubKeyHash
 	const owner = checkpoint.members_record?.members?.[ownerHash]
 	const pubHex = owner?.pubKeyHex
-	if (!pubHex || !/^[\da-f]{64}$/iu.test(pubHex))
+	if (!pubHex || !isHex64(pubHex))
 		return { valid: false, reason: 'delegated owner pubkey missing' }
 	if (!await verifyCheckpointSignature(checkpoint, Buffer.from(pubHex, 'hex')))
 		return { valid: false, reason: 'checkpoint signature invalid' }

package/crypto/crypto.mjs

@@ -81,11 +81,3 @@ export function pubKeyHash(publicKey) {
 export function sha256Hex(data) {
 	return bytesToHex(sha256(inputBytes(data)))
 }
-
-/**
- * @param {string} text 文本
- * @returns {string} 64 字符 hex
- */
-export function sha256TextHex(text) {
-	return sha256Hex(String(text ?? ''))
-}

package/crypto/key.mjs

@@ -73,7 +73,7 @@ function toHBuf(H) {
  * @returns {Buffer} 32 字节 AES-256 密钥
  */
 export function deriveFileKey(H, fileId) {
-	return kdf(toHBuf(H), 'file', String(fileId))
+	return kdf(toHBuf(H), 'file', fileId)
 }
 
 /**
@@ -83,7 +83,7 @@ export function deriveFileKey(H, fileId) {
  * @returns {Buffer} 32 字节 AES-256 密钥
  */
 export function deriveSocialPostKey(H, postId) {
-	return kdf(toHBuf(H), 'post', String(postId))
+	return kdf(toHBuf(H), 'post', postId)
 }
 
 /**
@@ -93,7 +93,7 @@ export function deriveSocialPostKey(H, postId) {
  * @returns {Buffer} 32 字节 HMAC 密钥
  */
 export function deriveStreamingAuthKey(H, groupId) {
-	return kdf(toHBuf(H), 'streaming', String(groupId))
+	return kdf(toHBuf(H), 'streaming', groupId)
 }
 
 // ─── H 轮换（§11.2、§6.3 key_rotate）──────────────────────────────────────
@@ -109,8 +109,8 @@ export function deriveStreamingAuthKey(H, groupId) {
 export function deriveNextFileMasterKey(oldKeyHex, eventId, nonce) {
 	return createHash('sha256')
 		.update(Buffer.from(oldKeyHex, 'hex'))
-		.update(String(eventId))
-		.update(String(nonce))
+		.update(eventId)
+		.update(nonce)
 		.digest('hex')
 }
 
@@ -245,7 +245,7 @@ export function encryptUtf8ForMember(utf8Text, memberEdPubKeyHex) {
 	const wrapKey = createHash('sha256').update(sharedSecret).digest()
 	const iv = randomBytes(12)
 	const cipher = createCipheriv('aes-256-gcm', wrapKey, iv)
-	const plain = Buffer.from(String(utf8Text), 'utf8')
+	const plain = Buffer.from(utf8Text, 'utf8')
 	const ciphertext = Buffer.concat([cipher.update(plain), cipher.final()])
 	const authTag = cipher.getAuthTag()
 	return {
@@ -356,7 +356,7 @@ export function decryptConvergentCiphertext(raw, contentHashHex) {
 		decipher.setAuthTag(authTag)
 		const plain = Buffer.concat([decipher.update(ciphertext), decipher.final()])
 		const check = createHash('sha256').update(plain).digest('hex')
-		if (check !== contentHashHex.toLowerCase()) return null
+		if (check !== contentHashHex) return null
 		return plain
 	}
 	catch { return null }
@@ -379,10 +379,9 @@ export function decryptRandomCiphertext(raw, contentKey, contentHashHex = '') {
 		const decipher = createDecipheriv('aes-256-gcm', Buffer.from(contentKey), iv)
 		decipher.setAuthTag(authTag)
 		const plain = Buffer.concat([decipher.update(ciphertext), decipher.final()])
-		const expect = String(contentHashHex || '').trim().toLowerCase()
-		if (expect) {
+		if (contentHashHex) {
 			const check = createHash('sha256').update(plain).digest('hex')
-			if (check !== expect) return null
+			if (check !== contentHashHex) return null
 		}
 		return plain
 	}

package/dag/canonicalize_row.mjs

@@ -28,7 +28,7 @@ export function canonicalizeRowContent(content, hexKeys, entityHashKeys = new Se
 		canonicalizeHexField(out, key)
 	for (const key of entityHashKeys) {
 		if (!out[key]) continue
-		const entityHash = String(out[key]).toLowerCase()
+		const entityHash = String(out[key] || '')
 		if (!isEntityHash128(entityHash))
 			throw new Error(`${key} must be 128 hex characters`)
 		out[key] = entityHash

package/discovery/advert_peer_hints.mjs

@@ -21,7 +21,7 @@ export function noteAdvertPeerHints(verifiedNodeHash, body, meta) {
 	// lanHosts 先写（差→优，unshift 后优在前），再写观测 address，使 address 最优先
 	for (const host of normalizeLanHosts(body?.lanHosts).toReversed())
 		noteLanPeerHint(verifiedNodeHash, { host, port: tcpPort })
-	const address = String(meta?.address || '').trim()
+	const address = String(meta?.address || '')
 	if (address)
 		noteLanPeerHint(verifiedNodeHash, { host: address, port: tcpPort })
 }

package/discovery/adverts.mjs

@@ -69,11 +69,9 @@ export function encryptAdvertForScope(scope, localIdentity, advertBody) {
  * Untrusted ingress：解密并验签 advert；失败返回 null，不抛。不写入可见池 / peer hints。
  * @param {string} rendezvousKey rendezvous 键
  * @param {Uint8Array} bytes 加密 advert
- * @param {object} [meta] 元数据
  * @returns {Promise<{ verifiedNodeHash: string, body: object } | null>} 验签成功返回 nodeHash 与 advert body，否则 null
  */
-export async function ingestEncryptedAdvert(rendezvousKey, bytes, meta) {
-	void meta
+export async function ingestEncryptedAdvert(rendezvousKey, bytes) {
 	const packet = decryptSignalPacket(rendezvousKey, bytes)
 	if (packet?.type !== 'advert' || !packet.body) return null
 	const verifiedNodeHash = await verifySignedAdvert(rendezvousKey, packet.body)
@@ -84,31 +82,28 @@ export async function ingestEncryptedAdvert(rendezvousKey, bytes, meta) {
 /**
  * Untrusted ingress：验签 network-scope advert；失败返回 null。不写盘 / 不写 hints。
  * @param {Uint8Array} bytes 加密 advert
- * @param {object} [meta] 元数据
  * @returns {Promise<{ verifiedNodeHash: string, body: object } | null>} 验签成功返回 nodeHash 与 advert body，否则 null
  */
-export async function ingestNetworkAdvert(bytes, meta) {
-	return ingestEncryptedAdvert(networkRendezvousKey(), bytes, meta)
+export async function ingestNetworkAdvert(bytes) {
+	return ingestEncryptedAdvert(networkRendezvousKey(), bytes)
 }
 
 /**
  * Untrusted ingress：验签 node-scope advert；失败返回 null。不写盘 / 不写 hints。
  * @param {string} nodeHash 目标 nodeHash
  * @param {Uint8Array} bytes 加密 advert
- * @param {object} [meta] 元数据
  * @returns {Promise<{ verifiedNodeHash: string, body: object } | null>} 验签成功返回 nodeHash 与 advert body，否则 null
  */
-export async function ingestNodeAdvert(nodeHash, bytes, meta) {
-	return ingestEncryptedAdvert(nodeRendezvousKey(normalizeHex64(nodeHash)), bytes, meta)
+export async function ingestNodeAdvert(nodeHash, bytes) {
+	return ingestEncryptedAdvert(nodeRendezvousKey(normalizeHex64(nodeHash)), bytes)
 }
 
 /**
  * Untrusted ingress：验签 group-scope advert；失败返回 null。不写盘 / 不写 hints。
  * @param {string} roomSecret 房间密钥
  * @param {Uint8Array} bytes 加密 advert
- * @param {object} [meta] 元数据
  * @returns {Promise<{ verifiedNodeHash: string, body: object } | null>} 验签成功返回 nodeHash 与 advert body，否则 null
  */
-export async function ingestGroupAdvert(roomSecret, bytes, meta) {
-	return ingestEncryptedAdvert(groupRendezvousKey(roomSecret), bytes, meta)
+export async function ingestGroupAdvert(roomSecret, bytes) {
+	return ingestEncryptedAdvert(groupRendezvousKey(roomSecret), bytes)
 }

package/discovery/bt/index.mjs

@@ -9,8 +9,10 @@ import { noteDiscoveryPeerClue } from '../peer_clue.mjs'
 import { getBtPeerHint } from './peer_hints.mjs'
 import { canUseBluetoothRuntime, loadBleno, loadNoble, resolveBtRole, waitPoweredOn } from './runtime.mjs'
 
-/** 重导出 waitPoweredOn，供 discovery 调用方使用。 */
-export { waitPoweredOn } from './runtime.mjs'
+/**
+ * 重导出有关 BT 生命期的工具函数。
+ */
+export { canUseBluetoothRuntime, waitPoweredOn }
 
 const BT_SERVICE_UUID = 'f017f017f017f017f017f017f017f017'
 const BT_CHARACTERISTIC_UUID = 'f017f017f017f017f017f017f017f018'
@@ -53,13 +55,6 @@ export function clearBtVisibleNodes() {
 	visibleByHash.clear()
 }
 
-/**
- * @returns {Promise<boolean>} 可用为 true
- */
-export async function canUseBluetoothDiscovery() {
-	return canUseBluetoothRuntime()
-}
-
 /**
  * @param {Map<string, Uint8Array>} presence nodeHash → encrypted advert
  * @returns {Buffer} JSON blob
@@ -100,9 +95,9 @@ function parsePresenceBlob(raw) {
  * @returns {Promise<{ verifiedNodeHash: string, body: object } | null>} 验签结果
  */
 export async function acceptBtScannedPresence(bytes, meta) {
-	const peripheralId = String(meta?.peripheralId || '').trim()
+	const peripheralId = String(meta?.peripheralId || '')
 	if (!peripheralId || !bytes?.byteLength) return null
-	const ingested = await ingestNetworkAdvert(bytes, meta)
+	const ingested = await ingestNetworkAdvert(bytes)
 	if (!ingested) return null
 	const firstSeen = !visibleByHash.has(ingested.verifiedNodeHash)
 	noteBtVisibleNode(ingested.verifiedNodeHash)

package/discovery/bt/peer_hints.mjs

@@ -15,9 +15,8 @@ const hints = createTtlMap(BT_PEER_HINT_TTL_MS)
  */
 export function noteBtPeerHint(nodeHash, peripheralId) {
 	const hash = normalizeHex64(nodeHash)
-	const id = String(peripheralId || '').trim()
-	if (!hash || !id) return
-	hints.set(hash, { peripheralId: id })
+	if (!hash || !peripheralId) return
+	hints.set(hash, { peripheralId })
 }
 
 /**

package/discovery/bt/runtime.mjs

@@ -96,7 +96,7 @@ export async function loadBleno() {
 	if (probeBluetoothHardware() === false)
 		throw new Error('p2p: no bluetooth adapter')
 	const mod = await import('@stoprocent/bleno')
-	if (typeof mod.withBindings === 'function') return mod.withBindings('default')
+	if (mod.withBindings) return mod.withBindings('default')
 	return mod.default ?? mod
 }
 

package/discovery/index.mjs

@@ -27,7 +27,7 @@ export function setDiscoveryLinkDialer(dialer) {
  */
 export function registerDiscoveryProvider(provider) {
 	if (!provider?.id) throw new Error('p2p: discovery provider requires id')
-	providers.set(String(provider.id), provider)
+	providers.set(provider.id, provider)
 	return () => unregisterDiscoveryProvider(provider.id)
 }
 
@@ -36,8 +36,8 @@ export function registerDiscoveryProvider(provider) {
  * @returns {void}
  */
 export function unregisterDiscoveryProvider(id) {
-	const provider = providers.get(String(id))
-	providers.delete(String(id))
+	const provider = providers.get(id)
+	providers.delete(id)
 	try { provider?.dispose?.() } catch { /* ignore */ }
 }
 
@@ -59,7 +59,7 @@ export function listDiscoveryProviders() {
  * @returns {DiscoveryProvider | undefined} 对应 id 的提供者，未注册为 undefined
  */
 export function getDiscoveryProvider(id) {
-	return providers.get(String(id))
+	return providers.get(id)
 }
 
 /**
@@ -67,17 +67,17 @@ export function getDiscoveryProvider(id) {
  * @returns {DiscoveryProvider[]} 实现了指定方法的提供者列表
  */
 function providersWith(method) {
-	return listDiscoveryProviders().filter(provider => typeof provider[method] === 'function')
+	return listDiscoveryProviders().filter(provider => provider[method])
 }
 
 /**
- * @param {Array<(() => void) | null | undefined>} cleanups 清理函数
+ * @param {Array<() => void>} cleanups 清理函数
  * @returns {() => void} 调用时依次执行各 cleanup
  */
 function composeCleanups(cleanups) {
 	return () => {
 		for (const stop of cleanups)
-			if (typeof stop === 'function') try { stop() } catch { /* ignore */ }
+			try { stop() } catch { /* ignore */ }
 	}
 }
 
@@ -92,15 +92,15 @@ async function fanInProviderMethod(method, methodArguments, options = {}) {
 	const requireAny = options.requireAny !== false
 	const capable = providersWith(method)
 	if (requireAny && !capable.length) throw new Error(options.errorLabel || `p2p: ${method} unavailable`)
-	const cleanups = await Promise.all(capable.map(async provider => {
+	const cleanups = (await Promise.all(capable.map(async provider => {
 		try {
 			return await provider[method](...methodArguments)
 		}
 		catch {
 			return null
 		}
-	}))
-	if (requireAny && !cleanups.some(stop => typeof stop === 'function'))
+	}))).filter(Boolean)
+	if (requireAny && !cleanups.length)
 		throw new Error(options.errorLabel || `p2p: ${method} unavailable`)
 	return composeCleanups(cleanups)
 }
@@ -116,7 +116,7 @@ export async function listVisibleNodeHashes(options = {}) {
 	/** @type {Record<string, string[]>} */
 	const byProvider = {}
 	for (const provider of listDiscoveryProviders()) {
-		if (typeof provider.listVisibleNodeHashes !== 'function') continue
+		if (!provider.listVisibleNodeHashes) continue
 		try {
 			const hashes = await provider.listVisibleNodeHashes(options)
 			byProvider[provider.id] = hashes.map(hash => shortHash(hash))
@@ -151,7 +151,7 @@ export async function listVisibleNodeHashes(options = {}) {
 export async function prepareConnectToNode(nodeHash, options = {}) {
 	const hash = normalizeHex64(nodeHash)
 	for (const provider of listDiscoveryProviders()) {
-		if (typeof provider.connectToNode !== 'function') continue
+		if (!provider.connectToNode) continue
 		try { await provider.connectToNode(hash, options) }
 		catch { /* prepare next medium */ }
 	}
@@ -304,7 +304,7 @@ export function noteVisibleNodeFromAdvert(verifiedNodeHash, options = {}) {
  */
 export async function watchVerifiedNodeAdvert(nodeHash, onAdvert) {
 	return await watchNodeAdvert(nodeHash, async (bytes, meta) => {
-		const ingested = await ingestNodeAdvert(nodeHash, bytes, meta)
+		const ingested = await ingestNodeAdvert(nodeHash, bytes)
 		if (!ingested) return
 		noteVisibleNodeFromAdvert(ingested.verifiedNodeHash)
 		await Promise.resolve(onAdvert(ingested.verifiedNodeHash, ingested.body, meta))
@@ -319,7 +319,7 @@ export async function watchVerifiedNodeAdvert(nodeHash, onAdvert) {
  */
 export async function watchVerifiedGroupAdverts(roomSecret, onAdvert) {
 	return await watchGroupAdverts(roomSecret, async (bytes, meta) => {
-		const ingested = await ingestGroupAdvert(roomSecret, bytes, meta)
+		const ingested = await ingestGroupAdvert(roomSecret, bytes)
 		if (!ingested) return
 		noteVisibleNodeFromAdvert(ingested.verifiedNodeHash, { roomSecret })
 		await Promise.resolve(onAdvert(ingested.verifiedNodeHash, ingested.body, meta))

package/discovery/lan.mjs

@@ -59,7 +59,7 @@ export function clearLanVisibleNodes() {
  */
 export async function acceptLanPresenceAdvert(advertBytes, meta = {}) {
 	if (!advertBytes?.byteLength) return null
-	const ingested = await ingestNetworkAdvert(advertBytes, meta)
+	const ingested = await ingestNetworkAdvert(advertBytes)
 	if (!ingested) return null
 	const skipHash = meta.skipNodeHash ? normalizeHex64(meta.skipNodeHash) : null
 	if (skipHash && ingested.verifiedNodeHash === skipHash) return ingested
@@ -68,7 +68,7 @@ export async function acceptLanPresenceAdvert(advertBytes, meta = {}) {
 	noteAdvertPeerHints(ingested.verifiedNodeHash, ingested.body, meta)
 	if (firstSeen) {
 		noteDiscoveryPeerClue(ingested.verifiedNodeHash)
-		const host = String(meta.address || '').trim()
+		const host = String(meta.address || '')
 		nodeDebug('p2p:lan peer visible', {
 			peer: shortHash(ingested.verifiedNodeHash),
 			host: host || undefined,
@@ -85,7 +85,7 @@ export async function acceptLanPresenceAdvert(advertBytes, meta = {}) {
  */
 export function createLanDiscoveryProvider(options = {}) {
 	const port = Number(options.port) || DEFAULT_PORT
-	const group = String(options.group || DEFAULT_GROUP)
+	const group = options.group || DEFAULT_GROUP
 	/** @type {import('node:dgram').Socket | null} */
 	let socket = null
 	let bound = false