使用OpenZeppelin部署ERC20合约时遭遇BigNumber参数错误

这个错误的核心原因是部署合约时，构造函数所需的初始供应量参数为空，或者格式不符合Solidity uint256类型的BigNumber要求。以下是具体的排查和解决方法：

1. 检查部署时的参数输入 #

• 若使用Remix IDE部署：在部署面板的参数输入框中，必须填写有效的初始供应量数值。注意要匹配代币的小数位——比如发行1000个带18位小数的代币，需输入1000000000000000000000（或直接计算1000 * 10 ** 18），不能留空。
• 若使用Hardhat/Truffle部署：确保部署脚本中正确传入初始供应量参数，示例如下：

  // Hardhat部署脚本示例
  const PJToken = await ethers.getContractFactory("PJToken");
  // 发行1000个代币，自动处理18位小数
  const initialSupply = ethers.utils.parseUnits("1000", 18);
  const pjToken = await PJToken.deploy(initialSupply, "你的目标钱包地址");
  await pjToken.deployed();
  

2. 确认合约构造函数的参数定义 #

确保你的ERC20合约构造函数正确接收参数并执行铸造逻辑，基于OpenZeppelin的标准示例如下：

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@openzeppelin/contracts/token/ERC20/ERC20.sol";

contract PJToken is ERC20 {
    // 构造函数接收初始供应量和代币接收地址
    constructor(uint256 initialSupply, address recipient) ERC20("PJToken", "PJT") {
        _mint(recipient, initialSupply);
    }
}

如果你的构造函数仅需初始供应量参数，也要保证部署时传入的是合法的uint256数值，不能留空或传入非数字内容。

3. 避免BigNumber格式错误 #

• 禁止输入空字符串、字母或特殊字符，必须是纯数字。
• 数值不能超出uint256的范围（最大值为2^256 - 1）。
• 推荐使用ethers.js/web3.js的工具函数（如parseUnits）处理大数，避免手动计算小数位时出错。

内容的提问来源于stack exchange，提问作者Pratik Jussal