From a2d9cb4550fdee8af1a26ff2e5c8ab557241bb61 Mon Sep 17 00:00:00 2001
From: bobeu <35783747+bobeu@users.noreply.github.com>
Date: Mon, 19 Feb 2024 13:41:31 +0100
Subject: [PATCH] Completed hardhat/web3v4 tutorial (#6806)

* Completed hardhat/web3v4 tutorial

* Create _category_.yml

* few typos, added links, and command to run the test.

* typo 'incuding' for 'including'

---------

Co-authored-by: Santiago Trujillo Zuluaga <santiago@chainsafe.io>
---
 .../guides/hardhat_tutorial/_category_.yml    |   5 +
 .../hardhat_tutorial/asset/artifacts.png      | Bin 0 -> 12011 bytes
 .../guides/hardhat_tutorial/asset/image_2.png | Bin 0 -> 3198 bytes
 .../guides/hardhat_tutorial/asset/image_3.png | Bin 0 -> 12123 bytes
 docs/docs/guides/hardhat_tutorial/index.md    | 304 ++++++++++++++++++
 5 files changed, 309 insertions(+)
 create mode 100644 docs/docs/guides/hardhat_tutorial/_category_.yml
 create mode 100644 docs/docs/guides/hardhat_tutorial/asset/artifacts.png
 create mode 100644 docs/docs/guides/hardhat_tutorial/asset/image_2.png
 create mode 100644 docs/docs/guides/hardhat_tutorial/asset/image_3.png
 create mode 100644 docs/docs/guides/hardhat_tutorial/index.md

diff --git a/docs/docs/guides/hardhat_tutorial/_category_.yml b/docs/docs/guides/hardhat_tutorial/_category_.yml
new file mode 100644
index 00000000000..dfd158abb00
--- /dev/null
+++ b/docs/docs/guides/hardhat_tutorial/_category_.yml
@@ -0,0 +1,5 @@
+label: '⛑️ Hardhat Tutorial'
+collapsible: true
+collapsed: true
+link: null
+position: 2
diff --git a/docs/docs/guides/hardhat_tutorial/asset/artifacts.png b/docs/docs/guides/hardhat_tutorial/asset/artifacts.png
new file mode 100644
index 0000000000000000000000000000000000000000..55271c0126fc36a7d1c81abc1f2548000e3800bf
GIT binary patch
literal 12011
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

literal 0
HcmV?d00001

diff --git a/docs/docs/guides/hardhat_tutorial/asset/image_2.png b/docs/docs/guides/hardhat_tutorial/asset/image_2.png
new file mode 100644
index 0000000000000000000000000000000000000000..1bcb5160790aa35a316a3cb9c785dbe61a65da3c
GIT binary patch
literal 3198
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
J_@8}M@=ssBm^=Ug

literal 0
HcmV?d00001

diff --git a/docs/docs/guides/hardhat_tutorial/asset/image_3.png b/docs/docs/guides/hardhat_tutorial/asset/image_3.png
new file mode 100644
index 0000000000000000000000000000000000000000..9785cac83e0a00018c00f6a0d24a6c6f458e7246
GIT binary patch
literal 12123
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

literal 0
HcmV?d00001

diff --git a/docs/docs/guides/hardhat_tutorial/index.md b/docs/docs/guides/hardhat_tutorial/index.md
new file mode 100644
index 00000000000..74d92b868ef
--- /dev/null
+++ b/docs/docs/guides/hardhat_tutorial/index.md
@@ -0,0 +1,304 @@
+---
+sidebar_position: 1
+sidebar_label: Web3.js v4 with Hardhat 
+---
+
+# Using Web3 With Hardhat
+
+## Introduction
+Following the recent compatibility update of Hardhat plugin [hardhat-web3-v4](https://hardhat.org/hardhat-runner/plugins/nomicfoundation-hardhat-web3-v4), `Web3.Js` is now available to use as plugin in Hardhat.
+
+This tutorial will guide you through using Web3js as a plugin to interact with the Blockchain.
+
+## Pre-requisite
+This tutorial assumes you have previous knowledge of writing Smart contracts, and are convenient working with Javascript/Typescript. You should have [NodeJS](https://nodejs.org/en) version greater than v16 installed.
+
+:::note
+To install dependencies, we will use `NPM`. 
+:::
+
+## Steps
+- [Initiate a Hardhat project](#initiate-a-hardhat-project)
+- [Install required dependencies (including `hardhat-web3-v4`)](#install-required-dependencies-including-hardhat-web3-v4)
+- [Write the Smart Contract](#write-the-smart-contract)
+- [Compile and deploying the contract](#compile-test-and-deploy-the-contract)
+- [Testing and interacting with the contract](#testing-and-interacting-with-the-contract)
+
+### Initiate a Hardhat project
+Create a new project folder and navigate into it.
+
+```bash
+mkdir myproject
+```
+
+```bash
+cd myproject
+```
+
+Install and instantiate Hardhat in the current project.
+
+```bash
+npm install hardhat
+```
+
+```bash
+npx hardhat init
+```
+
+![images](./asset/image_3.png)
+
+### Install required dependencies (including `hardhat-web3-v4`)
+
+Select `Typescript` and `Yes` for the rest of the options.
+You will be prompted to install the required dependencies. Reply `yes` to complete the installation.
+To include the `Hardhat-web3-v4` plugin, we will install it via `npm`. 
+
+```bash
+npm install --save-dev @nomicfoundation/hardhat-web3-v4 'web3@4'
+```
+
+This will add Web3.Js to your project by including it in the 'node_modules' folder. To extend the Hardhat functionality with this plugin, we have to import the `web3-v4 plugin` in the Hardhat configuration file `hardhat.config.ts`. Import this at the top of the config file.
+
+```ts
+import { HardhatUserConfig } from "hardhat/config";
+import "@nomicfoundation/hardhat-toolbox";
+import "@nomicfoundation/hardhat-web3-v4";  // <================ 
+
+const config: HardhatUserConfig = {
+  solidity: "0.8.19",
+};
+
+export default config;
+
+```
+
+By default, `hardhat-toolbox` is added to the file. You will need to explicity invoke the plugin. This will modify the Hardhat Run-time Environment - HRE and to include both the Web3 class and an instantiated web3 object. With the latter, you get a modified ready-to-use web3 object can comes with an initialized local/Hardhat provider. The object will be available to use anywhere in the project such as testing and deployment files.
+
+### Write the Smart Contract
+When you start a new project, Hardhat provides a sample `Lock` contracts. Please refer to the contract in `myproject/contracts/Lock.sol` file.
+
+```ts
+  // SPDX-License-Identifier: UNLICENSED
+  pragma solidity ^0.8.9;
+
+  // Uncomment this line to use console.log
+  // import "hardhat/console.sol";
+
+  contract Lock {
+    uint public unlockTime;
+    address payable public owner;
+
+    event Withdrawal(uint amount, uint when);
+
+    constructor(uint _unlockTime) payable {
+      require(
+        block.timestamp < _unlockTime,
+        "Unlock time should be in the future"
+      );
+
+      unlockTime = _unlockTime;
+      owner = payable(msg.sender);
+    }
+
+    function withdraw() public {
+      // Uncomment this line, and the import of "hardhat/console.sol", to print a log in your terminal
+      // console.log("Unlock time is %o and block timestamp is %o", unlockTime, block.timestamp);
+
+      require(block.timestamp >= unlockTime, "You can't withdraw yet");
+      require(msg.sender == owner, "You aren't the owner");
+
+      emit Withdrawal(address(this).balance, block.timestamp);
+
+      owner.transfer(address(this).balance);
+    }
+  }
+
+```
+
+`Lock.sol` is a simple timeLock contract capable of accepting any amount of `Ether` at deployment while expecting one parameter that will be assigned to a state variable when deployed. The `withdraw` function allows only the address marked as `owner` to withdraw the total contract balance only if the 'unlockTime' is not in the future.
+
+### Compile, test and deploy the contract
+- Compile and deploying the contract
+
+```bash
+npx hardhat compile
+```
+Running the above command will generate a folder called `artifacts` containing the build information and the compiled contracts. From this directory, we will require the jasonInterface otherwise called the Application Binary Interface - ABI during testing and deployment.
+
+![images](./asset/artifacts.png)
+
+To deploy the contract, we will modify the `script/deploy.ts` file as shown below.
+
+First, we import the initialized web3 object from hardhat. Next we get the artifacts.
+
+```ts
+import { web3 } from "hardhat";
+import artifacts from "../artifacts/contracts/Lock.sol/Lock.json";
+
+async function main() {
+ 
+}
+
+// We recommend this pattern to be able to use async/await everywhere
+// and properly handle errors.
+main().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});
+
+```
+
+Inside the main function, we prepare the deployment using a few of the web3.Js functionalities such as the `.utils` and `.eth` modules.
+
+```ts
+async function main() {
+  const currentTimestampInSeconds = Math.round(Date.now() / 1000);
+  const unlockTime = currentTimestampInSeconds + 60;
+
+  const lockedAmount = web3.utils.toWei("0.001", 'ether');
+
+  const [deployer] = await web3.eth.getAccounts();
+  const lockContract = new web3.eth.Contract(artifacts.abi);
+  const rawContract = lockContract.deploy({
+    data: artifacts.bytecode,
+    arguments: [unlockTime],
+  });
+
+  const lock = await rawContract.send({
+    from: deployer,
+    gasPrice: "10000000000",
+    value: lockedAmount.toString()
+  });
+
+  console.log(
+    `Lock with ${web3.utils.toWei(
+      lockedAmount,
+      'ether'
+    )}ETH and unlock timestamp ${unlockTime} deployed to ${lock.options.address}`
+  );
+}
+
+// We recommend this pattern to be able to use async/await everywhere
+// and properly handle errors.
+main().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});
+```
+Running the following command will deploy the `Lock` contract to a local Blockchain built into Hardhat. We use Web3.Js to talk to the Blockchain to broadcast our smart contract data to the network. 
+
+```bash
+npx hardhat run scripts/deploy.ts
+```
+
+### Testing and interacting with the contract
+
+In the previous steps, we compiled and deployed the contract to the local Blockchain network. It's time to test our contract ensuring it performs as expected.  Since we used Web3.Js to talk to the Blockchain to broadcast and save our data, we will use same protocol to view and modify the data.
+
+In the `myproject/test/Lock.ts` file, replace the content with the code below.
+
+```ts
+  import {
+    time,
+    loadFixture,
+  } from "@nomicfoundation/hardhat-toolbox/network-helpers";
+  import { expect } from "chai";
+  import { web3 } from "hardhat";
+  import artifacts from "../artifacts/contracts/Lock.sol/Lock.json";
+
+  describe("Lock", function () {
+    async function deployOneYearLockFixture() {
+      const ONE_YEAR_IN_SECS = 365 * 24 * 60 * 60;
+      const ONE_GWEI = 1_000_000_000;
+
+      const lockedAmount = ONE_GWEI;
+      const unlockTime = (await time.latest()) + ONE_YEAR_IN_SECS;
+
+      const lockContract = new web3.eth.Contract(artifacts.abi);
+      lockContract.handleRevert = true;
+
+      const [deployer, otherAccount] = await web3.eth.getAccounts();
+      const rawContract = lockContract.deploy({
+        data: artifacts.bytecode,
+        arguments: [unlockTime],
+      });
+
+      // To know how much gas will be consumed, we can estimate it first.
+      const estimateGas = await rawContract.estimateGas({
+        from: deployer,
+        value: lockedAmount.toString()
+      });
+
+      const lock = await rawContract.send({
+        from: deployer,
+        gas: estimateGas.toString(),
+        gasPrice: "10000000000",
+        value: lockedAmount.toString()
+      });
+
+      console.log("Lock contract deployed to: ", lock.options.address);
+      return { lock, unlockTime, lockedAmount, deployer, otherAccount, rawContract };
+    }
+
+    describe("Deployment", function () {
+      it("Should set the right unlockTime", async function () {
+        const { lock, unlockTime } = await loadFixture(deployOneYearLockFixture);
+        const setTime = await lock.methods.unlockTime().call();
+        console.log("SetTime", setTime);
+        expect(setTime).to.equal(unlockTime);
+      });
+
+      it("Should set the right deployer", async function () {
+        const { lock, deployer } = await loadFixture(deployOneYearLockFixture);
+
+        expect(await lock.methods.owner().call()).to.equal(deployer);
+      });
+
+      it("Should receive and store the funds to lock", async function () {
+        const { lock, lockedAmount } = await loadFixture(
+          deployOneYearLockFixture
+        );
+        const balance = await web3.eth.getBalance(String(lock.options.address));
+        expect(balance).to.equal(lockedAmount);
+      });
+
+      it("Shouldn't fail if the unlockTime has arrived and the deployer calls it", async function () {
+        const { lock, unlockTime, deployer } = await loadFixture(
+          deployOneYearLockFixture
+        );
+
+        await time.increaseTo(unlockTime);
+        await expect(lock.methods.withdraw().send({from: deployer})).not.to.be.reverted;
+      });
+    });
+  });
+
+```
+
+in this file, we performed similar steps as in the deployment script to prepare and deploy the contract using the `ABI` and `bytecode` in `deployOneYearLockFixture()`. To read the `owner` data from the Blockchain, we used an instance of the deployed contract i.e `lock.methods.owner().call().`Invoking `.call()` does not change the state of the blockchain hence no wallet signature is required.
+
+To change the status of the data we previously saved, we have to access the `method` container for the function (s) we desire and invoke the `.send` to broadcast our intention to the network `lock.methods.withdraw().send({from: deployer})`.
+
+:::note
+When using `.send()`, you must explicitly provide the `sender` of the transaction in the `from` field (in the above example is the address of the `deployer` account).
+:::
+
+
+To run the test you can use the command
+```bash
+npx hardhat test test/Lock.ts
+```
+
+And you'll get a similar result to this:
+```js
+/*
+Lock
+    Deployment
+Lock contract deployed to:  0x5FbDB2315678afecb367f032d93F642f64180aa3
+SetTime 1739193193n
+      ✔ Should set the right unlockTime (884ms)
+      ✔ Should set the right deployer (54ms)
+      ✔ Should receive and store the funds to lock
+      ✔ Shouldn't fail if the unlockTime has arrived and the deployer calls it
+*/
+```