Files
ssw-mpc/tools/fisco-realnode-probe.py
admin 0e968ed5ce feat(chain): GmSSL 真 TLCP 握手与 TA 密钥分级,主门禁扩到 16 条
- 纠正国密链提交方法为自有 sendTransaction(4 参),eth_sendRawTransaction 在国密链禁用
- 新增 GmSSL 3.2.0 环回真 TLCP 握手自测:双证书、国密套件、应用数据往返、负向期望拒绝特征
- 落地 build_optee.sh TA 签名密钥三级硬拒绝,缺 SDK 时判据仍可被执行到
- 新增 FISCO 真机对拍契约:缺环境显式 SKIPPED 并逐项列出,环境齐备只报 NEEDS_IMPL
- 同步 catalog 守卫 / 集成文档 / CLAUDE.md,主门禁 15 条改为 16 条
2026-11-07 18:23:46 +08:00

174 lines
7.3 KiB
Python
Executable File
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env python3
"""FISCO 国密链**真机对拍契约**(主门禁第 16 条)。
docs/INTEGRATION_ANALYSIS.md 第 7 节 9c 原本只是三行待办文字。这个脚本把
它变成可执行契约:**缺环境必须显式 SKIPPED 并逐项列出缺什么**,环境齐备
也必须报 NEEDS_IMPL(FISCO 自有交易编码 / TLCP 通道 / 真签名交易未落地),
**绝不打印「通过」**。静默跳过和通过长得一样,是这类通道最常见的失真。
★ 与 `selftest-tlcp-gmssl.py` 的分工:那边证明的是「本机环回 TLCP 握手
真的能跑」;这边守的是「客户端到 bcos-rpc + 合约验签 + 真交易」这套
真机链路还差什么。前者通过不能替代后者。
★ 9c 三处对拍(外加一笔真交易):
① 国密链交易走自有 `sendTransaction`(4 参),不是 web3 端点
`eth_sendRawTransaction`(后者固定 secp256k1 + keccak256 RLP);
② 客户端到 `bcos-rpc` 是否真要求国密 TLCP(本机环回不算);
③ `CryptoPrecompiled.sm2Verify(bytes32,bytes,bytes32,bytes32)` 四入参:
公钥编码 / message 是 32B 摘要 / distid 链上不可配只能实测;
④ `flush` 要发的是**已签名 FISCO 交易**而非链上对象规范字节。
用法:
python3 tools/fisco-realnode-probe.py --self-test # 判据逻辑(零依赖)
python3 tools/fisco-realnode-probe.py # 探测本机真机环境
"""
import os
import shutil
import subprocess
import sys
from pathlib import Path
REPO = Path(__file__).resolve().parent.parent
# 真机环境必备项。顺序即输出顺序,缺哪项就点名哪项。
REQUIRED = (
("rpc_endpoint", "MPC_CHAIN_RPC", "bcos-rpc 的 host:port 端点"),
("group_id", "MPC_CHAIN_GROUP", "sendTransaction 的 groupID"),
("node_name", "MPC_CHAIN_NODE", "sendTransaction 的 nodeName"),
("sm_crypto", "MPC_CHAIN_SM_CRYPTO", "国密链 sm_crypto=true 的真实链声明"),
("tlcp_backend", "MPC_TLCP_BACKEND", "TLCP 实现后端(gmssl / tongsuo)"),
("signer", "MPC_GM_SIGNER", "生产签名器(硬件模组 provider)"),
)
# 三处真机对拍 + 一笔真交易;这些是**实现缺口**,不是环境缺口。
IMPL_GAPS = (
"① sendTransaction 提交真国密交易:FISCO 自有交易编码(非以太坊 RLP)未落地",
"② 客户端到 bcos-rpc 的国密 TLCP:Rust 侧 FFI / 进程通道未接入,且未验证服务端启用 TLCP",
"③ CryptoPrecompiled.sm2Verify 四入参:公钥编码 / 32B 摘要 / 链上 distid 未做真机对拍",
"④ flush 仍发链上对象规范字节,不是已签名交易",
)
PASS_N = 0
FAIL_N = 0
def check(name, cond, extra=None):
global PASS_N, FAIL_N
if cond:
PASS_N += 1
print(f" ok {name}")
else:
FAIL_N += 1
print(f"FAIL {name}")
if extra is not None:
print(f" -> {str(extra)[:500]}")
def evaluate(env):
"""判据唯一真相源。返回 (decision, missing)。
decision 只有 "SKIPPED" / "NEEDS_IMPL" 两种,**永不返回 "PASS"**:
真机对拍的结果只能由将来实现的 `tx.rs` + 真链实跑给出。
"""
missing = []
for key, var, desc in REQUIRED:
if not env.get(key):
missing.append(f"{var}({desc})")
if missing:
return "SKIPPED", missing
return "NEEDS_IMPL", []
def probe_env():
return {
"rpc_endpoint": os.environ.get("MPC_CHAIN_RPC", "").strip(),
"group_id": os.environ.get("MPC_CHAIN_GROUP", "").strip(),
"node_name": os.environ.get("MPC_CHAIN_NODE", "").strip(),
"sm_crypto": os.environ.get("MPC_CHAIN_SM_CRYPTO", "").strip().lower() == "true",
"tlcp_backend": os.environ.get("MPC_TLCP_BACKEND", "").strip(),
"signer": os.environ.get("MPC_GM_SIGNER", "").strip(),
}
def self_test():
empty = {k: "" for k, _, _ in REQUIRED}
d, m = evaluate(empty)
check("判据逻辑:全缺环境 → SKIPPED", d == "SKIPPED", d)
check("判据逻辑:逐项列出 6 项缺失", len(m) == 6, m)
check("判据逻辑:缺失里点名 MPC_CHAIN_RPC 与 MPC_TLCP_BACKEND",
any("MPC_CHAIN_RPC" in x for x in m)
and any("MPC_TLCP_BACKEND" in x for x in m), m)
partial = dict(empty, rpc_endpoint="127.0.0.1:8545",
group_id="group0", node_name="node0", sm_crypto=True,
tlcp_backend="gmssl")
d2, m2 = evaluate(partial)
check("判据逻辑:缺生产签名器仍 SKIPPED 且只点名这一项",
d2 == "SKIPPED" and len(m2) == 1 and "MPC_GM_SIGNER" in m2[0], (d2, m2))
full = dict(partial, signer="hardware-module")
d3, m3 = evaluate(full)
check("★ 判据逻辑:环境全齐也只到 NEEDS_IMPL,绝不静默 PASS",
d3 == "NEEDS_IMPL" and not m3, (d3, m3))
check("判据逻辑:evaluate 永不返回 PASS",
"PASS" not in (d, d2, d3), (d, d2, d3))
# 漂移探针:把「sm_crypto=false」当成齐备必须仍被拒。
bad = dict(full, sm_crypto=False)
d4, m4 = evaluate(bad)
check("漂移探针:sm_crypto=false 不算国密链,退回 SKIPPED",
d4 == "SKIPPED" and any("MPC_CHAIN_SM_CRYPTO" in x for x in m4), (d4, m4))
src = Path(__file__).read_text()
check("契约脚本仍含 FISCO_REALNODE_SKIPPED 输出(防静默跳过回归)",
"FISCO_REALNODE_SKIPPED" in src)
check("契约脚本仍含 FISCO_REALNODE_NEEDS_IMPL 输出",
"FISCO_REALNODE_NEEDS_IMPL" in src)
check("契约脚本列全 9c 四处缺口", len(IMPL_GAPS) == 4
and all(s in src for s in IMPL_GAPS), IMPL_GAPS)
# 与 rpc.rs 的事实对拍:国密链方法名不许回退到 eth_sendRawTransaction。
rpc = (REPO / "crates/mpc-chain/src/rpc.rs").read_text()
check("★ rpc.rs 仍把 sendTransaction 定为国密链提交方法",
'METHOD_SEND_TRANSACTION: &str = "sendTransaction"' in rpc)
check("★ rpc.rs 仍有国密链禁用 web3 端点的守卫",
"assert_submit_method_allowed" in rpc and "secp256k1" in rpc)
print(f"\n判据 {PASS_N + FAIL_N} 条:通过 {PASS_N},失败 {FAIL_N}")
if FAIL_N:
print("存在失败判据")
return 1
print("判据逻辑全部通过(本模式不依赖真机环境)")
return 0
def run_probe():
env = probe_env()
decision, missing = evaluate(env)
if decision == "SKIPPED":
print(f"FISCO_REALNODE_SKIPPED: 缺 {len(missing)} 项真机环境,本通道未执行")
for m in missing:
print(f" - {m}")
print(" (--self-test 的零依赖契约判据仍在主门禁里跑,不因跳过变成盲区)")
# GmSSL 本机能力如实附带一句,但不能顶替真机环境。
hint = "可用" if shutil.which("gmssl") else "未安装"
print(f" 附注:本机 GmSSL {hint};环回 TLCP 握手通过 ≠ bcos-rpc 已启用 TLCP")
return 0
print("FISCO_REALNODE_NEEDS_IMPL: 真机环境齐备,但以下实现缺口未补,"
"拒绝宣称能上链")
for gap in IMPL_GAPS:
print(f" - {gap}")
print(" (缺的是实现,不是环境;把环境变量凑齐不等于能发真交易)")
return 0
def main():
if "--self-test" in sys.argv:
return self_test()
return run_probe()
if __name__ == "__main__":
sys.exit(main())