- 钉死 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 入仓。
167 lines
7.3 KiB
Solidity
167 lines
7.3 KiB
Solidity
// 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
|
||
)
|
||
);
|
||
}
|
||
}
|