Cipherem
Cipjs-unit
cipjs-unit
包是为 Cipherem 区块链设计的实用程序库。它提供了在加密货币的不同单位之间进行转换的功能,类似于 ethjs-unit在以太坊中的工作方式。该库允许开发人员轻松处理最小单位(wei)和较大单位(如 cip
、kwei
、mwei
等)之间的转换。
cipjs-unit
Cipherem 链的 cipjs-unit
是 ethjs-unit
包的克隆,一个用于处理以太坊单位转换的简单模块,适用于 Cipherem 区块链。
安装
要安装 cipjs-unit
,请使用以下命令:
npm install --save cipjs-unit
用法
以下是一个基本用法示例:
const unit = require('cipjs-unit');
var val1 = unit.toWei(249824778, 'cip');
// result: <BN ...> 249824778000000000000000000
var val2 = unit.fromWei('249824778000000000000000000', 'cip');
// result: '249824778'
关于
cipjs-unit 是 cipweb3.js 库的一个端口,专门用于处理各种类型的 Cipherem 货币单位之间的转换。toWei 方法返回一个BN实例,而 fromWei 总是返回一个字符串数字。
无定形数据格式
cipjs-unit 使用 number-to-bn 模块将所有数值(十六进制或其他)的格式改为易理解的 bn.js 数字实例。
可用方法和对象
- unitmap: { unitName: singleUnitWeiValue, ... }
- getValueOfUnit: <Function (unit) : (BN)>
- toWei: <Function (value, unit) : (BN)>
- fromWei: <Function (value, unit) : (String)>
支持的单位
'wei': '1',
'kwei': '1000',
'Kwei': '1000',
'babbage': '1000',
'femtoether': '1000',
'mwei': '1000000',
'Mwei': '1000000',
'lovelace': '1000000',
'picoether': '1000000',
'gwei': '1000000000',
'Gwei': '1000000000',
'shannon': '1000000000',
'nanoether': '1000000000',
'nano': '1000000000',
'szabo': '1000000000000',
'microether': '1000000000000',
'micro': '1000000000000',
'finney': '1000000000000000',
'milliether': '1000000000000000',
'milli': '1000000000000000',
'cip': '1000000000000000000',
'kether': '1000000000000000000000',
'grand': '1000000000000000000000',
'mether': '1000000000000000000000000',
'gether': '1000000000000000000000000000',
'tether': '1000000000000000000000000000000'
为什么使用 BN.js?
ethjs
采用了在所有模块中使用 BN.js
的策略,原因如下:
- 比替代选项更轻量(BigNumber.js)
- 比大多数替代方案更快(请参阅基准)
- 由以太坊基金会在所有
ethereumjs
存储库中使用 - 许多以太坊包的关键JS依赖性(例如,elliptic)
- 不支持小数或浮点,确保更高的精度(以太坊区块链不支持浮点值或十进制数)
贡献
请通过提交问题和拉取请求来帮助改进生态系统。我们需要所有帮助,以建立最佳的代码规范和实用程序。我们遵循 AirBNB 的代码规范和 Unix 哲学。
指南
您可以在我们的指南中找到更多关于使用 cipjs-unit
和根据您的需求进行定制的详细信息:
- 开发者指南: 为
cipjs-unit
做贡献,撰写报道和更新。
帮助我们
总有很多工作要做,我们有很多规则要遵守。请你以所能采取的任何方式提供帮助:
- 创建、增强和为cipjs规则除错(请参阅我们的“使用规则”指南)。
- 改进文档。
- 参与任何未决问题的讨论或提交请求。
- 提出新问题,提出让
cipjs-unit
更好的想法,提交请求,向我们展示您的想法是如何运作的。 - 为任何内容添加新的测试。
- 创建或为生态系统工具做出贡献,如编码模块或合同。
- 传播消息。
我们通过问题和请求进行沟通交流。
如有任何问题或疑问,请加入我们的 Discord 服务器 以获得支持。我们的社区和支持团队可以帮助您解决您可能面临的任何问题。