什麼是智能合同ABI（應用程序二進制界面）？

ABI充當高級智能合同代碼和EVM之間的橋樑，通過結構化功能定義使與已部署的合同的無縫互動。

2025/07/07 10:36

了解智能合約ABI的基礎知識

在智能合約的世界中，尤其是在以太坊和其他與EVM兼容的區塊鏈中， ABI（應用二進制界面）一詞起著至關重要的作用。 ABI本質上是定義如何在二進制級別與智能合約互動的規範。它充當高級編程語言（如堅固性或Vyper）與以太坊虛擬機（EVM）上運行的低級字節碼之間的橋樑。沒有ABI，外部應用程序將無法調用功能或從部署的智能合約中讀取數據。

ABI包含有關合同中每個功能的詳細信息，包括其名稱，輸入參數，輸出類型以及是否修改狀態（應付付款，查看，純）。這種結構化格式可確保開發人員和分散應用程序可以與基於區塊鏈的合同無縫通信。

智能合同ABI的結構和組成部分

典型的ABI定義表示為JSON數組，其中每個元素對應於智能合約中的函數或事件。每個條目包括幾個關鍵字段：

• 名稱：功能或事件的名稱。
• 類型：可以是“函數”，“事件”或“錯誤”。
• 輸入：描述輸入參數（用於函數）或索引主題（事件）的一系列對象。
• 輸出：對於函數，這描述了返回的值。
• 具有辯護性：指示該函數是否更改狀態（“不可付費”，“應付款”）或不更改它（'view'，'pure'）。

例如，考慮一個簡單的功能：

 function add(uint a, uint b) public pure returns (uint)

其相應的ABI條目將包括uint256類型的A和b名稱add function ， a和B的輸入，並輸出返回單個uint256輸出。

開發人員如何在實踐中使用ABI

當部署或與智能合約進行交互時，開發人員通常使用SOLC或REMIX IDE等工具編制其堅固代碼。這些工俱生成兩個主要文件：字節碼（已部署到區塊鏈）和ABI文件（用於交互的鏈中）。

要從Web應用程序中調用已部署合同的函數，開發人員使用諸如ethers.js或web3.js之類的庫。這些庫需要合同ABI和合同地址來創建接口對象。創建後，開發人員可以調用功能或收聽合同發出的事件。

這是使用ethers.js的簡化工作流程：

• 將ABI加載到您的JavaScript環境中。
• 連接到以太坊提供商（例如Infura或Alchemy）。
• 使用ABI和合同地址創建合同實例。
• 使用實例致電或發送交易轉換到合同方法。

此過程允許分散應用程序和區塊鏈邏輯之間的無縫集成。

生成和提取ABI文件

為了產生ABI ，開發人員通常依靠堅固的編譯器或開發框架。以下是使用SOLC手動提取ABI的步驟：

• 通過NPM（ npm install -g solc ）安裝實體編譯器。
• 將您的堅固合同保存在.sol文件中。
• 運行彙編命令：

   solcjs --abi YourContract.sol

• 所得文件將命名為YourContract_sol_YourContract.abi 。

使用HardHat或Truffle ，在運行npx hardhat compile後， ABI會自動生成artifacts目錄內部。您可以在下面找到它：

 artifacts/contracts/YourContract.sol/YourContract.json

該JSON文件同時包含ABI和字節碼，從而易於通過編程方式部署和與合同進行交互。

與ABIS合作時的常見錯誤

開發人員面臨的最常見問題之一是不匹配的ABI 。如果前端中使用的ABI與已部署的合同不匹配，則功能調用可能會失敗或返回意外結果。這可能發生時發生：

• 在不更新ABI的情況下部署新版本的合同。
• 使用截短或不完整的ABI文件。
• 手動將ABI複製，並缺少JSON結構的部分。

另一個頻繁的問題是對ABI中的元組類型或數組的處理不正確。開發人員必須確保在閱讀合同響應時正確解碼複雜的返回類型。 Ethers.js之類的庫提供內置的解碼機制，但使用不當會導致運行時錯誤。

此外，事件和日誌還依靠ABI進行適當的解碼。如果事件的ABI丟失或不正確，則無法有意義地解析從區塊鏈中檢索的日誌數據。

ABI編碼和解碼解釋

當按智能合約調用函數時，必鬚根據ABI規範編碼該參數作為交易的一部分。同樣，當函數返回值時，響應需要將響應解碼回可讀數據。

編碼遵循基於數據類型的特定規則。例如：

• UINT256值填充到32個字節。
• 字符串和字節用長度進行編碼，然後是實際數據。
• 按照嚴格的對齊規則，對數組和結構進行了遞歸編碼。

解碼相反。當收到交易收據或呼叫結果時， ABI解碼器使用函數簽名和返回類型將原始字節解析為有意義的值。當使用需要準確解釋區塊鏈數據的鍊鍊系統時，這一點尤其重要。

諸如ethers.utils.abicoder之類的庫提供了手動編碼和解碼數據的實用程序，這對於高級用例（例如自定義簽名或批處理交易）很有用。

---

常見問題（常見問題解答）

我可以將同一ABI用於合同的不同版本嗎？

不，每個版本的合同都應該擁有自己獨特的ABI 。功能名稱，參數或返回類型的更改會改變ABI ，並且使用過時的ABI可能會導致不正確的交互或失敗。

在哪裡可以找到以太坊部署合同的ABI？

您可以從像Etherscan這樣的Block Explorer中檢索ABI 。導航到合同地址，單擊“合同”選項卡，然後查找讀取合同或寫合同部分。一些合同還通過API或文檔公開發布其ABI 。

合同部署需要ABI嗎？

不，部署過程中不需要ABI 。部署僅需要字節碼。但是，後來， ABI對於與外部應用程序部署的合同進行互動至關重要。

如果我失去合同的ABI會發生什麼？

如果您無法訪問ABI ，則無法使用標準工具與合同進行交互。在某些情況下，您可以通過檢查合同源代碼或使用分解器來重建ABI ，但這並不總是可靠的。