#!/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())