Hardhat으로 개발하기

이 튜토리얼에서는 GIWA 체인에서 스마트 컨트랙트를 개발·테스트·배포·검증하는 전 과정을 다룹니다.

Hardhat은 Ethereum Application을 개발할 때 유용하게 사용할 수 있는 Node.js 기반 Toolkit 이에요. 유연하고 확장 가능하다는 특징을 가지고 있어요.

요구사항

Node v22+

이 튜토리얼은 Node 버전 22 이상이 설치되어 있어야 해요.

• Node v22+ 다운로드

nvm으로 Node 버전을 관리하는 경우 nvm install 22 명령어를 실행하면 돼요.

---

개발 환경 세팅

Hardhat을 설치하고 프로젝트를 생성해요.

mkdir giwa-project
cd giwa-project

npx hardhat --init
npm install --save-dev @nomicfoundation/hardhat-verify

생성된 프로젝트 구조는 아래와 같아요.

giwa_project/
├── hardhat.config.ts # 프로젝트 설정 파일
├── contracts         # 프로젝트 소스 코드 디렉토리
├── test              # 작성한 컨트랙트 테스트 디렉토리
├── ignition          # Hardhat Ignition 배포 스크립트
└── scripts           # 배포/시뮬레이션용 스크립트

---

Hardhat을 GIWA 체인에 연결하기

GIWA 체인에 스마트 컨트랙트를 배포하려면 hardhat.config.ts 파일에 GIWA 체인을 추가해야 해요.

import type { HardhatUserConfig } from "hardhat/config";

import hardhatToolboxViemPlugin from "@nomicfoundation/hardhat-toolbox-viem";
import hardhatVerify from "@nomicfoundation/hardhat-verify";
import 'dotenv/config'

const config: HardhatUserConfig = {
  plugins: [hardhatToolboxViemPlugin, hardhatVerify],
  solidity: {
    profiles: {
      default: {
        version: "0.8.28",
      },
      production: {
        version: "0.8.28",
        settings: {
          optimizer: {
            enabled: true,
            runs: 200,
          },
        },
      },
    },
  },
  networks: {
    giwaSepolia: {
      type: "http",
      chainType: "op",
      url: "https://sepolia-rpc.giwa.io",
      accounts: [process.env.PRIVATE_KEY as string]
    },
  },
  chainDescriptors: {
    91342: {
      name: "Giwa Sepolia",
      blockExplorers: {
        blockscout: {
          name: "Giwa Sepolia Explorer",
          url: "https://sepolia-explorer.giwa.io",
          apiUrl: "https://sepolia-explorer.giwa.io/api",
        },
      },
    },
  },
};

export default config;

환경 변수 불러오기

위 설정은 dotenv를 사용해서 .env 파일의 PRIVATE_KEY 환경 변수를 읽어와요. 절대 소스 코드에 개인 키를 하드코딩하지 마세요.

dotenv를 설치하려면 아래처럼 입력해요:

npm install --save dotenv

dotenv가 설치되었다면, .env 파일을 만들고 아래와 같이 채워넣어요.

PRIVATE_KEY=<YOUR_PRIVATE_KEY>

<YOUR_PRIVATE_KEY> 는 배포에 사용할 지갑의 개인키(Private Key)로 교체하세요.

PRIVATE_KEY는 컨트랙트를 배포할 때 사용할 지갑의 개인키(Private Key)예요.

---

컨트랙트 작성하기

아주 간단한 컨트랙트부터 작성해볼까요? 먼저, 프로젝트 생성 시에 같이 생성된 contracts/ 폴더 안의 Counter.sol, Counter.t.sol 파일과 test/ 폴더 안에 Counter.ts 파일, 그리고 ignition/modules/Counter.ts을 지워주고, 아래처럼 새로운 컨트랙트를 작성해요.

contracts/Giwa.sol

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

contract Giwa {
    event HelloGiwa();

    function helloGiwa() public {
        emit HelloGiwa();
    }
}

위 스마트 컨트랙트 코드는 Giwa 라는 이름의 컨트랙트이고, helloGiwa 라는 함수와 HelloGiwa라는 이벤트를 가진 컨트랙트예요.

Hardhat을 통해 컴파일하려면 아래와 같이 입력하면 돼요.

npx hardhat compile

테스트 코드 작성하기

작성한 컨트랙트가 의도한대로 동작하는지 확인하기 위해 테스트 코드를 작성해요. Hardhat은 viem을 사용해서 TypeScript/JavaScript 형태로 테스트 코드를 작성할 수도 있고, Solidity로도 유닛 테스트 코드를 작성할 수 있어요. 이번 예제에서는 viem을 사용해서 작성해볼게요.

test/Giwa.ts

import { describe, it } from "node:test";

import { network } from "hardhat";

describe("Giwa", async function () {
  const { viem } = await network.connect();

  it("Should emit the HelloGiwa event when calling the helloGiwa() function", async function () {
    const giwa = await viem.deployContract("Giwa");

    await viem.assertions.emit(
      giwa.write.helloGiwa(),
      giwa,
      "HelloGiwa"
    );
  });
});

결과를 확인하려면 아래와 같이 입력하면 돼요.

npx hardhat test

---

컨트랙트 배포하기

스마트 컨트랙트가 성공적으로 컴파일되면, 해당 컨트랙트를 GIWA Sepolia 테스트 네트워크에 배포할 수 있어요.

Hardhat을 통해서 컨트랙트를 배포하는 방법 중에 하나는 Hardhat Ignition 이라는 툴을 활용하는 거예요. 아래와 같이 코드를 작성해서 시작할 수 있어요.

ignition/modules/Giwa.ts

import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";

export default buildModule("GiwaModule", (m) => {
  const giwa = m.contract("Giwa");

  m.call(giwa, "helloGiwa", []);

  return { giwa };
});

작성이 완료되었다면, 아래와 같이 입력해서 GIWA Sepolia 테스트 네트워크에 배포할 수 있어요.

npx hardhat ignition deploy ignition/modules/Giwa.ts --network giwaSepolia

가스비가 부족한가요? 테스트 ETH를 클레임하세요.

아래와 같이 결과가 나왔다면, 블록체인 세상에 여러분의 스마트 컨트랙트가 배포되어 누구든지 상호작용할 수 있게 된 거예요.

Hardhat Ignition 🚀

Resuming existing deployment from ./ignition/deployments/chain-91342

Deploying [ GiwaModule ]

Batch #1
  Executed GiwaModule#Giwa

Batch #2
  Executed GiwaModule#Giwa.helloGiwa

[ GiwaModule ] successfully deployed 🚀

Deployed Addresses

GiwaModule#Giwa - 0x여러분이_배포한_컨트랙트의_주소

---

컨트랙트 검증하고 익스플로러에서 상호작용하기

블록 익스플로러에서 컨트랙트와 상호작용하려면, 여러분이나 다른 누군가가 먼저 이를 검증해야 해요.

위에서 배포된 컨트랙트 주소를 확인하고, 아래와 같이 입력해요.

npx hardhat verify --network giwaSepolia <배포된-컨트랙트-주소>

아래처럼 응답이 나왔다면 블록 익스플로러에 들어가서 여러분이 작성한 코드와 상호작용할 수 있어요.

=== Blockscout ===

📤 Submitted source code for verification on Giwa Sepolia Explorer:

  contracts/Giwa.sol:Giwa
  Address: <배포된-컨트랙트-주소>

⏳ Waiting for verification result...


✅ Contract verified successfully on Giwa Sepolia Explorer!

  contracts/Giwa.sol:Giwa