Files
ssw-mpc/tools/ci.sh
T
admin 4a750785f8 feat(cluster): pending 证明超时回收(默认 900 秒,可配可禁用)
- reconciler:可注入时钟 + 唯一判定 pending_timed_out(saturating_sub 防回拨);超时真调 destroy、释放容量、/report 留带原因失败、本轮不重建(下轮按期望态重试)

- 修真 bug:PendingSession.created_at 曾写 now_secs(),与判定时钟分叉 ⇒ 超时永不触发,单测直接抓到

- ControlPlaneConfig / CLI:--pending-timeout SECS(0=显式禁用),默认值只有 DEFAULT_PENDING_TIMEOUT_SECS 一份常量;help 数字由守卫测试对拍

- 新增 8 个构造用例 + 跨文件判据自测 16 条 / 破坏实验 15 条,并入主门禁第 25 条(分母仍 25)

- 文档:ARCH §1.6/§8、FINDINGS §12、README/INDEX/CLAUDE/真机 README/env 样例/MEMORY 同步;HTML 重新生成并校验

- 诚实边界:未做真机验证、真机 musl 产物未更新、超时后下一轮重试不是永久隔离
2026-11-09 21:22:53 +08:00

604 lines
38 KiB
Bash
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env bash
#
# 回归闸门:CI 与本地跑的是**同一份**,避免「CI 挂了、本地不知道怎么复现」。
#
# 守的四条就是 CLAUDE.md 里的铁律:
# 1. 全量测试必须带 --features secure(不带会漏掉 36 条,其中曾有坏的)
# 2. 零 rustc 告警(-Dwarnings,warning 直接变 error)
# 3. mpc-core 与 mpc-tee 都必须能 no_std 编译(TEE / armv7 那条路;
# OP-TEE 的 TA 就是按 default-features = false 构建的)
# 3b. TA UUID 的五处硬编码必须一致(三处 Rust + 两个 shell 脚本)
# (漂移的症状是 TA 找不到,且在独立通道里才暴露 —— 太晚)
# 4. 跨目标(x86_64-linux-musl)必须零告警 —— Linux 专属代码在宿主
# 目标下整段被排除,宿主编译发现不了它的 unused 之类的问题;
# 同时 guest 静态产物不许链接宿主控制面(openssl/axum/reqwest),
# 必须 --no-default-features,并由产物探针验标识串
# 5. 12 个示例必须跑得通且断言全绿(否则三个月后就是一批编译不过的摆设)
# 6. shell 脚本里不能有「变量后紧跟非 ASCII 字符」/「双引号串里的反引号」
# /「双引号串里未转义的双引号」三类引号与变量陷阱
# 7. OCI 运行期完整性链自测必须全过(篡改活文件必须能被发现)
# 8. KBS「先验证明才下发」必须自证:正向路径能走通,拒绝路径必须拒
# (判定器被顶替 / 输出不是判定结论时必须拒,防假绿)
# 9. guest 脚本必须在 ash 上语法正确(bash -n 通过 ≠ ash 能解析)
# 10. 芯片验签器必须正负向都对(假绿 = 密钥发给不该拿的人)
# SNP 与 CSV 两个平台各一份:CSV 侧 2026-11-07 真机探索补上,
# 并因此挖出两个真 bug(官方 SM2 签名不覆盖 MAC;
# 官方验签器缺证书会联网下载 ⇒ 链验证信任材料形同虚设)。
# 11. OP-TEE 判据逻辑必须正负向都对(判据错了 = 验证结论是错的;
# 而那两条验证只能在有 SDK 的机器上跑,判据不进主门禁就永远没被执行过)
# 12. 宿主控制面 mpc-hostd 必须端到端自测(e2b 兼容面 + /attestation 四布尔
# + 实例真回收 —— 这三条失效都是静默的:形状不对 SDK 才炸,
# 四布尔合并成 ok 会把「没验签」说成「验证通过」,
# 「状态改了但进程还在」是假回收。
# 协议层由 axum/hyper 承担,判据验的是**我们的契约**:
# 重复 Content-Length 带期望特征、chunked 拒绝、连续 20 次响应体完整)
# ★ 另:mpc-tee 会被拷进 OP-TEE SDK 离线交叉编译,第 3 条 no_std 双守
# 之外还要保证它零 crates.io 依赖;HTTP 依赖只许待在 mpc-hostd。
# 13. 会话级链路层(EasyTier)端到端自测(argv 漏 --secure-mode 之类全静默)
# 14. 链上层 mpc-chain 端到端自测(幂等 / fail-open / JSON-RPC 200≠成功)
# 15. 国密签名 / distid 对齐 / TLCP 准入 / 治理形状自测
# (★ 系统 openssl 独立验签,不许 Rust 自签自验)
# 16. GmSSL 真 TLCP 握手 / TA 密钥分级 / FISCO 真机对拍契约
# 17. 阶段 3 OPA bundle 签发 / 真判定 / decision 存证(undefined 当拒绝)
# 18. TLCP 进程通道环回实证(只到 LoopbackReachable,绝不宣称链上通道已通)
# 19. 真 TEE 双 guest 会话判据自测(★ 测判据逻辑,不是真机)
# 20. 真 TEE 证明门控判据自测(★ 必须与 19 分开:两者互不蕴含)
# 21. 国密链真交易编码 / sendTransaction 判据自测(TARS + r||s||pub + 幂等)
# 22. 国密链真合约部署 / 调用 / 读回 / 负向矩阵自测(缺环境显式 SKIPPED)
# 23. SA 扩展模式端到端自测 —— ★ VM 拿不到 K_root 这条边界必须被钉死:
# 破了它,Beaver 三元组全部可预测 ⇒ 密态乘法隐私性归零,
# 而症状是「不报错、不崩溃、结果数值也对」。每条否定判据都带期望特征,
# 每条否定都配正向对照(防假绿)。
# 24. 零种子守卫端到端自测 —— ★ 全零主种子是本项目最隐蔽的一类失败:
# 它不报错、不崩溃、结果数值照样对,但 Beaver 三元组全部可预测。
# 守卫必须在 CLI **入口**(含连网之前),覆盖全部 8 个吃种子的命令。
#
# ★ 第 18–22 条曾于 27cbdc7 被误删(脚本都还在,只是不再被调用 ⇒ 门禁静默削弱)。
# 已在 2026-11-XX 原样恢复,步骤号顺延后总数回到 24 条(2026-11-09 再加第 25 条 ⇒ 25 条)。
# 教训:**判据脚本在仓库里 ≠ 判据在门禁里** —— 每次改 ci.sh 必须核对
# 本文件的 step 条数与本文档分母一致,且逐条确认被调用的脚本存在。
# ★ 注意:本注释里刻意不写带引号的 step 字面样例 —— 那会让
# 「数 step 的 grep」把注释也算进去,计数永远多 1。
#
# 用法:tools/ci.sh 正常跑
# tools/ci.sh --fast 跳过测试与示例,只编译(改完想快速确认能编过时用)
#
set -euo pipefail
cd "$(dirname "$0")/.."
# 25. 集群自报 + 端点公布(控制面 + 多节点 hostd + 真 KBS)判据自测 + 破坏实验
# —— ★ 两份真机脚本的判据逻辑**永远不会被门禁执行**(真机不在门禁里):
# cluster-selfreport-e2e.sh(多节点自报)与
# cluster-endpoint-gate-e2e.sh(真 KBS 验签后端点公布)。
# —— ★ 自报侧三种静默失效:密钥进 argv / 否定式判据恒真 / 鉴权口径分叉。
# ③ 已真机踩过:控制面送 hex、节点比明文 ⇒ 全部 401。
# —— ★ 端点侧另有三类:正向没过就判负向(空集恒真)、只判数组非空不验
# 端点内容、负向缺 /report 正向锚点;以及 KBS 假就绪
# (端口 LISTEN ≠ 本轮参数的实例在跑)与最终结论不收口。
# —— ★ 破坏实验与判据**一起跑**:正向通过不能证明判据在起作用;
# 恒绿判据和真判据在正向路径上表现完全一样。
FAST=0
for a in "$@"; do
case "$a" in
--fast) FAST=1 ;;
-h|--help) sed -n '2,12p' "$0"; exit 0 ;;
*) echo "不认识的参数: $a" >&2; exit 2 ;;
esac
done
step() { printf '\n\033[1m== %s ==\033[0m\n' "$1"; }
ok() { printf '\033[32m ok\033[0m\n'; }
if [ "$FAST" -eq 0 ]; then
step "1/25 全量测试(含 secure 特性)"
cargo test --workspace --features secure
ok
fi
step "2/25 零告警构建(所有目标)"
# -Dwarnings 同时作用于本地 crate 的 test / bench / example 目标,
# 所以「测试代码里有 unused」也会被拦下 —— 这正是想要的。
RUSTFLAGS="${RUSTFLAGS:+${RUSTFLAGS} }-Dwarnings" \
cargo build --workspace --all-targets --features secure
ok
step "3/25 no_std 守线 + TA 常量对拍(mpc-core + mpc-tee)"
# 两条 no_std 都要守:
# mpc-core —— TEE / armv7 那条路的底座
# mpc-tee —— OP-TEE 的 TA 就是 default-features = false 构建的
# (见 crates/mpc-tee/Cargo.toml 与 build/build_optee.sh)。
# 只守 mpc-core 会漏掉它:TA 构建在独立通道里(见 docs 1.7),
# 主门禁不编 TA,就没人发现「mpc-tee 直接 use std」这种破坏。
cargo build -p mpc-core --no-default-features
cargo build -p mpc-tee --no-default-features
# TA UUID 在仓库里有五处硬编码,任何一处漂移的症状都是
# TEEC_ERROR_ITEM_NOT_FOUND(TA 找不到),而在独立通道里跑才暴露 —— 太晚。
# 这条零依赖,所以放主门禁,不放 ci-optee.sh。
python3 tools/check-optee-uuid.py
ok
# ★ 跨目标编译守线(Linux musl 目标)+ guest 产物边界。
#
# 为什么必须单独有一条:CI 平时在宿主(macOS / Linux glibc)上编译,
# 而 guest 用的二进制是 **x86_64-unknown-linux-musl** 静态产物。
# `collect.rs` 里的 CSV ioctl 采集代码是 `#[cfg(target_os = "linux")]`
# **专属**的 —— 宿主目标下**整段被排除**,宿主编译再干净也发现不了
# 它的 unused import / unused mut 之类的问题。
#
# 本轮就踩到:宿主零告警,但交叉编译出 3 个告警(Read/Write 未用、
# file 多余 mut),而 CI 第 2 条是 -Dwarnings —— 真机上直接编不过。
#
# 交叉编译不依赖外部 gcc(rustc 自带 rust-lld + musl crt)。
#
# ★ 本轮又踩到一条更根本的:mpc-chain 引入 openssl crate 后,
# `cargo build -p mpc-cli --target musl` 直接挂在 openssl-sys 找不到
# musl 版 libcrypto。这不是「装个交叉 OpenSSL 就好」——guest 静态产物
# 本来就不该链接 OpenSSL / axum / reqwest,那是宿主控制面。
# 修法:mpc-cli 按 feature + target 切分(见 Cargo.toml / build.rs),
# 交叉编译必须显式 --no-default-features;main.rs 的 compile_error!
# 在 musl + 默认 feature 时硬拒绝,给出可执行的指引。
# 三层判据都在 tools/check-guest-artifact.py:依赖树(必跑)、
# 编译期守卫负向、ELF 产物标识(后两条需已装 musl target)。
CROSS_TARGET=x86_64-unknown-linux-musl
step "4/25 跨目标编译(${CROSS_TARGET},guest 静态产物)+ guest 边界探针"
# 依赖树与标识串自检不依赖 musl target 是否安装 —— 目标没装也必须跑,
# 否则「跳过」会把最重要的边界判据一起跳掉(闸门不扫自己 = 假安全感)。
python3 tools/check-guest-artifact.py deps --target "$CROSS_TARGET"
if rustup target list --installed 2>/dev/null | grep -qx "$CROSS_TARGET"; then
# 负向:忘了 --no-default-features 必须被 compile_error! 明确拒绝,
# 而不是先撞上 openssl-sys 那句含混的 pkg-config 报错。
python3 tools/check-guest-artifact.py guard --target "$CROSS_TARGET"
# ★ 两份 musl 产物(2026-11-07 真机联调):
# guest —— 跑在 TEE enclave 里,不含任何宿主控制面。
# host —— 跑在 TEE 真机上的 hostd(真机没 Rust 工具链,要自包含静态二进制),
# 含 mpc-hostd、不含 mpc-chain(后者要系统 OpenSSL)。
# 两份产物**输出路径相同**(cargo 只按 target+profile 命名),所以先各自
# build 完立刻拷走,再做交叉对照 —— 顺序反了会拿错文件。
RUSTFLAGS="${RUSTFLAGS:+${RUSTFLAGS} }-Dwarnings" \
cargo build -p mpc-cli --target "$CROSS_TARGET" --release --no-default-features
cp "target/${CROSS_TARGET}/release/mpc" "target/${CROSS_TARGET}/release/mpc.guest"
RUSTFLAGS="${RUSTFLAGS:+${RUSTFLAGS} }-Dwarnings" \
cargo build -p mpc-cli --target "$CROSS_TARGET" --release \
--no-default-features --features host-only
cp "target/${CROSS_TARGET}/release/mpc" "target/${CROSS_TARGET}/release/mpc.host"
# ★ --host-path 是**否定判据的正向对照基准**:没有它,
# 「guest 里找不到 X」这类判据可能恒为真(探针失效也照样绿)。
python3 tools/check-guest-artifact.py binary \
"target/${CROSS_TARGET}/release/mpc.guest" \
--host-path "target/${CROSS_TARGET}/release/mpc.host"
ok
else
echo " GUEST_BINARY_SKIPPED:目标未安装,guard / binary 两条判据本轮未执行"
echo " 依赖树与标识串判据已在上面跑过;装好目标后本条才算完整通过"
echo " rustup target add ${CROSS_TARGET}"
fi
if [ "$FAST" -eq 0 ]; then
step "5/25 示例冒烟(12 个场景)"
tools/examples.sh
ok
# 第 5 条:shell 引号 / 变量名卫生。
# 三类陷阱都会「静默」破坏语义,编译器看不见、bash -n 也未必报错:
# ① `echo "值($VAR)"` 在 bash / ash 里把全角括号并进变量名 →
# unbound variable。踩过两次:guest init 的符号链接校验路径直接崩,
# 症状是「校验莫名失败」,排查方向被完全带偏。
# ② 双引号串里的反引号仍会被当命令替换执行(注释里也不行)。
# ③ 双引号串里未转义的双引号会提前闭合外层串 → body 被切成多个参数,
# 远端跑的是完全不同的脚本。
#
# ★ 扫描范围必须含 tools/ —— 闸门脚本自己也在 shell 生态里,
# 而且 tools/ci.sh 就是 CI 自身的实现。本轮就出现过:
# tools/ci.sh 里写了 "$CROSS_TARGET,guest 用的静态产物"(全角逗号),
# bash 把逗号并进变量名 → CI 第 4 条直接 `CROSS_TARGET,: unbound variable`
# 中途挂掉;而 lint 闸门只扫 deploy/tee,**对自己的盲区完全无感**。
# 闸门不扫闸门自己 = 闸门有盲区 = 假安全感。
step "6/25 shell 引号 / 变量名卫生"
# ★ deploy/arm 必须一起扫 —— 2026-11-XX 补:此前只扫 deploy/tee + tools,
# 而 arm 目录下的板端脚本是**真机上跑的**(变量名吞字会让板端输出错乱
# 且症状难查)。实跑板端脚本就抓到 4 处 var-ascii 命中。
python3 deploy/tee/real-machine/lint-shell-vars.py deploy/tee deploy/arm tools
ok
# 第 6 条:OCI 运行期完整性链自测。
# 这条链是「代码度量 → 活文件内容」的闭链,断了不会有编译错误,
# 只会在真机上表现为篡改活文件照样通过 —— 必须有本地闸门兜住。
step "7/25 OCI 运行期完整性链自测"
python3 deploy/tee/oci/selftest-chain.py
ok
# 第 7 条:KBS「先验证明才下发」自测。
# 这条链是「先出芯片证明 → KBS 校验 → 才签 token → 才给密钥」。
# 它的两端一旦断了不会有编译错误:
# · 顺序断(不验证明就给密钥)→ 密钥服务退化成文件服务器;
# · 判定断(判定器被顶替 / 输出不是判定结论)→ **假绿**,
# 「通过之后真的会签发 token 并下发密钥」这条路从未被验证过。
# 所以这里必须同时覆盖正向路径与全部拒绝路径。
step "8/25 KBS 先验证明才下发自测"
python3 deploy/tee/kbs/selftest-kbs.py
ok
# 第 8 条:guest 脚本在 ash 上的语法。
# guest 的 /init 由 busybox ash 解析,`bash -n` 通过 ≠ ash 能解析。
# 真机上这类错误要等 guest 起来才暴露,排查一轮几分钟;
# 本地闸门用 alpine 的 busybox ash(与 guest 同款解析器)秒级拦住。
step "9/25 guest 脚本 ash 语法"
deploy/tee/guest/syntax-check.sh
ok
# 第 9 条:芯片验签器自测(正负向)。
# 验签器是「先验证明才给密钥」链条的最后一关。这一关一旦假绿
# (把没验过的报告判成通过),密钥就发给了不该拿的人 —— 而且
# 不会有任何编译错误或运行时异常,只会安静地放行。
# 用的是真机采集的真报告 + 真 KDS 证书链(公开信任材料,无私钥),
# 所以本地无网也能验证「验签逻辑对真报告成立」。
#
# ★ SNP 与 CSV 两个平台各一份自测(两个平台的官方验签器行为不同):
# SNP:selftest-snp-verify.py
# CSV:selftest-csv-verify.py(2026-11-07 真机探索补上 —— CSV 侧此前
# 一直没有自测,与 SNP 不对称;而 CSV 侧真机实测挖出两个真 bug:
# ① 官方 SM2 签名**不覆盖 MAC 字段**(wrapper 曾声称验了 MAC);
# ② 官方验签器缺证书时会**联网**从 cert.hygon.cn 下载,
# 导致「我们提供的信任材料」根本没参与链验证。
# 两条都已在 wrapper 里修掉,并由自测把边界钉成判据。
# CSV 自测缺官方二进制时显式 CSV_VERIFY_SKIPPED,
# 但零依赖 --self-test 永远执行到 —— 不因跳过变成盲区。
# ★ 同一处还跑 kbs-up.sh 的参数自检:那份脚本的网段与 TCB 参数一旦被
# 硬编码覆盖,负向矩阵就会**假绿**(真踩过:外部设 min-tcb=99,
# 实际 KBS 收到 3,TCB 负向直接被放行)。
step "10/25 芯片验签器自测(SNP + CSV)+ KBS 启动参数自检"
python3 deploy/tee/real-machine/selftest-snp-verify.py
python3 deploy/tee/real-machine/selftest-csv-verify.py --self-test
python3 deploy/tee/real-machine/selftest-kbs-up.py
ok
# 第 10 条:OP-TEE 判据逻辑自测。
#
# 为什么这条必须进**主**门禁(而不是留在 ci-optee.sh 里):
# 跨设备(第 5 条)与跨重启(第 4 条)两条验证都只能在
# **有 OP-TEE SDK + QEMU** 的机器上跑。绝大多数开发机上
# ci-optee.sh 的输出是 OPTEE_SKIPPED。
# 于是判据逻辑(build/optee-verdict.py)就长期处于
# 「写完了,但从来没被执行过」的状态 ——
# 而判据恰恰是这类验证里最容易写错、错了最难发现的部分:
# 只判「失败」不判失败原因 → blob 没打进去也算通过;
# 只判「成功」不判 provisioned → 又 provision 一次的伪成功。
# 这两类错误在真机上都表现为「验证通过」,没有任何异常。
#
# 所以用**构造的串口日志**把判据的每条分支都跑一遍 ——
# 不需要 SDK、不需要 QEMU,秒级完成。
# 它证明的是「给定一份日志,判定器的结论正确」,
# **不**证明 OP-TEE 的 seal/unseal 行为正确(那要跑 QEMU)。
step "11/25 OP-TEE 判据逻辑自测"
python3 tools/selftest-optee-verdict.py
ok
# 第 12 条:宿主控制面 mpc-hostd 端到端自测。
#
# 为什么这条必须进主门禁:它的三条失效方式**全是静默的**。
# · e2b 兼容面形状不对 —— 只有真 client 才炸,单元测试看不出;
# · /attestation 四个布尔被合并成 ok —— 运维看到 ok=1 就以为安全,
# 而实际是「没做芯片验签」,这是最贵的一种错;
# · 「状态改了但进程还在」—— 站点端以为 TEE 已停,实际还在跑。
#
# 单元测试测的是「函数返回值对不对」,这里测的是**整条链路**在真 socket 上
# 跑不跑得通。实例回收那条用**心跳文件**判据(实例自己 touch 一个文件,
# 停掉后心跳停止)—— 不依赖 ps / /proc,因为受限环境里 ps 常被禁、
# macOS 也没有 /proc,那时这条判据会被跳过,而它恰恰是最重要的一条。
#
# ★ 2026-11-09 并入「guest → hostd 的证明材料回传闭环」子测试
# (判据数从 20 涨到 40+,但**门禁条数不变**仍是 22 条):
# · 正向:guest 侧**真实客户端**(`mpc tee attest-upload`,与 guest 里
# 同一个二进制)上传原始证明包 ⇒ 宿主**独立**判定 pending → verified;
# · 负向:错令牌 401 / 不带凭据 401(回环模式也不例外)/
# 绑定对不上 ⇒ rejected;
# · 集群面:用**假 hostd** 补「端点出现与收回」的正向对照
# (否则否定式判据会因 create 恒失败而恒真)。
#
# ★ 假 hostd 的正向场景必须返回 `chip_sig=true` ——
# 集群控制面默认 `require_chip_sig=true`(真 KBS 验签后才公布端点),
# 假 hostd 返回 chip_sig=false 时端点被**正确地**不公布,
# 那不是实现的错,是判据与策略对不上。
step "12/25 宿主控制面 mpc-hostd 端到端自测"
python3 tools/selftest-hostd.py
ok
# 第 13 条:会话级链路层(EasyTier)端到端自测。
#
# 链路层的失效全是静默的:argv 漏 --secure-mode 或混进 --network-secret,
# 网络照起但分级授权没了;easytier-cli peer 有多行时只判第一行,会把
# 第二行 relay 藏成 link=p2p(已经发生过一次,这里留了回归探针);
# allowlist 白名单为空却生成出等于 open 的配置。
#
# 本机没有 EasyTier 二进制,也没有联盟管理节点 —— 用桩跑完整链路,
# 判的是框架自己的契约,不是 EasyTier 的实现。进程真起真回收由
# LinkRuntime 单测判(持 Child + try_wait 收割),此处显式再跑一次,
# 保证这条判据真的进了主门禁的执行路径。
step "13/25 会话级链路层 EasyTier 端到端自测"
python3 tools/selftest-link.py
ok
# 第 14 条:链上层(mpc-chain)端到端自测。
#
# 这一层的失效也全是静默的:outbox 不幂等,补链会写出重复账;
# fail-open 写成 fail-closed,链一挂计算就停;反过来把成员准入写成
# 「读不到就放过」,就是准入被绕过。最隐蔽的是 JSON-RPC:HTTP 200
# 的响应体里带 error 字段是正常失败形态,只判 HTTP 状态会把「交易
# 被拒」当成「已上链」。
#
# 本机没有 FISCO BCOS 节点 —— 用 Python 假 bcos-rpc 跑完整链路,
# 判的是框架自己的契约。★ 诚实边界:flush 发出去的 payload 仍是
# 链上对象规范字节,不是已签名交易(国密交易 RLP 编码 / 真实
# bcos-rpc 的 TLCP 通道未落地;Rust 侧 TLCP 进程通道环回实证见
# gate 18,但那不是连真节点的通道),所以这条门禁不证明「能上链」。
# 另:--transport 必须显式给,stub 只供桩自测,tlcp 是生产路径
# (缺双证书配置即拒),传输形态不许有默认值 = 不许留明文后门。
step "14/25 链上层 mpc-chain 端到端自测"
python3 tools/selftest-chain.py
ok
# 第 15 条:国密签名与治理形状端到端自测。
#
# ★ 最关键的一条判据是「系统 openssl dgst -sm3 -verify 验过框架
# 签出的签名」:CLI 用 SM2 默认 user id,能验过才说明链下签名的
# distid 与 FISCO 上游 fast_sm2.cpp 的 c_userId 同值。只在 Rust 里
# 自签自验是循环自证,测不到 distid 漂移。
# 软件签名器私钥可导出、密评不可过 —— 生产策略必须拒绝它;
# profile 与「私钥不可导出」交叉校验,防止软件谎报硬件模组。
# 本机无 Tongsuo,但 GmSSL 3.2.0 可用:通道准入依旧 fail-closed
# (发真交易只对 Ready 放行);Rust 侧 TLCP **进程通道**已落地
# (gate 18),就绪状态从 NeedsFfi 推进到 LoopbackReachable ——
# 环回可达,但不是 bcos-rpc 真机通道。
# TLCP 双证书正向校验 / 真交易编码仍待真机对拍,
# 见 tools/selftest-chain-gm.py、tools/selftest-tlcp-tunnel.py
# 与 tools/fisco-realnode-probe.py。
step "15/25 国密签名 / distid 对齐 / TLCP 准入 / 治理形状自测"
python3 tools/selftest-chain-gm.py
ok
# 第 16 条:GmSSL 真 TLCP 握手 / TA 密钥分级 / FISCO 真机对拍契约。
#
# ★ 两个 --self-test 与 TA 探针都是**零外部依赖**,本机没装 GmSSL
# 也必须跑:判据逻辑永远测不到 = 假安全感。
# ★ 真握手缺 GmSSL 时打印 GMSSL_TLCP_SKIPPED + 逐项缺失(不算通过);
# 装了就真起 tlcp_server/tlcp_client,成功也只打印 GMSSL_TLCP_OK +
# BCOS_RPC_NOT_VERIFIED,绝不宣称 bcos-rpc 通道已通。
# ★ fisco-realnode-probe.py 环境齐备也只报 NEEDS_IMPL:FISCO 自有
# 交易编码 / Rust 侧 TLCP 通道 / sm2Verify 真机对拍 / 已签名交易
# 都还没落地,凑齐环境变量不等于能上链。
step "16/25 GmSSL TLCP 真握手 / TA 密钥分级 / FISCO 真机对拍契约"
python3 tools/selftest-tlcp-gmssl.py --self-test
python3 tools/fisco-realnode-probe.py --self-test
python3 tools/selftest-ta-key-tier.py
python3 tools/selftest-tlcp-gmssl.py
python3 tools/fisco-realnode-probe.py
ok
# 第 17 条:阶段 3 第一段 OPA bundle 签发 / 真判定 / decision 存证。
#
# ★ --self-test 是零依赖判据逻辑,没装 OPA 也必须跑;真闭环缺环境
# 打印 OPA_DECISION_SKIPPED + 逐项缺失(不算通过)。
# ★ 真闭环用的是真 opa build / opa eval 与系统 openssl 独立验签,
# 不是 Python 复刻的策略判定。undefined 输出当拒绝,不当默认 deny。
# ★ 成功也只打印 OPA_DECISION_OK + OPA_GUEST_NOT_VERIFIED +
# CHAIN_NOT_VERIFIED,绝不宣称「阶段 3 已完成」。
step "17/25 阶段 3 OPA bundle 签发 / 真判定 / decision 存证自测"
python3 tools/selftest-chain-opa.py --self-test
python3 tools/selftest-chain-opa.py
ok
# 第 18 条:TLCP **进程通道**环回实证。
#
# ★ 这条把「Rust 侧 TLCP 通道未落地」这一长期诚实边界项,在不突破
# 「≠ bcos-rpc 通道已通、不假装能发真交易」前提下,推进到「环回可达」
# 实证:Rust `TlcpTunnel` spawn `gmssl tlcp_client -in`(响应走 stdout,
# 注意 `tlcp_client` 没有 `-out`),把一段真实 JSON-RPC 经 TLCP 发给环回
# `gmssl tlcp_server` echo,读回响应,断言应用数据往返一致、sentBytes ==
# receivedBytes、channelLayerReachable=true、realChainVerified=false。
# ★ 诚实边界(沿用 gate 15 口径,且更进一层):环回服务端是
# `gmssl tlcp_server` echo,不是 FISCO 节点;未验证 bcos-rpc 是否启用
# TLCP;GmSSL 软件实现私钥可导出、不能过密评。所以成功只打印
# GMSSL_TLCP_TUNNEL_OK + BCOS_RPC_NOT_VERIFIED,绝不宣称「链上通道已通」
# 或「能发真交易」。发真国密交易仍由 require_transport 只对 Ready 放行,
# 本通道只到 LoopbackReachable。
# ★ 缺 GmSSL / 缺 mpc 二进制打印 GMSSL_TLCP_TUNNEL_SKIPPED + 逐项缺失;
# --self-test 零依赖判据逻辑永远被执行到(防盲区)。
step "18/25 TLCP 进程通道环回实证自测"
python3 tools/selftest-tlcp-tunnel.py --self-test
python3 tools/selftest-tlcp-tunnel.py
ok
# 第 19 条:真 TEE 双 guest 跨物理机会话的**判据**自测。
#
# ★ 这条测的是「判定逻辑」,不是「真机」。真机实跑见
# deploy/tee/real-machine/pair-run.sh(2026-11-07 两台真机实测通过:
# AMD SEV-SNP + 海光 CSV,双方都还原出 value | 35.000000)。
# 本条零依赖、每次 CI 都跑,保证「判定逻辑没写错」——
# 真机跑一次的成本高且不连续,判据写错了真机也测不出来。
#
# ★ 判据自指必须被证伪:负向判据天然有「恒为真 / 恒为假」的风险。
# 实测踩过两个真坑:
# ① 判据字符串写错("mpc selftest 全部通过" vs 真实的 "全部通过")
# → 恒为假 → 真机跑通了却报失败(假红);
# ② 只判 qemu 退出码 → guest 里 halt 之后的退出码与成功无关
# → 恒为真 → 什么都没发生也报成功(假绿)。
# 所以每条判据都要用构造样例逐条破坏,验证它能真的把结论推翻。
#
# ★ 测的是真机上**实际调用的那一份** check-pair-verdict.py,
# 不是另写一份模拟 —— 两份实现等于没有门禁。
step "19/25 真 TEE 双 guest 会话判据自测"
python3 tools/selftest-tee-pair-verdict.py
ok
# 第 20 条:真 TEE **证明门控**判据自测。
#
# ★ 为什么必须和第 19 条**分开**(合成一份就会出现「一项过掩盖另一项不过」):
# 第 19 条判的是「密文会话 + 运行期完整性链 + 数据面 MAC 唯一性」;
# 第 20 条判的是「密钥是不是**经过芯片证明**才发下来的」。
# 这两件事**互不蕴含**:
# · 会话跑成了 ≠ 密钥是证明后给的(上一版就是拿离线演练密钥跑通会话的)
# · 密钥是证明后给的 ≠ 会话跑成了(会话层另有一套判据)
#
# ★ 判据自指必须被证伪:
# 「证明门控判据」天然有「恒为真」的风险 —— 如果它只检查
# 「日志里没有 key_source=offline-demo」,那**空日志**也判通过,
# 等于什么都没验证。自测里必须包含「日志为空 / 日志缺失 / 只有一侧」
# 这些**不该通过**的样例,确保判据真的在读日志。
#
# ★ 测的是真机上**实际调用的那一份** check-attest-verdict.py,
# 不是另写一份模拟 —— 两份实现等于没有门禁。
step "20/25 真 TEE 证明门控判据自测"
python3 tools/selftest-tee-attest-verdict.py
ok
# 第 21 条:国密链**真交易编码**路径自测(`--mode signed-tx`)。
#
# ★ 这条测的是「真交易」那条路径,不是第 14 条的 stub 路径:
# stub 发的还是链上对象规范字节;signed-tx 发的才是
# **完整已签名 FISCO 交易**(TARS 字节),
# 走国密链自有 `sendTransaction`(4 参),
# 不是 web3 的 `eth_sendRawTransaction`(那个固定 secp256k1+keccak256)。
#
# ★ 判据要点(每条都必须可测、不得恒真):
# ① data 能被 TARS 解析成 Transaction 结构(dataHash 32B + signature 128B);
# ② signature 是 `r||s||pub`(128 字节)—— 上游 `signTransactionDataHash()`
# 传 `_signatureWithPub=true`,只签 64 字节 r||s 的交易节点会拒;
# ③ 成功判据三件套:status==0(TransactionStatus::None,**与 web3 相反**)
# 且 transactionHash 非空 且 blockNumber>0,缺一不算成功;
# ④ 幂等:已确认条目二次 flush 的 attempted 必须为 0
# (signed-tx 路径必须走 outbox 状态机,否则同一笔会再发一次);
# ⑤ 8 类负向:status!=0 / blockNumber=0 / 缺 transactionHash / 缺 status /
# RPC error / result=null / 合约地址不是 20 字节 / 缺 --key 或 --contract
# —— 每条都必须判失败**并带出期望特征**。
#
# ★ 诚实边界:本条用 Python 假 bcos-rpc,验证的是**框架自己的契约**
# (编码、判据、幂等、失败语义),**不证明**真链上能上链。
# 真链部署与调用见 tools/fisco-realnode-probe.py(目前报 NEEDS_IMPL)。
step "21/25 国密链真交易编码 / sendTransaction 判据自测"
python3 tools/selftest-chain-tx.py
ok
# 第 22 条:FISCO 国密链**真链合约**部署 + 调用 + 读回 + 负向矩阵。
#
# ★ 这是把「智能合约能上真链」从 NEEDS_IMPL 推进到实证的门禁:
# 连本机真节点(127.0.0.1:20200,sm_crypto=true,3.17.1),完整跑
# 部署 MpcHardRule → recordHardRule → call 读回 isRecorded/hardRuleSummary
# → 负向矩阵(零摘要 revert / 未登记读回 0 / 幂等不覆盖)。
# 成功三件套 = status==0 且 transactionHash 非空 且 blockNumber>0。
#
# ★ --self-test 是零依赖判据逻辑(22 项),每次 CI 必跑,防盲区:
# 真链环境不在时,真链批必须显式打印 FISCO_REALNODE_SKIPPED +
# 逐项缺失,绝不打印通过。凑齐 env 也不等于能上链 —— 但本机环境齐备
# 时这条会真上链并核对状态。
#
# ★ 诚实边界:软件 OpenSSL 签名器真能签、真链能上链,但私钥可导出
# ⇒ 密评不可过;生产必须换硬件模组签名器。真实 bcos-rpc 的 TLCP
# 通道仍未通(gate 18 服务端是环回 echo,不是真节点)。
step "22/25 国密链真合约部署 / 调用 / 读回 / 负向矩阵自测"
python3 tools/selftest-fisco-contract.py --self-test
python3 tools/selftest-fisco-contract.py
ok
# 第 23 条:SA 扩展模式(安全锚点供能力、算力挂外部 VM)端到端自测。
#
# 这条守的是**整个形态的信任基础**:
# VM(算力侧)能调用安全世界的能力,但**永远拿不到 K_root**。
# 一旦这条破了,Beaver 三元组全部可预测 ⇒ 密态乘法隐私性归零,
# 而症状是「不报错、不崩溃、结果数值也对」—— 最难发现的一类失败。
#
# ★ 每条否定判据都带**期望特征**("凭据不匹配" / "解封失败" /
# "未知操作" …),不是「退出码非 0」—— 否则 "Connection refused"
# 也会让「必须拒绝」因为**错误的原因**通过(假绿)。
# ★ 每条否定都配一条**正向对照**(同样的命令在正确参数下必须成功),
# 证明「拒绝」不是因为环境坏了。
# ★ 判据层次:端到端这条覆盖**整体**行为;分层责任
# (例:服务端层的全零守卫)由 mpc-tee 的 Rust 单测覆盖 ——
# 端到端脚本**无法区分**是哪一层拒的(CLI 层会遮蔽服务端层),
# 这一点必须写清楚,否则会误以为「服务端层也验过了」。
#
# 负向实验已逐条跑过(证明判据非恒绿):
# · 鉴权恒真(ct_eq 换成 true) ⇒ "错凭据被拒" 变红
# · unseal 不校验 AAD ⇒ "unseal 成功" 变红
# · 协议里加 root-key 导出端点 ⇒ "没有 root-key 端点" 变红
# · CLI + 服务端同时去全零守卫 ⇒ "全零根密钥拒绝启动" 变红
# · 回环模式接受任意 token ⇒ "回环模式带凭据被拒" 变红
step "23/25 SA 扩展模式端到端自测"
python3 tools/selftest-sa.py
ok
# 第 24 条:零种子守卫(fail-closed)端到端自测。
#
# ★ 为什么单独一条,而不是塞进 SA 那条:
# 零种子不是 SA 形态特有的问题,它是**整个项目**的会话物料问题 ——
# node / cluster / orch run / psi / lr / lr-vertical / fl / sql-join
# 这八个命令都吃会话种子,任何一个漏了守卫,整条链就漏了。
# 混进 SA 那条会让「哪条判据守什么」变得不可读。
#
# ★ 为什么必须单独有守卫:
# 全零主种子 ⇒ Beaver 三元组全部可预测 ⇒ 密态乘法隐私性归零,
# 而症状是「不报错、不崩溃、结果数值也对」——
# 这跟「服务起不来」「签名验不过」这类会自己叫出来的失败完全不是一回事。
#
# ★ 守卫的位置有硬要求:**CLI 入口,且在连网之前**。
# `mpc node` 原本的种子校验在连网(甚至 Ray 注册)之后 ——
# 那样全零种子会先让本进程连上网、注册进集群,然后才失败,
# 症状伪装成「网络问题」,而且对端已经在等你了。本轮已前移。
#
# 负向实验已逐条跑过(证明判据非恒绿):
# · parse_seed 去掉全零检查 ⇒ 6 条「零种子被拒」全部变红(18→12)
# · Vault::new 去掉全零守卫 ⇒ Rust 单测 zero_master_seed_is_rejected FAILED
#
# ★ 分层事实(与 SA 那条同一性质):CLI 入口的守卫会**遮蔽**下游的守卫。
# 本脚本覆盖**整体**行为(零种子 ⇒ 起不来);
# 分层责任(下游库自己拒不拒)由各自 crate 的 Rust 单测承担。
step "24/25 零种子守卫端到端自测"
python3 tools/selftest-seed-guard.py
ok
# 第 25 条:集群自报(控制面 + 多节点 hostd)判据自测 + 破坏实验。
#
# ★ 为什么必须单独一条:
# `cluster-selfreport-e2e.sh` 是**真机**脚本(两台真机:AMD SNP +
# 海光 CSV),真机不在门禁环境里 ⇒ 它的判据逻辑**永远不会被执行**。
# 而这个脚本的判据有三种典型的**静默失效**:
# ① 密钥进 argv ⇒ 密钥出现在远端 ps 里(脚本照样跑通);
# ② 否定式判据恒真 ⇒ 控制面根本没起来,脚本却报「度量非全零」;
# ③ 鉴权口径分叉 ⇒ 控制面送 hex、节点比明文 ⇒ 全部 401。
# ④ 输出被噪声污染 ⇒ xop 的 WARN 在 stdout、ssh 客户端 Warning 在
# stderr,混进 $(remote ...) 后 got_len 不是数字(同一个 bug 复发两次)。
# ③ 已经**真机踩过**(2026-11-09):症状是「节点活着、自报收到了,
# 就是下发不进去」——看起来像网络问题、像节点问题、像控制面没起。
#
# ★ 破坏实验为什么必须一起跑:
# 判据在正向路径上通过,**不能**证明它在起作用 ——
# 恒绿判据和真判据在正向路径上表现完全一样。
# ⇒ 每个判据都破坏一次,要求自测脚本**必须转红**。
# ★ 破坏实验必须**双向确认变异生效**(证据串消失/新增):
# 2026-11-09 实测踩过:变异函数删错了行 ⇒ 破坏实验「没抓到」
# ⇒ 差点被误判成「判据恒绿」。SKIP 不许当成通过。
#
# ★ 判据只查**代码形态**,不查注释里的字样 ——
# 查注释 ⇒ 注释删了代码还在也会绿(自指型假绿);
# 查裸字符串 ⇒ 注释里自己写着的历史说明会把自己判红(自指型假红)。
# ★ 判据 10 是**行为判据**:真跑一遍 remote()(假 xop 打 WARN、
# 假 sshpass 打 Warning),断言返回值只剩远端 stdout ——
# 静态查形态挡不住「换个写法又污染」。
step "25/25 集群判据自测 + 破坏实验(自报 / 端点 / 超时回收)"
python3 tools/selftest-cluster-selfreport.py
python3 tools/selftest-cluster-selfreport-break.py
# ★ 端点公布门禁(真 KBS 验签后才公布会话端点)—— 与自报是**两份**脚本,
# 两份的判据都不能被真机门禁执行 ⇒ 各自都要「自测 + 破坏实验」成对覆盖。
python3 tools/selftest-cluster-endpoint-gate.py
python3 tools/selftest-cluster-endpoint-gate-break.py
# ★ pending 超时回收(服务端逻辑,由第 1 条 cargo test 真跑单测覆盖)。
# 这里补的是**跨文件接线**静态判据:常量只有一份 / 真的调 destroy /
# 回收在容量记账之前 / 本轮不重建 / 组合根透传 / CLI flag 与 help。
# ★ 与上面两份不重复:那两份守的是真机脚本(判据永不被门禁执行),
# 这份守的是 Rust 源码里的接线(逻辑本身由单测真跑)。
python3 tools/selftest-pending-timeout.py
python3 tools/selftest-pending-timeout-break.py
ok
fi
printf '\n\033[32m\033[1m全部通过\033[0m\n'