- 新增 docs/ARCHITECTURE_SYSTEM.md(活真相源):组件清单、双层控制面、 会话主键、端到端数据流、部署拓扑、平台矩阵、判定治理、诚实边界。 用 [实证]/[桩验]/[设计]/[禁用] 区分实证与蓝图 —— `mpc site` 等 决策角色不再被写成已部署服务,避免照着文档敲不存在的命令。 - 新增 tools/render-share-html.py 与 docs/ARCHITECTURE_SYSTEM.html: 自包含单文件分享页,md 是唯一真相源、HTML 是派生产物勿手改; --check 校验两者同步,生成幂等无 diff 噪音。 - INTEGRATION_ANALYSIS.md 文首加「架构结论已抽出」指针,正文决策取证链 保持不变;INDEX.md(§0/§2/§3/§6)、CLAUDE.md、README.md 登记新文档 与第 9 条更新纪律。与原 ARCHITECTURE.md(计算分层)明确分工。 - 校验:HTML 与 md 同步、ci.sh 语法、判据自测 22/22、diff 空白、 23 个引用路径与密钥扫描全过;纯文档改动未跑全量门禁。
1021 lines
104 KiB
Markdown
1021 lines
104 KiB
Markdown
# ssw-mpc 三方整合:决策定稿与实施方案
|
||
|
||
> 2026-11-07 决策锁定。本文替代此前的分析稿,作为唯一实施依据。
|
||
> 原分析稿的取证过程见文末「事实来源」;被本轮决策推翻的结论已在正文标注 **[修正]**。
|
||
|
||
---
|
||
|
||
## ⚠ 状态提示(2026-11-08 复核,读正文前先看这里)
|
||
|
||
**本文是 2026-11-07 的决策定稿与阶段快照,不是当前实施状态的真相源。**
|
||
第 0 节决策台账、依赖边界、fail-closed 纪律、治理域分隔**仍然生效**;
|
||
但正文里所有「阶段状态 / 门禁条数 / 未落地 / 不宣称」的表述,已被随后三次提交
|
||
(`237e646` 真链合约实证、`3ad3f30` 复现脚本入库、`ba11de5` 链迁 k8s)推进:
|
||
|
||
| 本文当时写的 | 当前事实(2026-11-08) | 权威入口 |
|
||
|---|---|---|
|
||
| 主门禁共 **18 条**(§6、附录) | **22 条** | `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](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](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||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 内**、撤销链读后端未接入(声明 chain 即 fail-closed 拒)、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 判定这些框架自己的契约,**不宣称能上链**。
|
||
|
||
> **[修正 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. 交汇点:会话是唯一主键
|
||
|
||
```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 条(当时)**。
|
||
|
||
> **[当前状态 2026-11-08]** 上段与紧随其后的「两段诚实边界」都是**当时的阶段结论**,
|
||
> 不是现状。现在:主门禁 **22 条**(第 21 条真交易编码、第 22 条真链合约);
|
||
> 阶段 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 条全绿**(现为 **22 条**):第 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 的机器上也能被执行到**(守卫不会被前置环境检查抢先)。
|
||
|
||
**待实测(不阻塞开工,但阻塞上生产)**
|
||
|
||
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 条零依赖判据):
|
||
|
||
> **[销账 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`(缺的是实现),**绝不打印通过**。
|
||
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 内、撤销链读后端未接入(声明 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 条,现为 22 条**;以下条目编号按当时,新增第 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` 官方声明"从未被独立审计",密评不接受
|