Commit Graph
64 Commits
Author SHA1 Message Date
admin bd9bea0142 fix(cluster): 修掉真机自报脚本 3 个必挂缺陷,判据门禁收编为第 25 条
集群自报联调脚本的 3 个真机必挂缺陷:
- xop 把自己的 WARN 打在 stdout(不是 stderr)。`remote()` 原先 `2>&1`
  合并返回,导致 `wc -c` / `sha256sum` / curl HTTP 码全被污染;
  改用 fd3 分流:远端输出进临时文件,xop stdout 丢弃,返回值只剩真实输出。
  `xop_probe` 改为只认纯数字行,拿不到数字即失败(fail-closed)。
- `printf '--- 负向矩阵…'` 格式串前导破折号被 bash 当成选项,改用 `%s`。
- `remote()` 里 `< /dev/null` 被后面的 here-string 覆盖,是无效防护;
  同时删掉从未被调用的 `remote_amd()`(把脚本正文塞进 ssh argv 的活样本)。

判据门禁(第 25 条)收编:
- `selftest-cluster-selfreport.py` 重写为 9 组判据 10 项检查,
  探针先自证 fired(避免「argv 日志为空 ⇒ 没密钥」恒真),
  用假 xop + 假 sshpass,不依赖真机与保险库是否解锁。
- 判据 4 只扫密钥流经语句并豁免本地熵源;新增判据 9 守 fd3 隔离。
- `selftest-cluster-selfreport-break.py` 覆盖全部 9 组判据共 11 条破坏实验,
  每条变异双向确认证据串,顺序事实型单独一条路径。

文档:主门禁条数 24 → 25 全仓同步;诚实边界改为「真机两节点自报已实证,
选址/下发/证明门控/端点交付仍只在假 hostd 上验过;修完的脚本只过离线
判据门禁,尚未在真机复跑」。

验证:bash -n、shell 卫生 lint(39 脚本)、真 xop+假远端 fd3 分流实测、
自测 10/10、破坏实验 11/11、tools/ci.sh 全量 25 条 CI_EXIT=0。
2026-11-09 18:01:13 +08:00
admin bcad01d697 feat(sa): SA 扩展模式真机端到端跑通 + 修掉主门禁被误删的 5 条
SA 扩展模式(安全锚点供能力、算力挂外部 VM):
- 板端 SA 服务端 ↔ OrbStack 外挂 VM 端到端跑通,判据 26/26
- seal/unseal/attest/sign + 会话物料全部可用;VM 侧拿不到 K_root
  (site 名骗不出、协议无导出端点、VM 侧无根密钥文件)
- 阶段一边界写死为 platform=none,不假装有硬件根

零种子守卫(fail-closed):
- CLI 入口(连网之前)+ Vault::new 双层拒绝全零主种子
- mpc node 的种子校验原本在连网 + Ray 注册之后,失败会伪装成「网络问题」,已前移
- 判据 18 条,两处破坏实验证明非恒绿

主门禁回归修复(本次最重要):
- 27cbdc7 删掉了 ci.sh 的第 18-22 条共 5 个 step,判据脚本都还在、
  只是不再被调用 ⇒ 门禁静默削弱(文件在、判据在、门禁不跑)
- 已从 237e646 原样恢复,SA 与零种子守卫顺延为第 23/24 条,总数回到 24
- 头部注释编号与 step 号重新一一对齐

新发现的真缺陷与盲区:
- help 文本与实现漂移:attest-upload 的 --upload-path-file 漏写(实现里必填),
  SA 客户端五个必填参数全没写进帮助 ⇒ 静默失败,代码照编译门禁照全绿
- 加两条守卫测试,并修掉判据的自指型假绿(查裸字符串恒为真,要查解析调用)
- shell lint 不扫 deploy/arm,而那里是板端真跑的脚本 ⇒ 抓到 4 处 var-ascii 命中,
  已修并把 deploy/arm 纳入扫描范围(35 → 38 个脚本)
- hostd 客户端补 .no_proxy():代理会把这一跳端点换掉,症状是 502 伪装成控制面没起来

门禁:tools/ci.sh 全量 EXIT=0,24 条全绿(第 22 条真链批缺环境显式 SKIPPED)。
2026-11-09 16:32:36 +08:00
admin 01b8bb44aa docs: 更新 OP-TEE 实跑状态,纠正文档里 storage 默认路径的错误认知
- docs/INDEX.md / ARCHITECTURE_SYSTEM.md / README.md:
  「OP-TEE QEMU 实跑未做(缺 SDK)」改为已做,但明确标注是 QEMU 模拟
  (dna = 编译期 sha256 种子、HUK = 模拟值),不能当真板设备绑定证据。
- docs/OPTEE_VERIF_PLAN.md:补第 4 条实跑证据表与破坏实验表;
  新增坑 ⑦⑧⑨(storage 默认路径 / 落点检查时机 / QEMU 不退出);
  状态表判据用例 15 → 19;步骤 3 状态改为完成。
- 更正 §3 里「storage 默认在 /data/tee,所以不用改 tee-supplicant 启动参数」
  这句错误认知 —— 实测默认是 /var/lib/tee,必须显式 -f /data/tee。
- ARCHITECTURE_SYSTEM.html 由 tools/render-share-html.py 重新生成,--check 同步通过。
- CLAUDE.md 补集群调度面与 OP-TEE 实跑结论。
2026-11-09 13:20:35 +08:00
admin 660e5712c3 feat(tee): 真机双机实跑复验,固化 /opt 物料基线与本机重建条件
用户要求「跑一遍,确保本地资源能用,别两台机器重启就找不到了」。
按固化的三步重跑(env 样例 → 预检 → e2e)在两台真机上实跑:

- 正向 e2e 全绿:从源码重编 musl mpc → 重新导出 alpine rootfs → 重新打
  initrd → 分发 → 双 KBS → 双 guest,TEE_PAIR_OK + TEE_ATTEST_GATE_OK
  + TEE_PAIR_ATTEST_OK,两侧还原 35.000000(2m05s)。
- 负向矩阵全绿:篡改度量 pin ⇒ 403 拒证明、guest fail-closed 拿不到密钥;
  恢复 pin ⇒ 又拿到(TEE_ATTEST_NEGATIVE_OK,exit=0)。
  ★ 修掉旧版单独跑报「缺少 MPC_TEE_MANIFEST」:负向脚本现在自动从
    ${MPC_TEE_WORK}/image 用同一份 oci-image.py verify 重算并断言 64 hex,
    不手抄;两个构造样例验证非法值 / 无产物都 exit=2。

持久化保障(回答「重启就找不到」):
- 实测两台真机 / 是 ext4 / xfs 持久根盘、无独立 /tmp tmpfs;远端三个
  /tmp 运行时目录本来全为空,e2e 每次重铺 ⇒ 丢了不影响重跑。
- 新增 host-materials.sh + nodes/host-materials.sha256(入仓基线 18 条:
  AMD 3 / 海光 15,sha256 + size):--verify 逐台比对,缺文件/被替换/
  被升级一律 FAIL 并打印 diff;--self-test 6 个构造样例证明非恒绿;
  另用「篡改清单一条 hash」端到端破坏验证(精确判红 exit=1)。
  ★ 清单只记路径/大小/哈希,不搬 69MB qemu / 78MB initrd 进仓库;
  清单本身由 git 保护。换机/升级后 --collect 重采。
- 预检新增「本机重建条件」检查:alpine:3.18 镜像、musl target、
  oci-image.py、guest/init.sh、fixtures、物料基线;缺一项即 FAIL。
  完整预检 29/0(含远端),离线 25/0 SKIP=1,自测 7/0,
  lint-shell-vars 34 脚本无隐患。

文档:真机 README 增「机器重启 / 换机后怎么办」分工表与症状速查一条;
INDEX §2/§3/§6 登记新资产与第 11 条纪律;CLAUDE.md 部署段加指针;
env 样例 H 段写明 manifest 两处都不许手抄。
校验:ci.sh 语法、判据零依赖自测 22/0、diff --check、密钥扫描全过。
门禁条数仍为 22(未改 ci.sh)。
2026-11-08 20:01:22 +08:00
admin fc0dcec93b feat(tee): 固化真机双机重跑环境,补齐预检与症状速查,避免每次从零探索
核实结论:这两天 AMD / 海光真机测试内容**早已在仓库** —— 36 个脚本、
288 行复现 README、630 行 FINDINGS、nodes 真机路径样例、fixtures 真实
CSV/SNP 报告与证书链。真正导致「每次重跑重新拼」的只有三处缺口:
参数散在 5+ 个脚本头部、没有预检、踩坑结论按探索时间组织不好按症状查。

- 新增 real-machines.env.example:2026-11-08 证明门控 + 双 guest 会话合流
  跑通那组值的脱敏快照。28 个变量与脚本 ${VAR:-default} 逐字一致(已自动
  核对,无一处笔误);凭据只放 xop 键名;区分组级与编排层实例级变量,
  运行时生成项明确标注「不要手填」。
- 新增 preflight-real-machine.sh:本地工具 / xop 键 / 参数一致性 / SSH /
  远端物料一次性报缺;缺环境显式 SKIP 或 FAIL,不静默通过;
  --self-test 用 6 个构造样例逐条破坏参数判据(7/7),证明非恒绿。
  只查环境,不产生 TEE_PAIR_OK 之类业务结论。
- README 增「重跑前先看」:三步重跑、参数真相源、17 条症状→根因→处置
  速查表、/tmp 60+ 探索脚本处置说明(过程产物,结论已沉淀,不许重跑确认)。
- INDEX §2/§3/§6 与 CLAUDE.md 登记;.gitignore 屏蔽本地实际 env 配置。

校验:bash -n、lint-shell-vars 33 脚本无隐患、预检自测 7/0、离线实跑
ok=15 SKIP=1 FAIL=0、判据零依赖自测 22/0、diff --check、路径与密钥扫描
全过。未改 tools/ci.sh,门禁条数仍为 22。
2026-11-08 19:41:31 +08:00
admin c51190b20c docs: 拆解决策文档形成系统架构文档,附可分享 HTML
- 新增 docs/ARCHITECTURE_SYSTEM.md(活真相源):组件清单、双层控制面、
  会话主键、端到端数据流、部署拓扑、平台矩阵、判定治理、诚实边界。
  用 [实证]/[桩验]/[设计]/[禁用] 区分实证与蓝图 —— `mpc site` 等
  决策角色不再被写成已部署服务,避免照着文档敲不存在的命令。
- 新增 tools/render-share-html.py 与 docs/ARCHITECTURE_SYSTEM.html:
  自包含单文件分享页,md 是唯一真相源、HTML 是派生产物勿手改;
  --check 校验两者同步,生成幂等无 diff 噪音。
- INTEGRATION_ANALYSIS.md 文首加「架构结论已抽出」指针,正文决策取证链
  保持不变;INDEX.md(§0/§2/§3/§6)、CLAUDE.md、README.md 登记新文档
  与第 9 条更新纪律。与原 ARCHITECTURE.md(计算分层)明确分工。
- 校验:HTML 与 md 同步、ci.sh 语法、判据自测 22/22、diff 空白、
  23 个引用路径与密钥扫描全过;纯文档改动未跑全量门禁。
2026-11-08 19:29:18 +08:00
admin c1ae7d7473 docs: 系统性更新项目文档至 2026-11-08 当前状态,新增文档总索引
- 新增 docs/INDEX.md:文档分类(活真相源/专题设计/历史阶段快照)、
  当前状态总览、权威入口表、旧结论对照表、诚实边界与 8 条更新纪律。
- README.md 现状改为「2026-10-30 算子基线 + 2026-11-08 增量」,补齐真机
  TEE、国密链真交易、合约实证、k8s 持久化、22 条门禁与目录树。
- CLAUDE.md 纠正三处失效结论(门禁 20→22 条、3.x eth_ 兼容端点、
  flush 只发规范字节/不宣称能上链),文档章节改为分组索引。
- INTEGRATION_ANALYSIS.md 等历史阶段文档加「当时→当前」状态锚点与对照表,
  保留取证链不改写历史;真机文档第 7/9.4 节指向第 10 节合流结论。
- 修正两处事实错误:k8s README 把本机写成节点 IP、复现文档把
  20200/30300 标反;链复现入口统一指向 deploy/k8s/fisco/README.md。
- 诚实边界保持:软件签名器密评不可过、真 bcos-rpc TLCP 未通、hostd
  执行面仍在真机、OPA 未进 guest、链上撤销与 decision 上链未做。
2026-11-08 19:11:39 +08:00
admin ba11de5da9 feat(k8s): FISCO 国密链连同现有账本迁入 wuguirong,管理节点持久化
把原跑在本机 Docker 容器 fisco-gm(账本在 /tmp)的 FISCO BCOS 3.17.1
国密链整条搬进 k8s,账本落 nfs-wuguirong PVC,不再是临时环境:

- 镜像只含静态 fisco-bcos 二进制;账本/配置/国密证书/节点私钥一律
  经 migrate-ledger.sh 注入 PVC,不进镜像、不进 ConfigMap、不进 git。
- 幂等解包([ -f ] || tar):Pod 重建不覆盖账本,避免「假持久化」。
  replicas=1 + Recreate:单节点 PBFT 不许双写、RWO 不许新旧 Pod 抢挂载。
- 常驻 fisco-verify 守卫:链活性 + 高度>=30 + block30 哈希指纹;
  三条负向样例(基线抬高/指纹篡改/地址不存在)逐条破坏验证过,非恒绿。
- 管理配套 ConfigMap 从仓库原文件生成,不复制判据逻辑;
  hostd 只沉淀管理台账 ConfigMap(执行面受 TEE 设备与编排铁律约束留真机)。

实证:blockNumber 30→34,block 1/2/3/10/20/29/30 哈希逐个与迁移前一致,
三节点 NodePort 30100 全通,真链 22 项判据复跑 22/22;删 Pod 重建(UID 已变)
后高度仍 34、block30 哈希不变。配套更新链配置与真相文档指向 k8s 端点。
2026-11-08 17:24:09 +08:00
admin 237e646962 feat(chain): 国密链智能合约真链实证部署/调用/读回打通
- 钉死 InvalidSignature 根因:节点 3.17.1 走 fast_sm2_verify,验签 e=SM3(ZA||dataHash)(distid=1234567812345678);旧实现签裸摘要口径不符。
- PrehashedSm2Signer 改为带 ZA 口径;compute_za 从 OpenSSL 曲线读 a/Gx/Gy,杜绝手抄 a=p-3 错写 fc 的坑。
- chain contract deploy/call/read 子命令落地,opts 支持 --arg 多值;接真链跑通部署+recordHardRule+读回+负向矩阵。
- selftest-fisco-contract.py 接入 ci.sh 第 22 条(22 自测+22 真链批,缺环境显式 SKIPPED)。
- docs/catalog 纠正 eth_ 端点与「不二次 SM3」过时口径;合约源码与 combined.json 入仓。
2026-11-08 13:19:17 +08:00
admin 3fc34904ba feat(chain): 国密链真交易形态跑通,挖出并修掉签名格式、幂等状态机、僵尸进程三个真缺口
交易编码(新增)
- crates/mpc-chain/src/fisco_tx.rs:FISCO 国密链自有交易编码(TARS 二进制)
  + dataHash(SM3) + prehashed SM2 签名 + 已签名交易构造。
  逐字节对齐官方 bcos-sdk-jni 基准(V0 / V1 两个样本)。
- crates/mpc-chain/src/contract.rs:合约调用编码,选择子 = SM3 前 4 字节
  (国密链取 ABI selector[1],不是 keccak256 的 selector[0])。
- crates/mpc-chain/src/rpc.rs:ChainClient::send_transaction(4 参)+ ChainSubmitResult。

真缺口一:交易签名少了公钥
- 上游 signTransactionDataHash() 传 _signatureWithPub=true ⇒ 签名是
  r||s||pub(128 字节),公钥为裸 64 字节 X||Y。
- 只签 64 字节 r||s 的交易,节点侧 recover() 解析不出公钥 ⇒ 交易被拒。
- 新增 TX_SIGNATURE_LEN 与判据 transaction_signature_is_raw_rs_followed_by_the_public_key。

真缺口二:signed-tx 绕过 outbox 状态机 ⇒ 幂等性破
- 原来自己遍历 entries,从不写回 Confirmed ⇒ 二次 flush 会把同一笔再发一遍。
- 改为统一走 Outbox::flush_with:同一份状态机不许另起一套实现。

真缺口三:僵尸进程被当成活实例
- /proc/<pid>/stat 对僵尸仍存在、starttime 仍读得到 ⇒ 身份被误判为已确认
  ⇒ restore() 把已死实例标成 Running,站点端以为它还在跑。
- process_start_key() 显式排除 state=Z/X(Linux)与 ps -o state= 的 Z/I(macOS)。
- 新增判据 zombie_process_is_not_treated_as_alive。

判据
- tools/selftest-chain-tx.py:真链形态 44 条判据,含真 TARS 解析器、
  成功判据三件套、幂等、8 类负向;接入 tools/ci.sh 第 21 条(门禁 20→21)。
- 修判据脚本自身三个 bug:failed 是二维数组却被按字符串子串查(永远为假)、
  SIMPLE_LIST 类型码是 13 而非 0x13、TARS 解析只跳头不跳值导致错位。

文档
- docs/FISCO_UPSTREAM_TRUTH.md:FISCO 上游真相源逐条固化
  (TARS 编码 / dataHash / prehashed SM2 / r||s||pub / sendTransaction 4 参 /
  回执字段 / SM3 选择子 / status==0 才是成功 / gasUsed 是 hex 串)。

诚实边界:交易编码已对齐官方 SDK,但只在假 bcos-rpc 上验过框架契约,
不等于真链能上链;真链部署与调用仍未做。
2026-11-08 10:48:50 +08:00
admin 8404517cb3 feat(tee): 芯片证明链与双 guest 密文会话合流,挖出并修掉连接等待窗口不对称
真机(AMD SEV-SNP + 海光 CSV 跨两台物理机)同一次运行里两侧各自完成
attest-collect → attest-post(KBS 芯片验签放行)→ key_source=kbs →
跨物理机密文会话,两侧都还原 value | 35.000000。判据 TEE_PAIR_OK +
TEE_ATTEST_GATE_OK,EXIT=0。负向(度量 pin 不符 ⇒ 403 且拿不到密钥,
恢复后又能拿到)也真绿。

框架层真缺陷(本轮最深的坑):连接等待窗口两侧不对称 ——
被动方(--listen)原来无限等,主动方(--connect)硬编码 50×200ms=10s,
而被动方要先做 SNP 证明验签(联网拉 KDS 证书链,首次可达 90s)才 bind,
必然 Connection refused。症状像网络不通实为窗口配小,且看运气
(KDS 链有缓存时跑绿、缓存失效就必挂)。
修:mpc_node::SESSION_WAIT_BUDGET_SECS=180(两侧同一常量)+
connect_within/accept_within(按时长给预算而非次数×间隔)+
CLI wait_budget()(MPC_SESSION_WAIT_SECS 覆盖,两侧须一致);
accept 不再无限等,能报「等待对端连接超时」而非挂死到看门狗。
3 条守卫测试钉死。

其它真缺口:KBS 缺 --platform(AMD 机拿 csv 判 SNP ⇒ 平台不一致 403)、
KBS 缺 token 密钥(远端生成,经文件读入不落命令行)、手抄 hex 长度
66/65/63(改程序化生成 + assert)、PSK 带换行、证明提交超时 10s < KBS
判定 30s(改 90s;症状 os error 11 EAGAIN 不像超时易误判成 KBS 挂了)、
role=none 误要求数据面网卡(按 ROLE 分支)。

架构结论:两张网卡不能合成一张(socket 二层会话 / tap 三层 KBS);
网卡按 MAC 认不按枚举顺序;两侧各起本机 KBS 不共用;
编排层「等 qemu 端口 LISTEN」是假就绪信号。
证明门控判据独立于会话判据(互不蕴含,合成会一项过掩盖另一项不过)。

主门禁 19 → 20 条(第 20 条 = 证明门控判据自测 10/10)。
2026-11-08 00:20:45 +08:00
admin 5a0e6e389e feat(tee): 真 TEE 跨物理机双 guest 密文会话跑通,挖出并修掉四个真缺口
AMD SEV-SNP(192.168.1.7, alice) 与海光 CSV(192.168.1.102, bob) 跨两台物理机,
各自在真加密 VM 内完成 PSK 双向认证 + ChaCha20-Poly1305 密文会话,
两侧都还原出 value | 35.000000,判据 TEE_PAIR_OK。

新资产:
- deploy/tee/real-machine/tee-pair-e2e.sh  一键复现(编译→OCI→分发→双机→判定)
- deploy/tee/real-machine/guest-watch.sh   后台起 guest + 轮询完成标记 + 收尾
- deploy/tee/real-machine/check-pair-verdict.py  唯一判定实现
- tools/selftest-tee-pair-verdict.py        判据自测(主门禁第 19 条)

修掉的四个真缺口:
1. guest halt 后 qemu 不退出 ⇒ 前台 ssh 永久挂死(会话已成功但判据没跑到 ⇒ 假红)
2. 判据字符串写错("mpc selftest 全部通过" vs 真实 "全部通过")⇒ 假红
3. 串口没落盘 ⇒ guest stdout 全丢,判据无从采集
4. 采集日志被 xop 掩码(rootfs_files → ro****fs_files)⇒ 判据只认稳定后缀

判据纪律:判定只有一份实现(编排与门禁自测共用同一份),每条判据都用构造样例
逐条破坏过(13/13),证明能真的把结论推翻。

另修 tools/selftest-chain-opa.py 的门禁计数守卫:不再硬编码 "18/18",
改为从 ci.sh 实际解析条目编号(连续 + 分母一致),避免加条即假红。

诚实边界:本轮跑的是离线演练密钥,不宣称密钥分发链路;
pair-run.sh 不做芯片证明互验,不宣称两端互验过对方芯片报告。
2026-11-07 23:06:32 +08:00
admin 7451b5b55d feat(hostd): 服务端鉴权落地 + 沙箱站点端驱动真机闭环,挖出并修掉 DELETE 只停不删
真机联调(CubeSandbox 沙箱当异地站点端 → 海光真机 192.168.1.102)暴露并修掉
三个真缺口,并把「否定式判据恒为真」这个探针自指坑彻底堵上。

① hostd 服务端**完全没有鉴权**(真缺口)
   原来 client.rs 只在客户端拼 Authorization 头,服务端根本不验 ——
   之所以没出事只因默认只听回环。新增 crates/mpc-hostd/src/auth.rs:
   - 回环信任(未配密钥)/ 凭据模式(已配)两档;服务端只存 sha256(secret),
     摘要不能反向当 token 用;最低 32 字节,启动期硬拒;ct_eq 常量时间比对;
   - 对外不区分「没带」与「带错了」,细分只进日志;
   - 鉴权先于路由(含 /health),业务端点 POST /sandboxes 同样受保护;
   - 非回环必须「共享密钥 + --allow-remote」两者齐备,互为兜底。
   共享密钥是静态的,不是站点端签发的短期 token(那一层仍未落地)。

② DELETE /sandboxes/{id} 只停不删(真缺口)
   api.rs 注释写着「显式删除」,实现却只调 stop() ⇒ 删完仍在 GET /sandboxes 里。
   症状极静默:204 看着成功,列表越积越多。
   新增 runtime.remove()(先 stop 收进程、再删记录与子进程句柄,顺序反了会留僵尸)。

③ guest 边界探针的否定式判据可能是空判据
   实测 release+strip+LTO 后:eth_sendRawTransaction / 1234567812345678 在 musl
   host 产物里**也找不到**(host 不含 chain)⇒ 拿它们判 guest 必然恒为真;
   而 mpc-hostd / allow-remote 在 guest 产物里**也会有**(那是 main.rs 帮助文本)。
   改法:标识串按归属分五组,binary 子命令同时吃 guest + host 两份产物做交叉对照 ——
   先用 host 证明「这些串确实会进二进制」,再据此在 guest 上跑否定判据;
   host 里找不到 ⇒ 探针失效 ⇒ 直接 FAIL,不安静跳过。

配套:
- 两种 musl 产物正式化:guest(--no-default-features) 与
  host(--no-default-features --features host-only)。真机无 Rust 工具链,
  hostd 必须以自包含静态二进制跑在真机上;openssl 仍禁入 musl 依赖图
  (否则 pkg-config 会抢先于 compile_error! 守卫,守卫就成假判据)。
- 修 Request::header 大小写敏感(手写 Request 时带对 Authorization 头却被判没带)。
- 主门禁第 4 条改交叉对照(deps 30 + guard 3 + binary 39 条);
  第 12 条 hostd 自测补 DELETE 真删判据。
- 文档:docs/REAL_MACHINE_FINDINGS.md 第 5 节(沙箱→真机闭环)+ CLAUDE.md 铁律。

真机实测全绿:沙箱经 e2b 兼容 HTTP 面 up/ps/attest/down 跨机跑通,
鉴权矩阵(正向 200 / 缺凭据 401 / 错凭据 401 且两响应体逐字节相同)全绿。
诚实边界:沙箱起的是真机上的普通进程不是真 TEE enclave(四布尔必然全 false),
这验证的是控制面编排而非证明链;hostd 仍是明文 HTTP;只连了海光一台。
2026-11-07 22:13:11 +08:00
admin 260e67e700 feat(tee): 两台真机实证落库,挖出并修复 CSV 验签两个真 bug
海光 192.168.1.102 (CSV) 与 AMD 192.168.1.7 (SNP) 真机实测结论:

- 海光官方 SM2 签名不覆盖报告 MAC 字段(篡改末字节仍 verify success)
- 海光官方验签器缺证书时联网 curl cert.hygon.cn 补链,
  即「我们提供的信任材料」未参与链验证 —— wrapper 改为强制 unshare -rn 断网
  + 本地前置校验关键证书齐全,缺任一即 fail-closed 拒
- AMD SNP 当前 HEAD 五关闭环跑通(正向 attest/kbs/key 全通,负向四类全拒)
- 跨平台 user_data 上半段逐字节相同,验证方须用同一 node 描述重算
- TCB 关必须单独可达:--tcb 实际值 / --min-tcb 门槛不得混用

新增/变更:
- csv-verify-attestation.sh:断网隔离 + 本地链完整性前置校验
- kbs-up.sh:全部参数外部优先、网段/TCB 同源自检
- selftest-csv-verify.py:零依赖 18 条 + 真机闭环 10 条(Py3.6 兼容)
- selftest-kbs-up.py:17 条参数与自检判据
- fixtures/csv/:真实报告与公开信任材料(无私钥)
- docs/REAL_MACHINE_FINDINGS.md:真机硬事实专档

主门禁仍 18 条,EXIT=0 全绿(第 10 条纳入 CSV 与 KBS 参数自测)。
2026-11-07 21:06:27 +08:00
admin ccf74fc3cd feat(opa): 链上撤销状态位读取落契约,未接入即 fail-closed 拒
- opa.rs 新增 RevocationViewSource{CallerSupplied,ChainRead} + ChainRevocationReader
  + UnconfiguredRevocationReader + resolve_revocation;decide 撤销来源二选一
- 链读后端未接入时声明 chain 必拒(REVOCATION_CHAIN_UNVERIFIED),
  绝不默认 revoked=false 放行;撤销仍 fail-closed 且无缓存
- CLI 支持 --revocation chain,输出区分 chain-read / 本地桩两种来源标注
- 第 17 条判据扩到 41 真闭环 + 22 零依赖,新增链读 fail-closed 负向
- CLAUDE.md / INTEGRATION_ANALYSIS.md / MEMORY.md 同步撤销来源与诚实边界
2026-11-07 19:58:18 +08:00
admin d6330862d9 feat(chain): TLCP 进程通道环回实证落地,主门禁扩到 18 条
- mpc-chain 新增 TlcpEndpoint/TlcpTunnel:Rust 侧 spawn gmssl tlcp_client
  经 TLCP 收发真实 JSON-RPC(响应走 stdout),就绪状态 NeedsFfi → LoopbackReachable
- mpc chain tlcp send 端到端收发;realChainVerified 恒 false、channelLayerReachable
  仅当配置就绪才 true,诚实边界未破(环回 echo 不等于 bcos-rpc 真机通道)
- 主门禁第 18 条 = selftest-tlcp-tunnel.py(15 条真环回判据 + 零依赖 --self-test)
- 修 selftest-chain-gm.py / selftest-chain-opa.py 两处写死旧门禁计数的断言
- CLAUDE.md / INTEGRATION_ANALYSIS.md / ci.sh 同步门禁计数与状态
2026-11-07 19:23:40 +08:00
admin 8d7c9aace2 feat(chain): 阶段 3 第一段 OPA 真判定闭环,主门禁扩到 17 条
- 新增 mpc_chain::opa:真 bundle 的 SM3 hash pin + SM2 真签/重算验签、有效期与撤销 fail-closed、input.source 前置校验、只 spawn 外部 opa 真求值、decision 确定性 id 兼 outbox 幂等键
- 严格判 opa eval 输出:undefined({}) / 多结果 / 非 bool / 非零退出一律拒绝,绝不当默认 deny 放过
- CLI 新增 mpc chain opa sign|decide,系统 openssl 独立验签;输出 opaInGuest=false / chainRecorded=false
- 新增 tools/selftest-chain-opa.py:40 条真闭环 + 18 条零依赖判据;16 条负向带期望特征,并排除「未知参数」这类探针自身 bug 造成的假绿
- domain.rs 新增两个域分隔;catalog 守卫用 include_str! 直接校验 opa.rs 真实 API 存在
- 同步 CLAUDE.md / 集成文档,主门禁 16 条改为 17 条
- 诚实边界:OPA 不在 guest 内执行、撤销视图是本地桩(链上状态位未接)、decision 未签名未上链,不宣称阶段 3 完成
2026-11-07 18:44:08 +08:00
admin 0e968ed5ce feat(chain): GmSSL 真 TLCP 握手与 TA 密钥分级,主门禁扩到 16 条
- 纠正国密链提交方法为自有 sendTransaction(4 参),eth_sendRawTransaction 在国密链禁用
- 新增 GmSSL 3.2.0 环回真 TLCP 握手自测:双证书、国密套件、应用数据往返、负向期望拒绝特征
- 落地 build_optee.sh TA 签名密钥三级硬拒绝,缺 SDK 时判据仍可被执行到
- 新增 FISCO 真机对拍契约:缺环境显式 SKIPPED 并逐项列出,环境齐备只报 NEEDS_IMPL
- 同步 catalog 守卫 / 集成文档 / CLAUDE.md,主门禁 15 条改为 16 条
2026-11-07 18:23:46 +08:00
admin 851e899b3c feat(chain): 国密治理形状与 guest 产物边界,主门禁扩到 15 条
- mpc-chain 新增 sm2/tlcp/policy:OpenSSL 软件 SM2 真签名、distid 三重对齐、
  TLCP 双证书 fail-closed 准入、硬规则进合约与 OPA 业务策略分域
- signer 增加安全档与 SignerPolicy(无默认值);生产策略一律拒软件签名器
- mpc chain 扩到 keygen/sign/align/tlcp/governance;flush --transport 必填
- mpc-cli 按 control-plane feature + target 切分:musl guest 静态产物不再链接
  OpenSSL/axum/reqwest,交叉编译必须 --no-default-features,编译期守卫硬拒绝
- 新增 tools/check-guest-artifact.py(依赖树/守卫/ELF 三层探针)与
  selftest-chain-gm.py;第 4 条接产物探针,第 14 条 47 判据、第 15 条 33 判据
- catalog 守卫与 CLAUDE.md / README / ZYNQ / 真机 README / 方案文档同步

完整 ./tools/ci.sh 15 条全绿。诚实边界不变:flush 仍发规范字节、不是已签名交易,
RLP / Tongsuo TLCP FFI / 硬件模组 provider / 真机建链未落地。
2026-11-07 17:42:24 +08:00
admin b15f0268bf feat(chain): 阶段 2 链上层形状层,新增主门禁第 14 条
- 新增 crates/mpc-chain:链上对象规范编码、SM3 摘要、FISCO BCOS 3.x eth_* JSON-RPC 客户端、幂等 outbox、成员准入、Signer 形状层
- 新增 mpc chain digest|submit|flush|status|admit 命令族
- 新增 tools/selftest-chain.py 桩自测(44 判据),主门禁 13 → 14 条
- 同步 catalog 守卫、domain 域分隔、CLAUDE.md、INTEGRATION_ANALYSIS.md

边界:ModuleSigner / RLP / 国密模组 provider 未落地;flush 发的是规范字节而非已签名交易,未配置签名器即拒绝,本期不宣称能上链。
2026-11-07 16:48:08 +08:00
admin 362db1d7a8 feat(tee): 两层控制面、宿主控制面独立 crate 与会话级链路层
- 拆出 crates/mpc-hostd(axum/tokio/reqwest),mpc-tee 保持零 crates.io 依赖,保住 OP-TEE SDK 离线交叉编译
- mpc-hostd 提供 e2b 兼容 API + TeeRuntime + /attestation 四布尔分开报;站点侧 session_admit 产 TeeRequirement
- 新增 mpc link plan|verdict|credential:EasyTier 三档中继策略,凭据由管理节点签发,框架不生成
- OP-TEE 补跨设备/跨重启验证编排与判据逻辑自测,真机验收延后
- 主门禁 11→13 条:新增 hostd 端到端(33 判据)与链路层桩自测(53 判据)
- 同步 catalog 守卫测试、CLAUDE.md、INTEGRATION_ANALYSIS.md 与 OPTEE_VERIF_PLAN.md
2026-11-07 16:10:42 +08:00
admin e839a972c0 feat(tee): 接入 AMD SEV-SNP 芯片验签,双平台「先验证明才给密钥」全部真机跑通
## 改了什么

- **SNP 芯片签名验签闭环**:新增 `snp_collect.rs`(SNP_GET_EXT_REPORT ioctl
  + GHCB 切分)、`snp-verify-attestation.sh`(VCEK 走 AMD KDS)、
  `selftest-snp-verify.py`(正 1 + 负 8),进主闸门第 10 条。
- **框架侧补 `mpc.tee.platform`**:`tee plan` 现在告诉 guest 用哪个平台采证明。
- **KBS 补独立 `--pin`**:`MPC_KBS_PIN` 与 `--measurement` 解耦,缺省回落,
  既有部署行为不变 —— 这是「度量 pin 那一关」唯一能被单独测到的姿势。
- **guest stdout 修复**:init 开头 mknod 真 `/dev/console` + `exec > ... 2>&1`;
  `run-guest.py` 加 `MPC_TEE_SERIAL_LOG` 换 chardev file 落盘。
- **负向矩阵**:新增 `snp-attest-negative.sh`(6 条),判据全部收紧到该关独有文案。
- **KBS 就绪判据**:`kbs-net.sh` 从「进程存活」改成「端口进 LISTEN」。
- **文档**:`TEE_DIRECT_LAUNCH.md` 新增 SNP 整节 + bug 1~9;
  `TEE_OCI_PATH.md` 补 SNP 侧与负向判据唯一性;新增 `INTEGRATION_ANALYSIS.md`
  与 `OPTEE_VERIF_PLAN.md`;`ci.sh` 加 no_std 双守、TA UUID 对拍、SNP 自测。

## 什么影响

- 真机(海光 CSV `192.168.1.102` + AMD SNP `192.168.1.7`)**双向跑通**,
  两端用同一份 Rust 判定代码。
- SNP 正向 e2e 7/7、负向 6/6 全部真拒在各自关卡;`tools/ci.sh` 十条全绿。
- 三处真 bug 已修:guest stdout 全丢(`/dev/console` 是普通文件 +
  `-nographic`/`-serial stdio` 抢 stdio)、`MPC_KBS_PIN` 接口缺口、
  负向判据不唯一(兜底分支导致假绿)。
- 边界不变:`attest-mkbundle` 仍是合成件,过不了芯片验签(仅自测用)。
2026-11-07 12:47:22 +08:00
admin 0326311888 feat(tee): KBS 从 stub 变为真判定,打通「先验证明,才给密钥」闭环
密钥下发从「问就给」改成「先出证明,才给密钥」:

- 新增 crates/mpc-tee/src/bundle.rs:唯一的证明判定实现,判定五关
  全部 fail-closed(平台一致+布局解析 / 重算绑定值挡重放 / 度量 pin /
  TCB 门槛 / 芯片签名)。验证方与放行方共用同一份,口径不分叉。
- 新增 crates/mpc-tee/src/collect.rs:guest 内从芯片驱动采真报告
  (CSV ioctl 0xC0104401;SNP 证书链需单独 ioctl,显式 Unsupported)。
- 新增 crates/mpc-core/src/sm3.rs:CSV launch 度量与挑战哈希用。
- deploy/tee/kbs/serve.py:新增 /kbs/v0/attestation,判定调
  `mpc tee attest-check`(Rust),Python 只搬字节看退出码。
  严格模式默认开,缺判定器或缺验签器一律拒发。
- guest/init.sh:去掉 offline-demo 兜底,改「采集证明 → POST 换 token
  → 凭 token 取钥」。
- 新增 CLI 子命令 tee attest-collect/attest-check/attest-mkbundle/attest-post。

修掉多个真 bug:

- GNU coreutils `tee` 把非选项参数当文件名创建且成功退出,判定退化成
  「不报错就算过」就是假绿 → KBS 加五道闸(判定器校验 / 独立工作目录 /
  stdin=DEVNULL / 超时上限 / 输出必须是含 ok+verdict 的判定结论)。
- Rust TcpStream::connect 无超时,对端不可达时挂 ~130s,guest 表现为
  卡死 → 新增 connect_with_timeout(10s)。
- guest 显式等 carrier 就绪(LOWER_UP),消除 attest-post 偶发超时。
- tap 名两处各记一份导致「配置全对但连不上」→ 统一兜底。
- iproute2 接口名上限 15 字符,超长报误导性的 policy validation → 预检。
- argparse 吞「以 - 开头的值」→ 证书链目录改用独立选项 --chain-dir。
- 跨目标编译盲区:#[cfg(target_os="linux")] 代码在宿主目标被整段排除,
  宿主零告警但交叉编译出告警 → CI 新增跨目标零告警闸门。
- lint-shell-vars.py 只扫 deploy/tee,对 tools/ci.sh 自身无感 → 扩到
  tools;并跳过纯注释行(shell 不解析注释,对教学示例持续误报会让人
  习惯性忽略闸门输出 = 假绿的温床)。

真机(海光 CSV 192.168.1.102):正向 7/7 全绿,负向 6/6 全部 fail-closed。
CI 扩到九条,全部通过。
2026-11-07 08:46:24 +08:00
admin 5c68564b6c feat(tee): 打通 OCI 镜像流水线与在线 KBC 密钥下发,补齐运行期完整性链
交付两件此前欠着的事,并在真机(192.168.1.102 海光 CSV)端到端跑通:
1. OCI 镜像流水线 build → verify → pack 三步在真机跑通,manifest digest
   作 SessionBinding.code_measurement 钉进会话绑定值。
2. PSK / seed / root-key 不再内置 initrd,改由 guest 内 mpc tee kbs-get
   按会话从宿主 KBS 取回(key_source=kbs)。

★ 修掉两个框架级缺陷(都是「校验通过 ≠ 校验的是对的东西」):
- guest 侧活文件链:旧 layers.sha256 只覆盖 blobs/ 下的惰性证据副本,
  真正执行的 /init、/mpc 不在范围内 —— 真机改 /mpc 一个字节照样打印
  oci_layers: verified。现改为从 cmdline 的 PIN 逐跳推导到活文件逐个校验,
  失败时点名具体文件。
- 流水线侧自证:pack 打完 initrd 必须回读核对内嵌 digest / 清单 /
  manifest.json,不符即失败。缺前者不能保证「送进 guest 的是这个镜像」,
  缺后者不能保证「guest 跑的是这个镜像里的活内容」,两者缺一不可。

新增真机可复现资产(deploy/tee/):
- oci/oci-image.py:rootfs_state_from_layers() 直接从各层 tar 字节算活
  rootfs 状态,不解包(免 mknod 权限,build 与 pack 共用同一函数防分叉);
  build 扫 base rootfs 里的密钥物料,命中即退出码 3。
- oci/selftest-chain.py:完整性链本地回归,含「旧口径对 /mpc 篡改完全
  无感」的反向断言。
- real-machine/kbc-e2e.sh / kbc-negative.sh / kbs-net.sh:正向全链路与
  5 条 fail-closed 负向矩阵、tap + bridge 出网链路。
- real-machine/tamper-initrd.py:精确解析 newc cpio 改目标文件数据区。
- real-machine/guest-syntax-check.sh:解包 initrd 后用解出来的 musl loader
  跑解出来的 busybox,完全模拟 guest 内 ash 解析环境。
- real-machine/lint-shell-vars.py:shell 引号与变量名三类陷阱闸门。

框架侧:PlatformProfile.kbc 拆成 allowed_kbc(支持哪些)与 kbc(缺省);
kbs_endpoint 改由节点描述给出,现场部署事实与代码分离。

真机实测:正向 KBC_E2E_OK(key_source=kbs),负向 5/5 全 fail-closed。
闸门扩到六条:ci.sh 新增 shell 引号/变量名卫生与 OCI 完整性链自测。
2026-11-07 02:07:28 +08:00
admin 14eb9065de feat(tee): 接入海光 CSV 真实芯片验签,打通报告捕获到验签的端到端闭环
海光 CSV 报告的 user_data / mnonce / measure / pek_cert / sn 被 anonce
按 u32 数组逐个异或混淆,此前框架按明文比对,永远对不上。现按厂商 SDK
(csv_sdk/csv_status.c)规则还原(deobfuscate_csv_field),SNP 走明文分支。

另修两个真实 CLI bug:
- 全局 --report text|json 与 `tee verify --report <文件>` 撞名,导致
  tee verify 永远拿不到文件路径;改为上下文感知。
- tee verify 的 --tcb 默认 0,而 tee plan 用节点描述里的 tcb 算绑定值,
  二者不一致时报「user_data 与本次会话绑定不一致(疑似重放报告)」,
  把实现问题误导成安全事件。现给 tee verify 加 --node,site / measurement /
  tcb / platform 默认与 tee plan 同源,平台冲突直接拒绝。

新增真机可复现资产(deploy/tee/real-machine/):
- csv-attest-request.c:支持自定义挑战值取报告,自带 SM3 实现
  (厂商 get-attestation 把挑战值写死成 "user data",无法与会话绑定)
- csv-report-restore.py:还原 anonce 混淆字段
- csv-verify-attestation.sh:官方验签器 wrapper,堵住退出码恒 0、
  报告路径写死、离线证书 fallback 同目录、截断报告 fail-open 四个坑
- capture-csv-report.sh / verify-csv-report-e2e.sh / attest-init.sh /
  build-attest-initrd.sh

真机(192.168.1.102)实测:捕获 2548 字节真实报告,官方验签器完成
芯片签名与 hrk→hsk→cek→pek 全链验证,框架校验通过(structure_ok /
bound_ok / chip=已验证)。篡改 user_data、篡改 sig1、截断报告三种负向
场景全部 fail-closed。
2026-11-06 21:28:41 +08:00
admin eba460b4ff fix(tee): 按海光厂商 SDK 实测修正 CSV 报告总长 4096→2548
- 在 192.168.1.102 用海光厂商 SDK 头文件 /opt/hygon/csv/attestation/csv_status.h 经本机 gcc offsetof/sizeof 实测确认 struct csv_attestation_report:user_data@0x40、measure@0x90(32B SM3)、policy@0xB0、sig1@0xC0(144B),sizeof=2548,且结构体内无 version 字段。\n- 修正真 bug:CSV_REPORT_LEN / hygon_csv_layout().total_len 原写 4096(那是 hypercall/mmap 页大小),而 get-attestation 实际写出 sizeof(struct)=2548,原长度下限会拒掉每一份真实 CSV 报告;现改为 2548,4096 页填充仍按下限接受。\n- 新增回归测试 csv_real_size_accepted_and_page_padding_tolerated(2548 接受 / 2547 拒绝 / 4096 页填充接受),mpc-tee 单测 87→88。\n- docs/TEE_DIRECT_LAUNCH.md 同步表与说明,并如实标注「真实 CSV 报告 live 捕获未做(.102 主机无 /dev/csv-guest,须在 guest 内 ioctl 取)」。\n- 验证:./tools/ci.sh 四道全绿。
2026-11-06 20:08:23 +08:00
admin 25c3baf880 feat(tee): 泛化 attestation 报告解析,覆盖海光 CSV(SEV 派生)
- verify.rs:新增 ReportLayout + snp_layout()/hygon_csv_layout(),parse_sev_like_report 由 SNP 与 CSV 共用同一套解析逻辑(绑定原语通用、字节布局参数化);HygonCsv 不再走「长度≥64 即过」兜底,按 CSV 固件报告(4096B/user_data@0x40/measure 32B SM3/sig1@0xC0 144B)真实解析并校验 user_data 与会话绑定一致。
- platform.rs:模块注释说明 CSV 是 SEV 派生、证明原语通用、字节布局独立。
- docs/TEE_DIRECT_LAUNCH.md:新增「海光 CSV = 国产版 SEV」节,更正过度保守的兜底分支;更新「仍未交付」段。
- 测试:mpc-tee 单测 86→87,新增 CSV 报告 fixture 与绑定校验;./tools/ci.sh 四道全绿。
- 影响:海光证明报告结构校验与 AMD 等价(均如实区分结构与芯片验签);CSV 报告偏移源自 rats-tls csv.h,需在 192.168.1.102 用 csv-guest-tool 复核(verify.rs 留 TODO)。
2026-11-06 19:45:09 +08:00
admin 5dec915185 feat(tee): KBS 客户端 + 证明结构校验,OCI 打包与真机编排资产入仓
- mpc-tee 新增 kbs.rs(最小 HTTP/1.1 KBS 客户端 + fail-closed 校验 + KbsKeySource 替代内置 PSK)、verify.rs(SNP 报告结构解析 + 可插拔外部芯片验签器 + verify_attestation 显式区分「芯片签名未验证」)。
- mpc-cli 新增 mpc tee verify / mpc tee kbs-get 子命令。
- catalog.rs 补 verify/kbs 模块到 TEE 直接调度段并加回归断言(清单铁律)。
- deploy/tee 新增 oci/(分层镜像构建)、kbs/(serve stub)、guest/(init)、real-machine/(跨机双 guest 编排);docs/TEE_OCI_PATH.md 记录 Kata 实测复核(仅 AMD 有、海光无且不支持 CSV,不引入)与 e2b 远程调度接口参考。
- 影响:密钥经 KBS 注入(不再内置明文 PSK),证明结论如实区分结构与芯片验签;远程调度走 OCI digest + 框架选节点,不引入 Kata/e2b 依赖。
- 测试:./tools/ci.sh 四道全绿;mpc-tee 单测 73→86。
2026-11-06 19:33:53 +08:00
admin 783761cb26 feat(tee): 框架直接调度 AMD SEV-SNP / 海光 CSV,真机端到端跑通
mpc-tee 新增 platform/session/schedule(no_std) 与 guest(std):平台能力表、会话绑定证明、fail-closed 准入、qemu LaunchSpec、guest 内 Tee 实现。CLI 加 tee paths / tee plan,catalog 与 domain 同步清单与常量(非 breaking)。deploy/tee 提供宿主预检与直接启动脚本,docs/TEE_DIRECT_LAUNCH.md 记录分层与真机真值。真机校正:confidential-guest-support、kernel-hashes=on + pflash 固件(CSV)、cbitpos 51/47、console=ttyS0。影响:TEE 调度不经容器编排层;SNP/CSV guest 跨物理机密文会话已实测通过。
2026-11-06 18:42:27 +08:00
admin 535c63a690 refactor(domain): 协议域分隔常量统一到 mpc-core::domain,nax → mpc
ci / gate (push) Waiting to run
- 20 个 KDF/HMAC/PSI/TEE/分片/作业种子标签全量换 mpc 前缀,集中到 mpc-core::domain 唯一真相源,业务代码不再写裸字符串
- 等长替换,消息格式与长度不变;mpc-tee 的 COMMIT/EGRESS 消息长度改由 label.len() 计算,避免写死数字漂移
- 不兼容变更:会话密钥、TEE 封存 blob、PSI 盲化点、缓存指纹、分片流全部换钥,参与方须同步升级,旧 blob/缓存/离线物料作废;不提供旧 nax 标签兼容读取
- README/CLAUDE/OPT_PLAN 重写兼容约定与迁移清单;仍保留 refs/nax 路径与 Python 包名 import nax(独立只读仓库真实路径)
- golden 向量(ring/paillier/zkp)是纯数学、check_psi.py 只比语义,均不依赖这些标签,无需重生成
- CI 三条闸门全绿(全量测试 / -Dwarnings / mpc-core no_std)
2026-11-05 15:29:33 +08:00
admin e01c7f9419 docs: 按新定位重写中文描述,修复参考实现路径误改
- 中文定位从「Rust 重写 Python 算术执行引擎」改为「多方数据协同、数据不出域的安全计算框架」;README/CLAUDE/ARCHITECTURE/GAP_PLAN 同步,沿革小节写明新旧语义差别
- 修复机械替换引入的功能 bug:gen_golden.py / check_psi.py / bench_numpy.py 的 refs/mpc/mpc 路径改回 refs/nax/nax(参考实现真实目录,CI 不跑这些脚本故未暴露)
- 恢复 Python 参考实现包名 import nax;mpc-python 统一改称「Python 参考实现」;远端仓库描述同步
2026-11-05 15:17:28 +08:00
admin f36217c36a docs: 补命名沿革与兼容约定,明确 nax 字面量的保留边界
- README 新增沿革小节:改名映射、三个 tag、两类刻意保留项、部署迁移清单
- CLAUDE.md 加硬约束,避免后续把协议域分隔常量与 refs/nax 当漏改清理
- OPT_PLAN 标注握手 label 沿用历史域分隔常量
2026-11-05 15:11:59 +08:00
admin 54781b3f83 refactor: 项目改名 ssw-mpc,crate 统一到 mpc-* 前缀
ci / gate (push) Waiting to run
- 项目与文档标题:nax-rs → ssw-mpc(尚数网-多方安全计算),二进制 nax → mpc
- 18 个 crate 及目录 nax-* → mpc-*,Rust 引用 nax_* → mpc_*
- 环境变量、C 符号、构建/部署脚本:NAX_* → MPC_*、libnax_ray.so → libmpc_ray.so
- 保留协议域分隔常量与 refs/nax 参考实现路径,维持 golden 向量与历史数据兼容
- 新增 [profile.dev] incremental=false
2026-11-05 15:06:12 +08:00
rong 89bdef38fb docs(opt): 冷缓存与不缓存同价的说法按实测收准(差 0~23%,在漂移噪声内)
ci / gate (push) Waiting to run
2026-11-02 14:16:01 +08:00
rong f5a6424ca6 docs: OPT_PLAN 增 R6/R7/R8;IR §3.4 补两组读数并标注漂移
- R6 记下跨会话盲化缓存:三档实测表、5 条验收用例(含反向守卫)、
  三条代价、以及两件**刻意没做**的事(落盘、接进纵向 LR)。
- R7 是**量过但没做**的一条:换 Ristretto 约 1.55×,Edwards 约 1.75×。
  附三列实测表,并记下「映射到点的钱会吃掉窗口法收益」这个预判被推翻 ——
  本仓第三次同类失误,共同点都是只估了一边。
- R8 记录基准漂移:同一份代码同一台机,1024 行建会话 466 → 990 ms、
  每次迭代 10.65 → 79.73 ms,且两个倍率不同(说明降的是本地算术的时钟)。
  约定:本机毫秒数只在同一次运行内横向比,跨次跨机一律引比值。
- IR §3.4 加复测对照表,并把「建会话是最该优化项」这条指到 R6 的结果。
2026-11-02 14:15:01 +08:00
rong 0c6026b01e docs(ir): §3.4 轮数↔墙钟;nax plan 的口径从「上界」改成「实测相等」
- §3.4 两张表:计划 13 轮 == 线上 13 个往返(24 帧);本机 64/256/1024 行的
  建会话、每次迭代、每轮纯等待。
- 结论:环回上 13 轮只占一次迭代的 8%,本地计算占 92%;跨机房(RTT 20 ms)
  才轮到轮数当瓶颈。另外建会话(PSI 的 EC 运算)在小样本下比整个训练还贵。
- §6 把「上界」的说法收窄:只有「同阶段既有 mul 又有独立 open」的图会虚高,
  纵向 LR 的图没有独立 open,那一侧是精确的。
- `nax plan` 的口径行同步 —— 数字上的每个断言现在都指得到一条对账测试。
2026-11-02 12:48:06 +08:00
rong 0204e1fb21 docs(ir): 补多项式深度表与结合顺序的结论
- §3 的 degree 表加「深度 `⌈log₂ d⌉`」与「sigmoid 块往返」两行,
  说明多项式块是 `2·⌈log₂ d⌉ + 1`,并点明 degree 5 与 7 同价。
- 新增 §3.1:三条求值顺序的实测对比(7 / 8 / 9),结论是这条路没有杠杆。
- §5 变异表加两行反向守卫(改坏求幂顺序必红、改坏截断粒度必须不红),
  §6 把「换顺序」从待办里划掉。
2026-11-02 12:13:46 +08:00
rong 279ae5e94c docs: 同步树形归约后的轮数(5 行 45 / 1000 行 115)与用例数
影响:只改口径,不动代码。

- 掩码聚合 55 → 45 轮;新增 1000 行/10000 行的对照表(对数增长)
- §4 净收益改成三笔:上图 / 上批量 / 换算法,第三笔才是数量级
- §5 变异表补 3 条算法层守卫,重测批量三条的数字(90/45、49/45)
- 用例数 469 → 471(nax-sql 50 → 52)
2026-11-02 11:39:51 +08:00
rong 65e199c406 feat(sql): MIN/MAX 换树形归约,轮数从线性变对数
影响:`MIN`/`MAX` 的往返数不再随行数线性增长,1000 行的五聚合查询从
约 9995 轮降到 115 轮。**这是本仓第一次改增长阶,不是压常数因子。**

- `secure_graph::minmax` 从「best 与每一行比一次」改成逐层两两归约:
  叶子层是 `len` 个本地 slice,每层 9 轮比较 + 1 轮选择 = 10 轮,
  深度 ⌈log₂ len⌉。奇数个元素时最后一个轮空(补哑元素要多一次比较)。
- 每行翻一倍正好 +10 轮:4/8/16/32/64/128/256 行 → 23/33/43/53/63/73/83。
- 5 行 55 → 45 轮;1000 行 ~9995 → 115;10000 行 ~99995 → 155。

数值上等价:min/max 可结合,全程只有 cmp + select、不经过 truncate,
换结合顺序不引入任何差。`where_aggregate_matches_legacy_for_every_cmp_op`
仍要求 `MIN`/`MAX` 与手写序列逐位相同。

顺带修 `nax-cli` 的阶段表:本地算子列改成同名折叠(`slice ×2000`)。
1000 行时原来会把上千个 slice 逐个列出来,表格 300 KB 且不可读;
折叠之后树的结构反而一眼可见(`cmp ×1000 → ×500 → ×250 → ×124 → …`)。

修正一处自己写错的论断:`minmax` 原注释与 `docs/IR.md` 说「树形不省轮数,
因为串行依赖不变」—— 深度不同,`行数−1` vs `⌈log₂行数⌉`,而且同层比较
互不依赖可以合批。文档已改,另加 2 条测试钉住增长阶与非 2 的幂的正确性。

验证:471 用例全绿(+2),-Dwarnings 零告警,no_std 守线过,rustfmt 无 diff。
变异 3 条全部按预期红后还原:退回线性链(4→8 行多 40 轮)、落单元素不轮空
(n=3 MAX 错)、比较方向取反(n=2 MIN 错)。
2026-11-02 11:39:43 +08:00
rong b5bfb86581 docs: 同步批量之后的轮数(LR 13 轮 / SQL 55 轮 / 分组 13 轮)与用例数
影响:只改口径与描述,不动代码。

- LR 17 → 13 轮,degree 3/5/7/9 → 11/13/13/15(5 与 7 同价)
- 掩码聚合 115 → 55 轮(掩码 11 + 聚合 44),且与实测突发数逐轮相等
- GROUP BY 8 组:逐组 13、整数码 12(组数不再影响轮数)
- 用例数 462 → 469(nax-vault 30、nax-ir 39、nax-sql 50)
- README 能力表补批量路径(`mul_batch` / `truncate_batch` / `bit_lt_batch`)
2026-11-01 20:42:52 +08:00
rong 1dd4841368 feat(vault): 同阶段批量——k 个乘 1 个往返,k 次比较 9 轮封顶
影响:轮数模型与执行器一起改,SQL 侧的轮数掉一个数量级(不是靠换算法)。

`nax-vault` 新增三个协议原语,判据是「与逐次逐位相同」:

- `mul_batch` —— k 个 Beaver 乘 **1 个往返**(2k 个 d/e 一起发)。各对长度可
  以不同;离线三元组按序取,所有方必须同序调用。
- `bit_lt_batch` —— k 次比较 **9 轮封顶**:批量 open(1) + Hillis–Steele 六层
  扫描(6) + `z = p·d`(1) + `t·borrow`(1)。每一层把 k 个乘合成一个往返,所以
  轮数与 k 无关(k=1 与逐个同价 9 轮,k=5 时 45 → 9)。
- `truncate_batch` —— k 次截断 1 个往返。`cs` 只在 0 号出现这条铁律照旧;
  结果**不**逐位相同(随机舍入取决于取到哪对离线物料),只保证落在预算内。

`nax-ir`:`Exec` 加 `sec_mul_products_batch` / `sec_cmp_batch` /
`sec_trunc_batch`(默认实现是逐个循环,明文档执行器不必重写);`run` 的阶段内
顺序改为「本地 → 乘批 → 截断批 → 其余 → 比较批 → open 批」,依据是
`base` 相同 ⇒ 互不依赖;`compile` 的阶段耗时改成四项常数:

    (有乘类?1) + (有截断类?1) + (有open?1) + (有cmp?9) + Σ其余 cost

`Mul` 算「乘+截断」两段;`MulRaw` / `Select` 只算乘段 —— **`Select` 不截断**,
第一版把它记进截断类,5 个聚合的计划因此比实测多 5 轮(60 vs 55)。

实测(`nax plan` / `nax sql-plan` 现算):

- 纵向 LR 一次迭代 17 → **13** 轮;degree 3/5/7/9 → 11/13/13/15(5 与 7 同价)
- `[COUNT,SUM,AVG,MIN,MAX]` 5 行 115 → **55**(掩码 11 + 聚合 44)
- `GROUP BY` 8 组 162 → **13**(整数码 12):**组数不再影响轮数**
- `MIN`/`MAX` 两条链在同一层撞进同一阶段,比较天然合批(8 次比较 36 轮)

新增 7 条测试:`nax-vault` 4 条(批量与逐次的逐位一致 + 往返数钉值)、
`nax-ir` 3 条(同阶段两个比较 9 轮 / 两个 select 1 轮 / Mul+MulRaw 2 轮)。

`nax-ml` 的迁移判据随之修订:帧序列不再逐帧相同(`SRSR` → `SSRR`),改成
「**帧数不变 + 往返数不增**」,数值预算(≤8 / ≤64 ULP)不变。

变异验证 5 条全部按预期红后还原。其中四条证明模型与执行器是两条独立的链:
只改编译期 → 计划 91 实测 55;只改执行器 → 计划 55 实测 91。

全量 469 用例通过 / 0 失败,`-Dwarnings` 零告警,`nax-core` no_std 守线过。
2026-11-01 20:42:44 +08:00
rong 903f14efb2 feat(sql): GROUP BY 走整数码前缀和,8 组 162 → 92 轮
影响:`secure_group_by` 新增 `GroupMode::IntegerCode` 路径,每组相等判断
(`bit_eq` = 两次 `bit_lt`,18 轮/组、串行累加)换成 `N+1` 个单调前缀
「码 ≤ g」,`COUNT` 取前缀位之和、`SUM` 取 `mul_raw(前缀位, 列)`,所有 `open`
落在同一阶段合成一次,**组内值在明文侧差分**,没有第二段图。默认仍是
`GroupMode::Exact`,语义不变。

实测(`nax sql-plan --rows 8 --aggs count,sum`):2 组 42→32、4 组 82→52、
8 组 162→92;每组建图成本约 20 → 11 轮。带 WHERE 的增量是「一次比较 + 一次
搬家乘」10~11 轮。

新增:

- `secure_graph::build_prefix_stage` —— 谓词 → 码搬家 → N+1 个前缀 → 累积和
- `secure_group_by_coded` / `secure_group_by_pred_coded`,`query_rounds` 收
  `GroupMode`,`nax sql-plan --group-mode coded`、`nax sql --group-mode coded`
- `crates/nax-sql/tests/coded.rs` 12 条:与 Exact 对拍(`COUNT`/`SUM` 逐位、
  `AVG` 相对 1e-4)、复合谓词、越界/非整数码契约、空组、k-匿名、单组、轮数钉值

三条契约(写进 `docs/IR.md` §3.3,不隐藏代价):分组码必须是整数(非整数落
到上方最近一组);不支持 MIN/MAX(前缀和还原不出极值,直接报错不降级);
越界码丢弃(与逐组比较一致,两端边界 `−0.5` / `N−0.5` 就是为它留的)。

WHERE 未命中行不逐组乘 `base`(`2N` 轮),而是把码搬到 `−1000·2^fxp` 让它在
差分中自动抵消。**第一版把 `−1000` 当 raw 用**:分组码列是 fxp 编码,
`0.5` 编出来是 `131072`,于是 `−1000` 比每个边界都小,全部行被算进每个前缀
(行数变全表、SUM 变全表之和且不报错)。改为按 `2^fxp` 缩放,`fxp > 40` 拒绝。

变异验证 4 条全部按预期变红后还原:停放值不缩放(2 红)、边界少 `−0.5`
(只有非整数码契约那条红,整数码下 `<g` 与 `<g+0.5` 等价)、累积和忘记差分
(7 红)。

全量 462 用例通过 / 0 失败,`-Dwarnings` 零告警,`nax-core` no_std 守线过。
2026-11-01 19:49:16 +08:00
rong c00ec0d0a5 docs: 补上 IR 一层、n 方能力矩阵与轮数口径
影响:文档不再手抄「几次 matmul_trunc」,轮数一律引用 `nax plan` / `nax sql-plan`
的实测输出,读文档的人能自己复现。

- 新增 `docs/IR.md`:算子往返表(mul/matmul=2、trunc/open=1、整数 scale=0)、
  定点尺度为什么挂在值上、阶段与轮数公式、两个消费者(nax-ml / nax-sql)的实测数字
- 新增 `docs/N_PARTY.md`:能力矩阵(每条结论都指得到测试名)、PSI 环协议代价、
  安全边界(`strict` 挡不住什么写清楚)
- `docs/ARCHITECTURE.md`:分层图补 `nax-ir` / `nax-ml` / `nax-sql`
- `docs/COMPARE_SECRETFLOW.md` §2.3 加修正块:原来说「nax 的 IR 就是 nax-sql 的
  AST」—— 前半句对(拒绝 XLA + Bazel + MLIR 那一套),后半句错:AST 回答不了
  「几个往返」,中间要过一层「谓词/聚合 → 协议动作」的降级
- `README.md` / `CLAUDE.md`:用例数 423 → 450、crate 分层与关键设计决策同步

修正一处过期数据:文档里「14 个算子 / 7 轮、`lr=2` 时 5 轮」是早期 demo 图
(线性梯度步、不含 sigmoid 多项式)的数,不是 `nax plan` 的输出。迁移之后
`cmd_plan` 直连 `VerticalLR::build_epoch`,实测是 33 算子 / 17 轮;degree 3/5/9
对应 11/13/19 轮,`--l2` 恰好 +1 轮。
2026-11-01 19:01:27 +08:00
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
rong d79048e690 test(n-party): n>2 从"代码看着对"变成"有测试守着",列交换扩到 n 方
影响:nax 的 n 方能力此前只有 open 和整数乘有测试,截断/矩阵乘/比较一律
只跑过两方 —— 而这三处恰好都碰公开值,两方写错只是数值翻倍,三方错成三倍,
代码一模一样、不报错。另外竖向列交换原语硬卡在两方。

- nax-vault 补 4 条三方测试:truncate(cs 只落 0 号)、mul_trunc、matmul_trunc、bit_lt;
  截断那条做过变异验证(把 `if my_idx == 0` 改成 `if true`,测试立刻失败)
- nax-sql 新增 exchange_split_columns_multi:n 方竖向列交换,两方版改为复用(去重收发逻辑)
- docs/N_PARTY.md:能力矩阵,每条"支持 n 方"都指到测试,每条"不支持"写明是协议限制还是没做
- nax-node 的 run_session 文档补一句 `+1` 在求和之内(结果 = Σ∏ + 元素个数),
  避免把正确结果当成"公开值加多了"去改代码

未做(协议限制,非本轮):n 方 PSI。两两求交 ≠ n 方求交,需环协议(O(n) 轮)
并新增中间集合帧;落地前依赖行对齐的纵向 LR / SQL JOIN 只能两方,已在启动时拒绝。
2026-11-01 12:49:27 +08:00
rong a00b32f2f5 feat(secure): 链路 AEAD 加密 + 熵源统一 + TEE seal 换成标准 ChaCha20-Poly1305
影响:跨机部署不再假设链路可被窃听(此前只有握手认证,分片与掩码差值明文传输);
TEE 密封格式从 v1 换到 v2,旧 blob 解不开但会明确失败而不是误解。

- nax-core 新增 aead / osrand:ChaCha20-Poly1305(复用 prg 的 core,RFC 8439 标准向量 + OpenSSL 交叉验证),OS 熵源拒绝时间戳降级
- nax-node 握手派生 c2s/s2c 双向会话密钥,帧走 AEAD;计数器严格对齐,重放与错向密钥均拒绝
- nax-tee 两处手拼 encrypt-then-MAC(optee/core、mock)收敛到 nax-core::aead:开销 44B→28B、版本进 AAD、删除已无用的 K_mac;重复的 HMAC/ct_eq 合并为 nax-core 单一实现
- nax-he 补 keygen_os(库函数不再 panic),确定性 keygen 保留给 golden 测试
- tools/ci.sh + .gitea/workflows/ci.yml:测试 / -Dwarnings / nax-core no_std 三条闸门
- bench_core:matmul、逐元素、AEAD、分片重建的可复现基准

设计取舍:帧加密自己实现而不引 crate —— nax-core 的依赖树必须为空才能编进 OP-TEE TA;
ChaCha20 复用 prg 里已有的 core,避免两套实现分叉。
2026-11-01 11:20:28 +08:00
rong 471289fe55 feat: 按 SecretFlow 对比结论补齐六条优化 + PostgreSQL 数据接入
影响
- 传输层不再"知道端口就能冒充":PSK 挑战-应答,未配置时显式告警
- 参与方参数不一致可归因(逐字段对表,不再只说"指纹不同")
- 长跑不再整表进内存:CSV 真流式,PG 可直连
- 所有子命令支持 --report json,stdout 只出结构化结果,诊断走 stderr
- 作业支持 DAG 与落盘状态,失败/跳过/重来可追溯
- 计算域抽象落地,dry_run 开关第一次有消费者

改动
- nax-core: 新增 hmac(HMAC-SHA256 / ct_eq / derive_labeled);pg 的 HMAC 改为委托,删重复实现
- nax-node: 新增 auth(REQ/ACK/OK,ctx 绑定双方序号与双 nonce,双 label 防回打)、entropy(只读 /dev/urandom,不降级)
- nax-proto: 新增 Op::Manifest,显式拼字节避开长度前缀错位
- nax-vault: exchange_manifest 比对版本/参与方/fxp/键值清单,三种差异分别点名
- nax-data: 新增 source(TableSource/Batch/CsvSource,流式与整表逐位一致);新增 pg 客户端(自研 wire、trust/md5/SCRAM、零外部依赖)
- nax-orch: 新增 plan(文本计划 + 拓扑校验)、state(append-only JSONL)、run_jobs;协议加 SKIP,单作业模式逐字不变;每作业派生种子避免 Beaver 三元组复用
- nax-runtime: 新增 device(Value/Device/Plain/Secret);域是数据属性,单方搬不回明文;非线性算子在密态域显式拒绝而不是给出错掩码
- nax-cli: 新增 report 模块(Cell/table/kv/note!)、selfcheck(含 TEE 签名)、pg(列类型摊开)、orch run|status
- tools/pg-dev: PGlite + PG-wire 壳、两方种子库、e2e.sh 20 条断言

设计(明确拒绝的方案)
- 设备抽象不做 eval(op) 分发:线性算子对加性分片天然透明,多一层间接只多一个没人用的入口;非线性算子要换协议,不是换指针
- DAG 计划用文本不用 JSON:现场手改要能报"第 2 行:不认识的指令 retries",而 serde_json 与单二进制目标冲突
- 端到端用 PGlite 而非系统 PostgreSQL:同一份源码编成 WASM,无需常驻服务

回归
- cargo test --workspace --features secure → 338 通过 / 0 失败
- cargo build --workspace --all-targets --features secure → 零代码告警
- cargo build -p nax-core --no-default-features → no_std 守线通过
- tools/pg-dev/e2e.sh 两轮真 TCP + 真 PSI + 真密态聚合,两方输出逐字段一致
2026-10-31 21:08:21 +08:00
rong df021dba0d feat(cli): nax sql-join 真两进程 JOIN×PSI×密态 SQL
影响:能敲一个命令在真 TCP 两进程里跑 PSI → 对齐 → 密态聚合 → reveal;
`--schema` 约定全局列序解决竖向切分里两方各持不同列的拼接问题。

- `nax sql-join` 子命令(需 --features secure):真 TCP 两进程,
  PSI → align_by_key → exchange_split_columns → 密态聚合。
- `--schema col1,col2,...`:全局列序,列交换后按 schema 槽位落位。
  **不是 mine + theirs 简单拼接** —— 后者两方拼出的顺序不同,谓词下标静默错位。
- 两个种子:psi_seed 每方不同(同种子 = ECDH 私钥相同,隐私破坏);
  vault_seed 两方一致(Beaver 物料派生)。CLI 从 (seed, site) 自动派生 psi_seed。
- `impl Transport for &mut T`:同一条 TCP 先 PSI 再 Vault 不用拆通道。
- 新增 4 测(真 TcpListener + TcpTransport)含变异检验:
  schema 落位换成拼接 → 3 条红。
- 更新 README、GAP_PLAN(产品口径缺口 ①②③ 已闭环)。
2026-10-30 18:32:43 +08:00
rong c97da57c5f feat(sql): JOIN × PSI 竖直接入密态 SQL
影响:两方各持半张表的纵向切分,现在能 PSI 求交后在密态下跑 join 后的
COUNT/SUM/GROUP BY,结果与明文引擎的等价 JOIN 逐值一致;`nax-sql` 库依赖闭包不变。

- `secure::exchange_split_columns`:各方向对端送出本方每列一片,再收齐对端每列一片;
  先全发再全收(发一个收一个在缓冲撑满时会双向死锁),入口校验各列行数一致。
- `secure::secure_aggregate_all`:无 WHERE 聚合,掩码取 `vault.bit_one`,不新增公开常量。
- 新增 `tests/join_psi.rs`(6 测):PSI → 按键字节序排序对齐 → 密态聚合,对拍明文
  `Engine` 的 `bank JOIN shop ON bank.id = shop.uid`;覆盖 COUNT/SUM、跨方复合 WHERE、
  GROUP BY、对齐不变式、重复键拒绝、空交集拒绝。
- PSI 与行对齐留在调用方:`nax-node`/`nax-psi` 只作 dev-dependency,测试目标挂
  `required-features = ["secure"]`,默认构建不拉密码学依赖(workspace 218 测,
  `-p nax-sql --features secure` 27 测)。
- 明确不做一对多 join:PSI 去重只给一个下标,纵向对齐表达不了笛卡尔展开,本方键重复即报错。
2026-10-30 17:32:24 +08:00
rong 1e84d681c2 feat(sql): 密态 IN / NOT IN(脱糖 OR 等式)
Pred 加 In{col, values, negated}:逐个 bit_eq 后 bit_or,negated 再 bit_not。
对拍明文引擎的 x IN (100,250,500) 与 NOT IN。

nax-sql --features secure 21 测,workspace 218 全绿、零警告。
2026-10-30 16:51:32 +08:00