Web3.js를 사용한 스마트 계약 상호작용 가이드

스마트 계약 상호 작용 기본 사항 이해

1. 스마트 계약은 이더리움 블록체인에 상주하며 검열, 가동 중지 시간 또는 제3자의 간섭 가능성 없이 프로그래밍된 대로 정확하게 코드를 실행합니다.

2. Web3.js는 HTTP 또는 IPC 연결을 통해 Ethereum 노드와 상호 작용할 수 있는 JavaScript 라이브러리 역할을 합니다.

3. 모든 계약 상호 작용에는 상태 데이터를 읽거나 새 상태를 작성하는 것이 필요하며, 각각에는 서로 다른 트랜잭션 처리 논리가 필요합니다.

4. ABI(Application Binary Interface)는 계약의 인터페이스 정의 역할을 하며 함수, 입력, 출력 및 이벤트 서명을 JSON 형식으로 지정합니다.

5. 계약 주소는 네트워크에 배포되고 Web3.js에서 인스턴스화하는 데 필요한 불변의 20바이트 16진수 식별자입니다.

Web3.js 환경 설정

1. Node.js 프로젝트에서 npm install web3을 사용하여 npm을 통해 Web3.js를 설치하거나 브라우저 기반 애플리케이션에 CDN을 통해 포함합니다.

2. Ethereum 노드(로컬 Geth/Parity, Infura, Alchemy 또는 MetaMask 주입 공급자)에 연결하여 Web3 인스턴스를 초기화합니다.

3. window.ethereum 으로 MetaMask 존재를 감지하고 ethereum.request({ method: 'eth_requestAccounts' }) 를 사용하여 사용자 계정을 요청합니다.

4. web3.eth.defaultAccount를 사용하여 트랜잭션 서명을 위한 기본 계정을 설정하거나 트랜잭션 개체 에서 명시적으로 전달합니다.

5. 노드가 응답하면 true로 확인되는 약속을 반환하는 web3.eth.net.isListening()을 호출하여 연결 상태를 확인합니다.

계약 배포 및 인스턴스화

1. solc-js 또는 Hardhat을 사용하여 Solidity 소스 코드를 컴파일하여 바이트코드 및 ABI 아티팩트를 생성합니다.

2. new web3.eth.Contract(abi) 를 사용하여 계약 객체를 생성한 다음 contract.deploy({ data: bytecode, Arguments: [...] }) 를 사용하여 배포합니다.

3. 가스 추정이 contract.deploy().estimateGas() 에 의존하는 send({ from: account, gas: estimateGas }) 를 사용하여 배포 트랜잭션을 보냅니다.

4. 마이닝 후 거래 영수증의 contractAddress 필드에서 배포된 주소를 검색합니다.

5. 새로운 web3.eth.Contract(abi, contractAddress) 를 사용하여 기존 계약을 인스턴스화하여 읽기/쓰기 작업을 시작합니다.

계약 읽기 및 쓰기

1. contract.methods.methodName().call({ from: account })을 사용하여 상수 함수(marked view 또는 pure )를 호출합니다. 가스 비용이 발생하지 않습니다.

2. contract.methods.methodName().send({ from: account, value: weiAmount, gas:limit }) 를 사용하여 상태 수정 함수를 트리거합니다.

3. 가스 부족 오류를 방지하려면 contract.methods.methodName().estimateGas({ from: account }) 를 통해 전송하기 전에 필요한 가스를 추정하세요.

4. 로그, 상태, 블록 번호, 확인 시 사용된 누적 가스가 포함된 거래 영수증을 처리합니다.

5. contract.events.EventName({ fromBlock: 0 })을 사용하여 계약 이벤트를 구독하고 실시간 업데이트를 위한 콜백 핸들러를 연결합니다.

일반적인 질문과 답변

Q: Web3.js는 Ethereum 이외의 네트워크의 계약과 상호 작용할 수 있습니까? 답: 그렇습니다. Web3.js는 RPC 엔드포인트와 체인 ID가 올바르게 구성된 경우 BNB Chain, Polygon, Arbitrum 및 Optimism을 포함한 모든 EVM 호환 체인을 지원합니다.

Q: 계약 실행 중에 계약 기능이 되돌리면 어떻게 되나요? A: Solidity 0.8.0 이상으로 컴파일되고 디버그 추적을 통해 활성화된 경우 트랜잭션이 실패하고 할당된 가스를 모두 소비하며 되돌리기 이유 문자열이 포함된 오류가 발생합니다.

Q: ABI와 컨트랙트 주소를 공개적으로 노출해도 안전한가요? 답: 그렇습니다. 둘 다 공개 유물입니다. ABI는 인터페이스 구조를 정의하며 주소는 온체인의 투명한 식별자이며 무단 액세스나 제어를 허용하지 않습니다.

Q: ERC-20 토큰으로 작업할 때 소수점 정밀도를 어떻게 처리합니까? A: 계약 방법으로 전달하기 전에 토큰 금액에 10^십진수를 곱합니다. ETH에는 web3.utils.toWei()를 사용하고 표시 형식 지정에는 web3.utils.fromWei()를 사용합니다.