Truffle 是區(qū)塊鏈公司 ConsenSys 的一家子公司,它已經(jīng)為以太坊區(qū)塊鏈開發(fā)了一個開源區(qū)塊鏈開發(fā)環(huán)境和測試框架。近日,微軟和Truffle宣布結(jié)為伙伴關(guān)系,為微軟 Azure 生態(tài)系統(tǒng)引入?yún)^(qū)塊鏈開發(fā)者工具。這兩家組織正在進行的投資包括用于測試的本地區(qū)塊鏈節(jié)點,并提供測試數(shù)據(jù)、智能合約的撰寫和持續(xù)部署、調(diào)試及測試。
在使用Chainlink時,強大的開發(fā)工具可以幫助您的智能合約在鏈上安全地部署成功。Truffle旨在提供一個易于使用的dApp框架,以幫助開發(fā)人員更好地開展其dApp的開發(fā)工作。
Truffle非常易于上手,Truffle Boxes的特點決定了您可以直接在終端下載dApp樣板。為了幫助您使用Chainlink,我們提供Chainlink Truffle Box樣板。其中包含了一個名為“MyContract”的的Chainlinked智能合約示例以及預(yù)制的測試套件。首先需要打開終端并安裝Truffle。
npm install truffle -g
接下來,創(chuàng)建一個新的目錄,并通過下面的命令從box中獲取Chainlinked示例合約:
mkdir Chainlink
cd Chainlink
truffle unbox smartcontractkit/chainlink
開箱之后,您會發(fā)現(xiàn)有一些新目錄會自動創(chuàng)建。其中包含了很多非常有用的示例代碼,可以幫助您快速開始Chainlinked智能合約的開發(fā)。
本文我們主要會介紹“MyContract”合約,代碼文件可以在*contracts*目錄下找到。
## 測試
首先,測試合約以確保其一切正常。您可以通過以下命令執(zhí)行此操作:
npm test
這將在樣本合約上運行各種測試用例,例如創(chuàng)建帶有和不帶LINK代幣的請求,將這些請求發(fā)送到oracle合同地址以及測試合同所有權(quán)。
*注意:你可能會遇到一些LINK代幣合約的各種編譯警告,這是因為我們用的是最新的Solidity編譯器版本,而不是合約創(chuàng)建時候的編譯器版本,因此我們可以忽略這些警告。LINK代幣合約已經(jīng)部署,我們只是想這些合約提供給本地測試。
*需要注意的是,每次運行測試之后,我們都重新部署了每一個合約。這是為了我們可以進行真正的單元測試, 我們不想我們的測試依賴于其他測試的輸出。另外,重新部署每個合約需要時間,但這僅用于測試目的,不會影響我們的實際性能運行時間。
現(xiàn)在讓我們來看一下“MyContract”的這些測試用例的更多細節(jié),您可以在*test/MyContract_test.js*下找到。如果您之前使用過Mocha.js,您會發(fā)現(xiàn)語法很熟悉。Truffle基于Mocha測試框架,具有智能合約的特有功能。讓我們來看看其中的一些新功能。
定義MyContract合約所使用的變量。注意其中jobId值是演示所用的占位符,不是真正可用的JobId。您可以在這里找到真正可用的JobId。
contract()函數(shù)的功能和Mocha中describe()函數(shù)實現(xiàn)的功能類似,但它結(jié)合了Truffle中的clean-room-feature。在Truffle的文檔中這樣解釋:
- 在每個contract()函數(shù)運行之前,您的合約將重新部署到以太坊網(wǎng)絡(luò),其中的測試以原始的合約狀態(tài)運行。
- contract()函數(shù)提供了可以用來編寫測試的可用帳戶列表。
此外,我們的示例“MyContract”需要來自其他智能合約的輸出。為此,我們將使用artifacts.require()方法,該方法實質(zhì)上將特定智能合約的輸出作為合同抽象導(dǎo)入。此數(shù)據(jù)存儲為Truffle可以使用的JSON 二進制對象查看到。閱讀更多有關(guān)artifacts.require()如何在這里工作的信息。
助手合約存儲為常量引用,現(xiàn)在我們可以開始創(chuàng)建測試用例。為此,我們需要正確理解關(guān)鍵的測試方法,例如*describe(),beforeEach(),it()和context()*。
- *describe()* 允許我們將測試用例組合在一起。它需要兩個參數(shù),第一個是我們的測試組名稱的字符串,第二個是回調(diào)函數(shù)。這個方法涉及的測試用例是創(chuàng)建請求,完成請求,取消請求以及取回LINK。
- *beforeEach()*在每個單獨的測試范圍之前運行。對于許多測試來說,在運行測試用例之前,必須首先執(zhí)行一些操作(例如等待鏈LINK的轉(zhuǎn)賬)。
- *it()*用于單個測試用例。這些用于測試我們在不同狀態(tài)下的合約以及明確他們想要完成的任務(wù)。你會注意到當(dāng)我們運行npm test時,每個*it()函數(shù)*的參數(shù)中的字符串都會輸出為日志,這有助于我們清楚地看到我們的測試時間線。
- *context()*是*describe()*的別名,但是用于合同執(zhí)行的更具體的狀態(tài)。換言之,它提供了另一種更容易閱讀和更有條理的測試方法。
## 寫在最后
Truffle提供了一個功能強大的工具箱,可幫助您的Chainlinked智能合約正確的運行。得益于Mocha.js這樣的流行的且文檔豐富的世界級測試框架,開發(fā)人員會非常容易的實現(xiàn)相關(guān)的開發(fā)工作。使用Truffle boxes,dApp公司能夠輕松地為其開發(fā)人員提供有用的示例,幫助發(fā)展區(qū)塊鏈生態(tài)系統(tǒng)。