以太坊 方法签名
最近在工作中使用web3j調用合約,發(fā)現一個比較頭疼的問題?復雜一點的合約參數多了,函數的方法簽名老是出錯。在這之前調用合約方法一直都是拼接合約的函數簽名以及參數。為了能快速的獲取每個合約的函數簽名,我在思考是否便捷可行解決方案?而不是使用老套的方法,在remix IDE中編寫函數,用其編譯獲取函數簽名。
通常以太坊合約開發(fā)后,需要先進行編譯,部署時需要二進制字節(jié)編碼bytecode,或者是abi文件。其中abi文件是合約函數,變量,事件組成的一組輸入輸出的json串。而bytecode是根據abi文件生成的二進制字節(jié)碼。其中bytecode包含了合約中函數簽名。那bytecode的函數簽名是如何生成的呢?什么又是函數簽名?
?
一.以太坊函數簽名
區(qū)塊鏈中合約代碼執(zhí)行,需要指定某個合約地址的某個函數,其中這個執(zhí)行的函數是使用Keccak-256(SHA-3)編碼后的散列,取散列的前四個字節(jié)作為函數簽名。官方定義:"簽名被定義為沒有數據位置說明符的基本原型規(guī)范表達式,即具有帶括號的參數類型列表的函數名稱"。通俗的說就是:將函數名,帶順序的變量類型以及參數括號進行Keccak-256編碼后,取前四個字節(jié)的二進制字符串,即以太坊的合約函數簽名。
?
二.函數簽名生成
在java中可以使用bcpkix-jdk15on工具類的Keccak.Digest256將合約函數方法名及參數類型做hash計算,轉換成16進制后取前8位的四個字節(jié)。
代碼如下:
Keccak.Digest256 digest256 = new Keccak.Digest256();
System.out.println(Hex.toHexString(digest256.digest("setMap(bytes32,string,address[],bytes32)".getBytes())).substring(0, 8));
可以得到此函數簽名為:dc913337
還有一種特殊的簽名,叫event事件簽名:
Keccak.Digest256 digest256 = new Keccak.Digest256();?
System.out.println(Hex.toHexString(digest256.digest("LogCreate(address)".getBytes())));
得到的事件簽名值:
b8f132fb6526e0405f3ce4f3bab301f1d4409b1e7f2c01c2037d6cf845c831cb
關于合約函數簽名文檔生成,我在業(yè)余時間寫了個java小工具,目前已在github上開源,地址已經放在文末。那么為什么需要這個合約簽名文檔呢?
?
三.開發(fā)協(xié)調
以太坊合約函數簽名文檔,可以理解成接口文檔,主要作用有:
第一:由于合約開發(fā)者和合約調用者,可能是不同的開發(fā)人員。調用合約者需要知道合約的函數簽名,同時也可以驗證自己拼接的函數簽名以及參數是否正確。
第二:調用者需要知道合約原始的方法名以及參數類型,尤其是明確需要知道參數的順序,否則無法生成正確的函數簽名。那么此時就需要合約方法的文檔來作為調用者參考媒介。出于此功能的需要,就自己動手豐衣足食做了個規(guī)范化的合約函數簽名文檔生成工具。
在生成合約函數簽名文檔之前,需要使用truffle或者solc。truffle是以太坊合約開發(fā)的腳手架,使用truffle將完成開發(fā)的合約編譯成json文件。或者使用solc將合約編譯成abi文件。最后使用 ethSignUtil.jar 工具生成函數簽名文檔以及合約接口文檔。簡單看下效果圖
函數簽名:
?
合約接口:
?
?
關于合約函數簽名文檔生成的具體用法,請移步至github:
https://github.com/zhjgit/Ethereum-util
?
持續(xù)關注"刻意鏈習"公眾號,獲取更多區(qū)塊鏈技術知識。轉載請注明文章出處,原創(chuàng)技術貼,侵權必糾。
? ? ? ? ? ? ?
轉載于:https://www.cnblogs.com/sumingk/articles/10091305.html
總結
- 上一篇: windows下vagrant的安装使用
- 下一篇: 20165333 我期望的师生关系