最新內容會更新在主站深入淺出區塊鏈社群
原文連結:如何理解以太坊ABI - 應用程式二進位制介面
很多同學不是很明白以太坊ABI是什麼,他的作用是什麼,讀完本文就明白了。
寫在前面
閱讀本文前,你應該對以太坊、智慧合約有所瞭解,
如果你還不瞭解,建議你先看以太坊是什麼,也可以觀看我們的視訊:零基礎搞懂區塊鏈和深入詳解以太坊智慧合約語言Solidity, 可以系統全面學習理解以太坊、智慧合約。
ABI 是什麼
ABI 全稱是 Application Binary Interface,翻譯過來就是:應用程式二進位制介面,簡單來說就是 以太坊的呼叫合約時的介面說明。還不是很理解,沒關係。
呼叫合約函式發生了什麼
從外部施加給以太坊的行為都稱之為向以太坊網路提交了一個交易, 呼叫合約函式其實是向合約地址(賬戶)提交了一個交易,這個交易有一個附加資料,這個附加的資料就是ABI的編碼資料。
比特幣的交易也可以附加資料,以太坊革命性的地方就是能把附加資料轉化為都函式的執行。
因此要想和合約互動,就離不開ABI資料。
演示呼叫函式
以下面以個最簡單的合約為例,我們看看用引數 1 呼叫set(uint x)
,這個交易附帶的資料是什麼。
pragma solidity ^0.4.0;
contract SimpleStorage {
uint storedData;
function set(uint x) public {
storedData = x;
}
function get() public constant returns (uint) {
return storedData;
}
}
當然第一步需要先把合約部署到以太坊網路(其實部署也是一個)上,然後用 “1” 作為引數呼叫set,如下圖:
然後我們開啟etherscan檢視交易詳情資料, 可以看到其附加資料如下圖:
這個資料就是ABI的編碼資料:
0x60fe47b10000000000000000000000000000000000000000000000000000000000000001
ABI 編碼分析
我把上面交易的附加資料拷貝出來分析一下,這個資料可以分成兩個子部分:
函式選擇器(4位元組)
0x60fe47b1第一個引數(32位元組)
00000000000000000000000000000000000000000000000000000000000000001
函式選擇器值 實際是對函式簽名字串進行sha3(keccak256)雜湊運算之後,取前4個位元組,用程式碼表示就是:
bytes4(sha3(“set(uint256)”)) == 0x60fe47b1
引數部分則是使用對應的16進位制數。
現在就好理解 附加資料怎麼轉化為對應的函式呼叫。
ABI 編碼函式
那麼怎麼獲得函式對應的ABI 資料呢, 有兩種方法:
Solidity ABI 編碼函式
一個是 solidity 提供了ABI的相關API, 用來直接得到ABI編碼資訊,這些函式有:
- abi.encode(...) returns (bytes):計算引數的ABI編碼。
- abi.encodePacked(...) returns (bytes):計算引數的緊密打包編碼
- abi. encodeWithSelector(bytes4 selector, ...) returns (bytes): 計算函式選擇器和引數的ABI編碼
- abi.encodeWithSignature(string signature, ...) returns (bytes): 等價於* abi.encodeWithSelector(bytes4(keccak256(signature), ...)
通過ABI編碼函式可以在不用呼叫函式的情況下,獲得ABI編碼值,下面通過一段程式碼來看看這些方法的使用:
pragma solidity ^0.4.24;
contract testABI {
uint storedData;
function set(uint x) public {
storedData = x;
}
function abiEncode() public constant returns (bytes) {
abi.encode(1); // 計算1的ABI編碼
return abi.encodeWithSignature("set(uint256)", 1); //計算函式set(uint256) 及引數1 的ABI 編碼
}
}
大家可以執行執行下abiEncode
函式,它的輸出其實就是前面呼叫的附加資料。
Web3 ABI 編碼函式
另一個web3提供相應的API,例如使用web3計算函式選擇器的方式如下:
web3.eth.abi.encodeFunctionSignature('myMethod(uint256,string)');
其完整的文件在這裡,這裡不一一演示。
歡迎來知識星球提問,星球內已經聚集了300多位區塊鏈技術愛好者。
深入淺出區塊鏈 - 系統學習區塊鏈,打造最好的區塊鏈技術部落格。