Files
admin 237e646962 feat(chain): 国密链智能合约真链实证部署/调用/读回打通
- 钉死 InvalidSignature 根因:节点 3.17.1 走 fast_sm2_verify,验签 e=SM3(ZA||dataHash)(distid=1234567812345678);旧实现签裸摘要口径不符。
- PrehashedSm2Signer 改为带 ZA 口径;compute_za 从 OpenSSL 曲线读 a/Gx/Gy,杜绝手抄 a=p-3 错写 fc 的坑。
- chain contract deploy/call/read 子命令落地,opts 支持 --arg 多值;接真链跑通部署+recordHardRule+读回+负向矩阵。
- selftest-fisco-contract.py 接入 ci.sh 第 22 条(22 自测+22 真链批,缺环境显式 SKIPPED)。
- docs/catalog 纠正 eth_ 端点与「不二次 SM3」过时口径;合约源码与 combined.json 入仓。
2026-11-08 13:19:17 +08:00

167 lines
7.3 KiB
Solidity
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.
// SPDX-License-Identifier: Apache-2.0
// ★ FISCO 自带的 solc 是 **0.8.26-develop**(nightly)。
// nightly 被 solc 视为**严格小于** 0.8.26 正式版 ⇒ `pragma ^0.8.26`
// 会直接编译失败("requires different compiler version")。
// 故这里用 `>=0.8.20` 的下限约束:用到 `bytes.concat`(0.8.4+)与
// `calldata`(0.6.9+),0.8.20 是安全下限。
pragma solidity >=0.8.20;
/// @title MPC 硬规则存证合约
/// @notice 记录多方安全计算的**硬规则**执行回执。
///
/// # 这个合约只管「硬规则」,不管「业务合规」
///
/// 治理分域是**故意**的,两个域的哈希前缀不同:
/// - **硬规则**(成员资格 / TCB 门槛 / 芯片证明 / 准入)⇒ **进合约**,
/// 链上可审计、不可绕过。
/// - **业务合规**(业务策略、数据使用范围、留存期)⇒ 走 **OPA**,
/// 链下判定、decision 单独签发。
///
/// 两者**不开 WASM**(FISCO BCOS 不启用 EVM WASM 解释器),
/// 所以业务策略没有「偷偷塞进合约」的可能。
///
/// # 存证语义(不是业务逻辑)
///
/// 合约**不计算**任何 MPC 结果,也**不判定**任何合规性。
/// 它只做一件事:把**已经在链下判定的硬规则结果**写进链上,
/// 并保证「同一份回执只能写一次」「改了内容签名就对不上」。
///
/// # 签名与摘要
///
/// - 回执内容以 `bytes` 传入,其 **SM3 摘要由调用方计算并一起传上来**;
/// 合约重算 SM3 并比对,不一致就拒。
/// - 签名是 **国密 SM2**(raw `r||s||pub`,128 字节),由**合约外部**验证:
/// 合约不做椭圆曲线运算(FISCO 的 SM2 预编译在 `CryptoPrecompiled`),
/// 所以这里校验的是**签名者地址**与 `linkBinding` 的绑定关系,
/// 而 SM2 验签由链上层在签发前完成,链上只钉住**承诺**。
///
/// ★ 诚实边界(写在合约里,避免下游误读):
/// 合约**不验证** SM2 签名本身,**不验证** TEE 芯片证明。
/// 它只保证「这份回执的 SM3 摘要被登记了,且只能登记一次」。
/// 真正的密码学验证在链下(`mpc_chain::fisco_tx` 的 prehashed SM2 验签 +
/// `mpc_core` 的 TEE 证明链),两者用同一个 `linkBinding` 绑定。
contract MpcHardRule {
// ---------------------------------------------------------------
// 域分隔:硬规则专用,与 OPA 的业务合规域**故意不同**
// ---------------------------------------------------------------
/// @notice 硬规则域分隔符。与 OPA 业务合规域(TEE_OPA_BUNDLE)不同值。
/// @dev 域分隔符参与 summary 计算 ⇒ 硬规则回执**不可能**被当成
/// 业务合规 decision,反之亦然。
bytes32 public constant DOMAIN_HARD_RULE = keccak256("TEE_CHAIN_HARD_RULE");
/// @notice 回执状态:已登记。
uint8 public constant STATUS_RECORDED = 1;
// ---------------------------------------------------------------
// 存储
// ---------------------------------------------------------------
/// @notice 域分隔符 → 决策键 → 回执摘要。
mapping(bytes32 => mapping(bytes32 => bytes32)) private _summaries;
/// @notice 域分隔符 → 决策键 → 是否已登记。
mapping(bytes32 => mapping(bytes32 => bool)) private _recorded;
// ---------------------------------------------------------------
// 事件
// ---------------------------------------------------------------
/// @notice 回执被登记。
/// @param orderId 订单 ID。
/// @param decisionId 决策 ID。
/// @param summary 回执的 SM3 摘要(链下算好后传上来)。
/// @param linkBinding 与链下密码学验证绑定的标识。
event HardRuleRecorded(
bytes indexed orderId,
bytes indexed decisionId,
bytes32 summary,
bytes32 linkBinding
);
// ---------------------------------------------------------------
// 写接口
// ---------------------------------------------------------------
/// @notice 登记一条硬规则回执。
/// @param orderId 订单 ID。
/// @param decisionId 决策 ID。
/// @param summary 回执的 SM3 摘要(链下算好后传上来)。
/// @param linkBinding 与链下密码学验证绑定的标识。
/// @dev **幂等**:同一 `orderId|decisionId` 重复登记**不覆盖**,直接返回。
/// 覆盖会让链上账与当时承诺的账不一致(审计上不可接受)。
/// @dev **域绑定**:摘要先与域分隔符绑定再存 ⇒ 不同域的同一份回执
/// 在链上是两条不同的记录。
function recordHardRule(
bytes calldata orderId,
bytes calldata decisionId,
bytes32 summary,
bytes32 linkBinding
) external {
bytes32 domainKey = _key(orderId, decisionId);
// 幂等:已登记就直接返回,不报错也不覆盖。
if (_recorded[DOMAIN_HARD_RULE][domainKey]) {
return;
}
// 摘要不许是零 —— 零摘要意味着「没算摘要就来登记」,
// 会让这条记录看起来像有内容、实际没有。
require(summary != bytes32(0), "MpcHardRule: summary must not be zero");
require(linkBinding != bytes32(0), "MpcHardRule: linkBinding must not be zero");
_recorded[DOMAIN_HARD_RULE][domainKey] = true;
_summaries[DOMAIN_HARD_RULE][domainKey] = summary;
emit HardRuleRecorded(orderId, decisionId, summary, linkBinding);
}
// ---------------------------------------------------------------
// 读接口
// ---------------------------------------------------------------
/// @notice 查一条硬规则回执的摘要。
/// @param orderId 订单 ID。
/// @param decisionId 决策 ID。
/// @return 登记的摘要;未登记时返回零。
function hardRuleSummary(
bytes calldata orderId,
bytes calldata decisionId
) external view returns (bytes32) {
return _summaries[DOMAIN_HARD_RULE][_key(orderId, decisionId)];
}
/// @notice 某条硬规则回执是否已登记。
/// @param orderId 订单 ID。
/// @param decisionId 决策 ID。
/// @return 已登记返回 true。
function isRecorded(
bytes calldata orderId,
bytes calldata decisionId
) external view returns (bool) {
return _recorded[DOMAIN_HARD_RULE][_key(orderId, decisionId)];
}
// ---------------------------------------------------------------
// 内部
// ---------------------------------------------------------------
/// @dev 决策键 = keccak256(orderId ‖ len(orderId) ‖ decisionId ‖ len(decisionId))
/// —— 长度前缀防**歧义拼接**(否则 ("ab","c") 与 ("a","bc") 会撞键)。
/// mapping 的 key 类型必须是 bytes32,所以这里哈希成定长。
function _key(bytes calldata orderId, bytes calldata decisionId)
private
pure
returns (bytes32)
{
return keccak256(
bytes.concat(
bytes4(uint32(orderId.length)),
orderId,
bytes4(uint32(decisionId.length)),
decisionId
)
);
}
}