Cipherem

Cipjs-unit

cipjs-unit 包是为 Cipherem 区块链设计的实用程序库。它提供了在加密货币的不同单位之间进行转换的功能,类似于 ethjs-unit在以太坊中的工作方式。该库允许开发人员轻松处理最小单位(wei)和较大单位(如 cipkweimwei 等)之间的转换。

cipjs-unit

Cipherem 链的 cipjs-unitethjs-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规则除错(请参阅我们的“使用规则”指南)。
  • 改进文档。
  • 参与任何未决问题的讨论或提交请求。
  • 提出新问题,提出让 cipjs-unit 更好的想法,提交请求,向我们展示您的想法是如何运作的。
  • 为任何内容添加新的测试。
  • 创建或为生态系统工具做出贡献,如编码模块或合同。
  • 传播消息。

我们通过问题和请求进行沟通交流。

如有任何问题或疑问,请加入我们的 Discord 服务器 以获得支持。我们的社区和支持团队可以帮助您解决您可能面临的任何问题。


Copyright © 2024