sm-crypto
国密算法sm2、sm3和sm4的js实现。
安装
npm install --save sm-crypto安全公告
sm-crypto < 0.5.0 在 Node.js、小程序、Web Worker 等没有 window.crypto.getRandomValues 的环境中，sm2 的随机数仅由时钟生成，私钥、签名随机数和加密临时密钥均可被预测（GHSA-vh45-f885-3848 / CVE-2026-73567）。
- 请升级到
>= 0.5.0，升级无法挽回历史暴露 - 在旧版本中生成过、或用于签名过的 sm2 密钥，请轮换或吊销
- 在旧版本中使用
doEncrypt加密的数据，应视为已泄露
运行环境
sm2 依赖密码学安全的随机源 crypto.getRandomValues（浏览器使用 window.crypto，Node.js 使用 crypto 模块，其他环境使用 globalThis.crypto）。环境不支持时，加载 sm2 模块会直接抛出异常，不会回退到不安全的实现。Node.js 需要 17.4 及以上版本。
sm2
获取密钥对
const sm2 = require('sm-crypto').sm2
let keypair = sm2.generateKeyPairHex()
publicKey = keypair.publicKey // 公钥
privateKey = keypair.privateKey // 私钥
// 默认生成公钥 130 位太长，可以压缩公钥到 66 位
const compressedPublicKey = sm2.compressPublicKeyHex(publicKey) // compressedPublicKey 和 publicKey 等价
sm2.comparePublicKeyHex(publicKey, compressedPublicKey) // 判断公钥是否等价
// 自定义随机数：第一个参数为位数，第二个参数为实现了 nextBytes(array) 的随机数生成器，会透传给 jsbn 的 BigInteger(bits, rng)
// 注意：rng 必须基于密码学安全的随机源（CSPRNG），不要使用 jsbn 自带的 SecureRandom（存在同样的缺陷）
const crypto = require('crypto') // 浏览器中可改用 window.crypto.getRandomValues
const rng = {
nextBytes(array) {
const bytes = crypto.randomBytes(array.length)
for (let i = 0; i < array.length; i++) array[i] = bytes[i]
},
}
let keypair2 = sm2.generateKeyPairHex(256, rng)
let verifyResult = sm2.verifyPublicKey(publicKey) // 验证公钥
verifyResult = sm2.verifyPublicKey(compressedPublicKey) // 验证公钥
加密解密
const sm2 = require('sm-crypto').sm2
const cipherMode = 1 // 1 - C1C3C2，0 - C1C2C3，默认为1
let encryptData = sm2.doEncrypt(msgString, publicKey, cipherMode) // 加密结果
let decryptData = sm2.doDecrypt(encryptData, privateKey, cipherMode) // 解密结果
encryptData = sm2.doEncrypt(msgArray, publicKey, cipherMode) // 加密结果，输入数组
decryptData = sm2.doDecrypt(encryptData, privateKey, cipherMode, {output: 'array'}) // 解密结果，输出数组
ps：生成的密文会去掉 04 前缀，如遇到其他工具解密需要，则需要自己补充前缀。
> ps：密文会在解密时自动补充04，如遇到其他工具补充的04需手动去除再传入。
签名验签
ps：理论上来说，只做纯签名是最快的。
ps：hash参数默认为true，即默认会做 sm3 杂凑。如需纯签名（不做杂凑），请显式传入hash: false。
const sm2 = require('sm-crypto').sm2
// 纯签名 + 生成椭圆曲线点（不做sm3杂凑）
let sigValueHex = sm2.doSignature(msg, privateKey, {
hash: false,
}) // 签名
let verifyResult = sm2.doVerifySignature(msg, sigValueHex, publicKey, {
hash: false,
}) // 验签结果
// 纯签名
let sigValueHex2 = sm2.doSignature(msg, privateKey, {
pointPool: [sm2.getPoint(), sm2.getPoint(), sm2.getPoint(), sm2.getPoint()], // 传入事先已生成好的椭圆曲线点，可加快签名速度
}) // 签名
let verifyResult2 = sm2.doVerifySignature(msg, sigValueHex2, publicKey) // 验签结果
// 纯签名 + 生成椭圆曲线点 + der编解码
let sigValueHex3 = sm2.doSignature(msg, privateKey, {
der: true,
}) // 签名
let verifyResult3 = sm2.doVerifySignature(msg, sigValueHex3, publicKey, {
der: true,
}) // 验签结果
// sm3杂凑（默认行为）
let sigValueHex4 = sm2.doSignature(msg, privateKey)
let verifyResult4 = sm2.doVerifySignature(msg, sigValueHex4, publicKey) // 验签结果
// sm3杂凑（不做公钥推导）
let sigValueHex5 = sm2.doSignature(msg, privateKey, {
publicKey, // 传入公钥的话，可以去掉sm3杂凑中推导公钥的过程，速度更快
})
let verifyResult5 = sm2.doVerifySignature(msg, sigValueHex5, publicKey)
// sm3杂凑 + 不做公钥推导 + 添加 userId（长度小于 8192）
// 默认 userId 值为 1234567812345678
let sigValueHex6 = sm2.doSignature(msgString, privateKey, {
publicKey,
userId: 'testUserId',
})
let verifyResult6 = sm2.doVerifySignature(msgString, sigValueHex6, publicKey, {
userId: 'testUserId',
})
获取椭圆曲线点
const sm2 = require('sm-crypto').sm2
let point = sm2.getPoint() // 获取一个椭圆曲线点，可在sm2签名时传入
根据私钥获取公钥
const sm2 = require('sm-crypto').sm2
let publicKey = sm2.getPublicKeyFromPrivateKey(privateKey)
sm3
const sm3 = require('sm-crypto').sm3
let hashData = sm3('abc') // 杂凑
// hmac
hashData = sm3('abc', {
key: 'daac25c1512fe50f79b0e4526b93f5c0e1460cef40b6dd44af13caec62e8c60e0d885f3c6d6fb51e530889e6fd4ac743a6d332e68a0f2a3923f42585dceb93e9', // 要求为 16 进制串或字节数组
})
sm4
加密
const sm4 = require('sm-crypto').sm4
const msg = 'hello world! 我是 juneandgreen.' // 可以为 utf8 串或字节数组
const key = '0123456789abcdeffedcba9876543210' // 可以为 16 进制串或字节数组，要求为 128 比特
let encryptData = sm4.encrypt(msg, key) // 加密，默认输出 16 进制字符串，默认使用 pkcs#7 填充（传 pkcs#5 也会走 pkcs#7 填充）
let encryptData = sm4.encrypt(msg, key, {padding: 'none'}) // 加密，不使用 padding
let encryptData = sm4.encrypt(msg, key, {padding: 'none', output: 'array'}) // 加密，不使用 padding，输出为字节数组
let encryptData = sm4.encrypt(msg, key, {mode: 'cbc', iv: 'fedcba98765432100123456789abcdef'}) // 加密，cbc 模式
解密
const sm4 = require('sm-crypto').sm4
const encryptData = '0e395deb10f6e8a17e17823e1fd9bd98a1bff1df508b5b8a1efb79ec633d1bb129432ac1b74972dbe97bab04f024e89c' // 可以为 16 进制串或字节数组
const key = '0123456789abcdeffedcba9876543210' // 可以为 16 进制串或字节数组，要求为 128 比特
let decryptData = sm4.decrypt(encryptData, key) // 解密，默认输出 utf8 字符串，默认使用 pkcs#7 填充（传 pkcs#5 也会走 pkcs#7 填充）
let decryptData = sm4.decrypt(encryptData, key, {padding: 'none'}) // 解密，不使用 padding
let decryptData = sm4.decrypt(encryptData, key, {padding: 'none', output: 'array'}) // 解密，不使用 padding，输出为字节数组
let decryptData = sm4.decrypt(encryptData, key, {mode: 'cbc', iv: 'fedcba98765432100123456789abcdef'}) // 解密，cbc 模式
协议
MIT