@steve02081504/fount-p2p 0.0.26 → 0.0.28

package/mailbox/store.mjs

@@ -73,7 +73,7 @@ export function mailboxTierFromHop(hop) {
  */
 export function isDeliverableMailboxRecord(row) {
 	if (!row?.envelope || typeof row.envelope !== 'object') return false
-	if (!String(row.app || '').trim()) return false
+	if (!String(row.app || '')) return false
 	return row.tier === 'trusted' || row.tier === 'normal'
 }
 
@@ -139,7 +139,7 @@ async function writeAll(rows) {
  * @returns {string} 稳定信封 id
  */
 export function mailboxEnvelopeId(envelope) {
-	const id = String(envelope?.id || '').trim().toLowerCase()
+	const id = String(envelope?.id || '')
 	if (!id) throw new Error('mailbox envelope id required')
 	return id
 }
@@ -155,7 +155,7 @@ export async function storeMailboxRecord(record) {
 	const hop = normalizeMailboxHop(record.hop)
 	const { tier } = record
 	if (!['trusted', 'normal', 'quarantine'].includes(tier)) return false
-	const app = String(record.app || '').trim()
+	const app = String(record.app || '')
 	if (!app) return false
 	let id
 	try {
@@ -172,13 +172,13 @@ export async function storeMailboxRecord(record) {
 			id,
 			app,
 			toPubKeyHash,
-			dmSessionTag: record.dmSessionTag?.trim().toLowerCase() || undefined,
+			dmSessionTag: record.dmSessionTag ? String(record.dmSessionTag) : undefined,
 			groupId: record.groupId || undefined,
 			channelId: record.channelId || undefined,
 			envelope: record.envelope,
 			storedAt: Date.now(),
 			expiresAt: Date.now() + ttlMs,
-			fromNodeHash: String(record.fromNodeHash || '').trim(),
+			fromNodeHash: normalizeHex64(record.fromNodeHash),
 			hop,
 			tier,
 			importance: Number.isFinite(Number(record.importance)) ? Number(record.importance) : undefined,
@@ -204,7 +204,7 @@ export async function listMailboxIdsForRecipient(toPubKeyHash) {
  * @returns {Promise<MailboxRecord[]>} 匹配记录
  */
 export async function getMailboxRecords(ids) {
-	const want = new Set(ids.map(id => String(id).trim().toLowerCase()))
+	const want = new Set(ids.map(id => String(id)))
 	return (await readAll()).filter(record => want.has(record.id))
 }
 
@@ -213,7 +213,7 @@ export async function getMailboxRecords(ids) {
  * @returns {Promise<void>}
  */
 export async function deleteMailboxRecords(ids) {
-	const drop = new Set(ids.map(id => String(id).trim().toLowerCase()))
+	const drop = new Set(ids.map(id => String(id)))
 	return withAsyncMutex(mailboxStoreMutexKey(), async () => {
 		await writeAll((await readAll()).filter(record => !drop.has(record.id)))
 	})

package/node/denylist.mjs

@@ -46,7 +46,7 @@ function buildDenylistIndex(blocked) {
 	/** @type {DenylistIndex} */
 	const index = { blocked, keys: new Set() }
 	for (const entry of blocked) {
-		const gid = String(entry.groupId || '').trim() || '*'
+		const gid = entry.groupId || '*'
 		if (entry.scope === 'entity') {
 			index.keys.add(denyKey('entity', '*', entry.value))
 			continue
@@ -75,19 +75,20 @@ export function normalizeDenylist(raw) {
 	/** @type {Array<{ scope: DenyScope, value: string, groupId?: string }>} */
 	const blocked = []
 	for (const entry of raw?.blocked || []) {
-		const scope = String(entry?.scope || '').trim().toLowerCase()
-		const value = String(entry?.value || '').trim().toLowerCase()
-		const groupId = String(entry.groupId || '').trim()
-		if (!scope || !value) continue
+		const scope = String(entry?.scope || '')
+		const groupId = String(entry.groupId || '')
+		if (!scope) continue
 		if (scope === 'entity') {
+			const value = String(entry?.value || '')
 			if (isEntityHash128(value))
 				blocked.push({ scope: 'entity', value })
 			continue
 		}
-		if (scope === 'node' && isHex64(normalizeHex64(value)))
-			blocked.push({ scope: 'node', value: normalizeHex64(value), ...groupId ? { groupId } : {} })
-		else if (scope === 'subject' && isHex64(normalizeHex64(value)))
-			blocked.push({ scope: 'subject', value: normalizeHex64(value), ...groupId ? { groupId } : {} })
+		const value = normalizeHex64(entry?.value)
+		if (scope === 'node' && isHex64(value))
+			blocked.push({ scope: 'node', value, ...groupId ? { groupId } : {} })
+		else if (scope === 'subject' && isHex64(value))
+			blocked.push({ scope: 'subject', value, ...groupId ? { groupId } : {} })
 	}
 	return { blocked }
 }
@@ -117,7 +118,7 @@ export function saveDenylist(list) {
 export function isSubjectBannedByState(state, subject) {
 	const pk = normalizeHex64(subject?.pubKeyHash)
 	if (isHex64(pk) && state?.bannedMembers?.has?.(pk)) return true
-	const entity = String(subject?.entityHash || '').trim().toLowerCase()
+	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
@@ -132,17 +133,16 @@ export function isSubjectBannedByState(state, subject) {
  */
 function matchesDenylistIndex(index, subject, groupId = '') {
 	const pk = normalizeHex64(subject?.pubKeyHash)
-	const entity = String(subject?.entityHash || '').trim().toLowerCase()
+	const entity = String(subject?.entityHash || '')
 	const node = normalizeHex64(subject?.nodeHash)
-	const gid = String(groupId || '').trim()
 	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 (!gid) return false
-	if (isHex64(pk) && keys.has(denyKey('subject', gid, pk))) return true
-	if (isHex64(node) && keys.has(denyKey('node', gid, node))) 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
 	return false
 }
 
@@ -164,13 +164,12 @@ export function isPeerKeyBlocked(groupId, peerKey) {
 	const key = normalizeHex64(peerKey)
 	if (!isHex64(key)) return false
 	const index = getDenylistIndex()
-	const gid = String(groupId || '').trim()
 	const { keys } = index
 	if (keys.has(denyKey('subject', '*', key))) return true
 	if (keys.has(denyKey('node', '*', key))) return true
-	if (!gid) return false
-	if (keys.has(denyKey('subject', gid, key))) return true
-	if (keys.has(denyKey('node', gid, key))) return true
+	if (!groupId) return false
+	if (keys.has(denyKey('subject', groupId, key))) return true
+	if (keys.has(denyKey('node', groupId, key))) return true
 	return false
 }
 
@@ -196,21 +195,24 @@ export function isEntityHashBlocked(entityHash) {
  * @returns {Promise<void>}
  */
 export function addDenylistEntry(entry) {
-	const scope = String(entry?.scope || '').trim().toLowerCase()
-	const value = String(entry?.value || '').trim().toLowerCase()
-	if (!scope || !value)
+	const { scope } = entry
+	if (!scope)
 		throw new Error('scope and value required')
 	if (scope === 'entity' && entry.groupId)
 		throw new Error('entity scope does not use groupId')
-	if (scope === 'subject' && !isHex64(normalizeHex64(value)))
+	const normValue = scope === 'node' || scope === 'subject'
+		? normalizeHex64(entry.value)
+		: entry.value
+	if (!normValue)
+		throw new Error('scope and value required')
+	if (scope === 'subject' && !isHex64(normValue))
 		throw new Error('invalid pubKeyHash')
-	if (scope === 'entity' && !isEntityHash128(value))
+	if (scope === 'entity' && !isEntityHash128(normValue))
 		throw new Error('invalid entityHash')
-	if (scope === 'node' && !isHex64(normalizeHex64(value)))
+	if (scope === 'node' && !isHex64(normValue))
 		throw new Error('invalid nodeHash')
 
-	const normValue = scope === 'node' || scope === 'subject' ? normalizeHex64(value) : value
-	const groupId = entry.groupId ? String(entry.groupId).trim() : undefined
+	const groupId = entry.groupId || undefined
 	return mutateDenylist(() => {
 		const list = loadDenylist()
 		if (list.blocked.some(row => row.scope === scope && row.value === normValue && row.groupId === groupId))
@@ -226,8 +228,8 @@ export function addDenylistEntry(entry) {
  * @returns {Promise<void>}
  */
 export async function addDenylistFromBanContent(banContent, groupId) {
-	const scope = String(banContent?.banScope || 'entity').trim().toLowerCase()
-	const sourceGroupId = String(groupId || '').trim()
+	const scope = String(banContent?.banScope || 'entity')
+	const sourceGroupId = groupId || ''
 	if (scope === 'entity' && banContent?.targetEntityHash)
 		await addDenylistEntry({ scope: 'entity', value: banContent.targetEntityHash })
 	if (scope === 'node' && banContent?.targetNodeHash)
@@ -245,10 +247,9 @@ export async function addDenylistFromBanContent(banContent, groupId) {
  * @returns {Promise<void>}
  */
 export function addGroupBlockedPeer(groupId, scope, value) {
-	const normScope = String(scope || '').trim().toLowerCase()
-	if (normScope === 'entity')
-		return addDenylistEntry({ scope: normScope, value })
-	return addDenylistEntry({ scope: normScope, value, groupId })
+	if (scope === 'entity')
+		return addDenylistEntry({ scope, value })
+	return addDenylistEntry({ scope, value, groupId })
 }
 
 /**
@@ -258,14 +259,13 @@ export function addGroupBlockedPeer(groupId, scope, value) {
  * @returns {Promise<void>}
  */
 export function removeGroupBlockedPeer(groupId, scope, value) {
-	const normScope = String(scope || '').trim().toLowerCase()
-	const id = String(value || '').trim().toLowerCase()
-	if (!normScope || !id) return Promise.resolve()
+	const id = scope === 'entity' ? value : normalizeHex64(value)
+	if (!scope || !id) return Promise.resolve()
 	return mutateDenylist(() => {
 		const list = loadDenylist()
 		list.blocked = list.blocked.filter(entry => {
-			if (entry.scope !== normScope || entry.value !== id) return true
-			if (normScope === 'entity') return false
+			if (entry.scope !== scope || entry.value !== id) return true
+			if (scope === 'entity') return false
 			return entry.groupId !== groupId
 		})
 		saveDenylist(list)

package/node/entity_store.mjs

@@ -25,9 +25,9 @@ import { readJsonFile, writeJsonFile } from '../utils/json_io.mjs'
  * @returns {string} 规范化 entityHash
  */
 function normalizeEntityHash(entityHash) {
-	const hash = String(entityHash || '').trim().toLowerCase()
-	if (!parseEntityHash(hash)) throw new Error('invalid entityHash')
-	return hash
+	const parsed = parseEntityHash(entityHash)
+	if (!parsed) throw new Error('invalid entityHash')
+	return parsed.entityHash
 }
 
 /**
@@ -51,7 +51,7 @@ export function createFsEntityStore(baseDir) {
 	 * @returns {string} JSON 文件绝对路径
 	 */
 	function entityJsonPath(entityHash, name) {
-		const safe = String(name || '').trim().replace(/\\/g, '/')
+		const safe = name.replace(/\\/g, '/')
 		if (!safe || safe.includes('..') || safe.startsWith('/')) throw new Error('invalid entity json name')
 		return path.join(entityRoot(entityHash), safe)
 	}
@@ -78,7 +78,7 @@ export function createFsEntityStore(baseDir) {
 		async listEntityHashes() {
 			try {
 				const entries = await fsp.readdir(root, { withFileTypes: true })
-				return entries.filter(e => e.isDirectory()).map(e => e.name.toLowerCase()).filter(h => parseEntityHash(h))
+				return entries.filter(e => e.isDirectory()).map(e => e.name).filter(h => parseEntityHash(h))
 			}
 			catch (error) {
 				if (/** @type {NodeJS.ErrnoException} */ error.code === 'ENOENT') return []

package/node/identity.mjs

@@ -2,14 +2,13 @@ import { Buffer } from 'node:buffer'
 import { randomBytes } from 'node:crypto'
 
 import { entityHashFromRecoveryPubKeyHex, parseEntityHash } from '../core/entity_id.mjs'
-import { isHex64 } from '../core/hexIds.mjs'
+import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
 import { keyPairFromSeed, pubKeyHash } from '../crypto/crypto.mjs'
 import { normalizeMailboxSettings } from '../mailbox/settings.mjs'
 
 import { emitNodeChange } from './instance.mjs'
 import { readNodeJsonSync, writeNodeJsonSync } from './storage.mjs'
 
-const NODE_SEED_HEX_RE = /^[\da-f]{64}$/iu
 const NODE_JSON = 'node'
 
 /**
@@ -18,7 +17,7 @@ const NODE_JSON = 'node'
  * @returns {string} 节点哈希
  */
 export function nodeHashFromSeed(seedHex) {
-	const seed = Buffer.from(String(seedHex).trim(), 'hex')
+	const seed = Buffer.from(normalizeHex64(seedHex), 'hex')
 	if (seed.length !== 32) throw new Error('invalid node seed')
 	const { publicKey } = keyPairFromSeed(seed)
 	return pubKeyHash(publicKey)
@@ -47,8 +46,8 @@ function saveNodeFile(patch) {
  */
 export function ensureNodeSeed() {
 	const data = loadNodeFile()
-	const existing = String(data.nodeSeedHex || '').trim().toLowerCase()
-	if (NODE_SEED_HEX_RE.test(existing)) return existing
+	const existing = normalizeHex64(data.nodeSeedHex)
+	if (isHex64(existing)) return existing
 	const nodeSeedHex = randomBytes(32).toString('hex')
 	saveNodeFile({ nodeSeedHex })
 	return nodeSeedHex
@@ -67,7 +66,7 @@ export function getNodeHash() {
 export function getNodeTransportSettings() {
 	const data = loadNodeFile()
 	const relayUrls = (data.relayUrls || [])
-		.map(url => url.trim())
+		.map(url => String(url || ''))
 		.filter(url => url.startsWith('wss://'))
 	const batterySaver = !!data.batterySaver
 	const mailbox = normalizeMailboxSettings(data.mailbox || {})
@@ -82,7 +81,7 @@ export function saveNodeTransportSettings(patch) {
 	const data = loadNodeFile()
 	if (patch.batterySaver != null) data.batterySaver = !!patch.batterySaver
 	if (patch.relayUrls)
-		data.relayUrls = patch.relayUrls.map(url => url.trim()).filter(url => url.startsWith('wss://'))
+		data.relayUrls = patch.relayUrls.map(url => String(url || '')).filter(url => url.startsWith('wss://'))
 	if (patch.mailbox)
 		data.mailbox = normalizeMailboxSettings({ ...data.mailbox, ...patch.mailbox })
 	saveNodeFile(data)
@@ -106,7 +105,7 @@ export function ensureNodeDefaults() {
  * @returns {string | null} entityHash（非法 hex 时 null）
  */
 export function entityHashFromKeys(nodeHash, recoveryPubKeyHex) {
-	const pub = String(recoveryPubKeyHex || '').trim().toLowerCase().replace(/^0x/iu, '')
+	const pub = normalizeHex64(recoveryPubKeyHex)
 	if (!isHex64(nodeHash) || !isHex64(pub)) return null
 	return entityHashFromRecoveryPubKeyHex(nodeHash, pub)
 }

package/node/instance.mjs

@@ -40,7 +40,7 @@ export function initNode(options) {
 	if (runtime) throw new Error('p2p: initNode already called — use setNodeLogger / setSignalingRuntimeConfig or resetNodeForTests')
 	if (options?.logger !== undefined || options?.signaling !== undefined)
 		throw new Error('p2p: initNode only accepts nodeDir/entityStore — use setNodeLogger / setSignalingRuntimeConfig')
-	const nodeDir = path.resolve(String(options.nodeDir || '').trim())
+	const nodeDir = path.resolve(options.nodeDir)
 	if (!nodeDir) throw new Error('p2p: initNode requires nodeDir')
 	const entityStore = options.entityStore ?? createFsEntityStore(path.join(nodeDir, 'entities'))
 	runtime = {

package/node/log.mjs

@@ -29,7 +29,7 @@ export function isConnectivityDebug() {
  * @returns {string} 短 hash
  */
 export function shortHash(hash, n = 8) {
-	const value = String(hash || '')
+	const value = hash || ''
 	return value.length <= n ? value : value.slice(0, n)
 }
 

package/node/network.mjs

@@ -54,17 +54,17 @@ export function normalizeNetwork(raw) {
 	 */
 	const pickIds = key => [...new Set(
 		(file[key] || [])
-			.map(id => normalizeHex64(id) || id.trim())
+			.map(id => normalizeHex64(id))
 			.filter(id => isHex64(id)),
 	)]
 	const hints = (file.hints || [])
 		.map(hint => ({
 			nodeHash: normalizeHex64(hint.nodeHash) || '',
-			source: hint.source?.trim() || '',
-			kind: hint.kind?.trim() || '',
+			source: String(hint.source || ''),
+			kind: String(hint.kind || ''),
 			weight: Number.isFinite(Number(hint.weight)) ? Number(hint.weight) : 0.1,
 			expiresAt: Number(hint.expiresAt) || 0,
-			...hint.groupId ? { groupId: hint.groupId.trim() } : {},
+			...hint.groupId ? { groupId: String(hint.groupId) } : {},
 		}))
 		.filter(hint => isHex64(hint.nodeHash))
 	return {
@@ -98,7 +98,7 @@ export function capHintsBySource(hints, maxPerSource = MAX_HINTS_PER_SOURCE) {
 	const counts = new Map()
 	const out = []
 	for (const hint of [...hints].reverse()) {
-		const source = String(hint.source || 'unknown')
+		const source = hint.source || 'unknown'
 		const n = counts.get(source) ?? 0
 		if (n >= maxPerSource) continue
 		counts.set(source, n + 1)
@@ -134,8 +134,8 @@ export function applyNetworkHint(hint) {
 	const now = Date.now()
 	const ttlMs = Number.isFinite(hint.ttlMs) ? hint.ttlMs : DEFAULT_EXPLORE_TTL_MS
 	const expiresAt = Number.isFinite(hint.expiresAt) ? hint.expiresAt : now + ttlMs
-	const source = String(hint.source || 'unknown')
-	const priorSources = new Set(net.hints.filter(h => h.nodeHash === nodeHash).map(h => String(h.source || 'unknown')))
+	const source = hint.source || 'unknown'
+	const priorSources = new Set(net.hints.filter(h => h.nodeHash === nodeHash).map(h => h.source || 'unknown'))
 	priorSources.add(source)
 	const multiSourceBoost = priorSources.size >= 2 ? 1.2 : 1
 	const baseWeight = Number.isFinite(hint.weight) ? hint.weight : 0.1
@@ -145,10 +145,10 @@ export function applyNetworkHint(hint) {
 	net.hints.push({
 		nodeHash,
 		source,
-		kind: String(hint.kind || 'hint'),
+		kind: hint.kind || 'hint',
 		weight: baseWeight * multiSourceBoost,
 		expiresAt,
-		...hint.groupId ? { groupId: String(hint.groupId).trim() } : {},
+		...hint.groupId ? { groupId: hint.groupId } : {},
 	})
 	saveNetwork(net)
 }
@@ -234,11 +234,10 @@ export function replaceNetworkPeerPools(pools = {}) {
  * @returns {string[]} 规范化 value 列表
  */
 function denyValuesForScope(groupId, scope) {
-	const gid = String(groupId || '').trim()
 	return [...new Set(
 		loadDenylist().blocked
 			.filter(entry => entry.scope === scope)
-			.filter(entry => scope === 'entity' || !entry.groupId || !gid || entry.groupId === gid)
+			.filter(entry => scope === 'entity' || !entry.groupId || !groupId || entry.groupId === groupId)
 			.map(entry => entry.value),
 	)]
 }
@@ -278,10 +277,9 @@ export function loadPeerPoolView(groupId = '') {
  * @returns {boolean} 是否命中 denylist（按 scope 匹配）
  */
 export function isPeerPoolKeyBlocked(view, key) {
-	const normalized = String(key || '').trim().toLowerCase()
-	if (!normalized) return false
-	if (view.deniedNodes.includes(normalized)) return true
-	if (view.deniedSubjects.includes(normalized)) return true
-	if (isEntityHash128(normalized) && view.deniedEntities.includes(normalized)) return true
+	if (!key) return false
+	if (view.deniedNodes.includes(key)) return true
+	if (view.deniedSubjects.includes(key)) return true
+	if (isEntityHash128(key) && view.deniedEntities.includes(key)) return true
 	return false
 }

package/node/personal_block.mjs

@@ -38,12 +38,17 @@ export function normalizePersonalListEntries(raw) {
 	/** @type {Map<string, { scope: PersonalListScope, value: string }>} */
 	const byKey = new Map()
 	for (const entry of raw || []) {
-		const scope = String(entry?.scope || '').trim().toLowerCase()
-		const value = String(entry?.value || '').trim().toLowerCase()
-		if (scope === 'entity' && parseEntityHash(value))
-			byKey.set(`entity:${value}`, { scope: 'entity', value })
-		else if (scope === 'subject' && isHex64(normalizeHex64(value)))
-			byKey.set(`subject:${normalizeHex64(value)}`, { scope: 'subject', value: normalizeHex64(value) })
+		const scope = String(entry?.scope || '')
+		if (scope === 'entity') {
+			const parsed = parseEntityHash(entry?.value)
+			if (parsed)
+				byKey.set(`entity:${parsed.entityHash}`, { scope: 'entity', value: parsed.entityHash })
+		}
+		else if (scope === 'subject') {
+			const value = normalizeHex64(entry?.value)
+			if (isHex64(value))
+				byKey.set(`subject:${value}`, { scope: 'subject', value })
+		}
 	}
 	return [...byKey.values()]
 }
@@ -58,7 +63,7 @@ export function normalizePersonalListEntries(raw) {
  * @returns {boolean} 是否命中列表
  */
 export function matchesPersonalListEntries(entries, subject) {
-	const entity = String(subject?.entityHash || '').trim().toLowerCase()
+	const entity = subject?.entityHash || ''
 	const pk = normalizeHex64(subject?.pubKeyHash || subject?.subjectHash || '')
 	if (entity) {
 		for (const entry of entries)
@@ -112,11 +117,10 @@ export async function loadPersonalBlockEntries(viewerEntityHash) {
  */
 export async function setPersonalHidden(viewerEntityHash, targetEntityHash, hide) {
 	if (!isWritableLocalEntity(viewerEntityHash)) throw new Error('entity not writable on this replica')
-	const target = String(targetEntityHash || '').trim().toLowerCase()
-	if (!parseEntityHash(target)) throw new Error('invalid targetEntityHash')
+	if (!parseEntityHash(targetEntityHash)) throw new Error('invalid targetEntityHash')
 	const store = getEntityStore()
 	const current = normalizePersonalListEntries((await store.readEntityJson(viewerEntityHash, HIDE_JSON))?.hidden || [])
-	const addEntries = entriesForTargetEntityHash(target)
+	const addEntries = entriesForTargetEntityHash(targetEntityHash)
 	const addKeys = new Set(addEntries.map(e => `${e.scope}:${e.value}`))
 	const next = hide
 		? normalizePersonalListEntries([...current, ...addEntries])
@@ -133,11 +137,10 @@ export async function setPersonalHidden(viewerEntityHash, targetEntityHash, hide
  */
 export async function setPersonalMuted(viewerEntityHash, targetEntityHash, mute) {
 	if (!isWritableLocalEntity(viewerEntityHash)) throw new Error('entity not writable on this replica')
-	const target = String(targetEntityHash || '').trim().toLowerCase()
-	if (!parseEntityHash(target)) throw new Error('invalid targetEntityHash')
+	if (!parseEntityHash(targetEntityHash)) throw new Error('invalid targetEntityHash')
 	const store = getEntityStore()
 	const current = normalizePersonalListEntries((await store.readEntityJson(viewerEntityHash, MUTE_JSON))?.muted || [])
-	const addEntries = entriesForTargetEntityHash(target)
+	const addEntries = entriesForTargetEntityHash(targetEntityHash)
 	const addKeys = new Set(addEntries.map(e => `${e.scope}:${e.value}`))
 	const next = mute
 		? normalizePersonalListEntries([...current, ...addEntries])
@@ -193,9 +196,9 @@ export function filterSetsFromPersonalListEntries(entries) {
 	/** @type {Set<string>} */
 	const mutedSubjects = new Set()
 	for (const entry of entries || []) {
-		const kind = String(entry?.kind || '').trim().toLowerCase()
-		const scope = String(entry?.scope || '').trim().toLowerCase()
-		const value = String(entry?.value || '').trim().toLowerCase()
+		const kind = String(entry?.kind || '')
+		const scope = String(entry?.scope || '')
+		const value = String(entry?.value || '')
 		if (!value || (scope !== 'entity' && scope !== 'subject')) continue
 		if (kind === 'block')
 			if (scope === 'entity') blockedEntityHashes.add(value)
@@ -237,11 +240,10 @@ export async function loadPersonalFilterSets(viewerEntityHash) {
  * @returns {boolean} 是否应过滤
  */
 export function isAuthorFilteredByPersonalSets(filterSets, authorEntityHash) {
-	const entity = String(authorEntityHash || '').trim().toLowerCase()
-	if (!entity) return false
-	if (filterSets.blockedEntityHashes.has(entity) || filterSets.hiddenEntityHashes.has(entity) || filterSets.mutedEntityHashes?.has(entity))
+	if (!authorEntityHash) return false
+	if (filterSets.blockedEntityHashes.has(authorEntityHash) || filterSets.hiddenEntityHashes.has(authorEntityHash) || filterSets.mutedEntityHashes?.has(authorEntityHash))
 		return true
-	const parsed = parseEntityHash(entity)
+	const parsed = parseEntityHash(authorEntityHash)
 	if (!parsed) return false
 	if (filterSets.blockedSubjects.has(parsed.subjectHash)
 		|| filterSets.hiddenSubjects.has(parsed.subjectHash)

package/node/reputation_store.mjs

@@ -120,7 +120,7 @@ export function recordGossipAllUnknownWant(groupId, peerNodeHash) {
  * @returns {Promise<void>}
  */
 export function recordMessageRateViolation(peerNodeHash, excessRatio = 1) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(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 = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(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 = String(storagePeerKey || '').trim()
+	const id = normalizeHex64(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 = String(blamePeerKey || '').trim()
+	const id = normalizeHex64(blamePeerKey)
 	if (!id) return
 	void mutateReputation(data => {
 		penalizeChunkStorageFailurePure(data, id)
@@ -173,24 +173,16 @@ export function penalizeChunkStorageFailure(blamePeerKey) {
  * @returns {void}
  */
 export function penalizeArchiveServeMismatch(peerNodeHash) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	if (!id) return
 	void mutateReputation(data => {
 		penalizeArchiveServeMismatchPure(data, id)
 	})
 }
 
-/**
- * @param {object | null | undefined} groupSettings 群设置
- * @returns {number} 毫秒
- */
-export function resolveSlashAlertTtlMs(groupSettings) {
-	return resolveSlashAlertTtlMsPure(groupSettings)
-}
-
 /**
  * @param {object} alert VOLATILE slash 载荷
- * @returns {boolean} 是否已应用
+ * @returns {Promise<boolean>} 是否已应用
  */
 export async function applyVolatileSlashAlert(alert) {
 	const expiresAt = Number(alert?.expiresAt)
@@ -215,7 +207,7 @@ export function buildUnverifiedSlashAlert(senderPubKeyHash, content, groupSettin
 	const targetPubKeyHash = assertHex64(content.targetPubKeyHash, 'slash target')
 	const claim = Number.isFinite(Number(content.claim)) ? Number(content.claim) : reputationTunables.slashDefaultClaim
 	const sender = assertHex64(senderPubKeyHash, 'slash sender')
-	const ttl = resolveSlashAlertTtlMs(groupSettings)
+	const ttl = resolveSlashAlertTtlMsPure(groupSettings)
 	return {
 		type: 'reputation_slash_alert',
 		targetPubKeyHash,
@@ -235,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 = content.targetPubKeyHash.trim().toLowerCase()
-	const sender = event.sender.trim().toLowerCase()
+	const target = normalizeHex64(content.targetPubKeyHash)
+	const sender = normalizeHex64(event.sender)
 
 	await mutateReputation(async data => {
 		const verified = content.verified && await verifySlashProof(username, groupId, content, readEvents)
@@ -253,7 +245,7 @@ export async function applySubjectiveSlashFromEvent(username, groupId, event, re
  * @returns {Promise<boolean>} 是否找到 proof 对应事件
  */
 async function verifySlashProof(username, groupId, content, readEvents) {
-	const eventId = content?.proof?.eventId?.trim().toLowerCase()
+	const eventId = normalizeHex64(content?.proof?.eventId)
 	if (!eventId) return false
 	const events = await readEvents(username, groupId)
 	return events.some(event => event.id === eventId)
@@ -269,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: targetPubKeyHash.trim().toLowerCase(),
+				target: normalizeHex64(targetPubKeyHash),
 				upstreamCount: applied.length,
 				hops: applied.map(row => row.hop),
 			})

package/node/reputation_sync.mjs

@@ -85,13 +85,6 @@ function persistSyncConfig() {
 	writeNodeJsonSync(SYNC_DATA_NAME, loadSyncConfig())
 }
 
-/**
- * @returns {object} 当前 reputation 表（byNodeHash）
- */
-export function getReputationTable() {
-	return loadReputation()
-}
-
 /**
  * @param {object} table - 含 byNodeHash 的信誉表或裸 byNodeHash 对象
  * @returns {void}

package/node/signaling_config.mjs

@@ -41,7 +41,7 @@ export function resolveSignalingRuntimeConfig(patch = {}) {
 		relayOverride = patch.relayOverride == null
 			? null
 			: [...new Set((Array.isArray(patch.relayOverride) ? patch.relayOverride : [])
-				.map(url => String(url || '').trim())
+				.map(url => String(url || ''))
 				.filter(url => url.startsWith('wss://')))]
 	return {
 		relayOverride,

package/node/storage_plugins.mjs

@@ -47,7 +47,7 @@ export function createLocalStoragePlugin(baseDir) {
 		 * @returns {Promise<Uint8Array>} 文件内容
 		 */
 		async getChunk(locator) {
-			const localLocatorMatch = String(locator).match(/^local:([^/]+)\/chunks\/(.+)$/)
+			const localLocatorMatch = locator.match(/^local:([^/]+)\/chunks\/(.+)$/)
 			if (!localLocatorMatch) throw new Error('Invalid local locator')
 			const chunkPath = join(baseDir, 'groups', localLocatorMatch[1], 'chunks', localLocatorMatch[2])
 			return new Uint8Array(await readFile(chunkPath))
@@ -57,7 +57,7 @@ export function createLocalStoragePlugin(baseDir) {
 		 * @returns {Promise<void>}
 		 */
 		async deleteChunk(locator) {
-			const localLocatorMatch = String(locator).match(/^local:([^/]+)\/chunks\/(.+)$/)
+			const localLocatorMatch = locator.match(/^local:([^/]+)\/chunks\/(.+)$/)
 			if (!localLocatorMatch) return
 			const chunkPath = join(baseDir, 'groups', localLocatorMatch[1], 'chunks', localLocatorMatch[2])
 			try {