Hardhat开发中ethers.parseUnits的正确使用姿势及版本迁移

admin 百科 2025-12-09 15

本文旨在解决hardhat项目中常见的`typeerror: cannot read properties of undefined (reading 'parseunits')`错误。该问题通常源于`ethers.js`库在v5和v6版本之间对工具函数api的重大变更。我们将详细解释这一变化，提供正确的`ethers v6`语法，并指导开发者如何检查和适配`ethers.js`版本，确保智能合约测试和交互的顺畅进行。

理解ethers.parseUnits错误

在Hardhat开发中，我们经常需要将人类可读的以太币数量（如"1 ether"）转换为EVM所需的最小单位（wei）。ethers.js库提供了parseUnits和parseEther等实用函数来完成这项任务。然而，当开发者在测试或脚本中尝试使用如下代码时，可能会遇到TypeError: Cannot read properties of undefined (reading 'parseUnits')的错误：

const { deployments, ethers, getNamedAccounts } = require("hardhat");
const { assert, expect } = require("chai");

describe("FundMe", async function () {
    let fundMe;
    let deployer;
    // 错误示例：在ethers v6环境中尝试使用v5语法
    const sendValue = ethers.utils.parseUnits("1", "ether"); 
    // 或者
    // const sendValue = ethers.utils.parseEther("1"); 
});

登录后复制

这个错误明确指出ethers.utils对象上没有parseUnits属性，这通常不是因为拼写错误，而是因为ethers.js库的版本发生了变化。

错误的根源：ethers.js版本差异

ethers.js是一个核心的以太坊JavaScript库，广泛用于Hardhat项目。在ethers.js的v5版本中，许多实用工具函数，如parseUnits、formatUnits、keccak256等，都被封装在ethers.utils命名空间下。因此，使用ethers.utils.parseUnits()是正确的。

然而，从ethers.js的v6版本开始，为了简化API和提高模块化程度，许多常用的工具函数被提升到了ethers对象的顶层。这意味着ethers.utils命名空间下的许多函数，包括parseUnits和parseEther，都直接成为了ethers对象的属性。

因此，当你的Hardhat项目依赖于ethers.js v6版本，但你的代码仍然沿用ethers v5的ethers.utils.parseUnits语法时，就会出现上述的TypeError。

Hardhat开发中ethers.parseUnits的正确使用姿势及版本迁移-第2张图片-佛山资讯网