@steve02081504/fount-p2p 0.0.22 → 0.0.24

package/files/{manifest_fetch.mjs → manifest/fetch.mjs}

@@ -1,20 +1,19 @@
-import { randomUUID } from 'node:crypto'
+import { parseEntityHash } from '../../core/entity_id.mjs'
+import { assertSafeEvfsLogicalPath } from '../../core/evfs_logical_path.mjs'
+import { isWritableLocalEntity } from '../../node/identity.mjs'
+import { getEntityStore } from '../../node/instance.mjs'
+import { ms } from '../../utils/duration.mjs'
+import { createInflightTable } from '../../utils/inflight_table.mjs'
+import { loadFileManifest, saveFileManifest } from '../evfs.mjs'
+import { beginFedFanoutFetch } from '../fed/fetch_shared.mjs'
 
+import { normalizeFileManifest } from './normalize.mjs'
 import {
 	manifestFetchExpectedKey,
 	MAX_PENDING_MANIFEST_FETCHES,
 	registerManifestFetchWait,
-} from '../federation/manifest_fetch_pending.mjs'
-import { isWritableLocalEntity } from '../node/identity.mjs'
-import { getEntityStore } from '../node/instance.mjs'
-import { ms } from '../utils/duration.mjs'
-import { createInflightTable } from '../utils/inflight_table.mjs'
-
-import { resolveNodeHash } from './chunk_provider_registry.mjs'
-import { loadFileManifest, saveFileManifest } from './evfs.mjs'
-import { fanoutFedFetch } from './fetch_fanout.mjs'
-import { normalizeFileManifest } from './manifest.mjs'
-import { shouldPreferIncomingPublicManifest } from './public_manifest.mjs'
+} from './pending.mjs'
+import { shouldPreferIncomingPublicManifest } from './public.mjs'
 
 const DEFAULT_MANIFEST_FETCH_TIMEOUT_MS = ms('8s')
 
@@ -29,7 +28,7 @@ const manifestInflight = createInflightTable({
  * 本地已有 publicSig 时立即返回，并后台 fanout；`cache: true` 时按 publishedAt 择新写盘。
  * 冷 miss 仍等 fanout。同 key in-flight 去重；调用方外层超时不 abort，后台继续填缓存。
  * @param {{ username: string, ownerEntityHash: string, logicalPath: string, cache?: boolean, timeoutMs?: number }} context - 拉取上下文
- * @returns {Promise<import('./manifest.mjs').FileManifest | null>} 验签后的 manifest，失败为 null
+ * @returns {Promise<import('./normalize.mjs').FileManifest | null>} 验签后的 manifest，失败为 null
  */
 export async function fetchPublicManifest(context) {
 	const ownerEntityHash = String(context.ownerEntityHash || '').trim().toLowerCase()
@@ -41,27 +40,31 @@ export async function fetchPublicManifest(context) {
 		? Number(context.timeoutMs)
 		: DEFAULT_MANIFEST_FETCH_TIMEOUT_MS
 	const expectedKey = manifestFetchExpectedKey(ownerEntityHash, logicalPath)
-	const inflightKey = `${username}\0${expectedKey}`
 	const wantCache = context.cache === true
 
 	// 先挂 in-flight（同步），再读本地 — 避免并发调用在 await 间隙各自 start
 	const localPromise = loadFileManifest(ownerEntityHash, logicalPath)
-	const shared = manifestInflight.acquire(inflightKey, () => {
-		const requestId = randomUUID()
-		const wait = registerManifestFetchWait(requestId, expectedKey, timeoutMs)
-		void (async () => {
-			try {
-				const { nodeHash } = await resolveNodeHash(username)
-				await fanoutFedFetch(username, 'fed_manifest_get', {
-					requestId,
-					nodeHash,
-					ownerEntityHash,
-					logicalPath,
-				})
-			}
-			catch { /* pending wait 超时/cancel 负责 settle */ }
-		})()
-		return { done: wait.done, cancel: wait.cancel }
+	const shared = beginFedFanoutFetch({
+		inflight: manifestInflight,
+		inflightKey: `${username}\0${expectedKey}`,
+		username,
+		action: 'fed_manifest_get',
+		/**
+		 * @param {string} requestId 请求 id
+		 * @returns {{ done: Promise<import('./normalize.mjs').FileManifest | null>, cancel: () => void }} 等待句柄
+		 */
+		registerWait: requestId => registerManifestFetchWait(requestId, expectedKey, timeoutMs),
+		/**
+		 * @param {string} requestId 请求 id
+		 * @param {string} nodeHash 目标节点 hash
+		 * @returns {object} fanout 载荷
+		 */
+		buildPayload: (requestId, nodeHash) => ({
+			requestId,
+			nodeHash,
+			ownerEntityHash,
+			logicalPath,
+		}),
 	})
 
 	const local = await localPromise
@@ -69,13 +72,12 @@ export async function fetchPublicManifest(context) {
 	if (!shared) return hasLocalPublic ? local : null
 
 	if (hasLocalPublic) {
-		// SWR：立刻回本地；后台 fanout 择新写盘（需 cache: true）
-		if (wantCache) {
+		if (wantCache) 
 			void shared.then(async result => {
 				if (result && shouldPreferIncomingPublicManifest(local, result))
 					await cachePublicManifest(ownerEntityHash, logicalPath, result)
 			})
-		}
+		
 		return local
 	}
 
@@ -89,41 +91,34 @@ export async function fetchPublicManifest(context) {
  * 将已验签公开 manifest 写入本地缓存（显式 apply；`fetchPublicManifest` 默认不调用）。
  * @param {string} ownerEntityHash owner
  * @param {string} logicalPath 路径
- * @param {import('./manifest.mjs').FileManifest} incoming 已验签入站清单
+ * @param {import('./normalize.mjs').FileManifest} incoming 已验签入站清单
  * @returns {Promise<void>}
  */
 export async function cachePublicManifest(ownerEntityHash, logicalPath, incoming) {
-	await maybeCacheIncomingPublicManifest(ownerEntityHash, logicalPath, incoming)
-}
-
-/**
- * @param {string} ownerEntityHash owner
- * @param {string} logicalPath 路径
- * @param {import('./manifest.mjs').FileManifest} incoming 已验签入站清单
- * @returns {Promise<void>}
- */
-async function maybeCacheIncomingPublicManifest(ownerEntityHash, logicalPath, incoming) {
 	if (isWritableLocalEntity(ownerEntityHash)) return
-	const store = getEntityStore()
-	const existing = await store.readManifest(ownerEntityHash, logicalPath)
+	const existing = await getEntityStore().readManifest(ownerEntityHash, logicalPath)
 	if (existing && !shouldPreferIncomingPublicManifest(existing, incoming)) return
 	await saveFileManifest(incoming)
 }
 
 /**
  * 若本机有已签名公开 manifest 则响应 fed_manifest_get。
- * @param {string} username 用户
  * @param {object} payload 请求
  * @param {(response: object, peerId: string) => void} sendResponse 发送
  * @param {string} peerId 对端
  * @returns {Promise<void>}
  */
-export async function handleIncomingManifestGet(username, payload, sendResponse, peerId) {
-	void username
-	const ownerEntityHash = String(payload?.ownerEntityHash || '').trim().toLowerCase()
-	const logicalPath = String(payload?.logicalPath || '').trim().replace(/^\/+/, '')
+export async function handleIncomingManifestGet(payload, sendResponse, peerId) {
+	const parsedOwner = parseEntityHash(payload?.ownerEntityHash)
+	if (!parsedOwner) return
+	let logicalPath
+	try {
+		logicalPath = assertSafeEvfsLogicalPath(payload?.logicalPath)
+	}
+	catch { return }
 	const requestId = String(payload?.requestId || '')
-	if (!ownerEntityHash || !logicalPath || !requestId) return
+	if (!requestId) return
+	const { entityHash: ownerEntityHash } = parsedOwner
 
 	const raw = await getEntityStore().readManifest(ownerEntityHash, logicalPath)
 	const manifest = normalizeFileManifest(raw)

package/files/{manifest.mjs → manifest/normalize.mjs}

@@ -1,5 +1,5 @@
-import { isEntityHash128 } from '../core/entity_id.mjs'
-import { isHex64 } from '../core/hexIds.mjs'
+import { isEntityHash128 } from '../../core/entity_id.mjs'
+import { isHex64 } from '../../core/hexIds.mjs'
 
 /** @typedef {'plain' | 'convergent' | 'random'} CeMode */
 

package/files/manifest/pending.mjs

@@ -0,0 +1,53 @@
+import { compositeKey } from '../../core/composite_key.mjs'
+import { createFetchWaitTable } from '../../utils/fetch_wait.mjs'
+
+import { verifySignedPublicManifest } from './public.mjs'
+
+/** 并发 pending manifest fetch 上限。 */
+export const MAX_PENDING_MANIFEST_FETCHES = 512
+
+const table = createFetchWaitTable({ maxSize: MAX_PENDING_MANIFEST_FETCHES })
+
+/** @type {typeof table.pending} */
+export const pendingManifestFetches = table.pending
+
+/**
+ * @param {string} ownerEntityHash owner
+ * @param {string} logicalPath 路径
+ * @returns {string} 期望键
+ */
+export function manifestFetchExpectedKey(ownerEntityHash, logicalPath) {
+	return compositeKey(
+		String(ownerEntityHash || '').trim().toLowerCase(),
+		String(logicalPath || '').trim().replace(/^\/+/, ''),
+	)
+}
+
+/**
+ * @param {string} key requestId
+ * @param {string} expectedKey owner+path 复合键
+ * @param {number} timeoutMs 超时毫秒
+ * @returns {{ done: Promise<object | null>, cancel: () => void }} 等待 Promise 与取消
+ */
+export function registerManifestFetchWait(key, expectedKey, timeoutMs) {
+	return table.register(key, expectedKey, timeoutMs)
+}
+
+/**
+ * 处理 fed_manifest_data：验签通过后 resolve pending。
+ * @param {object} payload 入站载荷
+ * @returns {Promise<boolean>} 是否命中并完成等待
+ */
+export async function resolvePendingManifestFetch(payload) {
+	const requestId = String(payload?.requestId || '')
+	if (!requestId) return false
+	const entry = table.peek(requestId)
+	if (!entry) return false
+
+	const verified = await verifySignedPublicManifest(payload?.manifest)
+	if (!verified) return false
+	const key = manifestFetchExpectedKey(verified.ownerEntityHash, verified.logicalPath)
+	if (key !== entry.expectedKey) return false
+
+	return table.settle(requestId, verified)
+}

package/files/{public_manifest.mjs → manifest/public.mjs}

@@ -1,13 +1,13 @@
 import { Buffer } from 'node:buffer'
 
-import { canonicalStringify } from '../core/canonical_json.mjs'
-import { hashFromPubKeyHex, parseEntityHash } from '../core/entity_id.mjs'
-import { assertSafeEvfsLogicalPath } from '../core/evfs_logical_path.mjs'
-import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
-import { sign, verify } from '../crypto/crypto.mjs'
+import { canonicalStringify } from '../../core/canonical_json.mjs'
+import { hashFromPubKeyHex, parseEntityHash } from '../../core/entity_id.mjs'
+import { assertSafeEvfsLogicalPath } from '../../core/evfs_logical_path.mjs'
+import { isHex64, normalizeHex64 } from '../../core/hexIds.mjs'
+import { sign, verify } from '../../crypto/crypto.mjs'
+import { putFileManifest, saveFileManifest } from '../evfs.mjs'
 
-import { putFileManifest, saveFileManifest } from './evfs.mjs'
-import { normalizeFileManifest, publicTransferKeyDescriptor } from './manifest.mjs'
+import { normalizeFileManifest, publicTransferKeyDescriptor } from './normalize.mjs'
 
 /** 实体公开 manifest 签名域 */
 export const ENTITY_PUBLIC_MANIFEST_DOMAIN = 'fount-entity-public-manifest'
@@ -32,11 +32,11 @@ export function publicManifestSignBytes(fields) {
 }
 
 /**
- * @param {import('./manifest.mjs').FileManifest} manifest 清单
+ * @param {import('./normalize.mjs').FileManifest} manifest 清单
  * @param {number} publishedAt 发布时间
  * @param {Uint8Array | Buffer} entitySecretKey recovery 私钥种子
  * @param {string} entityPubKeyHex recovery 公钥 hex
- * @returns {Promise<import('./manifest.mjs').FileManifest>} 带 publicSig 的清单
+ * @returns {Promise<import('./normalize.mjs').FileManifest>} 带 publicSig 的清单
  */
 export async function attachPublicManifestSig(manifest, publishedAt, entitySecretKey, entityPubKeyHex) {
 	const pubKeyHex = normalizeHex64(entityPubKeyHex)
@@ -63,7 +63,7 @@ export async function attachPublicManifestSig(manifest, publishedAt, entitySecre
 
 /**
  * @param {unknown} input 原始 manifest
- * @returns {Promise<import('./manifest.mjs').FileManifest | null>} 验签通过的清单；非法为 null
+ * @returns {Promise<import('./normalize.mjs').FileManifest | null>} 验签通过的清单；非法为 null
  */
 export async function verifySignedPublicManifest(input) {
 	const manifest = normalizeFileManifest(input)
@@ -105,7 +105,7 @@ export async function verifySignedPublicManifest(input) {
 
 /**
  * @param {object | null | undefined} localManifest 本地已有清单
- * @param {import('./manifest.mjs').FileManifest} incoming 入站已验签清单
+ * @param {import('./normalize.mjs').FileManifest} incoming 入站已验签清单
  * @returns {boolean} 是否应以 incoming 覆盖本地缓存
  */
 export function shouldPreferIncomingPublicManifest(localManifest, incoming) {
@@ -125,7 +125,7 @@ export function shouldPreferIncomingPublicManifest(localManifest, incoming) {
  * @param {Uint8Array | Buffer} parameters.entitySecretKey recovery 私钥种子
  * @param {string} parameters.entityPubKeyHex recovery 公钥 hex
  * @param {number} [parameters.publishedAt] 发布时间（默认 Date.now）
- * @returns {Promise<import('./manifest.mjs').FileManifest>} 已签名并落盘的公开清单
+ * @returns {Promise<import('./normalize.mjs').FileManifest>} 已签名并落盘的公开清单
  */
 export async function publishPublicFile(parameters) {
 	const {

package/files/transfer_key.mjs

@@ -8,8 +8,8 @@ import {
 } from '../crypto/key.mjs'
 
 /**
- * @typedef {import('./manifest.mjs').FileManifest} FileManifest
- * @typedef {import('./manifest.mjs').TransferKeyDescriptor} TransferKeyDescriptor
+ * @typedef {import('./manifest/normalize.mjs').FileManifest} FileManifest
+ * @typedef {import('./manifest/normalize.mjs').TransferKeyDescriptor} TransferKeyDescriptor
  */
 
 /**

package/files/transfer_key_registry.mjs

@@ -1,7 +1,7 @@
 /** @type {Map<string, { getGroupFileMasterKey?: (replicaUsername: string, groupId: string, keyGeneration?: number) => Promise<Buffer | string | null>, getVaultMasterKey?: (replicaUsername: string, entityHash: string) => Promise<Buffer | string | null> }>} */
 const transferDependenciesByOwner = new Map()
 
-/** @type {Map<string, (replicaUsername: string, manifest: import('./manifest.mjs').FileManifest) => Promise<Buffer | null>>} */
+/** @type {Map<string, (replicaUsername: string, manifest: import('./manifest/normalize.mjs').FileManifest) => Promise<Buffer | null>>} */
 const dagPlaintextReadersByOwner = new Map()
 
 /**
@@ -17,19 +17,19 @@ export function registerTransferKeyDependencies(ownerId, dependencies) {
 
 /**
  * @param {string} ownerId 注册方
- * @param {(replicaUsername: string, manifest: import('./manifest.mjs').FileManifest) => Promise<Buffer | null>} reader dagParts 明文读取
+ * @param {(replicaUsername: string, manifest: import('./manifest/normalize.mjs').FileManifest) => Promise<Buffer | null>} reader dagParts 明文读取
  * @returns {void}
  */
 export function registerDagManifestPlaintextReader(ownerId, reader) {
 	dagPlaintextReadersByOwner.set(String(ownerId), reader)
 }
 
-/** @type {Array<{ ownerId: string, match: (manifest: import('./manifest.mjs').FileManifest) => boolean }>} */
+/** @type {Array<{ ownerId: string, match: (manifest: import('./manifest/normalize.mjs').FileManifest) => boolean }>} */
 const manifestOwnerMatchers = []
 
 /**
  * @param {string} ownerId 注册方
- * @param {(manifest: import('./manifest.mjs').FileManifest) => boolean} match manifest 匹配谓词
+ * @param {(manifest: import('./manifest/normalize.mjs').FileManifest) => boolean} match manifest 匹配谓词
  * @returns {void}
  */
 export function registerManifestOwnerMatcher(ownerId, match) {
@@ -59,7 +59,7 @@ export function unregisterTransferKeyDependencies(ownerId) {
 
 /**
  * 从 manifest 推断 transfer key 注册方 id（按 registerManifestOwnerMatcher 注册顺序匹配）。
- * @param {import('./manifest.mjs').FileManifest} manifest 清单
+ * @param {import('./manifest/normalize.mjs').FileManifest} manifest 清单
  * @returns {string | null} 所有者 id
  */
 export function resolveManifestTransferOwnerId(manifest) {
@@ -70,7 +70,7 @@ export function resolveManifestTransferOwnerId(manifest) {
 
 /**
  * @param {string} [ownerId] 显式注册方；省略时按 manifest 推断
- * @param {import('./manifest.mjs').FileManifest} [manifest] 用于推断 ownerId
+ * @param {import('./manifest/normalize.mjs').FileManifest} [manifest] 用于推断 ownerId
  * @returns {{ getGroupFileMasterKey?: (replicaUsername: string, groupId: string, keyGeneration?: number) => Promise<Buffer | string | null>, getVaultMasterKey?: (replicaUsername: string, entityHash: string) => Promise<Buffer | string | null> }} 依赖
  */
 export function resolveTransferKeyDependencies(ownerId, manifest) {
@@ -81,7 +81,7 @@ export function resolveTransferKeyDependencies(ownerId, manifest) {
 
 /**
  * @param {string} replicaUsername 副本用户名
- * @param {import('./manifest.mjs').FileManifest} manifest 清单
+ * @param {import('./manifest/normalize.mjs').FileManifest} manifest 清单
  * @returns {Promise<Buffer | null>} 明文；无 reader 或未命中为 null
  */
 export async function readDagManifestPlaintext(replicaUsername, manifest) {

package/index.mjs

@@ -32,7 +32,6 @@ import {
 	unlockReputationMax,
 } from './node/reputation_sync.mjs'
 import { getRoutingProfile, setRoutingProfile } from './node/routing_profile.mjs'
-import { createScopedLinkRoom } from './rooms/scoped_link.mjs'
 import { createGroupLinkSet } from './transport/group_link_set.mjs'
 import {
 	configureLinkRegistry,
@@ -42,9 +41,10 @@ import {
 	reloadDiscoveryRelays,
 	sendToNodeLink,
 } from './transport/link_registry.mjs'
+import { attachNodeScopeDefaultFeatures } from './transport/node_scope/features.mjs'
+import { ensureNodeScope } from './transport/node_scope/wire.mjs'
+import { createScopedLinkRoom } from './transport/scoped_link.mjs'
 import {
-	attachUserRoomDefaultWires,
-	ensureNodeScope,
 	ensureUserRoom,
 	getUserRoomSlot,
 } from './transport/user_room.mjs'
@@ -54,7 +54,7 @@ import {
  */
 export {
 	attachReputationSyncWire,
-	attachUserRoomDefaultWires,
+	attachNodeScopeDefaultFeatures,
 	configureLinkRegistry,
 	createGroupLinkSet,
 	createScopedLinkRoom,

package/infra/service.mjs

@@ -2,7 +2,7 @@
 import { isNodeInitialized } from '../node/instance.mjs'
 import { setOverlayRateGate, clearOverlayRateGate } from '../overlay/index.mjs'
 import { getLinkRegistry } from '../transport/link_registry.mjs'
-import { attachNodeScopeMailbox } from '../transport/node_scope.mjs'
+import { attachNodeScopeMailbox } from '../transport/node_scope/features.mjs'
 
 import { attachInfraDebugLog, detachInfraDebugLog } from './debug_log.mjs'
 import {

package/link/handshake.mjs

@@ -9,9 +9,6 @@ import { ensureNodeSeed, getNodeHash } from '../node/identity.mjs'
 
 import { normalizeDtlsFingerprint } from './sdp_fingerprint.mjs'
 
-/** advert / peer-hint 端口规范化（re-export，调用方可直接从 core/tcp_port 导入） */
-export const normalizeAdvertTcpPort = normalizeTcpPort
-
 /**
  * Link 握手签名域标识符。
  */

package/mailbox/deliver_or_store.mjs

@@ -23,7 +23,6 @@ import {
  * @returns {Promise<string | null>} 已验证的 remote nodeHash
  */
 async function resolveRemoteNodeHashForPeer(username, peerId) {
-	void username
 	if (!peerId) return null
 	const entry = activeLinkRoster().find(row => row.peerId === peerId)
 	const remote = entry?.remoteNodeHash?.trim().toLowerCase()
@@ -51,7 +50,6 @@ async function resolveRelayHopForIngress(record) {
  * @returns {Promise<{ maxHop: number, relayFanoutTrusted: number, relayFanoutNormal: number, wantFanout: number, batterySaver: boolean }>} 按在线 peer 数缩放的路由
  */
 async function resolveRouting(username) {
-	void username
 	const { batterySaver, mailbox } = getNodeTransportSettings()
 	const peerCount = activeLinkRoster().length
 	return resolveMailboxRoutingForPeerCount(peerCount, mailbox, batterySaver)

package/mailbox/parse.mjs

@@ -1,9 +1,9 @@
 import { assertHex64 } from '../core/hexIds.mjs'
+import { isPlainObject } from '../core/object.mjs'
 import {
 	assertMailboxPubKeyHash,
 	assertMailboxRecordShape,
 } from '../schemas/mailbox.mjs'
-import { isPlainObject } from '../wire/ingress.mjs'
 
 /**
  * @typedef {import('../schemas/mailbox.mjs').MailboxWireErr} MailboxParseErr

package/mailbox/store.mjs

@@ -11,19 +11,10 @@ import {
 	sortMailboxForRetention,
 } from './importance.mjs'
 import {
-	MAX_BUCKET_BYTES,
-	MAX_BUCKET_ENTRIES,
-	mailboxBucketKey,
-	mailboxRecordBytes,
 	pruneMailboxBuckets,
 	pruneMailboxGlobalFair,
 } from './prune.mjs'
 
-/**
- * mailbox 桶裁剪与计量辅助（re-export）。
- */
-export { MAX_BUCKET_BYTES, MAX_BUCKET_ENTRIES, mailboxBucketKey, mailboxRecordBytes }
-
 /** 单条 mailbox envelope JSON 字节上限 */
 export const MAX_ENTRY_BYTES = 256 * 1024
 

package/mailbox/wire.mjs

@@ -1,3 +1,5 @@
+import { subscribeWire } from '../wire/subscribe.mjs'
+
 import {
 	ingestMailboxGive,
 	ingestMailboxPut,
@@ -5,23 +7,30 @@ import {
 } from './deliver_or_store.mjs'
 import { parseMailboxGive, parseMailboxPut, parseMailboxWant } from './parse.mjs'
 
-/**
- * @typedef {{ replicaUsername?: string }} MailboxWireContext
- */
+/** @typedef {import('../wire/adapter.mjs').WireContext} MailboxWireContext */
+/** @typedef {import('../wire/adapter.mjs').WireAdapter} WireAdapter */
 
 /**
  * @param {MailboxWireContext} wireContext 入站上下文
- * @param {{ on: (name: string, handler: (payload: unknown, peerId: string) => void) => (() => void) | void, send: (name: string, payload: unknown, peerId: string | null) => void }} wire Trystero 适配器
+ * @param {WireAdapter} wire action 表
  * @returns {() => void} 取消挂载的 dispose
  */
 export function attachMailboxWire(wireContext, wire) {
-	const offs = [
-		wire.on('mailbox_put', (payload, peerId) => {
+	return subscribeWire(wire, {
+		/**
+		 * @param {unknown} payload mailbox_put 载荷
+		 * @param {string} peerId 对端 nodeHash
+		 */
+		mailbox_put(payload, peerId) {
 			const put = parseMailboxPut(payload)
 			if (!put.ok) return
 			void ingestMailboxPut(wireContext, put.value, peerId).catch(error => console.error('mailbox: put ingest failed', error))
-		}),
-		wire.on('mailbox_want', (payload, peerId) => {
+		},
+		/**
+		 * @param {unknown} payload mailbox_want 载荷
+		 * @param {string} peerId 对端 nodeHash
+		 */
+		mailbox_want(payload, peerId) {
 			const want = parseMailboxWant(payload)
 			if (!want.ok) return
 			void respondMailboxWant(want.value, (giveWire, targetPeerId) => {
@@ -30,15 +39,14 @@ export function attachMailboxWire(wireContext, wire) {
 				}
 				catch { /* disconnected */ }
 			}, peerId).catch(error => console.error('mailbox: want failed', error))
-		}),
-		wire.on('mailbox_give', payload => {
+		},
+		/**
+		 * @param {unknown} payload mailbox_give 载荷
+		 */
+		mailbox_give(payload) {
 			const give = parseMailboxGive(payload)
 			if (!give.ok) return
 			void ingestMailboxGive(wireContext, give.value).catch(error => console.error('mailbox: give ingest failed', error))
-		}),
-	]
-	return () => {
-		for (const off of offs)
-			try { off?.() } catch { /* ignore */ }
-	}
+		},
+	})
 }

package/node/reputation_sync.mjs

@@ -2,7 +2,9 @@ import { randomUUID } from 'node:crypto'
 
 import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
 import { sendToNodeLink } from '../transport/link_registry.mjs'
-import { attachNodeScopeFeature, ensureNodeScope, getNodeScopeWire } from '../transport/node_scope.mjs'
+import { attachNodeScopeFeature } from '../transport/node_scope/features.mjs'
+import { ensureNodeScope, getNodeScopeWire } from '../transport/node_scope/wire.mjs'
+import { subscribeWire } from '../wire/subscribe.mjs'
 
 import {
 	loadReputation,
@@ -226,34 +228,36 @@ function exportScoreTable() {
 export function attachReputationSyncWire() {
 	ensureNodeScope()
 	if (!getNodeScopeWire()) throw new Error('p2p: attachReputationSyncWire requires node scope wire')
-	const dispose = attachNodeScopeFeature('rep_sync', wire => {
-		const offs = [
-			wire.on('rep_sync_req', (payload, peerId) => {
-				const requester = normalizeHex64(peerId)
-				if (!requester || !getReputationExportAllowlist().includes(requester)) return
-				try {
-					wire.send('rep_sync_res', {
-						requestId: payload?.requestId,
-						...exportScoreTable(),
-					}, peerId)
-				}
-				catch { /* disconnected */ }
-			}),
-			wire.on('rep_sync_res', (payload, peerId) => {
-				const requestId = String(payload?.requestId || '')
-				const pending = pendingPulls.get(requestId)
-				if (!pending) return
-				if (normalizeHex64(peerId) !== pending.donor) return
-				clearTimeout(pending.timer)
-				pendingPulls.delete(requestId)
-				pending.resolve(payload)
-			}),
-		]
-		return () => {
-			for (const off of offs)
-				try { off?.() } catch { /* ignore */ }
-		}
-	})
+	const dispose = attachNodeScopeFeature('rep_sync', wire => subscribeWire(wire, {
+		/**
+		 * @param {unknown} payload rep_sync_req 载荷
+		 * @param {string} peerId 对端 nodeHash
+		 */
+		rep_sync_req(payload, peerId) {
+			const requester = normalizeHex64(peerId)
+			if (!requester || !getReputationExportAllowlist().includes(requester)) return
+			try {
+				wire.send('rep_sync_res', {
+					requestId: payload?.requestId,
+					...exportScoreTable(),
+				}, peerId)
+			}
+			catch { /* disconnected */ }
+		},
+		/**
+		 * @param {unknown} payload rep_sync_res 载荷
+		 * @param {string} peerId 对端 nodeHash
+		 */
+		rep_sync_res(payload, peerId) {
+			const requestId = String(payload?.requestId || '')
+			const pending = pendingPulls.get(requestId)
+			if (!pending) return
+			if (normalizeHex64(peerId) !== pending.donor) return
+			clearTimeout(pending.timer)
+			pendingPulls.delete(requestId)
+			pending.resolve(payload)
+		},
+	}))
 	syncWireDisposers.add(dispose)
 	return () => {
 		if (!syncWireDisposers.delete(dispose)) return

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@steve02081504/fount-p2p",
-	"version": "0.0.22",
+	"version": "0.0.24",
 	"description": "fount federation P2P layer — link, trust graph, mailbox, DAG, EVFS.",
 	"keywords": [
 		"network",
@@ -41,19 +41,15 @@
 		"./crypto": "./crypto/crypto.mjs",
 		"./crypto/*": "./crypto/*.mjs",
 		"./wire/*": "./wire/*.mjs",
+		"./wire/part/*": "./wire/part/*.mjs",
 		"./schemas/*": "./schemas/*.mjs",
 		"./node/*": "./node/*.mjs",
 		"./discovery": "./discovery/index.mjs",
 		"./discovery/bt": "./discovery/bt/index.mjs",
 		"./discovery/bt/*": "./discovery/bt/*.mjs",
 		"./discovery/*": "./discovery/*.mjs",
-		"./transport/link_registry": "./transport/link_registry.mjs",
-		"./transport/user_room": "./transport/user_room.mjs",
-		"./transport/group_link_set": "./transport/group_link_set.mjs",
-		"./transport/node_scope": "./transport/node_scope.mjs",
-		"./transport/room_scopes": "./transport/room_scopes.mjs",
-		"./transport/remote_user_room": "./transport/remote_user_room.mjs",
-		"./rooms/*": "./rooms/*.mjs",
+		"./transport/node_scope/*": "./transport/node_scope/*.mjs",
+		"./transport/*": "./transport/*.mjs",
 		"./overlay": "./overlay/index.mjs",
 		"./overlay/*": "./overlay/*.mjs",
 		"./trust_graph/*": "./trust_graph/*.mjs",
@@ -62,7 +58,11 @@
 		"./dag/*": "./dag/*.mjs",
 		"./timeline/*": "./timeline/*.mjs",
 		"./files/*": "./files/*.mjs",
+		"./files/chunk/*": "./files/chunk/*.mjs",
+		"./files/manifest/*": "./files/manifest/*.mjs",
+		"./files/fed/*": "./files/fed/*.mjs",
 		"./federation/*": "./federation/*.mjs",
+		"./federation/part_query/*": "./federation/part_query/*.mjs",
 		"./governance/*": "./governance/*.mjs",
 		"./registries/*": "./registries/*.mjs",
 		"./permissions": "./permissions/index.mjs",
@@ -71,6 +71,7 @@
 	},
 	"dependencies": {
 		"@noble/curves": "latest",
+		"@noble/hashes": "latest",
 		"node-rtc-connection": "latest",
 		"on-shutdown": "latest",
 		"ws": "latest"