集群自报联调脚本的 3 个真机必挂缺陷: - xop 把自己的 WARN 打在 stdout(不是 stderr)。`remote()` 原先 `2>&1` 合并返回,导致 `wc -c` / `sha256sum` / curl HTTP 码全被污染; 改用 fd3 分流:远端输出进临时文件,xop stdout 丢弃,返回值只剩真实输出。 `xop_probe` 改为只认纯数字行,拿不到数字即失败(fail-closed)。 - `printf '--- 负向矩阵…'` 格式串前导破折号被 bash 当成选项,改用 `%s`。 - `remote()` 里 `< /dev/null` 被后面的 here-string 覆盖,是无效防护; 同时删掉从未被调用的 `remote_amd()`(把脚本正文塞进 ssh argv 的活样本)。 判据门禁(第 25 条)收编: - `selftest-cluster-selfreport.py` 重写为 9 组判据 10 项检查, 探针先自证 fired(避免「argv 日志为空 ⇒ 没密钥」恒真), 用假 xop + 假 sshpass,不依赖真机与保险库是否解锁。 - 判据 4 只扫密钥流经语句并豁免本地熵源;新增判据 9 守 fd3 隔离。 - `selftest-cluster-selfreport-break.py` 覆盖全部 9 组判据共 11 条破坏实验, 每条变异双向确认证据串,顺序事实型单独一条路径。 文档:主门禁条数 24 → 25 全仓同步;诚实边界改为「真机两节点自报已实证, 选址/下发/证明门控/端点交付仍只在假 hostd 上验过;修完的脚本只过离线 判据门禁,尚未在真机复跑」。 验证:bash -n、shell 卫生 lint(39 脚本)、真 xop+假远端 fd3 分流实测、 自测 10/10、破坏实验 11/11、tools/ci.sh 全量 25 条 CI_EXIT=0。
105 KiB
ssw-mpc 三方整合:决策定稿与实施方案
2026-11-07 决策锁定。本文替代此前的分析稿,作为唯一实施依据。 原分析稿的取证过程见文末「事实来源」;被本轮决策推翻的结论已在正文标注 [修正]。
⚠ 状态提示(2026-11-08 复核,读正文前先看这里)
本文是 2026-11-07 的决策定稿与阶段快照,不是当前实施状态的真相源。
第 0 节决策台账、依赖边界、fail-closed 纪律、治理域分隔仍然生效;
但正文里所有「阶段状态 / 门禁条数 / 未落地 / 不宣称」的表述,已被随后三次提交
(237e646 真链合约实证、3ad3f30 复现脚本入库、ba11de5 链迁 k8s)推进:
| 本文当时写的 | 当前事实(2026-11-08) | 权威入口 |
|---|---|---|
| 主门禁共 18 条(§6、附录) | 25 条 | tools/ci.sh |
「flush 只发规范字节,不是已签名交易」 |
FISCO TARS 编码 + 128B r‖s‖pub 签名已落地,flush --mode signed-tx 发完整已签名交易并走 Outbox::flush_with 状态机 |
crates/mpc-chain/src/fisco_tx.rs、crates/mpc-cli/src/chain.rs |
| 「不宣称能上链」「合约部署仍未做」 | 真链合约部署 / 调用 / 读回 + 负向矩阵已实证,22 项判据全绿 | tools/selftest-fisco-contract.py(主门禁第 22 条)、contracts/MpcHardRule.sol |
| 「FISCO 自有交易编码待真机对拍」 | 已逐字节核对落地;★ 签名口径是 e = SM3(ZA‖dataHash)(节点 3.17.1 只编译了 fast_sm2_*,用 distid 1234567812345678),不是签裸 dataHash |
docs/FISCO_UPSTREAM_TRUTH.md §3.1、tools/sm2_verify.py |
「3.x 是 eth_ 兼容端点」这一旧直觉 |
eth_call / eth_getTransactionReceipt 实测 method-not-found;读回用自有 call / getTransactionReceipt(4 参 groupID+nodeName) |
docs/FISCO_UPSTREAM_TRUTH.md |
链跑在本机 fisco-gm / 127.0.0.1:20200 |
连同现有账本迁入 wuguirong k8s(NodePort 30100),账本落 nfs-wuguirong PVC;历史区块哈希逐个一致、删 Pod 重建后高度不变 |
deploy/k8s/fisco/README.md |
「fisco-realnode-probe.py 只报 NEEDS_IMPL」 |
该探针仍是历史契约(未销账);但真链验收已由第 22 条脚本承担,两者别混 | tools/fisco-realnode/README.md |
当前状态以 docs/INDEX.md 与上表权威入口为准;本文正文保留当时的
取证与推理链,凡与上表冲突处按上表读。正文里带「(2026-11-07 当时)」标注的
段落同理。诚实边界依然成立,不许借这次更新冲掉:软件 OpenSSL 签名器私钥
可导出 ⇒ 密评不可过;真实 bcos-rpc 的 TLCP 通道未通(第 18 条服务端是环回
echo);硬件模组 provider 未落地;OPA 不在 guest 内;撤销链读后端未接入
(声明 chain 即 fail-closed 拒);decision 未签名未上链;TEE 证明未上链。
架构结论已抽出(2026-11-08):本文 §1 双层控制面、§4 链上形态、§5 会话主键的
架构骨架已拆到 ARCHITECTURE_SYSTEM.md(活文档),
并结合真链 / 合约 / k8s / 真机实证补齐当前形态与状态标注([实证] / [桩验] / [设计] / [禁用])。
本文保留决策台账与取证推理链,不再承担「系统长什么样」的职责:
查架构去那份,查「当时为什么这么定」来本文。请勿把本文的职责矩阵当成已部署清单
(例如 mpc site 是设计角色,CLI 里没有这个子命令)。
0. 决策台账
| # | 决策 | 取值 | 直接后果 |
|---|---|---|---|
| 1 | 飞梭链部署形态 | Pro 版 | bcos-rpc / bcos-gateway / bcos-node 三件套;TARS 可选;RPC 可横向扩展,站点端只连 RPC |
| 2 | 密码套件 | 必须国密 | SM2 签名 + SM3 哈希 + SM4 落盘 + 节点间国密 SSL;建链时定,之后不可改 |
| 3 | 策略执行位置 | 硬规则 | 成员白名单、TCB 门槛、算力上限、算法准入写成 Solidity 合约,链上共识执行 |
| 4 | 链路中继策略 | 两者兼容,参数控制 | open / allowlist / p2p-only 三档,由 mpc link plan --policy 落参数(不经过 e2b 兼容面,见 3.3 / 6) |
| 5 | 策略来源与签发 | 都可写,控制面签发 | 联盟全局表与机构自持并存;签发私钥唯一在站点端控制面 |
| 6 | WASM 合约 | 不开 | WITH_WASM 保持 OFF;Rego→WASM 上链(原 3c)整条删除 |
| — | 控制面层数 | 两层 | 站点端 + 宿主机端(e2b),宿主机向站点端提供 e2b 接口 |
| — | TEE 平台矩阵 | 海光 CSV / AMD SNP / ARM OP-TEE | 国密只在海光跑;AMD 走非国密;OP-TEE 是轻形态(见 1.6) |
| — | 国密实现路径 | 硬件模组 + OpenSSL provider | 只走 provider,不走 engine/SDF/PKCS#11;Rust 不实现 SM2(见 4.3④) |
| — | OP-TEE 定位 | 单独编译 / 单独验证 | 编译与设备验证走独立通道;零 SDK 能判的(no_std、UUID 对拍)仍进主门禁;缺环境必须显式报 skip(见 1.7) |
| — | 宿主 HTTP 栈 | axum + tokio + reqwest | 协议层交给成熟组件;依赖只落在独立 mpc-hostd crate,mpc-tee 保持零 crates.io 依赖(要被拷进 OP-TEE SDK 离线交叉编译,见 6) |
| — | 会话凭据来源 | 管理节点签发,框架不生成 | easytier-cli credential generate --ttl 返回 credential_id + credential_secret;框架只承载 / 传递 / 绑定 / 回收,CredentialProvider 未配置即拒绝(见 3.3) |
| — | 国密链参数(2026-11-07 拍板) | sm_crypto=true 已确认 |
建链参数按国密冻结,不可逆;false 一律拒 |
| — | 国密签名实现(2026-11-07 拍板) | 先用 OpenSSL 软件实现 | 真能签 SM2(raw `r |
| — | 客户端通道(2026-11-07 拍板) | bcos-rpc 做国密 TLS / TLCP |
双证书 + Tongsuo ≥ 8.4 或 GmSSL ≥ 3.2;Rust 侧通道未接入 ⇒ fail-closed,明文不许冒充 |
| — | TLCP 实现选型(2026-11-07 用户提点) | GmSSL 可用(开源免费,Apache-2.0) | 本机 3.2.0 环回真握手已跑通(第 16 条 19 判据);但 3.x 不与 OpenSSL ABI 兼容、软件实现不能过密评,生产仍需硬件模组 |
| — | 国密链提交方法(2026-11-07 源码核对) | 自有 sendTransaction(4 参) |
eth_sendRawTransaction 固定 secp256k1+keccak256,国密链禁用;纠正上一版「sendTransaction 搜不到」的搜索假阴性(见 4.8) |
| — | TA 密钥分级脚本层(2026-11-07 补) | 硬拒绝已实现,不再只落文档 | build_optee.sh --check-only 三级规则,缺 SDK 也能被第 16 条测到;prod 缺密钥绝不回落开发密钥 |
| — | SM2 distid(2026-11-07 拍板) | 三重对齐,唯一值 1234567812345678 |
依据 FISCO fast_sm2.cpp:35 的 c_userId;三处声明任一漂移即点名拒绝 |
| — | TA 密钥 / OP-TEE 范围(2026-11-07 拍板) | 三级密钥 + 只覆盖小隐私计算 | 分级方案与覆盖范围定稿见第 7 节 |
| — | TARS(2026-11-07 拍板) | 先不上 | ssw-mpc 只依赖 bcos-rpc 的 HTTP 端点 |
| — | OPA(2026-11-07 拍板) | 硬规则进合约,业务合规策略仍走 OPA | 两者域分隔不同、字段互相禁止、不开 WASM;签发收口到控制面 |
| — | guest 静态产物边界(2026-11-07 补) | musl mpc 不许带宿主控制面 |
mpc-hostd / mpc-chain 归 control-plane 可选依赖并按 target 排除;交叉编译必须 --no-default-features;主门禁第 4 条三层探针钉死(见 4.8 / 6) |
| — | 阶段 3 第一段(2026-11-07 补) | OPA 真判定闭环已落地,但阶段 3 未完成 | 真 opa build + SM2 真签 / SM3 hash pin + 真 opa eval + decision 幂等落 outbox(第 17 条);★ OPA 不在 guest 内、撤销链读后端未接入(声明 chain 即 fail-closed 拒)、decision 未签名未上链 |
1. 双层控制面(本轮最大的结构变化)
1.1 为什么必须两层
单层控制面在三个地方会崩,且都是必然发生:
- 证明采不到。芯片报告只能由宿主机读(
/dev/sev、/dev/csv-guest就在宿主上)。站点端如果直接管 TEE,就必须把宿主机凭据发给每一方,等于取消隔离。 - 调度没有落点。一个联盟有 n 个机构、每机构 m 台机器,站点端要知道"哪台机器还有 SNP 容量"。这个状态只存在于宿主机。
- 准入判据不在一处。站点端知道"谁是联盟成员、这轮算什么",宿主机知道"这块芯片的 TCB 是多少、度量对不对"。两边都只有一半判据。
所以切分不是审美选择,是判据归属决定的。
1.2 职责矩阵
┌───────────────────────────────────────────────────────────────┐
│ 站点端控制面 mpc site(每机构一个,或联盟共置) │
│ 会话编排:谁和谁算、算什么算法、什么时候算 │
│ 成员与策略:Member 表、PolicyBundle 签发(SM2 私钥在此) │
│ 链交互:ComputeOrder / Receipt 上链,硬规则查询 │
│ 跨宿主调度:按平台、TCB、余量选 host │
│ 审计对账:会话 ↔ 订单 ↔ 回执 三方对齐 │
└───────────────────────────┬───────────────────────────────────┘
│ e2b 兼容 API(HTTPS + 双向认证)
│ 控制面 3010 / 数据面 3011
┌───────────────────────────▼───────────────────────────────────┐
│ 宿主机控制面 mpc hostd(每台物理机一个) │
│ sandbox CRUD → 翻译成 TeeRuntime 调用 │
│ TeeRuntime:qemu spawn / 状态表 / reaper / 孤儿进程校验 │
│ 运行时准入:度量 pin、TCB 门槛、芯片签名、绑定值比对 │
│ 本地网络:tap/bridge + 每会话一个 EasyTier 实例 │
│ 证明采集:采报告 → deobfuscate → 落盘 + 上报 │
└───────────────────────────┬───────────────────────────────────┘
│ vsock / tap(不进网络栈)
┌───────────────────────────▼───────────────────────────────────┐
│ guest(mpc 二进制 + 策略引擎) │
│ 只做计算与出证明,不持有链凭据、不发 HTTP │
└───────────────────────────────────────────────────────────────┘
站点端不碰 qemu,宿主机端不碰私钥。 这两条是硬边界,越界即失去多机构前提。
1.3 宿主层用 e2b 的形,不用 e2b 的义
宿主机对外提供 e2b 兼容接口(POST /sandboxes、GET /sandboxes/{id}、DELETE、POST /{id}/timeout、POST /{id}/pause|resume),因为 cbox 已经验证过这条路的形状:boxe2b 只是一个翻译层,把 E2B 请求翻成 boxlite serve 的 REST,自己不起 VM。
照搬的是这个结构:
| cbox | ssw-mpc 对应 |
|---|---|
boxe2b(E2B 兼容层,axum) |
mpc-hostd 的 API 层 |
boxlite serve(POST /v1/boxes) |
TeeRuntime(进程内,不用 REST) |
state.rs 的 sandboxID → box 映射 |
session_id → TEE 实例 |
proxy 按 E2b-Sandbox-Id 反代 envd |
数据面按 session 反代到 guest 的 MPC 端口 |
| 控制面 3010 / 数据面 3011 | 同 |
不同的一点,且必须不同:TeeRuntime 不走 REST。cbox 的 boxlite serve 是独立产品,所以中间有 HTTP;ssw-mpc 是单二进制交付,中间加 REST 只会带来版本漂移(agent 与 serve 不同步时,报错会指向错误的一侧)。
e2b 的 template 语义要升级。在 e2b 里 template = 镜像;对 TEE,template 必须是度量集合:kernel hash + initramfs hash + cmdline + OVMF 版本 + 平台类型。create sandbox 的实质是"用这套已 pin 的度量起一个 VM"。这个映射不改 API 形状,但改变了 template 的存储内容——它从 docker image 变成一条 MeasurementProfile 记录,且必须带签名(否则谁能改 template 谁就能改准入)。
证明不能塞进 SandboxView。e2b 的返回体里没有这个字段,硬塞会破坏 SDK 兼容。正确做法是独立端点:
GET /sandboxes/{id}/attestation
→ { session_id, platform, tcb, user_data, measurement,
user_data_ok, meas_ok, tcb_ok, chip_sig, ← 四项分开,不许合并
report_sha256, collected_at }
四个布尔分开报,理由见 2.4。
1.4 准入必须拆成两段
现在的 mpc_tee::schedule::admit(req, node, binding) 是单段,因为只有一个控制面。两层之后要拆:
| 段 | 在哪 | 判据 | 失败语义 |
|---|---|---|---|
| 会话准入 | 站点端 | 成员资格(链上)、策略有效性(签名 + 有效期 + 未撤销)、订单 deadline、参与方集合 | fail-closed,链读失败带缓存 |
| 运行时准入 | 宿主机端 | 平台一致、设备/固件/qemu 存在、度量 pin、TCB ≥ 门槛、user_data 绑定比对、芯片签名 |
fail-closed,无缓存 |
不能合并的理由是硬的:站点端拿不到芯片报告,宿主机端不知道联盟成员表。合并只能靠"其中一端信任另一端传过来的结论",那这一段就成了新的信任根,而它恰恰是最容易被攻破的一层。
admit 函数本身不用改签名——它已经在宿主侧,输入正好是 req/node/binding。新增的是站点侧的 session_admit(),它产出 TeeRequirement 而不是 LaunchSpec。
[本轮已落地] 站点侧这一段已实现为 crates/mpc-tee/src/site_admit.rs 的 session_admit(&SiteAdmission, Option<&dyn PolicyVerifier>),10 条拒绝项覆盖成员表过期、本方非成员、参与方少于两方、参与方重复、参与方非成员、订单过 deadline、策略不在有效期、签发方为空、未配置验签器、验签不通过。注意 Option<&dyn PolicyVerifier> 的 None 分支是拒绝而非跳过——mpc-core 目前只有 SHA-256/SM3/HMAC/ChaCha20,没有非对称签名,所以验签层本期只落形状与可插拔接口,不假装可用。
[本轮已落地] 宿主侧这一段的落点是 crates/mpc-hostd/src/(TeeRuntime + e2b 兼容 API + /attestation 扩展)。1.5 的三层信任建立目前只落了第一层的形状(HostClient.token 字段先留出来,宿主端尚未强制校验),签名与 token 校验是下一阶段的活——现在不要以为 token 已经在起作用。
1.5 两层的信任建立
站点端调宿主机不能用长期共享密钥(一泄全泄)。三层:
- 宿主机在联盟注册时把 host 公钥 + 平台类型 + 机器指纹写进
Member表。 - 站点端下发任务时签一个短期 token(SM2),含
session_id、order_id、有效期(分钟级)、允许的操作。 - 宿主机验签 + 查
session_id未被使用过(防重放),再执行。
TeeRuntime 的所有写操作都必须带这个 token。读操作(GET /sandboxes)也要——否则联盟成员能枚举别人机器上的负载。
1.6 三平台不是同一套形态
PlatformKind 有四个值,但只有两个能"直接启动"(PlatformProfile::builtin() 对 Optee / Tdx 返回 None,且有断言钉死)。这个差异必须体现在宿主机层,否则 e2b 的 create 会在 OP-TEE 上假装成功。
| 海光 CSV / AMD SNP | ARM OP-TEE | |
|---|---|---|
| 宿主侧动作 | Command::spawn(qemu) 拉起 VM |
attach 到已存在的 /dev/tee0 |
| 信任根 | 芯片密钥 + 度量(measurement 进报告) | 设备密钥 + TA 签名 |
| 绑定值 | 64B user_data(报告中固定偏移) |
取决于 TA 实现,长度不保证 64B |
| 生命周期 | 进程级:起 → 跑 → 退 → reaper 回收 | 会话级:CA 打开 → 调 TA → 关会话,TA 进程一直在 |
| 回收 | kill qemu | 关 CA 会话。杀进程反而会切断别人正在用的 TA |
所以宿主机层的 e2b 语义要分叉,但不新建接口:
POST /sandboxes VM → 起 qemu,返回 sandbox_id
OPTEE → "分配 TA 会话",返回同一套 sandbox_id(映射到 CA 会话)
DELETE /sandboxes/{id} VM → kill + reaper 确认
OPTEE → 只关会话,不动 TA 进程
为什么不在 OP-TEE 上假装是 VM:TeeRuntime 的核心是 pid + 启动时间 校验孤儿进程(2.3)。OP-TEE 没有"这个 TA 属于哪个租户"的进程语义——TA 是所有 CA 共享的,杀进程等于杀掉别人的会话。硬套会让 reaper 变成事故源。
更要紧的判断:OP-TEE 场景可能不需要 EasyTier 和链。
"小隐私计算"通常发生在设备侧、参与方少(两方居多)、跨域需求弱。给它也配组网 overlay + 联盟链存证,等于为了 5% 的场景把 80% 的重型组件全带上,而它的证明根本过不了链上验签(4.4)。
边界(已定),代码共享抽象、编排不复用:
| 能力 | CSV / SNP | OP-TEE |
|---|---|---|
| 多方组网(EasyTier) | 需要 | 不需要(同机/同域,直连即可) |
| 链上存证 | 需要 | 可选:只存结果 hash 与设备身份,不存证明 |
| 控制面层数 | 两层 | 退化为一层:设备本地 CA 即控制面,无跨宿主调度 |
| 准入 | 会话准入 + 运行时准入 | 只做 TA 侧策略校验 |
也就是说:OP-TEE 是同一套 mpc-tee 抽象下的另一个部署形态,不是另一套基础设施。它仍在平台矩阵内,只是走独立的编译与验证通道(1.7)——Tee trait 与 optee/core.rs 的 seal 格式可以复用,但别把两层控制面、EasyTier、链一起压上去。
1.7 OP-TEE:独立编译通道与独立验证规则
决策是"单独编译 / 单独验证"。独立不是免责——本仓库的铁律是"闸门不扫自己 = 盲区 = 假安全感",所以独立必须拆成"能进主门禁的"和"只能在独立通道跑的"两段,且第二段缺环境时要显式报告,不能静默消失。
为什么必须独立(这是约束,不是偏好)
build/build_optee.sh的必需环境是OPTEE_OS(已构建的 optee_os 源码树)+SDK_DIR(teaclave-trustzone-sdk)+arm-linux-gnueabihf-交叉工具链 + 固定 nightly。主门禁机器上不可能齐备。- 主门禁的形态与它冲突:十四条里有"跨目标 x86_64-musl 零告警""12 示例冒烟",而 OP-TEE 的产物是 armv7 的已签名
.ta,签名和 verify 都要过sign_encrypt.py。混进去会让所有人的本地ci.sh变红。
段一:进主门禁的部分(零 SDK 依赖)
optee/core.rs 与 optee/proto.rs 本来就在 workspace 内编译和测试(optee/mod.rs 已写明),这部分天然被守。真正缺的是下面两条,本轮已落地:
-
mpc-tee --no-default-features必须能编。TA 就是按default-features = false(no_std + alloc)构建的,而主门禁原先只守mpc-core的 no_std。后果很隐蔽:有人在mpc-tee里直接use std::…,主门禁全绿,TA 构建在独立通道里挂。已并入tools/ci.sh第 3 条:cargo build -p mpc-core --no-default-features cargo build -p mpc-tee --no-default-features python3 tools/check-optee-uuid.py # 见下条 -
TA UUID 对拍 —— 实际是五处,不是三处。
crates/mpc-tee/ca/src/main.rs的注释写"必须与 TA 的 main.rs、build.rs 三处一致",但仓库里是五处硬编码:位置 形式 crates/mpc-tee/ta/src/main.rspub const UUID: &strcrates/mpc-tee/ta/build.rsTaConfig::new_default_with_cargo_env("…")crates/mpc-tee/ca/src/main.rsconst UUID: &strbuild/build_optee.shUUID="…"(签名.ta时写入)build/p3_optee_qemu.shMPC_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:
PHASE=build不含 run —— QEMU 根本没启动,而 build 段退出 0 = "看起来跑通了"。已加PHASE=buildrun。MODE=unseal的判据硬编码为"必须失败",与跨重启要的"必须成功"直接冲突。已参数化为MPC_UNSEAL_EXPECT。- 判据散落三处 = 迟早分叉且分叉了没人知道。已抽成
build/optee-verdict.py(唯一真相源)。 - 判据逻辑在绝大多数机器上永远不会被执行(要 SDK + QEMU)。已用构造日志做分支自测,
进主门禁第 11 条(
tools/selftest-optee-verdict.py)。
★ 一条容易自我欺骗的地方(判据层):判据写错时,真机上的表现全都是"验证通过" —— 没有编译错误、没有运行时异常。所以判据必须有负向判据(显式排除假失败):
- 只判「unseal 失败」不判失败原因 → blob 根本没打进 rootfs(IO 错)也会算通过;
- 只判「unseal 成功」不判
provisioned=true→ 第二次启动又 provision 一次的伪成功。
所以跨设备必须命中 MPC_UNSEAL_TAG_MISMATCH,而 MPC_UNSEAL_BAD_FORMAT /
MPC_UNSEAL_OTHER 都判假失败。
一条必须写死的边界:OP-TEE 不做远程证明
- CSV/SNP 的报告是芯片固件签的,验证方拿到公钥就能验,信任根在芯片厂商。
- OP-TEE 的远程证明需要额外部署(attestation TA 或 fTPM + 一个验证服务),返回的是 TA 自己构造的 quote,信任根回到 device key 的签发方——也就是"谁烧的密钥"。
也就是说:OP-TEE 的信任根是供应链,不是数学。 这轮不做 RA,就必须明确写成"OP-TEE 只能本地自证,不能向第三方证明"。
落到接口上:e2b 的 /attestation 对 OP-TEE 返回 platform_verified: false + 原因码,而不是返回一份格式相似但没人签过的"报告"。这正好接上 1.4 的两段准入——OP-TEE 的准入在站点侧(成员 + 策略),宿主侧没有芯片可判。
与 admit 的关系:OP-TEE 不进 admit(那是 VM 的五关:平台一致 / 布局解析 / 度量 pin / TCB 门槛 / 芯片签名)。它需要的是独立的 ta_admit():TA UUID + TA 签名 + TA 版本。不要复用 admit 的函数签名,否则参数只能硬塞,读代码的人会以为五关都过了。
2. 方向一:控制面直控 TEE
2.1 现状:一条"给人用"的链路
deploy/tee/launch.sh (bash)
└─ mpc tee plan --report json --argv # 输出 NDJSON 的 kind=table/rows
└─ python3 从"人类表格"里抠 argv_json # 机器反向解析人类界面
└─ os.execvp(qemu) # 进程交出去,控制面失联
四个断点,按严重程度排:
- exec 之后没有句柄。谁在跑、跑了多久、为什么退出,全无记录。这是"不能算部署"的根本原因——部署的含义是能被观察和回收。
- 协议是表格。
--report json的 schema 是{"kind":"table","rows":[...]},为看板和jq设计。要拿结构化数据得反向解析行号,launch.sh里的 python 片段就是这笔债。 - preflight 在 bash 里。宿主能力探测产出
key=value文本,没有"再探一次"的入口。换了盘、换了 qemu 版本,没人知道。 - verify 只认文件。
mpc tee verify --report FILE对着历史报告判定,对"正在运行的实例"没有入口——而运行期验证才是 TEE 的意义。
2.2 cbox 能给什么、不能给什么
| 该学 | 为什么不学另一半 |
|---|---|
| 控制面 / 运行时两段,中间一条窄协议 | boxlite/src/vmm 是自研最小 VMM。TEE 的证明依赖 qemu 的 sev-snp-guest 对象、OVMF 固件、kernel-hashes=on 的度量语义——自研 VMM 等于再也不会通过芯片验签 |
状态表 + reaper(每 5s 扫,stopped/error 就清) |
两个独立二进制。mpc 是 fat LTO + strip 单二进制,拆 daemon 会带来版本漂移 |
| 单一协议层(换后端只改一个文件) | E2B 的 API 形状作为内部协议。它只适合对外(1.3),对内是多余的 |
| 数据面反代(按 id 打到已发布端口) | 端口分配方式。mpc 是 n² 网状,不是单点反代 |
2.3 落点:HostAgent 内嵌 TeeRuntime
[修正] 上一版说"不新造 serve、不需要 HTTP"。在单层控制面下成立;两层控制面下不成立——站点端在另一台机器上,必须有网络接口。
修正后的落点:
mpc hostd --listen 0.0.0.0:3010 --data-port 3011 --state-dir /var/lib/mpc
├─ API 层(axum / hyper):e2b 兼容 + /attestation 扩展
├─ TeeRuntime(mpc-tee 的 std feature)
│ Entry { id, argv, pid, started_at, state, exit_code, session_id }
│ Command::spawn(不是 exec)+ reaper 线程
└─ 本地网络:每会话一个 EasyTier 实例 + tap
mpc cluster / mpc agent 保留原用途(多方计算的编排与执行),不承担 TEE 生命周期。两者通过 session_id 关联:
当前已实现的参数(--order / --pubkey 那套是设计蓝图,尚未接线,别照着敲):
mpc hostd --listen 127.0.0.1:3010 --state-file /var/lib/mpc/hostd.json
mpc tee up --host alice:3010 --session <hex> --site alice \
--platform snp --program /bin/sleep --arg 30
mpc tee ps --host alice:3010 # 状态表:sandboxID / state / platform
mpc tee attest --host alice:3010 --sandbox job-7 # 四布尔分开报
mpc tee down --host alice:3010 --sandbox job-7 # DELETE 返回 204 空体
注意实例 ID 的参数名是 --sandbox(不是 --id),且 down 在 DELETE(204 空体)之后会补一次 GET 拿停后状态。
TeeRuntime 的实现要点没变:Vec<Entry> + Command::spawn + reaper,状态落盘,重启后按 pid + 启动时间校验孤儿进程——只按 pid 会误杀(重启后 pid 会被复用)。
2.4 "验证通过"必须拆成四句话
verify.rs 现在严格区分「结构/绑定对得上」与「芯片签名已验证」。这个区分必须原样传进 API,不能塌缩成一个 ok=1:
user_data_ok=1 meas_ok=1 tcb_ok=1 chip_sig=0
chip_sig=0 的含义是:绑定关系成立,但没做芯片验签。运维看到 ok=1 就以为安全,是最容易出的事故。fold_semantic_risks() 那种"判定口径只有一份"的纪律,在这里表现为不允许把不同结论合并成一个字段。
[本轮已落地] API 侧形状见 crates/mpc-hostd/src/api.rs 的 AttestationVerdict:user_data_ok / meas_ok / tcb_ok / chip_sig 四个布尔分开报,且响应里不允许出现 ok 这个合并字段;布尔字段缺失一律当 false("没拿到"与"不成立"在安全语义上必须同向,否则解析失败会伪装成通过)。
3. 方向二:EasyTier
3.1 前提纠正:它不是 WireGuard 的薄壳
WireGuard 在 EasyTier 里只有三个边缘角色:一种隧道协议(--listeners wg:11013,与 tcp/udp/ws/wss/quic/ring/faketcp 并列八选一)、外部客户端接入门户(--vpn-portal wg://)、一种加密选项。
主体是:peer 发现与状态、NAT 穿透(UDP/IPv6/TCP 打洞 + 对称 NAT 生日攻击)、OSPF 路由收敛、中继转发、子网代理、多协议隧道引擎、数据面、实例生命周期。仿做等于重写这一整列。
3.2 LGPL 边界本来就划得开
| 用法 | 定性 | 义务 |
|---|---|---|
静态链接进 mpc |
衍生作品 | 整个二进制按 LGPL 分发。唯一不能碰的一档 |
动态链接 .so |
combined work | 允许用户替换该库即可 |
| 独立进程 + CLI/RPC | 两个独立程序 | 只约束被分发的那一个,天然满足"可替换" |
独立进程不是规避手段,是 LGPL 明确许可的正常用法。反过来说,"仿做"才是真风险:仿得像 = 复制加修改,直接落进 LGPL 的修改版条款且很难自证独立实现。
实务细节别漏:分发时要随包附 LGPL 文本和源码获取方式(因为你分发了它的二进制)。
3.3 会话级入网:credential 是签出来的,不是派生出来的
[修正] 初稿写「credential 从 session_id 派生,与 user_data[0..32] 同源」——
按官方文档核对后这是错的:拿 sha256(session_id) 拼 --credential 只会得到一串
EasyTier 根本不认的字节,网络「看起来起好了、实际连不上」。
EasyTier secure mode 的真实流程(官方 secure-mode.html):
# 联盟管理节点(正式节点:持 network_secret,且必须配 --credential-file 持久化)
easytier-cli credential generate --ttl 86400 [--allow-relay]
# → credential_id 管理 ID,可公开,用于撤销与链上核对
# → credential_secret 临时凭据私钥(base64),等价于高敏感密码
# 临时节点(本轮计算):不需要 network_secret,指定 --credential 会隐式开 secure mode
easytier-core --network-name office --secure-mode --credential '<secret>' -p tcp://admin:11010
# 会话结束
easytier-cli credential revoke <credential_id>
框架因此不生成凭据:mpc_tee::link::CredentialProvider 是可插拔接口,
参考实现 mpc_hostd::link::CliCredentialIssuer 只调 CLI;
未配置 provider 即拒绝(与 PolicyVerifier 同一纪律,不假装可用)。
框架做四件事:承载并校验形状(base64、无空白 / 控制字符,防 argv 注入)、
把 credential_id 与 session_id、user_data[0..32] 绑成可公开摘要
(域分隔 TEE_LINK_BIND,私钥不参与哈希,否则等于把私钥哈希公开)、
把摘要写进 link= 与 Receipt、会话结束撤销。
★ 两个方向别混:
- 三档
LinkPolicy管「我能不能经中继出去」; - 凭据的
allow_relay管「别人能不能经我中继」(官方默认false)。
初稿「allow_relay 随档位定」是错的。默认一律 false(最小权限),
只有本节点确实被指派为联盟中继时才显式授权。
管理节点必须配 --credential-file,否则重启后已签发的凭据全部失效。
3.4 relay 策略:三档,参数控制
决策 4 要求两者兼容。落到具体参数:
| 档 | 参数 | 适用 |
|---|---|---|
open(默认) |
不设限制 | 内网全通、可用性优先 |
allowlist |
--relay-network-whitelist <联盟网名> |
只允许联盟自有中继转发,公共节点不作中继 |
p2p-only |
--p2p-only |
仅与已建立 P2P 的节点通信,缺直连即失败 |
辅助参数(按需组合,不要全部打开):
--disable-sym-hole-punching:关掉对称 NAT 生日攻击打洞(会被运营商风控,但 NAT4-NAT4 场景唯一的通路)--private-mode:禁止不同网名/密码的节点借道本节点中转--disable-p2p/--need-p2p:精细控制谁可以和本节点建 P2P
必须记录实际路径。easytier-cli peer 的 cost 列会标 p2p / relay,宿主机要把这个值写进 TEE_ATTEST 的 link= 字段和 Receipt。链路的 AEAD 让中继看不到明文,但看得到元数据(谁和谁、多大流量、什么时候)。报告里写"私有部署"实际走了公共中继,是这类系统最常见的失真。
link 值同时是准入项:allowlist 档下如果实际路径是 relay 且中继不在白名单,admit 拒绝。
3.5 不要把 EasyTier 塞进 TCB
在 guest 里跑能让元数据也进 TEE,但网络组件进入 measurement 且随版本漂移,--pin 就失去意义了。宿主侧组网 + guest 走 tap/bridge 是目标形态。
[修正] 初稿写「deploy/tee/ 已经实现了这条链路」——实际那里只有
deploy/tee/real-machine/kbs-net.sh 建的本机 tap + bridge,用途是让 guest
够到宿主上的 KBS(真机自带的 qemu 没编 slirp,-netdev user 用不了)。
那是 KBS 出网链路,不是 EasyTier 跨站点组网。EasyTier 实例本期由部署层
按 mpc link plan --argv 起,框架不托管长驻进程。
3.6 已有资产:connector 做过同一件事的 TPM 版本
ssw/studio 的 security-connector 有 TPM_INIT → AUTH_REGISTER → EASYTIER_JOIN → RUNNING 六态状态机。状态机形状和 credential 生命周期应该对齐,别搞两套入网流程。
4. 方向三:飞梭链(Pro + 国密 + 硬规则 + 无 WASM)
4.1 链上执行只有一种做法:合约
决策 3 与 6 合起来,只剩一条:
| 原方案 | 状态 |
|---|---|
| A 硬规则编译成 Solidity 合约,共识节点执行 | 采用 |
| B 链下执行 + 上链(无证明) | 禁用。不可篡改的假话比可篡改的假话更危险 |
| C OPA 在 TEE 内执行 + 附证明上链 | 保留(业务合规策略,见 4.6) |
| D Rego→WASM 上链 | 删除。WITH_WASM 保持 OFF |
D 删除的连带收益:生产联盟链不用为一条没人维护的执行路径开编译开关,也不用和联盟成员对齐建链参数。
4.2 Pro 版的实际形态
| 组件 | 职责 | 端口(示例) |
|---|---|---|
bcos-rpc |
接收客户端 JSON-RPC,转发给节点;可横向扩展 | 20200 |
bcos-gateway |
跨机构节点间通信;可横向扩展 | 30300 |
bcos-node |
共识 / 执行 / 上链;内部再分 txpool / scheduler / pbft / ledger / front | 经 tars proxy(40400+) |
两个事实决定落地方式:
- TARS 不是必须的。官方提供
installation_without_tars:build_chain.py build -c config.toml -O ./generated产出安装包,手动起各服务,用tars_proxy.ini指定模块间 endpoint。建议先用无 TARS 路径——TARS 管理台自带 MySQL + web(3000 端口),是运维团队的资产,不该成为 ssw-mpc 的依赖。 - 站点端只连
bcos-rpc,不连节点。这层解耦让链扩容对站点端透明。
建链(含国密):
bash build_chain.sh -p 30300,20200,40400 \
-l <ip>:2,<ip>:2 -C deploy -V pro -o generate -t all -s
# ↑ 国密
4.3 国密的五个硬约束
① 建链时定,之后不可改。 官方注释:sm_crypto "should never be changed"。选错只能重建链、迁移数据。这是第一个必须在开工前确认的事。
② 合约里 keccak256 / sha3 实际执行 SM3。 官方 OPCODE 差异表明确写了(3.x 同样适用)。后果:链下算 hash 必须用 SM3,否则链上比对永不对,症状是"hash 不匹配",极易被误判成 ABI 编码问题。CREATE2 的地址推导也按 SM3 算,合约地址会和以太坊工具算出来的不一样。
③ 交易签名是 SM2,交易结构变长。 标准版 520 bits → 国密版 1024 bits(含 512 bits 公钥)。RLP 结构和 v 的取值都要按 FISCO 的规范来,不能套以太坊的 secp256k1 经验。
④ SM2 不在 Rust 侧实现,走国密模组 + OpenSSL provider。 接口形态已定:只走 provider,不走 engine / SDF / PKCS#11。
mpc-chain (Rust) ──FFI──▶ libcrypto(Tongsuo ≥ 8.4)──provider──▶ 国密模组
Signer trait 独立 OSSL_LIB_CTX 私钥不出模组
三条收益,缺一条都不值得引入 FFI:
- 私钥不出模组。
PolicyBundle签发私钥、Member治理密钥放硬件里,落盘泄露和内存抓取同时失效。对一个"站点端控制面持有唯一签发权"的设计(4.6),这是必需项。 - 密评可过。密评看密码模块资质,不看代码质量。RustCrypto 的
sm2(官方声明"从未被独立审计")只能用于测试与离线校验,不进生产链路。 - 与链同源。FISCO 国密版本身就构建在 Tongsuo 上,签名/验签同一套实现,省掉一整类"格式对不上"的联调。
版本门槛是硬的:provider 是 OpenSSL 3.0 引入的架构,Tongsuo 8.4.0 才迁到 OpenSSL 3.0.2 基线;8.3.x 及以前是 1.1.1 基线,只有 engine。所以选 provider 等于把版本锁在 Tongsuo ≥ 8.4,建议 8.5——理由是它有现成资产:
- 内置"商用密码检测和认证 Provider":身份认证、完整性验证、算法自测试、随机数自检、熵源健康测试。这几项正是密评要查的内容,不用自己写。
- 已有"SMTC Provider 适配蚂蚁密码卡":厂商 provider 该怎么接,项目里有先例可对照,不用从零摸 OSSL provider 的接口约定。
"加载了 provider" ≠ "签名走了模组"。 这是这一节最要紧的一条。Tongsuo 自带的 default provider 里本来就有 SM2,模组 provider 注册同名算法时谁被选中取决于 libctx 与 property query。如果只做 OSSL_PROVIDER_load 就直接签,很可能一直在用软件实现而没人发现——直到密评现场被问"你怎么证明私钥在硬件里"。
对策不是"我去指定它",而是让环境里没有替代品:
// openssl crate 的 Provider::load 语义 = OSSL_PROVIDER_load + 关掉 fallback
let ctx = LibCtx::new()?; // 独立 libctx,不碰 default
Provider::load(Some(&ctx), "gmprovider")?; // 该 ctx 内 fallback providers 被禁用
// 此后在该 ctx 里 new_from_name("SM2") 要么选到模组,要么失败 —— 不会静默回落
openssl crate 的 provider 模块只有 load / try_load / set_default_search_path 三个方法,没有 property query 封装(EVP_PKEY_CTX_new_from_name(ctx, "SM2", propq) 的第三个参数没暴露)。所以两条路:
- 用
Provider::load的"禁用 fallback"语义拿到唯一性——首选,纯 Rust 就够,且证据比 property query 更硬("不存在替代实现"比"我要求用哪个"更难反驳)。 - 若要按 property 精确路由(同机装多个 provider),必须自己绑三个符号:
EVP_PKEY_CTX_new_from_name、EVP_PKEY_sign_message_init、OSSL_PROVIDER_available。工作量不大,但要自己管OSSL_LIB_CTX生命周期。
启动自检三件,任一不满足就拒绝启动(对齐现有"密钥缺省 → 拒绝启动"的纪律):
| 检查 | 做法 | 防的是什么 |
|---|---|---|
| provider 加载 | 独立 ctx 里 load 成功,且 SM2 可用 |
驱动 / so 没装对 |
| 私钥不可导出 | 读 OSSL_PKEY_PARAM_PRIV_KEY 必须失败 |
"私钥不出模组"变成口号 |
| 已知答案试签 | 固定私钥 + 固定消息 → 与 KAT 向量比对 | 签名格式 / distid 与 FISCO 不一致 |
第二条最容易被跳过,也最容易被现场戳穿:模组往往支持"导入私钥再签",而导入是双向的。必须要求 keymgmt 的私钥参数不可读,否则模组退化成一个更贵的文件。
签名输出一定是 DER,拆包是确定工程项,不是待确认项。 OpenSSL 的 SM2 走 EVP 签名接口,输出是 ECDSA-Sig-Value 的 ASN.1 DER;FISCO 交易要 64 字节裸 r||s + v。所以必须拆 ASN.1,且要处理两种情况:r/s 高位为 1 时 DER 会插 0x00(33 字节),值小时会省略前导零(可能 < 32 字节)。两边都补/截到 32 字节,长度越界即报错,不能 unwrap。
新的阻塞项:模组 distid 可设性。 SM2 签名对 (user_id, msg, pubkey) 做预处理,OpenSSL 侧通过 EVP_PKEY_CTX_set1_id 设,默认 1234567812345678。硬件模组内部的 SM2 实现可能固定 distid 或不支持自定义。这条与 4.4 的链上验签、与 FISCO 交易验签是同一个前置条件,采购时必须问清,不能等联调。
Signer 做成 trait,两个实现:SoftSigner(sm2 crate,仅测试)+ ModuleSigner(provider,生产)。单元测试不依赖硬件,CI 能跑;ModuleSigner 的集成测试标 #[ignore],靠独立通道跑(与 OP-TEE 同样的两段式,见 1.7)。
代价与边界:
mpc-chain不再是纯 Rust。只影响它一个 crate:mpc-core(零依赖 / no_std)与mpc-tee不受影响,既有约束不破。- provider 是运行时 dlopen,编译期不需要模组:CI 能编,但运行期需要 libcrypto + provider so + 模组驱动三层齐备,缺哪层由启动自检指出。
mpc-chain进不了 musl 静态产物——但它只跑在站点端/宿主,不需要。- 客户端 Tongsuo 版本不必与链节点一致(只要签名格式一致);但若要用 8.5 自带的密评 Provider,就锁 8.5。
⑤ user_data 的绑定 hash 是 sha256,链上没有 sha256 预编译。 mpc-tee/src/session.rs 用自研 sha256 算 user_data 两段。国密链只提供 sm3 和 sm2Verify 预编译,没有 sha256。所以:
链上不能重算
user_data。 链上只能存原始 64 字节,由验证方离线比对。
如果将来要求"链上可重算绑定值",必须把 mpc-tee 的绑定 hash 从 sha256 换成 SM3——那是全系统最敏感的 64 字节,且 sha256 是零依赖自研实现,换 SM3 要自己写一份。这笔账现在不要动,写进约束即可。
4.4 [修正] 链上验不了芯片签名?要分平台
上一版说"链上验不了 SNP/CSV 签名,因为没有预编译"。这句对 SNP 成立,对 CSV 不成立。
FISCO BCOS 有 CryptoPrecompiled(bcos-executor/src/precompiled/CryptoPrecompiled.cpp),提供:
function sm3(bytes memory data) public view returns(bytes32);
function keccak256Hash(bytes memory data) public view returns(bytes32);
function sm2Verify(bytes32 message, bytes memory publicKey, bytes32 r, bytes32 s)
public view returns(bool, address);
sm2Verify 的实现是 sm2Recover(msgHash, sig) + sm3Hash(pubkey) 推地址,签名不合法则 recover 失败返回 false。这是一个真正的链上 SM2 验签。
所以分平台:
| 平台 | 芯片签名算法 | 链上可验? | 启动形态 |
|---|---|---|---|
| 海光 CSV | SM2-with-SM3 | 理论可验,走 sm2Verify。前置条件见下 |
qemu 直起 VM |
| AMD SEV-SNP | ECDSA P-384 | 不可。无 P-384 预编译,Solidity 实现 gas 不可接受 | qemu 直起 VM |
| ARM OP-TEE | 设备密钥(P-256 或 RSA,取决于平台) | 不可 | CA/TA,不起 VM(见 1.6) |
| Intel TDX | ECDSA P-256 | 不可。无 P-256 预编译 | 未实现(仅枚举) |
CSV 走链上验签的三个前置条件,缺一不可,且都需实测:
- user id(Z 值)一致。SM2 签名对
(id, msg, pubkey)做预处理。FISCO 的sm2Recover在其源码里没有显式设置 id(全仓搜不到1234567812345678),实际用的是库默认值;CSV 固件用的 id 需从海光文档或实测确认。对不上就是永远验不过,且报错只有false,没有原因。 message传的是 hash 还是原文。预编译签名收bytes32 message,内部当 hash 用。如果 CSV 报告签名的是"报告的 SM3 摘要",可以直接传;如果签的是原文,要先sm3()再传。- 公钥编码。预编译收
bytes publicKey(非压缩 SEC1,65 字节),而 CSV 报告里公钥的编码格式需核对。
结论保持不变的部分:链上验签只覆盖"芯片确实签了这段字节",不覆盖"报告内容是否合理"(TCB 门槛、度量 pin、绑定值仍需链下判)。所以验证方签名这一层不因为 sm2Verify 而取消——它只是把"我验过"升级成"链自己也能验"。
国密只在海光跑(决策)。所以这张表的实际结论是:
- 海光 = 国密闭环:交易 SM2(模组)+ 合约
sm3/sm2Verify+ 芯片 SM2,一条算法链走到底,且链上能自证。 - AMD = 非国密主力:SNP 的 P-384 与国密无关,验证方签名层必须保留。后续若要在 AMD 上跑国密,等于"非国密证明 + 国密链"两套信任根拼接,单独做,不要混进这一轮。
- OP-TEE = 独立通道的形态:见 1.6 / 1.7。它连"直起 VM"都不成立,验证规则也换成 TA 签名 + seal 那五条;不做远程证明,所以链上这层"验证方签名"它给不出来。
4.5 链上对象
只存 hash 与承诺,不存数据。
| 对象 | 字段(示意) | 谁写 |
|---|---|---|
Member |
机构 ID、签名公钥、TEE 平台类型、host 公钥列表、可用算力、状态 | 联盟治理(多签) |
PolicyBundle |
bundle_hash、issuer、生效区间、撤销状态 |
站点端控制面(决策 5) |
DataOffer |
owner、数据集摘要、可用算法 ID 列表、策略表达式 hash | 数据持有方 |
ComputeOrder |
参与方集合、catalog ID + IR hash、各方输入摘要、min_tcb、会话公钥、policy_bundle_hash、deadline |
发起方 |
Receipt |
结果 hash、decision_id、input_hash、各方签名、user_data(64B)、chip_sig 标志、link 路径 |
参与方 + 验证方 |
ComputeOrder.会话公钥 是关键:现在 mpc tee plan --pubkey 是外部传进来的,没有可信来源,中间人可替换做 MITM。登记到链上(由参与方长期密钥签名)才补上这一环。
policy_bundle_hash 留在链上、不折进 user_data:折进去能拿到密码学级绑定,但要动 session.rs 的 64 字节拆分(且国密下要换 SM3,见 4.3⑤)——代价与收益不成比例。
4.6 策略签发:内容可分散,签发必须收口
决策 5 落地为三段式:
机构 A 写策略 ─┐
机构 B 写策略 ─┼─→ 站点端控制面:校验 → 合并 → 签名(SM2)→ 发 bundle
联盟全局表 ─┘ │
├─→ 分发到各宿主机(拉取 + 验签)
└─→ PolicyBundle 上链(bundle_hash + issuer + 有效期)
规则:
- 内容可以来自任何地方(机构自持、联盟全局表),控制面不做内容审查,只做结构校验 + 签名
- 签发私钥唯一在站点端。机构提交的是"策略草稿",不是"生效策略"
- 宿主机只验签 + 验 hash + 验有效期,不判断内容合法性——判断合法性是站点端的事,宿主机判断就是第二套口径
- 撤销通过链上状态位,宿主机每次加载 bundle 前查一次(带短 TTL 缓存)
这样解决了"审计口径散":内容分散不假,但任意一份生效的策略都能追到唯一的签发者和唯一的 hash。
OPA 的位置不变:跑在 guest 内,decision 落 Receipt。三条硬要求照旧——bundle 签名并 pin hash、每条 input 要有来源字段、decision 含 decision_id + bundle_hash + input_hash。
4.7 fail-open 与 fail-closed 必须分开
mpc_tee::schedule::admit 是全 fail-closed,没有降级分支。如果链也这样接,链挂 = 算不了。
| 用途 | 策略 | 理由 |
|---|---|---|
| 成员资格 / 硬规则 | fail-closed,带缓存 + 短 TTL | 准入错了是安全事故;缓存让链抖动不阻断计算 |
| 合规策略(OPA) | fail-closed,无缓存 | 判定是"这次能不能算",缓存等于放宽 |
| 订单 / 回执 / decision 存证 | fail-open + outbox | 链是审计锚,不是执行前提 |
outbox 必须幂等:同一 order_id + 同一 decision_id 重复提交不产生两条记录,否则补链会写出重复账。decision_id 的确定性正好当幂等键。
4.8 mpc-chain 接入形态 —— [修正] 3.x 有 eth_ 兼容端点
- 新建
crates/mpc-chain(stdonly):本期落形状层(对象规范编码 + 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-planefeature +[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 参数当 RLPWeb3Transaction解(codec::rlp::decode);web3jsonrpc/model/Web3Transaction.cppincludeSecp256k1Crypto.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‖pub128B 签名,flush --mode signed-tx发完整已签名交易并复用Outbox::flush_with状态机 (不许另起一套遍历),tools/selftest-fisco-contract.py(主门禁第 22 条)在真链上 完成部署 / 调用 / 读回 / 负向矩阵 22/22 全绿。★ 签名口径也一并纠正:节点fast_sm2_verify验的是e = SM3(ZA‖dataHash),不是签裸dataHash; 详见docs/FISCO_UPSTREAM_TRUTH.md§3.1。仍成立的只有后半段边界: 真实bcos-rpc的 TLCP 通道未通、硬件模组 provider 未落地、软件签名器密评不可过。
★ 配置与准入纪律:
① sm_crypto 必须显式给、false 直接拒(标准版链上用 keccak256Hash,链下没有 keccak256 实现,放行等于「摘要永远对不上」的假绿);true 已由用户确认,建链参数按国密冻结。
② 客户端到 bcos-rpc 这一跳做国密 TLCP(用户拍板)。client_tlcp=true 是合法声明;false 在生产路径 flush --transport tlcp 被拒。明文只允许显式 --transport stub 桩自测并打印警告 —— 传输形态没有默认值,不许留「没传就悄悄降级」的后门。
③ 签名器按用户「先用 openssl 做」落 OpenSslSoftwareSigner:真签 SM2,把 OpenSSL 的 DER ECDSA-Sig-Value 拆成 FISCO 要的 raw r||s 64B,公钥去掉 04 前缀成 64B。但软件私钥可导出、密评不可过:SignerPolicy::ProductionModule 一律拒绝它,开发必须显式选 DevelopmentSoftware 并把警告透给运维;security_profile() 与「私钥不可导出」交叉校验,禁止软件谎报硬件模组。不引 RustCrypto sm2 crate(未经独立审计)。
★ distid 三重对齐:唯一值 1234567812345678,真相源 mpc_core::domain::SM2_DISTID。依据是 FISCO 上游 bcos-crypto/bcos-crypto/signature/fastsm2/fast_sm2.cpp:35 的 const char* c_userId = "1234567812345678",与 OpenSSL SM2 默认 user id 同值;同文件 c_R_FIELD_LEN=32 / c_S_FIELD_LEN=32 / c_PUBLICKEY_LEN=64 也印证裸 r||s 与裸公钥格式。三处消费方(链下签名 / 链上验签 / CSV 证明验签)都必须声明它,aligned_distid() 任一漂移即点名拒绝。硬证据是系统 openssl dgst -sm3 -verify 验过框架签出的签名(门禁第 15 条)—— 只在 Rust 里自签自验是循环自证,测不到 distid 漂移。
★ TLCP 本机实测与 GmSSL(2026-11-07 用户提点后追加):OpenSSL 4.0.3 的 openssl ciphers -v 无 TLCP 套件、无 tongsuo;用户指出可用 GmSSL(开源免费、Apache-2.0),brew install gmssl 装到 3.2.0:gmssl tlcp_server -help / tlcp_client -help 支持 SM2 双证书,套件名是 TLS_ECC_SM4_CBC_SM3 / TLS_ECC_SM4_GCM_SM3(与 Tongsuo 的 ECC-SM2-SM4-CBC-SM3 命名不同,TLCP_CIPHER_SUITES 合并白名单收两套名字)。tools/selftest-tlcp-gmssl.py 现场生成 SM2 根 CA + 签名/加密双证书、真起服务端与客户端,本机环回握手跑通:Protocol: TLCP / Version: TLCP (0101) / 国密套件 / 应用数据往返 / -certout 双证书;负向(错误 CA → tls_cert_chain_verify、纯非国密套件 → tls_ctx_set_cipher_suites)都带期望特征,19 条判据进第 16 条。另:gmssl certgen -help 明写默认 -sm2_id 就是 1234567812345678,与 SM2_DISTID 做跨实现对拍(第 16 条判据)。
★ 但绝不能把「本机握手通过」说成「通道已通」:① GmSSL 3.x 移除了核心的 OpenSSL 兼容 API(libgmssl 是独立 ABI),不能当 provider 直接喂给 reqwest;② 服务端是环回 tlcp_server,不是 bcos-rpc,也没验证节点是否启用 TLCP;③ Rust 侧把 JSON-RPC 经 TLCP 发出去的进程通道(gmssl tlcp_client -in file,响应走 stdout)已接入 TlcpTunnel 并跑通环回 echo 实证(第 18 条),但服务端是 echo 不是真节点,不等于 bcos-rpc 通道已通。所以 TlcpReadiness 已从 NeedsFfi 推进到 LoopbackReachable(环回可达),但仍非 Ready、require_transport() 发真交易继续 fail-closed;脚本成功只打印 GMSSL_TLCP_TUNNEL_OK + BCOS_RPC_NOT_VERIFIED。GmSSL 是软件实现、私钥可导出,不能过密评,不替代硬件国密模组。本机 OpenSSL 4 用 CLI 自签 SM2 X509 报 wrong public key type,双证书正向校验仍待真机环境对拍;负向(非法配置即拒、环境缺失即拒)已在第 15 / 16 条真跑。
★ HttpChainClient 显式 .no_proxy():控制面只连配置里的 host:port。系统代理会把这一跳的端点换掉 —— 桩测试里表现为回环端口被代理接走后返回 502(而不是 Connection refused),生产里会让国密 TLS 的实测结论整个失效(TLS 终止点变了)。门禁第 14 条有专门回归探针。
4.9 不要重复 WeDPR
镜像里有 WeBankBlockchain/WeDPR——微众自己的"区块链 + MPC"平台,已经把"平台化集成"走完了。ssw-mpc 如果也做"链上管数据集、管项目、管任务",就是用更少资源重做一个更弱的 WeDPR。
差异化只有一条,且恰好是 WeDPR 没做的:可验证执行。WeDPR 证明"计算按协议做了"(密码学层),ssw-mpc 能额外证明"这段二进制,在这个 TCB 上,用这把会话公钥、按这份策略算的"(硬件层)。链上存证要把后者当主字段。
5. 交汇点:会话是唯一主键
┌──────────────────────────────────────────┐
│ Session(session_id + session_pubkey) │
└──────────────────────────────────────────┘
│ │ │
┌─────────────────┘ │ └─────────────────┐
▼ ▼ ▼
TEE 绑定 EasyTier 入网 飞梭链登记
user_data[0..32] = sha256( 短期 credential(会话派生) ComputeOrder.会话公钥
domain‖session_id‖site‖pubkey) allow_relay 单独授权(默认 false) ComputeOrder.policy_hash
user_data[32..64] = sha256( 会话结束即失效 Receipt.decision_id
domain‖measurement‖platform‖tcb) Receipt.user_data(64B)
│ │ │
└──────────► 会话准入(站点)· 运行时准入(宿主)◄─────────────────────┘
│
▼
LaunchSpec → qemu → guest 内 mpc + 策略引擎
四个约束:
user_data已经绑定会话公钥(crates/mpc-tee/src/session.rs:75),链上登记的会话公钥与报告里的公钥天然可对齐,不需要新协议。- EasyTier credential 由管理节点签发(不是从
session_id派生)。框架把credential_id与session_id、user_data[0..32]绑成摘要(域分隔TEE_LINK_BIND)写进link=与Receipt;会话结束由控制面credential revoke,凭据与报告一起失效。私钥不参与摘要计算。 Receipt.user_data存原始 64 字节,不存链上重算值(国密链无 sha256 预编译,见 4.3⑤)。- 准入拆两段:站点管成员与策略,宿主管度量与芯片。链的硬规则在站点段,芯片判定在宿主段。
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 |
| — | — | 删除(决策 6) |
阶段状态(2026-11-08 追加 TLCP 进程通道后,历史快照):0a 已完成(第 12 条)、1 已完成(第 13 条)、2 形状层 + OpenSSL 国密签名 + GmSSL 本机 TLCP 真握手 + Rust 侧 TLCP 进程通道环回实证已完成(第 14 / 15 / 16 / 18 条);3 第一段已完成(第 17 条:真 OPA bundle 签发 / 真判定 / decision 幂等存证);0b 的编排与判据已实现、QEMU 实跑待有 SDK 的机器。主门禁共 18 条(当时)。
[当前状态 2026-11-08] 上段与紧随其后的「两段诚实边界」都是当时的阶段结论, 不是现状。现在:主门禁 25 条(第 21 条真交易编码、第 22 条真链合约、第 23 条 SA 扩展模式、第 24 条零种子守卫、第 25 条集群自报判据自测 + 破坏实验); 阶段 2 的 FISCO TARS 编码与已签名交易已落地并在真链实证;阶段 3 的 合约部署已实证(
MpcHardRule.sol)。但「OPA 在 guest 内执行 / bundle 分发 / 链上撤销状态位读取后端 / decision 签名上链」仍未做,QEMU 实跑仍待 SDK。 逐条对照见本文顶部状态提示,总览见docs/INDEX.md。 ★ 两段诚实边界(2026-11-07 当时)都不许冲掉:① 当时阶段 2 仍不含真实交易签名上链(★ 现已落地:TARS 编码 + 已签名交易 + 真链实证,见文首状态提示)—— FISCO 自有交易编码 / 国密模组 provider / 真实bcos-rpc的 TLCP 通道当时未落地(后两者至今仍未落地;Rust 侧 TLCP 进程通道环回实证已落地,但服务端是 echo 不是真节点),见 4.8 与tools/fisco-realnode-probe.py;② 阶段 3 只完成第一段 —— OPA 仍在宿主 / 控制面 spawn,不在 guest 内执行,撤销来源分两类(调用方本地桩 /--revocation chain声明链读),链读后端未接入 ⇒ 声明 chain 即 fail-closed 拒(绝不默认revoked=false放行),decision 只入 outbox、未签名未上链;合约部署当时未做(现已真链实证),OPA bundle 的 guest 分发仍未做。成功输出为OPA_DECISION_OK+OPA_GUEST_NOT_VERIFIED+CHAIN_NOT_VERIFIED,不是「阶段 3 已完成」。
★ 第 4 条门禁本轮补上 guest 产物边界:mpc-chain 引 openssl 后 musl 静态产物链接失败,
暴露的是「宿主控制面被编进 guest」而不是环境缺包。现按 feature + target 切分,
tools/check-guest-artifact.py 三层探针(依赖树 / 编译期守卫 / ELF 标识)进主门禁;
deps 不依赖 musl target 是否安装,避免「跳过目标」把边界判据一起跳掉。
本轮(2026-11-07 当时)./tools/ci.sh 18 条全绿(现为 25 条):第 4 条 guest 探针 22(deps)/ 3(guard)/ 15(binary)、
第 14 条 50、第 15 条 36、第 16 条真握手 19 + TA 密钥 16 + 两份零依赖契约判据
11 / 12、第 17 条真 OPA 闭环 41 + 零依赖判据 22、第 18 条 TLCP 进程通道环回实证 15 + 零依赖判据;
第 10 条芯片验签器自测现含 SNP + CSV 两平台(CSV 零依赖 18 条);
真机契约实跑如实输出 FISCO_REALNODE_SKIPPED 与 6 项缺失,无静默通过。
★ 两台真机的实测结论(2026-11-07) 见 docs/REAL_MACHINE_FINDINGS.md。三条改变了代码:
① 海光 CSV 的官方 SM2 签名不覆盖 MAC 字段(篡改 MAC 末字节后官方输出逐字节相同、
仍 verify success)⇒ wrapper 去掉永不命中的 MAC 断言,边界固化成判据;
② 海光官方验签器缺证书时联网从 cert.hygon.cn 下载,链结论其实来自网络
⇒ wrapper 链校验模式强制 unshare -rn 断网 + 本地前置校验证书齐全;
③ AMD SNP 侧用当前 HEAD 的产物,五关闭环 + 负向矩阵真机跑通
(guest 与 KBS 判定器用同一份 musl 产物 ⇒ 验证方与放行方同源)。
★ TCB 门槛关必须单独可达:设 guest 侧 MIN_TCB=99 时拒在更早的节点准入层,
根本没走到 KBS;要测到 KBS 侧的 TCB 关必须 --tcb 3(实际值)+ --min-tcb 99(门槛)。
为什么 0a 必须第一:后三件都要"可编排的对象"。没有 TeeRuntime 和 e2b 接口,"给这个会话签 credential""把这轮登记上链"都没有承载点。
HTTP 栈决策:两次反转,最终用 axum + tokio + reqwest(2026-11-07)
这一项来回过两次,如实记下来,免得后来人按旧的段落改代码:
- 初稿写「axum + tokio,仅宿主二进制」。
- 0a 开工时拍板改自研
std::net,零第三方依赖,理由是仓库的低依赖定位与 no_std 双守。 - 最终改回开源组件。触发点是实测:自研层把响应头与 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‖pub128B 已签名交易已落地, 真链合约部署 / 调用 / 读回已实证(第 21 / 22 条,22/22 全绿),签名口径是e = SM3(ZA‖dataHash)。仍未实现的只有国密模组 provider 与真实bcos-rpc的 TLCP 通道;软件签名器私钥可导出 ⇒ 密评不可过。见docs/FISCO_UPSTREAM_TRUTH.md。 CLImpc chain digest|submit|flush|status|admit|keygen|sign|align|tlcp|governance;tools/selftest-chain.py50 条判据进主门禁第 14 条(含国密链提交方法纠正的 4 条)、tools/selftest-chain-gm.py36 条判据进第 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)
sm_crypto=true已确认。建链参数按国密冻结,不可逆;配置层false一律拒。- 国密签名先用 OpenSSL 软件实现。真能签 SM2(DER→raw 64B);但私钥可导出、密评不可过,生产仍要换硬件模组 provider。采购规格书条件不变:provider 形态、私钥不可导出、distid 可设、Tongsuo ≥ 8.4(建议 8.5);engine 形态不接受。软件实现只是把链路打通,不替代采购。
- 客户端到
bcos-rpc做国密 TLCP 已定。本期落双证书契约 + 环境探测 + fail-closed;用户提点后装了 GmSSL 3.2.0,本机环回真 TLCP 握手已跑通(第 16 条 19 判据),Rust 侧 TLCP 进程通道也已环回实证可达(第 18 条,spawngmssl tlcp_client收发真实 JSON-RPC),但真实bcos-rpc是否启用 TLCP 仍未验证(服务端是 echo 不是节点),见 4.8。Tongsuo FFI 不再是唯一路径。 - OP-TEE 覆盖范围定稿:只覆盖小隐私计算(两方、设备侧、同域),不进 EasyTier、不进链、不进
TeeRuntime进程生命周期(它是会话级 attach/dev/tee0,杀进程会切断别人正在用的 TA)。CI 覆盖 QEMU 五条判据,真板作为上线前一次性验收;两者证明的东西不同,不能互相替代。 - SM2 distid 三重对齐已定:唯一值
1234567812345678(FISCOfast_sm2.cpp:35的c_userId与 OpenSSL 默认同值),真相源mpc_core::domain::SM2_DISTID;三处声明任一漂移即点名拒绝,系统 openssl CLI 独立验签为硬证据(门禁第 15 条)。模组内部若硬编码别的值,采购验收时必须实测对齐。 - 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.py16 条判据进第 16 条,在没 SDK 的机器上也能被执行到(守卫不会被前置环境检查抢先)。
待实测(不阻塞开工,但阻塞上生产)
-
模组能否直接输出裸
r||s。DER 拆包本身是确定的(4.3④),所以这条不阻塞;但如果模组能直接出裸值,就少一段容易写错长度的 ASN.1 解析。 -
CSV 报告的公钥编码与签名对象(原文 or SM3 摘要),决定
sm2Verify的三个入参怎么填。 -
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-rpcTLCP 通道) 与 ③(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(缺的是实现),绝不打印通过。 -
OP-TEE 在 TA 共享语义下的租户隔离。TA 是设备级单例,多机构共存时密钥域怎么分——
optee/core.rs的 seal 格式是否已带租户维度,要核对。这条现在是生效的(OP-TEE 已进本轮,见 1.7)。
已拍板(2026-11-07)
- Pro 版先不上 TARS。ssw-mpc 只依赖
bcos-rpc的 HTTP 端点,TARS 留给运维团队自建(4.2)。 - 硬规则进合约,业务合规策略仍走 OPA。两者域分隔不同(
TEE_CHAIN_HARD_RULE/TEE_OPA_BUNDLE)、字段互相禁止(HardRuleSet拒wasm/rego,OpaPolicyBundle拒min_tcb等硬规则字段)、不开 WASM;策略签发收口到站点端控制面。第 15 条落对象形状与边界守卫;第 17 条落阶段 3 第一段(真 bundle 签发 / 真opa eval/ decision 幂等存证),但 OPA 仍不在 guest 内、撤销链读后端未接入(声明 chain 即 fail-closed 拒)、decision 未签名未上链;合约部署已于 2026-11-08 真链实证(第 22 条,MpcHardRule.sol),OPA bundle 的 guest 分发仍未做。
附:事实来源
本项目
crates/mpc-tee/src/schedule.rs(admit单段准入、LaunchSpec、qemu_argv)crates/mpc-tee/src/site_admit.rs(站点侧准入,产出TeeRequirement而非LaunchSpec;session_admit()10 条拒绝项;PolicyVerifier为可插拔 trait,未配置验签器即拒绝(不是"不验就放过");SitePolicy::canonical_bytes()给出唯一确定的签名对象——字段顺序固定 + 列表长度显式编码 + 4 字节大端长度前缀 + 域分隔mpc_core::domain::TEE_SITE_POLICY,签名本身不编进被签内容(否则自指))crates/mpc-hostd/src/runtime.rs(TeeRuntime:Command::spawn+ reaper + 状态落盘;必须持有Child句柄并用try_wait()收割,否则 Rust 的Child在 drop 时不 wait → zombie →process_alive永远为真 → reaper 永远收不掉;存活与身份是两个独立判据——存活由子进程句柄try_wait()判定,身份优先级为「有句柄 ⇒ 身份天然确定」(句柄指向内核里那个具体进程,pid 在被回收前不可能复用)→「无句柄(重启恢复的孤儿)⇒ 才用平台启动标识做三态判定」,Some(false)绝不发信号、None不发信号(fail-closed);signal_pid必须跨平台——Rust 标准库只有Child::kill()(= SIGKILL),没有 SIGSTOP / SIGCONT,而这两个是 pause/resume 的唯一实现,不能按平台 cfg 掉)crates/mpc-hostd/src/api.rs(e2b 兼容面:SandboxView字段名必须与 e2b 一致——templateID/sandboxID/clientID/envdVersion/envdAccessToken/domain/alias/timeout/memory;扩展字段放同一层不嵌套(嵌套会让老 SDK 反序列化失败);GET /sandboxes返回裸数组;DELETE /sandboxes/{id}返回 204 空体(e2b 硬要求,不能改成 200 + JSON);AttestationVerdict的四个布尔分开报,布尔字段缺失一律当false——"没拿到"与"不成立"在安全语义上必须同向)crates/mpc-hostd/Cargo.toml(axum 0.8 + tokio 1 + reqwest 0.12 blocking;依赖只落在这个独立 crate,mpc-tee保持零 crates.io 依赖、连build.rs都移走了——build/build_optee.sh会把整个crates/mpc-tee拷进 OP-TEE SDK 做 armv7 离线交叉编译,Cargo 解析阶段不能要求拿到 axum)crates/mpc-hostd/src/server.rs(axum / hyper 接管协议层;fallback单 handler 把 axum 请求转成protocol.rs的中间表示再交给api::dispatch——路径分段规则只留一份,不在路由层重写一遍;显式把守三条边界:chunked → 400、重复Content-Length→ 400、body > 4 MiB → 413;204 空体)crates/mpc-hostd/src/protocol.rs(协议无关的Request/Response/Status中间表示 —— 换协议栈不换业务判定的隔离带;自研 HTTP 解析器 624 行已删)crates/mpc-hostd/src/client.rs(reqwest blocking 客户端;fail-closed:endpoint 只认host:port、路径必须以/开头且无控制字符(防请求头注入)、连接与整体请求都带超时、禁止跟随重定向、响应必须 2xx 且Content-Length准确(拒绝 chunked 与重复 CL)、body 上限 4 MiB;非 2xx 把服务端message带出来——"为什么被拒"才是排查关键;204 空体容忍)crates/mpc-hostd/src/json.rs(自研 JSON 编解码,保留:它不是 HTTP 层,且被TeeRuntime状态落盘复用;键有序,保证状态文件可回读)crates/mpc-cli/src/hostd.rs(mpc hostd子命令 +mpc tee up|ps|attest|down宿主端客户端;非回环地址必须显式加--allow-remote——宿主控制面当前没有鉴权;down在 DELETE(204 空体)后补一次 GET 拿停后状态)tools/selftest-hostd.py(进主门禁第 12 条;33 条判据:起真 hostd(真 socket、真起进程、真杀进程)/ e2b 字段名齐全 / 裸数组 / 四布尔分开且不含ok/chip_sig=false时明说没验签 / 实例进程真被回收 / 未知实例 404 / 缺字段 400 / 重复Content-Length被拒(带期望特征:400 + 空体 + 关连接,说明请求没进业务层)/ chunked 被拒且说明原因 / 连续 20 次请求都拿到完整响应体(钉死「头与 body 分两次写、只读一次」那个偶发失败的回归探针)。回收判据用心跳文件(实例自己 touch 文件,停掉后 mtime 不再前进)——不依赖ps//proc,因为 macOS 无/proc、受限环境ps常被禁,那条判据恰恰是最重要的一条,不能靠"环境不支持就跳过"糊过去)crates/mpc-tee/src/link.rs(链路协议层,no_std + alloc:三档LinkPolicy;LinkCredential手写Debug脱敏私钥;CredentialProvider未配置即拒绝;aggregate_observations对全部 peer 取最严路径;link_admit三档 fail-closed;session_link_binding把credential_id绑到会话与user_data[0..32],私钥不参与哈希)crates/mpc-hostd/src/link.rs(链路进程层:EasyTierSpec::argv()三档参数 + 被禁 flag 自检(--network-secret/--relay-all-peer-rpc/--disable-encryption/-u);RPC portal 只绑回环;CliCredentialIssuer调credential generate|revoke;parse_peer_output认不出一律Unknown;LinkRuntime持Child句柄 +try_wait()收割)crates/mpc-cli/src/link.rs(mpc link plan|verdict|credential;凭据只走 0600 文件、不进命令行;--argv输出真实 argv 并警告,--argv-redacted输出合法 JSON 脱敏版;未知参数直接报错,不静默忽略)tools/selftest-link.py(进主门禁第 13 条;53 条判据,用 fake-easytier-cli / fake-easytier-core 两个桩跑完整链路;每条负向带期望特征;含「混合 peer 假绿」「进程真回收」两条回归探针)crates/mpc-chain/src/lib.rs(ChainConfig每字段必须显式、sm_crypto=false拒绝并说明 keccak256 未实现、client_tlcp声明 TLCP +require_transport()生产路径 fail-closed;digest_for_config是全框架唯一 hash 入口)crates/mpc-chain/src/objects.rs(ChainObject::canonical_bytes唯一实现:域分隔TEE_CHAIN_OBJECT+ 类型标签 + 4 字节大端长度前缀;四类对象摘要;Receipt四布尔分开、签名不进被签内容)crates/mpc-chain/src/rpc.rs(两组方法常量:国密链METHOD_SEND_TRANSACTION(4 参)与 web3 端点METHOD_SEND_RAW_TX;assert_submit_method_allowed()对国密链 +eth_sendRawTransaction拒绝;send_transaction_params()钉死[groupID,nodeName,data,requireProof];CRYPTO_SM2_VERIFY_ABI四入参;parse_response先判 error 再判 result、缺 result 拒、id 不匹配拒、result:null不算成功;.no_proxy())crates/mpc-chain/src/outbox.rs(kind:order_id:decision_id复合幂等键、重复不覆盖、fail-open、坏行整体拒绝、临时文件 + rename)crates/mpc-chain/src/admission.rs(fail-closed:缓存缺失 / 过期 / 硬规则失败 / 非成员一律拒;expires_at缺失不当永不过期)crates/mpc-chain/src/signer.rs(SignerSecurityProfile::{HardwareModule,SoftwareDev}+SignerPolicy(无 Default);require_self_test(s, policy)生产策略拒软件签名器;硬件模组ModuleSigner仍未实现)crates/mpc-chain/src/tlcp.rs(TlcpBackend::{None,Tongsuo,GmSSL}+TlcpReadiness::{LoopbackReachable,MissingEnvironment,Ready};Tongsuo与GmSSL两套套件名合并白名单;probe_tlcp_environment()真跑openssl/gmssl;TlcpEndpoint配置 +TlcpTunnel(spawngmssl 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_DEVA/B 跨设备解封失败的机制已串进tools/optee-cross-device.sh,但QEMU 未实跑)crates/mpc-tee/Cargo.toml(没有opteefeature;TA 走default-features = false,所以mpc-tee的 no_std 是 OP-TEE 的硬前置)tools/ci.sh(本文写作时 18 条,现为 25 条;以下条目编号按当时,新增第 21 条真交易编码判据、第 22 条真链合约判据,见文首状态提示与docs/INDEX.md;第 3 条 = mpc-core + mpc-tee no_std + TA UUID 对拍;第 4 条 = musl 跨目标零告警 + guest 产物三层探针;第 11 条 = OP-TEE 判据逻辑自测(零 SDK);第 12 / 13 / 14 条 = hostd / 链路层 / 链上层端到端自测;第 15 条 = 国密签名 / distid / TLCP 准入 / 治理形状;第 16 条 = GmSSL TLCP 真握手 + TA 密钥分级 + FISCO 真机对拍契约,其中两份--self-test与 TA 探针零外部依赖;第 17 条 = 阶段 3 OPA bundle 签发 / 真判定 / decision 存证,零依赖判据 18 + 真闭环 40;第 18 条 = TLCP 进程通道环回实证(TlcpTunnelspawngmssl 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 serveREST;控制面 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⇒ 国密链要 rawr||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全通,签名为 DERECDSA-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 接入先例)
opensslcrate 的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官方声明"从未被独立审计",密评不接受