- 新增 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 发的是规范字节而非已签名交易,未配置签名器即拒绝,本期不宣称能上链。
77 KiB
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 为什么必须两层
单层控制面在三个地方会崩,且都是必然发生:
- 证明采不到。芯片报告只能由宿主机读(
/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
[修正] 初稿写「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 + 策略引擎
四个约束:
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:形状层已完成(对象规范编码 + JSON-RPC + 幂等 outbox + 准入);真链建链 / SM2 签名 / RLP 仍待模组 |
中(serde_json + reqwest,仅 mpc-chain;FFI 未落地) |
高(国密不可逆、模组 distid、CSV 验签待实测) | 0a |
| 3 | 策略:OPA 进 guest + 控制面签发 bundle + decision 上链 | 中(OPA 二进制 + bundle 分发) | 高(bundle 灰度与撤销、TCB 边界) | 2 |
| — | — | 删除(决策 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)
这一项来回过两次,如实记下来,免得后来人按旧的段落改代码:
- 初稿写「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,零 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. 剩余待定与待验证
必须先定(阻塞开工)
sm_crypto=true确认 + 建链参数冻结。不可逆。- 模组必须给 OpenSSL provider,且锁 Tongsuo ≥ 8.4(建议 8.5)。这是采购规格书里的硬性条件,三条一起写:provider 形态、私钥不可导出、distid 可设。engine 形态不接受——它意味着退回 1.1.1 基线,provider 那套"独立 libctx + 无 fallback"的可证性也就没有了。模组采购与驱动适配有周期,要在阶段 2 之前启动,不能等代码写完再找硬件。
bcos-rpc是否需要国密 TLS 通道。需要 → Rust 侧要引 Tongsuo 并实现 TLCP,现有 crate 生态没有现成实现(见 4.8)。- OP-TEE 已定进本轮,待定的是覆盖范围:QEMU 跑通即验收,还是必须有一块真板(
boardfeature 从 SLCR 读 DNA)?前者能进 CI 自动化,后者才有真实的设备绑定证据。建议:CI 覆盖 QEMU 那五条,真板作为上线前的一次性验收——两者证明的东西不同,不能互相替代。 - SM2 的 distid 三重对齐。FISCO 侧未显式设置(用库默认)、OpenSSL 侧默认
1234567812345678、模组内部可能硬编码。对不上则 4.4 的链上验签与 4.3③ 的交易验签同时不成立,且报错只有false。 - TA 签名密钥怎么管。
build_optee.sh的SIGN_KEY留空就用开发密钥default_ta.pem,这在小场景里会被一路带进生产。要么建一套签名密钥的分级(dev / staging / prod),要么明确写"OP-TEE 场景由设备厂商签名,我们不持密钥"——中间状态最危险。
待实测(不阻塞开工,但阻塞上生产)
- 模组能否直接输出裸
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 真机必须补的三处对拍(本期用桩 + 形状层,别拿"本机没链"当通过): ①sm_crypto=true的国密交易是否走 web3 端点(eth_sendRawTransaction)—— 方法名兼容 不等于 RLP / SM2 签名结构兼容;② 客户端到bcos-rpc是否要求国密 TLCP; ③CryptoPrecompiled.sm2Verify的三个入参(CSV 公钥编码 / message 是 hash 还是原文 / distid),见 4.4。另外:模组到位后要让flush发出去的是已签名交易 而非规范字节,并补一笔真机交易对拍。 - OP-TEE 在 TA 共享语义下的租户隔离。TA 是设备级单例,多机构共存时密钥域怎么分——
optee/core.rs的 seal 格式是否已带租户维度,要核对。这条现在是生效的(OP-TEE 已进本轮,见 1.7)。
已有建议,等你拍
- Pro 版是否上 TARS。建议先不上(4.2),把 TARS 留给运维团队自建;ssw-mpc 只依赖
bcos-rpc的 HTTP 端点。 - 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.xeth_*方法常量;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(Signertrait 形状 + 启动自检三件;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_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(十四条;第 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 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 镜像
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 接入先例)
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官方声明"从未被独立审计",密评不接受