@steve02081504/fount-p2p 0.0.35 → 0.0.37

package/link/providers/lan_tcp.mjs

@@ -2,7 +2,6 @@ import { Buffer } from 'node:buffer'
 import { randomBytes } from 'node:crypto'
 import net from 'node:net'
 
-import { normalizeHex64 } from '../../core/hexIds.mjs'
 import { getLanPeerHint, listLanPeerHints } from '../../discovery/lan_peer_hints.mjs'
 import { asLinkHandle } from '../pipe.mjs'
 
@@ -186,7 +185,7 @@ async function openTcpPipe(options) {
 		pipe.handleInbound(payload)
 
 	if (options.initiator)
-		codec.write(buildLinkOpen(normalizeHex64(options.linkId), options.localIdentity?.nodeHash))
+		codec.write(buildLinkOpen(options.linkId, options.localIdentity?.nodeHash))
 
 	await pipe.startHandshake()
 	return asLinkHandle(pipe)
@@ -198,7 +197,7 @@ async function openTcpPipe(options) {
  * @returns {Promise<import('./index.mjs').LinkHandle>} 已就绪的 link
  */
 async function dialLanTcp(options) {
-	const remoteNodeHash = normalizeHex64(options.nodeHash)
+	const remoteNodeHash = options.nodeHash
 	const hints = listLanPeerHints(remoteNodeHash)
 	if (!hints.length) throw new Error('p2p: lan_tcp no peer hint')
 

package/link/providers/link_id_pipe.mjs

@@ -1,6 +1,6 @@
 import { Buffer } from 'node:buffer'
 
-import { normalizeHex64 } from '../../core/hexIds.mjs'
+import { isHex64 } from '../../core/hexIds.mjs'
 import { createLinkPipe } from '../pipe.mjs'
 
 /**
@@ -25,7 +25,7 @@ export function parseLinkOpen(raw) {
 	}
 	catch { return null }
 	if (parsed?.type !== 'link-open' || !parsed.linkId) return null
-	return { linkId: String(parsed.linkId), from: normalizeHex64(parsed.from) || null }
+	return { linkId: String(parsed.linkId), from: isHex64(parsed.from) }
 }
 
 /**
@@ -34,7 +34,7 @@ export function parseLinkOpen(raw) {
  * @returns {ReturnType<typeof createLinkPipe>} link pipe
  */
 export function createLinkIdBoundPipe(options) {
-	const linkId = normalizeHex64(options.linkId)
+	const { linkId } = options
 	if (!linkId) throw new Error(`p2p: ${options.providerId || 'link'} linkId required`)
 	return createLinkPipe({
 		...options,

package/link/providers/{nostr.mjs → nostr/index.mjs}

@@ -1,17 +1,16 @@
 import { Buffer } from 'node:buffer'
 import { randomBytes } from 'node:crypto'
 
-import { base64ToBytes, bytesToBase64 } from '../../core/bytes_codec.mjs'
-import { normalizeHex64 } from '../../core/hexIds.mjs'
-import { getDiscoveryProvider, sendNodeSignalPacket } from '../../discovery/index.mjs'
-import { NOSTR_SIGNAL_KIND, resolveNostrRelayUrls } from '../../discovery/nostr.mjs'
-import { ms } from '../../utils/duration.mjs'
-import { createLruMap } from '../../utils/lru.mjs'
-import { FRAME_HEADER_BYTES, maxFrameChunkBytesForPayload } from '../frame.mjs'
-import { asLinkHandle } from '../pipe.mjs'
-
-import { LINK_LEVEL_NOSTR } from './levels.mjs'
-import { createLinkIdBoundPipe } from './link_id_pipe.mjs'
+import { base64ToBytes, bytesToBase64 } from '../../../core/bytes_codec.mjs'
+import { isHex64 } from '../../../core/hexIds.mjs'
+import { getDiscoveryProvider, sendNodeSignalPacket } from '../../../discovery/index.mjs'
+import { NOSTR_SIGNAL_KIND, resolveNostrRelayUrls } from '../../../discovery/nostr/index.mjs'
+import { ms } from '../../../utils/duration.mjs'
+import { createLruMap } from '../../../utils/lru.mjs'
+import { FRAME_HEADER_BYTES, maxFrameChunkBytesForPayload } from '../../frame.mjs'
+import { asLinkHandle } from '../../pipe.mjs'
+import { LINK_LEVEL_NOSTR } from '../levels.mjs'
+import { createLinkIdBoundPipe } from '../link_id_pipe.mjs'
 
 /** 单包 payload（UTF-8 / base64）上限，避免撞 relay content 限制。
  *  默认兜底取 2026-08 本机对默认公共 relay 的 NIP-11 `max_message_length` 非零最小值（131072 = nostr.mom）。
@@ -317,9 +316,8 @@ export function createNostrLinkProvider(options = {}) {
 	 */
 	async function deliverPacket(packet) {
 		if (packet?.type !== 'link') return
-		const linkId = normalizeHex64(packet.linkId)
-		const from = normalizeHex64(packet.from)
-		if (!linkId || !from) return
+		const { linkId, from } = packet
+		if (!isHex64(linkId) || !isHex64(from)) return
 		if (localIdentity?.nodeHash && from === localIdentity.nodeHash) return
 
 		const op = String(packet.op || '')
@@ -375,8 +373,8 @@ export function createNostrLinkProvider(options = {}) {
 		 */
 		async dial(dialOptions) {
 			if (!isAvailable()) return null
-			const remoteNodeHash = normalizeHex64(dialOptions.nodeHash)
-			if (!remoteNodeHash) return null
+			const remoteNodeHash = dialOptions.nodeHash
+			if (!isHex64(remoteNodeHash)) return null
 			localIdentity = dialOptions.localIdentity || localIdentity
 			if (!localIdentity?.nodeHash) throw new Error('p2p: nostr dial requires localIdentity')
 			await refreshPayloadCap(resolveRelayUrls())
@@ -398,8 +396,15 @@ export function createNostrLinkProvider(options = {}) {
 		ensureListening(handlers) {
 			onInbound = handlers.onInbound
 			localIdentity = handlers.localIdentity
-			void refreshPayloadCap(resolveRelayUrls())
+			// 探测延迟到启动路径之外（首个 macrotask），避免同步 fetch 阻塞 startup 预算。
+			const capTimer = setTimeout(() => {
+				let relayUrls
+				try { relayUrls = resolveRelayUrls() } catch { return }
+				void refreshPayloadCap(relayUrls).catch(() => { })
+			}, 0)
+			capTimer.unref?.()
 			return () => {
+				clearTimeout(capTimer)
 				onInbound = null
 				for (const session of sessions.values())
 					void session.pipe.close('listen-stop')

package/mailbox/deliver_or_store.mjs

@@ -1,4 +1,4 @@
-import { normalizeHex64 } from '../core/hexIds.mjs'
+import { isHex64 } from '../core/hexIds.mjs'
 import { getNodeTransportSettings, getNodeHash } from '../node/identity.mjs'
 import { activeLinkRoster, deliverToUserRoomPeers } from '../transport/user_room.mjs'
 import { DEFAULT_TRUST_GRAPH_OWNER, requireTrustGraphProvider } from '../trust_graph/registry.mjs'
@@ -25,7 +25,7 @@ import {
 async function resolveRemoteNodeHashForPeer(username, peerId) {
 	if (!peerId) return null
 	const entry = activeLinkRoster().find(row => row.peerId === peerId)
-	const remote = normalizeHex64(entry?.remoteNodeHash)
+	const remote = entry?.remoteNodeHash
 	return remote || null
 }
 
@@ -62,8 +62,8 @@ async function resolveRouting(username) {
  */
 export async function deliverOrStoreMailboxPut(username, options) {
 	const routing = await resolveRouting(username)
-	const toPubKeyHash = normalizeHex64(options.toPubKeyHash)
-	if (!toPubKeyHash) return { stored: false, delivered: false, relayed: 0 }
+	const { toPubKeyHash } = options
+	if (!isHex64(toPubKeyHash)) return { stored: false, delivered: false, relayed: 0 }
 	const hop = normalizeMailboxHop(options.hop)
 	if (hop >= routing.maxHop) return { stored: false, delivered: false, relayed: 0 }
 	const tier = mailboxTierFromHop(hop)
@@ -76,9 +76,8 @@ export async function deliverOrStoreMailboxPut(username, options) {
 		fromNodeHash: options.record?.fromNodeHash || nodeHash,
 	}
 	const stored = await storeMailboxRecord(record)
-	const toNodeHash = normalizeHex64(options.toNodeHash)
-	const delivered = toNodeHash && isMailboxRecordWithinSizeLimit(record)
-		? await requireTrustGraphProvider(DEFAULT_TRUST_GRAPH_OWNER).sendToNode(username, toNodeHash, 'mailbox_put', { nodeHash, record })
+	const delivered = isHex64(options.toNodeHash) && isMailboxRecordWithinSizeLimit(record)
+		? await requireTrustGraphProvider(DEFAULT_TRUST_GRAPH_OWNER).sendToNode(username, options.toNodeHash, 'mailbox_put', { nodeHash, record })
 		: false
 
 	let relayed = 0
@@ -114,8 +113,8 @@ export async function publishMailboxRecord(username, toPubKeyHash, record, toNod
 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 fromNode = put.nodeHash
+	if (!isHex64(fromNode) || !takeIncomingMailboxPutSlot(fromNode)) return
 	const username = wireContext.replicaUsername || ''
 	if (!username) return
 	if (peerId) {
@@ -143,8 +142,8 @@ export async function ingestMailboxPut(wireContext, put, peerId = '') {
  */
 export async function respondMailboxWant(want, sendGive, peerId) {
 	const { getMailboxRecords, takeMailboxForRecipient } = await import('./store.mjs')
-	const recipient = normalizeHex64(want.toPubKeyHash)
-	if (!recipient) return
+	const recipient = want.toPubKeyHash
+	if (!isHex64(recipient)) return
 	const ids = want.ids || []
 	const rows = (ids.length
 		? await getMailboxRecords(ids)
@@ -179,7 +178,7 @@ export async function ingestMailboxGive(wireContext, give) {
 export async function requestMailboxFromNetwork(username, toPubKeyHash) {
 	const routing = await resolveRouting(username)
 	const { listMailboxIdsForRecipient } = await import('./store.mjs')
-	const recipient = normalizeHex64(toPubKeyHash)
+	const recipient = toPubKeyHash
 	if (!recipient) return
 	await deliverToUserRoomPeers(username, 'mailbox_want', {
 		toPubKeyHash: recipient,

package/mailbox/prune.mjs

@@ -1,7 +1,6 @@
 /**
  * Mailbox 公平淘汰（纯函数，供 store 与单测复用）。
  */
-import { normalizeHex64 } from '../core/hexIds.mjs'
 
 /** 单收件人×发送者桶：条数上限 */
 export const MAX_BUCKET_ENTRIES = 10
@@ -31,9 +30,9 @@ export function mailboxRecordBytes(record) {
  * @returns {string} 公平淘汰桶键
  */
 export function mailboxBucketKey(record) {
-	const to = normalizeHex64(record.toPubKeyHash) || ''
-	const from = normalizeHex64(record.fromNodeHash)
-		|| normalizeHex64(record.envelope?.sender)
+	const to = record.toPubKeyHash || ''
+	const from = record.fromNodeHash
+		|| record.envelope?.sender
 		|| 'unknown'
 	return `${to}\0${from}`
 }

package/mailbox/rate.mjs

@@ -1,7 +1,7 @@
 /**
  * Mailbox 入站 put 限速（按来源节点，节点级单例）。
  */
-import { normalizeHex64 } from '../core/hexIds.mjs'
+import { isHex64 } from '../core/hexIds.mjs'
 
 const DEFAULT_WINDOW_MS = 60_000
 const DEFAULT_MAX_PUTS = 20
@@ -62,7 +62,8 @@ function evictLruIfNeeded(key) {
  */
 export function takeIncomingMailboxPutSlot(fromNodeHash, limits) {
 	const { windowMs, maxPuts } = resolveMailboxRateLimits(limits)
-	const key = normalizeHex64(fromNodeHash)
+	const key = fromNodeHash
+	if (!isHex64(key)) return false
 	const now = Date.now()
 	if (inboundByKey.size >= MAX_KEYS) sweepExpiredEntries(now)
 	evictLruIfNeeded(key)

package/mailbox/store.mjs

@@ -1,7 +1,7 @@
 import { mkdir, readFile } from 'node:fs/promises'
 import { dirname } from 'node:path'
 
-import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
+import { isHex64 } from '../core/hexIds.mjs'
 import { jsonlMutexKey, writeJsonl } from '../dag/storage.mjs'
 import { mailboxStorePath } from '../node/user_paths.mjs'
 import { withAsyncMutex } from '../utils/async_mutex.mjs'
@@ -150,7 +150,7 @@ export function mailboxEnvelopeId(envelope) {
  */
 export async function storeMailboxRecord(record) {
 	if (!isMailboxRecordWithinSizeLimit(record)) return false
-	const toPubKeyHash = normalizeHex64(record.toPubKeyHash)
+	const { toPubKeyHash } = record
 	if (!isHex64(toPubKeyHash)) return false
 	const hop = normalizeMailboxHop(record.hop)
 	const { tier } = record
@@ -178,7 +178,7 @@ export async function storeMailboxRecord(record) {
 			envelope: record.envelope,
 			storedAt: Date.now(),
 			expiresAt: Date.now() + ttlMs,
-			fromNodeHash: normalizeHex64(record.fromNodeHash),
+			fromNodeHash: record.fromNodeHash,
 			hop,
 			tier,
 			importance: Number.isFinite(Number(record.importance)) ? Number(record.importance) : undefined,
@@ -193,9 +193,8 @@ export async function storeMailboxRecord(record) {
  * @returns {Promise<string[]>} record id 列表
  */
 export async function listMailboxIdsForRecipient(toPubKeyHash) {
-	const recipient = normalizeHex64(toPubKeyHash)
 	return (await readAll())
-		.filter(record => record.toPubKeyHash === recipient)
+		.filter(record => record.toPubKeyHash === toPubKeyHash)
 		.map(record => record.id)
 }
 
@@ -224,8 +223,7 @@ export async function deleteMailboxRecords(ids) {
  * @returns {Promise<MailboxRecord[]>} 待发记录（不删除）
  */
 export async function takeMailboxForRecipient(toPubKeyHash) {
-	const recipient = normalizeHex64(toPubKeyHash)
-	return (await readAll()).filter(record => record.toPubKeyHash === recipient)
+	return (await readAll()).filter(record => record.toPubKeyHash === toPubKeyHash)
 }
 
 /**
@@ -233,9 +231,8 @@ export async function takeMailboxForRecipient(toPubKeyHash) {
  * @returns {Promise<number>} 未过期条数
  */
 export async function countMailboxPendingForRecipient(toPubKeyHash) {
-	const recipient = normalizeHex64(toPubKeyHash)
 	const now = Date.now()
-	return (await readAll()).filter(record => record.toPubKeyHash === recipient && record.expiresAt > now).length
+	return (await readAll()).filter(record => record.toPubKeyHash === toPubKeyHash && record.expiresAt > now).length
 }
 
 /**

package/node/denylist.mjs

@@ -1,6 +1,6 @@
 import { compositeKey } from '../core/composite_key.mjs'
 import { isEntityHash128 } from '../core/entity_id.mjs'
-import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
+import { isHex64 } from '../core/hexIds.mjs'
 import { withAsyncMutex } from '../utils/async_mutex.mjs'
 
 import { readNodeJsonSync, writeNodeJsonSync } from './storage.mjs'
@@ -79,15 +79,15 @@ export function normalizeDenylist(raw) {
 		const groupId = String(entry.groupId || '')
 		if (!scope) continue
 		if (scope === 'entity') {
-			const value = String(entry?.value || '')
-			if (isEntityHash128(value))
+			const value = isEntityHash128(entry?.value)
+			if (value)
 				blocked.push({ scope: 'entity', value })
 			continue
 		}
-		const value = normalizeHex64(entry?.value)
-		if (scope === 'node' && isHex64(value))
+		const value = isHex64(entry?.value)
+		if (scope === 'node' && value)
 			blocked.push({ scope: 'node', value, ...groupId ? { groupId } : {} })
-		else if (scope === 'subject' && isHex64(value))
+		else if (scope === 'subject' && value)
 			blocked.push({ scope: 'subject', value, ...groupId ? { groupId } : {} })
 	}
 	return { blocked }
@@ -116,12 +116,12 @@ export function saveDenylist(list) {
  * @returns {boolean} 是否命中群级 ban 集合
  */
 export function isSubjectBannedByState(state, subject) {
-	const pk = normalizeHex64(subject?.pubKeyHash)
-	if (isHex64(pk) && state?.bannedMembers?.has?.(pk)) return true
-	const entity = String(subject?.entityHash || '')
-	if (isEntityHash128(entity) && state?.bannedEntities?.has?.(entity)) return true
-	const node = normalizeHex64(subject?.nodeHash)
-	if (isHex64(node) && state?.bannedNodes?.has?.(node)) return true
+	const pk = isHex64(subject?.pubKeyHash)
+	if (pk && state?.bannedMembers?.has?.(pk)) return true
+	const entity = isEntityHash128(subject?.entityHash)
+	if (entity && state?.bannedEntities?.has?.(entity)) return true
+	const node = isHex64(subject?.nodeHash)
+	if (node && state?.bannedNodes?.has?.(node)) return true
 	return false
 }
 
@@ -132,17 +132,17 @@ export function isSubjectBannedByState(state, subject) {
  * @returns {boolean} 是否命中
  */
 function matchesDenylistIndex(index, subject, groupId = '') {
-	const pk = normalizeHex64(subject?.pubKeyHash)
+	const pk = isHex64(subject?.pubKeyHash)
 	const entity = String(subject?.entityHash || '')
-	const node = normalizeHex64(subject?.nodeHash)
+	const node = isHex64(subject?.nodeHash)
 	const { keys } = index
 
 	if (entity && keys.has(denyKey('entity', '*', entity))) return true
-	if (isHex64(node) && keys.has(denyKey('node', '*', node))) return true
-	if (isHex64(pk) && keys.has(denyKey('subject', '*', pk))) return true
+	if (node && keys.has(denyKey('node', '*', node))) return true
+	if (pk && keys.has(denyKey('subject', '*', pk))) return true
 	if (!groupId) return false
-	if (isHex64(pk) && keys.has(denyKey('subject', groupId, pk))) return true
-	if (isHex64(node) && keys.has(denyKey('node', groupId, node))) return true
+	if (pk && keys.has(denyKey('subject', groupId, pk))) return true
+	if (node && keys.has(denyKey('node', groupId, node))) return true
 	return false
 }
 
@@ -161,8 +161,8 @@ export function isSubjectBlocked(subject, groupId = '') {
  * @returns {boolean} 是否拉黑
  */
 export function isPeerKeyBlocked(groupId, peerKey) {
-	const key = normalizeHex64(peerKey)
-	if (!isHex64(key)) return false
+	const key = isHex64(peerKey)
+	if (!key) return false
 	const index = getDenylistIndex()
 	const { keys } = index
 	if (keys.has(denyKey('subject', '*', key))) return true
@@ -200,9 +200,7 @@ export function addDenylistEntry(entry) {
 		throw new Error('scope and value required')
 	if (scope === 'entity' && entry.groupId)
 		throw new Error('entity scope does not use groupId')
-	const normValue = scope === 'node' || scope === 'subject'
-		? normalizeHex64(entry.value)
-		: entry.value
+	const normValue = entry.value
 	if (!normValue)
 		throw new Error('scope and value required')
 	if (scope === 'subject' && !isHex64(normValue))
@@ -234,8 +232,8 @@ export async function addDenylistFromBanContent(banContent, groupId) {
 		await addDenylistEntry({ scope: 'entity', value: banContent.targetEntityHash })
 	if (scope === 'node' && banContent?.targetNodeHash)
 		await addDenylistEntry({ scope: 'node', value: banContent.targetNodeHash })
-	const pk = normalizeHex64(banContent?.targetPubKeyHash)
-	if (isHex64(pk))
+	const pk = isHex64(banContent?.targetPubKeyHash)
+	if (pk)
 		await addDenylistEntry({ scope: 'subject', value: pk, ...sourceGroupId ? { groupId: sourceGroupId } : {} })
 }
 
@@ -259,12 +257,11 @@ export function addGroupBlockedPeer(groupId, scope, value) {
  * @returns {Promise<void>}
  */
 export function removeGroupBlockedPeer(groupId, scope, value) {
-	const id = scope === 'entity' ? value : normalizeHex64(value)
-	if (!scope || !id) return Promise.resolve()
+	if (!scope || !value) return Promise.resolve()
 	return mutateDenylist(() => {
 		const list = loadDenylist()
 		list.blocked = list.blocked.filter(entry => {
-			if (entry.scope !== scope || entry.value !== id) return true
+			if (entry.scope !== scope || entry.value !== value) return true
 			if (scope === 'entity') return false
 			return entry.groupId !== groupId
 		})

package/node/feature_config.mjs

@@ -0,0 +1,30 @@
+/**
+ * 通用包级行为开关（布尔 feature map）：`{ census: true, ... }`。
+ * 新增功能只需加入新布尔 key，无需新增专属设置界面。
+ */
+
+/** 默认 feature：census 默认开启（人口统计，基于 nostr）。 */
+const DEFAULT_P2P_FEATURES = { census: true }
+
+/**
+ * @returns {Record<string, boolean>} 默认 feature map 快照
+ */
+export function defaultP2PFeatures() {
+	return { ...DEFAULT_P2P_FEATURES }
+}
+
+/**
+ * 归一化 feature map：已知 key 用默认值，patch 中未知 key 原样透传（值必须为 boolean）。
+ * @param {Record<string, boolean>} [patch] 部分 feature 覆盖
+ * @returns {Record<string, boolean>} 完整 boolean feature map
+ */
+export function resolveP2PFeatures(patch = {}) {
+	/** @type {Record<string, boolean>} */
+	const out = defaultP2PFeatures()
+	for (const [key, value] of Object.entries(patch)) {
+		if (value !== true && value !== false)
+			throw new Error(`p2p: feature "${key}" must be boolean`)
+		out[key] = value
+	}
+	return out
+}

package/node/identity.mjs

@@ -2,7 +2,7 @@ import { Buffer } from 'node:buffer'
 import { randomBytes } from 'node:crypto'
 
 import { entityHashFromRecoveryPubKeyHex, parseEntityHash } from '../core/entity_id.mjs'
-import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
+import { isHex64 } from '../core/hexIds.mjs'
 import { keyPairFromSeed, pubKeyHash } from '../crypto/crypto.mjs'
 import { normalizeMailboxSettings } from '../mailbox/settings.mjs'
 
@@ -17,7 +17,7 @@ const NODE_JSON = 'node'
  * @returns {string} 节点哈希
  */
 export function nodeHashFromSeed(seedHex) {
-	const seed = Buffer.from(normalizeHex64(seedHex), 'hex')
+	const seed = Buffer.from(seedHex, 'hex')
 	if (seed.length !== 32) throw new Error('invalid node seed')
 	const { publicKey } = keyPairFromSeed(seed)
 	return pubKeyHash(publicKey)
@@ -46,8 +46,8 @@ function saveNodeFile(patch) {
  */
 export function ensureNodeSeed() {
 	const data = loadNodeFile()
-	const existing = normalizeHex64(data.nodeSeedHex)
-	if (isHex64(existing)) return existing
+	const existing = isHex64(data.nodeSeedHex)
+	if (existing) return existing
 	const nodeSeedHex = randomBytes(32).toString('hex')
 	saveNodeFile({ nodeSeedHex })
 	return nodeSeedHex
@@ -105,8 +105,8 @@ export function ensureNodeDefaults() {
  * @returns {string | null} entityHash（非法 hex 时 null）
  */
 export function entityHashFromKeys(nodeHash, recoveryPubKeyHex) {
-	const pub = normalizeHex64(recoveryPubKeyHex)
-	if (!isHex64(nodeHash) || !isHex64(pub)) return null
+	const pub = isHex64(recoveryPubKeyHex)
+	if (!isHex64(nodeHash) || !pub) return null
 	return entityHashFromRecoveryPubKeyHex(nodeHash, pub)
 }
 

package/node/instance.mjs

@@ -1,6 +1,7 @@
 import path from 'node:path'
 
 import { createFsEntityStore } from './entity_store.mjs'
+import { resolveP2PFeatures } from './feature_config.mjs'
 import { closeAllFileStreams } from './handles.mjs'
 import { defaultSignalingRuntimeConfig, resolveSignalingRuntimeConfig } from './signaling_config.mjs'
 
@@ -14,6 +15,7 @@ import { defaultSignalingRuntimeConfig, resolveSignalingRuntimeConfig } from './
  *   entityStore: import('./entity_store.mjs').EntityStore
  *   logger: NodeLogger | null
  *   signaling: SignalingRuntimeConfig
+ *   features: Record<string, boolean>
  * }} NodeRuntime
  */
 
@@ -49,6 +51,7 @@ export function initNode(options) {
 		entityStore,
 		logger: console,
 		signaling: resolveSignalingRuntimeConfig(),
+		features: resolveP2PFeatures(),
 	}
 	return runtime
 }
@@ -101,6 +104,24 @@ export function getSignalingRuntimeConfig() {
 	return runtime?.signaling ?? defaultSignalingRuntimeConfig()
 }
 
+/**
+ * 设置包级行为开关（布尔 feature map）；运行时切换，生效于对应 feature 的下一轮。
+ * @param {Record<string, boolean>} config - feature 补丁
+ * @returns {void}
+ */
+export function setP2PFeatures(config) {
+	if (!runtime) throw new Error('p2p: setP2PFeatures requires initNode')
+	runtime.features = resolveP2PFeatures({ ...runtime.features, ...config })
+	emitNodeChange('features-changed', runtime.features)
+}
+
+/**
+ * @returns {Record<string, boolean>} 当前包级 feature map
+ */
+export function getP2PFeatures() {
+	return { ...getNode().features }
+}
+
 /**
  * @returns {string} 节点数据目录绝对路径
  */

package/node/network.mjs

@@ -1,5 +1,5 @@
 import { isEntityHash128 } from '../core/entity_id.mjs'
-import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
+import { isHex64 } from '../core/hexIds.mjs'
 
 import { loadDenylist } from './denylist.mjs'
 import { getNodeDir, isNodeInitialized } from './instance.mjs'
@@ -57,7 +57,7 @@ export function normalizeNetwork(raw) {
 	)]
 	const hints = (file.hints || [])
 		.map(hint => ({
-			nodeHash: normalizeHex64(hint.nodeHash) || '',
+			nodeHash: hint.nodeHash || '',
 			source: String(hint.source || ''),
 			kind: String(hint.kind || ''),
 			weight: Number.isFinite(Number(hint.weight)) ? Number(hint.weight) : 0.1,
@@ -126,8 +126,8 @@ export function saveNetwork(data) {
  * @returns {void}
  */
 export function applyNetworkHint(hint) {
-	const nodeHash = normalizeHex64(hint?.nodeHash)
-	if (!isHex64(nodeHash)) return
+	const nodeHash = isHex64(hint?.nodeHash)
+	if (!nodeHash) return
 	const net = loadNetwork()
 	const now = Date.now()
 	const ttlMs = Number.isFinite(hint.ttlMs) ? hint.ttlMs : DEFAULT_EXPLORE_TTL_MS
@@ -160,8 +160,8 @@ export function widenExploreFromTrustedAnchors() {
 	const net = loadNetwork()
 	const now = Date.now()
 	for (const raw of net.trustedPeers.slice(0, 12)) {
-		const nodeHash = normalizeHex64(raw)
-		if (!isHex64(nodeHash)) continue
+		const nodeHash = isHex64(raw)
+		if (!nodeHash) continue
 		if (!net.explorePeers.includes(nodeHash))
 			net.explorePeers.push(nodeHash)
 		net.hints.push({
@@ -185,12 +185,12 @@ export function widenExploreFromTrustedAnchors() {
 export function mergeNetworkPeerPools(patch = {}) {
 	const net = loadNetwork()
 	for (const raw of patch.trustedPeers || []) {
-		const id = normalizeHex64(raw)
-		if (isHex64(id) && !net.trustedPeers.includes(id)) net.trustedPeers.push(id)
+		const id = isHex64(raw)
+		if (id && !net.trustedPeers.includes(id)) net.trustedPeers.push(id)
 	}
 	for (const raw of patch.explorePeers || []) {
-		const id = normalizeHex64(raw)
-		if (isHex64(id) && !net.explorePeers.includes(id)) net.explorePeers.push(id)
+		const id = isHex64(raw)
+		if (id && !net.explorePeers.includes(id)) net.explorePeers.push(id)
 	}
 	net.lastRosterAt = Date.now()
 	saveNetwork(net)
@@ -203,8 +203,8 @@ export function mergeNetworkPeerPools(patch = {}) {
  */
 export function promoteExplorePeer(nodeHash) {
 	const net = loadNetwork()
-	const id = normalizeHex64(nodeHash)
-	if (!isHex64(id)) return
+	const id = isHex64(nodeHash)
+	if (!id) return
 	net.explorePeers = net.explorePeers.filter(peer => peer !== id)
 	if (!net.trustedPeers.includes(id)) net.trustedPeers.push(id)
 	net.lastRosterAt = Date.now()

package/node/personal_block.mjs

@@ -4,7 +4,7 @@
  * **hide**：纯本地隐藏（personal_hide.json，永不联邦）。
  */
 import { parseEntityHash } from '../core/entity_id.mjs'
-import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
+import { isHex64 } from '../core/hexIds.mjs'
 
 import { isWritableLocalEntity } from './identity.mjs'
 import { isNodeInitialized, getEntityStore } from './instance.mjs'
@@ -45,8 +45,8 @@ export function normalizePersonalListEntries(raw) {
 				byKey.set(`entity:${parsed.entityHash}`, { scope: 'entity', value: parsed.entityHash })
 		}
 		else if (scope === 'subject') {
-			const value = normalizeHex64(entry?.value)
-			if (isHex64(value))
+			const value = isHex64(entry?.value)
+			if (value)
 				byKey.set(`subject:${value}`, { scope: 'subject', value })
 		}
 	}
@@ -64,7 +64,7 @@ export function normalizePersonalListEntries(raw) {
  */
 export function matchesPersonalListEntries(entries, subject) {
 	const entity = subject?.entityHash || ''
-	const pk = normalizeHex64(subject?.pubKeyHash || subject?.subjectHash || '')
+	const pk = subject?.pubKeyHash || subject?.subjectHash || ''
 	if (entity) {
 		for (const entry of entries)
 			if (entry.scope === 'entity' && entry.value === entity) return true