Files
ssw-mpc/tools/sm2_verify.py
T
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

224 lines
7.9 KiB
Python
Raw 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.
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""纯 Python SM2 验签器(判定「被签对象 e 到底是哪一个」)。
为什么需要它
------------
FISCO 国密链的**交易签名**不是普通 SM2 消息签名:
上游 `SM2Crypto.cpp` 把已经算好的 32 字节 `dataHash` 直接交给
`wedpr_sm2_sign_fast(priv, pub, msgHash, sig)`;而 HSM 路径
(`HsmSM2Crypto.cpp`)的注释明写「M' = Za || M,e = H(M')」。
两条路径对 `e` 的定义**不一样**,而症状都是「验签失败」。
本脚本按**候选 e** 分别验签,从而判定:
- `e = dataHash`(把摘要直接当 e,不算 ZA)
- `e = SM3(ZA || dataHash)`(标准 SM2,ZA 用 distid `1234567812345678`)
★ 本脚本**只做判定**,不替代被测实现。标准向量自检不过就抛异常,
绝不允许「算错了但结论看起来对」。
★ 坐标运算用**仿射坐标**(每次加法做一次模逆):慢一点,但不可能
因为「忘了把雅可比坐标转回仿射」而恒定验签失败 —— 那种 bug 的
症状恰好和「签名真的错了」一模一样,最容易把排查方向带偏。
"""
import hashlib
import os
import sys
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
from sm3 import sm3 # noqa: E402
# SM2 推荐参数(GM/T 0003-2012)
P = 0xFFFFFFFEFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000FFFFFFFFFFFFFFFF
A = 0xFFFFFFFEFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000FFFFFFFFFFFFFFFC
B = 0x28E9FA9E9D9F5E344D5A9E4BCF6509A7F39789F515AB8F92DDBCBD414D940E93
N = 0xFFFFFFFEFFFFFFFFFFFFFFFFFFFFFFFF7203DF6B21C6052B53BBF40939D54123
GX = 0x32C4AE2C1F1981195F9904466A39C9948FE30BBFF2660BE1715A4589334C74C7
GY = 0xBC3736A2F4F6779C59BDCEE36B692153D0A9877CC62A474002DF32E52139F0A0
DEFAULT_ID = b"1234567812345678"
INF = (0, 0)
def _inv(a, m):
return pow(a % m, -1, m)
def _add(p1, p2):
x1, y1 = p1
x2, y2 = p2
if x1 == 0 and y1 == 0:
return p2
if x2 == 0 and y2 == 0:
return p1
if x1 == x2:
if (y1 + y2) % P == 0:
return INF
lam = ((3 * x1 * x1 + A) * _inv(2 * y1, P)) % P
else:
lam = ((y2 - y1) * _inv(x2 - x1, P)) % P
nx = (lam * lam - x1 - x2) % P
ny = (lam * (x1 - nx) - y1) % P
return (nx, ny)
def _mul(k, pt):
k %= N
if k == 0 or (pt[0] == 0 and pt[1] == 0):
return INF
result = INF
addend = pt
while k:
if k & 1:
result = _add(result, addend)
addend = _add(addend, addend)
k >>= 1
return result
def _on_curve(pt):
x, y = pt
return (y * y - (x * x * x + A * x + B)) % P == 0
def za(px, py, distid=DEFAULT_ID):
"""SM2 的 ZA = SM3(ENTL || ID || a || b || Gx || Gy || Px || Py)。"""
entl = len(distid) * 8
buf = bytearray()
buf += entl.to_bytes(2, "big")
buf += distid
buf += A.to_bytes(32, "big")
buf += B.to_bytes(32, "big")
buf += GX.to_bytes(32, "big")
buf += GY.to_bytes(32, "big")
buf += px.to_bytes(32, "big")
buf += py.to_bytes(32, "big")
return sm3(bytes(buf))
def verify(pub_xy, e, raw_rs):
"""按给定 `e` 验 raw `r||s`。返回 True/False。"""
if len(raw_rs) != 64:
raise ValueError("raw 签名必须是 64 字节 r||s")
r = int.from_bytes(raw_rs[:32], "big")
s = int.from_bytes(raw_rs[32:], "big")
if not (1 <= r < N and 1 <= s < N):
return False
px, py = pub_xy
if not _on_curve((px, py)):
return False
t = (r + s) % N
if t == 0:
return False
# ★ 这里必须用**不同名字**接 y 坐标。早先写成 `x1, _ = ...` / `x2, _ = ...`
# 会让 `_` 被第二次赋值覆盖,于是 `_add` 拿到的是「同一个 y」,
# 点加结果全错 —— 而症状是「验签失败」,和签名真的错了没法区分。
x1, y1 = _mul(s, (GX, GY))
x2, y2 = _mul(t, (px, py))
x, y = _add((x1, y1), (x2, y2))
if x == 0 and y == 0:
return False
# SM2 验签关系:`r == (e + x_R) mod n`。
return (e + x) % N == r
def _self_test():
"""自洽性自检:造一个签名,用标准 `e` 验必须过,用错的 `e` 验必须失败。
另外用 GM/T 0003-2012 附录 A.2 的**标准消息 'abc'** 走一遍完整
流程(ZA → e → 签 → 验),确保 ZA 的拼装字节序也是对的。
"""
d = 0x128B2FA8BD433C6C068C8D803DFF79792A519A55171B1B650C23661D15897263
px, py = _mul(d, (GX, GY))
assert _on_curve((px, py)), "公钥必须在上曲线上"
z = za(px, py)
# ★ ZA 的**值**锚点:GmSSL 3.2.0 权威交叉验证。
# `gmssl sm3 -pubkey <pem> -id 1234567812345678 -in_str abc -hex`
# 对同一把公钥给出 `a3aeb6d5…`,与本实现逐字节相同。
# 只测「长度 32」等于没测 —— ZA 拼错一个字节,验签照样全绿,
# 而真链症状是 `InvalidSignature`,与「ZA 拼错」八竿子打不着。
GMSSL_SM3_ZA_ABC = "a3aeb6d51774289959d560d767bbabfcdd716686146e153b95e4d734603ca185"
assert (
sm3(z + b"abc").hex() == GMSSL_SM3_ZA_ABC
), "SM3(ZA‖'abc') 与 GmSSL 权威值不符:%s" % sm3(z + b"abc").hex()
e = int.from_bytes(sm3(z + b"abc"), "big")
k = 0x6CB28D99385C175C94F94E934817663FC176D925DD72B727260DBAAE1FB2F96F
x1, _ = _mul(k, (GX, GY))
r = (e + x1) % N
s = (_inv(1 + d, N) * (k - r * d)) % N
sig = r.to_bytes(32, "big") + s.to_bytes(32, "big")
assert verify((px, py), e, sig), "标准 e 验签必须通过"
assert not verify((px, py), e ^ 1, sig), "错误的 e 必须验签失败"
# 另一条独立路径:把消息哈希当成 e(即「不算 ZA」的候选语义),
# 用它签出来的签名在「标准 e」下必须验不过 —— 这正是我们要区分的两种语义。
e2 = int.from_bytes(sm3(b"abc"), "big")
x2, _ = _mul(k, (GX, GY))
r2 = (e2 + x2) % N
s2 = (_inv(1 + d, N) * (k - r2 * d)) % N
sig2 = r2.to_bytes(32, "big") + s2.to_bytes(32, "big")
assert verify((px, py), e2, sig2), "裸摘要 e 验签必须通过"
assert not verify((px, py), e, sig2), "两种 e 语义必须互相验不过"
return True
def _hex_to_xy(hexpub):
h = hexpub.lower().replace("0x", "")
if len(h) != 128:
raise ValueError("公钥必须是 64 字节 X||Y 的 hex")
return int(h[:64], 16), int(h[64:], 16)
def main(argv):
if len(argv) != 4:
print(
"用法: sm2_verify.py <pub_hex_XY> <data_hash_hex> <sig_r_s_hex>\n"
"输出: 逐个候选 e 的验签结果",
file=sys.stderr,
)
return 2
pub_hex, hash_hex, sig_hex = argv[1], argv[2], argv[3]
_self_test()
px, py = _hex_to_xy(pub_hex)
digest = bytes.fromhex(hash_hex.lower().replace("0x", ""))
if len(digest) != 32:
raise SystemExit("dataHash 必须是 32 字节")
sig = bytes.fromhex(sig_hex.lower().replace("0x", ""))
if len(sig) != 64:
raise SystemExit("签名必须是 64 字节 r||s")
z = za(px, py)
e_za = sm3(z + digest)
e_za2 = sm3(z + sm3(digest))
cands = [
("A e = dataHash(裸摘要直接当 e,不算 ZA)", int.from_bytes(digest, "big")),
(
"B e = SM3(ZA||dataHash)(标准 SM2,distid=1234567812345678)",
int.from_bytes(e_za, "big"),
),
(
"C e = SM3(ZA||SM3(dataHash))(OpenSSL sm2_do_sign/verify 双哈希)",
int.from_bytes(e_za2, "big"),
),
]
print("pub_xy = %064x%064x" % (px, py))
print("dataHash = %s" % hash_hex.lower().replace("0x", ""))
print("ZA = %s" % z.hex())
print("SM3(ZA||hash) = %s" % e_za.hex())
print("SM3(ZA||SM3(h)) = %s" % e_za2.hex())
hit = None
for name, e in cands:
ok = verify((px, py), e, sig)
print("%-62s => %s" % (name, "PASS" if ok else "FAIL"))
if ok and hit is None:
hit = name
print("VERDICT: %s" % (hit if hit else "NO_CANDIDATE_MATCHED"))
return 0 if hit else 1
if __name__ == "__main__":
sys.exit(main(sys.argv))