跳到主要内容

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

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

推特：@0xAA_Science

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

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

提示：本教程基于ethers.js 6.3.0 ，如果你使用的是v5，可以参考ethers.js v5文档。

这一讲，我们介绍BigInt类和单位转换。

BigInt​

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

创建BigInt实例​

你可以利用ethers.getBigInt()函数将string，number等类型转换为BigInt。

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

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

BigNumber

BigInt运算​

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

注意：数值带后缀n会自动转换成BigInt

// 运算
console.log("加法：", oneGwei + 1n)
console.log("减法：", oneGwei - 1n)
console.log("乘法：", oneGwei * 2n)
console.log("除法：", oneGwei / 2n)
// 比较
console.log("是否相等：", oneGwei == 1000000000n)

BigNumber运算

单位转换​

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

常用单位

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

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

    //代码参考：https://docs.ethers.org/v6/api/utils/#about-units
    console.group('\n2. 格式化：小单位转大单位，formatUnits');
    console.log(ethers.formatUnits(oneGwei, 0));
    // '1000000000'
    console.log(ethers.formatUnits(oneGwei, "gwei"));
    // '1.0'
    console.log(ethers.formatUnits(oneGwei, 9));
    // '1.0'
    console.log(ethers.formatUnits(oneGwei, "ether"));
    // `0.000000001`
    console.log(ethers.formatUnits(1000000000, "gwei"));
    // '1.0'
    console.log(ethers.formatEther(oneGwei));
    // `0.000000001` 等同于formatUnits(value, "ether")
    console.groupEnd();

    formatUnits

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

    // 3. 解析：大单位转小单位
    // 例如将ether转换为wei：parseUnits(变量, 单位),parseUnits默认单位是 ether
    // 代码参考：https://docs.ethers.org/v6/api/utils/#about-units
    console.group('\n3. 解析：大单位转小单位，parseUnits');
    console.log(ethers.parseUnits("1.0").toString());
    // { BigNumber: "1000000000000000000" }
    console.log(ethers.parseUnits("1.0", "ether").toString());
    // { BigNumber: "1000000000000000000" }
    console.log(ethers.parseUnits("1.0", 18).toString());
    // { BigNumber: "1000000000000000000" }
    console.log(ethers.parseUnits("1.0", "gwei").toString());
    // { BigNumber: "1000000000" }
    console.log(ethers.parseUnits("1.0", 9).toString());
    // { BigNumber: "1000000000" }
    console.log(ethers.parseEther("1.0").toString());
    // { BigNumber: "1000000000000000000" } 等同于parseUnits(value, "ether")
    console.groupEnd();

    parseUnits

总结​

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