- 新增 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 发的是规范字节而非已签名交易,未配置签名器即拒绝,本期不宣称能上链。
240 lines
14 KiB
Bash
Executable File
240 lines
14 KiB
Bash
Executable File
#!/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'
|