開發(fā)框架。level1編程項目這是一個基于go語言編寫的,自動化測試以太坊智能合約的開發(fā)框架,使用此框架,可以自動化的部署合約,自動測試合約內(nèi)的功能函數(shù)。
成都創(chuàng)新互聯(lián)公司,為您提供成都網(wǎng)站建設(shè)、網(wǎng)站制作、網(wǎng)站營銷推廣、網(wǎng)站開發(fā)設(shè)計,對服務(wù)垃圾桶等多個行業(yè)擁有豐富的網(wǎng)站建設(shè)及推廣經(jīng)驗。成都創(chuàng)新互聯(lián)公司網(wǎng)站建設(shè)公司成立于2013年,提供專業(yè)網(wǎng)站制作報價服務(wù),我們深知市場的競爭激烈,認真對待每位客戶,為客戶提供賞心悅目的作品。 與客戶共同發(fā)展進步,是我們永遠的責(zé)任!
在這個章節(jié)中我們會介紹如何用Go來編譯,部署,寫入和讀取智能合約。
與智能合約交互,我們要先生成相應(yīng)智能合約的應(yīng)用二進制接口ABI(application binary interface),并把ABI編譯成我們可以在Go應(yīng)用中調(diào)用的格式。
第一步是安裝 Solidity編譯器 ( solc ).
Solc 在Ubuntu上有snapcraft包。
Solc在macOS上有Homebrew的包。
其他的平臺或者從源碼編譯的教程請查閱官方solidity文檔 install guide .
我們還得安裝一個叫 abigen 的工具,來從solidity智能合約生成ABI。
假設(shè)您已經(jīng)在計算機上設(shè)置了Go,只需運行以下命令即可安裝 abigen 工具。
我們將創(chuàng)建一個簡單的智能合約來測試。 學(xué)習(xí)更復(fù)雜的智能合約,或者智能合約的開發(fā)的內(nèi)容則超出了本書的范圍。 我強烈建議您查看 truffle framework 來學(xué)習(xí)開發(fā)和測試智能合約。
這里只是一個簡單的合約,就是一個鍵/值存儲,只有一個外部方法來設(shè)置任何人的鍵/值對。 我們還在設(shè)置值后添加了要發(fā)出的事件。
雖然這個智能合約很簡單,但它將適用于這個例子。
現(xiàn)在我們可以從一個solidity文件生成ABI。
它會將其寫入名為“Store_sol_Store.abi”的文件中
現(xiàn)在讓我們用 abigen 將ABI轉(zhuǎn)換為我們可以導(dǎo)入的Go文件。 這個新文件將包含我們可以用來與Go應(yīng)用程序中的智能合約進行交互的所有可用方法。
為了從Go部署智能合約,我們還需要將solidity智能合約編譯為EVM字節(jié)碼。 EVM字節(jié)碼將在事務(wù)的數(shù)據(jù)字段中發(fā)送。 在Go文件上生成部署方法需要bin文件。
現(xiàn)在我們編譯Go合約文件,其中包括deploy方法,因為我們包含了bin文件。
在接下來的課程中,我們將學(xué)習(xí)如何部署智能合約,然后與之交互。
Commands
Store.sol
solc version used for these examples
如果你還沒看之前的章節(jié),請先學(xué)習(xí) 編譯智能合約的章節(jié) 因為這節(jié)內(nèi)容,需要先了解如何將智能合約編譯為Go文件。
假設(shè)你已經(jīng)導(dǎo)入從 abigen 生成的新創(chuàng)建的Go包文件,并設(shè)置ethclient,加載您的私鑰,下一步是創(chuàng)建一個有配置密匙的交易發(fā)送器(tansactor)。 首先從go-ethereum導(dǎo)入 accounts/abi/bind 包,然后調(diào)用傳入私鑰的 NewKeyedTransactor 。 然后設(shè)置通常的屬性,如nonce,燃氣價格,燃氣上線限制和ETH值。
如果你還記得上個章節(jié)的內(nèi)容, 我們創(chuàng)建了一個非常簡單的“Store”合約,用于設(shè)置和存儲鍵/值對。 生成的Go合約文件提供了部署方法。 部署方法名稱始終以單詞 Deploy 開頭,后跟合約名稱,在本例中為 Store 。
deploy函數(shù)接受有密匙的事務(wù)處理器,ethclient,以及智能合約構(gòu)造函數(shù)可能接受的任何輸入?yún)?shù)。我們測試的智能合約接受一個版本號的字符串參數(shù)。 此函數(shù)將返回新部署的合約地址,事務(wù)對象,我們可以交互的合約實例,還有錯誤(如果有)。
就這么簡單:)你可以用事務(wù)哈希來在Etherscan上查詢合約的部署狀態(tài):
Commands
Store.sol
contract_deploy.go
solc version used for these examples
這寫章節(jié)需要了解如何將智能合約的ABI編譯成Go的合約文件。如果你還沒看, 前先讀 上一個章節(jié) 。
一旦使用 abigen 工具將智能合約的ABI編譯為Go包,下一步就是調(diào)用“New”方法,其格式為“Newcontractname style="box-sizing: border-box; font-size: 16px; -ms-text-size-adjust: auto; -webkit-tap-highlight-color: transparent;"”,所以在我們的例子中如果你 回想一下它將是 NewStore 。 此初始化方法接收智能合約的地址,并返回可以開始與之交互的合約實例。/contractname
Commands
Store.sol
contract_load.go
solc version used for these examples
這寫章節(jié)需要了解如何將智能合約的ABI編譯成Go的合約文件。如果你還沒看, 前先讀 上一個章節(jié) 。
在上個章節(jié)我們學(xué)習(xí)了如何在Go應(yīng)用程序中初始化合約實例。 現(xiàn)在我們將使用新合約實例提供的方法來閱讀智能合約。 如果你還記得我們在部署過程中設(shè)置的合約中有一個名為 version 的全局變量。 因為它是公開的,這意味著它們將成為我們自動創(chuàng)建的getter函數(shù)。 常量和view函數(shù)也接受 bind.CallOpts 作為第一個參數(shù)。了解可用的具體選項要看相應(yīng)類的 文檔 一般情況下我們可以用 nil 。
Commands
Store.sol
contract_read.go
solc version used for these examples
這寫章節(jié)需要了解如何將智能合約的ABI編譯成Go的合約文件。如果你還沒看, 前先讀 上一個章節(jié) 。
寫入智能合約需要我們用私鑰來對交易事務(wù)進行簽名。
我們還需要先查到nonce和燃氣價格。
接下來,我們創(chuàng)建一個新的keyed transactor,它接收私鑰。
然后我們需要設(shè)置keyed transactor的標準交易選項。
現(xiàn)在我們加載一個智能合約的實例。如果你還記得 上個章節(jié) 我們創(chuàng)建一個名為 Store 的合約,并使用 abigen 工具生成一個Go文件。 要初始化它,我們只需調(diào)用合約包的 New 方法,并提供智能合約地址和ethclient,它返回我們可以使用的合約實例。
我們創(chuàng)建的智能合約有一個名為 SetItem 的外部方法,它接受solidity“bytes32”格式的兩個參數(shù)(key,value)。 這意味著Go合約包要求我們傳遞一個長度為32個字節(jié)的字節(jié)數(shù)組。 調(diào)用 SetItem 方法需要我們傳遞我們之前創(chuàng)建的 auth 對象(keyed transactor)。 在幕后,此方法將使用它的參數(shù)對此函數(shù)調(diào)用進行編碼,將其設(shè)置為事務(wù)的 data 屬性,并使用私鑰對其進行簽名。 結(jié)果將是一個已簽名的事務(wù)對象。
現(xiàn)在我就可以看到交易已經(jīng)成功被發(fā)送到了以太坊網(wǎng)絡(luò)了:
要驗證鍵/值是否已設(shè)置,我們可以讀取智能合約中的值。
搞定!
Commands
Store.sol
contract_write.go
solc version used for these examples
有時您需要讀取已部署的智能合約的字節(jié)碼。 由于所有智能合約字節(jié)碼都存在于區(qū)塊鏈中,因此我們可以輕松獲取它。
首先設(shè)置客戶端和要讀取的字節(jié)碼的智能合約地址。
現(xiàn)在你需要調(diào)用客戶端的 codeAt 方法。 codeAt 方法接受智能合約地址和可選的塊編號,并以字節(jié)格式返回字節(jié)碼。
你也可以在etherscan上查詢16進制格式的字節(jié)碼
contract_bytecode.go
首先創(chuàng)建一個ERC20智能合約interface。 這只是與您可以調(diào)用的函數(shù)的函數(shù)定義的契約。
然后將interface智能合約編譯為JSON ABI,并使用 abigen 從ABI創(chuàng)建Go包。
假設(shè)我們已經(jīng)像往常一樣設(shè)置了以太坊客戶端,我們現(xiàn)在可以將新的 token 包導(dǎo)入我們的應(yīng)用程序并實例化它。這個例子里我們用 Golem 代幣的地址.
我們現(xiàn)在可以調(diào)用任何ERC20的方法。 例如,我們可以查詢用戶的代幣余額。
我們還可以讀ERC20智能合約的公共變量。
我們可以做一些簡單的數(shù)學(xué)運算將余額轉(zhuǎn)換為可讀的十進制格式。
同樣的信息也可以在etherscan上查詢:
Commands
erc20.sol
contract_read_erc20.go
solc version used for these examples
智能合約具有在執(zhí)行期間“發(fā)出”事件的能力。 事件在以太坊中也稱為“日志”。 事件的輸出存儲在日志部分下的事務(wù)處理中。 事件已經(jīng)在以太坊智能合約中被廣泛使用,以便在發(fā)生相對重要的動作時記錄,特別是在代幣合約(即ERC-20)中,以指示代幣轉(zhuǎn)賬已經(jīng)發(fā)生。 這些部分將引導(dǎo)您完成從區(qū)塊鏈中讀取事件以及訂閱事件的過程,以便交易事務(wù)被礦工打包入塊的時候及時收到通知。
為了訂閱事件日志,我們需要做的第一件事就是撥打啟用websocket的以太坊客戶端。 幸運的是,Infura支持websockets。
下一步是創(chuàng)建篩選查詢。 在這個例子中,我們將閱讀來自我們在之前課程中創(chuàng)建的示例合約中的所有事件。
我們接收事件的方式是通過Go channel。 讓我們從go-ethereum core/types 包創(chuàng)建一個類型為 Log 的channel。
現(xiàn)在我們所要做的就是通過從客戶端調(diào)用 SubscribeFilterLogs 來訂閱,它接收查詢選項和輸出通道。 這將返回包含unsubscribe和error方法的訂閱結(jié)構(gòu)。
最后,我們要做的就是使用select語句設(shè)置一個連續(xù)循環(huán)來讀入新的日志事件或訂閱錯誤。
我們會在下個章節(jié)介紹如何解析日志。
Commands
Store.sol
event_subscribe.go
智能合約可以可選地釋放“事件”,其作為交易收據(jù)的一部分存儲日志。讀取這些事件相當(dāng)簡單。首先我們需要構(gòu)造一個過濾查詢。我們從go-ethereum包中導(dǎo)入 FilterQuery 結(jié)構(gòu)體并用過濾選項初始化它。我們告訴它我們想過濾的區(qū)塊范圍并指定從中讀取此日志的合約地址。在示例中,我們將從在 智能合約章節(jié) 創(chuàng)建的智能合約中讀取特定區(qū)塊所有日志。
下一步是調(diào)用ethclient的 FilterLogs ,它接收我們的查詢并將返回所有的匹配事件日志。
返回的所有日志將是ABI編碼,因此它們本身不會非常易讀。為了解碼日志,我們需要導(dǎo)入我們智能合約的ABI。為此,我們導(dǎo)入編譯好的智能合約Go包,它將包含名稱格式為 ContractABI 的外部屬性。之后,我們使用go-ethereum中的 accounts/abi 包的 abi.JSON 函數(shù)返回一個我們可以在Go應(yīng)用程序中使用的解析過的ABI接口。
現(xiàn)在我們可以通過日志進行迭代并將它們解碼為我么可以使用的類型。若您回憶起我們的樣例合約釋放的日志在Solidity中是類型為 bytes32 ,那么Go中的等價物將是 [32]byte 。我們可以使用這些類型創(chuàng)建一個匿名結(jié)構(gòu)體,并將指針作為第一個參數(shù)傳遞給解析后的ABI接口的 Unpack 函數(shù),以解碼原始的日志數(shù)據(jù)。第二個參數(shù)是我們嘗試解碼的事件名稱,最后一個參數(shù)是編碼的日志數(shù)據(jù)。
此外,日志結(jié)構(gòu)體包含附加信息,例如,區(qū)塊摘要,區(qū)塊號和交易摘要。
若您的solidity事件包含 indexed 事件類型,那么它們將成為 主題 而不是日志的數(shù)據(jù)屬性的一部分。在solidity中您最多只能有4個主題,但只有3個可索引的事件類型。第一個主題總是事件的簽名。我們的示例合約不包含可索引的事件,但如果它確實包含,這是如何讀取事件主題。
正如您所見,首個主題只是被哈希過的事件簽名。
這就是閱讀和解析日志的全部內(nèi)容。要學(xué)習(xí)如何訂閱日志,閱讀上個章節(jié)。
命令
Store.sol
event_read.go
首先,創(chuàng)建ERC-20智能合約的事件日志的interface文件 erc20.sol :
然后在給定abi使用 abigen 創(chuàng)建Go包
現(xiàn)在在我們的Go應(yīng)用程序中,讓我們創(chuàng)建與ERC-20事件日志簽名類型相匹配的結(jié)構(gòu)類型:
初始化以太坊客戶端
按照ERC-20智能合約地址和所需的塊范圍創(chuàng)建一個“FilterQuery”。這個例子我們會用 ZRX 代幣:
用 FilterLogs 來過濾日志:
接下來我們將解析JSON abi,稍后我們將使用解壓縮原始日志數(shù)據(jù):
為了按某種日志類型進行過濾,我們需要弄清楚每個事件日志函數(shù)簽名的keccak256哈希值。 事件日志函數(shù)簽名哈希始終是 topic [0] ,我們很快就會看到。 以下是使用go-ethereum crypto 包計算keccak256哈希的方法:
現(xiàn)在我們將遍歷所有日志并設(shè)置switch語句以按事件日志類型進行過濾:
現(xiàn)在要解析 Transfer 事件日志,我們將使用 abi.Unpack 將原始日志數(shù)據(jù)解析為我們的日志類型結(jié)構(gòu)。 解包不會解析 indexed 事件類型,因為它們存儲在 topics 下,所以對于那些我們必須單獨解析,如下例所示:
Approval 日志也是類似的方法:
最后,把所有的步驟放一起:
我們可以把解析的日志與etherscan的數(shù)據(jù)對比:
Commands
erc20.sol
event_read_erc20.go
solc version used for these examples
要讀取 0x Protocol 事件日志,我們必須首先將solidity智能合約編譯為一個Go包。
安裝solc版本 0.4.11
為例如 Exchange.sol 的事件日志創(chuàng)建0x Protocol交易所智能合約接口:
Create the 0x protocol exchange smart contract interface for event logs as Exchange.sol :
接著給定abi,使用 abigen 來創(chuàng)建Go exchange 包:
Then use abigen to create the Go exchange package given the abi:
現(xiàn)在在我們的Go應(yīng)用程序中,讓我們創(chuàng)建與0xProtocol事件日志簽名類型匹配的結(jié)構(gòu)體類型:
初始化以太坊客戶端:
創(chuàng)建一個 FilterQuery ,并為其傳遞0x Protocol智能合約地址和所需的區(qū)塊范圍:
用 FilterLogs 查詢?nèi)罩荆?/p>
接下來我們將解析JSON abi,我們后續(xù)將使用解壓縮原始日志數(shù)據(jù):
為了按某種日志類型過濾,我們需要知曉每個事件日志函數(shù)簽名的keccak256摘要。正如我們很快所見到的那樣,事件日志函數(shù)簽名摘要總是 topic[0] :
現(xiàn)在我們迭代所有的日志并設(shè)置一個switch語句來按事件日志類型過濾:
現(xiàn)在要解析 LogFill ,我們將使用 abi.Unpack 將原始數(shù)據(jù)類型解析為我們自定義的日志類型結(jié)構(gòu)體。Unpack不會解析 indexed 事件類型,因為這些它們存儲在 topics 下,所以對于那些我們必須單獨解析,如下例所示:
對于 LogCancel 類似:
最后是 LogError :
將它們放在一起并運行我們將看到以下輸出:
將解析后的日志輸出與etherscan上的內(nèi)容進行比較:
命令
Exchange.sol
event_read_0xprotocol.go
這些示例使用的solc版本