[Solidity+hardhat+JavaScript] 스마트컨트랙 배포 실습

이 글은 아래 영상을 보고 공부한 내용을 기록한 글입니다.

영상 바로가기

목표

펀딩 프로그램을 관장하는 스마트 컨트랙 만들기

• 프로젝트의 오너, 목표 금액, 프로젝트에 기부한 사람들의 목록, 그들의 구매금액, 기부금의 누적 총액, 데드라인
• 데드라인 도달 시 기부금 총액>=목표금액일 경우 돈은 프로젝트 오너에게 전달 -기부금 총액<목표금액일 경우 돈은 기부자들에게 환불

 

Contract 배포

1. 필요한 라이브러리 설치

npm install -D hardhat

npm install -D ethers

npm install -D --legacy-peer-deps @nomiclabs/hardhat-ethers

npm install -D --legacy-peer-deps @nomiclabs/hardhat-waffle

2. hardhat 프로젝트 생성

npx hardhat

위 명령어를 입력하고 create an empty hardhat.config.js를 선택한 후 hardhat.config.js파일의 solidity버전을 Fundraisign.sol 상단  pragma solidity 버전에 맞춰줘야 한다. 이후 hardhat.config.js 파일에 require("@nomiclabs/hardhat-waffle") 추가하면 된다.

 

 

1. hardhat.config.js 파일에 require("@nomiclabs/hardhat-waffle") 추

1. create an empty hardhat.config.js 선택
2. hardhat.config.js 파일의 solidity 버전을 Fundraising.sol 상단 pragma solidity 버전에 맞추기
3. hardhat.config.js 파일에 require("@nomiclabs/hardhat-waffle") 추가

 

3. 블록체인 계정 생성

이제 컨트랙을 배포하고 기부된 돈을 수령하기 위한 블록체인 계정을 만들어보자. 아래 링크를 눌러서 메타마스크 익스텐션을 추가하도록 하자.

https://chrome.google.com/webstore/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn

MetaMask

그런 다음 새 지갑 생성을 눌러 지갑을 생성하고, 설정에 들어가 테스트넷이 보이도록 설정을 해주자.

지갑의 비밀번호와 니모닉코드는 잘 저장해두어야 한다. 절대 잃어버려서는 안되는 정보이다.

 

3. 테스트 이더 받기

영상에서는 All that Node로 진행하지만 지금은 너무 많은 요청으로 인해 막혀서 아래 사이트에서 테스트 이더를 수령했다.

https://goerlifaucet.com/

 

위 버튼을 눌러 지갑주소를 간편하게 복사할 수 있다.

4. All that Node 프로젝트 생성

All that Node 상단의 dashboard - Create New Project를 클릭하자.

기본 옵션으로 진행할 것이다. checkout을 누르고 create project버튼을 누르자. 

이후 add protocol을 누르고 Ethereum을 선택하도록 하자.

이제 Goerli RPC 복사해 hardhat.config.js에 추가할 것이다. 아래와 같은 형식으로 url에 Goerli RPC/API Key 형식으로 추가하면 된다.

networks: {
    goerli: {
      url: "Goerli RPC 링크/API Key",
    },
  },

5. HardHat에서 지갑 관리하도록 하기

현재는 MetaMask에서 지갑을 관리하고 있다. HardHat에서도 지갑을 관리할 수 있도록 해주자.

MetaMask에서 계정 세부정보 - 비공개 키 내보내기 - 비밀번호 입력 과정을 거쳐 private key를 알아내도록 하자.

이후 accounts부분에 알아낸 private key를 추가해 주면 된다. 다만 이것은 보안상 좋지 않은 방법이니 .env에 값을 저장해서 불러오는 것을 추천한다.

networks: {
    goerli: {
      url: "Goerli RPC 링크/API Key",
      accounts: ["알아낸 private key"]
    },
  },

 

6. 배포 코드 작성

이제 작성한 컨트랙 코드를 배포해보자. scripts폴더를 만들고 안에 deploy.js 생성한 뒤 아래 코드를 작성해주도록 하자.

const { ethers } = require("hardhat");

async function main() {
  const Fundraising = await ethers.getContractFactory("Fundraising"); //Fundraising 컨트랙을 가져와서 컴파일 한다.
  const contract = await Fundraising.deploy(100); //100이라는 인자와 함께 배포한다. 해당 인자는 Fundraising 컨트랙에 전달된다. 이 프로젝트에서는 목표금액을 의미한다.
  console.log("Contract address is: ", contract.address);
}

main()
  .then(() => process.exit(0))
  .catch((error) => {
    console.error(error);
    process.exit(1);
  });

그런 다음 아래 코드를 커맨드창에 입력해주도록 하자.

npx hardhat run scripts/deploy.js --network goerli

성공할 경우 콘솔 창에 contract address가 출력된다. 에러가 났을 경우 아래 ERRORS 부분을 참고하도록 하자. 이제 메타마스크를 통해 Ether Scan에 들어가면 배포된 컨트랙을 확인할 수 있다.

Etherscan에서 계정 보기를 통해 배포된 컨트랙을 확인할 수 있다.

 

 

7. 배포된 컨트랙과 상호작용 하기

Ether Scan에서 Contract Creation을 눌러 해당 컨트랙 상세 보기 페이지로 접근한 뒤, 해당 페이지 상단의 컨트랙 주소를 복사하자.

그리고 메타마스크를 통해 복사한 컨트랙 주소로 0.001Ether를 보내주도록 하자. 참고로 1 Ether = 1,000,000,000,000,000,000 WEI 이다.

다시 컨트랙 상세 페이지를 보면 0.001Ether가 잘 들어간 것을 확인할 수 있다.

 

8. 컨트랙 함수 실행하기

hardhat.config.js에 아래 코드를 추가한다. abi값은 artifacts/contracts/Fundraising/Fundraising.json에서 찾을 수 있다.

task("check", "Check contract amounts", async () => {
  const [developer] = await ethers.getSigners();
  const contract = process.env.CONTRACT_ADDRESS;
  const abi = [
    'artifacts/contracts/Fundraising/Fundraising.json의 "abi":[]하고 나와있는 부분',
  ];
  const fundraising = new ethers.Contract(contract, abi, developer);
  console.log(
    await fundraising.targetAmount(),
    await fundraising.raisedAmount()
  );
});

그리고 아래 명령어를 통해 방금 작성한 task를 실행해보자. 10진수로 출력하고 싶다면 아래와 같이 parseInt를 사용하면 된다.

npx hardhat check --network goerli

task("check", "Check contract amounts", async () => {
  const [developer] = await ethers.getSigners();
  const contract = process.env.CONTRACT_ADDRESS;
  const abi = [
    'artifacts/contracts/Fundraising/Fundraising.json의 "abi":[]하고 나와있는 부분',
  ];
  const fundraising = new ethers.Contract(contract, abi, developer);

  //여기서부터 수정된 코드
  targetAmount = await fundraising.targetAmount();
  raisedAmount = await fundraising.raisedAmount();
  console.log(parseInt(targetAmount), parseInt(raisedAmount));
});

 

값이 16진수로 출력되는 모습

값이 10진수로 출력되는 모습

 

ERRORS

• Error: insufficient funds for intrinsic transaction cost
  컨트랙을 배포하기에 테스트 이더가 부족해서 발생하는 에러. 아래 사이트에서 테스트이더를 모을 수 있다.
  https://goerli-faucet.pk910.de/
• Error: overflow [ See: https://links.ethers.org/v5-errors-NUMERIC_FAULT-overflow ]
  영상을 보고 100000000000000000000라는 숫자와 함께 배포했더니 아래 에러가 발생했다. 100으로 고쳐주었다.
• ProviderError: Too Many Requests error received from ethereum-goerli-rpc.allthatnode.com
  All that Node 에서 현재 too many request라며 테스트 이더도 받을 수 없는 상태인데 말 그대로 너무 많은 요청이 와서 그런 것 같다. 잠시 뒤 실행하면 성공한다. 유저 문제가 아니다.
• TypeError: Cannot read properties of undefined (reading 'JsonRpcProvider')
  이더리움 버전을 5.4이하로 낮추면 해결되는 오류이다. package.json에서 이더리움 버전을 5.4로 입력하고 npm install을 한 뒤 다시 시도해보자.
  https://ethereum.stackexchange.com/questions/144451/typeerror-cannot-read-properties-of-undefined-reading-jsonrpcprovider

 

References

• Solidity types https://docs.soliditylang.org/en/v0.8.19/types.html#types
• Solidity iteration https://docs.soliditylang.org/en/v0.8.19/types.html#iterable-mappings