Deploy a contract - Foundry, Hardhat, Ethers.js

사전 요구 사항

Node.js 16+
Ethereum 개발 경험
테스트넷 토큰이 있는 지갑(테스트넷 체인 상세 정보 참조)

컨트랙트 준비

이 가이드 전반에서 다음 예시 컨트랙트를 사용합니다:

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

contract SimpleStorage {
    string private storedData;
    address public owner;
    
    event DataStored(string data, address indexed by);
    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
    
    constructor(string memory initialData) {
        storedData = initialData;
        owner = msg.sender;
        emit DataStored(initialData, msg.sender);
    }
    
    modifier onlyOwner() {
        require(msg.sender == owner, "Only owner can perform this action");
        _;
    }
    
    function setData(string memory data) public onlyOwner {
        storedData = data;
        emit DataStored(data, msg.sender);
    }
    
    function getData() public view returns (string memory) {
        return storedData;
    }
    
    function transferOwnership(address newOwner) public onlyOwner {
        require(newOwner != address(0), "New owner cannot be zero address");
        emit OwnershipTransferred(owner, newOwner);
        owner = newOwner;
    }
}

Foundry로 배포하기

Foundry는 Rust 기반의 빠른 Ethereum 개발 툴킷입니다.

Foundry를 설치합니다:
curl -L https://foundry.paradigm.xyz | bash
.bashrc 또는 .zshrc 파일을 source 해야 할 수도 있습니다.

새 Foundry 프로젝트를 설정합니다:

foundryup
forge init my-plasma-project
cd my-plasma-project

Plasma 테스트넷 설정으로 foundry.toml을 업데이트합니다:

[profile.default]
src = "src"
out = "out"
libs = ["lib"]
solc_version = "0.8.28"
optimizer = true
optimizer_runs = 200

[rpc_endpoints]
plasma_testnet = "https://testnet-rpc.plasma.to"

프로젝트 루트에 .env 파일을 생성합니다:

PRIVATE_KEY=your_private_key_here
RPC_URL=https://testnet-rpc.plasma.to

환경 변수를 로드합니다:
source .env

컨트랙트 코드를 src/SimpleStorage.sol로 저장한 후 배포합니다:

forge create src/SimpleStorage.sol:SimpleStorage \
    --rpc-url $RPC_URL \
    --private-key $PRIVATE_KEY \
    --constructor-args "Hello, Plasma!"

Foundry는 배포 트랜잭션 해시와 컨트랙트 주소를 출력합니다:

[⠊] Compiling...
[⠢] Compiling 1 files with Solc 0.8.28
[⠆] Solc 0.8.28 finished in 124.81ms
Compiler run successful!
Warning: Dry run enabled, not broadcasting transaction

Contract: SimpleStorage
Transaction: {
  "from": "0xbd828f7679656f8f830b89611c933017442f2ebf",
  "to": null,
  "maxFeePerGas": "0xf",
  "maxPriorityFeePerGas": "0x1",
  "gas": "0x69f18",

[...]

Foundry의 cast 도구를 사용하여 배포된 컨트랙트를 테스트합니다. 먼저 저장된 데이터를 읽습니다:
cast call 0x742d35Cc6610C7532C8582d4C371Acb1D5f44D7F \ "getData()" \ --rpc-url $RPC_URL

그런 다음 데이터를 업데이트하고 다시 읽습니다:

# 저장된 데이터를 업데이트합니다.
cast send 0x742d35Cc6610C7532C8582d4C371Acb1D5f44D7F \
    "setData(string)" "Updated from Foundry" \
    --private-key $PRIVATE_KEY \
    --rpc-url $RPC_URL

# 저장된 데이터를 다시 읽습니다.
cast call 0x742d35Cc6610C7532C8582d4C371Acb1D5f44D7F \
    "getData()" \
    --rpc-url $RPC_URL

다음과 같은 출력이 표시됩니다:

blockHash            0x68fbd2aaf1de9c577869056ca634f2103fa1695673a94d8c049d0b78d3733aac
blockNumber          1200423
contractAddress
cumulativeGasUsed    21712
effectiveGasPrice    8
from                 0xBd828F7679656F8f830b89611C933017442F2EbF
gasUsed              21712
logs                 []
logsBloom            0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
root
status               1 (success)
transactionHash      0xcf5b1fcc8d19f7cf7992f6e6a8b3ade74e07afbd0da0b9fce26bda4c9503a12b
transactionIndex     0
type                 2
blobGasPrice
blobGasUsed
to                   0x742D35Cc6610c7532C8582D4C371aCb1D5F44D7F
0x

Hardhat으로 배포하기

Hardhat은 풍부한 플러그인을 지원하는 완전한 기능의 개발 프레임워크입니다.

다음 사항을 확인합니다:

Node.js 20+ (최신 Hardhat 호환성에 필요)
Ethereum 개발 경험
테스트넷 토큰이 있는 지갑(테스트넷 체인 상세 정보 참조)

Node.js 18 이하는 더 이상 Hardhat에서 지원되지 않으며 ES 모듈 호환성 문제를 일으킬 수 있습니다.

Node.js 버전을 확인합니다:

node --version

Node.js 18 이하를 사용하고 있다면 Node.js 20+로 업그레이드합니다:

# nvm 사용 (권장)
nvm install 20
nvm use 20

# 또는 NodeSource 저장소 사용 (Ubuntu/Debian)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

새 Hardhat 프로젝트를 초기화합니다:

mkdir my-plasma-hardhat-project
cd my-plasma-hardhat-project
npm init -y
npm install --save-dev hardhat@latest @nomicfoundation/hardhat-toolbox@latest
npm install dotenv@latest ethers@latest
npx hardhat init

호환성 문제가 발생하면 Hardhat 문서에서 최신 지원 버전을 확인하세요.

프롬프트가 나타나면 Create a JavaScript project를 선택합니다.

hardhat.config.js를 업데이트합니다:

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

/** @type import('hardhat/config').HardhatUserConfig */
module.exports = {
  solidity: {
    version: "0.8.28",
    settings: {
      optimizer: {
        enabled: true,
        runs: 200
      }
    }
  },
  networks: {
    plasmaTestnet: {
      url: process.env.RPC_URL,
      chainId: 9746,
      accounts: [process.env.PRIVATE_KEY],
      gasPrice: 1000000000, // 1 gwei
    }
  },
  etherscan: {
    apiKey: {
      plasmaTestnet: process.env.ETHERSCAN_API_KEY
    },
    customChains: [
      {
        network: "plasmaTestnet",
        chainId: 9746,
        urls: {
          apiURL: "https://testnet.plasmascan.to/api",
          browserURL: "https://testnet.plasmascan.to/"
        }
      }
    ]
  }
};

프로젝트 루트에 .env 파일을 생성합니다:

PRIVATE_KEY=your_private_key_here
RPC_URL=https://testnet-rpc.plasma.to
ETHERSCAN_API_KEY=your_api_key_for_verification

scripts 디렉터리와 배포 스크립트를 생성합니다:
mkdir scripts

scripts/deploy.js를 생성합니다:

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

async function main() {
  // 컨트랙트 팩토리를 가져옵니다.
  const SimpleStorage = await ethers.getContractFactory("SimpleStorage");

  console.log("Deploying SimpleStorage contract...");

  // 생성자 인수를 사용하여 컨트랙트를 배포합니다.
  const simpleStorage = await SimpleStorage.deploy("Hello, Plasma from Hardhat!");

  // 배포가 완료될 때까지 기다립니다.
  await simpleStorage.waitForDeployment();

  const contractAddress = await simpleStorage.getAddress();
  console.log("SimpleStorage deployed to:", contractAddress);
  console.log("Transaction hash:", simpleStorage.deploymentTransaction().hash);

  // 트랜잭션이 포함될 때까지 몇 블록을 기다립니다.
  console.log("Waiting for block confirmations...");
  await simpleStorage.deploymentTransaction().wait(5);

  console.log("✅ Deployment completed successfully!");
}

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

컨트랙트 코드를 contracts/SimpleStorage.sol로 저장한 후 배포합니다:
npx hardhat run scripts/deploy.js --network plasmaTestnet
완료되었습니다!

Ethers.js로 배포하기

Ethers.js는 최소한의 프로그램 방식 배포 흐름을 제공합니다.

새 프로젝트를 생성합니다:

mkdir my-plasma-ethers-project
cd my-plasma-ethers-project
npm init -y
npm install ethers dotenv solc

프로젝트 루트에 .env 파일을 생성합니다:

PRIVATE_KEY=<your_private_key_here>
RPC_URL=https://testnet-rpc.plasma.to
ETHERSCAN_API_KEY=your_api_key_for_verification

Solidity 컨트랙트를 컴파일하기 위한 compile.js를 생성합니다:

const fs = require('fs');
const solc = require('solc');
require('dotenv').config();

// 컨트랙트 소스 코드를 읽습니다.
const contractSource = fs.readFileSync('SimpleStorage.sol', 'utf8');

// Solidity 컴파일러용 입력을 준비합니다.
const input = {
  language: 'Solidity',
  sources: {
    'SimpleStorage.sol': {
      content: contractSource,
    },
  },
  settings: {
    outputSelection: {
      '*': {
        '*': ['*'],
      },
    },
    optimizer: {
      enabled: true,
      runs: 200,
    },
  },
};

// 컨트랙트를 컴파일합니다.
const output = JSON.parse(solc.compile(JSON.stringify(input)));

// 컴파일 오류를 확인합니다.
if (output.errors) {
  output.errors.forEach((error) => {
    console.error(error.formattedMessage);
  });
}

// 컨트랙트 데이터를 추출합니다.
const contract = output.contracts['SimpleStorage.sol']['SimpleStorage'];
const abi = contract.abi;
const bytecode = contract.evm.bytecode.object;

// 컴파일 아티팩트를 저장합니다.
fs.writeFileSync('SimpleStorage.json', JSON.stringify({
  abi: abi,
  bytecode: bytecode
}, null, 2));

console.log('Contract compiled successfully!');

컨트랙트를 SimpleStorage.sol로 저장한 후 컴파일합니다:
node compile.js
다음과 같이 출력됩니다:
Contract compiled successfully!

deploy.js를 생성합니다:

const { ethers } = require('ethers');
const fs = require('fs');
require('dotenv').config();

async function deploy() {
  // 프로바이더와 지갑을 설정합니다.
  const provider = new ethers.JsonRpcProvider(process.env.RPC_URL);
  const wallet = new ethers.Wallet(process.env.PRIVATE_KEY, provider);
  
  console.log('Deploying from account:', wallet.address);
  
  // 계정 잔액을 확인합니다.
  const balance = await provider.getBalance(wallet.address);
  console.log('Account balance:', ethers.formatEther(balance), 'XPL');
  
  // 컴파일된 컨트랙트를 불러옵니다.
  const contractData = JSON.parse(fs.readFileSync('SimpleStorage.json', 'utf8'));
  
  // 컨트랙트 팩토리를 생성합니다.
  const factory = new ethers.ContractFactory(
    contractData.abi,
    contractData.bytecode,
    wallet
  );
  
  // 컨트랙트를 배포합니다.
  console.log('Deploying contract...');
  const contract = await factory.deploy("Hello, Plasma from Ethers.js!", {
    gasLimit: 500000, // 적절한 가스 한도를 설정합니다.
    gasPrice: ethers.parseUnits('1', 'gwei'), // 1 gwei 가스 가격.
  });
  
  // 배포를 기다립니다.
  await contract.waitForDeployment();
  
  const contractAddress = await contract.getAddress();
  console.log('Contract deployed to:', contractAddress);
  console.log('Transaction hash:', contract.deploymentTransaction().hash);
  
  // 배포 정보를 저장합니다.
  const deploymentInfo = {
    contractAddress: contractAddress,
    transactionHash: contract.deploymentTransaction().hash,
    deployer: wallet.address,
    network: 'plasmaTestnet',
    timestamp: new Date().toISOString()
  };
  
  fs.writeFileSync('deployment.json', JSON.stringify(deploymentInfo, null, 2));
  
  return contract;
}

async function interact(contract) {
  console.log('\nInteracting with deployed contract...');
  
  // 초기 데이터를 읽습니다.
  const initialData = await contract.getData();
  console.log('Initial data:', initialData);
  
  // 데이터를 업데이트합니다.
  const updateTx = await contract.setData("Updated via Ethers.js");
  await updateTx.wait();
  console.log('Data updated. Transaction hash:', updateTx.hash);
  
  // 업데이트된 데이터를 읽습니다.
  const updatedData = await contract.getData();
  console.log('Updated data:', updatedData);
  
  // 소유자를 가져옵니다.
  const owner = await contract.owner();
  console.log('Contract owner:', owner);
}

// 메인 실행.
deploy()
  .then(async (contract) => {
    await interact(contract);
    console.log('\nDeployment and interaction completed successfully!');
  })
  .catch((error) => {
    console.error('Error:', error);
    process.exit(1);
  });

배포 스크립트를 실행합니다:

node deploy.js

다음과 같이 출력됩니다:

Deploying from account: 0xBd828F7679656F8f830b89611C933017442F2EbF
Account balance: 98539.897261933991888304 XPL
Deploying contract...
Contract deployed to: 0xf298A2A7BC526F9228B8C422D38f3c2E0D15449F
Transaction hash: 0x3d16cc55b9148bac9ac20981d9748a0fc89861c6beb92a2f869bb09b75f685b2

Interacting with deployed contract...
Initial data: Hello, Plasma from Ethers.js!
Data updated. Transaction hash: 0xe3328862ece5d0ca4ca84d25c4130d6749ec872c24bf76eea23dfa8c50c22505
Updated data: Updated via Ethers.js
Contract owner: 0xBd828F7679656F8f830b89611C933017442F2EbF

Deployment and interaction completed successfully!

배포 검증

위의 방법 중 하나로 배포한 후 컨트랙트 배포를 검증하세요.

문제 해결

ES 모듈 호환성 문제

Error [ERR_REQUIRE_ESM]: require() of ES Module과 같은 오류가 발생한다면 일반적으로 다음을 의미합니다:

Node.js 버전이 너무 오래됨: 사전 요구 사항에 명시된 대로 Node.js 20+로 업그레이드하세요.
종속성 버전 불일치: Node.js 업그레이드가 불가능하다면 문제가 되는 종속성을 다운그레이드할 수 있습니다:
npm install micro-eth-signer@0.10.0

Node.js 버전 경고

지원되지 않는 Node.js 버전에 대한 경고가 표시되는 경우:

WARNING: You are currently using Node.js v18.19.1, which is not supported by Hardhat

사전 요구 사항 섹션의 단계를 따라 Node.js 20+로 업그레이드하세요.

자금 부족

Error: insufficient funds for intrinsic transaction cost

지갑에 충분한 테스트넷 토큰이 있는지 확인하세요. 테스트넷 포셋을 방문하세요.

잘못된 네트워크 구성

Error: network with chainId "1" doesn't match the configured chainId "9746"

네트워크 구성이 테스트넷 체인 상세 정보와 일치하는지 확인하세요.

가스 추정 실패

Error: cannot estimate gas

배포 구성에 명시적인 가스 한도를 설정하세요:

// 배포 스크립트에서
const simpleStorage = await SimpleStorage.deploy("Hello, Plasma from Hardhat!", {
  gasLimit: 500000
});

개발

자산 관리

네트워크 구성

스마트 컨트랙트

테스트 및 리소스

컨트랙트 배포하기

사전 요구 사항

컨트랙트 준비

Foundry로 배포하기

Hardhat으로 배포하기

Ethers.js로 배포하기

배포 검증

문제 해결

ES 모듈 호환성 문제

Node.js 버전 경고

자금 부족

잘못된 네트워크 구성

가스 추정 실패

​사전 요구 사항

​컨트랙트 준비

​Foundry로 배포하기

​Hardhat으로 배포하기

​Ethers.js로 배포하기

​배포 검증

​문제 해결

​ES 모듈 호환성 문제

​Node.js 버전 경고

​자금 부족

​잘못된 네트워크 구성

​가스 추정 실패

사전 요구 사항

컨트랙트 준비

Foundry로 배포하기

Hardhat으로 배포하기

Ethers.js로 배포하기

배포 검증

문제 해결

ES 모듈 호환성 문제

Node.js 버전 경고

자금 부족

잘못된 네트워크 구성

가스 추정 실패