스마트 계약 ABI 란 무엇입니까?

Smart Contract ABI는 인터페이스 역할을하여 앱 및 지갑이 기능 및 이벤트가 인코딩 및 디코딩되는 방식을 정의하여 블록 체인 계약과 상호 작용할 수있게합니다.

2025/07/21 18:07

스마트 계약 ABI의 개념 이해

스마트 계약 ABI 또는 애플리케이션 바이너리 인터페이스는 블록 체인 및 스마트 계약 개발의 세계에서 중요한 구성 요소입니다. 이는 개발자가 작성한 고급 코드와 EVM (Ethereum Virtual Machine) 또는 기타 호환 블록 체인 환경에서 발생하는 저수준 상호 작용 사이의 브리지 역할을합니다. ABI는 스마트 계약과 상호 작용할 때 데이터를 인코딩 및 디코딩하는 방법을 정의하여 외부 응용 프로그램, 지갑 또는 기타 계약이 효과적으로 통신 할 수 있도록합니다.

ABI는 기본적으로 스마트 계약의 기능과 이벤트를 표준화 된 형식으로 자세히 설명하는 인터페이스 역할을합니다 . 이를 통해 개발자는 EVM의 내부 역학을 이해하지 않고도 web3.js 또는 ethers.js와 같은 도구를 사용하여 계약과 상호 작용할 수 있습니다.

스마트 계약 ABI의 구조

ABI는 JSON 배열로 표시되며 각 요소는 스마트 계약의 함수 또는 이벤트에 해당합니다. 각 항목에는 동작 및 예상 입력 또는 출력을 정의하는 몇 가지 주요 필드가 포함되어 있습니다.

• 유형 : 항목이 함수, 이벤트 또는 오류인지 지정합니다.
• 이름 : 함수 또는 이벤트의 이름.
• 입력 : 함수에 필요한 매개 변수를 설명하거나 이벤트에 의해 방출되는 배열. 각 입력에는 이름, 유형 및 이벤트에 대한 인덱스 상태가 포함됩니다.
• 출력 : 함수의 경우이 배열은 리턴 값을 설명합니다.
• 법정 : 함수가 상태가 변경되는지 (지불 할 수없고, 지불 할 수,보기 또는 순수한지를 나타냅니다.
• 익명 : 이벤트가 익명인지를 나타내는 행사에 사용되는 부울.

예를 들어, 매개 변수 _to 및 _amount 있는 transfer 이라는 기능은 ABI에 각각 유형 ( address 및 uint256 )을 지정하는 항목과 호출 할 때 인코딩하는 방법을 갖습니다.

ABI가 현명한 계약 상호 작용을 촉진하는 방법

개발자가 배포 된 스마트 계약에서 함수를 호출하려면 ABI는 EVM이 이해할 수있는 기능 호출을 바이트 코드로 인코딩하는 데 사용됩니다 . 마찬가지로 함수가 데이터를 반환하면 ABI는 응답을 다시 읽을 수있는 값으로 다시 해독하는 데 도움이됩니다 .

예를 들어, Ethers.js 라이브러리를 사용하여 개발자는 주소와 ABI를 제공하여 계약에 연결할 수 있습니다. 이를 통해 라이브러리는 계약 방법에 해당하는 JavaScript 기능을 생성 할 수 있습니다. balanceOf(address) 와 같은 함수가 호출되면 ABI는 주소가 올바르게 인코딩되고 반환 된 잔액이 올바르게 해석되도록합니다 .

이 프로세스는 모든 당사자가 동일한 방식으로 데이터를 해석 할 수 있도록 지갑 통합, DAPP (Depentralized Applications) 및 계약 간 통신 에 필수적입니다.

ABI 생성 및 액세스

Solidity Smart 계약을 편집하는 동안 SOLC (Solidity Compiler) 또는 Truffle 과 같은 도구는 바이트 코드와 함께 ABI를 자동으로 생성합니다. 개발자는 편집 후 ABI를 다운로드 할 수있는 Remix IDE를 사용할 수도 있습니다.

컴파일 된 계약에서 ABI를 수동으로 추출하려면 :

• 리믹스 IDE 에서 컴파일 된 계약을 엽니 다.
• '컴파일 세부 사항' 섹션으로 이동하십시오.
• '아비'탭을 클릭하십시오.
• JSON 형식 ABI를 복사하거나 다운로드하십시오.

트러플 프로젝트 에서 ABI는 truffle compile 실행 한 후 build/contracts 디렉토리에 저장됩니다. 개발자는이 ABI를 프론트 엔드 애플리케이션 또는 기타 스마트 계약으로 가져와 커뮤니케이션을 설정할 수 있습니다.

실제로 ABI 사용 : 단계별 예제

ABI가 실제로 어떻게 사용되는지 보여주기 위해 web3.js를 사용하여 간단한 예제를 통해 ERC-20 토큰 계약과 상호 작용하십시오.

• Ropsten과 같은 TestNet에 ERC-20 계약을 배치하거나 Ganache와 같은 로컬 개발 블록 체인을 사용하십시오.
• Solidity 컴파일러를 사용하여 계약을 컴파일 하고 ABI를 검색하십시오 .
• NPM을 사용하여 프로젝트에 web3.js를 설치하십시오 .

   npm install web3

• Web3 가져 오기 및 제공자 초기화 :

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

• 계약 주소와 ABI를 제공하십시오 .

   const contractAddress = '0x...';
   const abi = [ / ABI JSON here / ];

• 계약 인스턴스 생성 :

   const contract = new web3.eth.Contract(abi, contractAddress);

• balanceOf 와 같은 함수를 호출하십시오 .

   contract.methods.balanceOf('0x...').call()
   .then(balance => console.log(web3.utils.fromWei(balance, 'ether')));

이 예제는 ABI가 개발자가 프로그래밍 방식으로 스마트 계약과 상호 작용하여 EVM 상호 작용의 복잡성을 추상화 할 수있는 방법을 보여줍니다.

스마트 계약 ABI의 일반적인 사용 사례

ABI는 다양한 블록 체인 응용 분야에서 중추적 인 역할을합니다 . 가장 일반적인 사용 사례 중 일부는 다음과 같습니다.

• 지갑 통합 : 메타 마스크와 같은 지갑은 ABI를 사용하여 맞춤형 토큰 및 계약을 인식하고 상호 작용합니다.
• 분산 금융 (DEFI) 플랫폼 : Uniswap 또는 AAVE와 같은 프로토콜은 ABI에 의존하여 다양한 토큰 및 대출 풀과 통합됩니다.
• 스마트 계약 테스트 : 개발자는 테스트 중에 ABI를 사용하여 상호 작용을 시뮬레이션하고 예상 결과를 확인합니다.
• 블록 체인 탐색기 : Etherscan과 같은 플랫폼은 ABI를 사용하여 트랜잭션 데이터를 해독하고 사람이 읽을 수있는 기능 호출 및 이벤트 로그를 표시합니다.

ABI가 없으면 이러한 애플리케이션은 사용자와 스마트 계약간에 교환 된 원시 16 진수 데이터를 해석하기 위해 어려움을 겪어 블록 체인 개발의 기본 요소가 될 것입니다.

---

자주 묻는 질문

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

A : 바이트 코드 만 사용하여 계약과 상호 작용하는 것이 기술적으로 가능하지만 매우 어렵고 실용적이지 않습니다. ABI는 기능 서명 및 이벤트 구조를 이해하는 데 필요한 메타 데이터를 제공하여 대부분의 개발 워크 플로우에 필수적입니다.

Q : 각 스마트 계약마다 ABI가 독특합니까?

A : ABI는 계약의 인터페이스에 따라 다릅니다 . 즉, 동일한 기능 및 이벤트를 가진 두 계약이 동일한 ABI를 갖습니다. 그러나 계약 코드, 특히 기능 이름 또는 매개 변수가 변경되면 ABI도 변경됩니다.

Q : Etherscan에서 계약의 ABI를 어떻게 확인합니까?

A : Etherscan에서는 소스 코드를 제공하여 계약을 확인할 수 있습니다. 일단 확인되면 플랫폼은 '계약'탭에 자동으로 ABI를 생성하고 표시하므로 사용자와 개발자가 통합 목적으로 액세스 할 수 있습니다.

Q : 계약을 배치 한 후 ABI를 수정할 수 있습니까?

A : ABI는 계약의 소스 코드에서 파생되므로 계약 기능 또는 이벤트에 대한 변경으로 인해 새로운 ABI가 발생합니다. 블록 체인은 불변이기 때문에 배치 된 계약의 ABI를 재배치하지 않고 변경할 수 없습니다.