# @fanthos/gm-crypto > An implementation of GM/T industry standards Latest version **0.1.7** (published 2021-03-26) · MIT license · 0 weekly downloads ## Install ```sh npm install @fanthos/gm-crypto pnpm add @fanthos/gm-crypto yarn add @fanthos/gm-crypto bun add @fanthos/gm-crypto ``` ## Health **Score 30/100 (F)** — status: abandoned. Positive: has types; esm support; no vulnerabilities; high quality score. Warnings: low downloads; pre 1.0. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 0.1.7 | | Published | 2021-03-26 | | First published | 2021-03-26 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 3 | | Unpacked size | 73 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 213 | | Author | panjizhi1987@gmail.com | | Maintainers | fanthos | | Keywords | sm2, sm3, sm4, zuc, gm, crypto | ## Links - npm: https://www.npmjs.com/package/@fanthos/gm-crypto - Repository: https://github.com/byte-fe/gm-crypto - Homepage: https://github.com/byte-fe/gm-crypto#readme - Issues: https://github.com/byte-fe/gm-crypto/issues - npm.io page: https://npm.io/package/@fanthos/gm-crypto ## Dependencies (3) - [jsbn](https://npm.io/package/jsbn.md) ^1.1.0 - [buffer](https://npm.io/package/buffer.md) ^5.7.0 - [to-arraybuffer](https://npm.io/package/to-arraybuffer.md) ^1.0.1 ## Alternatives - [@gemini-wallet/core](https://npm.io/package/@gemini-wallet/core.md) — 515.6K weekly downloads - [utility](https://npm.io/package/utility.md) — 416.6K weekly downloads - [@primno/dpapi](https://npm.io/package/@primno/dpapi.md) — 7.2K weekly downloads - [pi-readseek](https://npm.io/package/pi-readseek.md) — 3.7K weekly downloads - [@emilia-protocol/verify](https://npm.io/package/@emilia-protocol/verify.md) — 1.1K weekly downloads ## Recent versions - 0.1.7 (latest) — 2021-03-26 ## README # gm-crypto [![Build Status](https://travis-ci.com/byte-fe/gm-crypto.svg?branch=main)](https://travis-ci.com/byte-fe/gm-crypto) [![codecov](https://codecov.io/gh/byte-fe/gm-crypto/branch/main/graph/badge.svg?token=5UbUw8VKYh)](https://codecov.io/gh/byte-fe/gm-crypto) [![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/) [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](pulls) ![密码行业标准化委员会](./spec_header.png) A pure JavaScript implementation of GM/T series cryptographic algorithms for Node.js and browsers, with type declaration files support. - [GM/T0003-2012《SM2 public key cryptographic algorithm based on elliptic curves》](http://www.oscca.gov.cn/sca/xxgk/2010-12/17/content_1002386.shtml) - [GM/T0004-2012《SM3 cryptographic hash algorithm》](https://www.oscca.gov.cn/sca/xxgk/2010-12/17/content_1002389.shtml) - [GM/T0002-2012《SM4 block cipher algorithm》(also aliased as SMS4)](http://www.sca.gov.cn/sca/c100061/201611/1002423/files/330480f731f64e1ea75138211ea0dc27.pdf) ## Quick Start ### Install Using npm: ```bash $ npm install gm-crypto ``` Using yarn: ```bash $ yarn add gm-crypto ``` ### Basic Usage #### SM2 > Public Key Cryptographic Algorithm Based on Elliptic Curves. ```js const { SM2 } = require('gm-crypto') const { publicKey, privateKey } = SM2.generateKeyPair() const originalData = 'SM2 椭圆曲线公钥密码算法' const encryptedData = SM2.encrypt(originalData, publicKey, { inputEncoding: 'utf8', outputEncoding: 'base64' }) const decryptedData = SM2.decrypt(encryptedData, privateKey, { inputEncoding: 'base64', outputEncoding: 'utf8' }) ``` #### SM3 > Cryptographic Hash Algorithm. ```js const { SM3 } = require('gm-crypto') console.log(SM3.digest('abc')) console.log(SM3.digest('YWJj', 'base64')) console.log(SM3.digest('616263', 'hex', 'base64')) ``` #### SM4 > Block Cipher Algorithm. ```js const { SM4 } = require('gm-crypto') const key = '0123456789abcdeffedcba9876543210' // Any string of 32 hexadecimal digits const originalData = 'SM4 国标对称加密' /** * Block cipher modes: * - ECB: electronic codebook * - CBC: cipher block chaining */ let encryptedData, decryptedData // ECB encryptedData = SM4.encrypt(originalData, key, { inputEncoding: 'utf8', outputEncoding: 'base64' }) decryptedData = SM4.decrypt(encryptedData, key, { inputEncoding: 'base64', outputEncoding: 'utf8' }) // CBC const iv = '0123456789abcdeffedcba9876543210' // Initialization vector(any string of 32 hexadecimal digits) encryptedData = SM4.encrypt(originalData, key, { iv, mode: SM2.constants.CBC, inputEncoding: 'utf8', outputEncoding: 'hex' }) decryptedData = SM4.decrypt(encryptedData, key, { iv, mode: SM2.constants.CBC, inputEncoding: 'hex', outputEncoding: 'utf8' }) ``` ## API - [SM2](#api) - [.generateKeyPair()](#sm2generatekeypair) ⇒ `object` - [.encrypt(data, key[, options]](#sm2encryptdata-key-options) ⇒ `string` | `ArrayBuffer` - [.decrypt(data, key[, options])](#sm2decryptdata-key-options) ⇒ `string` | `ArrayBuffer` - [SM3](#api) - [.digest(data[, inputEncoding][, outputEncoding])](#sm3digestdata-inputencoding-outputencoding) ⇒ `string` | `ArrayBuffer` - [SM4](#api) - [.encrypt(data, key[, options])](#sm4encryptdata-key-options) ⇒ `string` | `ArrayBuffer` - [.decrypt(data, key[, options])](#sm4decryptdata-key-options) ⇒ `string` | `ArrayBuffer` ### SM2.generateKeyPair() Generates a new asymmetric key pair. ### SM2.encrypt(data, key[, options]) Encrypt data. | Param | Type | Default | Description | | ---------------------- | --------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | data | `string`\|`ArrayBuffer`\|`Buffer` | | Plain message | | key | `string` | | Public key generated by [SM2.generateKeyPair()](#sm2generatekeypair) | | options | `object` | | Options | | options.mode | `C1C3C2` \| `C1C2C3` | `C1C3C2` | Concatenation mode | | options.inputEncoding | `string` | `"utf8"` | The encoding of the plain `data` string,if `data` is not a string then `inputEncoding` is ignored. | | options.outputEncoding | `string` | | If `outputEncoding` is provided, a string will be returned, otherwise a [ArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) is returned. | ### SM2.decrypt(data, key[, options]) Decrypt data. | Param | Type | Default | Description | | ---------------------- | --------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | data | `string`\|`ArrayBuffer`\|`Buffer` | | Ciphered data | | key | `string` | | Private key generated by [SM2.generateKeyPair()](#sm2generatekeypair) | | options.mode | `C1C3C2` \| `C1C2C3` | `C1C3C2` | Concatenation mode | | options.inputEncoding | `string` | | The encoding of the plain `data` string,if `data` is not a string then `inputEncoding` is ignored. | | options.outputEncoding | `string` | | If `outputEncoding` is provided, a string will be returned, otherwise a [ArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) is returned. | ### SM3.digest(data, [inputEncoding], [outputEncoding]) Calculates the digest. | Param | Type | Default | Description | | -------------- | --------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | data | `string`\|`ArrayBuffer`\|`Buffer` | | Data message | | inputEncoding | `string` | `"utf8"` | The encoding of the `data` string, if `data` is not a string then `inputEncoding` is ignored. | | outputEncoding | `string` | | If `outputEncoding` is provided, a string will be returned, otherwise a [ArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) is returned. | ### SM4.encrypt(data, key[, options]) Encrypt data. | Param | Type | Default | Description | | ---------------------- | --------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | data | `string`\|`ArrayBuffer`\|`Buffer` | | Plain message | | key | `string` | | Cipher key(any string of 32 hexadecimal digits) | | options | `object` | | Options | | options.mode | `ECB` \| `CBC` | `ECB` | Block cipher mode | | options.iv | `string` | | Initialization vector(any string of 32 hexadecimal digits) | | options.inputEncoding | `string` | `"utf8"` | The encoding of the plain `data` string,if `data` is not a string then `inputEncoding` is ignored. | | options.outputEncoding | `string` | | If `outputEncoding` is provided, a string will be returned, otherwise a [ArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) is returned. | ### SM4.decrypt(data, key[, options]) Decrypt data. | Param | Type | Default | Description | | ---------------------- | --------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | data | `string`\|`ArrayBuffer`\|`Buffer` | | Ciphered data | | key | `string` | | Cipher key(any string of 32 hexadecimal digits) | | options | `object` | | Options | | options.mode | `ECB` \| `CBC` | `ECB` | Block cipher mode | | options.iv | `string` | | Initialization vector(any string of 32 hexadecimal digits) | | options.inputEncoding | `string` | | The encoding of the plain `data` string,if `data` is not a string then `inputEncoding` is ignored. | | options.outputEncoding | `string` | | If `outputEncoding` is provided, a string will be returned, otherwise a [ArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) is returned. | --- _Source: https://npm.io/package/@fanthos/gm-crypto · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._