跳到主要内容

Ethers极简入门: 10. BigNumber和单位转换

我最近在重新学ethers.js,巩固一下细节,也写一个WTF Ethers极简入门,供小白们使用。

推特@0xAA_Science

WTF Academy社群: 官网 wtf.academy | WTF Solidity教程 | discord | 微信群申请

所有代码和教程开源在github: github.com/WTFAcademy/WTFEthers


这一讲,我们介绍BigNumber类和单位转换。

BigNumber

以太坊中,许多计算都对超出JavaScript整数的安全值(js中最大安全整数为9007199254740991)。因此,ethers.js使用BigNumber类安全地对任何数量级的数字进行数学运算。在ethers.js中,大多数需要返回值的操作将返回BigNumber,而接受值的参数也会接受它们。

创建BigNumber实例

你可以利用ethers.BigNumber.from()函数将stringnumberBigNumber等类型转换为BigNumber

注意,超过js最大安全整数的数值将不能转换。

const oneGwei = ethers.BigNumber.from("1000000000"); // 从十进制字符串生成
console.log(oneGwei)
console.log(ethers.BigNumber.from("0x3b9aca00")) // 从hex字符串生成
console.log(ethers.BigNumber.from(1000000000)) // 从数字生成
// 不能从js最大的安全整数之外的数字生成BigNumber,下面代码会报错
// ethers.BigNumber.from(Number.MAX_SAFE_INTEGER);
console.log("js中最大安全整数:", Number.MAX_SAFE_INTEGER)

BigNumber

BigNumber运算

BigNumber支持很多运算,例如加减乘除、取模mod,幂运算pow,绝对值abs等运算:

// 运算
console.log("加法:", oneGwei.add(1).toString())
console.log("减法:", oneGwei.sub(1).toString())
console.log("乘法:", oneGwei.mul(2).toString())
console.log("除法:", oneGwei.div(2).toString())
// 比较
console.log("是否相等:", oneGwei.eq("1000000000"))

BigNumber运算

单位转换

在以太坊中,1 ether等于10^18 wei。下面列出了一些常用的单位:

常用单位

在应用中,我们经常将数值在用户可读的字符串(以ether为单位)和机器可读的数值(以wei为单位)之间转换。例如,钱包可以为用户界面指定余额(以ether为单位)和gas价格(以gwei为单位),但是在发送交易时,两者都必须转换成以wei为单位的数值。ethers.js提供了一些功能函数,方便这类转换。

  • formatUnits(变量, 单位):格式化,小单位转大单位,比如wei -> ether,在显示余额时很有用。参数中,单位填位数(数字)或指定的单位(字符串)。

    console.group('\n2. 格式化:小单位转大单位,formatUnits');
    console.log(ethers.utils.formatUnits(oneGwei, 0));
    // '1000000000'
    console.log(ethers.utils.formatUnits(oneGwei, "gwei"));
    // '1.0'
    console.log(ethers.utils.formatUnits(oneGwei, 9));
    // '1.0'
    console.log(ethers.utils.formatUnits(oneGwei, "ether"));
    // `0.000000001`
    console.log(ethers.utils.formatUnits(1000000000, "gwei"));
    // '1.0'
    console.log(ethers.utils.formatEther(oneGwei));
    // `0.000000001` 等同于formatUnits(value, "ether")
    console.groupEnd();

    formatUnits

  • parseUnits:解析,大单位转小单位,比如ether -> wei,在将用户输入的值转为wei为单位的数值很有用。参数中,单位填位数(数字)或指定的单位(字符串)。

    // 3. 解析:大单位转小单位
    // 例如将ether转换为wei:parseUnits(变量, 单位)
    console.group('\n3. 解析:大单位转小单位,parseUnits');
    console.log(ethers.utils.parseUnits("1.0").toString());
    // { BigNumber: "1000000000000000000" }
    console.log(ethers.utils.parseUnits("1.0", "ether").toString());
    // { BigNumber: "1000000000000000000" }
    console.log(ethers.utils.parseUnits("1.0", 18).toString());
    // { BigNumber: "1000000000000000000" }
    console.log(ethers.utils.parseUnits("1.0", "gwei").toString());
    // { BigNumber: "1000000000" }
    console.log(ethers.utils.parseUnits("1.0", 9).toString());
    // { BigNumber: "1000000000" }
    console.log(ethers.utils.parseEther("1.0").toString());
    // { BigNumber: "1000000000000000000" } 等同于parseUnits(value, "ether")
    console.groupEnd();

    parseUnits

总结

这一讲,我们介绍了BigNumber类,以太坊中的常用单位,以及单位转换。