web3.js를 사용하여 스마트 계약과 상호 작용하는 방법은 무엇입니까?

Web3.js를 통해 개발자는 HTTP, IPC 또는 WebSocket Connection을 통해 데이터를 읽고, 거래를 보내고, 이벤트를 듣는 도구를 제공하여 Ethereum Smart Contracts와 상호 작용할 수 있습니다.

2025/07/23 15:21

web3.js 란 무엇이며 왜 스마트 계약 상호 작용에 사용됩니까?

Web3.js는 개발자가 HTTP, IPC 또는 WebSocket을 사용하여 로컬 또는 원격 이더 리움 노드와 상호 작용할 수있는 라이브러리 모음입니다. 이 Ethereum 블록 체인과 통신하는 편리한 방법을 제공하여 개발자가 거래를 보내고 블록 체인에서 데이터를 읽고 배포 된 스마트 계약과 상호 작용할 수 있도록합니다.

스마트 계약은 코드에 직접 작성된 이용 약관과 자체 실행 계약입니다. EVM (Ethereum Virtual Machine)에서 실행되며 외부 계정 또는 기타 계약을 통해 액세스 할 수 있습니다. web3.js는 강력하고 유연한 API를 제공합니다. 이를 통해 Ethereum 네트워크와의 백엔드 상호 작용이 필요한 DAPP (Depentralized Applications)를 구축하는 개발자에게 선호되는 도구가됩니다.

Web3.js 통합 환경 설정

스마트 계약과 상호 작용하기 전에 개발 환경을 올바르게 설정해야합니다. 첫 번째 단계는 프로젝트에 web3.js를 설치하는 것입니다. NPM을 사용하여 수행 할 수 있습니다.

 npm install web3

설치되면 JavaScript 파일에서 Web3 객체를 가져오고 초기화 할 수 있습니다. Web3 객체는 이더 리움 노드에 연결되며 로컬 노드 또는 Infura 또는 Alchemy 와 같은 원격 노드 일 수 있습니다.

 const Web3 = require('web3');
 const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID');

특정 스마트 계약과 상호 작용하려면 계약 주소 와 ABI (Application Binary Interface)가 필요합니다. ABI는 계약의 기능, 이벤트 및 매개 변수를 설명하는 JSON 파일입니다. 스마트 계약과 응용 프로그램 사이의 인터페이스 역할을합니다.

스마트 계약에 연결

환경을 설정 한 후 다음 단계는 ABI 및 주소를 사용하여 스마트 계약에 연결하는 것입니다. 이것은 web3.js에서 계약 인스턴스를 작성하여 수행됩니다.

 const contractAddress = '0x...'; // Replace with your contract address
 const abi = [...]; // Replace with your contract's ABI const contract = new web3.eth.contract (ABI, ContractAdDress);

계약 인스턴스가 생성되면 메소드를 호출하거나 트랜잭션을 보낼 수 있습니다. 상호 작용의 두 가지 유형이 있습니다 : 읽기 작업 (블록 체인 상태를 수정하지 않음)과 작업 작업 (수행). 읽기 작업은 일반적으로 무료이며 call() 메소드를 사용하여 실행할 수 있지만 쓰기 작업에는 트랜잭션이 필요하고 가스를 소비합니다.

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

블록 체인 상태를 수정하지 않고 스마트 계약에서 데이터를 검색하려면 call() 메소드를 사용할 수 있습니다. 값을 반환하는 getBalance() 또는 getName() 과 같은 함수에 유용합니다.

 contract.methods.name().call()
 .then(console.log)
 .catch(console.error);

이 예에서는 계약의 name() 함수가 호출되고 결과는 콘솔에 인쇄됩니다. 이것은 읽기 작업이므로 블록 체인으로 전송되지 않으며 가스 수수료가 발생하지 않습니다 . 이 기능은이 기능이 올바르게 작동하려면 견고성에서 view 또는 pure 표시되어야한다는 점에 유의해야합니다.

함수에 매개 변수가 필요한 경우 call() 메소드에서 직접 전달할 수 있습니다. 예를 들어:

 contract.methods.balanceOf('0x...').call()
 .then(console.log)
 .catch(console.error);

이는 ERC-20 토큰 계약에서 특정 이더 리움 주소의 잔액을 검색합니다.

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

토큰 전송 또는 계약 데이터 업데이트와 같은 블록 체인의 상태를 수정하려면 거래를 보내야 합니다. 여기에는 발신자의 개인 키와 거래에 서명하고 가스 비용을 지불하는 것이 포함됩니다.

 const account = '0x...'; // Replace with your Ethereum account address
 const privateKey = '0x...'; // Replace with your private key web3.eth.accounts.wallet.add (privatekey);


contract.methods.Transfer ( '0xrecipientAddress', '100')
 .send ({wrom : chance, gas : 200000})
 .on ( 'TransactionHash', Hash => console.log (hash))
 .ON ( '영수증', 영수증 => console.log (영수증))
 .on ( 'error', error => console.error (error));

이 예에서는 ERC-20 토큰 계약의 transfer() 함수가 호출됩니다. .send() 메소드는 트랜잭션을 실행하는 데 사용됩니다. 발신자의 주소와 가스 제한이 필요합니다. transactionHash , receipt 및 error 와 같은 이벤트를 사용하여 트랜잭션 상태를 모니터링 할 수 있습니다.

거래를 보내기 전에 개인 키를 안전하게 처리하는 것이 중요합니다. 프로덕션 코드에서 하드 코딩하지 말고 메타 마스크 또는 하드웨어 지갑과 같은 지갑 서비스를 사용하여 보안을 개선하십시오.

이벤트 처리 및 계약 로그 청취

스마트 계약은 특정 조치가 발생하면 이벤트를 방출 할 수 있습니다. 이 이벤트는 블록 체인의 로그에 저장되며 Web3.js를 사용하여 모니터링 할 수 있습니다. 이는 사용자 작업, 계약 업데이트 또는 시스템 경고를 추적하는 데 유용합니다.

 contract.events.Transfer({
 fromBlock: 0,
 toBlock: 'latest'
 })
 .on('data', event => console.log(event))
 .on('error', error => console.error(error));

위의 코드는 계약에 의해 방출되는 모든 Transfer 이벤트에 대해 경청합니다. fromBlock 및 toBlock 매개 변수는 이벤트를 검색 할 블록 범위를 정의합니다. 이 기능을 통해 개발자는 온쇄 활동에 반응하는 실시간 응용 프로그램을 구축 할 수 있습니다.

필터를 사용하여 특정 기준에 따라 이벤트를 좁힐 수도 있습니다. 예를 들어, 필터링은 특정 주소로 전송됩니다.

 contract.events.Transfer({
 filter: { to: '0xRecipientAddress' },
 fromBlock: 0,
 toBlock: 'latest'
 })
 .on('data', event => console.log(event));

---

자주 묻는 질문

Q : web3.js의 Call ()와 send ()의 차이점은 무엇입니까?

A : call() 메소드는 상태를 수정하지 않고 블록 체인의 데이터를 읽는 데 사용되며 가스가 필요하지 않습니다. send() 메소드는 블록 체인 상태를 변경하고 가스 수수료가 필요한 트랜잭션을 실행하는 데 사용됩니다.

Q : 개인 키없이 스마트 계약과 상호 작용할 수 있습니까?

A : 예, 개인 키없이 call() 사용하여 읽기 작업을 수행 할 수 있습니다. 그러나 send() 사용하여 쓰기 작업에는 가스 비용을 지불하기에 충분한 에테르가있는 유효한 이더 리움 계정이 필요합니다.

Q : 배포 된 스마트 계약의 ABI를 어떻게 얻습니까?

A : ABI는 견고성 코드를 컴파일 할 때 생성됩니다. 계약이 이미 배포 된 경우 계약의 소스 코드가 확인되면 Etherscan과 같은 블록 탐색기에서 ABI를 검색 할 수 있습니다.

Q : 거래가 고정되면 어떻게해야합니까?

A : Etherscan과 같은 도구를 사용하여 거래 상태를 확인하거나 receipt 과 같은 이벤트를 들으면서 거래 상태를 확인할 수 있습니다. 거래가 너무 오랫동안 계류중인 경우 가스 가격을 인상하고 재판매해야 할 수도 있습니다.