@steve02081504/fount-p2p 0.0.35 → 0.0.36

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/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/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

package/node/reputation_store.mjs

@@ -1,4 +1,4 @@
-import { assertHex64, isHex64, normalizeHex64 } from '../core/hexIds.mjs'
+import { assertHex64, isHex64 } from '../core/hexIds.mjs'
 import { recordWantIdsBackoff, wantIdsPeerKey } from '../federation/want_ids.mjs'
 import {
 	applyDecayCollusionAfterSlashPure,
@@ -120,7 +120,7 @@ export function recordGossipAllUnknownWant(groupId, peerNodeHash) {
  * @returns {Promise<void>}
  */
 export function recordMessageRateViolation(peerNodeHash, excessRatio = 1) {
-	const id = normalizeHex64(peerNodeHash)
+	const id = peerNodeHash
 	if (!id) return Promise.resolve()
 	return mutateReputation(data => {
 		recordMessageRateViolationPure(data, id, undefined, excessRatio)
@@ -134,7 +134,7 @@ export function recordMessageRateViolation(peerNodeHash, excessRatio = 1) {
  * @returns {Promise<boolean>} 是否触发异常隔离
  */
 export async function observePeerBehavior(peerNodeHash, sample) {
-	const id = normalizeHex64(peerNodeHash)
+	const id = peerNodeHash
 	if (!id) return false
 	let anomaly = false
 	await mutateReputation(data => {
@@ -149,7 +149,7 @@ export async function observePeerBehavior(peerNodeHash, sample) {
  * @returns {void}
  */
 export function bumpChunkStorageReputation(storagePeerKey) {
-	const id = normalizeHex64(storagePeerKey)
+	const id = storagePeerKey
 	if (!id) return
 	void mutateReputation(data => {
 		bumpChunkStorageReputationPure(data, id)
@@ -161,7 +161,7 @@ export function bumpChunkStorageReputation(storagePeerKey) {
  * @returns {void}
  */
 export function penalizeChunkStorageFailure(blamePeerKey) {
-	const id = normalizeHex64(blamePeerKey)
+	const id = blamePeerKey
 	if (!id) return
 	void mutateReputation(data => {
 		penalizeChunkStorageFailurePure(data, id)
@@ -173,7 +173,7 @@ export function penalizeChunkStorageFailure(blamePeerKey) {
  * @returns {void}
  */
 export function penalizeArchiveServeMismatch(peerNodeHash) {
-	const id = normalizeHex64(peerNodeHash)
+	const id = peerNodeHash
 	if (!id) return
 	void mutateReputation(data => {
 		penalizeArchiveServeMismatchPure(data, id)
@@ -187,9 +187,9 @@ export function penalizeArchiveServeMismatch(peerNodeHash) {
 export async function applyVolatileSlashAlert(alert) {
 	const expiresAt = Number(alert?.expiresAt)
 	if (Number.isFinite(expiresAt) && Date.now() > expiresAt) return false
-	const target = normalizeHex64(alert?.targetPubKeyHash)
-	const sender = normalizeHex64(alert?.sender)
-	if (!isHex64(target) || !isHex64(sender)) return false
+	const target = isHex64(alert?.targetPubKeyHash)
+	const sender = isHex64(alert?.sender)
+	if (!target || !sender) return false
 	const claim = Number.isFinite(Number(alert?.claim)) ? Number(alert.claim) : reputationTunables.slashDefaultClaim
 	await mutateReputation(data => {
 		applySubjectiveSlashPure(data, target, sender, claim, false)
@@ -227,8 +227,8 @@ export function buildUnverifiedSlashAlert(senderPubKeyHash, content, groupSettin
 export async function applySubjectiveSlashFromEvent(username, groupId, event, readEvents) {
 	if (event.type !== 'reputation_slash') return
 	const { content } = event
-	const target = normalizeHex64(content.targetPubKeyHash)
-	const sender = normalizeHex64(event.sender)
+	const target = content.targetPubKeyHash
+	const sender = event.sender
 
 	await mutateReputation(async data => {
 		const verified = content.verified && await verifySlashProof(username, groupId, content, readEvents)
@@ -245,7 +245,7 @@ export async function applySubjectiveSlashFromEvent(username, groupId, event, re
  * @returns {Promise<boolean>} 是否找到 proof 对应事件
  */
 async function verifySlashProof(username, groupId, content, readEvents) {
-	const eventId = normalizeHex64(content?.proof?.eventId)
+	const eventId = content?.proof?.eventId
 	if (!eventId) return false
 	const events = await readEvents(username, groupId)
 	return events.some(event => event.id === eventId)
@@ -261,7 +261,7 @@ export function applyDecayCollusionAfterSlash(targetPubKeyHash, inviteEdges) {
 		const applied = applyDecayCollusionAfterSlashPure(data, targetPubKeyHash, inviteEdges)
 		if (applied.length)
 			getNodeLogger()?.warn?.('reputation: collusion decay after slash', {
-				target: normalizeHex64(targetPubKeyHash),
+				target: targetPubKeyHash,
 				upstreamCount: applied.length,
 				hops: applied.map(row => row.hop),
 			})

package/node/reputation_sync.mjs

@@ -1,6 +1,6 @@
 import { randomUUID } from 'node:crypto'
 
-import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
+import { isHex64 } from '../core/hexIds.mjs'
 import { sendToNodeLink } from '../transport/link_registry.mjs'
 import { attachNodeScopeFeature } from '../transport/node_scope/features.mjs'
 import { ensureNodeScope, getNodeScopeWire } from '../transport/node_scope/wire.mjs'
@@ -55,9 +55,8 @@ function loadSyncConfig() {
 		? raw.lockedMaxPrevByNodeHash
 		: {}
 	for (const [nodeHash, score] of Object.entries(prevRaw)) {
-		const id = normalizeHex64(nodeHash)
 		const n = Number(score)
-		if (id && isHex64(id) && Number.isFinite(n)) lockedMaxPrevByNodeHash[id] = n
+		if (isHex64(nodeHash) && Number.isFinite(n)) lockedMaxPrevByNodeHash[nodeHash] = n
 	}
 	syncConfig = {
 		trustSyncDonors: normalizeHashList(raw.trustSyncDonors),
@@ -73,7 +72,7 @@ function loadSyncConfig() {
  * @returns {string[]} 规范化去重后的 64-hex 列表
  */
 function normalizeHashList(list) {
-	return [...new Set((Array.isArray(list) ? list : []).map(isHex64).filter(Boolean))]
+	return [...new Set(list?.map?.(isHex64)?.filter?.(Boolean) || [])]
 }
 
 /** 将当前 sync 配置写盘 */
@@ -91,8 +90,8 @@ export async function setReputationTable(table) {
 	await mutateReputation(data => {
 		data.byNodeHash = data.byNodeHash || {}
 		for (const [nodeHash, row] of Object.entries(incoming)) {
-			const id = normalizeHex64(nodeHash)
-			if (!id || !isHex64(id)) continue
+			const id = isHex64(nodeHash)
+			if (!id) continue
 			const score = Number(row?.score ?? row)
 			if (!Number.isFinite(score)) continue
 			data.byNodeHash[id] = { ...data.byNodeHash[id] || {}, score }
@@ -223,7 +222,7 @@ export function attachReputationSyncWire() {
 		 * @param {string} peerId 对端 nodeHash
 		 */
 		rep_sync_req(payload, peerId) {
-			const requester = normalizeHex64(peerId)
+			const requester = peerId
 			if (!requester || !getReputationExportAllowlist().includes(requester)) return
 			try {
 				wire.send('rep_sync_res', {
@@ -241,7 +240,7 @@ export function attachReputationSyncWire() {
 			const requestId = String(payload?.requestId || '')
 			const pending = pendingPulls.get(requestId)
 			if (!pending) return
-			if (normalizeHex64(peerId) !== pending.donor) return
+			if (peerId !== pending.donor) return
 			clearTimeout(pending.timer)
 			pendingPulls.delete(requestId)
 			pending.resolve(payload)
@@ -271,8 +270,8 @@ export function detachReputationSyncWire() {
  * @returns {Promise<object>} donor 返回的信誉表
  */
 export async function pullReputationFromNode(nodeHash) {
-	const donor = normalizeHex64(nodeHash)
-	if (!donor || !isHex64(donor)) throw new Error('p2p: pullReputationFromNode requires valid nodeHash')
+	const donor = isHex64(nodeHash)
+	if (!donor) throw new Error('p2p: pullReputationFromNode requires valid nodeHash')
 	if (!getTrustSyncDonors().includes(donor))
 		throw new Error('p2p: node not in trustSyncDonors')
 	attachReputationSyncWire()

package/package.json

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

package/reputation/engine.mjs

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

package/schemas/discovery.mjs

@@ -1,4 +1,4 @@
-import { assertHex64, isHex64, isSignatureHex128, normalizeHex64 } from '../core/hexIds.mjs'
+import { assertHex64, isHex64, isSignatureHex128 } from '../core/hexIds.mjs'
 import { isPlainObject } from '../core/object.mjs'
 
 const MAX_DISCOVERY_ADS = 64
@@ -10,16 +10,15 @@ const MAX_DISCOVERY_ADS = 64
 function sanitizeDiscoveryAdvertisement(ad) {
 	if (!isPlainObject(ad)) return null
 	const groupId = String(ad.groupId || '')
-	const advertiserPubKeyHash = normalizeHex64(ad.advertiserPubKeyHash)
-	const signature = String(ad.signature || '')
-	if (!groupId || !isHex64(advertiserPubKeyHash) || !isSignatureHex128(signature)) return null
-	const advertiserNodeHash = normalizeHex64(ad.advertiserNodeHash)
+	const advertiserPubKeyHash = isHex64(ad.advertiserPubKeyHash)
+	const signature = isSignatureHex128(ad.signature)
+	if (!groupId || !advertiserPubKeyHash || !signature) return null
 	const body = {
 		groupId,
 		title: String(ad.title || '').slice(0, 200),
 		blurb: String(ad.blurb || '').slice(0, 500),
 		advertiserPubKeyHash,
-		advertiserNodeHash: isHex64(advertiserNodeHash) || String(ad.advertiserNodeHash || ''),
+		advertiserNodeHash: isHex64(ad.advertiserNodeHash) || '',
 		observedAt: Number(ad.observedAt) || 0,
 		signature,
 	}

package/schemas/federation_pull.mjs

@@ -1,7 +1,7 @@
 /**
  * 联邦补拉 attestation / HPKE 响应 wire 解析（无 attestation/envelope 即丢弃）。
  */
-import { isHex64, isSignatureHex128, normalizeHex64 } from '../core/hexIds.mjs'
+import { isHex64, isSignatureHex128 } from '../core/hexIds.mjs'
 import { isPlainObject } from '../core/object.mjs'
 import { EVENT_ID_HEX } from '../dag/index.mjs'
 
@@ -23,15 +23,15 @@ function isEnvelopeBlob(value) {
  */
 export function parsePullAttestation(attestation) {
 	if (!isPlainObject(attestation)) return null
-	const requesterPubKeyHash = normalizeHex64(attestation.requesterPubKeyHash)
+	const requesterPubKeyHash = isHex64(attestation.requesterPubKeyHash)
 	const groupId = String(attestation.groupId || '')
 	const requestId = String(attestation.requestId || '')
 	const timestamp = Number(attestation.timestamp)
-	const signature = String(attestation.signature || '')
-	if (!isHex64(requesterPubKeyHash) || !groupId || !Number.isFinite(timestamp) || !isSignatureHex128(signature))
+	const signature = isSignatureHex128(attestation.signature)
+	if (!requesterPubKeyHash || !groupId || !Number.isFinite(timestamp) || !signature)
 		return null
 	const wantIds = attestation.wantIds?.length
-		? [...new Set(attestation.wantIds.map(id => normalizeHex64(id)).filter(id => EVENT_ID_HEX.test(id)))]
+		? [...new Set(attestation.wantIds.filter(id => EVENT_ID_HEX.test(id)))]
 		: undefined
 	return {
 		requesterPubKeyHash,
@@ -50,13 +50,13 @@ export function parsePullAttestation(attestation) {
 export function parsePullResponseEnvelope(envelope) {
 	if (!isPlainObject(envelope)) return null
 	const requestId = String(envelope.requestId || '')
-	const requesterPubKeyHash = normalizeHex64(envelope.requesterPubKeyHash)
+	const requesterPubKeyHash = isHex64(envelope.requesterPubKeyHash)
 	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 (!requestId || !requesterPubKeyHash || !requesterNodeHash) return null
 	if (!isEnvelopeBlob(ephemPub) || !isEnvelopeBlob(iv) || !isEnvelopeBlob(ciphertext) || !isEnvelopeBlob(authTag))
 		return null
 	return {

package/schemas/mailbox.mjs

@@ -1,4 +1,4 @@
-import { normalizeHex64, HEX_ID_64 } from '../core/hexIds.mjs'
+import { isHex64 } from '../core/hexIds.mjs'
 
 /**
  * @typedef {{ ok: true, value: string }} MailboxWireOk
@@ -17,8 +17,8 @@ import { normalizeHex64, HEX_ID_64 } from '../core/hexIds.mjs'
  * @returns {MailboxWireResult} 规范化 hex64 或结构化错误
  */
 export function assertMailboxPubKeyHash(value) {
-	const normalized = normalizeHex64(value)
-	if (!HEX_ID_64.test(normalized))
+	const normalized = isHex64(value)
+	if (!normalized)
 		return { ok: false, code: 'invalid_hex64', field: 'toPubKeyHash' }
 	return { ok: true, value: normalized }
 }

package/schemas/part_query.mjs

@@ -1,7 +1,7 @@
 import { Buffer } from 'node:buffer'
 
 import { canonicalStringify } from '../core/canonical_json.mjs'
-import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
+import { isHex64 } from '../core/hexIds.mjs'
 import { isPlainObject } from '../core/object.mjs'
 import { parsePartpath } from '../core/partpath.mjs'
 
@@ -99,8 +99,8 @@ export function parsePartQueryReq(value, tunables = partQueryTunables) {
 	if (!isPlainObject(value)) return null
 	const requestId = normalizeRequestId(value.requestId)
 	if (!requestId) return null
-	const originNodeHash = normalizeHex64(value.originNodeHash)
-	if (!isHex64(originNodeHash)) return null
+	const originNodeHash = isHex64(value.originNodeHash)
+	if (!originNodeHash) return null
 	const partpath = parsePartpath(value.partpath)
 	if (!partpath) return null
 	const kind = String(value.kind || '')
@@ -130,8 +130,8 @@ export function parsePartQueryRes(value, tunables = partQueryTunables) {
 	if (!isPlainObject(value)) return null
 	const requestId = normalizeRequestId(value.requestId)
 	if (!requestId) return null
-	const fromNodeHash = normalizeHex64(value.fromNodeHash)
-	if (!isHex64(fromNodeHash)) return null
+	const fromNodeHash = isHex64(value.fromNodeHash)
+	if (!fromNodeHash) return null
 	const rows = clampPartQueryRows(value.rows, tunables.maxHits, tunables.maxRowsBytes)
 	if (!rows) return null
 	return { requestId, fromNodeHash, rows }