Files
ssw-mpc/docs/INTEGRATION_ANALYSIS.md
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

105 KiB
Raw Permalink Blame History

ssw-mpc 三方整合:决策定稿与实施方案

2026-11-07 决策锁定。本文替代此前的分析稿,作为唯一实施依据。 原分析稿的取证过程见文末「事实来源」;被本轮决策推翻的结论已在正文标注 [修正]。


⚠ 状态提示(2026-11-08 复核,读正文前先看这里)

本文是 2026-11-07 的决策定稿与阶段快照,不是当前实施状态的真相源。 第 0 节决策台账、依赖边界、fail-closed 纪律、治理域分隔仍然生效; 但正文里所有「阶段状态 / 门禁条数 / 未落地 / 不宣称」的表述,已被随后三次提交 (237e646 真链合约实证、3ad3f30 复现脚本入库、ba11de5 链迁 k8s)推进:

本文当时写的 当前事实(2026-11-08) 权威入口
主门禁共 18 条(§6、附录) 25 条 tools/ci.sh
「flush 只发规范字节,不是已签名交易」 FISCO TARS 编码 + 128B r‖s‖pub 签名已落地,flush --mode signed-tx 发完整已签名交易并走 Outbox::flush_with 状态机 crates/mpc-chain/src/fisco_tx.rs、crates/mpc-cli/src/chain.rs
「不宣称能上链」「合约部署仍未做」 真链合约部署 / 调用 / 读回 + 负向矩阵已实证,22 项判据全绿 tools/selftest-fisco-contract.py(主门禁第 22 条)、contracts/MpcHardRule.sol
「FISCO 自有交易编码待真机对拍」 已逐字节核对落地;★ 签名口径是 e = SM3(ZA‖dataHash)(节点 3.17.1 只编译了 fast_sm2_*,用 distid 1234567812345678),不是签裸 dataHash docs/FISCO_UPSTREAM_TRUTH.md §3.1、tools/sm2_verify.py
「3.x 是 eth_ 兼容端点」这一旧直觉 eth_call / eth_getTransactionReceipt 实测 method-not-found;读回用自有 call / getTransactionReceipt(4 参 groupID+nodeName) docs/FISCO_UPSTREAM_TRUTH.md
链跑在本机 fisco-gm / 127.0.0.1:20200 连同现有账本迁入 wuguirong k8s(NodePort 30100),账本落 nfs-wuguirong PVC;历史区块哈希逐个一致、删 Pod 重建后高度不变 deploy/k8s/fisco/README.md
「fisco-realnode-probe.py 只报 NEEDS_IMPL」 该探针仍是历史契约(未销账);但真链验收已由第 22 条脚本承担,两者别混 tools/fisco-realnode/README.md

当前状态以 docs/INDEX.md 与上表权威入口为准;本文正文保留当时的 取证与推理链,凡与上表冲突处按上表读。正文里带「(2026-11-07 当时)」标注的 段落同理。诚实边界依然成立,不许借这次更新冲掉:软件 OpenSSL 签名器私钥 可导出 ⇒ 密评不可过;真实 bcos-rpc 的 TLCP 通道未通(第 18 条服务端是环回 echo);硬件模组 provider 未落地;OPA 不在 guest 内;撤销链读后端未接入 (声明 chain 即 fail-closed 拒);decision 未签名未上链;TEE 证明未上链。

架构结论已抽出(2026-11-08):本文 §1 双层控制面、§4 链上形态、§5 会话主键的 架构骨架已拆到 ARCHITECTURE_SYSTEM.md(活文档), 并结合真链 / 合约 / k8s / 真机实证补齐当前形态与状态标注([实证] / [桩验] / [设计] / [禁用])。 本文保留决策台账与取证推理链,不再承担「系统长什么样」的职责: 查架构去那份,查「当时为什么这么定」来本文。请勿把本文的职责矩阵当成已部署清单 (例如 mpc site 是设计角色,CLI 里没有这个子命令)。


0. 决策台账

# 决策 取值 直接后果
1 飞梭链部署形态 Pro 版 bcos-rpc / bcos-gateway / bcos-node 三件套;TARS 可选;RPC 可横向扩展,站点端只连 RPC
2 密码套件 必须国密 SM2 签名 + SM3 哈希 + SM4 落盘 + 节点间国密 SSL;建链时定,之后不可改
3 策略执行位置 硬规则 成员白名单、TCB 门槛、算力上限、算法准入写成 Solidity 合约,链上共识执行
4 链路中继策略 两者兼容,参数控制 open / allowlist / p2p-only 三档,由 mpc link plan --policy 落参数(不经过 e2b 兼容面,见 3.3 / 6)
5 策略来源与签发 都可写,控制面签发 联盟全局表与机构自持并存;签发私钥唯一在站点端控制面
6 WASM 合约 不开 WITH_WASM 保持 OFF;Rego→WASM 上链(原 3c)整条删除
— 控制面层数 两层 站点端 + 宿主机端(e2b),宿主机向站点端提供 e2b 接口
— TEE 平台矩阵 海光 CSV / AMD SNP / ARM OP-TEE 国密只在海光跑;AMD 走非国密;OP-TEE 是轻形态(见 1.6)
— 国密实现路径 硬件模组 + OpenSSL provider 只走 provider,不走 engine/SDF/PKCS#11;Rust 不实现 SM2(见 4.3④)
— OP-TEE 定位 单独编译 / 单独验证 编译与设备验证走独立通道;零 SDK 能判的(no_std、UUID 对拍)仍进主门禁;缺环境必须显式报 skip(见 1.7)
— 宿主 HTTP 栈 axum + tokio + reqwest 协议层交给成熟组件;依赖只落在独立 mpc-hostd crate,mpc-tee 保持零 crates.io 依赖(要被拷进 OP-TEE SDK 离线交叉编译,见 6)
— 会话凭据来源 管理节点签发,框架不生成 easytier-cli credential generate --ttl 返回 credential_id + credential_secret;框架只承载 / 传递 / 绑定 / 回收,CredentialProvider 未配置即拒绝(见 3.3)
— 国密链参数(2026-11-07 拍板) sm_crypto=true 已确认 建链参数按国密冻结,不可逆;false 一律拒
— 国密签名实现(2026-11-07 拍板) 先用 OpenSSL 软件实现 真能签 SM2(raw `r
— 客户端通道(2026-11-07 拍板) bcos-rpc 做国密 TLS / TLCP 双证书 + Tongsuo ≥ 8.4 或 GmSSL ≥ 3.2;Rust 侧通道未接入 ⇒ fail-closed,明文不许冒充
— TLCP 实现选型(2026-11-07 用户提点) GmSSL 可用(开源免费,Apache-2.0) 本机 3.2.0 环回真握手已跑通(第 16 条 19 判据);但 3.x 不与 OpenSSL ABI 兼容、软件实现不能过密评,生产仍需硬件模组
— 国密链提交方法(2026-11-07 源码核对) 自有 sendTransaction(4 参) eth_sendRawTransaction 固定 secp256k1+keccak256,国密链禁用;纠正上一版「sendTransaction 搜不到」的搜索假阴性(见 4.8)
— TA 密钥分级脚本层(2026-11-07 补) 硬拒绝已实现,不再只落文档 build_optee.sh --check-only 三级规则,缺 SDK 也能被第 16 条测到;prod 缺密钥绝不回落开发密钥
— SM2 distid(2026-11-07 拍板) 三重对齐,唯一值 1234567812345678 依据 FISCO fast_sm2.cpp:35 的 c_userId;三处声明任一漂移即点名拒绝
— TA 密钥 / OP-TEE 范围(2026-11-07 拍板) 三级密钥 + 只覆盖小隐私计算 分级方案与覆盖范围定稿见第 7 节
— TARS(2026-11-07 拍板) 先不上 ssw-mpc 只依赖 bcos-rpc 的 HTTP 端点
— OPA(2026-11-07 拍板) 硬规则进合约,业务合规策略仍走 OPA 两者域分隔不同、字段互相禁止、不开 WASM;签发收口到控制面
— guest 静态产物边界(2026-11-07 补) musl mpc 不许带宿主控制面 mpc-hostd / mpc-chain 归 control-plane 可选依赖并按 target 排除;交叉编译必须 --no-default-features;主门禁第 4 条三层探针钉死(见 4.8 / 6)
— 阶段 3 第一段(2026-11-07 补) OPA 真判定闭环已落地,但阶段 3 未完成 真 opa build + SM2 真签 / SM3 hash pin + 真 opa eval + decision 幂等落 outbox(第 17 条);★ OPA 不在 guest 内、撤销链读后端未接入(声明 chain 即 fail-closed 拒)、decision 未签名未上链

1. 双层控制面(本轮最大的结构变化)

1.1 为什么必须两层

单层控制面在三个地方会崩,且都是必然发生:

  1. 证明采不到。芯片报告只能由宿主机读(/dev/sev、/dev/csv-guest 就在宿主上)。站点端如果直接管 TEE,就必须把宿主机凭据发给每一方,等于取消隔离。
  2. 调度没有落点。一个联盟有 n 个机构、每机构 m 台机器,站点端要知道"哪台机器还有 SNP 容量"。这个状态只存在于宿主机。
  3. 准入判据不在一处。站点端知道"谁是联盟成员、这轮算什么",宿主机知道"这块芯片的 TCB 是多少、度量对不对"。两边都只有一半判据。

所以切分不是审美选择,是判据归属决定的。

1.2 职责矩阵

┌───────────────────────────────────────────────────────────────┐
│ 站点端控制面  mpc site(每机构一个,或联盟共置)                │
│   会话编排:谁和谁算、算什么算法、什么时候算                    │
│   成员与策略:Member 表、PolicyBundle 签发(SM2 私钥在此)      │
│   链交互:ComputeOrder / Receipt 上链,硬规则查询               │
│   跨宿主调度:按平台、TCB、余量选 host                          │
│   审计对账:会话 ↔ 订单 ↔ 回执 三方对齐                         │
└───────────────────────────┬───────────────────────────────────┘
                            │  e2b 兼容 API(HTTPS + 双向认证)
                            │  控制面 3010 / 数据面 3011
┌───────────────────────────▼───────────────────────────────────┐
│ 宿主机控制面  mpc hostd(每台物理机一个)                       │
│   sandbox CRUD  → 翻译成 TeeRuntime 调用                       │
│   TeeRuntime:qemu spawn / 状态表 / reaper / 孤儿进程校验       │
│   运行时准入:度量 pin、TCB 门槛、芯片签名、绑定值比对          │
│   本地网络:tap/bridge + 每会话一个 EasyTier 实例              │
│   证明采集:采报告 → deobfuscate → 落盘 + 上报                 │
└───────────────────────────┬───────────────────────────────────┘
                            │  vsock / tap(不进网络栈)
┌───────────────────────────▼───────────────────────────────────┐
│ guest(mpc 二进制 + 策略引擎)                                  │
│   只做计算与出证明,不持有链凭据、不发 HTTP                     │
└───────────────────────────────────────────────────────────────┘

站点端不碰 qemu,宿主机端不碰私钥。 这两条是硬边界,越界即失去多机构前提。

1.3 宿主层用 e2b 的形,不用 e2b 的义

宿主机对外提供 e2b 兼容接口(POST /sandboxes、GET /sandboxes/{id}、DELETE、POST /{id}/timeout、POST /{id}/pause|resume),因为 cbox 已经验证过这条路的形状:boxe2b 只是一个翻译层,把 E2B 请求翻成 boxlite serve 的 REST,自己不起 VM。

照搬的是这个结构:

cbox ssw-mpc 对应
boxe2b(E2B 兼容层,axum) mpc-hostd 的 API 层
boxlite serve(POST /v1/boxes) TeeRuntime(进程内,不用 REST)
state.rs 的 sandboxID → box 映射 session_id → TEE 实例
proxy 按 E2b-Sandbox-Id 反代 envd 数据面按 session 反代到 guest 的 MPC 端口
控制面 3010 / 数据面 3011 同

不同的一点,且必须不同:TeeRuntime 不走 REST。cbox 的 boxlite serve 是独立产品,所以中间有 HTTP;ssw-mpc 是单二进制交付,中间加 REST 只会带来版本漂移(agent 与 serve 不同步时,报错会指向错误的一侧)。

e2b 的 template 语义要升级。在 e2b 里 template = 镜像;对 TEE,template 必须是度量集合:kernel hash + initramfs hash + cmdline + OVMF 版本 + 平台类型。create sandbox 的实质是"用这套已 pin 的度量起一个 VM"。这个映射不改 API 形状,但改变了 template 的存储内容——它从 docker image 变成一条 MeasurementProfile 记录,且必须带签名(否则谁能改 template 谁就能改准入)。

证明不能塞进 SandboxView。e2b 的返回体里没有这个字段,硬塞会破坏 SDK 兼容。正确做法是独立端点:

GET /sandboxes/{id}/attestation
→ { session_id, platform, tcb, user_data, measurement,
    user_data_ok, meas_ok, tcb_ok, chip_sig,   ← 四项分开,不许合并
    report_sha256, collected_at }

四个布尔分开报,理由见 2.4。

1.4 准入必须拆成两段

现在的 mpc_tee::schedule::admit(req, node, binding) 是单段,因为只有一个控制面。两层之后要拆:

段 在哪 判据 失败语义
会话准入 站点端 成员资格(链上)、策略有效性(签名 + 有效期 + 未撤销)、订单 deadline、参与方集合 fail-closed,链读失败带缓存
运行时准入 宿主机端 平台一致、设备/固件/qemu 存在、度量 pin、TCB ≥ 门槛、user_data 绑定比对、芯片签名 fail-closed,无缓存

不能合并的理由是硬的:站点端拿不到芯片报告,宿主机端不知道联盟成员表。合并只能靠"其中一端信任另一端传过来的结论",那这一段就成了新的信任根,而它恰恰是最容易被攻破的一层。

admit 函数本身不用改签名——它已经在宿主侧,输入正好是 req/node/binding。新增的是站点侧的 session_admit(),它产出 TeeRequirement 而不是 LaunchSpec。

[本轮已落地] 站点侧这一段已实现为 crates/mpc-tee/src/site_admit.rs 的 session_admit(&SiteAdmission, Option<&dyn PolicyVerifier>),10 条拒绝项覆盖成员表过期、本方非成员、参与方少于两方、参与方重复、参与方非成员、订单过 deadline、策略不在有效期、签发方为空、未配置验签器、验签不通过。注意 Option<&dyn PolicyVerifier> 的 None 分支是拒绝而非跳过——mpc-core 目前只有 SHA-256/SM3/HMAC/ChaCha20,没有非对称签名,所以验签层本期只落形状与可插拔接口,不假装可用。

[本轮已落地] 宿主侧这一段的落点是 crates/mpc-hostd/src/(TeeRuntime + e2b 兼容 API + /attestation 扩展)。1.5 的三层信任建立目前只落了第一层的形状(HostClient.token 字段先留出来,宿主端尚未强制校验),签名与 token 校验是下一阶段的活——现在不要以为 token 已经在起作用。

1.5 两层的信任建立

站点端调宿主机不能用长期共享密钥(一泄全泄)。三层:

  1. 宿主机在联盟注册时把 host 公钥 + 平台类型 + 机器指纹写进 Member 表。
  2. 站点端下发任务时签一个短期 token(SM2),含 session_id、order_id、有效期(分钟级)、允许的操作。
  3. 宿主机验签 + 查 session_id 未被使用过(防重放),再执行。

TeeRuntime 的所有写操作都必须带这个 token。读操作(GET /sandboxes)也要——否则联盟成员能枚举别人机器上的负载。

1.6 三平台不是同一套形态

PlatformKind 有四个值,但只有两个能"直接启动"(PlatformProfile::builtin() 对 Optee / Tdx 返回 None,且有断言钉死)。这个差异必须体现在宿主机层,否则 e2b 的 create 会在 OP-TEE 上假装成功。

海光 CSV / AMD SNP ARM OP-TEE
宿主侧动作 Command::spawn(qemu) 拉起 VM attach 到已存在的 /dev/tee0
信任根 芯片密钥 + 度量(measurement 进报告) 设备密钥 + TA 签名
绑定值 64B user_data(报告中固定偏移) 取决于 TA 实现,长度不保证 64B
生命周期 进程级:起 → 跑 → 退 → reaper 回收 会话级:CA 打开 → 调 TA → 关会话,TA 进程一直在
回收 kill qemu 关 CA 会话。杀进程反而会切断别人正在用的 TA

所以宿主机层的 e2b 语义要分叉,但不新建接口:

POST /sandboxes          VM    → 起 qemu,返回 sandbox_id
                         OPTEE → "分配 TA 会话",返回同一套 sandbox_id(映射到 CA 会话)
DELETE /sandboxes/{id}   VM    → kill + reaper 确认
                         OPTEE → 只关会话,不动 TA 进程

为什么不在 OP-TEE 上假装是 VM:TeeRuntime 的核心是 pid + 启动时间 校验孤儿进程(2.3)。OP-TEE 没有"这个 TA 属于哪个租户"的进程语义——TA 是所有 CA 共享的,杀进程等于杀掉别人的会话。硬套会让 reaper 变成事故源。

更要紧的判断:OP-TEE 场景可能不需要 EasyTier 和链。

"小隐私计算"通常发生在设备侧、参与方少(两方居多)、跨域需求弱。给它也配组网 overlay + 联盟链存证,等于为了 5% 的场景把 80% 的重型组件全带上,而它的证明根本过不了链上验签(4.4)。

边界(已定),代码共享抽象、编排不复用:

能力 CSV / SNP OP-TEE
多方组网(EasyTier) 需要 不需要(同机/同域,直连即可)
链上存证 需要 可选:只存结果 hash 与设备身份,不存证明
控制面层数 两层 退化为一层:设备本地 CA 即控制面,无跨宿主调度
准入 会话准入 + 运行时准入 只做 TA 侧策略校验

也就是说:OP-TEE 是同一套 mpc-tee 抽象下的另一个部署形态,不是另一套基础设施。它仍在平台矩阵内,只是走独立的编译与验证通道(1.7)——Tee trait 与 optee/core.rs 的 seal 格式可以复用,但别把两层控制面、EasyTier、链一起压上去。

1.7 OP-TEE:独立编译通道与独立验证规则

决策是"单独编译 / 单独验证"。独立不是免责——本仓库的铁律是"闸门不扫自己 = 盲区 = 假安全感",所以独立必须拆成"能进主门禁的"和"只能在独立通道跑的"两段,且第二段缺环境时要显式报告,不能静默消失。

为什么必须独立(这是约束,不是偏好)

  • build/build_optee.sh 的必需环境是 OPTEE_OS(已构建的 optee_os 源码树)+ SDK_DIR(teaclave-trustzone-sdk)+ arm-linux-gnueabihf- 交叉工具链 + 固定 nightly。主门禁机器上不可能齐备。
  • 主门禁的形态与它冲突:十四条里有"跨目标 x86_64-musl 零告警""12 示例冒烟",而 OP-TEE 的产物是 armv7 的已签名 .ta,签名和 verify 都要过 sign_encrypt.py。混进去会让所有人的本地 ci.sh 变红。

段一:进主门禁的部分(零 SDK 依赖)

optee/core.rs 与 optee/proto.rs 本来就在 workspace 内编译和测试(optee/mod.rs 已写明),这部分天然被守。真正缺的是下面两条,本轮已落地:

  1. mpc-tee --no-default-features 必须能编。TA 就是按 default-features = false(no_std + alloc)构建的,而主门禁原先只守 mpc-core 的 no_std。后果很隐蔽:有人在 mpc-tee 里直接 use std::…,主门禁全绿,TA 构建在独立通道里挂。已并入 tools/ci.sh 第 3 条:

    cargo build -p mpc-core --no-default-features
    cargo build -p mpc-tee  --no-default-features
    python3 tools/check-optee-uuid.py      # 见下条
    
  2. TA UUID 对拍 —— 实际是五处,不是三处。crates/mpc-tee/ca/src/main.rs 的注释写"必须与 TA 的 main.rs、build.rs 三处一致",但仓库里是五处硬编码:

    位置 形式
    crates/mpc-tee/ta/src/main.rs pub const UUID: &str
    crates/mpc-tee/ta/build.rs TaConfig::new_default_with_cargo_env("…")
    crates/mpc-tee/ca/src/main.rs const UUID: &str
    build/build_optee.sh UUID="…"(签名 .ta 时写入)
    build/p3_optee_qemu.sh MPC_UUID="…"(QEMU 全流程,从未在注释的视野里)

    漂移的症状是 TEEC_ERROR_ITEM_NOT_FOUND("TA 找不到"),排查成本远高于一条 grep。tools/check-optee-uuid.py 要求五处彼此相等,不写死期望值(写死就等于制造第六处硬编码)。已做探针回归:把 p3_optee_qemu.sh 的 UUID 改掉一个字符,脚本报 OPTE_UUID_FAIL 并逐行指出哪一处不同;还原后回到 OPTE_UUID_OK: 5 处一致。

段二:独立通道 tools/ci-optee.sh(需要 SDK)

已创建。缺环境时打印 OPTEE_SKIPPED: 缺 N 项环境 并逐条列出缺什么(不是只说"skip"),退出 0——复用主门禁第 4 条已有的"跳过:目标未安装"语义。关键是这段输出必须存在:静默跳过和通过长得一样,是这类独立通道最常见的失真。

通道内容:check-optee-uuid.py → build_optee.sh(TA 编译 → sign_encrypt.py sign-enc → verify)→ 产物存在性校验 → --qemu 才跑 p3_optee_qemu.sh。

本机无 OPTEE_OS/SDK_DIR/交叉工具链,skip 分支已实测;构建分支尚未在真实 SDK 上跑过——这个状态必须写在这里,而不是靠"应该能行"。

验证规则:五条,每条写清"证明什么 / 不证明什么 / 现在覆盖了吗"

# 检查 证明什么 不证明什么 覆盖状态
1 TA 签名 verify TA 被 SIGN_KEY 授权、未被篡改 签名密钥本身可信(那是供应链) build_optee.sh 内置;未在真 SDK 上跑过
2 TA UUID 五处一致 CA 能加载到这个 TA — 主门禁已跑,绿
3 seal → unseal 往返 密钥派生与 seal 格式自洽 跨 session / 跨设备 CA selftest [3];需 QEMU
4 设备重启后 unseal 用的是 TA 的 storage key,不是内存态 跨设备;硬件根密钥的稳定性与唯一性 编排已实现,QEMU 未实跑,见下
5 跨设备解封必须失败 seal 绑定了设备身份,不是软编码 真板 DNA 读取正确性(仅 board feature) 编排已实现,QEMU 未实跑,见下

第 4 条有一个容易自我欺骗的地方:CA selftest 的第 [4] 步是"关掉 session 再重开",不是设备重启。它证明的是密钥在 TA 的 storage 里、不随会话消失,但不能证明重启后仍能解开(那要走 tee-supplicant 的持久化路径)。两者不能互相替代,selftest 的日志也不能当重启证据用。

第 4、5 条的实现状态(2026-11-07)

两条的编排脚本与判据都已落地(tools/optee-cross-device.sh、tools/optee-restart.sh、 build/optee-verdict.py),并接进 tools/ci-optee.sh --cross-device / --restart。 但QEMU 上的实际行为一次都还没跑过(本机无 OP-TEE SDK 与 armhf 交叉工具链), 所以现在能说"验证链路是通的",不能说"这两条已通过"。

落地时修掉的四个真问题(照着原方案写也会写错的类型),详见 docs/OPTEE_VERIF_PLAN.md:

  1. PHASE=build 不含 run —— QEMU 根本没启动,而 build 段退出 0 = "看起来跑通了"。已加 PHASE=buildrun。
  2. MODE=unseal 的判据硬编码为"必须失败",与跨重启要的"必须成功"直接冲突。已参数化为 MPC_UNSEAL_EXPECT。
  3. 判据散落三处 = 迟早分叉且分叉了没人知道。已抽成 build/optee-verdict.py(唯一真相源)。
  4. 判据逻辑在绝大多数机器上永远不会被执行(要 SDK + QEMU)。已用构造日志做分支自测, 进主门禁第 11 条(tools/selftest-optee-verdict.py)。

★ 一条容易自我欺骗的地方(判据层):判据写错时,真机上的表现全都是"验证通过" —— 没有编译错误、没有运行时异常。所以判据必须有负向判据(显式排除假失败):

  • 只判「unseal 失败」不判失败原因 → blob 根本没打进 rootfs(IO 错)也会算通过;
  • 只判「unseal 成功」不判 provisioned=true → 第二次启动又 provision 一次的伪成功。

所以跨设备必须命中 MPC_UNSEAL_TAG_MISMATCH,而 MPC_UNSEAL_BAD_FORMAT / MPC_UNSEAL_OTHER 都判假失败。

一条必须写死的边界:OP-TEE 不做远程证明

  • CSV/SNP 的报告是芯片固件签的,验证方拿到公钥就能验,信任根在芯片厂商。
  • OP-TEE 的远程证明需要额外部署(attestation TA 或 fTPM + 一个验证服务),返回的是 TA 自己构造的 quote,信任根回到 device key 的签发方——也就是"谁烧的密钥"。

也就是说:OP-TEE 的信任根是供应链,不是数学。 这轮不做 RA,就必须明确写成"OP-TEE 只能本地自证,不能向第三方证明"。

落到接口上:e2b 的 /attestation 对 OP-TEE 返回 platform_verified: false + 原因码,而不是返回一份格式相似但没人签过的"报告"。这正好接上 1.4 的两段准入——OP-TEE 的准入在站点侧(成员 + 策略),宿主侧没有芯片可判。

与 admit 的关系:OP-TEE 不进 admit(那是 VM 的五关:平台一致 / 布局解析 / 度量 pin / TCB 门槛 / 芯片签名)。它需要的是独立的 ta_admit():TA UUID + TA 签名 + TA 版本。不要复用 admit 的函数签名,否则参数只能硬塞,读代码的人会以为五关都过了。


2. 方向一:控制面直控 TEE

2.1 现状:一条"给人用"的链路

deploy/tee/launch.sh (bash)
  └─ mpc tee plan --report json --argv      # 输出 NDJSON 的 kind=table/rows
       └─ python3 从"人类表格"里抠 argv_json  # 机器反向解析人类界面
            └─ os.execvp(qemu)               # 进程交出去,控制面失联

四个断点,按严重程度排:

  1. exec 之后没有句柄。谁在跑、跑了多久、为什么退出,全无记录。这是"不能算部署"的根本原因——部署的含义是能被观察和回收。
  2. 协议是表格。--report json 的 schema 是 {"kind":"table","rows":[...]},为看板和 jq 设计。要拿结构化数据得反向解析行号,launch.sh 里的 python 片段就是这笔债。
  3. preflight 在 bash 里。宿主能力探测产出 key=value 文本,没有"再探一次"的入口。换了盘、换了 qemu 版本,没人知道。
  4. verify 只认文件。mpc tee verify --report FILE 对着历史报告判定,对"正在运行的实例"没有入口——而运行期验证才是 TEE 的意义。

2.2 cbox 能给什么、不能给什么

该学 为什么不学另一半
控制面 / 运行时两段,中间一条窄协议 boxlite/src/vmm 是自研最小 VMM。TEE 的证明依赖 qemu 的 sev-snp-guest 对象、OVMF 固件、kernel-hashes=on 的度量语义——自研 VMM 等于再也不会通过芯片验签
状态表 + reaper(每 5s 扫,stopped/error 就清) 两个独立二进制。mpc 是 fat LTO + strip 单二进制,拆 daemon 会带来版本漂移
单一协议层(换后端只改一个文件) E2B 的 API 形状作为内部协议。它只适合对外(1.3),对内是多余的
数据面反代(按 id 打到已发布端口) 端口分配方式。mpc 是 n² 网状,不是单点反代

2.3 落点:HostAgent 内嵌 TeeRuntime

[修正] 上一版说"不新造 serve、不需要 HTTP"。在单层控制面下成立;两层控制面下不成立——站点端在另一台机器上,必须有网络接口。

修正后的落点:

mpc hostd --listen 0.0.0.0:3010 --data-port 3011 --state-dir /var/lib/mpc
  ├─ API 层(axum / hyper):e2b 兼容 + /attestation 扩展
  ├─ TeeRuntime(mpc-tee 的 std feature)
  │    Entry { id, argv, pid, started_at, state, exit_code, session_id }
  │    Command::spawn(不是 exec)+ reaper 线程
  └─ 本地网络:每会话一个 EasyTier 实例 + tap

mpc cluster / mpc agent 保留原用途(多方计算的编排与执行),不承担 TEE 生命周期。两者通过 session_id 关联:

当前已实现的参数(--order / --pubkey 那套是设计蓝图,尚未接线,别照着敲):

mpc hostd --listen 127.0.0.1:3010 --state-file /var/lib/mpc/hostd.json
mpc tee up --host alice:3010 --session <hex> --site alice \
           --platform snp --program /bin/sleep --arg 30
mpc tee ps --host alice:3010                       # 状态表:sandboxID / state / platform
mpc tee attest --host alice:3010 --sandbox job-7   # 四布尔分开报
mpc tee down   --host alice:3010 --sandbox job-7   # DELETE 返回 204 空体

注意实例 ID 的参数名是 --sandbox(不是 --id),且 down 在 DELETE(204 空体)之后会补一次 GET 拿停后状态。

TeeRuntime 的实现要点没变:Vec<Entry> + Command::spawn + reaper,状态落盘,重启后按 pid + 启动时间校验孤儿进程——只按 pid 会误杀(重启后 pid 会被复用)。

2.4 "验证通过"必须拆成四句话

verify.rs 现在严格区分「结构/绑定对得上」与「芯片签名已验证」。这个区分必须原样传进 API,不能塌缩成一个 ok=1:

user_data_ok=1  meas_ok=1  tcb_ok=1  chip_sig=0

chip_sig=0 的含义是:绑定关系成立,但没做芯片验签。运维看到 ok=1 就以为安全,是最容易出的事故。fold_semantic_risks() 那种"判定口径只有一份"的纪律,在这里表现为不允许把不同结论合并成一个字段。

[本轮已落地] API 侧形状见 crates/mpc-hostd/src/api.rs 的 AttestationVerdict:user_data_ok / meas_ok / tcb_ok / chip_sig 四个布尔分开报,且响应里不允许出现 ok 这个合并字段;布尔字段缺失一律当 false("没拿到"与"不成立"在安全语义上必须同向,否则解析失败会伪装成通过)。


3. 方向二:EasyTier

3.1 前提纠正:它不是 WireGuard 的薄壳

WireGuard 在 EasyTier 里只有三个边缘角色:一种隧道协议(--listeners wg:11013,与 tcp/udp/ws/wss/quic/ring/faketcp 并列八选一)、外部客户端接入门户(--vpn-portal wg://)、一种加密选项。

主体是:peer 发现与状态、NAT 穿透(UDP/IPv6/TCP 打洞 + 对称 NAT 生日攻击)、OSPF 路由收敛、中继转发、子网代理、多协议隧道引擎、数据面、实例生命周期。仿做等于重写这一整列。

3.2 LGPL 边界本来就划得开

用法 定性 义务
静态链接进 mpc 衍生作品 整个二进制按 LGPL 分发。唯一不能碰的一档
动态链接 .so combined work 允许用户替换该库即可
独立进程 + CLI/RPC 两个独立程序 只约束被分发的那一个,天然满足"可替换"

独立进程不是规避手段,是 LGPL 明确许可的正常用法。反过来说,"仿做"才是真风险:仿得像 = 复制加修改,直接落进 LGPL 的修改版条款且很难自证独立实现。

实务细节别漏:分发时要随包附 LGPL 文本和源码获取方式(因为你分发了它的二进制)。

3.3 会话级入网:credential 是签出来的,不是派生出来的

[修正] 初稿写「credential 从 session_id 派生,与 user_data[0..32] 同源」—— 按官方文档核对后这是错的:拿 sha256(session_id) 拼 --credential 只会得到一串 EasyTier 根本不认的字节,网络「看起来起好了、实际连不上」。

EasyTier secure mode 的真实流程(官方 secure-mode.html):

# 联盟管理节点(正式节点:持 network_secret,且必须配 --credential-file 持久化)
easytier-cli credential generate --ttl 86400 [--allow-relay]
#   → credential_id     管理 ID,可公开,用于撤销与链上核对
#   → credential_secret 临时凭据私钥(base64),等价于高敏感密码

# 临时节点(本轮计算):不需要 network_secret,指定 --credential 会隐式开 secure mode
easytier-core --network-name office --secure-mode --credential '<secret>' -p tcp://admin:11010

# 会话结束
easytier-cli credential revoke <credential_id>

框架因此不生成凭据:mpc_tee::link::CredentialProvider 是可插拔接口, 参考实现 mpc_hostd::link::CliCredentialIssuer 只调 CLI; 未配置 provider 即拒绝(与 PolicyVerifier 同一纪律,不假装可用)。 框架做四件事:承载并校验形状(base64、无空白 / 控制字符,防 argv 注入)、 把 credential_id 与 session_id、user_data[0..32] 绑成可公开摘要 (域分隔 TEE_LINK_BIND,私钥不参与哈希,否则等于把私钥哈希公开)、 把摘要写进 link= 与 Receipt、会话结束撤销。

★ 两个方向别混:

  • 三档 LinkPolicy 管「我能不能经中继出去」;
  • 凭据的 allow_relay 管「别人能不能经我中继」(官方默认 false)。

初稿「allow_relay 随档位定」是错的。默认一律 false(最小权限), 只有本节点确实被指派为联盟中继时才显式授权。

管理节点必须配 --credential-file,否则重启后已签发的凭据全部失效。

3.4 relay 策略:三档,参数控制

决策 4 要求两者兼容。落到具体参数:

档 参数 适用
open(默认) 不设限制 内网全通、可用性优先
allowlist --relay-network-whitelist <联盟网名> 只允许联盟自有中继转发,公共节点不作中继
p2p-only --p2p-only 仅与已建立 P2P 的节点通信,缺直连即失败

辅助参数(按需组合,不要全部打开):

  • --disable-sym-hole-punching:关掉对称 NAT 生日攻击打洞(会被运营商风控,但 NAT4-NAT4 场景唯一的通路)
  • --private-mode:禁止不同网名/密码的节点借道本节点中转
  • --disable-p2p / --need-p2p:精细控制谁可以和本节点建 P2P

必须记录实际路径。easytier-cli peer 的 cost 列会标 p2p / relay,宿主机要把这个值写进 TEE_ATTEST 的 link= 字段和 Receipt。链路的 AEAD 让中继看不到明文,但看得到元数据(谁和谁、多大流量、什么时候)。报告里写"私有部署"实际走了公共中继,是这类系统最常见的失真。

link 值同时是准入项:allowlist 档下如果实际路径是 relay 且中继不在白名单,admit 拒绝。

3.5 不要把 EasyTier 塞进 TCB

在 guest 里跑能让元数据也进 TEE,但网络组件进入 measurement 且随版本漂移,--pin 就失去意义了。宿主侧组网 + guest 走 tap/bridge 是目标形态。

[修正] 初稿写「deploy/tee/ 已经实现了这条链路」——实际那里只有 deploy/tee/real-machine/kbs-net.sh 建的本机 tap + bridge,用途是让 guest 够到宿主上的 KBS(真机自带的 qemu 没编 slirp,-netdev user 用不了)。 那是 KBS 出网链路,不是 EasyTier 跨站点组网。EasyTier 实例本期由部署层 按 mpc link plan --argv 起,框架不托管长驻进程。

3.6 已有资产:connector 做过同一件事的 TPM 版本

ssw/studio 的 security-connector 有 TPM_INIT → AUTH_REGISTER → EASYTIER_JOIN → RUNNING 六态状态机。状态机形状和 credential 生命周期应该对齐,别搞两套入网流程。


4. 方向三:飞梭链(Pro + 国密 + 硬规则 + 无 WASM)

4.1 链上执行只有一种做法:合约

决策 3 与 6 合起来,只剩一条:

原方案 状态
A 硬规则编译成 Solidity 合约,共识节点执行 采用
B 链下执行 + 上链(无证明) 禁用。不可篡改的假话比可篡改的假话更危险
C OPA 在 TEE 内执行 + 附证明上链 保留(业务合规策略,见 4.6)
D Rego→WASM 上链 删除。WITH_WASM 保持 OFF

D 删除的连带收益:生产联盟链不用为一条没人维护的执行路径开编译开关,也不用和联盟成员对齐建链参数。

4.2 Pro 版的实际形态

组件 职责 端口(示例)
bcos-rpc 接收客户端 JSON-RPC,转发给节点;可横向扩展 20200
bcos-gateway 跨机构节点间通信;可横向扩展 30300
bcos-node 共识 / 执行 / 上链;内部再分 txpool / scheduler / pbft / ledger / front 经 tars proxy(40400+)

两个事实决定落地方式:

  1. TARS 不是必须的。官方提供 installation_without_tars:build_chain.py build -c config.toml -O ./generated 产出安装包,手动起各服务,用 tars_proxy.ini 指定模块间 endpoint。建议先用无 TARS 路径——TARS 管理台自带 MySQL + web(3000 端口),是运维团队的资产,不该成为 ssw-mpc 的依赖。
  2. 站点端只连 bcos-rpc,不连节点。这层解耦让链扩容对站点端透明。

建链(含国密):

bash build_chain.sh -p 30300,20200,40400 \
  -l <ip>:2,<ip>:2 -C deploy -V pro -o generate -t all -s
#                                                      ↑ 国密

4.3 国密的五个硬约束

① 建链时定,之后不可改。 官方注释:sm_crypto "should never be changed"。选错只能重建链、迁移数据。这是第一个必须在开工前确认的事。

② 合约里 keccak256 / sha3 实际执行 SM3。 官方 OPCODE 差异表明确写了(3.x 同样适用)。后果:链下算 hash 必须用 SM3,否则链上比对永不对,症状是"hash 不匹配",极易被误判成 ABI 编码问题。CREATE2 的地址推导也按 SM3 算,合约地址会和以太坊工具算出来的不一样。

③ 交易签名是 SM2,交易结构变长。 标准版 520 bits → 国密版 1024 bits(含 512 bits 公钥)。RLP 结构和 v 的取值都要按 FISCO 的规范来,不能套以太坊的 secp256k1 经验。

④ SM2 不在 Rust 侧实现,走国密模组 + OpenSSL provider。 接口形态已定:只走 provider,不走 engine / SDF / PKCS#11。

mpc-chain (Rust) ──FFI──▶ libcrypto(Tongsuo ≥ 8.4)──provider──▶ 国密模组
                  Signer trait     独立 OSSL_LIB_CTX                私钥不出模组

三条收益,缺一条都不值得引入 FFI:

  1. 私钥不出模组。PolicyBundle 签发私钥、Member 治理密钥放硬件里,落盘泄露和内存抓取同时失效。对一个"站点端控制面持有唯一签发权"的设计(4.6),这是必需项。
  2. 密评可过。密评看密码模块资质,不看代码质量。RustCrypto 的 sm2(官方声明"从未被独立审计")只能用于测试与离线校验,不进生产链路。
  3. 与链同源。FISCO 国密版本身就构建在 Tongsuo 上,签名/验签同一套实现,省掉一整类"格式对不上"的联调。

版本门槛是硬的:provider 是 OpenSSL 3.0 引入的架构,Tongsuo 8.4.0 才迁到 OpenSSL 3.0.2 基线;8.3.x 及以前是 1.1.1 基线,只有 engine。所以选 provider 等于把版本锁在 Tongsuo ≥ 8.4,建议 8.5——理由是它有现成资产:

  • 内置"商用密码检测和认证 Provider":身份认证、完整性验证、算法自测试、随机数自检、熵源健康测试。这几项正是密评要查的内容,不用自己写。
  • 已有"SMTC Provider 适配蚂蚁密码卡":厂商 provider 该怎么接,项目里有先例可对照,不用从零摸 OSSL provider 的接口约定。

"加载了 provider" ≠ "签名走了模组"。 这是这一节最要紧的一条。Tongsuo 自带的 default provider 里本来就有 SM2,模组 provider 注册同名算法时谁被选中取决于 libctx 与 property query。如果只做 OSSL_PROVIDER_load 就直接签,很可能一直在用软件实现而没人发现——直到密评现场被问"你怎么证明私钥在硬件里"。

对策不是"我去指定它",而是让环境里没有替代品:

// openssl crate 的 Provider::load 语义 = OSSL_PROVIDER_load + 关掉 fallback
let ctx = LibCtx::new()?;                       // 独立 libctx,不碰 default
Provider::load(Some(&ctx), "gmprovider")?;      // 该 ctx 内 fallback providers 被禁用
// 此后在该 ctx 里 new_from_name("SM2") 要么选到模组,要么失败 —— 不会静默回落

openssl crate 的 provider 模块只有 load / try_load / set_default_search_path 三个方法,没有 property query 封装(EVP_PKEY_CTX_new_from_name(ctx, "SM2", propq) 的第三个参数没暴露)。所以两条路:

  • 用 Provider::load 的"禁用 fallback"语义拿到唯一性——首选,纯 Rust 就够,且证据比 property query 更硬("不存在替代实现"比"我要求用哪个"更难反驳)。
  • 若要按 property 精确路由(同机装多个 provider),必须自己绑三个符号:EVP_PKEY_CTX_new_from_name、EVP_PKEY_sign_message_init、OSSL_PROVIDER_available。工作量不大,但要自己管 OSSL_LIB_CTX 生命周期。

启动自检三件,任一不满足就拒绝启动(对齐现有"密钥缺省 → 拒绝启动"的纪律):

检查 做法 防的是什么
provider 加载 独立 ctx 里 load 成功,且 SM2 可用 驱动 / so 没装对
私钥不可导出 读 OSSL_PKEY_PARAM_PRIV_KEY 必须失败 "私钥不出模组"变成口号
已知答案试签 固定私钥 + 固定消息 → 与 KAT 向量比对 签名格式 / distid 与 FISCO 不一致

第二条最容易被跳过,也最容易被现场戳穿:模组往往支持"导入私钥再签",而导入是双向的。必须要求 keymgmt 的私钥参数不可读,否则模组退化成一个更贵的文件。

签名输出一定是 DER,拆包是确定工程项,不是待确认项。 OpenSSL 的 SM2 走 EVP 签名接口,输出是 ECDSA-Sig-Value 的 ASN.1 DER;FISCO 交易要 64 字节裸 r||s + v。所以必须拆 ASN.1,且要处理两种情况:r/s 高位为 1 时 DER 会插 0x00(33 字节),值小时会省略前导零(可能 < 32 字节)。两边都补/截到 32 字节,长度越界即报错,不能 unwrap。

新的阻塞项:模组 distid 可设性。 SM2 签名对 (user_id, msg, pubkey) 做预处理,OpenSSL 侧通过 EVP_PKEY_CTX_set1_id 设,默认 1234567812345678。硬件模组内部的 SM2 实现可能固定 distid 或不支持自定义。这条与 4.4 的链上验签、与 FISCO 交易验签是同一个前置条件,采购时必须问清,不能等联调。

Signer 做成 trait,两个实现:SoftSigner(sm2 crate,仅测试)+ ModuleSigner(provider,生产)。单元测试不依赖硬件,CI 能跑;ModuleSigner 的集成测试标 #[ignore],靠独立通道跑(与 OP-TEE 同样的两段式,见 1.7)。

代价与边界:

  • mpc-chain 不再是纯 Rust。只影响它一个 crate:mpc-core(零依赖 / no_std)与 mpc-tee 不受影响,既有约束不破。
  • provider 是运行时 dlopen,编译期不需要模组:CI 能编,但运行期需要 libcrypto + provider so + 模组驱动三层齐备,缺哪层由启动自检指出。
  • mpc-chain 进不了 musl 静态产物——但它只跑在站点端/宿主,不需要。
  • 客户端 Tongsuo 版本不必与链节点一致(只要签名格式一致);但若要用 8.5 自带的密评 Provider,就锁 8.5。

⑤ user_data 的绑定 hash 是 sha256,链上没有 sha256 预编译。 mpc-tee/src/session.rs 用自研 sha256 算 user_data 两段。国密链只提供 sm3 和 sm2Verify 预编译,没有 sha256。所以:

链上不能重算 user_data。 链上只能存原始 64 字节,由验证方离线比对。

如果将来要求"链上可重算绑定值",必须把 mpc-tee 的绑定 hash 从 sha256 换成 SM3——那是全系统最敏感的 64 字节,且 sha256 是零依赖自研实现,换 SM3 要自己写一份。这笔账现在不要动,写进约束即可。

4.4 [修正] 链上验不了芯片签名?要分平台

上一版说"链上验不了 SNP/CSV 签名,因为没有预编译"。这句对 SNP 成立,对 CSV 不成立。

FISCO BCOS 有 CryptoPrecompiled(bcos-executor/src/precompiled/CryptoPrecompiled.cpp),提供:

function sm3(bytes memory data) public view returns(bytes32);
function keccak256Hash(bytes memory data) public view returns(bytes32);
function sm2Verify(bytes32 message, bytes memory publicKey, bytes32 r, bytes32 s)
    public view returns(bool, address);

sm2Verify 的实现是 sm2Recover(msgHash, sig) + sm3Hash(pubkey) 推地址,签名不合法则 recover 失败返回 false。这是一个真正的链上 SM2 验签。

所以分平台:

平台 芯片签名算法 链上可验? 启动形态
海光 CSV SM2-with-SM3 理论可验,走 sm2Verify。前置条件见下 qemu 直起 VM
AMD SEV-SNP ECDSA P-384 不可。无 P-384 预编译,Solidity 实现 gas 不可接受 qemu 直起 VM
ARM OP-TEE 设备密钥(P-256 或 RSA,取决于平台) 不可 CA/TA,不起 VM(见 1.6)
Intel TDX ECDSA P-256 不可。无 P-256 预编译 未实现(仅枚举)

CSV 走链上验签的三个前置条件,缺一不可,且都需实测:

  1. user id(Z 值)一致。SM2 签名对 (id, msg, pubkey) 做预处理。FISCO 的 sm2Recover 在其源码里没有显式设置 id(全仓搜不到 1234567812345678),实际用的是库默认值;CSV 固件用的 id 需从海光文档或实测确认。对不上就是永远验不过,且报错只有 false,没有原因。
  2. message 传的是 hash 还是原文。预编译签名收 bytes32 message,内部当 hash 用。如果 CSV 报告签名的是"报告的 SM3 摘要",可以直接传;如果签的是原文,要先 sm3() 再传。
  3. 公钥编码。预编译收 bytes publicKey(非压缩 SEC1,65 字节),而 CSV 报告里公钥的编码格式需核对。

结论保持不变的部分:链上验签只覆盖"芯片确实签了这段字节",不覆盖"报告内容是否合理"(TCB 门槛、度量 pin、绑定值仍需链下判)。所以验证方签名这一层不因为 sm2Verify 而取消——它只是把"我验过"升级成"链自己也能验"。

国密只在海光跑(决策)。所以这张表的实际结论是:

  • 海光 = 国密闭环:交易 SM2(模组)+ 合约 sm3/sm2Verify + 芯片 SM2,一条算法链走到底,且链上能自证。
  • AMD = 非国密主力:SNP 的 P-384 与国密无关,验证方签名层必须保留。后续若要在 AMD 上跑国密,等于"非国密证明 + 国密链"两套信任根拼接,单独做,不要混进这一轮。
  • OP-TEE = 独立通道的形态:见 1.6 / 1.7。它连"直起 VM"都不成立,验证规则也换成 TA 签名 + seal 那五条;不做远程证明,所以链上这层"验证方签名"它给不出来。

4.5 链上对象

只存 hash 与承诺,不存数据。

对象 字段(示意) 谁写
Member 机构 ID、签名公钥、TEE 平台类型、host 公钥列表、可用算力、状态 联盟治理(多签)
PolicyBundle bundle_hash、issuer、生效区间、撤销状态 站点端控制面(决策 5)
DataOffer owner、数据集摘要、可用算法 ID 列表、策略表达式 hash 数据持有方
ComputeOrder 参与方集合、catalog ID + IR hash、各方输入摘要、min_tcb、会话公钥、policy_bundle_hash、deadline 发起方
Receipt 结果 hash、decision_id、input_hash、各方签名、user_data(64B)、chip_sig 标志、link 路径 参与方 + 验证方

ComputeOrder.会话公钥 是关键:现在 mpc tee plan --pubkey 是外部传进来的,没有可信来源,中间人可替换做 MITM。登记到链上(由参与方长期密钥签名)才补上这一环。

policy_bundle_hash 留在链上、不折进 user_data:折进去能拿到密码学级绑定,但要动 session.rs 的 64 字节拆分(且国密下要换 SM3,见 4.3⑤)——代价与收益不成比例。

4.6 策略签发:内容可分散,签发必须收口

决策 5 落地为三段式:

机构 A 写策略 ─┐
机构 B 写策略 ─┼─→ 站点端控制面:校验 → 合并 → 签名(SM2)→ 发 bundle
联盟全局表  ─┘         │
                       ├─→ 分发到各宿主机(拉取 + 验签)
                       └─→ PolicyBundle 上链(bundle_hash + issuer + 有效期)

规则:

  • 内容可以来自任何地方(机构自持、联盟全局表),控制面不做内容审查,只做结构校验 + 签名
  • 签发私钥唯一在站点端。机构提交的是"策略草稿",不是"生效策略"
  • 宿主机只验签 + 验 hash + 验有效期,不判断内容合法性——判断合法性是站点端的事,宿主机判断就是第二套口径
  • 撤销通过链上状态位,宿主机每次加载 bundle 前查一次(带短 TTL 缓存)

这样解决了"审计口径散":内容分散不假,但任意一份生效的策略都能追到唯一的签发者和唯一的 hash。

OPA 的位置不变:跑在 guest 内,decision 落 Receipt。三条硬要求照旧——bundle 签名并 pin hash、每条 input 要有来源字段、decision 含 decision_id + bundle_hash + input_hash。

4.7 fail-open 与 fail-closed 必须分开

mpc_tee::schedule::admit 是全 fail-closed,没有降级分支。如果链也这样接,链挂 = 算不了。

用途 策略 理由
成员资格 / 硬规则 fail-closed,带缓存 + 短 TTL 准入错了是安全事故;缓存让链抖动不阻断计算
合规策略(OPA) fail-closed,无缓存 判定是"这次能不能算",缓存等于放宽
订单 / 回执 / decision 存证 fail-open + outbox 链是审计锚,不是执行前提

outbox 必须幂等:同一 order_id + 同一 decision_id 重复提交不产生两条记录,否则补链会写出重复账。decision_id 的确定性正好当幂等键。

4.8 mpc-chain 接入形态 —— [修正] 3.x 有 eth_ 兼容端点

  • 新建 crates/mpc-chain(std only):本期落形状层(对象规范编码 + SM3 摘要 + JSON-RPC 最小面 + 幂等 outbox + fail-closed 准入);RLP / SM2 交易签名待模组
  • 不进 mpc-core(零依赖、no_std),不进 mpc-tee(TA 侧要 no_std)
  • 链交互在宿主,不在 guest:SM2 是全新 crypto 依赖,塞进 TEE 会同时扩大 TCB 和破坏"零依赖"叙事。guest 只产出证明、decision 与结果 hash。 这条本期从「约定」升级成「可执行边界」:mpc-chain 引入 openssl 后, cargo build -p mpc-cli --target x86_64-unknown-linux-musl 直接挂在 openssl-sys 找不到 musl 版 libcrypto —— 这不是装个交叉 OpenSSL 就能糊过去, 而是「宿主控制面被编进 guest」的真实信号。修法:mpc-cli 用 control-plane feature + [target.'cfg(not(target_env = "musl"))'.dependencies] 切分,build.rs 算唯一 cfg;musl + 默认 feature 由 compile_error! 硬拒绝并 提示 --no-default-features。tools/check-guest-artifact.py 三层探针 (依赖树 / 编译期守卫 / ELF 产物标识)进主门禁第 4 条。

[修正] 初稿写「3.x 接入面是自有 JSON-RPC,不是 eth_ 兼容」—— 用 gitea 镜像核对 FISCO-BCOS/FISCO-BCOS 源码后,这是 2.x 的老结论:bcos-rpc/bcos-rpc/web3jsonrpc/endpoints/EthMethods.h:54 明确列出 eth_sendRawTransaction / eth_call / eth_getTransactionReceipt,EndpointsMapping.cpp 按枚举注册 handler。

[修正 2,2026-11-07 追加] 上一版还写「sendTransaction 全仓搜不到」—— 这是搜索假阴性:那次 search_code 带了不匹配的 path glob,空结果被当成「不存在」。实际源码把两条路径分得很清楚:

  • (以下为上游 FISCO-BCOS 仓库路径)bcos-rpc/bcos-rpc/jsonrpc/JsonRpcInterface.cpp:18 注册 m_methodToFunc["sendTransaction"];JsonRpcImpl_2_0.cpp:477 是实现,JsonRpcInterface.h:171 给出参数 [groupID, nodeName, data(hex FISCO 交易字节), requireProof] —— 4 个参数。节点用 transactionFactory()->decodeTransaction() 解 FISCO 自有交易结构,cryptoSuite()->hashImpl() 在国密链是 SM3。
  • EthEndpoint.cpp:419 把 web3 参数当 RLP Web3Transaction 解(codec::rlp::decode);web3jsonrpc/model/Web3Transaction.cpp include Secp256k1Crypto.h,txHash() / hashForSign() 都是 keccak256Hash,takeToTarsTransaction() 写死 SECP256K1_SIGNATURE_LEN 与 r||s||v。⇒ 国密链 SM2 交易不能走 web3 端点:这不是「待实测」,是源码判定。方法名兼容 ≠ 交易结构兼容。
  • bcos-executor/src/precompiled/CryptoPrecompiled.cpp:45 的 sm2Verify(bytes32,bytes,bytes32,bytes32) 是 4 个入参(不是三个):message 是 32B 摘要、publicKey 为 bytes、r/s 各 32B;内部 SM2Crypto::verify() → wedpr_sm2_verify 的 C 入参只有 公钥 / msgHash / 签名,distid 不是 ABI 入参 —— 链上这处不可配置,只能让链下与节点实现一致并用真机 sm2Verify 对拍确认。

因此 mpc_chain::rpc 同时保留两组常量:METHOD_SEND_TRANSACTION(国密链正确入口)与 METHOD_SEND_RAW_TX(web3 端点,标注仅标准版)。assert_submit_method_allowed(method, sm_crypto) 对「国密链 + eth_sendRawTransaction」一律 Config 拒绝并点名 secp256k1/keccak256;send_transaction_params() 钉死 4 参顺序。flush 的假链桩仍用 eth_sendRawTransaction 演练补链,但输出带 methodIsStub=true、guomiSubmitMethod=sendTransaction、guomiChainRejectsStubMethod=true 与 payload=canonical-bytes-not-signed-tx,绝不把桩方法冒充真链入口(第 14 条 4 条判据钉死)。

本期诚实边界(2026-11-07 当时;已被后续提交推进,见下方修正):mpc chain sign 已能用 OpenSSL 真的签出 SM2 签名;但 mpc chain flush 发出去的 payload 仍是链上对象的规范字节,不是已签名的 FISCO 交易 —— FISCO 自有交易编码(不是以太坊 RLP)待真机对拍、真实 bcos-rpc 的 TLCP 通道(Tongsuo FFI)未接入;GmSSL 进程通道环回实证已落地(第 18 条,服务端是 echo 不是真节点)。它验证的是签名 / distid 对齐 / 传输准入 / 幂等补链 / fail-open 与 fail-closed 分离 / JSON-RPC 判定这些框架自己的契约,不宣称能上链。

[修正 2026-11-08] 上段「不宣称能上链」是当时的阶段结论,现已失效: crates/mpc-chain/src/fisco_tx.rs 落地了 TARS 编码 + r‖s‖pub 128B 签名, flush --mode signed-tx 发完整已签名交易并复用 Outbox::flush_with 状态机 (不许另起一套遍历),tools/selftest-fisco-contract.py(主门禁第 22 条)在真链上 完成部署 / 调用 / 读回 / 负向矩阵 22/22 全绿。★ 签名口径也一并纠正:节点 fast_sm2_verify 验的是 e = SM3(ZA‖dataHash),不是签裸 dataHash; 详见 docs/FISCO_UPSTREAM_TRUTH.md §3.1。仍成立的只有后半段边界: 真实 bcos-rpc 的 TLCP 通道未通、硬件模组 provider 未落地、软件签名器密评不可过。

★ 配置与准入纪律: ① sm_crypto 必须显式给、false 直接拒(标准版链上用 keccak256Hash,链下没有 keccak256 实现,放行等于「摘要永远对不上」的假绿);true 已由用户确认,建链参数按国密冻结。 ② 客户端到 bcos-rpc 这一跳做国密 TLCP(用户拍板)。client_tlcp=true 是合法声明;false 在生产路径 flush --transport tlcp 被拒。明文只允许显式 --transport stub 桩自测并打印警告 —— 传输形态没有默认值,不许留「没传就悄悄降级」的后门。 ③ 签名器按用户「先用 openssl 做」落 OpenSslSoftwareSigner:真签 SM2,把 OpenSSL 的 DER ECDSA-Sig-Value 拆成 FISCO 要的 raw r||s 64B,公钥去掉 04 前缀成 64B。但软件私钥可导出、密评不可过:SignerPolicy::ProductionModule 一律拒绝它,开发必须显式选 DevelopmentSoftware 并把警告透给运维;security_profile() 与「私钥不可导出」交叉校验,禁止软件谎报硬件模组。不引 RustCrypto sm2 crate(未经独立审计)。

★ distid 三重对齐:唯一值 1234567812345678,真相源 mpc_core::domain::SM2_DISTID。依据是 FISCO 上游 bcos-crypto/bcos-crypto/signature/fastsm2/fast_sm2.cpp:35 的 const char* c_userId = "1234567812345678",与 OpenSSL SM2 默认 user id 同值;同文件 c_R_FIELD_LEN=32 / c_S_FIELD_LEN=32 / c_PUBLICKEY_LEN=64 也印证裸 r||s 与裸公钥格式。三处消费方(链下签名 / 链上验签 / CSV 证明验签)都必须声明它,aligned_distid() 任一漂移即点名拒绝。硬证据是系统 openssl dgst -sm3 -verify 验过框架签出的签名(门禁第 15 条)—— 只在 Rust 里自签自验是循环自证,测不到 distid 漂移。

★ TLCP 本机实测与 GmSSL(2026-11-07 用户提点后追加):OpenSSL 4.0.3 的 openssl ciphers -v 无 TLCP 套件、无 tongsuo;用户指出可用 GmSSL(开源免费、Apache-2.0),brew install gmssl 装到 3.2.0:gmssl tlcp_server -help / tlcp_client -help 支持 SM2 双证书,套件名是 TLS_ECC_SM4_CBC_SM3 / TLS_ECC_SM4_GCM_SM3(与 Tongsuo 的 ECC-SM2-SM4-CBC-SM3 命名不同,TLCP_CIPHER_SUITES 合并白名单收两套名字)。tools/selftest-tlcp-gmssl.py 现场生成 SM2 根 CA + 签名/加密双证书、真起服务端与客户端,本机环回握手跑通:Protocol: TLCP / Version: TLCP (0101) / 国密套件 / 应用数据往返 / -certout 双证书;负向(错误 CA → tls_cert_chain_verify、纯非国密套件 → tls_ctx_set_cipher_suites)都带期望特征,19 条判据进第 16 条。另:gmssl certgen -help 明写默认 -sm2_id 就是 1234567812345678,与 SM2_DISTID 做跨实现对拍(第 16 条判据)。

★ 但绝不能把「本机握手通过」说成「通道已通」:① GmSSL 3.x 移除了核心的 OpenSSL 兼容 API(libgmssl 是独立 ABI),不能当 provider 直接喂给 reqwest;② 服务端是环回 tlcp_server,不是 bcos-rpc,也没验证节点是否启用 TLCP;③ Rust 侧把 JSON-RPC 经 TLCP 发出去的进程通道(gmssl tlcp_client -in file,响应走 stdout)已接入 TlcpTunnel 并跑通环回 echo 实证(第 18 条),但服务端是 echo 不是真节点,不等于 bcos-rpc 通道已通。所以 TlcpReadiness 已从 NeedsFfi 推进到 LoopbackReachable(环回可达),但仍非 Ready、require_transport() 发真交易继续 fail-closed;脚本成功只打印 GMSSL_TLCP_TUNNEL_OK + BCOS_RPC_NOT_VERIFIED。GmSSL 是软件实现、私钥可导出,不能过密评,不替代硬件国密模组。本机 OpenSSL 4 用 CLI 自签 SM2 X509 报 wrong public key type,双证书正向校验仍待真机环境对拍;负向(非法配置即拒、环境缺失即拒)已在第 15 / 16 条真跑。

★ HttpChainClient 显式 .no_proxy():控制面只连配置里的 host:port。系统代理会把这一跳的端点换掉 —— 桩测试里表现为回环端口被代理接走后返回 502(而不是 Connection refused),生产里会让国密 TLS 的实测结论整个失效(TLS 终止点变了)。门禁第 14 条有专门回归探针。

4.9 不要重复 WeDPR

镜像里有 WeBankBlockchain/WeDPR——微众自己的"区块链 + MPC"平台,已经把"平台化集成"走完了。ssw-mpc 如果也做"链上管数据集、管项目、管任务",就是用更少资源重做一个更弱的 WeDPR。

差异化只有一条,且恰好是 WeDPR 没做的:可验证执行。WeDPR 证明"计算按协议做了"(密码学层),ssw-mpc 能额外证明"这段二进制,在这个 TCB 上,用这把会话公钥、按这份策略算的"(硬件层)。链上存证要把后者当主字段。


5. 交汇点:会话是唯一主键

                    ┌──────────────────────────────────────────┐
                    │  Session(session_id + session_pubkey)    │
                    └──────────────────────────────────────────┘
                          │                │                │
        ┌─────────────────┘                │                └─────────────────┐
        ▼                                  ▼                                  ▼
  TEE 绑定                            EasyTier 入网                      飞梭链登记
  user_data[0..32] = sha256(          短期 credential(会话派生)        ComputeOrder.会话公钥
     domain‖session_id‖site‖pubkey)   allow_relay 单独授权(默认 false)   ComputeOrder.policy_hash
  user_data[32..64] = sha256(         会话结束即失效                    Receipt.decision_id
     domain‖measurement‖platform‖tcb)                                    Receipt.user_data(64B)
        │                                  │                                  │
        └──────────► 会话准入(站点)· 运行时准入(宿主)◄─────────────────────┘
                               │
                               ▼
                  LaunchSpec → qemu → guest 内 mpc + 策略引擎

四个约束:

  1. user_data 已经绑定会话公钥(crates/mpc-tee/src/session.rs:75),链上登记的会话公钥与报告里的公钥天然可对齐,不需要新协议。
  2. EasyTier credential 由管理节点签发(不是从 session_id 派生)。框架把 credential_id 与 session_id、user_data[0..32] 绑成摘要(域分隔 TEE_LINK_BIND)写进 link= 与 Receipt;会话结束由控制面 credential revoke,凭据与报告一起失效。私钥不参与摘要计算。
  3. Receipt.user_data 存原始 64 字节,不存链上重算值(国密链无 sha256 预编译,见 4.3⑤)。
  4. 准入拆两段:站点管成员与策略,宿主管度量与芯片。链的硬规则在站点段,芯片判定在宿主段。

6. 实施顺序

阶段 内容 新增依赖 风险 前置
0a 拆两层:mpc-hostd(e2b 兼容)+ TeeRuntime + /attestation + 站点侧 session_admit 中(axum + tokio + reqwest,只在独立 mpc-hostd crate) 中(协议设计、token 信任链) —
0b OP-TEE 独立通道:tools/ci-optee.sh + 五条验证规则 + ta_admit 零(复用 build/build_optee.sh) 低(不碰主链路) —
1 链路:EasyTier 进程化 + 三档 --link-policy + credential + link 上报 零(外部二进制) 中(LGPL 合规、TUN 权限、relay 可见性) 0a
2 mpc-chain:形状层 + OpenSSL 国密签名 + GmSSL 本机 TLCP 真握手 + Rust 侧 TLCP 进程通道环回实证已完成(对象 / JSON-RPC / outbox / 准入 / SM2 真签名 / distid 对齐 / TLCP 契约 / 治理形状 / TlcpTunnel 进程通道);真实 bcos-rpc 的 TLCP 通道 / RLP / 国密模组 provider 待环境与硬件 中(serde_json + reqwest + openssl,仅 mpc-chain;国密模组 / Tongsuo FFI 未落地) 高(国密不可逆、真实 TLCP 通道环境、CSV 验签待实测) 0a
3 策略:OPA 进 guest + 控制面签发 bundle + decision 上链。第一段已完成(控制面真签 bundle + 真 opa eval 判定 + decision 幂等落 outbox,第 17 条);guest 内执行 / bundle 分发 / 链上撤销状态位读取后端 / 已签名交易上链未落地 中(OPA 二进制 + bundle 分发) 高(bundle 灰度与撤销、TCB 边界) 2
4 Rego→WASM 上链 — — 删除(决策 6)

阶段状态(2026-11-08 追加 TLCP 进程通道后,历史快照):0a 已完成(第 12 条)、1 已完成(第 13 条)、2 形状层 + OpenSSL 国密签名 + GmSSL 本机 TLCP 真握手 + Rust 侧 TLCP 进程通道环回实证已完成(第 14 / 15 / 16 / 18 条);3 第一段已完成(第 17 条:真 OPA bundle 签发 / 真判定 / decision 幂等存证);0b 的编排与判据已实现、QEMU 实跑待有 SDK 的机器。主门禁共 18 条(当时)。

[当前状态 2026-11-08] 上段与紧随其后的「两段诚实边界」都是当时的阶段结论, 不是现状。现在:主门禁 25 条(第 21 条真交易编码、第 22 条真链合约、第 23 条 SA 扩展模式、第 24 条零种子守卫、第 25 条集群自报判据自测 + 破坏实验); 阶段 2 的 FISCO TARS 编码与已签名交易已落地并在真链实证;阶段 3 的 合约部署已实证(MpcHardRule.sol)。但「OPA 在 guest 内执行 / bundle 分发 / 链上撤销状态位读取后端 / decision 签名上链」仍未做,QEMU 实跑仍待 SDK。 逐条对照见本文顶部状态提示,总览见 docs/INDEX.md。 ★ 两段诚实边界(2026-11-07 当时)都不许冲掉:① 当时阶段 2 仍不含真实交易签名上链(★ 现已落地:TARS 编码 + 已签名交易 + 真链实证,见文首状态提示)—— FISCO 自有交易编码 / 国密模组 provider / 真实 bcos-rpc 的 TLCP 通道当时未落地(后两者至今仍未落地;Rust 侧 TLCP 进程通道环回实证已落地,但服务端是 echo 不是真节点),见 4.8 与 tools/fisco-realnode-probe.py;② 阶段 3 只完成第一段 —— OPA 仍在宿主 / 控制面 spawn,不在 guest 内执行,撤销来源分两类(调用方本地桩 / --revocation chain 声明链读),链读后端未接入 ⇒ 声明 chain 即 fail-closed 拒(绝不默认 revoked=false 放行),decision 只入 outbox、未签名未上链;合约部署当时未做(现已真链实证),OPA bundle 的 guest 分发仍未做。成功输出为 OPA_DECISION_OK + OPA_GUEST_NOT_VERIFIED + CHAIN_NOT_VERIFIED,不是「阶段 3 已完成」。

★ 第 4 条门禁本轮补上 guest 产物边界:mpc-chain 引 openssl 后 musl 静态产物链接失败, 暴露的是「宿主控制面被编进 guest」而不是环境缺包。现按 feature + target 切分, tools/check-guest-artifact.py 三层探针(依赖树 / 编译期守卫 / ELF 标识)进主门禁; deps 不依赖 musl target 是否安装,避免「跳过目标」把边界判据一起跳掉。 本轮(2026-11-07 当时)./tools/ci.sh 18 条全绿(现为 25 条):第 4 条 guest 探针 22(deps)/ 3(guard)/ 15(binary)、 第 14 条 50、第 15 条 36、第 16 条真握手 19 + TA 密钥 16 + 两份零依赖契约判据 11 / 12、第 17 条真 OPA 闭环 41 + 零依赖判据 22、第 18 条 TLCP 进程通道环回实证 15 + 零依赖判据; 第 10 条芯片验签器自测现含 SNP + CSV 两平台(CSV 零依赖 18 条); 真机契约实跑如实输出 FISCO_REALNODE_SKIPPED 与 6 项缺失,无静默通过。

★ 两台真机的实测结论(2026-11-07) 见 docs/REAL_MACHINE_FINDINGS.md。三条改变了代码: ① 海光 CSV 的官方 SM2 签名不覆盖 MAC 字段(篡改 MAC 末字节后官方输出逐字节相同、 仍 verify success)⇒ wrapper 去掉永不命中的 MAC 断言,边界固化成判据; ② 海光官方验签器缺证书时联网从 cert.hygon.cn 下载,链结论其实来自网络 ⇒ wrapper 链校验模式强制 unshare -rn 断网 + 本地前置校验证书齐全; ③ AMD SNP 侧用当前 HEAD 的产物,五关闭环 + 负向矩阵真机跑通 (guest 与 KBS 判定器用同一份 musl 产物 ⇒ 验证方与放行方同源)。 ★ TCB 门槛关必须单独可达:设 guest 侧 MIN_TCB=99 时拒在更早的节点准入层, 根本没走到 KBS;要测到 KBS 侧的 TCB 关必须 --tcb 3(实际值)+ --min-tcb 99(门槛)。

为什么 0a 必须第一:后三件都要"可编排的对象"。没有 TeeRuntime 和 e2b 接口,"给这个会话签 credential""把这轮登记上链"都没有承载点。

HTTP 栈决策:两次反转,最终用 axum + tokio + reqwest(2026-11-07)

这一项来回过两次,如实记下来,免得后来人按旧的段落改代码:

  1. 初稿写「axum + tokio,仅宿主二进制」。
  2. 0a 开工时拍板改自研 std::net,零第三方依赖,理由是仓库的低依赖定位与 no_std 双守。
  3. 最终改回开源组件。触发点是实测:自研层把响应头与 body 分两次 write_all,而端到端测试只 read 一次,TCP 是流 —— 25 轮主门禁压测偶发红 2 次。查这类问题要自己啃 HTTP 流语义,而它跟隐私计算没有半点关系。用户拍板:「用开源 http 组件,别自己折腾了」。

代价与它换来的东西:引入约 100 个传递依赖(hyper / tower / tokio / serde / url / icu …)。换来的是 HTTP/1.1 解析、分块、长度校验、keep-alive、半开连接超时全部由成熟实现承担,上述偶发失败连同类问题一起消失。

阶段 1 落地(2026-11-07):协议层 crates/mpc-tee/src/link.rs(no_std,站点侧与宿主侧共用一份判据)、 进程层 crates/mpc-hostd/src/link.rs(只 spawn 外部二进制,这是 LGPL 明确许可的独立程序用法)、 CLI crates/mpc-cli/src/link.rs(mpc link plan|verdict|credential)。 链路不进 e2b 兼容面:mpc hostd 只管 TEE 实例,链路有独立凭据与生命周期, 硬塞成 tee up --link-policy 会造出「参数传了但没人据此起进程」的假接口。 长驻进程由部署层 exec,与 mpc tee plan --argv → deploy/tee/launch.sh 同构。 tools/selftest-link.py 53 条判据进主门禁第 13 条,用桩跑完整链路(本机无 EasyTier 二进制)。

★ 本期抓到并修掉的两个真 bug:① easytier-cli peer 会列多行,只判第一行会把第二行 relay 藏成 link=p2p(改为 aggregate_observations 取最严路径 + 回归探针); ② p2p-relay 这种含糊 cost 被前缀匹配判成 P2p(改为 Unknown → 拒绝)。

★ 依赖必须落在独立 crate mpc-hostd,不能落在 mpc-tee:build/build_optee.sh 会把整个 crates/mpc-tee 拷进 OP-TEE SDK 的 workspace 做 armv7 离线交叉编译(TA 是 no_std + alloc)。哪怕把 axum 标成 optional,Cargo 解析阶段仍要能拿到这些 crate,没网的 SDK 环境会直接挂。所以 mpc-tee 保持零 crates.io 依赖、连 build.rs 都移走了;mpc-hostd 独立成 crate,mpc-cli 依赖它。这是硬约束,不是风格偏好。

保留的边界(框架默认行为不等于我们的契约,handler 里显式判):Transfer-Encoding: chunked → 400 并说明原因、重复 Content-Length → 400(hyper 在解析层就拒,空体、没进业务层)、body > 4 MiB → 413。客户端侧同样 fail-closed:只认 host:port、带超时、响应必须 2xx 且有准确 Content-Length、非 2xx 带出服务端 message、204 空体容忍。

没换的部分:json.rs(自研 JSON 编解码)保留。它不是 HTTP 层,且被 TeeRuntime 的状态落盘复用;换它要动 1500 行运行时代码,风险大于收益。若要彻底替换,应作为独立一轮做,并保留「键有序 + 状态文件可回读」的回归测试。

阶段 2 落地(2026-11-07,形状层 → 国密签名):新建独立 crate crates/mpc-chain(serde_json + reqwest + openssl), 模块:objects(ChainObject::canonical_bytes 唯一实现,域分隔 TEE_CHAIN_OBJECT + 类型标签 + 4 字节大端长度前缀, Receipt 四布尔分开、签名不进被签内容)、rpc(2026-11-08 纠正:国密链用自有 sendTransaction(4 参)/ call / getTransactionReceipt,eth_call / eth_getTransactionReceipt 实测 method-not-found, 并非「3.x eth_* 兼容端点」;HTTP 200 + error 判失败、result:null 不算成功、 .no_proxy())、outbox(复合幂等键、fail-open、坏行拒绝、临时文件 + rename 落盘)、admission(fail-closed、 expires_at 过期即拒)、signer / sm2 / tlcp / policy / fisco_tx(软件 SM2 真签名、distid 三重对齐、 TLCP 双证书准入、硬规则与 OPA 分域、TARS 交易编码与 SM2 ZA 预哈希签名)。 2026-11-07 当时:FISCO 自有交易编码 / 模组 provider / 真实 bcos-rpc 的 TLCP 通道仍未实现, 不宣称能上链(Rust 侧 TLCP 进程通道环回实证已落地,第 18 条)。

[修正 2026-11-08] FISCO TARS 编码与 r‖s‖pub 128B 已签名交易已落地, 真链合约部署 / 调用 / 读回已实证(第 21 / 22 条,22/22 全绿),签名口径是 e = SM3(ZA‖dataHash)。仍未实现的只有国密模组 provider 与真实 bcos-rpc 的 TLCP 通道;软件签名器私钥可导出 ⇒ 密评不可过。见 docs/FISCO_UPSTREAM_TRUTH.md。 CLI mpc chain digest|submit|flush|status|admit|keygen|sign|align|tlcp|governance; tools/selftest-chain.py 50 条判据进主门禁第 14 条(含国密链提交方法纠正的 4 条)、 tools/selftest-chain-gm.py 36 条判据进第 15 条(含系统 openssl CLI 独立验签与 GmSSL 套件名白名单),均用桩跑完整链路。 第 16 条新增 tools/selftest-tlcp-gmssl.py(真 TLCP 握手 19 条)、 tools/selftest-ta-key-tier.py(三级密钥 16 条)与 tools/fisco-realnode-probe.py(真机对拍契约 12 条零依赖判据); 前两者的 --self-test / TA 探针不依赖 GmSSL 或 SDK,判据永远能被执行到。

阶段 3 第一段落地(2026-11-07):新增 crates/mpc-chain/src/opa.rs(阶段 3 与链上层 同 crate,因为 bundle 签发 / decision 存证都在宿主侧),CLI mpc chain opa sign|decide,判据 tools/selftest-chain-opa.py 进主门禁第 17 条。 两个新域分隔 TEE_OPA_SIGNED_BUNDLE / TEE_OPA_DECISION 进 domain.rs (前者与 TEE_OPA_BUNDLE 分开:策略对象形状 ≠ 真 bundle 字节的签名对象)。

链路:opa build 出真 bundle → SM3 hash pin + SM2 真签(canonicalHex / derSigHex 供系统 openssl dgst -sm3 -verify 独立验签)→ 每次决定时 hash pin + 验签 + 有效期 + 撤销视图 + input.source 五道 fail-closed → 真 opa eval → decision(decisionId, bundleHash, inputHash) 幂等落 outbox。 判据 40 条真闭环 + 18 条零依赖 --self-test,每条负向带期望拒绝特征。

★ 三个真正抓到过的假绿陷阱(都写成了回归判据): ① opa eval 查不存在的规则返回 {}(没有 result),把 undefined 当 「默认 deny」会掩盖「bundle 根本没加载 / 查询写错」——必须拒绝; 输出还要求恰好一个 bool(非零退出 / errors / 多结果 / 非 bool 一律拒)。 ② 负向探针若在 shell 里把整串参数当成一个 argv(zsh 不分词),CLI 会回 「未知参数」而 rc≠0 —— 只判 rc≠0 会把探针自己的 bug 当成拒绝成功; 判据脚本一律用列表参数,并显式排除「未知参数」特征。 ③ manifest 里的 canonicalHex 只能用于外部对拍,验签必须重算;否则 改 bundle 后顺手改清单即可绕过。判据用「改 bundleId」单独测这一层。

★ 诚实边界:OPA 跑在宿主 / 控制面(只 spawn 外部二进制,不在 guest 内), 撤销来源两类:调用方本地桩(新鲜度 TTL 30s)或 --revocation chain 声明走链上 撤销状态位读取(ChainRevocationReader 契约已落,后端未接入 ⇒ fail-closed 拒, 绝不默认 revoked=false 放行), decision 只是 outbox 存证(未签名、未上链),软件签名器生产策略仍必拒。 判定 fail-closed 且无缓存,存证 fail-open,两者不许混。

★ fail-open 与 fail-closed 不许混:链是审计锚(存证侧链挂照算、条目入队等补链), 成员资格与硬规则是安全前提(缓存缺失 / 过期 / 非成员一律拒绝)。两侧各写一份,绝不互相借用策略。

★ 本期抓到并修掉的两个真问题:① reqwest 默认跟随系统代理,链挂时返回代理的 502 而不是「连不上 bcos-rpc」—— 显式 .no_proxy() + 回归探针;② JSON-RPC 的失败走 HTTP 200 响应体里的 error 字段,parse_response 必须先判 error 再判 result,顺序反了就是假绿。

门禁见 tools/selftest-hostd.py(主门禁第 12 条,33 条判据),其中新增「连续 20 次请求都拿到完整响应体」——这条就是钉死上述偶发失败的回归探针。

为什么 1 可以紧跟 0a:改动面在 mpc-node 之外(地址列表 + 编排层),与 0a 不冲突。

为什么 0b 与 0a 并行且不能无限拖:OP-TEE 不阻塞任何后序阶段,但它有一个"独立通道 = 永久不跑"的固有风险。所以把它排在 0a 旁边而不是最后:先让 ci-optee.sh 存在并在有 SDK 的机器上跑通一次,哪怕后面几个月没人动它。只有"跑过一次"的通道才可能在需要时救场;从没跑过的通道等于不存在。

为什么 2 需要两条前置:

  • sm_crypto 建链后不可改。先按标准版建起来,后面再改等于重建。
  • 国密模组有采购与驱动周期。阶段 2 的第一天就该能签出一笔交易,如果模组还在采购,整段会空转。所以模组选型要和阶段 0 并行启动(见 7.2)。

0a 的三个交付物要先定形状:MeasurementProfile(template = 度量集合,带签名)、/attestation 的返回 schema(四个布尔分开)、以及 OP-TEE 的 /attestation 应答(platform_verified: false + 原因码,见 1.7)。这些接口一旦发出去,后面改就是破坏性变更。


7. 剩余待定与待验证

已拍板(2026-11-07)

  1. sm_crypto=true 已确认。建链参数按国密冻结,不可逆;配置层 false 一律拒。
  2. 国密签名先用 OpenSSL 软件实现。真能签 SM2(DER→raw 64B);但私钥可导出、密评不可过,生产仍要换硬件模组 provider。采购规格书条件不变:provider 形态、私钥不可导出、distid 可设、Tongsuo ≥ 8.4(建议 8.5);engine 形态不接受。软件实现只是把链路打通,不替代采购。
  3. 客户端到 bcos-rpc 做国密 TLCP 已定。本期落双证书契约 + 环境探测 + fail-closed;用户提点后装了 GmSSL 3.2.0,本机环回真 TLCP 握手已跑通(第 16 条 19 判据),Rust 侧 TLCP 进程通道也已环回实证可达(第 18 条,spawn gmssl tlcp_client 收发真实 JSON-RPC),但真实 bcos-rpc 是否启用 TLCP 仍未验证(服务端是 echo 不是节点),见 4.8。Tongsuo FFI 不再是唯一路径。
  4. OP-TEE 覆盖范围定稿:只覆盖小隐私计算(两方、设备侧、同域),不进 EasyTier、不进链、不进 TeeRuntime 进程生命周期(它是会话级 attach /dev/tee0,杀进程会切断别人正在用的 TA)。CI 覆盖 QEMU 五条判据,真板作为上线前一次性验收;两者证明的东西不同,不能互相替代。
  5. SM2 distid 三重对齐已定:唯一值 1234567812345678(FISCO fast_sm2.cpp:35 的 c_userId 与 OpenSSL 默认同值),真相源 mpc_core::domain::SM2_DISTID;三处声明任一漂移即点名拒绝,系统 openssl CLI 独立验签为硬证据(门禁第 15 条)。模组内部若硬编码别的值,采购验收时必须实测对齐。
  6. TA 签名密钥分级定稿:三级 —— ① dev:仓库内 default_ta.pem,仅 QEMU / CI;② staging:MPC_TA_SIGN_KEY 指向受控密钥,预发布验收;③ prod:由设备厂商 / OEM 持有,ssw-mpc 不持密钥。build_optee.sh 缺生产 SIGN_KEY 时不得回落开发密钥。2026-11-07 补:脚本层硬拒绝已实现,不再只落文档 —— build/build_optee.sh --check-only 把三级解析放在 OPTEE_OS 检查之前;prod 缺密钥 / 用开发密钥、staging 缺受控密钥、dev 无 QEMU/CI 标记、两个密钥变量同时给、非法 tier 一律以 MPC_TA_KEY_FAIL: 独立短行拒绝。tools/selftest-ta-key-tier.py 16 条判据进第 16 条,在没 SDK 的机器上也能被执行到(守卫不会被前置环境检查抢先)。

待实测(不阻塞开工,但阻塞上生产)

  1. 模组能否直接输出裸 r||s。DER 拆包本身是确定的(4.3④),所以这条不阻塞;但如果模组能直接出裸值,就少一段容易写错长度的 ASN.1 解析。

  2. CSV 报告的公钥编码与签名对象(原文 or SM3 摘要),决定 sm2Verify 的三个入参怎么填。

  3. EasyTier 三档在目标网络的实际表现。p2p-only 在 NAT4-NAT4 场景会直接失败,要确认业务能接受。 9b. EasyTier 真机必须补的三处对拍(本期用桩,不能拿"本机没装"当通过): easytier-cli credential generate 的输出排版(parse_credential_output 现按 key: value 解析, 解析不出即拒、不假装成功);easytier-cli peer 的 cost 列实际取值 (parse_peer_cost 认不出一律 Unknown → 拒绝);中继网络名的观测源 —— peer 只给 p2p/relay,不报经的是哪个中继网,所以 allowlist 档目前靠 --relay-network 的宿主配置声明核对,真机要补 RPC / route 观测后才能算 「实际路径已核对」。p2p-only 档不受影响(见 relay 即拒)。 9c. FISCO 真机必须补的四处对拍(2026-11-07 已契约化,见 tools/fisco-realnode-probe.py,第 16 条 12 条零依赖判据):

    [销账 2026-11-08] ① 的「节点是否接受我们的 data 编码」与 ④ 的 「flush 要发已签名 FISCO 交易」已完成:TARS 编码落地、真链合约 部署 / 调用 / 读回 22/22 全绿(第 22 条)。②(真实 bcos-rpc TLCP 通道) 与 ③(CryptoPrecompiled.sm2Verify 真机对拍)仍未做。 ★ 本探针脚本本身仍是历史契约:缺环境 FISCO_REALNODE_SKIPPED、 全齐也只报 NEEDS_IMPL,不等于真链验收;真链验收只认第 22 条脚本。 ① 源码已判定:国密链交易走自有 sendTransaction(4 参), eth_sendRawTransaction 是 secp256k1+keccak256 的 web3 端点、国密链禁用 (见 4.8);真机仍需对拍节点是否接受我们的 data 编码。 ② 客户端到 bcos-rpc 是否真要求国密 TLCP —— 本机环回握手通过不算, 服务端是 gmssl tlcp_server 不是节点。 ③ CryptoPrecompiled.sm2Verify(bytes32,bytes,bytes32,bytes32) 四入参: message 是 32B 摘要、公钥是 bytes、r/s 各 32B;distid 不在 ABI, 链上不可配,只能链下对齐 + 真机对拍(见 4.4 / 4.8)。 ④ 模组到位后 flush 要发已签名 FISCO 交易而非规范字节,并补一笔真机交易对拍。 ★ 契约纪律:缺环境打印 FISCO_REALNODE_SKIPPED + 逐项缺失; 环境全齐也只报 FISCO_REALNODE_NEEDS_IMPL(缺的是实现),绝不打印通过。

  4. OP-TEE 在 TA 共享语义下的租户隔离。TA 是设备级单例,多机构共存时密钥域怎么分——optee/core.rs 的 seal 格式是否已带租户维度,要核对。这条现在是生效的(OP-TEE 已进本轮,见 1.7)。

已拍板(2026-11-07)

  1. Pro 版先不上 TARS。ssw-mpc 只依赖 bcos-rpc 的 HTTP 端点,TARS 留给运维团队自建(4.2)。
  2. 硬规则进合约,业务合规策略仍走 OPA。两者域分隔不同(TEE_CHAIN_HARD_RULE / TEE_OPA_BUNDLE)、字段互相禁止(HardRuleSet 拒 wasm / rego,OpaPolicyBundle 拒 min_tcb 等硬规则字段)、不开 WASM;策略签发收口到站点端控制面。第 15 条落对象形状与边界守卫;第 17 条落阶段 3 第一段(真 bundle 签发 / 真 opa eval / decision 幂等存证),但 OPA 仍不在 guest 内、撤销链读后端未接入(声明 chain 即 fail-closed 拒)、decision 未签名未上链;合约部署已于 2026-11-08 真链实证(第 22 条,MpcHardRule.sol),OPA bundle 的 guest 分发仍未做。

附:事实来源

本项目

  • crates/mpc-tee/src/schedule.rs(admit 单段准入、LaunchSpec、qemu_argv)
  • crates/mpc-tee/src/site_admit.rs(站点侧准入,产出 TeeRequirement 而非 LaunchSpec;session_admit() 10 条拒绝项;PolicyVerifier 为可插拔 trait,未配置验签器即拒绝(不是"不验就放过");SitePolicy::canonical_bytes() 给出唯一确定的签名对象——字段顺序固定 + 列表长度显式编码 + 4 字节大端长度前缀 + 域分隔 mpc_core::domain::TEE_SITE_POLICY,签名本身不编进被签内容(否则自指))
  • crates/mpc-hostd/src/runtime.rs(TeeRuntime:Command::spawn + reaper + 状态落盘;必须持有 Child 句柄并用 try_wait() 收割,否则 Rust 的 Child 在 drop 时不 wait → zombie → process_alive 永远为真 → reaper 永远收不掉;存活与身份是两个独立判据——存活由子进程句柄 try_wait() 判定,身份优先级为「有句柄 ⇒ 身份天然确定」(句柄指向内核里那个具体进程,pid 在被回收前不可能复用)→「无句柄(重启恢复的孤儿)⇒ 才用平台启动标识做三态判定」,Some(false) 绝不发信号、None 不发信号(fail-closed);signal_pid 必须跨平台——Rust 标准库只有 Child::kill()(= SIGKILL),没有 SIGSTOP / SIGCONT,而这两个是 pause/resume 的唯一实现,不能按平台 cfg 掉)
  • crates/mpc-hostd/src/api.rs(e2b 兼容面:SandboxView 字段名必须与 e2b 一致——templateID/sandboxID/clientID/envdVersion/envdAccessToken/domain/alias/timeout/memory;扩展字段放同一层不嵌套(嵌套会让老 SDK 反序列化失败);GET /sandboxes 返回裸数组;DELETE /sandboxes/{id} 返回 204 空体(e2b 硬要求,不能改成 200 + JSON);AttestationVerdict 的四个布尔分开报,布尔字段缺失一律当 false——"没拿到"与"不成立"在安全语义上必须同向)
  • crates/mpc-hostd/Cargo.toml(axum 0.8 + tokio 1 + reqwest 0.12 blocking;依赖只落在这个独立 crate,mpc-tee 保持零 crates.io 依赖、连 build.rs 都移走了——build/build_optee.sh 会把整个 crates/mpc-tee 拷进 OP-TEE SDK 做 armv7 离线交叉编译,Cargo 解析阶段不能要求拿到 axum)
  • crates/mpc-hostd/src/server.rs(axum / hyper 接管协议层;fallback 单 handler 把 axum 请求转成 protocol.rs 的中间表示再交给 api::dispatch——路径分段规则只留一份,不在路由层重写一遍;显式把守三条边界:chunked → 400、重复 Content-Length → 400、body > 4 MiB → 413;204 空体)
  • crates/mpc-hostd/src/protocol.rs(协议无关的 Request/Response/Status 中间表示 —— 换协议栈不换业务判定的隔离带;自研 HTTP 解析器 624 行已删)
  • crates/mpc-hostd/src/client.rs(reqwest blocking 客户端;fail-closed:endpoint 只认 host:port、路径必须以 / 开头且无控制字符(防请求头注入)、连接与整体请求都带超时、禁止跟随重定向、响应必须 2xx 且 Content-Length 准确(拒绝 chunked 与重复 CL)、body 上限 4 MiB;非 2xx 把服务端 message 带出来——"为什么被拒"才是排查关键;204 空体容忍)
  • crates/mpc-hostd/src/json.rs(自研 JSON 编解码,保留:它不是 HTTP 层,且被 TeeRuntime 状态落盘复用;键有序,保证状态文件可回读)
  • crates/mpc-cli/src/hostd.rs(mpc hostd 子命令 + mpc tee up|ps|attest|down 宿主端客户端;非回环地址必须显式加 --allow-remote——宿主控制面当前没有鉴权;down 在 DELETE(204 空体)后补一次 GET 拿停后状态)
  • tools/selftest-hostd.py(进主门禁第 12 条;33 条判据:起真 hostd(真 socket、真起进程、真杀进程)/ e2b 字段名齐全 / 裸数组 / 四布尔分开且不含 ok / chip_sig=false 时明说没验签 / 实例进程真被回收 / 未知实例 404 / 缺字段 400 / 重复 Content-Length 被拒(带期望特征:400 + 空体 + 关连接,说明请求没进业务层)/ chunked 被拒且说明原因 / 连续 20 次请求都拿到完整响应体(钉死「头与 body 分两次写、只读一次」那个偶发失败的回归探针)。回收判据用心跳文件(实例自己 touch 文件,停掉后 mtime 不再前进)——不依赖 ps / /proc,因为 macOS 无 /proc、受限环境 ps 常被禁,那条判据恰恰是最重要的一条,不能靠"环境不支持就跳过"糊过去)
  • crates/mpc-tee/src/link.rs(链路协议层,no_std + alloc:三档 LinkPolicy;LinkCredential 手写 Debug 脱敏私钥;CredentialProvider 未配置即拒绝;aggregate_observations 对全部 peer 取最严路径;link_admit 三档 fail-closed;session_link_binding 把 credential_id 绑到会话与 user_data[0..32],私钥不参与哈希)
  • crates/mpc-hostd/src/link.rs(链路进程层:EasyTierSpec::argv() 三档参数 + 被禁 flag 自检(--network-secret / --relay-all-peer-rpc / --disable-encryption / -u);RPC portal 只绑回环;CliCredentialIssuer 调 credential generate|revoke;parse_peer_output 认不出一律 Unknown;LinkRuntime 持 Child 句柄 + try_wait() 收割)
  • crates/mpc-cli/src/link.rs(mpc link plan|verdict|credential;凭据只走 0600 文件、不进命令行;--argv 输出真实 argv 并警告,--argv-redacted 输出合法 JSON 脱敏版;未知参数直接报错,不静默忽略)
  • tools/selftest-link.py(进主门禁第 13 条;53 条判据,用 fake-easytier-cli / fake-easytier-core 两个桩跑完整链路;每条负向带期望特征;含「混合 peer 假绿」「进程真回收」两条回归探针)
  • crates/mpc-chain/src/lib.rs(ChainConfig 每字段必须显式、sm_crypto=false 拒绝并说明 keccak256 未实现、client_tlcp 声明 TLCP + require_transport() 生产路径 fail-closed;digest_for_config 是全框架唯一 hash 入口)
  • crates/mpc-chain/src/objects.rs(ChainObject::canonical_bytes 唯一实现:域分隔 TEE_CHAIN_OBJECT + 类型标签 + 4 字节大端长度前缀;四类对象摘要;Receipt 四布尔分开、签名不进被签内容)
  • crates/mpc-chain/src/rpc.rs(两组方法常量:国密链 METHOD_SEND_TRANSACTION(4 参)与 web3 端点 METHOD_SEND_RAW_TX;assert_submit_method_allowed() 对国密链 + eth_sendRawTransaction 拒绝;send_transaction_params() 钉死 [groupID,nodeName,data,requireProof];CRYPTO_SM2_VERIFY_ABI 四入参;parse_response 先判 error 再判 result、缺 result 拒、id 不匹配拒、result:null 不算成功;.no_proxy())
  • crates/mpc-chain/src/outbox.rs(kind:order_id:decision_id 复合幂等键、重复不覆盖、fail-open、坏行整体拒绝、临时文件 + rename)
  • crates/mpc-chain/src/admission.rs(fail-closed:缓存缺失 / 过期 / 硬规则失败 / 非成员一律拒;expires_at 缺失不当永不过期)
  • crates/mpc-chain/src/signer.rs(SignerSecurityProfile::{HardwareModule,SoftwareDev} + SignerPolicy(无 Default);require_self_test(s, policy) 生产策略拒软件签名器;硬件模组 ModuleSigner 仍未实现)
  • crates/mpc-chain/src/tlcp.rs(TlcpBackend::{None,Tongsuo,GmSSL} + TlcpReadiness::{LoopbackReachable,MissingEnvironment,Ready};Tongsuo 与 GmSSL 两套套件名合并白名单;probe_tlcp_environment() 真跑 openssl/gmssl;TlcpEndpoint 配置 + TlcpTunnel(spawn gmssl tlcp_client -in、响应走 stdout)进程通道;环境齐备已到 LoopbackReachable(环回可达),但仍非 Ready)
  • crates/mpc-cli/src/chain.rs(mpc chain digest|submit|flush|status|admit|keygen|sign|align|tlcp|governance|opa sign|opa decide;flush 输出 methodIsStub / guomiSubmitMethod / guomiChainRejectsStubMethod / payload,明确标注 payload 不是已签名交易;opa decide 输出 opaInGuest=false / chainRecorded=false / decisionStoredAs=outbox-pending-not-signed-tx)
  • tools/selftest-chain.py(进主门禁第 14 条;50 条判据,Python 假 bcos-rpc;每条负向带期望特征;含 .no_proxy() 与国密链提交方法回归探针)
  • tools/selftest-chain-gm.py(第 15 条;36 条判据;系统 openssl CLI 独立验签、生产策略拒软件签名器、GmSSL 套件名白名单、环境齐备也 ready=false)
  • tools/selftest-tlcp-gmssl.py / tools/selftest-ta-key-tier.py / tools/fisco-realnode-probe.py(第 16 条;真 TLCP 握手 19 / 三级密钥 16 / 真机契约 12 + 两份零依赖 --self-test;缺环境一律显式 *_SKIPPED + 逐项缺失,绝不静默通过)
  • crates/mpc-chain/src/opa.rs(阶段 3 第一段:sign_bundle / verify_bundle(SM3 hash pin + SM2 真验签,被签内容重算)/ RevocationView(本地桩、TTL 新鲜度)/ RevocationViewSource + ChainRevocationReader + UnconfiguredRevocationReader + resolve_revocation(链上撤销状态位读取契约已落,后端未接入即 fail-closed 拒)/ require_input_source(调 OPA 前判)/ OpaRunner(只 spawn 外部 opa,带超时与 wait 收割)/ parse_eval_allow(undefined {} 必拒)/ Decision(确定性 decision_id 兼 outbox 幂等键);OPA 不在 guest 内、撤销链读后端未接入、decision 未签名未上链)
  • tools/selftest-chain-opa.py(第 17 条;41 条真闭环判据 + 22 条零依赖 --self-test;真 opa build / 真 opa eval / 系统 openssl 独立验签;16 条负向每条带期望拒绝特征并排除「未知参数」探针 bug;缺 OPA 显式 OPA_DECISION_SKIPPED,成功也只报 OPA_GUEST_NOT_VERIFIED + CHAIN_NOT_VERIFIED)
  • crates/mpc-core/src/domain.rs(TEE_LINK_BIND / TEE_CHAIN_OBJECT / TEE_OPA_SIGNED_BUNDLE / TEE_OPA_DECISION 域分隔常量;改一个字节 = 已登记摘要或幂等键全部对不上)
  • crates/mpc-tee/src/session.rs:75(user_data 两段 sha256 拆分)
  • crates/mpc-tee/src/verify.rs:89(CSV_REPORT_LEN = 2548,真机实测;注释明确 4096 是 hypercall 页不是报告长度)
  • deploy/tee/real-machine/selftest-csv-verify.py(进主门禁第 10 条;CSV 侧验签器自测 —— 零依赖 18 条判据逻辑 + 真官方验签器 10 条正负向;★ 真机实测固化两条边界:MAC 不在 SM2 签名覆盖内、官方验签器缺证书会联网补链;wrapper 已据此改为链校验模式强制 unshare -rn 断网)
  • docs/REAL_MACHINE_FINDINGS.md(两台真机实测的硬事实:海光 CSV / AMD SNP 画像、AMD 五关闭环与负向矩阵、跨平台 user_data 一致性、九条踩坑清单、诚实边界)
  • crates/mpc-tee/src/platform.rs(PlatformProfile::builtin() 对 Optee / Tdx 返回 None,有断言钉死;本轮已把该文件开头误写的"CSV 4096 字节"改为 2548)
  • crates/mpc-tee/src/optee/{mod,core,proto}.rs(CA↔TA 三层范式、seal 格式、命令协议;ta/、ca/ 需 OP-TEE SDK 交叉编译,build/build_optee.sh 驱动)
  • build/build_optee.sh(需要 OPTEE_OS + SDK_DIR + arm-linux-gnueabihf-;UUID 硬编码 a1b2c3d4-…;--check-only 在 SDK 检查之前解析 TA 签名密钥三级:dev 必须显式 MPC_TA_ALLOW_DEV_KEY=1 / MPC_SIM_DEV,staging 必须 MPC_TA_SIGN_KEY,prod 必须 SIGN_KEY 且绝不回落 default_ta.pem,违规以 MPC_TA_KEY_FAIL: 独立短行拒绝;MPC_SIM_DEV A/B 跨设备解封失败的机制已串进 tools/optee-cross-device.sh,但QEMU 未实跑)
  • crates/mpc-tee/Cargo.toml(没有 optee feature;TA 走 default-features = false,所以 mpc-tee 的 no_std 是 OP-TEE 的硬前置)
  • tools/ci.sh(本文写作时 18 条,现为 25 条;以下条目编号按当时,新增第 21 条真交易编码判据、第 22 条真链合约判据,见文首状态提示与 docs/INDEX.md;第 3 条 = mpc-core + mpc-tee no_std + TA UUID 对拍;第 4 条 = musl 跨目标零告警 + guest 产物三层探针;第 11 条 = OP-TEE 判据逻辑自测(零 SDK);第 12 / 13 / 14 条 = hostd / 链路层 / 链上层端到端自测;第 15 条 = 国密签名 / distid / TLCP 准入 / 治理形状;第 16 条 = GmSSL TLCP 真握手 + TA 密钥分级 + FISCO 真机对拍契约,其中两份 --self-test 与 TA 探针零外部依赖;第 17 条 = 阶段 3 OPA bundle 签发 / 真判定 / decision 存证,零依赖判据 18 + 真闭环 40;第 18 条 = TLCP 进程通道环回实证(TlcpTunnel spawn gmssl tlcp_client 经 TLCP 收发真实 JSON-RPC 给环回 echo,断言往返一致;realChainVerified 恒 false、BCOS_RPC_NOT_VERIFIED);缺环境一律显式 *_SKIPPED + 逐项缺失)
  • tools/check-optee-uuid.py(五处 UUID 对拍,不写死期望值;已做探针回归——改一个字符即 OPTE_UUID_FAIL 并指出差异行)
  • tools/ci-optee.sh(段二独立通道。skip 分支已实测,构建分支待真 SDK;新增 --cross-device / --restart 两个互斥模式)
  • build/optee-verdict.py(判据的唯一真相源:按 mode / expect / provisioned / require-9p 判定串口日志,兼带 blob 抠取。判据散落多处 = 迟早分叉且分叉了没人知道)
  • tools/selftest-optee-verdict.py(进主门禁第 11 条;用构造日志跑判据每条分支 + Rust↔Python 跨语言常量一致性 + 漂移探针。判据逻辑在没 SDK 的机器上永远不会被执行,所以必须另有一条零依赖的路)
  • tools/optee-cross-device.sh / tools/optee-restart.sh(两条编排脚本;QEMU 未实跑)
  • crates/mpc-tee/ca/src/main.rs(selftest 八步:provision / info / seal-unseal / 重开 session / 篡改拒绝 / AAD 绑定 / sign / attest;第 4 步是重开会话,不是设备重启。另有 seal / seal-hex / unseal / unseal-hex 四个文件子命令,未知命令 exit(2))
  • crates/mpc-orch/src/{lib,state}.rs(orch/agent 行文本协议、Event)
  • crates/mpc-cli/src/{main,report}.rs(cluster/agent 参数、不引 serde 的 JSON 手写)
  • deploy/tee/launch.sh(bash + python 反解析)、deploy/tee/guest/init.sh

cbox

  • boxe2b/src/{main,api,backend,state,proxy}.rs(E2B 兼容层 → boxlite serve REST;控制面 3010 / 数据面 3011)
  • boxlite/src/vmm(自研 VMM)、AGENTS.md

FISCO BCOS

  • bcos-executor/src/precompiled/CryptoPrecompiled.{h,cpp}(sm3 / keccak256Hash / sm2Verify 预编译;实现走 sm2Recover + sm3Hash 推地址)

  • bcos-crypto/bcos-crypto/signature/sm2.{h,cpp}

  • 官方文档:Pro 版部署(deploy_pro_by_buildchain、installation_without_tars、TARS 依赖)、[chain] sm_crypto 不可改、OPCODE 差异表(KECCAK256 国密版为 SM3、CREATE2 按 SM3 推导地址)

  • gitea 镜像 distid 核对(2026-11-07):FISCO-BCOS/FISCO-BCOS 的 bcos-crypto/bcos-crypto/signature/fastsm2/fast_sm2.cpp:35 写死 const char* c_userId = "1234567812345678",同文件 c_R_FIELD_LEN = 32 / c_S_FIELD_LEN = 32 / c_PUBLICKEY_LEN = 64 ⇒ 国密链要 raw r||s 与无 04 前缀的裸公钥。以上均为上游仓库相对路径,不是 ssw-mpc 本仓库文件。

  • 本机国密能力实测(2026-11-07,GmSSL 追加后):OpenSSL 4.0.3 有 SM2 实现(openssl list -signature-algorithms 含 {1.2.156.10197.1.301, SM2} @ default);openssl ecparam -name SM2 -genkey + openssl dgst -sm3 -sign/-verify 全通,签名为 DER ECDSA-Sig-Value。openssl ciphers -v 无 TLCP 套件、无 tongsuo;CLI 自签 SM2 X509 报 wrong public key type。追加:brew install gmssl 装到 GmSSL 3.2.0(Apache-2.0),gmssl help 有 tlcp_server / tlcp_client,两个命令的 -help 列出 TLS_ECC_SM4_CBC_SM3 / TLS_ECC_SM4_GCM_SM3;gmssl certgen -help 明写默认 -sm2_id 为 1234567812345678。本机环回真握手输出 Protocol: TLCP / Version: TLCP (0101) / 国密套件 / 双证书,判据见 tools/selftest-tlcp-gmssl.py。

  • gitea 镜像 FISCO-BCOS/FISCO-BCOS 源码核对(2026-11-07,含一次重要的假阴性纠正):下列路径均为上游仓库相对路径,不是 ssw-mpc 本仓库文件。web3jsonrpc/endpoints/EthMethods.h:54 的 EthMethod 枚举含 eth_sendRawTransaction / eth_call / eth_getTransactionReceipt,EndpointsMapping.cpp 按枚举注册;bcos-rpc/bcos-rpc/jsonrpc/JsonRpcInterface.cpp:18 注册 m_methodToFunc["sendTransaction"],JsonRpcImpl_2_0.cpp:477 是实现,JsonRpcInterface.h:171 给出 4 参 [groupID,nodeName,data,requireProof] —— 上一版写「sendTransaction 全仓搜不到」是 search_code 带了不匹配 path glob 导致的搜索假阴性,已纠正。web3jsonrpc/model/Web3Transaction.cpp 固定 Secp256k1Crypto.h + keccak256Hash + SECP256K1_SIGNATURE_LEN(r||s||v)⇒ 国密链不走 web3 端点。bcos-executor/src/precompiled/CryptoPrecompiled.cpp:45 的 sm2Verify(bytes32,bytes,bytes32,bytes32) 是 4 入参;bcos-crypto/bcos-crypto/signature/sm2/SM2Crypto.cpp 走 wedpr_sm2_verify,C 入参只有公钥 / msgHash / 签名,distid 不在 ABI。FISCO-BCOS/tools/BcosBuilder/pro/conf/config-build-example.toml 有 sm_crypto=false;bcos-tool/bcos-tool/NodeConfig.cpp:664 从 chain.sm_crypto 读创世配置。

  • cmake/Options.cmake 的 WITH_WASM(默认 OFF)——决策 6 后不再使用

EasyTier

  • 官方配置文档 https://easytier.cn/guide/network/configurations.html(--p2p-only、--relay-network-whitelist(空格分隔 + 通配符)、--private-mode true、--disable-sym-hole-punching true、--no-tun、--rpc-portal / --rpc-portal-whitelist、--credential(临时凭据私钥 base64)、--credential-file、--secure-mode)
  • 官方安全模式文档 https://easytier.cn/guide/network/secure-mode.html(credential generate --ttl [--allow-relay] → credential_id + credential_secret;credential revoke <id>;allow_relay 默认 false,含义是「本节点能否为他人转发」;临时节点不需要 network_secret;管理节点须配 --credential-file)
  • LGPL-3.0(独立进程 + CLI/RPC 是许可明确允许的正常用法;分发其二进制时须附协议文本与源码获取方式)

国密与密码模块

  • 接口形态已定:OpenSSL provider(不走 engine / SDF / PKCS#11)
  • Tongsuo 版本基线(GitHub Releases):8.4.0 起基础代码迁到 OpenSSL 3.0.2(provider 可用),8.3.x 及以前为 1.1.1 基线(只有 engine);8.5.0 迁到 OpenSSL 3.5.4
  • Tongsuo 8.5.0 自带两项现成资产:"商用密码检测和认证 Provider"(身份认证、完整性验证、算法自测试、随机数自检、熵源健康测试——正对密评)、"SMTC Provider 适配蚂蚁密码卡(atf_slibce)"(厂商 provider 接入先例)
  • openssl crate 的 provider 模块:只有 Provider::load / try_load / set_default_search_path;load 的语义是 OSSL_PROVIDER_load 并禁用 fallback providers;没有暴露 property query(EVP_PKEY_CTX_new_from_name 的 propq 参数无封装)
  • sm2 / sm3(RustCrypto)—— 仅用于 SoftSigner 测试实现,不进生产链路。sm2 官方声明"从未被独立审计",密评不接受