轻量级国密算法库sm-crypto：微信小程序的高效安全解决方案

1. 项目定位与应用场景

1.1 微信生态专属国密实现

作为专为微信小程序设计的国密算法库，sm-crypto提供SM2、SM3和SM4全系列国密算法支持，完美适配小程序基础库2.2.1+环境，解决小程序开发中的合规加密需求。

1.2 核心应用场景

覆盖金融支付、身份认证、数据传输等关键场景，特别适合需要符合国家密码标准的政务、金融类小程序，提供开箱即用的加密能力。

1.3 技术优势

采用纯JavaScript实现，无需原生插件支持，体积轻量且性能优异，在小程序有限的运行环境中实现高效加密运算。

2. 技术特性解析

2.1 SM2非对称加密：密钥对生成与加解密

🔑 支持密钥对生成、公钥压缩（130位→66位）、加密解密及多种签名验签模式，满足数字签名和密钥交换需求。

2.2 SM3密码杂凑：高效哈希计算

⚡️ 实现SM3密码杂凑算法，支持标准哈希和HMAC模式，可用于消息完整性校验和数据指纹生成，运算速度达毫秒级。

2.3 SM4对称加密：灵活加密方案

🔐 提供ECB、CBC等多种加密模式，支持PKCS#7填充，密钥长度128比特，适用于敏感数据加密存储和传输。

2.4 算法对比表格

算法	类型	密钥长度	主要用途	性能特点
SM2	非对称	256位	数字签名、密钥交换	安全性高，运算速度适中
SM3	杂凑	输出256位	数据完整性校验	计算高效，抗碰撞性强
SM4	对称	128位	数据加密解密	速度快，适合大量数据处理

3. 版本演进亮点

3.1 公钥压缩功能：存储优化

新增公钥压缩功能，将130位公钥压缩至66位，大幅减少存储空间和传输带宽，提升移动端性能。

3.2 自定义随机数支持：灵活性增强

支持开发者传入自定义随机数生成密钥对，满足特定安全场景需求，提升算法使用灵活性。

3.3 SM2签名优化：性能提升

通过预生成椭圆曲线点、DER编解码和SM3杂凑优化，签名速度提升40%，降低小程序运行时开销。

3.4 SM4模式扩展：应用广泛

新增CBC加密模式支持，提供更全面的对称加密选项，满足不同场景下的数据保护需求。

4. 实用集成指南

4.1 环境要求

• 微信小程序基础库2.2.1及以上版本
• 开发者工具支持npm构建功能
• Node.js环境（构建时需要）

4.2 安装步骤

# 克隆仓库
git clone https://gitcode.com/gh_mirrors/smcry/sm-crypto

# 安装依赖
npm install --save miniprogram-sm-crypto

4.3 构建与使用

通过npm构建后即可在小程序中引入使用，支持按需加载各算法模块，最小化资源占用。

4.4 测试与验证

提供完整测试用例，可通过npm test命令验证算法正确性，确保集成后功能可靠。

4.5 注意事项

使用自定义随机数时需确保符合密码学安全要求；加密数据传输时注意密文格式处理，避免额外字符干扰解密过程。