改进 README.md

This commit is contained in:
陆柯 2020-10-31 12:20:02 +08:00
parent df71cf346a
commit ae96a990f1

View File

@ -1,24 +1,43 @@
# tic.crypto # tic.crypto
时光链密码学工具库:时光链专用的密码学工具库,用来处理哈希、加解密、签名、助记词、等等。 时光链区块链密码学算法工具库:为区块链相关应用开发提供一套底层的基础算法工具库,用来处理哈希、加解密、签名、助记词、等等。
## Table of Contents - 支持 md5、sha256 等算法的哈希
- 基于 bip39 等算法的助记词生成、检验
- 基于 secp256k1 等曲线算法的签名、交易的加解密
- 其他辅助算法工具
1. [Installation Guide](#1-installation-guide) - [tic.crypto](#ticcrypto)
2. [Usage](#2-usage) - [硬件环境](#硬件环境)
3. [API Specification](#3-api-specification) - [软件环境](#软件环境)
4. [References](#4-references) - [安装指南](#安装指南)
- [用法](#用法)
- [编程接口规范](#编程接口规范)
## 1. Installation Guide ## 硬件环境
- 机型Mac 或 PC 机
- 内存8GB 以上
- 硬盘500G 以上
## 软件环境
- 操作系统:跨平台通用,支持 MacOS, Linux, Windows
- 开发环境:推荐 Visual Studio Code
- 运行环境nodejs 12.16 版本
## 安装指南
在前后端软件的 package.json 的依赖清单中引入本库: 在前后端软件的 package.json 的依赖清单中引入本库:
``` ```
npm install git+https://git.faronear.org/tic/tic.action#RELEASE_OR_BRANCH --save npm install git+https://git.faronear.org/tic/tic.action#RELEASE_OR_BRANCH --save
``` ```
## 2. Usage ## 用法
基本用法示例: 基本用法示例:
``` ```
let ticCrypto=require('tic.crypto') // 引用 let ticCrypto=require('tic.crypto') // 引用
let sw=ticCrypto.randomSecword() // 生成一个随机的助记词(即密语)。或者使用现成的密语。 let sw=ticCrypto.randomSecword() // 生成一个随机的助记词(即密语)。或者使用现成的密语。
@ -26,10 +45,10 @@ let kp=ticCrypto.secword2keypair(sw) // 把密语转换成公私钥
let address=ticCrypto.secword2address(sw) // 把密语转换成地址 let address=ticCrypto.secword2address(sw) // 把密语转换成地址
``` ```
## 3. API Specification ## 编程接口规范
|函数名|参数|说明 | 函数名 | 参数 | 备注 |
|-|-|-| | ------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
| hash | (data, option={hasher:'sha256', salt, input:'utf8', output:'hex'}) | 哈希算法。给 input(=utf8 | latin1 | ascii)格式的输入 data 加 salt 后,根据 hasher(=sha256 | md5 | sha1 | sha512 | ripemd160),输出 output(=hex | latin1 | base64 | buf)格式的哈希值。 | | hash | (data, option={hasher:'sha256', salt, input:'utf8', output:'hex'}) | 哈希算法。给 input(=utf8 | latin1 | ascii)格式的输入 data 加 salt 后,根据 hasher(=sha256 | md5 | sha1 | sha512 | ripemd160),输出 output(=hex | latin1 | base64 | buf)格式的哈希值。 |
| isHashable | (data) | | | isHashable | (data) | |
| isHash | | | | isHash | | |
@ -49,7 +68,7 @@ let address=ticCrypto.secword2address(sw) // 把密语转换成地址
| isAddress | | | | isAddress | | |
| pubkey2address | | | | pubkey2address | | |
| secword2seed | | | | secword2seed | | |
|randomSecword|(lang)|lang=[ 'CHINESE', 'ENGLISH', 'FRENCH', 'ITALIAN', 'JAPANESE', 'SPANISH' ] | randomSecword | (lang) | lang=[ 'CHINESE', 'ENGLISH', 'FRENCH', 'ITALIAN', 'JAPANESE', 'SPANISH' ] |
| randomSeckey | | | | randomSeckey | | |
| randomKeypair | | | | randomKeypair | | |
| randomString | | | | randomString | | |
@ -62,8 +81,5 @@ let address=ticCrypto.secword2address(sw) // 把密语转换成地址
| getString2Sign | | | | getString2Sign | | |
| rsaSign | | | | rsaSign | | |
| rsaVerify | | | | rsaVerify | | |
--- ---
## 4. References
+ 返回根文档: <https://git.faronear.org/tic/_tic/>