ethers.js를 사용하여 스마트 계약과 상호 작용하는 방법?

Ethers.js는 Ethereum Smart Contracts와 상호 작용하는 데 사용되는 JavaScript 라이브러리로 개발자가 노드에 연결하고 데이터를 읽고 거래를 안전하고 효율적으로 보낼 수 있습니다.

2025/07/29 09:01

스마트 계약이란 무엇이며 왜 ethers.js를 사용합니까?

스마트 계약은 코드에 직접 작성된 계약 조건과 자체 실행 계약입니다. 이 계약은 이더 리움 블록 체인 에서 실행되며 개발자는 중개자없이 운영되는 분산 응용 프로그램 (DAPP)을 만들 수 있습니다. 이러한 계약과 상호 작용하기 위해 개발자는 종종 Ethereum 블록 체인과 상호 작용하기위한 포괄적 인 도구 세트를 제공하는 가벼운 JavaScript 라이브러리 인 Ethers.js를 사용합니다.

Ethers.js는 이더 리움 노드에 연결, 거래 서명 및 스마트 계약 기능 호출과 같은 작업을 단순화합니다. 읽기 및 쓰기 작업을 모두 지원하므로 이더 리움 기반 애플리케이션에서 작업하는 개발자에게 선호하는 선택이됩니다.

개발 환경 설정

Ethers.js를 사용하여 스마트 계약과 상호 작용하기 전에 개발 환경이 올바르게 구성되어 있는지 확인하십시오. 당신은 필요합니다 :

• 시스템에 Node.js가 설치되었습니다
• NPM 또는 원사 와 같은 패키지 관리자
• 로컬 또는 원격 이더 리움 노드 (예 : Infura 또는 Alchemy )
• 대상 스마트 계약의 ABI (응용 이진 인터페이스)
• 계약 주소

새 프로젝트를 초기화하고 Ethers.js를 설치하여 시작하십시오.

 mkdir my-ethers-project
 cd my-ethers-project
 npm init -y
 npm install ethers

일단 설치되면 JavaScript 코드를 작성하여 이더 리움 네트워크에 연결하고 계약과 상호 작용할 수 있습니다.

이더 리움 제공 업체에 연결

스마트 계약과 상호 작용하려면 먼저 이더 리움 노드에 연결해야합니다. Ethers.js는 JSONRPCProvider , Infuraprovider 및 AlchemyProvider를 포함한 몇 가지 제공자 옵션을 제공합니다.

Infura를 사용하여 연결하는 방법은 다음과 같습니다.

 const { ethers } = require('ethers'); const infuraurl = 'https://mainnet.infura.io/v3/your_infura_project_id';
 const provider = new ethers.jsonrpcprovider (Infuraurl);

YOUR_INFURA_PROJECT_ID 실제 Infura 프로젝트 ID로 바꾸십시오. 이 공급자를 사용하면 블록 체인 데이터를 쿼리하고 트랜잭션을 보낼 수 있습니다.

로컬 노드를 사용하는 경우 다음을 통해 연결할 수 있습니다.

 const provider = new ethers.JsonRpcProvider('http://localhost:8545');

이 연결은 계약 상태를 읽고 트랜잭션을 네트워크로 전송하는 데 필수적입니다.

스마트 계약 인터페이스로드

스마트 계약과 상호 작용하려면 사용 가능한 기능 및 이벤트를 정의하는 ABI가 필요합니다. ABI는 일반적으로 JSON 어레이로 제공됩니다. 스크립트에로드하여 Ethers.contract 와 함께 사용할 수 있습니다.

ABI를 포함하는 MyContract.json 이라는 JSON 파일이 있다고 가정합니다.

 const contractABI = require('./MyContract.json');
 const contractAddress = '0x...'; // Replace with your contract address const contract = new ethers.contract (ContractAddress, Contractabi, 제공자);

이렇게하면 기능을 호출하고 계약에 의해 방출 된 이벤트를들을 수있는 계약 인스턴스가 생성됩니다.

트랜잭션을 보내려면 (즉, 상태 변경 기능을 호출) 계약 인스턴스에 서명자를 첨부해야합니다.

스마트 계약으로 거래를 보냅니다

스마트 계약에 대한 쓰기 작업을 수행하려면 (토큰을 마무리하거나 변수를 업데이트하는 것) 서명자를 사용해야합니다. 서명자는 거래에 서명하고 보낼 수있는 이더 리움 계정을 나타냅니다.

개인 키를 사용하여 서명자를 만드는 방법은 다음과 같습니다.

 const privateKey = '0x...';
 const wallet = new ethers.Wallet(privateKey, provider);
 const contractWithSigner = contract.connect(wallet);

이제 블록 체인 상태를 수정하는 계약 기능을 호출 할 수 있습니다. 예를 들어, 계약에 mint() 라는 함수가있는 경우

 async function mintToken() {
 const tx = await contractWithSigner.mint(1);
 await tx.wait();
 console.log('Transaction mined:', tx.hash);
 }

이것은 트랜잭션을 네트워크로 보내고 확인되기를 기다립니다. ethers.js는 거래의 서명 및 제출을 자동으로 처리합니다.

스마트 계약에서 데이터를 읽습니다

스마트 계약에서 데이터를 읽으면 거래가 필요하지 않으므로 무료입니다. 계약 인스턴스를 사용하여 뷰 또는 순수 함수를 직접 호출 할 수 있습니다.

예를 들어, 계약에 balanceOf(address) 라는 기능이있는 경우 :

 async function getBalance(address) {
 const balance = await contract.balanceOf(address);
 console.log( Balance of ${address}: , balance.toString());
 }

이것은 주어진 이더 리움 주소의 토큰 잔액을 검색합니다. 반환 된 값은 일반적으로 Bignumber 이며, 디스플레이 목적으로 문자열 또는 번호로 변환 할 수 있습니다.

한 번에 여러 값을 검색하거나 구조화 된 데이터를 반환하는 복잡한 기능을 호출 할 수도 있습니다. ethers.js는 기능의 ABI 정의에 따라 반환 값이 올바르게 디코딩되도록합니다.

자주 묻는 질문

Q : Ethereum 외에 다른 블록 체인과 함께 Ethers.js를 사용할 수 있습니까?

예, Ethers.js는 Binance Smart Chain , Polygon 및 Arbitrum 과 같은 EVM 호환 블록 체인을 지원합니다. 제공자 URL을 변경하고 계약 ABI 및 주소가 대상 체인에 맞는지 확인하면됩니다.

Q : Ethers.js와의 계약 이벤트를 어떻게 처리합니까?

on() 또는 once() 메소드를 사용하여 스마트 계약 이벤트를들을 수 있습니다. 예를 들어, Transfer 이벤트를 듣기 위해 :

 contract.on('Transfer', (from, to, amount, event) => {
 console.log( Transfer from ${from} to ${to} of ${amount} );
 });

Q : 스마트 계약의 ABI를 노출시키는 것이 안전합니까?

예, ABI는 민감한 데이터가 아니며 외부 상호 작용에 필요합니다. 그러나 개인 키 와 서명자는 클라이언트 측 코드 또는 공개 리포지토리에 노출되어서는 안됩니다.

Q : ethers.js를 통해 전송 된 실패 트랜잭션을 어떻게 디버깅 할 수 있습니까?

거래 영수증을 검사하고 Etherscan 또는 Remix IDE 와 같은 도구를 사용하여 거래를 시뮬레이션하고 디버깅 할 수 있습니다. 또한 Ethers.js를 사용하면 call() 메소드를 사용하여 트랜잭션을 네트워크로 보내지 않고 시뮬레이션 할 수 있습니다.