- 纠正国密链提交方法为自有 sendTransaction(4 参),eth_sendRawTransaction 在国密链禁用 - 新增 GmSSL 3.2.0 环回真 TLCP 握手自测:双证书、国密套件、应用数据往返、负向期望拒绝特征 - 落地 build_optee.sh TA 签名密钥三级硬拒绝,缺 SDK 时判据仍可被执行到 - 新增 FISCO 真机对拍契约:缺环境显式 SKIPPED 并逐项列出,环境齐备只报 NEEDS_IMPL - 同步 catalog 守卫 / 集成文档 / CLAUDE.md,主门禁 15 条改为 16 条
174 lines
7.3 KiB
Python
Executable File
174 lines
7.3 KiB
Python
Executable File
#!/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())
|