Files
ssw-mpc/docs/INTEGRATION_ANALYSIS.md
T
admin d6330862d9 feat(chain): TLCP 进程通道环回实证落地,主门禁扩到 18 条
- mpc-chain 新增 TlcpEndpoint/TlcpTunnel:Rust 侧 spawn gmssl tlcp_client
  经 TLCP 收发真实 JSON-RPC(响应走 stdout),就绪状态 NeedsFfi → LoopbackReachable
- mpc chain tlcp send 端到端收发;realChainVerified 恒 false、channelLayerReachable
  仅当配置就绪才 true,诚实边界未破(环回 echo 不等于 bcos-rpc 真机通道)
- 主门禁第 18 条 = selftest-tlcp-tunnel.py(15 条真环回判据 + 零依赖 --self-test)
- 修 selftest-chain-gm.py / selftest-chain-opa.py 两处写死旧门禁计数的断言
- CLAUDE.md / INTEGRATION_ANALYSIS.md / ci.sh 同步门禁计数与状态
2026-11-07 19:23:40 +08:00

939 lines
96 KiB
Markdown
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.
# ssw-mpc 三方整合:决策定稿与实施方案
> 2026-11-07 决策锁定。本文替代此前的分析稿,作为唯一实施依据。
> 原分析稿的取证过程见文末「事实来源」;被本轮决策推翻的结论已在正文标注 **[修正]**。
## 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||s`);私钥可导出、密评不可过,生产仍需硬件模组 provider |
| — | 客户端通道(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 内**、撤销视图是本地桩(链上状态位未接)、decision 未签名未上链 |
---
## 1. 双层控制面(本轮最大的结构变化)
### 1.1 为什么必须两层
单层控制面在三个地方会崩,且都是必然发生:
1. **证明采不到**。芯片报告只能由宿主机读(`/dev/sev`、`/dev/csv-guest` 就在宿主上)。站点端如果直接管 TEE,就必须把宿主机凭据发给每一方,等于取消隔离。
2. **调度没有落点**。一个联盟有 n 个机构、每机构 m 台机器,站点端要知道"哪台机器还有 SNP 容量"。这个状态只存在于宿主机。
3. **准入判据不在一处**。站点端知道"谁是联盟成员、这轮算什么",宿主机知道"这块芯片的 TCB 是多少、度量对不对"。**两边都只有一半判据**。
所以切分不是审美选择,是判据归属决定的。
### 1.2 职责矩阵
```text
┌───────────────────────────────────────────────────────────────┐
│ 站点端控制面 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 兼容。正确做法是独立端点:
```text
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 语义要分叉,但**不新建接口**:
```text
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 条:
```bash
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 现状:一条"给人用"的链路
```text
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"。在单层控制面下成立;**两层控制面下不成立**——站点端在另一台机器上,必须有网络接口。
修正后的落点:
```text
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` 那套是设计蓝图,尚未接线,别照着敲):
```bash
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`:
```text
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`):
```sh
# 联盟管理节点(正式节点:持 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
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。
```text
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` 就直接签,很可能一直在用软件实现而没人发现**——直到密评现场被问"你怎么证明私钥在硬件里"。
对策不是"我去指定它",而是**让环境里没有替代品**:
```rust
// 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`),提供:
```solidity
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 落地为三段式:
```text
机构 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 判定这些框架自己的契约,**不宣称能上链**。
**★ 配置与准入纪律**:
① `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. 交汇点:会话是唯一主键
```text
┌──────────────────────────────────────────┐
│ 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 条**。
**★ 两段诚实边界都不许冲掉**:① **阶段 2 仍不含真实交易签名上链** —— FISCO 自有交易编码 / 国密模组 provider / 真实 `bcos-rpc` 的 TLCP 通道未落地(Rust 侧 TLCP 进程通道环回实证已落地,但服务端是 echo 不是真节点),见 4.8 与 `tools/fisco-realnode-probe.py`;② **阶段 3 只完成第一段** —— OPA 仍在宿主 / 控制面 spawn,**不在 guest 内执行**,撤销视图是调用方每次提供的本地桩(链上状态位读取未接入),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 是否安装,避免「跳过目标」把边界判据一起跳掉。
本轮 `./tools/ci.sh` **18 条全绿**:第 4 条 guest 探针 22(deps)/ 3(guard)/ 15(binary)、
第 14 条 50、第 15 条 36、第 16 条真握手 19 + TA 密钥 16 + 两份零依赖契约判据
11 / 12、第 17 条真 OPA 闭环 40 + 零依赖判据 18、第 18 条 TLCP 进程通道环回实证 15 + 零依赖判据;真机契约实跑如实输出
`FISCO_REALNODE_SKIPPED` 与 6 项缺失,无静默通过。
**为什么 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`(3.x `eth_*` 方法、HTTP 200 + `error` 判失败、`result:null` 不算成功、
`.no_proxy()`)、`outbox`(复合幂等键、fail-open、坏行拒绝、临时文件 + rename 落盘)、`admission`(fail-closed、
`expires_at` 过期即拒)、`signer` / `sm2` / `tlcp` / `policy`(软件 SM2 真签名、distid 三重对齐、TLCP 双证书准入、
硬规则与 OPA 分域)。**FISCO 自有交易编码 / 模组 provider / 真实 `bcos-rpc` 的 TLCP 通道仍未实现**(Rust 侧 TLCP 进程通道环回实证已落地,第 18 条),不宣称能上链。
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),
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 的机器上也能被执行到**(守卫不会被前置环境检查抢先)。
**待实测(不阻塞开工,但阻塞上生产)**
7. **模组能否直接输出裸 `r||s`**。DER 拆包本身是确定的(4.3④),所以这条不阻塞;但如果模组能直接出裸值,就少一段容易写错长度的 ASN.1 解析。
8. **CSV 报告的公钥编码与签名对象**(原文 or SM3 摘要),决定 `sm2Verify` 的三个入参怎么填。
9. **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 条零依赖判据):
① **源码已判定**:国密链交易走自有 `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`(缺的是实现),**绝不打印通过**。
10. **OP-TEE 在 TA 共享语义下的租户隔离**。TA 是设备级单例,多机构共存时密钥域怎么分——`optee/core.rs` 的 seal 格式是否已带租户维度,要核对。**这条现在是生效的**(OP-TEE 已进本轮,见 1.7)。
**已拍板(2026-11-07)**
11. **Pro 版先不上 TARS**。ssw-mpc 只依赖 `bcos-rpc` 的 HTTP 端点,TARS 留给运维团队自建(4.2)。
12. **硬规则进合约,业务合规策略仍走 OPA**。两者域分隔不同(`TEE_CHAIN_HARD_RULE` / `TEE_OPA_BUNDLE`)、字段互相禁止(`HardRuleSet` 拒 `wasm` / `rego`,`OpaPolicyBundle` 拒 `min_tcb` 等硬规则字段)、不开 WASM;策略签发收口到站点端控制面。第 15 条落对象形状与边界守卫;**第 17 条落阶段 3 第一段**(真 bundle 签发 / 真 `opa eval` / decision 幂等存证),但 OPA 仍不在 guest 内、撤销不是链读、decision 未签名未上链,合约部署与 bundle 分发仍未做。
---
## 附:事实来源
**本项目**
- `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 新鲜度)/ `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 条**;40 条真闭环判据 + 18 条零依赖 `--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 页不是报告长度)
- `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`(**十八条**;第 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` 官方声明"从未被独立审计",密评不接受