Files
ssw-mpc/docs/N_PARTY.md
T
rong 37aa81e394 feat(psi): n 方隐私求交(环协议)+ 分块流水修复大集合死锁
影响:PSI 此前硬卡在两方,导致纵向 LR / SQL JOIN 无法扩展。现在 3 方及以上
可以直接跑,n=2 退化为原两轮交换、开销逐项不变(没有第二条代码路径)。

- nax-psi 新增 match_across:n 方求交(逐个 match_points 取 AND)。不能拿两两
  求交拼 —— A={1,2} B={2,3} C={3,1} 两两都非空但三方交集为空,有专门的测试钉住
- run_psi_session 改成环协议:集合沿环走 n-1 跳、每跳叠一把密钥,最后汇总广播;
  新增 PsiConfig.my_idx(必须与 transport 的 party 编号一致)
- pipeline_points:分块 + 交替收发。整份 3.2 MB 单帧会写满 socket 缓冲(macOS
  默认 ~128 KB)造成多方互相阻塞 —— 实测 10 万条两方 256 s 后 Broken pipe;
  分块后在途数据恒定 32 KB,10 万条两方 34 s、三方 90 s
- nax-cli 的 psi 支持 --peers 建网状连接(与 node 一致);种子一律从
  (主种子, site) 派生,否则各方共用默认 --seed 会撞 ECDH 私钥(交集仍对,隐私全失)

验证:三方真 TCP 跑出正确交集;变异验证两条 —— 把 AND 退化成"只比第一个对端"、
把环上"谁持有哪份集合"写错,对应测试都立刻失败。

未做:恶意方防护(需 OPRF-based PSI);纵向 LR / SQL JOIN 仍是两方(它们是
两方协议,不是被 PSI 卡住)。
2026-11-01 14:29:53 +08:00

7.9 KiB
Raw Blame History

n 方(n > 2):哪些真的支持、哪些还不支持

一句话:计算路径和 PSI 都是真 n 方的,纵向 LR / SQL JOIN / TEE 信任模型还是两方。 这份文档的唯一目的是让这句话可核对 —— 每条"支持"都指得到测试, 每条"不支持"都写清是协议限制还是没做。

nax 是 N-arty Arithmetic eXecution。两方是 n=2 的特例,不是框架的形状。 把两方当默认会带来一种很隐蔽的退化:代码在 n=2 时看着全对, 到 n=3 时不是崩,而是算出一个错但合理的数。


能力矩阵

模块 / 能力 n > 2 证据 说明
nax-core 分片 / Beaver / 矩阵三元组 / 截断对 / edaBit ✅ share::tests::split_reconstruct_roundtrip(n=3)、mul_triple_consistent、edabit_* 全部参数化 n,输出布局 shares[party*len + i]
nax-core 安全比较 / 位代数 ✅ compare::tests::* 逐位算子,本身不含 party 概念
nax-vault open / mul / truncate / matmul_trunc ✅ open_three_party_sums_all、beaver_mul_three_party、truncate_three_party_puts_public_cs_once、mul_trunc_three_party_fixed_point、matmul_trunc_three_party 见下方"三处最容易错的地方"
nax-vault 安全比较(bit_lt / msb_raw / 位代数) ✅ bit_lt_three_party 走 edaBit + 多次 Beaver 乘
nax-node 网状连接 + 会话 ✅ three_party_session_over_mesh、three_party_session_over_mesh_with_psk 真 TCP,三方全网状,含 PSK 加密链路
nax-psi 隐私求交(环协议) ✅ psi_three_party_over_mesh、psi_three_party_no_common_element、n_way_intersection_is_not_pairwise 真 TCP 三方;n=2 退化为原两轮交换,开销不变
nax-sql 竖向列交换 ✅ exchange_split_columns_three_party 三方各持一列,按 party 下标拼回全局列序
nax-he HE-OLE 物料 ✅ he_mul_triple_three_parties 每对做两次 OLE,无第三方
nax-fl 加权聚合 ✅ — 客户端数是 delta_shares.len(),与参与方数无关
nax-node 纵向 LR(run_lr_vertical_session) ❌ 协议限制 显式拒绝 n≠2 PSI 已经不是瓶颈了;卡在纵向切分本身:一方持左列块、另一方持右列块,训练时互相补列
nax-cli lr / sql-join ❌ 同上 启动即报错并说明原因 不给半条路:连网之前就拒绝;psi 与 node 已可 n 方
nax-tee TrustPlan(L0–L3) ❌ 模型限制 TrustPlan 是成对的 四级可信度讲的是"两方各自有无 TEE",n 方需要重新定义可信度组合

三处最容易错的地方

n 方出错的地方不在通信,而在"公开值出现了几次"。同一份代码在 n=2 时 写错成 2·x,在 n=3 时错成 3·x —— 数值离谱但不报错,看着像精度问题。

  1. 截断的 cs:c = x + r 打开后,c >> fxp 是公开值,只能落在一方身上 (Vault::truncate 里 if self.my_idx == 0)。每方都减一次 → n·cs − rt。
  2. 矩阵乘的 d·e:同一个道理,只有 0 号补。
  3. 常数项的 1:bit_not、bit_one 也只在 0 号带 1。

这三处都有测试钉着,而且是变异验证过的:把 if self.my_idx == 0 改成 if true,truncate_three_party_puts_public_cs_once 立刻失败 (实测得到 18446698035212651052 而不是 1572864)。测试会不会失败, 和测试会不会通过同样重要。

另外两处只在 n 方现形的问题:

  • 列块顺序:收到分片按到达顺序排,各方速度不同时偶发错位 —— 值全对、 语义全错。所以 exchange_split_columns_multi 一律按 party 下标收。
  • 环上死锁:n 方"发一个收一个"会让每方都在等下一方。Vault::open 与 列交换是先全发、再全收;PSI 因为集合可能很大,改用分块流水 (发一块收一块),道理相同但把在途数据压到恒定 32 KB。

n 方 PSI 怎么做

两轮 DH-PSI 天然是两方的(每轮"对端"只有一个)。n 方求交不是把它包进 for 循环 —— 两两求交 ≠ n 方求交,反例 A={1,2} B={2,3} C={3,1}: 两两交集都非空,三方交集是空集。拿两两结果拼,会把三个元素全判成命中 (n_way_intersection_is_not_pairwise 钉的就是这条)。

run_psi_session 用的是环协议(Meadows / Huberman–Franklin–Hogg):

阶段 0   方 i 盲化自己的集合:S_i^{k_i} = shuffle(k_i · H(ID))
阶段 A   沿环走 n-1 跳,每跳被当前持有者用自己密钥再幂一次
         结束时 S_j^{K} 停在方 j-1 手里(K = k_1·k_2·…·k_n)
阶段 B   每方把自己手上那份完整集合广播给其余 n-1 方
         至此每方持有全部 n 个 S_j^{K},本地求交

传输是按集合算的,不是按点算(每方每跳只传手上一个集合):

两轮 DH-PSI(n=2) 环协议(n 方)
通信轮次 2 n(n−1 跳环 + 1 轮广播)
每方发出 2|X| 点 2(n−1)|X| 点
每方模幂 2|X| 次 2(n−1)|X| 次(n=2 时同为 2|X|)
新增帧类型 — 无(复用 Op::PsiPoints)
安全假设 DDH + 半诚实 同左

n=2 时开销与旧实现逐项相同,所以没有保留单独的"两方快路径"—— 一份实现、一份测试。

安全边界(说清楚,不美化)

  • 环上中间方看到的是"别人集合乘了部分密钥"的点,反推 ID 等价于解 X25519 离散对数,与两方版本同级。
  • 没有防恶意方:恶意参与方可以用自己的密钥构造探针,测试某个 ID 是否 在别人集合里。堵这个洞要 OPRF-based PSI(如 KKRT / ecOPRF),不在本轮范围。
  • 每方种子必须不同。同种子 = 同私钥,交集仍然算得对,但隐私性直接失效 —— 这是最隐蔽的一种失败,CLI 从 (seed, site) 派生正是为此。

规模:必须分块,否则必死锁

一开始是"整份集合发一帧"。10 万条(3.2 MB/方)在 macOS 上必然卡死: 发送缓冲默认只有 ~128 KB,写满后每方都在等对方读 —— 实测 256 秒后 以 Broken pipe 失败。5000 条能过,只是因为它装得下缓冲。 这是最容易被小规模测试骗过去的那类缺陷(规模相关,不是逻辑错)。

现在 pipeline_points 按 1024 点(32 KB)分块,发一块收一块, 在途数据与总规模无关。实测(--release,i5-5250U):

规模 方数 耗时
10 万 2 34 s
10 万 3 90 s

复现:

cargo test --release -p nax-node --lib -- --ignored --nocapture psi_large

自己验

# n 方算子(vault 层,内存全互联)
cargo test -p nax-vault --lib three_party

# n 方真 TCP(起三个实际 socket)
cargo test -p nax-node three_party

# n 方 PSI(真 TCP 三方 + 无公共元素的反例)
cargo test -p nax-node --lib psi_three_party

# n 方竖向列交换
cargo test -p nax-sql --features secure exchange_split_columns_three_party

命令行三进程跑真 PSI:

S=alice,bob,carol
P="alice=127.0.0.1:9440,bob=127.0.0.1:9441,carol=127.0.0.1:9442"
nax psi --site alice --sites $S --listen 127.0.0.1:9440 --peers $P \
        --ids 1,2,3,4,5 --seed 1111... &
nax psi --site bob   --sites $S --listen 127.0.0.1:9441 --peers $P \
        --ids 3,4,5,6,7 --seed 2222... &
nax psi --site carol --sites $S --listen 127.0.0.1:9442 --peers $P \
        --ids 4,5,6,7,8 --seed 3333... &
# 三方都应输出 4,5

内存通道用 nax_vault::MeshPipe::mesh(n):每对 (i,j) 一条独立管道, recv_from(party) 严格按来源取帧 —— 和 TcpMesh 语义一致。 用 Pipe::pair() 串成 n 方是错的:它忽略 party 参数, 会把"发给 2 号"静默送给 1 号,那正是要测的东西。