Files
ssw-mpc/docs/INTEGRATION_ANALYSIS.md
T
admin b15f0268bf feat(chain): 阶段 2 链上层形状层,新增主门禁第 14 条
- 新增 crates/mpc-chain:链上对象规范编码、SM3 摘要、FISCO BCOS 3.x eth_* JSON-RPC 客户端、幂等 outbox、成员准入、Signer 形状层
- 新增 mpc chain digest|submit|flush|status|admit 命令族
- 新增 tools/selftest-chain.py 桩自测(44 判据),主门禁 13 → 14 条
- 同步 catalog 守卫、domain 域分隔、CLAUDE.md、INTEGRATION_ANALYSIS.md

边界:ModuleSigner / RLP / 国密模组 provider 未落地;flush 发的是规范字节而非已签名交易,未配置签名器即拒绝,本期不宣称能上链。
2026-11-07 16:48:08 +08:00

77 KiB
Raw Blame History

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

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

0. 决策台账

# 决策 取值 直接后果
1 飞梭链部署形态 Pro 版 bcos-rpc / bcos-gateway / bcos-node 三件套;TARS 可选;RPC 可横向扩展,站点端只连 RPC
2 密码套件 必须国密 SM2 签名 + SM3 哈希 + SM4 落盘 + 节点间国密 SSL;建链时定,之后不可改
3 策略执行位置 硬规则 成员白名单、TCB 门槛、算力上限、算法准入写成 Solidity 合约,链上共识执行
4 链路中继策略 两者兼容,参数控制 open / allowlist / p2p-only 三档,由 mpc link plan --policy 落参数(不经过 e2b 兼容面,见 3.3 / 6)
5 策略来源与签发 都可写,控制面签发 联盟全局表与机构自持并存;签发私钥唯一在站点端控制面
6 WASM 合约 不开 WITH_WASM 保持 OFF;Rego→WASM 上链(原 3c)整条删除
— 控制面层数 两层 站点端 + 宿主机端(e2b),宿主机向站点端提供 e2b 接口
— TEE 平台矩阵 海光 CSV / AMD SNP / ARM OP-TEE 国密只在海光跑;AMD 走非国密;OP-TEE 是轻形态(见 1.6)
— 国密实现路径 硬件模组 + OpenSSL provider 只走 provider,不走 engine/SDF/PKCS#11;Rust 不实现 SM2(见 4.3④)
— OP-TEE 定位 单独编译 / 单独验证 编译与设备验证走独立通道;零 SDK 能判的(no_std、UUID 对拍)仍进主门禁;缺环境必须显式报 skip(见 1.7)
— 宿主 HTTP 栈 axum + tokio + reqwest 协议层交给成熟组件;依赖只落在独立 mpc-hostd crate,mpc-tee 保持零 crates.io 依赖(要被拷进 OP-TEE SDK 离线交叉编译,见 6)
— 会话凭据来源 管理节点签发,框架不生成 easytier-cli credential generate --ttl 返回 credential_id + credential_secret;框架只承载 / 传递 / 绑定 / 回收,CredentialProvider 未配置即拒绝(见 3.3)

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

1.1 为什么必须两层

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

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

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

1.2 职责矩阵

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

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

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

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

照搬的是这个结构:

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

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

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

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

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

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

1.4 准入必须拆成两段

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

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

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

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

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

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

1.5 两层的信任建立

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

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

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

1.6 三平台不是同一套形态

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

2.3 落点:HostAgent 内嵌 TeeRuntime

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

修正后的落点:

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

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

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

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

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

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

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

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

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

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

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


3. 方向二:EasyTier

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

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

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

3.2 LGPL 边界本来就划得开

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

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

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

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

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

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

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

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

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

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

★ 两个方向别混:

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

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

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

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

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

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

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

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

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

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

3.5 不要把 EasyTier 塞进 TCB

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

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

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

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


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

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

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

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

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

4.2 Pro 版的实际形态

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

两个事实决定落地方式:

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

建链(含国密):

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

4.3 国密的五个硬约束

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

代价与边界:

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

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

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

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

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

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

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

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

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

所以分平台:

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

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

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

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

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

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

4.5 链上对象

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

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

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

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

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

决策 5 落地为三段式:

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

规则:

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

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

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

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

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

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

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

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

  • 新建 crates/mpc-chain(std only):本期落形状层(对象规范编码 + SM3 摘要 + JSON-RPC 最小面 + 幂等 outbox + fail-closed 准入);RLP / SM2 交易签名待模组
  • 不进 mpc-core(零依赖、no_std),不进 mpc-tee(TA 侧要 no_std)
  • 链交互在宿主,不在 guest:SM2 是全新 crypto 依赖,塞进 TEE 会同时扩大 TCB 和破坏"零依赖"叙事。guest 只产出证明、decision 与结果 hash

[修正] 初稿写「3.x 接入面是自有 JSON-RPC(sendTransaction / call / getTransactionReceipt),不是 eth_ 兼容」—— 用 gitea 镜像核对 FISCO-BCOS/FISCO-BCOS 源码后,这是 2.x 的老结论:

  • (以下为上游 FISCO-BCOS 仓库路径)bcos-rpc/bcos-rpc/web3jsonrpc/endpoints/EthMethods.h 的 EthMethod 枚举明确列出 eth_sendRawTransaction、eth_call、eth_getTransactionReceipt、eth_blockNumber 等;EndpointsMapping.cpp 按 methodString(EthMethod::...) 注册 handler。
  • sendTransaction 全仓搜不到。Rust 侧仍没有官方 SDK,所以只做最小面:发交易、查回执、call 三个方法。
  • 本期 mpc_chain::rpc 的三个方法常量按 eth_* 写,并同时钉在单测与桩自测里(防止有人照旧文档改回去)。

★ 方法名兼容 ≠ 交易结构兼容:sm_crypto=true 时交易是 SM2 签名 + FISCO 自有 RLP,web3 端点是否接受国密交易尚未实测(写进第 7 节)。方法名只解决「怎么调」,没解决「发什么」。

本期形状层的诚实边界:mpc chain flush 发出去的 payload 是链上对象的规范字节,不是已签名交易。它验证的是幂等 / 补链 / fail-open 与 fail-closed 分离 / JSON-RPC 判定这些框架自己的契约,不宣称能上链。模组到位后要让 ModuleSigner + RLP 编码接进 flush,并补一笔真机交易对拍。

★ 三条配置纪律(把待拍板项做成显式拒绝,而不是隐式假设): ① sm_crypto 必须显式给、false 直接拒(标准版链上用 keccak256Hash,链下没有 keccak256 实现,放行等于「摘要永远对不上」的假绿); ② client_tlcp=true 直接拒(Rust 侧 TLCP 未实现);③ 未配置 Signer 即拒绝,ModuleSigner 只留 trait 与启动自检三件的形状 —— 不写软件签名器充数(sm2 crate 未经独立审计,进生产等于把「密评可过」悄悄作废)。

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

仍待确认的阻塞项:国密 SSL 双证书用在节点间与 Gateway 之间,客户端到 bcos-rpc 这一跳是否也要求国密 TLS,官方文档没有明确说法,必须实测(配置里 client_tlcp 必须显式给,true 本期直接拒)。如果要求,Rust 侧会被卡住——rustls 不支持 TLCP(GB/T 38636),只能引 Tongsuo/BabaSSL 做旁路(多一个运行时 + FFI 边界)。这条要在建链前问清楚,不能等联调。

4.9 不要重复 WeDPR

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

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


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

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

四个约束:

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

6. 实施顺序

阶段 内容 新增依赖 风险 前置
0a 拆两层:mpc-hostd(e2b 兼容)+ TeeRuntime + /attestation + 站点侧 session_admit 中(axum + tokio + reqwest,只在独立 mpc-hostd crate) 中(协议设计、token 信任链) —
0b OP-TEE 独立通道:tools/ci-optee.sh + 五条验证规则 + ta_admit 零(复用 build/build_optee.sh) 低(不碰主链路) —
1 链路:EasyTier 进程化 + 三档 --link-policy + credential + link 上报 零(外部二进制) 中(LGPL 合规、TUN 权限、relay 可见性) 0a
2 mpc-chain:形状层已完成(对象规范编码 + JSON-RPC + 幂等 outbox + 准入);真链建链 / SM2 签名 / RLP 仍待模组 中(serde_json + reqwest,仅 mpc-chain;FFI 未落地) 高(国密不可逆、模组 distid、CSV 验签待实测) 0a
3 策略:OPA 进 guest + 控制面签发 bundle + decision 上链 中(OPA 二进制 + bundle 分发) 高(bundle 灰度与撤销、TCB 边界) 2
4 Rego→WASM 上链 — — 删除(决策 6)

阶段状态(2026-11-07):0a 已完成(第 12 条)、1 已完成(第 13 条)、2 形状层已完成(第 14 条);0b 的编排与判据已实现、QEMU 实跑待有 SDK 的机器;3 未开工。阶段 2 的「形状层」不含真实交易签名 —— SM2 / RLP / 国密模组 provider 未落地,见 4.8。

为什么 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,零 FFI), 模块:objects(ChainObject::canonical_bytes 唯一实现,域分隔 TEE_CHAIN_OBJECT + 类型标签 + 4 字节大端长度前缀, Receipt 四布尔分开、签名不进被签内容)、rpc(3.x eth_* 方法、HTTP 200 + error 判失败、result:null 不算成功、 .no_proxy())、outbox(复合幂等键、fail-open、坏行拒绝、临时文件 + rename 落盘)、admission(fail-closed、 expires_at 过期即拒)、signer(trait 形状 + 自检三件,未实现)。 CLI mpc chain digest|submit|flush|status|admit;tools/selftest-chain.py 44 条判据进主门禁第 14 条, 用 Python 假 bcos-rpc 跑完整链路(本机无 FISCO 节点与国密模组)。

★ 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. 剩余待定与待验证

必须先定(阻塞开工)

  1. sm_crypto=true 确认 + 建链参数冻结。不可逆。
  2. 模组必须给 OpenSSL provider,且锁 Tongsuo ≥ 8.4(建议 8.5)。这是采购规格书里的硬性条件,三条一起写:provider 形态、私钥不可导出、distid 可设。engine 形态不接受——它意味着退回 1.1.1 基线,provider 那套"独立 libctx + 无 fallback"的可证性也就没有了。模组采购与驱动适配有周期,要在阶段 2 之前启动,不能等代码写完再找硬件。
  3. bcos-rpc 是否需要国密 TLS 通道。需要 → Rust 侧要引 Tongsuo 并实现 TLCP,现有 crate 生态没有现成实现(见 4.8)。
  4. OP-TEE 已定进本轮,待定的是覆盖范围:QEMU 跑通即验收,还是必须有一块真板(board feature 从 SLCR 读 DNA)?前者能进 CI 自动化,后者才有真实的设备绑定证据。建议:CI 覆盖 QEMU 那五条,真板作为上线前的一次性验收——两者证明的东西不同,不能互相替代。
  5. SM2 的 distid 三重对齐。FISCO 侧未显式设置(用库默认)、OpenSSL 侧默认 1234567812345678、模组内部可能硬编码。对不上则 4.4 的链上验签与 4.3③ 的交易验签同时不成立,且报错只有 false。
  6. TA 签名密钥怎么管。build_optee.sh 的 SIGN_KEY 留空就用开发密钥 default_ta.pem,这在小场景里会被一路带进生产。要么建一套签名密钥的分级(dev / staging / prod),要么明确写"OP-TEE 场景由设备厂商签名,我们不持密钥"——中间状态最危险。

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

  1. 模组能否直接输出裸 r||s。DER 拆包本身是确定的(4.3④),所以这条不阻塞;但如果模组能直接出裸值,就少一段容易写错长度的 ASN.1 解析。
  2. CSV 报告的公钥编码与签名对象(原文 or SM3 摘要),决定 sm2Verify 的三个入参怎么填。
  3. EasyTier 三档在目标网络的实际表现。p2p-only 在 NAT4-NAT4 场景会直接失败,要确认业务能接受。 9b. EasyTier 真机必须补的三处对拍(本期用桩,不能拿"本机没装"当通过): easytier-cli credential generate 的输出排版(parse_credential_output 现按 key: value 解析, 解析不出即拒、不假装成功);easytier-cli peer 的 cost 列实际取值 (parse_peer_cost 认不出一律 Unknown → 拒绝);中继网络名的观测源 —— peer 只给 p2p/relay,不报经的是哪个中继网,所以 allowlist 档目前靠 --relay-network 的宿主配置声明核对,真机要补 RPC / route 观测后才能算 「实际路径已核对」。p2p-only 档不受影响(见 relay 即拒)。 9c. FISCO 真机必须补的三处对拍(本期用桩 + 形状层,别拿"本机没链"当通过): ① sm_crypto=true 的国密交易是否走 web3 端点(eth_sendRawTransaction)—— 方法名兼容 不等于 RLP / SM2 签名结构兼容;② 客户端到 bcos-rpc 是否要求国密 TLCP; ③ CryptoPrecompiled.sm2Verify 的三个入参(CSV 公钥编码 / message 是 hash 还是原文 / distid),见 4.4。另外:模组到位后要让 flush 发出去的是已签名交易 而非规范字节,并补一笔真机交易对拍。
  4. OP-TEE 在 TA 共享语义下的租户隔离。TA 是设备级单例,多机构共存时密钥域怎么分——optee/core.rs 的 seal 格式是否已带租户维度,要核对。这条现在是生效的(OP-TEE 已进本轮,见 1.7)。

已有建议,等你拍

  1. Pro 版是否上 TARS。建议先不上(4.2),把 TARS 留给运维团队自建;ssw-mpc 只依赖 bcos-rpc 的 HTTP 端点。
  2. OPA 是否真需要。决策 3 选了"硬规则",决策 5 又说"策略都可以写"。我的解读是:硬规则进合约,业务合规策略仍走 OPA,签发收口到控制面。如果本意是"只要合约、不要 OPA",阶段 3 可以整体删掉,届时 Receipt 里只留合约判定结果。

附:事实来源

本项目

  • 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=true 拒绝;digest_for_config 是全框架唯一 hash 入口)
  • crates/mpc-chain/src/objects.rs(ChainObject::canonical_bytes 唯一实现:域分隔 TEE_CHAIN_OBJECT + 类型标签 + 4 字节大端长度前缀;四类对象摘要;Receipt 四布尔分开、签名不进被签内容)
  • crates/mpc-chain/src/rpc.rs(3.x eth_* 方法常量;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(Signer trait 形状 + 启动自检三件;ModuleSigner 未实现,未配置即拒绝,不假装可用)
  • crates/mpc-cli/src/chain.rs(mpc chain digest|submit|flush|status|admit;flush 输出明确标注 payload 不是已签名交易)
  • tools/selftest-chain.py(进主门禁第 14 条;44 条判据,Python 假 bcos-rpc;每条负向带期望特征;含 .no_proxy() 回归探针)
  • crates/mpc-core/src/domain.rs(TEE_LINK_BIND / TEE_CHAIN_OBJECT 域分隔常量;改一个字节 = 已登记摘要全部对不上)
  • crates/mpc-tee/src/session.rs:75(user_data 两段 sha256 拆分)
  • crates/mpc-tee/src/verify.rs:89(CSV_REPORT_LEN = 2548,真机实测;注释明确 4096 是 hypercall 页不是报告长度)
  • crates/mpc-tee/src/platform.rs(PlatformProfile::builtin() 对 Optee / Tdx 返回 None,有断言钉死;本轮已把该文件开头误写的"CSV 4096 字节"改为 2548)
  • crates/mpc-tee/src/optee/{mod,core,proto}.rs(CA↔TA 三层范式、seal 格式、命令协议;ta/、ca/ 需 OP-TEE SDK 交叉编译,build/build_optee.sh 驱动)
  • build/build_optee.sh(需要 OPTEE_OS + SDK_DIR + arm-linux-gnueabihf-;UUID 硬编码 a1b2c3d4-…;SIGN_KEY 留空即用开发密钥 default_ta.pem;MPC_SIM_DEV A/B 跨设备解封失败的机制已串进 tools/optee-cross-device.sh,但QEMU 未实跑)
  • crates/mpc-tee/Cargo.toml(没有 optee feature;TA 走 default-features = false,所以 mpc-tee 的 no_std 是 OP-TEE 的硬前置)
  • tools/ci.sh(十四条;第 3 条已从"mpc-core no_std"扩展为"mpc-core + mpc-tee no_std + TA UUID 对拍";第 4 条有"跳过:目标未安装"的既有语义,ci-optee.sh 的 skip 输出照此设计;第 11 条 = OP-TEE 判据逻辑自测,零 SDK 依赖;第 12 条 = 宿主控制面端到端自测;第 13 条 = 会话级链路层端到端自测;第 14 条 = 链上层端到端自测,见下)
  • 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 镜像 FISCO-BCOS/FISCO-BCOS 源码核对(2026-11-07):下列路径均为上游仓库相对路径,不是 ssw-mpc 本仓库文件。bcos-rpc/bcos-rpc/web3jsonrpc/endpoints/EthMethods.h 的 EthMethod 枚举含 eth_sendRawTransaction / eth_call / eth_getTransactionReceipt;EndpointsMapping.cpp 按枚举注册;sendTransaction 全仓搜不到。FISCO-BCOS/tools/BcosBuilder/pro/conf/config-build-example.toml 有 sm_crypto=false(注释 "use sm-crypto or not");bcos-tool/bcos-tool/NodeConfig.cpp:664 从 chain.sm_crypto 读创世配置。bcos-executor/src/precompiled/CryptoPrecompiled.cpp 确认 sm3(bytes) / keccak256Hash(bytes) / sm2Verify(bytes32,bytes,bytes32,bytes32) 三个选择器。
  • 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 官方声明"从未被独立审计",密评不接受