同构 API，Node.js (>= 18) 与现代浏览器一致可用
函数式 / OOP 双轨 API，友好按需加载与 Tree-shaking
对齐 GM/T 标准，兼容 OpenSSL 等主流实现的密文格式
纯 TypeScript、零额外依赖，适合生产环境性能优化
✨ 核心特性
gmkitx 是一套纯 TypeScript 实现的密码学工具集。它不仅实现了 SM2 / SM3 / SM4 / ZUC 等国密标准，还集成了 SHA 系列国际算法。
设计的初衷很简单：提供一套同构（Isomorphic）的代码库，让开发者在服务端和 现代浏览器 前端，都能使用完全一致的 API 进行加密、解密、签名与哈希运算。
🚀 快速安装
npm
npm install gmkitxpnpm
pnpm add gmkitxyarn
yarn add gmkitx⚡ 快速示例
函数式编程（推荐）
适合现代前端开发，利于 Tree-shaking，代码更简洁。
import {
digest, // SM3
sm4Encrypt, // SM4
sm4Decrypt,
sm2Encrypt, // SM2
sm2Decrypt,
generateKeyPair,
CipherMode,
PaddingMode
} from 'gmkitx';
// 1. SM3 摘要
const hash = digest('Hello, SM3!');
// 2. SM4 对称加密 (CBC模式)
const key = '0123456789abcdeffedcba9876543210'; // 128位密钥
const iv = 'fedcba98765432100123456789abcdef'; // 初始化向量
const ciphertext = sm4Encrypt(key, '我的机密数据', {
mode: CipherMode.CBC,
padding: PaddingMode.PKCS7,
iv,
});
// 3. SM2 非对称加密
const { publicKey, privateKey } = generateKeyPair();
const encData = sm2Encrypt(publicKey, 'Hello, SM2!');
const decData = sm2Decrypt(privateKey, encData);命名空间导入
结构清晰，适合大型项目统一管理加密模块。
import { sm2, sm3, sm4, sha } from 'gmkitx';
// 统一入口调用
const hash = sm3.digest('Hello');
const sig = sm2.sign(privateKey, 'Message');
const verified = sm2.verify(publicKey, 'Message', sig);
// SHA 国际标准
const sha512Hash = sha.sha512('Hello World');📚 支持的算法
国密算法
- SM2 - 椭圆曲线公钥密码算法（加密、解密、签名、验签）
- SM3 - 密码杂凑算法（哈希）
- SM4 - 分组密码算法（对称加密，支持多种模式）
- ZUC - 祖冲之序列密码算法（流加密）
国际标准算法
- SHA - SHA-1, SHA-224, SHA-256, SHA-384, SHA-512 系列哈希算法