hardhat-toolbox

핵심 개념

Hardhat plugin

Hardhat의 기능을 확장하는 모듈 단위로, hardhat-toolbox는 여러 플러그인을 묶어서 한 번에 설치·활성화한다.

ethers.js integration

컨트랙트 배포, 호출, 계정 서명 등을 자바스크립트/타입스크립트 코드에서 다룰 수 있게 해주는 ethers 라이브러리를 테스트 환경에 자동으로 연결해준다.

chai matcher

revert 발생 여부, 이벤트 emit 여부, 잔액 변화 등 스마트 컨트랙트 특유의 검증을 chai의 expect 문법으로 표현할 수 있게 해주는 확장 assertion 세트다.

TypeChain

컨트랙트 ABI를 기반으로 타입스크립트 타입 정의를 자동 생성해, 컨트랙트 호출 시 타입 안전성을 보장해주는 도구다.

gas reporter / coverage

테스트 실행 시 함수별 가스 소비량을 표로 보여주거나, 테스트가 컨트랙트 코드를 얼마나 실행했는지 커버리지를 측정해주는 부가 도구다.

hardhat.config.js에서 toolbox 활성화 및 테스트 작성

hardhat.config.js에 toolbox를 한 줄로 등록하면 ethers와 chai matcher가 테스트 코드에서 바로 사용 가능해진다.

// hardhat.config.js
require("@nomicfoundation/hardhat-toolbox");

module.exports = {
  solidity: "0.8.20",
};

// test/Token.test.js
const { expect } = require("chai");
const { ethers } = require("hardhat");

describe("Token", function () {
  it("deploys and mints correctly", async function () {
    const Token = await ethers.getContractFactory("Token");
    const token = await Token.deploy();

    await expect(token.mint(100)).to.emit(token, "Transfer");
  });
});