Files
ssw-mpc/tools/ci.sh
T
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

240 lines
14 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. 12 个示例必须跑得通且断言全绿(否则三个月后就是一批编译不过的摆设)
# 4b. 跨目标(x86_64-linux-musl)必须零告警 —— Linux 专属代码在宿主
# 目标下整段被排除,宿主编译发现不了它的 unused 之类的问题
# 5. shell 脚本里不能有「变量后紧跟非 ASCII 字符」/「双引号串里的反引号」
# /「双引号串里未转义的双引号」三类引号与变量陷阱
# 6. OCI 运行期完整性链自测必须全过(篡改活文件必须能被发现)
# 7. KBS「先验证明才下发」必须自证:正向路径能走通,拒绝路径必须拒
# (判定器被顶替 / 输出不是判定结论时必须拒,防假绿)
# 8. guest 脚本必须在 ash 上语法正确(bash -n 通过 ≠ ash 能解析)
# 9. SNP 芯片验签器必须正负向都对(假绿 = 密钥发给不该拿的人)
# 10. OP-TEE 判据逻辑必须正负向都对(判据错了 = 验证结论是错的;
# 而那两条验证只能在有 SDK 的机器上跑,判据不进主门禁就永远没被执行过)
# 11. 宿主控制面 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。
# 12. 会话级链路层必须端到端自测(三档 relay 判据、凭据只由管理节点签发、
# argv 绝不分发 network_secret、所有 peer 取最严路径、进程真起真回收)。
# 本机没有 EasyTier 二进制,用桩跑完整链路 —— 「没装」不等于判据可以跳过。
# 13. 链上层形状必须端到端自测(对象规范编码 / 幂等 outbox /
# fail-open 与 fail-closed 分开 / JSON-RPC 200+error 不当成功 /
# 系统代理不能把这一跳的端点偷偷换掉)。
# 本机没有 FISCO 节点与国密模组,用桩跑完整链路;
# ★ 不宣称能上链 —— flush 发的是规范字节,不是已签名交易。
#
# 用法:tools/ci.sh 正常跑
# tools/ci.sh --fast 跳过测试与示例,只编译(改完想快速确认能编过时用)
#
set -euo pipefail
cd "$(dirname "$0")/.."
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/14 全量测试(含 secure 特性)"
cargo test --workspace --features secure
ok
fi
step "2/14 零告警构建(所有目标)"
# -Dwarnings 同时作用于本地 crate 的 test / bench / example 目标,
# 所以「测试代码里有 unused」也会被拦下 —— 这正是想要的。
RUSTFLAGS="${RUSTFLAGS:+${RUSTFLAGS} }-Dwarnings" \
cargo build --workspace --all-targets --features secure
ok
step "3/14 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 目标)。
#
# 为什么必须单独有一条: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)。
CROSS_TARGET=x86_64-unknown-linux-musl
if rustup target list --installed 2>/dev/null | grep -qx "$CROSS_TARGET"; then
step "4/14 跨目标编译(${CROSS_TARGET},guest 用的静态产物)"
RUSTFLAGS="${RUSTFLAGS:+${RUSTFLAGS} }-Dwarnings" \
cargo build -p mpc-cli --target "$CROSS_TARGET" --release
ok
else
step "4/14 跨目标编译(${CROSS_TARGET})—— 跳过:目标未安装"
echo " 安装该目标后本条闸门才生效: rustup target add ${CROSS_TARGET}"
fi
if [ "$FAST" -eq 0 ]; then
step "5/14 示例冒烟(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/14 shell 引号 / 变量名卫生"
python3 deploy/tee/real-machine/lint-shell-vars.py deploy/tee tools
ok
# 第 6 条:OCI 运行期完整性链自测。
# 这条链是「代码度量 → 活文件内容」的闭链,断了不会有编译错误,
# 只会在真机上表现为篡改活文件照样通过 —— 必须有本地闸门兜住。
step "7/14 OCI 运行期完整性链自测"
python3 deploy/tee/oci/selftest-chain.py
ok
# 第 7 条:KBS「先验证明才下发」自测。
# 这条链是「先出芯片证明 → KBS 校验 → 才签 token → 才给密钥」。
# 它的两端一旦断了不会有编译错误:
# · 顺序断(不验证明就给密钥)→ 密钥服务退化成文件服务器;
# · 判定断(判定器被顶替 / 输出不是判定结论)→ **假绿**,
# 「通过之后真的会签发 token 并下发密钥」这条路从未被验证过。
# 所以这里必须同时覆盖正向路径与全部拒绝路径。
step "8/14 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/14 guest 脚本 ash 语法"
deploy/tee/guest/syntax-check.sh
ok
# 第 9 条:SNP 芯片验签器自测(正负向)。
# 验签器是「先验证明才给密钥」链条的最后一关。这一关一旦假绿
# (把没验过的报告判成通过),密钥就发给了不该拿的人 —— 而且
# 不会有任何编译错误或运行时异常,只会安静地放行。
# 用的是真机采集的真报告 + 真 KDS 证书链(公开信任材料,无私钥),
# 所以本地无网也能验证「验签逻辑对真报告成立」。
step "10/14 SNP 芯片验签器自测(正负向)"
python3 deploy/tee/real-machine/selftest-snp-verify.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/14 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,那时这条判据会被跳过,而它恰恰是最重要的一条。
step "12/14 宿主控制面 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/14 会话级链路层 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 是链上对象规范字节,不是已签名交易(SM2 / RLP / provider
# 尚未落地),所以这条门禁不证明「能上链」。
step "14/14 链上层 mpc-chain 端到端自测"
python3 tools/selftest-chain.py
ok
fi
printf '\n\033[32m\033[1m全部通过\033[0m\n'