手把手帶你走上智慧合約程式設計之路

譯註：原文首發於ConsenSys開發者部落格，原作者為Eva以及ConsenSys的開發團隊。如果您想要獲取更多及時資訊，可以訪問ConsenSys首頁點選左下角Newsletter訂閱郵件。本文的翻譯獲得了ConsenSys創始人Lubin先生的授權。

有些人說以太坊太難對付，於是我們(譯註：指Consensys, 下同)寫了這篇文章來幫助大家學習如何利用以太坊編寫智慧合約和應用。這裡所用到的工具，錢包，應用程式以及整個生態系統仍處於開發狀態，它們將來會更好用！

• 第一部分概述，討論了關鍵概念，幾大以太坊客戶端以及寫智慧合約用到的程式語言。
• 第二部分討論了總體的工作流程，以及目前流行的一些DApp框架和工具。
• 第三部分主要關於程式設計，我們將學習如何使用Truffle來為智慧合約編寫測試和構建DApp。

第一部分. 概述

如果你覺得白皮書中的章節太晦澀，也可以直接動手來熟悉以太坊。在以太坊上做開發並不要求你理解所有那些“密碼經濟電腦科學”(crypto economic computer science)，而白皮書的大部分是關於以太坊想對於比特幣架構上的改進。

新手教程

ethereum.org提供了官方的新手入門教程，以及一個代幣合約和眾籌合約的教程。合約語言Solidity也有官方文件。學習智慧合約的另一份不錯的資料（也是我的入門資料）是dappsForBeginners，不過現在可能有些過時了。

這篇文章的目的是成為上述資料的補充，同時介紹一些基本的開發者工具，使入門以太坊，智慧合約以及構建DApps(decentralized apps, 分散式應用)更加容易。我會試圖按照我自己(依然是新手)的理解來解釋工作流程中的每一步是在做什麼，我也得到了ConsenSys酷酷的開發者們的許多幫助。

基本概念

瞭解這些名詞是一個不錯的開始：

公鑰加密系統。 Alice有一把公鑰和一把私鑰。她可以用她的私鑰建立數字簽名，而Bob可以用她的公鑰來驗證這個簽名確實是用Alice的私鑰建立的，也就是說，確實是Alice的簽名。當你建立一個以太坊或者比特幣錢包的時候，那長長的0xdf...5f地址實質上是個公鑰，對應的私鑰儲存某處。類似於Coinbase的線上錢包可以幫你保管私鑰，你也可以自己保管。如果你弄丟了存有資金的錢包的私鑰，你就等於永遠失去了那筆資金，因此你最好對私鑰做好備份。過來人表示：通過踩坑學習到這一點是非常痛苦的...

點對點網路。 就像BitTorrent, 以太坊分散式網路中的所有節點都地位平等，沒有中心伺服器。(未來會有半中心化的混合型服務出現為使用者和開發者提供方便，這我們後面會講到。)

區塊鏈。 區塊鏈就像是一個全球唯一的帳簿，或者說是資料庫，記錄了網路中所有交易歷史。

以太坊虛擬機器(EVM)。 它讓你能在以太坊上寫出更強大的程式（比特幣上也可以寫指令碼程式）。它有時也用來指以太坊區塊鏈，負責執行智慧合約以及一切。

節點。 你可以執行節點，通過它讀寫以太坊區塊鏈，也即使用以太坊虛擬機器。完全節點需要下載整個區塊鏈。輕節點仍在開發中。

礦工。 挖礦，也就是處理區塊鏈上的區塊的節點。這個網頁可以看到當前活躍的一部分以太坊礦工：stats.ethdev.com。

工作量證明。 礦工們總是在競爭解決一些數學問題。第一個解出答案的(算出下一個區塊)將獲得以太幣作為獎勵。然後所有節點都更新自己的區塊鏈。所有想要算出下一個區塊的礦工都有與其他節點保持同步，並且維護同一個區塊鏈的動力，因此整個網路總是能達成共識。(注意：以太坊正計劃轉向沒有礦工的權益證明系統(POS)，不過那不在本文討論範圍之內。)

以太幣。 縮寫ETH。一種你可以購買和使用的真正的數字貨幣。這裡是可以交易以太幣的其中一家交易所的走勢圖。在寫這篇文章的時候，1個以太幣價值65美分。

Gas. (汽油) 在以太坊上執行程式以及儲存資料都要消耗一定量的以太幣，Gas是以太幣轉換而成。這個機制用來保證效率。

DApp. 以太坊社群把基於智慧合約的應用稱為去中心化的應用程式(Decentralized App)。DApp的目標是(或者應該是)讓你的智慧合約有一個友好的介面，外加一些額外的東西，例如IPFS（可以儲存和讀取資料的去中心化網路，不是出自以太坊團隊但有類似的精神)。DApp可以跑在一臺能與以太坊節點互動的中心化伺服器上，也可以跑在任意一個以太坊平等節點上。(花一分鐘思考一下：與一般的網站不同，DApp不能跑在普通的伺服器上。他們需要提交交易到區塊鏈並且從區塊鏈而不是中心化資料庫讀取重要資料。相對於典型的使用者登入系統，使用者有可能被表示成一個錢包地址而其它使用者資料儲存在本地。許多事情都會與目前的web應用有不同架構。)

以太坊客戶端，智慧合約語言

編寫和部署智慧合約並不要求你執行一個以太坊節點。下面有列出基於瀏覽器的IDE和API。但如果是為了學習的話，還是應該執行一個以太坊節點，以便理解其中的基本元件，何況執行節點也不難。

執行以太坊節點可用的客戶端

以太坊有許多不同語言的客戶端實現（即多種與以太坊網路互動的方法），包括C++, Go, Python, Java, Haskell等等。為什麼需要這麼多實現？不同的實現能滿足不同的需求（例如Haskell實現的目標是可以被數學驗證），能使以太坊更加安全，能豐富整個生態系統。

在寫作本文時，我使用的是Go語言實現的客戶端geth (go-ethereum)，其他時候還會使用一個叫testrpc的工具, 它使用了Python客戶端pyethereum。後面的例子會用到這些工具。

注: 我曾經使用過C++的客戶端，現在仍然在用其中的ethminer元件和geth配合挖礦，因此這些不同的元件是可以一起工作的。
關於挖礦：挖礦很有趣，有點像精心照料你的室內盆栽，同時又是一種瞭解整個系統的方法。雖然以太幣現在的價格可能連電費都補不齊，但以後誰知道呢。人們正在創造許多酷酷的DApp, 可能會讓以太坊越來越流行。

互動式控制檯。 客戶端執行起來後，你就可以同步區塊鏈，建立錢包，收發以太幣了。使用geth的一種方式是通過Javascript控制檯（JavaScript console, 類似你在chrome瀏覽器裡面按F12出來的那個，只不過是跑在終端裡）。此外還可以使用類似cURL的命令通過JSON RPC來與客戶端互動。本文的目標是帶大家過一邊DApp開發的流程，因此這塊就不多說了。但是我們應該記住這些命令列工具是除錯，配置節點，以及使用錢包的利器。

在測試網路執行節點。 如果你在正式網路執行geth客戶端，下載整個區塊鏈與網路同步會需要相當時間。（你可以通過比較節點日誌中列印的最後一個塊號和stats.ethdev.com上列出的最新塊來確定是否已經同步。) 另一個問題是在正式網路上跑智慧合約需要實實在在的以太幣。在測試網路上執行節點的話就沒有這個問題。此時也不需要同步整個區塊鏈，建立一個自己的私有鏈就勾了，對於開發來說更省時間。

testrpc. 用geth可以建立一個測試網路，另一種更快的建立測試網路的方法是使用testrpc. Testrpc可以在啟動時幫你建立一堆存有資金的測試賬戶。它的執行速度也更快因此更適合開發和測試。你可以從testrpc起步，然後隨著合約慢慢成型，轉移到geth建立的測試網路上 - 啟動方法很簡單，只需要指定一個networkid：geth --networkid "12345"。這裡是testrpc的程式碼倉庫，下文我們還會再講到它。

接下來我們來談談可用的程式語言，之後就可以開始真正的程式設計了。

寫智慧合約用的程式語言

用Solidity就好。 要寫智慧合約有好幾種語言可選：有點類似Javascript的Solidity, 副檔名是.sol. 和Python接近的Serpent, 檔名以.se結尾。還有類似Lisp的LLL。Serpent曾經流行過一段時間，但現在最流行而且最穩定的要算是Solidity了，因此用Solidity就好。聽說你喜歡Python? 用Solidity。

solc編譯器。 用Solidity寫好智慧合約之後，需要用solc來編譯。它是一個來自C++客戶端實現的元件（又一次，不同的實現產生互補），這裡是安裝方法。如果你不想安裝solc也可以直接使用基於瀏覽器的編譯器，例如Solidity real-time compiler或者Cosmo。後文有關程式設計的部分會假設你安裝了solc。

注意：以太坊正處於積極的開發中，有時候新的版本之間會有不同步。確認你使用的是最新的dev版本，或者穩定版本。如果遇到問題可以去以太坊專案對應的Gitter聊天室或者forums.ethereum.org上問問其他人在用什麼版本。

web3.js API. 當Solidity合約編譯好並且傳送到網路上之後，你可以使用以太坊的web3.js JavaScript API來呼叫它，構建能與之互動的web應用。

以上就是在以太坊上編寫智慧合約和構建與之互動的DApp所需的基本工具。

第二部分. DApp框架，工具以及工作流程

DApp開發框架

雖然有上文提到的工具就可以進行開發了，但是使用社群大神們創造的框架會讓開發更容易。

Truffle and Embark. 是Truffle把我領進了門。在Truffle出現之前的那個夏天，我目睹了一幫有天分的學生是如何不眠不休的參加一個hackathon（程式設計馬拉松）活動的，雖然結果相當不錯，但我還是嚇到了。然後Truffle出現了，幫你處理掉大量無關緊要的小事情，讓你可以迅速進入寫程式碼-編譯-部署-測試-打包DApp這個流程。另外一個相似的DApp構建與測試框架是Embark。我只用過Truffle, 但是兩個陣營都擁有不少DApp大神。

Meteor. 許多DApp開發者使用的另一套開發棧由web3.js和Meteor組成，Meteor是一套通用webapp開發框架（ethereum-meteor-wallet專案提供了一個很棒的入門例項，而SilentCiero正在構建大量Meteor與web3.js和DApp整合的模板）。我下載並執行過一些不錯的DApp是以這種方式構造的。在11月9日至13日的以太坊開發者大會ÐΞVCON1上將有一些有趣的討論，是關於使用這些工具構建DApp以及相關最佳實踐的（會議將會在YouTube上直播）。

APIs. BlockApps.net打算提供一套RESTful API給DApp使用以免去開發者執行本地節點的麻煩，這個中心化服務是基於以太坊Haskell實現的。這與DApp的去中心化模型背道而馳，但是在本地無法執行以太坊節點的場合非常有用，比如在你希望只有瀏覽器或者使用移動裝置的使用者也能使用你的DApp的時候。BlockApps提供了一個命令列工具bloc，註冊一個開發者帳號之後就可以使用。

許多人擔心需要執行以太坊節點才能使用DApp的話會把使用者嚇跑，其實包括BlockApps在內的許多工具都能解決這個問題。Metamask允許你在瀏覽器裡面使用以太坊的功能而無需節點，以太坊官方提供的AlethZero或者AlethOne是正在開發中有易用介面的客戶端，ConsenSys正在打造一個輕錢包LightWallet，這些工具都會讓DApp的使用變得更容易。輕客戶端和水平分片(sharding)也在計劃和開發之中。這是一個能進化出混合架構的P2P生態系統。

智慧合約整合開發環境 (IDE)

IDE. 以太坊官方出品了用來編寫智慧合約的Mix IDE，我還沒用過但會盡快一試。

基於瀏覽器的IDE. Solidity real-time compiler和Cosmo都可以讓你快速開始在瀏覽器中編寫智慧合約。你甚至可以讓這些工具使用你的本地節點，只要讓本地節點開一個埠（注意安全！這些工具站點必須可信，而且千萬不要把你的全部身家放在這樣一個本地節點裡面！Cosmo UI上有如何使用geth做到這一點的指引）。在你的智慧合約除錯通過之後，可以用開發框架來給它新增使用者介面和打包成DApp，這正是Truffle的工作，後面的程式設計章節會有詳細講解。

Ether.Camp正在開發另一個強大的企業級瀏覽器IDE。他們的IDE將支援沙盒測試網路，自動生成用於測試的使用者介面（取代後文將展示的手動編寫測試），以及一個測試交易瀏覽器test.ether.camp。當你的合約準備正式上線之前，使用他們的測試網路會是確保你的智慧合約在一個接近真實的環境工作正常的好方法。他們也為正式網路提供了一個交易瀏覽器frontier.ether.camp，上面可以看到每一筆交易的細節。在本文寫作時Ether.Camp的IDE還只能通過邀請註冊，預計很快會正式釋出。

合約和Dapp示例。 在Github上搜索DApp倉庫和.sol檔案可以看到進行中的有趣東西。這裡有一個DApp大列表：dapps.ethercasts.com，不過其中一些專案已經過時。Ether.fund/contracts上有一些Solidity和Serpent寫的合約示例，但是不清楚這些例子有沒有經過測試或者正確性驗證。11月12日的開發者大會ÐΞVCON1將會有一整天的DApp主題演講。

部署智慧合約的流程

流程如下：

1. 啟動一個以太坊節點 (例如geth或者testrpc)。
2. 使用solc*編譯*智慧合約。 => 獲得二進位制程式碼。
3. 將編譯好的合約部署到網路。（這一步會消耗以太幣，還需要使用你的節點的預設地址或者指定地址來給合約簽名。） => 獲得合約的區塊鏈地址和ABI（合約介面的JSON表示，包括變數，事件和可以呼叫的方法）。(譯註：作者在這裡把ABI與合約介面弄混了。ABI是合約介面的二進位制表示。)
4. 用web3.js提供的JavaScript API來呼叫合約。（根據呼叫的型別有可能會消耗以太幣。）

下圖詳細描繪了這個流程：

你的DApp可以給使用者提供一個介面先部署所需合約再使用之（如圖1到4步），也可以假設合約已經部署了（常見方法），直接從使用合約（如圖第6步）的介面開始。

第三部分. 程式設計

在Truffle中進行測試

Truffle用來做智慧合約的測試驅動開發(TDD)非常棒，我強烈推薦你在學習中使用它。它也是學習使用JavaScript Promise的一個好途徑，例如deferred和非同步呼叫。Promise機制有點像是說“做這件事，如果結果是這樣，做甲，如果結果是那樣，做乙... 與此同時不要在那兒乾等著結果返回，行不？”。Truffle使用了包裝web3.js的一個JS Promise框架Pudding（因此它為為你安裝web3.js）。(譯註：Promise是流行於JavaScript社群中的一種非同步呼叫模式。它很好的封裝了非同步呼叫，使其能夠靈活組合，而不會陷入callback hell.)

Transaction times. Promise對於DApp非常有用，因為交易寫入以太坊區塊鏈需要大約12-15秒的時間。即使在測試網路上看起來沒有那麼慢，在正式網路上卻可能會要更長的時間（例如你的交易可能用光了Gas，或者被寫入了一個孤兒塊）。

下面讓我們給一個簡單的智慧合約寫測試用例吧。

使用Truffle

首先確保你 1.安裝好了solc以及 2.testrpc。（testrpc需要Python和pip。如果你是Python新手，你可能需要用virtualenv來安裝，這可以將Python程式庫安裝在一個獨立的環境中。）

接下來安裝 3.Truffle（你可以使用NodeJS's npm來安裝：npm install -g truffle,-g開關可能會需要sudo）。安裝好之後，在命令列中輸入truffle list來驗證安裝成功。然後建立一個新的專案目錄（我把它命名為'conference'），進入這個目錄，執行truffle init。該命令會建立如下的目錄結構：

現在讓我們在另一個終端裡通過執行testrpc來啟動一個節點（你也可以用geth）：

回到之前的終端中，輸入truffle deploy。這條命令會部署之前truffle init產生的模板合約到網路上。任何你可能遇到的錯誤資訊都會在testrpc的終端或者執行truffle的終端中輸出。

在開發過程中你隨時可以使用truffle compile命令來確認你的合約可以正常編譯（或者使用solc YourContract.sol），truffle deploy來編譯和部署合約，最後是truffle test來執行智慧合約的測試用例。

第一個合約

下面是一個針對會議的智慧合約，通過它參會者可以買票，組織者可以設定參會人數上限，以及退款策略。本文涉及的所有程式碼都可以在這個程式碼倉庫找到。

contract Conference {
  address public organizer;
  mapping (address => uint) public registrantsPaid;
  uint public numRegistrants;
  uint public quota;

  event Deposit(address _from, uint _amount);  // so you can log these events
  event Refund(address _to, uint _amount); 

  function Conference() { // Constructor
    organizer = msg.sender;
    quota = 500;
    numRegistrants = 0;
  }
  function buyTicket() public returns (bool success) {
    if (numRegistrants >= quota) { return false; }
    registrantsPaid[msg.sender] = msg.value;
    numRegistrants++;
    Deposit(msg.sender, msg.value);
    return true;
  }
  function changeQuota(uint newquota) public {
    if (msg.sender != organizer) { return; }
    quota = newquota;
  }
  function refundTicket(address recipient, uint amount) public {
    if (msg.sender != organizer) { return; }
    if (registrantsPaid[recipient] == amount) { 
      address myAddress = this;
      if (myAddress.balance >= amount) { 
        recipient.send(amount);
        registrantsPaid[recipient] = 0;
        numRegistrants--;
        Refund(recipient, amount);
      }
    }
  }
  function destroy() { // so funds not locked in contract forever
    if (msg.sender == organizer) { 
      suicide(organizer); // send funds to organizer
    }
  }
}

接下來讓我們部署這個合約。（注意：本文寫作時我使用的是Mac OS X 10.10.5, solc 0.1.3+ (通過brew安裝)，Truffle v0.2.3, testrpc v0.1.18 (使用venv)）

部署合約

(譯註：圖中步驟翻譯如下：）

使用truffle部署智慧合約的步驟：
1. truffle init (在新目錄中) => 建立truffle專案目錄結構
2. 編寫合約程式碼，儲存到contracts/YourContractName.sol檔案。
3. 把合約名字加到config/app.json的'contracts'部分。
4. 啟動以太坊節點（例如在另一個終端裡面執行testrpc）。
5. truffle deploy（在truffle專案目錄中)

新增一個智慧合約。 在truffle init執行後或是一個現有的專案目錄中，複製粘帖上面的會議合約到contracts/Conference.sol檔案中。然後開啟config/app.json檔案，把'Conference'加入'deploy'陣列中。

啟動testrpc。 在另一個終端中啟動testrpc。

編譯或部署。 執行truffle compile看一下合約是否能成功編譯，或者直接truffle deploy一步完成編譯和部署。這條命令會把部署好的合約的地址和ABI（應用介面）加入到配置檔案中，這樣之後的truffle test和truffle build步驟可以使用這些資訊。

出錯了？ 編譯是否成功了？記住，錯誤資訊即可能出現在testrpc終端也可能出現在truffle終端。

重啟節點後記得重新部署！ 如果你停止了testrpc節點，下一次使用任何合約之前切記使用truffle deploy重新部署。testrpc在每一次重啟之後都會回到完全空白的狀態。

合約程式碼解讀

讓我們從智慧合約頭部的變數宣告開始：

address public organizer;
mapping (address => uint) public registrantsPaid;
uint public numRegistrants;
uint public quota;

address. 地址型別。第一個變數是會議組織者的錢包地址。這個地址會在合約的建構函式function Conference()中被賦值。很多時候也稱呼這種地址為'owner'（所有人）。

uint. 無符號整型。區塊鏈上的儲存空間很緊張，保持資料儘可能的小。

public. 這個關鍵字表明變數可以被合約之外的物件使用。private修飾符則表示變數只能被本合約(或者衍生合約)內的物件使用。如果你想要在測試中通過web3.js使用合約中的某個變數，記得把它宣告為public。

Mapping或陣列。（譯註：Mapping類似Hash, Directory等資料型別，不做翻譯。）在Solidity加入陣列型別之前，大家都使用類似mapping (address => uint)的Mapping型別。這個宣告也可以寫作address registrantsPaid[]，不過Mapping的儲存佔用更小(smaller footprint)。這個Mapping變數會用來儲存參加者（用他們的錢包地址表示）的付款數量以便在退款時使用。

關於地址。 你的客戶端（比如testrpc或者geth）可以生成一個或多個賬戶/地址。testrpc啟動時會顯示10個可用地址：

第一個地址, accounts[0]，是發起呼叫的預設地址，如果沒有特別指定的話。

組織者地址 vs. 合約地址。 部署好的合約會在區塊鏈上擁有自己的地址（與組織者擁有的是不同的地址）。在Solidity合約中可以使用this來訪問這個合約地址，正如refundTicket函式所展示的：address myAddress = this;

Suicide, Solidity的好東西。（譯註：suicide意為'自殺', 為Solidity提供的關鍵字，不做翻譯。）轉給合約的資金會保存於合約（地址）中。最終這些資金通過destroy函式被釋放給了建構函式中設定的組織者地址。這是通過suicide(orgnizer);這行程式碼實現的。沒有這個，資金可能被永遠鎖定在合約之中（reddit上有些人就遇到過），因此如果你的合約會接受資金一定要記得在合約中使用這個方法！

如果想要模擬另一個使用者或者對手方（例如你是賣家想要模擬一個買家），你可以使用可用地址陣列中另外的地址。假設你要以另一個使用者，accounts[1], 的身份來買票，可以通過from引數設定：

conference.buyTicket({ from: accounts[1], value: some_ticket_price_integer });

函式呼叫可以是交易。 改變合約狀態（修改變數值，新增記錄，等等）的函式呼叫本身也是轉賬交易，隱式的包含了傳送人和交易價值。因此web3.js的函式呼叫可以通過指定{ from: __, value: __ }引數來發送以太幣。在Solidity合約中，你可以通過msg.sender和msg.value來獲取這些資訊：

function buyTicket() public {
    ...
    registrantsPaid[msg.sender] = msg.value;
    ...
}

事件(Event)。 可選的功能。合約中的Deposit（充值）和Send（傳送）事件是會被記錄在以太坊虛擬機器日誌中的資料。它們實際上沒有任何作用，但是用事件(Event)把交易記錄進日誌是好的做法。

好了，現在讓我們給這個智慧合約寫一個測試，來確保它能工作。

寫測試

把專案目錄test/中的example.js檔案重新命名為conference.js，檔案中所有的'Example'替換為'Conference'。

contract('Conference', function(accounts) {
  it("should assert true", function(done) {
    var conference = Conference.at(Conference.deployed_address);
    assert.isTrue(true);
    done();   // stops tests at this point
  });
});

在專案根目錄下執行truffle test，你應該看到測試通過。在上面的測試中truffle通過Conference.deployed_address獲得合約部署在區塊鏈上的地址。

讓我們寫一個測試來初始化一個新的Conference，然後檢查變數都正確賦值了。將conference.js中的測試程式碼替換為：

contract('Conference', function(accounts) {
  it("Initial conference settings should match", function(done) {
    var conference = Conference.at(Conference.deployed_address);  
    // same as previous example up to here
    Conference.new({ from: accounts[0]  })
    .then(function(conference) {
      conference.quota.call().then(
          function(quota) {
            assert.equal(quota, 500, "Quota doesn't match!"); 
          }).then( function() {
            return conference.numRegistrants.call();
          }).then( function(num) {
            assert.equal(num, 0, "Registrants should be zero!");
            return conference.organizer.call();
          }).then( function(organizer) {
            assert.equal(organizer, accounts[0], "Owner doesn't match!");
            done();   // to stop these tests earlier, move this up
        }).catch(done);
      }).catch(done);
    });
  });

建構函式。 Conference.new({ from: accounts[0] })通過呼叫合約建構函式創造了一個新的Conference例項。由於不指定from時會預設使用accounts[0]，它其實可以被省略掉：

Conference.new({ from: accounts[0] }); // 和Conference.new()效果相同

Promise. 程式碼中的那些then和return就是Promise。它們的作用寫成一個深深的巢狀呼叫鏈的話會是這樣：

conference.numRegistrants.call().then(
  function(num) {
    assert.equal(num, 0, "Registrants should be zero!");
    conference.organizer.call().then(
     function(organizer) {
        assert.equal(organizer, accounts[0], "Owner doesn't match!");
        }).then(
          function(...))
            }).then(
              function(...))
            // Because this would get hairy...

Promise減少巢狀，使程式碼變得扁平，允許呼叫非同步返回，並且簡化了表達“成功時做這個”和“失敗時做那個”的語法。Web3.js通過回撥函式實現非同步呼叫，因此你不需要等到交易完成就可以繼續執行前端程式碼。Truffle藉助了用Promise封裝web3.js的一個框架，叫做Pudding，這個框架本身又是基於Bluebird的，它支援Promise的高階特性。

call. 我們使用call來檢查變數的值，例如conference.quota.call().then(...，還可以通過傳引數，例如call(0), 來獲取mapping在index 0處的元素。Solidity的文件說這是一種特殊的“訊息呼叫”因為 1.不會為礦工記錄和 2.不需要從錢包賬戶/地址發起（因此它沒有被賬戶持有者私鑰做簽名）。另一方面，交易/事務(Transaction)會被礦工記錄，必須來自於一個賬戶（也就是有簽名），會被記錄到區塊鏈上。對合約中資料做的任何修改都是交易。僅僅是檢查一個變數的值則不是。因此在讀取變數時不要忘記加上call()！否則會發生奇怪的事情。（此外如果在讀取變數是遇到問題別忘記檢查它是否是public。）call()也能用於呼叫不是交易的函式。如果一個函式本來是交易，但你卻用call()來呼叫，則不會在區塊鏈上產生交易。

斷言。 標準JS測試中的斷言（如果你不小心拼成了複數形式'asserts'，truffle會報錯，讓你一頭霧水），assert.equal是最常用的，其他型別的斷言可以在Chai的文件中找到。

再一次執行truffle test確保一切工作正常。

測試合約函式呼叫

現在我們測試一下改變quote變數的函式能工作。在tests/conference.js檔案的contract('Conference', function(accounts) {...};)的函式體中新增如下測試用例：

it("Should update quota", function(done) {
  var c = Conference.at(Conference.deployed_address);

  Conference.new({from: accounts[0] }).then(
    function(conference) {
      conference.quota.call().then( 
        function(quota) { 
          assert.equal(quota, 500, "Quota doesn't match!"); 
        }).then( function() { 
          return conference.changeQuota(300);
        }).then( function(result) {  // result here is a transaction hash
          console.log(result);  // if you were to print this out it’d be long hex - the transaction hash
          return conference.quota.call()
        }).then( function(quota) { 
          assert.equal(quota, 300, "New quota is not correct!");
          done();
        }).catch(done);
    }).catch(done);
});

這裡的新東西是呼叫changeQuota函式的那一行。console.log對於除錯很有用，用它能在執行truffle的終端中輸出資訊。在關鍵點插入console.log可以檢視執行到了哪一步。記得把Solidity合約中changeQuota函式被宣告為public，否則你不能呼叫它：

  function changeQuota(uint newquota) public {  }

測試交易

現在讓我們呼叫一個需要發起人傳送資金的函式。

Wei. 以太幣有很多種單位（這裡有個很有用的轉換器）,在合約中通常用的是Wei，最小的單位。Web3.js提供了在各單位與Wei之間互相轉換的便利方法，形如web3.toWei(.05, 'ether')。JavaScript在處理很大的數字時有問題，因此web3.js使用了程式庫BigNumber，並建議在程式碼各處都以Wei做單位，直到要給使用者看的時候（文件。

賬戶餘額。 Web3.js提供了許多提供方便的方法，其中另一個會在下面測試用到的是web3.eth.getBalance(some_address)。記住傳送給合約的資金會由合約自己持有直到呼叫suicide。

在contract(Conference, function(accounts) {...};)的函式體中插入下面的測試用例。在高亮顯示的方法中，測試用例讓另一個使用者(accounts[1])以ticketPrice的價格買了一張門票。然後它檢查合約的賬戶餘額增加了ticketPrice，以及購票使用者被加入了參會者列表。

這個測試中的buyTicket是一個交易函式：

it("Should let you buy a ticket", function(done) {
  var c = Conference.at(Conference.deployed_address);

  Conference.new({ from: accounts[0] }).then(
    function(conference) {
      var ticketPrice = web3.toWei(.05, 'ether');
      var initialBalance = web3.eth.getBalance(conference.address).toNumber();

      conference.buyTicket({ from: accounts[1], value: ticketPrice }).then(
        function() {
          var newBalance = web3.eth.getBalance(conference.address).toNumber();
          var difference = newBalance - initialBalance;
          assert.equal(difference, ticketPrice, "Difference should be what was sent");
          return conference.numRegistrants.call();
      }).then(function(num) {
          assert.equal(num, 1, "there should be 1 registrant");
          return conference.registrantsPaid.call(accounts[1]);
      }).then(function(amount) {
          assert.equal(amount.toNumber(), ticketPrice, "Sender's paid but is not listed");
          done();
      }).catch(done);
  }).catch(done);
});

交易需要簽名。 和之前的函式呼叫不同，這個呼叫是一個會發送資金的交易，在這種情況下購票使用者(accounts[1])會用他的私鑰對buyTicket()呼叫做簽名。（在geth中使用者需要在傳送資金之前通過輸入密碼來批准這個交易或是解鎖錢包的賬戶。）

toNumber(). 有時我們需要把Solidity返回的十六進位制結果轉碼。如果結果可能是個很大的數字可以用web3.toBigNumber(numberOrHexString)來處理因為JavaScript直接對付大數要糟。

測試包含轉賬的合約

最後，為了完整性，我們確認一下refundTicket方法能正常工作，而且只有會議組織者能呼叫。下面是測試用例：

it("Should issue a refund by owner only", function(done) {
  var c = Conference.at(Conference.deployed_address);

  Conference.new({ from: accounts[0] }).then(
    function(conference) {
      var ticketPrice = web3.toWei(.05, 'ether');
      var initialBalance = web3.eth.getBalance(conference.address).toNumber(); 

      conference.buyTicket({ from: accounts[1], value: ticketPrice }).then(
        function() {
          var newBalance = web3.eth.getBalance(conference.address).toNumber();
          var difference = newBalance - initialBalance;
          assert.equal(difference, ticketPrice, "Difference should be what was sent");  // same as before up to here
          // Now try to issue refund as second user - should fail
          return conference.refundTicket(accounts[1], ticketPrice, {from: accounts[1]});  
        }).then(
          function() {
            var balance = web3.eth.getBalance(conference.address).toNumber();
            assert.equal(web3.toBigNumber(balance), ticketPrice, "Balance should be unchanged");
            // Now try to issue refund as organizer/owner - should work
            return conference.refundTicket(accounts[1], ticketPrice, {from: accounts[0]});  
        }).then(
          function() {
            var postRefundBalance = web3.eth.getBalance(conference.address).toNumber();
            assert.equal(postRefundBalance, initialBalance, "Balance should be initial balance");
            done();
        }).catch(done);
    }).catch(done);
 });

這個測試用例覆蓋的Solidity函式如下：

function refundTicket(address recipient, uint amount) public returns (bool success) {
  if (msg.sender != organizer) { return false; }
  if (registrantsPaid[recipient] == amount) { 
    address myAddress = this;
    if (myAddress.balance >= amount) { 
      recipient.send(amount);
      Refund(recipient, amount);
      registrantsPaid[recipient] = 0;
      numRegistrants--;
      return true;
    }
  }
  return false;
}

合約中傳送以太幣。 address myAddress = this展示瞭如何獲取該會議合約例項的地址，以變接下來檢查這個地址的餘額（或者直接使用this.balance）。合約通過recipient.send(amount)方法把資金髮回了購票人。

交易無法返回結果給web3.js. 注意這一點！refundTicket函式會返回一個布林值，但是這在測試中無法檢查。因為這個方法是一個交易函式（會改變合約內資料或是傳送以太幣的呼叫），而web3.js得到的交易執行結果是一個交易雜湊（如果打印出來是一個長長的十六進位制/怪怪的字串）。既然如此為什麼還要讓refundTicket返回一個值？因為在Solidity合約內可以讀到這個返回值，例如當另一個合約呼叫refundTicket()的時候。也就是說Solidity合約可以讀取交易執行的返回值，而web3.js不行。另一方面，在web3.js中你可以用事件機制（Event, 下文會解釋）來監控交易執行，而合約不行。合約也無法通過call()來檢查交易是否修改了合約內變數的值。

關於sendTransaction(). 當你通過web3.js呼叫類似buyTicket()或者refundTicket()的交易函式時（使用web3.eth.sendTransaction），交易並不會立即執行。事實上交易會被提交到礦工網路中，交易程式碼直到其中一位礦工產生一個新區塊把交易記錄進區塊鏈之後才執行。因此你必須等交易進入區塊鏈並且同步回本地節點之後才能驗證交易執行的結果。用testrpc的時候可能看上去是實時的，因為測試環境很快，但是正式網路會比較慢。

事件/Event. 在web3.js中你應該監聽事件而不是返回值。我們的智慧合約示例定義了這些事件：

event Deposit(address _from, uint _amount);
event Refund(address _to, uint _amount);

它們在buyTicket()和refundTicket()中被觸發。觸發時你可以在testrpc的輸出中看到日誌。要監聽事件，你可以使用web.js監聽器(listener)。在寫本文時我還不能在truffle測試中記錄事件，但是在應用中沒問題：

Conference.new({ from: accounts[0] }).then(
  function(conference) {
    var event = conference.allEvents().watch({}, ''); // or use conference.Deposit() or .Refund()
    event.watch(function (error, resu