110 lines
3.1 KiB
Markdown
110 lines
3.1 KiB
Markdown
# tic-crypto
|
||
|
||
时光链区块链密码学算法工具库：为区块链相关应用开发提供一套底层的基础算法工具库，用来处理哈希、加解密、签名、助记词、等等。
|
||
|
||
- 支持 md5、sha256 等算法的哈希
|
||
- 基于 bip39 等算法的助记词生成、检验
|
||
- 基于 secp256k1 等曲线算法的签名、交易的加解密
|
||
- 其他辅助算法工具
|
||
|
||
## 硬件环境
|
||
|
||
- 机型：Mac 或 PC 机
|
||
- 内存：8GB 以上
|
||
- 硬盘：500G 以上
|
||
|
||
## 软件环境
|
||
|
||
- 操作系统：跨平台通用，支持 MacOS, Linux, Windows
|
||
- 开发环境：推荐 Visual Studio Code
|
||
- 运行环境：nodejs 12.16 版本
|
||
|
||
## 安装指南
|
||
|
||
在前后端软件的 package.json 的依赖清单中引入本库：
|
||
|
||
```
|
||
npm install git+https://git.tic.cc/npm/tic-crypto#RELEASE_OR_BRANCH --save
|
||
```
|
||
|
||
## 用法
|
||
|
||
基本用法示例：
|
||
|
||
```
|
||
let ticc=require('tic-crypto') // 引用
|
||
let sw=ticc.randomize_secword() // 生成一个随机的助记词（即密语）。或者使用现成的密语。
|
||
let kp=ticc.secword_to_keypair({secword:sw}) // 把密语转换成公私钥
|
||
let address=ticc.secword_to_address({secword:sw}) // 把密语转换成地址
|
||
```
|
||
|
||
## 其他
|
||
|
||
```
|
||
const keyPair = crypto.generateKeyPairSync('rsa', {
|
||
modulusLength: 520,
|
||
publicKeyEncoding: {
|
||
type: 'spki',
|
||
format: 'pem'
|
||
},
|
||
|
||
privateKeyEncoding: {
|
||
type: 'pkcs8',
|
||
format: 'pem',
|
||
cipher: 'aes-256-cbc',
|
||
passphrase: ''
|
||
}
|
||
})
|
||
```
|
||
|
||
这样生成的 keyPair.privateKey 开头是 -----BEGIN ENCRYPTED PRIVATE KEY-----
|
||
|
||
如果直接
|
||
|
||
```
|
||
crypto.privateEncrypt(kp.privateKey, Buffer.from('sdafasfdsaf'))
|
||
```
|
||
|
||
会报错
|
||
|
||
```
|
||
Uncaught TypeError: Passphrase required for encrypted key
|
||
```
|
||
|
||
所以要这样才行
|
||
|
||
```
|
||
crypto.privateEncrypt({key:kp.privateKey, passphrase:''}, Buffer.from('sdafasfdsaf'))
|
||
```
|
||
|
||
我从 https://www.cnblogs.com/chyingp/p/nodejs-asymmetric-enc-dec.html 抄到一个 privateKey 可以直接使用，不需要 passphrase
|
||
|
||
返回 Buffer。每次结果都一样
|
||
|
||
这样生成的 keyPair.publicKey 开头是 -----BEGIN PUBLIC KEY-----
|
||
|
||
可以直接
|
||
|
||
```
|
||
crypto.publicEncrypt(kp.publicKey, Buffer.from('sdafasfdsaf'))
|
||
```
|
||
|
||
返回 Buffer。每次结果不一样
|
||
|
||
似乎 crypto 一定要 rsa 公私钥才可以用加解密，ticc.randomize_keypair() 生成的 ecc 公私钥不行。
|
||
|
||
而 eccrypto 和 eccrypto-js 可以用。eccrypto.generateKeyPair() 生成的和 ticc.randomize_keypair() 一样
|
||
|
||
eccrypto 在 windows 上的安装有麻烦，一来需要手工安装 OpenSSL 到 c:\openssl-win64\，二来 openssl 1.1.0 起把 libeay32.lib 改名为 libcrypto.dll，而 eccrypto 需要 c:\openssl-win64\lib\libeay32.lib，会报错
|
||
|
||
eccrypto-js 在 devDependencies 里继承了 eccrypto，因此 npm i --production 即可
|
||
|
||
base32 有多种字符集：[Base32 - Wikipedia](https://en.wikipedia.org/wiki/Base32)
|
||
|
||
IPFS 用的是 RFC4648 字符集
|
||
|
||
- 从数到数符串：Number(数).toString(进制数)，0x 数.toString(进制数), 0b 数.toString(进制数)
|
||
- 从数符串到数字：parseInt(str, 进制数)
|
||
- Buffer 到数符串: Buffer.toString(编码方案例如'hex','base64',默认'utf8')
|
||
- 字符串到 Buffer: Buffer.from(data, 编码方案如'hex','base64',默认'utf8')
|