# Hardhat을 이용한 컨트랙트 배포

하드햇 (Hardhat)은 이더리움 소프트웨어를 위한 개발 프레임워크입니다. 컨트랙트 디앱 개발, 컴파일, 디버깅, 배포 등 이더리움을 개발하기 위한 다양한 기능이 구성되어 있습니다. 

디카르고는 이더리움의 EVM과 상호 작용을 할 수 있기에, 디카르고 네트워크에 컨트랙트를 배포할 수 있습니다.

하드햇과 디카르고 웨어하우스를 사용하여 지갑 디앱 (Wallet dApp)을 구축하는 방법을 살펴보겠습니다.

{% hint style="info" %}
모든 블록체인에 컨트랙트를 배포할 때는 해당 체인의 네이티브 토큰을 사용하여 배포 가스 수수료를 지불해야 하며, 이는 디카르고도 마찬가지입니다. 디카르고 웨어하우스에 배포하기 전에 [포우셋 (faucet)](/undefined-4/undefined.md)을 통해 $DKA 테스트넷 토큰을 획득할 수 있습니다.
{% endhint %}

## 개발 환경

사전 준비 사항 (Prerequisites)

* **Node.js & npm/yarn**:
  * Installed from [Node.js](https://nodejs.org/).
* **Hardhat**: Development environment for Ethereum.

  * Install with:

  ```bash
  npm install --save-dev hardhat
  ```

## Step 1 - 하드햇 프로젝트 설정

1. 하드햇 프로젝트를 새로 초기화합니다.

```solidity
mkdir helloDka
cd helloDka
npx hardhat init
```

2. 추가로 개발에 필요한 [dotenv](https://github.com/motdotla/dotenv) 를 설치합니다.

```bash
npm i dotenv
touch .env
```

3. 다음은 하드햇 프로젝트의 폴더 구조에 대한 예시입니다.

```bash
/helloDka
├── README.md
├── contracts
|  └── Lock.sol
├── hardhat.config.js
├── ignition
|  └── modules
|     └── Lock.js
├── package-lock.json
├── package.json
└── test
   └── Lock.js
```

## Step 2 - Counter.sol 컨트랙트 작성

contracts 폴더 안에 <mark style="color:blue;">`Counter.sol`</mark> 파일을 생성한 다음 아래 코드를 복사하여 붙여 넣습니다.&#x20;

해당 코드는 변수 Number를 설정할 수 있는 간단한 기능이 구현되어 있습니다.

```solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
 
contract Counter {
    uint256 public number;
 
    function setNumber(uint256 newNumber) public {
        number = newNumber;
    }
 
    function increment() public {
        number++;
    }
}
```

## Step 3 - 이그니션 파일 업데이트

<mark style="color:blue;">`./ignition/modules`</mark> 폴더 안에 <mark style="color:blue;">`Counter.js`</mark> 파일을 생성한 다음 아래 코드를 복사하여 붙혀 넣습니다.&#x20;

해당 코드는[ 하드햇 이그니션(hardhat ignition) ](https://hardhat.org/ignition/docs/getting-started#overview)표준 코드이며, 컨트랙트 배포를 수행합니다.

```jsx
const { buildModule } = require("@nomicfoundation/hardhat-ignition/modules");
 
module.exports = buildModule("Counter", (m) => {
  const lock = m.contract("Counter");
 
  return { lock };
});
```

## Step 4 - 하드햇 설정

1. 필요한 플러그인 및 구성을 <mark style="color:blue;">`hardhat.config.js`</mark>에 작성합니다.
   * <mark style="color:blue;">`require('dotenv').config()`</mark> :  <mark style="color:blue;">`.env`</mark>를 불러옵니다.
   * accounts: \[process.env.PRIVATE\_KEY] : <mark style="color:blue;">`.env`</mark> 에 작성된 개인키를 전달합니다.

```jsx
require("@nomicfoundation/hardhat-toolbox");
require("dotenv").config();

/** @type import('hardhat/config').HardhatUserConfig */
module.exports = {
  solidity: "0.8.24",
  networks: {
    warehouse: {
      url: "<https://it-full.dknote.net>",
      accounts: [process.env.PRIVATE_KEY],
    },
  },
  ignition: {
    requiredConfirmations: 1
  }
};

```

2. <mark style="color:blue;">`.env`</mark> 파일 안에 다음을 추가합니다. <mark style="color:blue;">`gitignore`</mark> 파일에 <mark style="color:blue;">`.env`</mark>가 추가되었는지 확인합니다.

```bash
PRIVATE_KEY=YOUR KEY HERE WITH NO QUOTES
```

## Step 5 - 컴파일과 배포

1. <mark style="color:blue;">`counter.sol`</mark> 을 컴파일합니다.

```bash
npx hardhat compile
```

2. <mark style="color:blue;">`counter.sol`</mark> 코드를 디카르고 웨어하우스에 배포합니다.

```bash
npx hardhat ignition deploy ./ignition/modules/Counter.js --network warehouse
```

## Step 6 - 배포 트랜잭션 확인

1. 배포된 컨트랙트의 트랜잭션 정보를 조회합니다.

```jsx
npx hardhat ignition transactions chain-2465001
```

2. [dScanner](https://warehouse.dscanner.io/)에서 트랜잭션 정보 검색할 수 있습니다.

## 컨트랙트 검증

이더리움이나 EVM 기반 블록체인에서 스마트 컨트랙트를 개발해 보셨다면, 아마 하드햇의 검증 (verify) 기능을 사용해 보셨을 겁니다.

하지만 저희 디카르고 체인은 물류 서비스에 최적화된 블록 익스플로러 (Explorer)인 [dScanner](https://warehouse.dscanner.io/)를 자체적으로 개발했기 때문에, 하드햇의 검증 기능과는 호환되지 않습니다.

대신, 여러분이 개발한 컨트랙트의 투명성을 보장하기 위해 [dScanner](https://warehouse.dscanner.io/)에서 제공하는 [Verify Contract](https://warehouse.dscanner.io/verify-contract)를 활용할 수 있습니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dkargo.io/undefined-3/hardhat.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.