{"content":{"title":"Hardhat 开发框架 - Solidity开发教程连载","body":"Decert.me 要连载教程了， [《Solidity 开发教程》](https://decert.me/tutorial/solidity/intro)  力求**系统**、**深入**的介绍 Solidity 开发， 同时这是一套交互式教程，你可以实时的修改教程里的合约代码并运行。\r\n\r\n本教程来自贡献者 [@Tiny熊](https://twitter.com/tinyxiong_eth)，让我们正式开始学习吧。\r\n\r\n如果你已经熟练使用 Hardhat ，可以直接跳到文末，参与挑战领取技能认证 NFT。\r\n\r\n---\r\n\r\nHardhat 提供了一个灵活且易于使用的环境，可以轻松地编写、测试和部署智能合约。类似的开发工具或框架还有： [Remix IDE](https://decert.me/tutorial/solidity/tools/remix/)， [Truffle ](https://decert.me/tutorial/solidity/tools/truffle_ganache/)， [Foundry](https://decert.me/tutorial/solidity/tools/foundry)， 目前最受欢迎的是 Hardhat 与 Foundry。\r\n\r\nHardhat 使用 Node 进行包管理，如果你熟悉 Node 及 Javascript， Hardhat 将非常简单上手。\r\n\r\n\r\n\r\n**Hardhat**还内置了**Hardhat 网络（Hardhat Node）**，它是为开发而设计的本地以太坊网络。 用来部署合约，运行测试和**调试代码**。\r\n\r\n\r\n\r\n在本文中，我们将介绍：\r\n\r\n\r\n\r\n1. 创建及配置Hardhat项目\r\n2. 编写智能合约\r\n3. Hardhat 编译合约\r\n4. 使用 [Ethers.js](https://learnblockchain.cn/ethers_v5/) 和为合约编写自动化测试\r\n5. 使用 `console.log()`调试 Solidity\r\n6. 使用 Hardhat 部署合约\r\n7. 使用 Hardhat Etherscan 进行开源验证。\r\n8. Hardhat 插件的使用\r\n\r\n\r\n\r\n本文对应的代码在：https://github.com/xilibi2003/training_camp_2/tree/main/w1_hardhat\r\n\r\n\r\n\r\n## 创建及配置Hardhat项目\r\n\r\n\r\n\r\nHardhat 构建在Node.js之上， 使用 Hardhat 要求我们在电脑先安装好Node.js (>= 16.0)， 环境准备可以参考[这里](https://learnblockchain.cn/docs/hardhat/tutorial/setting-up-the-environment.html)。\r\n\r\n先创建项目目录：\r\n\r\n```bash\r\nmkdir hardhat-tutorial\r\ncd hardhat-tutorial\r\n```\r\n\r\n初始化 Node 项目：\r\n\r\n```bash\r\nnpm init\r\n```\r\n\r\n\r\n\r\n安装 Hardhat :\r\n\r\n```bash\r\nnpm install --save-dev hardhat\r\n```\r\n\r\n\r\n\r\n在安装**Hardhat**的目录下运行：\r\n\r\n```bash\r\nnpx hardhat\r\n```\r\n\r\n\r\n\r\n使用键盘选择\"创建一个新的hardhat.config.js（`Create a JavaScript project`）\" ，然后回车。\r\n\r\n\r\n\r\n```markup{14}\r\n$ npx hardhat\r\n888    888                      888 888               888\r\n888    888                      888 888               888\r\n888    888                      888 888               888\r\n8888888888  8888b.  888d888 .d88888 88888b.   8888b.  888888\r\n888    888     \"88b 888P\"  d88\" 888 888 \"88b     \"88b 888\r\n888    888 .d888888 888    888  888 888  888 .d888888 888\r\n888    888 888  888 888    Y88b 888 888  888 888  888 Y88b.\r\n888    888 \"Y888888 888     \"Y88888 888  888 \"Y888888  \"Y888\r\n\r\n👷 Welcome to Hardhat v2.13.0 👷‍\r\n\r\n? What do you want to do? …\r\n❯ Create a JavaScript project\r\n  Create a TypeScript project\r\n  Create an empty hardhat.config.js\r\n  Quit\r\n```\r\n\r\n\r\n\r\n这个 JavaScript Hardhat 工程会默认下载 `hardhat-toolbox 插件`及一些常规设置：\r\n\r\n\r\n\r\n创建好的Hardhat工程包含文件有：\r\n\r\n- `contracts`：智能合约目录\r\n- `scripts` ：部署脚本文件\r\n- `test`：智能合约测试用例文件夹。\r\n- `hardhat.config.js`：配置文件，配置hardhat连接的网络及编译选项。\r\n\r\n\r\n\r\n## 编写合约\r\n\r\n合约开发推荐使用 VSCode 编辑器 + [solidity 插件](https://marketplace.visualstudio.com/items?itemName=NomicFoundation.hardhat-solidity)，在`contracts` 下新建一个合约文件 `Counter.sol` (`*.sol` 是 Solidity 合约文件的后缀名),  复制如下代码：\r\n\r\n```js title=”counter.sol“\r\n//SPDX-License-Identifier: MIT\r\npragma solidity ^0.8.0;\r\n\r\ncontract Counter {\r\n    uint counter;\r\n\r\n    constructor() {\r\n        counter = 0;\r\n    }\r\n\r\n    function count() public {\r\n        counter = counter + 1;\r\n    }\r\n\r\n    function get() public view returns (uint) {\r\n        return counter;\r\n    }\r\n}\r\n```\r\n\r\n接下来就可以编译这个合约了。\r\n\r\n\r\n\r\n### 使用OpenZepplin 等第三方库\r\n\r\n在编写合约时，尽量不要重复造轮子，基于优质开源的第三方库，不仅可以提交效率，还可以让我们的合约代码更安全，例如要开发一个 Token，可以用npm 安装OpenZepplin 库：\r\n\r\n```bash\r\nnpm install @openzeppelin/contracts --save-dev\r\n```\r\n\r\n\r\n\r\n然后在合约中 `import`  相应库中的合约文件及可。\r\n\r\n```solidity\r\npragma solidity ^0.8.0;\r\n\r\nimport \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\r\n\r\ncontract Token is ERC20 {\r\n  constructor(uint256 initialSupply) ERC20(\"Token Name\", \"Token Symbol\") {\r\n    _mint(msg.sender, initialSupply);\r\n  }\r\n}\r\n```\r\n\r\n\r\n\r\n## 编译合约\r\n\r\n\r\n\r\n`hardhat.config.js` 有默认的Solidity 编译器配置：\r\n\r\n```\r\nrequire(\"@nomicfoundation/hardhat-toolbox\");\r\n\r\n/** @type import('hardhat/config').HardhatUserConfig */\r\nmodule.exports = {\r\n  solidity: \"0.8.18\",\r\n};\r\n```\r\n\r\n\r\n\r\n因此我们直接编译合约即可，在终端中运行 `npx hardhat compile` 。 `compile`任务是内置任务之一。\r\n\r\n```\r\n$ npx hardhat compile\r\nCompiling 1 file with 0.8.18\r\nCompilation finished successfully\r\n```\r\n\r\n合约已成功编译了。\r\n\r\n\r\n\r\n成功编译后，会在 `artifacts/contracts/`  目录下生成`Counter.json` 和 build-info， `Counter.json`包含了智能合约的 ABI 、字节码（Bytecode）等。\r\n\r\n\r\n\r\n:::tip\r\n\r\n智能合约的 **ABI（Application Binary Interface）**信息，其中包括了合约的函数、事件等接口信息。这个文件通常会在与其他合约交互时使用，因为它可以被其他合约和 DApp 使用。\r\n\r\n`Bytecode ` 是部署合约所需的字节码（也称为创建时字节码），部署合约时，就是把该字节码作为交易的输入数据发送链上。:::\r\n\r\n:::\r\n\r\n\r\n\r\n## 编写测试用例\r\n\r\n为智能合约编写自动化测试至关重要，因为事关用户资金。 \r\n\r\n在我们的测试中，使用 Harhdat 内置的网络，使用[ethers.js](https://learnblockchain.cn/ethers_v5/)与前面的合约进行交互，并使用 [Mocha](https://mochajs.org/) 作为测试运行器。\r\n\r\n\r\n\r\n在项目 `test`下，并创建一个名为`Counter.js`的新文件：\r\n\r\n```js title=\"Counter.js\"\r\nconst { ethers } = require(\"hardhat\");\r\nconst { expect } = require(\"chai\");\r\n\r\nlet counter;\r\n\r\ndescribe(\"Counter\", function () {\r\n  async function init() {\r\n    const [owner, otherAccount] = await ethers.getSigners();\r\n    const Counter = await ethers.getContractFactory(\"Counter\");\r\n    counter = await Counter.deploy();\r\n    await counter.deployed();\r\n    console.log(\"counter:\" + counter.address);\r\n  }\r\n\r\n  before(async function () {\r\n    await init();\r\n  });\r\n\r\n  // \r\n  it(\"init equal 0\", async function () {\r\n    expect(await counter.get()).to.equal(0);\r\n  });\r\n\r\n  it(\"add 1 equal 1\", async function () {\r\n    let tx = await counter.count();\r\n    await tx.wait();\r\n    expect(await counter.get()).to.equal(1);\r\n  });\r\n\r\n});\r\n\r\n```\r\n\r\n\r\n\r\n在终端上运行`npx hardhat test`。 你应该看到以下输出：\r\n\r\n\r\n\r\n```\r\n> npx hardhat test\r\n\r\n\r\n  Counter\r\ncounter:0x5FbDB2315678afecb367f032d93F642f64180aa3\r\n    ✔ init equal 0\r\n    ✔ add 1 equal 1\r\n\r\n  2 passing (1s)\r\n```\r\n\r\n\r\n\r\n\r\n\r\n这意味着测试通过了。 现在我们解释主要代码：\r\n\r\n\r\n\r\n```js\r\n  const Counter = await ethers.getContractFactory(\"Counter\");\r\n```\r\n\r\nethers.js中的`ContractFactory`是用于部署新智能合约的抽象，因此此处的`Counter`是用来实例合约的工厂。\r\n\r\n\r\n\r\n```js\r\ncounter = await Counter.deploy();\r\n```\r\n\r\n在`ContractFactory`上调用`deploy()`将启动部署，并返回解析为`Contract`的`Promise`。 该对象包含了智能合约所有函数的方法。\r\n\r\n```\r\nlet tx = await counter.count();\r\nawait tx.wait();\r\n```\r\n\r\n\r\n\r\n在`counter` 上调用合约方法， 并等待交易执行完毕。\r\n\r\n注意，默认情况下， `ContractFactory`和`Contract`实例连接到第一个[签名者（Singer）](https://learnblockchain.cn/ethers_v5/)。\r\n\r\n若需要使用其他的签名这， 可以使用[合约实例connect 到另一个签名者](https://learnblockchain.cn/ethers_v5/api/contract/example/#example-erc-20-contract--methods)， 如 `counter.connect(otherAccount)`\r\n\r\n```js\r\nexpect(await counter.get()).to.equal(0);\r\n```\r\n\r\n判断相等，我们使用[Chai](https://www.chaijs.com/)，这是一个断言库。 这些断言函数称为“匹配器”，在此实际上使用的“匹配器”来自[Hardhat Chai Matchers](https://hardhat.org/hardhat-runner/plugins/nomicfoundation-hardhat-chai-matchers)。\r\n\r\n\r\n\r\n## 使用 Console.log  调试合约\r\n\r\n在**Hardhat Node **节点上运行合约和测试时，你可以在Solidity代码中调用`console.log()`打印日志信息和合约变量，可以方便我们调试代码。\r\n\r\n在合约代码中导入**Hardhat **的`console.log`就可以使用它。\r\n\r\n\r\n\r\n```js {3}\r\npragma solidity ^0.8.0;\r\n\r\nimport \"hardhat/console.sol\";\r\n\r\ncontract Counter {\r\n    uint public counter;\r\n\r\n    constructor(uint x) {\r\n        counter = x;\r\n    }\r\n\r\n    function count() public {\r\n        counter = counter + 1;\r\n        console.log(\"counter is %s \", counter);\r\n    }\r\n\r\n}\r\n```\r\n\r\n\r\n\r\n就像在JavaScript中使用一样, 将一些`console.log`添加函数中，运行测试时，将输出日志记录：\r\n\r\n```\r\n> npx hardhat test\r\n\r\n  Counter\r\ncounter:0x5FbDB2315678afecb367f032d93F642f64180aa3\r\n    ✔ init equal 0\r\ncounter is 1\r\n    ✔ add 1 equal 1 (38ms)\r\n\r\n\r\n  2 passing (1s)\r\n```\r\n\r\n\r\n\r\n可以在[这里](https://learnblockchain.cn/docs/hardhat/hardhat-network/#console-log)了解更多 console.log 。 \r\n\r\n\r\n\r\n## 部署合约\r\n\r\n 其实我们在测试时， 合约已经部署到了Hardhat 内置的网络上，部署合约我们需要编写一个部署脚本。\r\n\r\n\r\n\r\n在`scripts`文件夹，新建一个`deploy.js` 用来写部署脚本，部署脚本其实和前面测试时 `init` 函数类似：\r\n\r\n```js\r\nconst { ethers } = require(\"hardhat\");\r\n\r\nasync function main() {\r\n\r\n   const Counter = await ethers.getContractFactory(\"Counter\");\r\n   const counter = await Counter.deploy();\r\n   await counter.deployed();\r\n\r\n  console.log(\"Counter address:\", counter.address);\r\n}\r\n\r\nmain();\r\n```\r\n\r\n\r\n\r\n运行 `npx hardhat run scripts/deploy.js` 时， 可以合约会部署到Hardhat 内置网络上。\r\n\r\n```\r\n> npx hardhat run scripts/deploy.js\r\nCounter address: 0x5FbDB2315678afecb367f032d93F642f64180aa3\r\n\r\n```\r\n\r\n\r\n\r\n\r\n\r\n为了在运行任何任务时指示**Hardhat**连接到特定的EVM网络，可以使用`--network`参数。 像这样：\r\n\r\n```js\r\nnpx hardhat run scripts/deploy.js --network <network-name>\r\n```\r\n\r\n\r\n\r\n`network-name` 需要在 `hardhat.config.js` 文件中进行配置：\r\n\r\n```js\r\nrequire(\"@nomicfoundation/hardhat-toolbox\");\r\n\r\n// 填入自己的私钥或助记词，\r\nconst PRIVATE_KEY1 = \"0x.... YOUR PRIVATE KEY1\";\r\nconst PRIVATE_KEY2 = \"0x....  YOUR PRIVATE KEY1\";\r\nconst Mnemonic = \"YOUR Mnemonic\";\r\n\r\n\r\nmodule.exports = {\r\n  solidity: \"0.8.9\", // solidity的编译版本\r\n  networks: {\r\n    goerli: {\r\n      url: \"https://eth-goerli.api.onfinality.io/public\",\r\n      accounts: [PRIVATE_KEY1,PRIVATE_KEY2],\r\n      chainId: 5,\r\n    },\r\n    \r\n     mumbai: {\r\n      url: \"https://endpoints.omniatech.io/v1/matic/mumbai/public\",\r\n      accounts: {\r\n        mnemonic: Mnemonic,\r\n      },\r\n      chainId: 80001,\r\n    },\r\n  }\r\n};\r\n```\r\n\r\n\r\n\r\n以上配置了两个网络，一个是以太坊测试网 `goerli`， 一个是 Polygon 测试网`mumbai`， 我们可以在 https://chainlist.org 找到每个网络的节点 URL 及 chainID。\r\n\r\n在网络配置中，需要提供提交交易账号， 可以通过私钥或`助记词`  进行配置，这里配置的账号（需要提前充币进入到账号中），在hardhat 脚本中（测试及部署脚本）调用`getSigners` 即可获得：\r\n\r\n```\r\nconst [owner, otherAccount] = await ethers.getSigners();\r\n```\r\n\r\n\r\n\r\n一个私钥对应一个Singer，助记词则对应无数个 Singer ， 为每个项目生成一个独立的账号是比较推荐的做法，使用 [ChainTool 开源工具](https://chaintool.tech/generateWallet) 可以生成账号。\r\n\r\n:::tip\r\n\r\n助记词可以推导出无数了私钥，可参考：[BIP39](https://learnblockchain.cn/2018/09/28/hdwallet)\r\n\r\n:::\r\n\r\n\r\n\r\n另外要注意， 在 Goerli 上进行部署，需要将Goerli-ETH发送到将要进行部署的地址中。 可以从水龙头免费或一些测试币，这是Goerli的一个水龙头:\r\n\r\n- [Alchemy Goerli Faucet](https://goerlifaucet.com/)\r\n\r\n\r\n\r\n最后运行：\r\n\r\n```\r\nnpx hardhat run scripts/deploy.js --network goerli\r\n```\r\n\r\n如果一切顺利，你应该看到已部署的合约地址。\r\n\r\n\r\n\r\n## 代码开源验证\r\n\r\n\r\n\r\n智能代码开源会增加了合约的透明度和可靠性，是项目建立信任很重要的一个步骤。\r\n\r\n在 `hardhat-toolbox` 工具箱里，包含了 [hardhat-etherscan](https://hardhat.org/hardhat-runner/plugins/nomiclabs-hardhat-etherscan) 插件用于验证已经部署到区块链网络上的智能合约代码与源代码是否匹配，在完成验证后在区块链浏览器中合约标签上会出现✅， 如图：\r\n\r\n\r\n\r\n![image-20230313104044517](https://img.learnblockchain.cn/pics/20230313104045.png)\r\n\r\n\r\n\r\n在部署智能合约时，合约字节码会被写入到区块链中，这意味着其他人无法检查合约的源代码。代码验证的过程是将已部署合约的字节码与原始Solidity代码再次编译后与部署的字节码进行比较，确保它们是一致的。\r\n\r\n\r\n\r\n相比在区块链浏览器上上传代码验证， hardhat-etherscan 有很多优点，否则会自动使用 hardhat config 值设置的编译器选项，并且当代码中引用的第三方库或合约， hardhat-etherscan 能自动探测并处理。\r\n\r\n\r\n\r\n开源验证的步骤是：\r\n\r\n1. 安装 `hardhat-toolbox`  或 `hardhat-etherscan` ， 这一步我们这里已经完成，因为在初始化项目的时候安装了 `hardhat-toolbox`  ， 如果没有安装，可以使用以下命令安装\r\n\r\n   ```\r\n   npm install --save-dev @nomiclabs/hardhat-etherscan\r\n   ```\r\n\r\n   \r\n\r\n2. 在 `hardhat.config.js` 中配置您的 Etherscan API 密钥和网络设置，例如：\r\n\r\n```js\r\n  require(\"@nomicfoundation/hardhat-toolbox\");\r\n  或\r\n  // require(\"@nomiclabs/hardhat-etherscan\");\r\n  \r\n  etherscan: {\r\n    apiKey: \"\"\r\n  },\r\n  \r\n \r\n```\r\n\r\n> 如何获取 Etherscan API 密钥？\r\n> 1. 访问部署网络<b>对应主网</b>的 Etherscan 网站，并注册一个账号（如果还没有账号的话）。\r\n> 2. 登录你的账号并进入 Etherscan 的「我的帐户」页面。\r\n>3. 点击页面左侧的「API-KEYs」标签页。\r\n>4. 在页面上方的「Create New API KEY」部分，输入 API 密钥的名称和描述，然后选择需要访问的 API 权限。\r\n> 5. 点击「Generate」按钮来生成 API 密钥。\r\n\r\n\r\n\r\n3. 执行验证命令：\r\n\r\n   ```\r\n   npx hardhat verify <deployed-contract-address> \"参数(若有)\" --network <network-name> \r\n   ```\r\n   \r\n   例如，要在 goerli  网络上验证合约，可以运行以下命令：\r\n   \r\n   ```\r\n   npx hardhat verify 0x..... --network goerli\r\n   ```\r\n\r\n该命令会为我们上传合约代码并验证其源代码。如果一切顺利（网络顺畅的话），在 Etherscan 上看到的合约被成功验证。\r\n\r\n\r\n\r\n## Hardhat 插件（Plugin）的使用\r\n\r\n上面代码开源验证时，使用了`hardhat-etherscan`插件，其实也可以使用 [hardhat-verify](https://hardhat.org/hardhat-runner/plugins/nomicfoundation-hardhat-verify#hardhat-verify) 插件。\r\n\r\n在 https://hardhat.org/hardhat-runner/plugins 链接可以找到当前使用较多的插件，例如：[hardhat-gas-reporter](https://www.npmjs.com/package/hardhat-gas-reporter) 可以对部署合约及函数执行的Gas消耗给出报告；[solidity-coverage](https://www.npmjs.com/package/solidity-coverage) 可以对测试覆盖率给出报告。\r\n\r\n\r\n\r\n要使用一个插件通常要：\r\n\r\n1. 用 Node.js 包管理先安装相应的插件\r\n\r\n2. 在 **hardhat.config.js** 文件中引入插件，以便Hardhat 能加载上对应的插件。\r\n\r\n\r\n\r\n\r\n\r\n## 参考文档\r\n\r\n\r\n\r\n示例非常简单， 更多使用方法，可参考文档：\r\n\r\n- Hardhat 官方文档：https://hardhat.org/getting-started/\r\n\r\n- Hardhat 中文文档：https://learnblockchain.cn/docs/hardhat/getting-started/\r\n\r\n- Harhdat 入门教程：https://learnblockchain.cn/docs/hardhat/tutorial/\r\n\r\n- Ethers.js 文档：https://learnblockchain.cn/ethers_v5/\r\n\r\n  \r\n\r\n## 小结\r\n\r\n本文介绍了 Hardhat 开发框架的一些基本概念和使用方法，了解了如何使用 Hardhat 进行合约编译、部署、调试及测试，在开发中要**经常查看文档**，了解更多Hardhat 用法。\r\n\r\n--- \r\n\r\nHardhat 的使用你掌握了吗？来[这里](https://decert.me/quests/10003)挑战一下看看，挑战完成你就可以领取到一枚技能认证 NFT。\r\n\r\n[![码一个未来](https://img.learnblockchain.cn/pics/20230511102508.png!/scale/40)](https://decert.me/quests/10003)\r\n\r\n--- \r\n原教程链接：https://decert.me/tutorial/solidity/tools/hardhat \r\n[Decert.me](https://decert.me/challenges) -- 码一个未来"},"author":{"user":"https://learnblockchain.cn/people/13917","address":null},"history":"QmdDUpZPk29jfGLVDZ1oN9MkXmJz2mg3Ee8H5tfEV3TL9H","timestamp":1683776071,"version":1}