Files
admin bd9bea0142 fix(cluster): 修掉真机自报脚本 3 个必挂缺陷,判据门禁收编为第 25 条
集群自报联调脚本的 3 个真机必挂缺陷:
- xop 把自己的 WARN 打在 stdout(不是 stderr)。`remote()` 原先 `2>&1`
  合并返回,导致 `wc -c` / `sha256sum` / curl HTTP 码全被污染;
  改用 fd3 分流:远端输出进临时文件,xop stdout 丢弃,返回值只剩真实输出。
  `xop_probe` 改为只认纯数字行,拿不到数字即失败(fail-closed)。
- `printf '--- 负向矩阵…'` 格式串前导破折号被 bash 当成选项,改用 `%s`。
- `remote()` 里 `< /dev/null` 被后面的 here-string 覆盖,是无效防护;
  同时删掉从未被调用的 `remote_amd()`(把脚本正文塞进 ssh argv 的活样本)。

判据门禁(第 25 条)收编:
- `selftest-cluster-selfreport.py` 重写为 9 组判据 10 项检查,
  探针先自证 fired(避免「argv 日志为空 ⇒ 没密钥」恒真),
  用假 xop + 假 sshpass,不依赖真机与保险库是否解锁。
- 判据 4 只扫密钥流经语句并豁免本地熵源;新增判据 9 守 fd3 隔离。
- `selftest-cluster-selfreport-break.py` 覆盖全部 9 组判据共 11 条破坏实验,
  每条变异双向确认证据串,顺序事实型单独一条路径。

文档:主门禁条数 24 → 25 全仓同步;诚实边界改为「真机两节点自报已实证,
选址/下发/证明门控/端点交付仍只在假 hostd 上验过;修完的脚本只过离线
判据门禁,尚未在真机复跑」。

验证:bash -n、shell 卫生 lint(39 脚本)、真 xop+假远端 fd3 分流实测、
自测 10/10、破坏实验 11/11、tools/ci.sh 全量 25 条 CI_EXIT=0。
2026-11-09 18:01:13 +08:00

126 lines
6.7 KiB
Markdown
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.
# 国密链真链合约:复现与证据索引
> 本目录是 **FISCO BCOS 国密链「真链」智能合约** 工作的落地与索引。
> 目标:把「区块链智能合约真的跑通」这件事所需的关键脚本、证据、复现说明
> 全部留在仓库里,避免散落在 `/tmp` 之后找不着。
>
> 一句话结论:**部署 → 真调用写接口 → 只读读回 → 负向矩阵** 已在真链
> 全绿(合约地址 `0x82a3c328…`,`isRecorded=0x…01`,摘要原样读回,
> 零摘要被 `require` 拒、`10008 InvalidSignature` 已根除)。
---
## 1. 哪些是「规范入口」(要跑就跑这些)
| 文件 | 作用 | 说明 |
|---|---|---|
| `tools/selftest-fisco-contract.py` | **真链判据主脚本**(主门禁第 22 条) | 连真链跑完整流程:部署→写→读→负向矩阵。**这是唯一权威验收脚本**。 |
| `tools/sm2_verify.py` | SM2 签名口径自检 | 交叉验证 `ZA‖digest` 口径,附 ZA 值锚点。 |
| `tools/ci.sh` | 门禁(25 条) | 第 22 条即本真链判据;全绿才放行。 |
| `contracts/MpcHardRule.sol` | 合约源码 | `recordHardRule(summary)` 写接口 + `isRecorded`/`hardRuleSummary` 读接口,`require(summary!=0)`。 |
| `build/contracts/combined.json` | solc 产物 | 含 `abi` 与 `bin`(部署字节码),selftest 的 `MPC_FISCO_ABI` 指向这里。 |
| `docs/FISCO_UPSTREAM_TRUTH.md` | **上游事实真相** | 签名口径(`fast_sm2_verify` → `e=SM3(ZA‖dataHash)`)、TARS 编码、端点、selector 二元数组等,全部以真链实测为准。 |
> 不要去跑 `tools/selftest-chain.py` / `selftest-chain-gm.py` / `selftest-chain-tx.py` /
> `selftest-chain-opa.py` 当作「真链验收」——那些是**框架契约**或**其它子系统**的判据,
> 不证明真链能上链。真链验收只看 `selftest-fisco-contract.py`。
---
## 2. 复现所需环境变量
`selftest-fisco-contract.py` 必须的三个变量(缺一会显式 `SKIPPED` 并点名缺哪个):
| 变量 | 含义 |
|---|---|
| `MPC_FISCO_CHAIN_CONFIG` | 链配置文件路径(见本目录 `example.chain.json`) |
| `MPC_FISCO_KEY` | SM2 **私钥** PEM 路径(**密钥,绝不入库**,见 §5) |
| `MPC_FISCO_ABI` | solc ABI JSON 路径(用 `build/contracts/combined.json`) |
| `MPC_FISCO_NODE` | 可选,默认 `node0` |
跑法:
```bash
# 零依赖判据逻辑自测(不需要真链)
python3 tools/selftest-fisco-contract.py --self-test
# 连真链跑完整验收
MPC_FISCO_CHAIN_CONFIG=tools/fisco-realnode/example.chain.json \
MPC_FISCO_KEY=/path/to/key.pem \
MPC_FISCO_ABI=build/contracts/combined.json \
python3 tools/selftest-fisco-contract.py
```
`example.chain.json` 字段:`rpc_endpoint`(k8s NodePort `192.168.1.26:30100`)、
`group_id`、`chain_id`、`sm_crypto=true`、`client_tlcp=false`。
> **2026-11-08 起链已迁入 k8s**:原 `fisco-gm` 本机容器已停,账本(含历史区块)
> 迁到 `nfs-wuguirong` PVC。集群内用 `fisco-chain.wuguirong.svc.cluster.local:20200`,
> 集群外用 `192.168.1.26|27|29:30100`。完整迁移与回滚说明见
> `deploy/k8s/fisco/README.md`。
---
## 3. 真链环境怎么来(不在仓库,按需下载)
这些二进制**体积大且可重新下载,已用 `.gitignore` 排除**,不要入库:
- **节点二进制** `fisco-bcos`:FISCO BCOS v3 官方发布(国密链 `sm_crypto=true`,
RPC/通道端口 **20200** / P2P 端口 **30300**,`chain0`/`group0`;k8s 里
对应 NodePort `30100` / `30101`)。
- **Java SDK** `fisco-bcos-java-sdk`(Maven Central 可达,含 `sdk.jar`)。
- **solcJ** `solcJ-mac-1.0.0.jar`:FISCO 提供的 Solidity 编译器封装。
- **TASSL / TLCP** 国密 TLS 工具链(如需 `client_tlcp=true` 再准备)。
> 本机历史上真链跑在 `/tmp/fisco-linux-node` + 容器 `fisco-gm` 上(已 stop,保留可回滚)。
> **现在链在 k8s**:部署 / 账本迁移 / 回滚一律按 `deploy/k8s/fisco/README.md`;
> 不要 `docker start fisco-gm` 与 k8s 链同时对外服务,否则同一账本两份拷贝会分叉。
> 仅在需要一条**全新本地调试链**时,才按 FISCO 官方 `build_chain.sh` 起
> `sm_crypto=true` 的链(那是另一条链,不含现有历史区块)。
---
## 4. 审计轨迹 / 证据(本目录的 `fj-sdk/` `jni/` `tars/`)
这些是 **2026-11-08 真链实证期间** 用来挖根因、做独立交叉验证的脚本,
作为**审计轨迹**保留,便于将来回看「为什么这么签」。它们不是要日常跑的入口。
- `fj-sdk/*.py`:基于 FISCO Java SDK 的 Python 封装与发送器
(`sender*.py` 真发过部署/调用交易,`tree*.py` 录制回包树,
`readabi.py`/`readtx.py` 读 ABI 与回执,`req.py` 发 JSON-RPC)。
- `jni/*.java`:**独立地面真相探针**——用官方 JNI(`OffReal.java` /
`OfficialTx.java`)按官方流程签名并组交易,与本项目 `mpc-chain` 的
签名结果逐一比对,由此锁定 `10008 InvalidSignature` 根因
(节点 `fast_sm2_verify` 验的是 `e=SM3(ZA‖dataHash)`,旧代码签裸摘要)。
`Probe*.java` / `DiffProbe.java` 做逐字节 diff。
- `tars/*.py`:TARS 二进制编解码辅助(`analyze_tars.py` / `decode_tars.py` /
`gh_decode.py`),用来核对交易编码与 `TransactionData` 哈希口径。
> 这些脚本依赖上面 §3 的 jar/二进制,且多为实证期的迭代稿;
> **重跑验证请用 §1 的 `selftest-fisco-contract.py`**,本目录脚本仅作证据留档。
---
## 5. 密钥与秘密(重点)
- **真实链私钥(`*.pem`)绝对不入库**——一旦进 git 历史就无法撤回,且泄漏即失陷。
本目录 `.gitignore` 已屏蔽 `*.pem`/`*.key`。
- `example.chain.json` 只含 `rpc_endpoint`/`group_id`/`chain_id`/`sm_crypto`,
**不含任何密钥**,可安全入库。
- 真实私钥请放在仓库外(如 `/tmp/mpc-chain-real/key.pem` 或密钥管理器),
通过 `MPC_FISCO_KEY` 环境变量注入。
---
## 6. 诚实边界(仍未做的,不要误以为已做)
- **软件 OpenSSL 签名器私钥可导出 ⇒ 密评不可过**:生产须换硬件加密模组
(`SignerPolicy::ProductionModule` 必拒软件签名器)。真链验证用的是软件签名器,
仅证明「口径正确、能上链」,不代表满足密评。
- **TLCP 接真 `bcos-rpc` 通道未通**:此前只在环回 echo 上验过框架契约,
不等于真链 TLCP 通道已打通(`client_tlcp=false` 跑的通)。
- **部署地址非确定**:nonce 随机,每次部署地址不同,不写死。
- `tools/fisco-realnode-probe.py`(仓库根 `tools/`)是更早的探针,
含 4 处 `IMPL_GAPS`、只报 `SKIPPED`/`NEEDS_IMPL`,已被
`selftest-fisco-contract.py` 取代;保留作历史参考。