蓋索林 Gasolin

Posted on  |    |   1,780 words, 1 min. read   |  

上一篇中我們已寫好並部署完成了簡單的加密代幣🔒💵合約。在閱讀完本文後，你將學會建立一個可以放到乙太幣錢包👛的加密代幣🔒💵。

開發前的準備

延續上一篇的內容，在開發的過程中，我們將繼續使用testrpc1工具在電腦上模擬智能合約所需的乙太坊區塊鏈測試環境。

首先確保已啟動testrpc。若尚未啟動，可以使用以下命令啟動：

$ testrpc
...

建立的代幣若要能透過乙太幣錢包👛來收送，必須相容於以太坊的ERC20標準2。ERC20標準定義了支援錢包所必須的合約介面。

本篇將使用OpenZeppelin2函式庫來簡化建立加密代幣🔒💵的過程。OpenZeppelin是一套協助撰寫安全的加密合約的函式庫，裡面也提供了相容ERC20標準的智能合約。可以透過npm工具安裝到專案目錄node_modules/zeppelin-solodity/中：

$ npm install zeppelin-solidity

準備完成，我們可以開始建立新的加密代幣智能合約了。

建立一個標準代幣合約

在contracts/目錄下建立一個HelloToken.sol檔案。也可以使用以下命令來產生檔案：

$ truffle create contract HelloToken

HelloToken.sol檔案內容如下：

pragma solidity ^0.4.11;
import "zeppelin-solidity/contracts/token/StandardToken.sol";
contract HelloToken is StandardToken {
  string public name = "HelloCoin";
  string public symbol = "[email protected]";
  uint8 public decimals = 2;
  uint256 public INITIAL_SUPPLY = 88888;
  function HelloToken() {
    totalSupply = INITIAL_SUPPLY;
    balances[msg.sender] = INITIAL_SUPPLY;
  }
}

講解

pragma solidity ^0.4.11;

第一行指名目前使用的solidity版本，不同版本的solidity可能會編譯出不同的bytecode。

import "zeppelin-solidity/contracts/token/StandardToken.sol";

接著我們使用import語句，來讀入zeppelin-solidity提供的StandardToken合約。

contract HelloToken is StandardToken {
}

建立HelloToken合約時，使用is語句繼承了StandardToken合約。因此HelloToken合約繼承了StandardToken合約所包含的資料與呼叫方法。

當我們繼承了StandardToken合約，也就支援了以下 ERC-20 標準中2規定的函式

函式 描述
totalSupply() 代幣發行的總量
balanceOf(A) 查詢A帳戶下的代幣數目
transfer(A,x) 傳送x個代幣到A帳戶
transferFrom(A,x) 從A帳戶提取x個代幣
approve(A,x) 同意A帳戶從我的帳戶中提取代幣
allowance(A,B) 查詢B帳戶可以從A帳戶提取多少代幣

和前一篇一樣，後面驗證時會用到balanceOf和transfer兩個函式。因為StandardToken合約中已經幫我們實做了這些函式，因此我們不需要自己從頭再寫一次。

string public name = "HelloCoin";
string public symbol = "[email protected]";
uint8 public decimals = 2;
uint256 public INITIAL_SUPPLY = 88888888;

這邊設定參數的目的是指定這個代幣的一些特性。以美元為例，美元的名稱(name)是dollar，美元的代號為$，拿一美元去找零最小可以拿到零錢是一美分(cent)，也就是0.01元。因為一美元最小可分割到小數點後2位(0.01)，因此最小交易單位(decimals)為2。

這邊將這個加密代幣取名(name)為HelloCoin(哈囉幣)，代幣的代號(symbol)為[email protected]，最小分割單位是2(最小可以找0.01個哈囉幣)。

以下為美金，比特幣，以太幣，哈囉幣的對照表供參考：

Name Symbol decimals
Dollar $ 2
Bitcoin BTC 8
Ethereum ETH 18
HelloCoin [email protected] 2

最後也定義了初始代幣數目INITIAL_SUPPLY。這邊一樣選擇了一個吉祥數字88888888。 另外，當我們把全域變數設為public(公開)，編譯時就會自動新增一個讀取公開變數的ABI接口，我們在truffle console中也可以讀取這些變數。

function HelloToken() {
  totalSupply = INITIAL_SUPPLY;
  balances[msg.sender] = INITIAL_SUPPLY;
}

和合約同名的HelloToken方法，就是HelloToken合約的建構函式(constructor)。 在建構式裡指定了totalSupply數目，並將所有的初始代幣INITIAL_SUPPLY都指定給msg.sender帳號，也就是用來部署這個合約的帳號。‵totalSupply定義於ERC20Basic.sol中，balances定義於BasicToken.sol中。

import '../math/SafeMath.sol';
...
using SafeMath for uint256;
...
balances[msg.sender] = balances[msg.sender].sub(_value);

進一步追去看BasicToken.sol合約的內容，可以發現BasicToken.sol合約中匯入了SafeMath.sol合約7。SafeMath對各種數值運算加入了必要的驗證，讓合約中的數字計算更安全。

如此一來，我們已寫好一個可透過以太幣錢包交易的新加密代幣🔒💵合約。這個合約一經部署，就可以一直存在於以太坊區塊鏈上，世界上從此也就多了一種新的加密代幣。只要你能找到人想擁有這種代幣，這種代幣就有交易的價值。

編譯與部署

在migrations/目錄下建立一個4_deploy_hellotoken.js檔案，內容如下：

var HelloToken = artifacts.require("HelloToken");
module.exports = function(deployer) {
  deployer.deploy(HelloToken);
};

現在執行compile與migrate命令

$ truffle compile
...
$ truffle migrate --reset
Using network 'development'.
Running migration: 4_deploy_hellotoken.js
  Deploying HelloToken...
  ... 0x2c4659528c68b4e43d1edff6c989fba05e8e7e56cc4085d408426d339b4e9ba4
  HelloToken: 0x352fa9aa18106f269d944935503afe57a00a9a0d
Saving successful migration to network...
  ... 0x1434c1b61e9719f410fc6090ce37c0ec141a1738aba278dd320738e4a5d229fa
Saving artifacts...

如此一來我們已將HelloCoin代幣合約部署到testrpc上。

驗證

$ truffle console
> let contract
> HelloToken.deployed().then(instance => contract = instance)
> contract.address
'0x352fa9aa18106f269d944935503afe57a00a9a0d'
> contract.balanceOf(web3.eth.coinbase)
{ [String: '88888888'] s: 1, e: 4, c: [ 88888888 ] }
> contract.balanceOf(web3.eth.accounts[1])
{ [String: '0'] s: 1, e: 0, c: [ 0 ] }
> contract.transfer(web3.eth.accounts[1], 123)
...
> contract.balanceOf(web3.eth.accounts[0])
{ [String: '88888765'] s: 1, e: 4, c: [ 88888765 ] }
> contract.balanceOf(web3.eth.accounts[1])
{ [String: '123'] s: 1, e: 2, c: [ 123 ] }
>

講解

> let contract
> SimpleToken.deployed().then(instance => contract = instance)

這邊使用HelloToken.deployed().then語句來取得HelloToken合約的Instance(實例)，並存到contract變數中，以方便後續的呼叫。

> contract.balanceOf(web3.eth.coinbase)
{ [String: '88888888'] s: 1, e: 4, c: [ 88888888 ] }
> contract.balanceOf(web3.eth.accounts[1])
{ [String: '0'] s: 1, e: 0, c: [ 0 ] }

web3.eth.coinbase 代表操作者預設的帳號，即testrpc所提供的10個帳號中的第一個帳號，也可以透過web3.eth.accounts[0]取得。 這兩句的目的是在進行轉帳操作前，先查詢前兩個帳號所擁有的代幣餘額。透過呼叫balanceOf函式，可以看到第一個帳號(部署合約的帳號)裡存著所有的代幣。

> contract.transfer(web3.eth.accounts[1], 123)
...

接著使用transfer函式來傳送123個代幣到第二個帳號web3.eth.accounts[1]。如果轉帳成功，傳送者預設帳號中會減少123個代幣，接收者帳號中會增加123個代幣。

> contract.balanceOf(web3.eth.coinbase)
{ [String: '88888765'] s: 1, e: 4, c: [ 88888765 ] }
> contract.balanceOf.call(web3.eth.accounts[1])
{ [String: '123'] s: 1, e: 2, c: [ 123 ] }
>

我們再次透過呼叫balanceOf函式，查詢傳送者帳號和接收者帳號各自剩下的HelloToken數目。發現轉帳真的成功了。

結語

我們用到 OpenZeppelin提供的函式庫來簡化撰寫加密代幣合約的工作。要實際投入使用前，還是建議將呼叫到的程式碼都再審查幾遍。可以從 OpenZeppelin 自己提供的Audit開始看4，可以學到一些觀念。

參考資料

蓋索林 Gasolin

Posted on  |    |   1,923 words, 1 min. read   |  

上一篇中我們已寫好並部署完成了第一個智能合約，也驗證了合約確實可以運作。在閱讀完本文後，你將學會建立一個簡易的加密代幣🔒💵。本篇目的並非為了寫出一個安全可用的加密代幣，而是以介紹代幣合約的相關概念為主， 是以對合約做了適當地簡化，好更易於理解。

開發前的準備

延續上一篇的內容，在開發的過程中，我們將繼續使用testrpc1工具在電腦上模擬智能合約所需的乙太坊區塊鏈測試環境。

首先確保已啟動testrpc，若尚未啟動，可以使用以下命令啟動

$ testrpc
...

這樣我們就可以開始建立加密代幣智能合約專案了。

代幣合約的基礎概念

代幣合約扮演像是銀行🏦的角色。使用者在代幣合約中，用自己的乙太幣帳戶地址當作銀行帳戶，可以透過代幣合約執行轉帳(transfer，將代幣由一個帳戶傳送到另一個帳戶)，查詢餘額(balanceOf，查詢指定帳戶中擁有的代幣)等原本由銀行負責的工作。因為合約部署在公開區塊鏈上，所有的交易都是公開透明，可供檢驗的。

建立一個代幣合約

在contracts/目錄下建立一個SimpleToken.sol檔案。也可以使用以下命令來產生檔案：

$ truffle create contract SimpleToken

SimpleToken.sol檔案內容如下：

pragma solidity ^0.4.11;
contract SimpleToken {
  uint256 INITIAL_SUPPLY = 88888;
  mapping(address => uint256) balances;
  function SimpleToken() {
    balances[msg.sender] = INITIAL_SUPPLY;
  }
  // transfer token for a specified address
  function transfer(address _to, uint256 _amount) {
    if (balances[msg.sender] < _amount) throw;
    balances[msg.sender] -= _amount;
    balances[_to] += _amount;
  }
  // Gets the balance of the specified address
  function balanceOf(address _owner) constant returns (uint256) {
    return balances[_owner];
  }
}

講解

pragma solidity ^0.4.11;

第一行指名目前使用的solidity版本，不同版本的solidity可能會編譯出不同的bytecode。

uint256 INITIAL_SUPPLY = 88888;
mapping(address => unit256) balances;

我們定義了初始代幣數目INITIAL_SUPPLY。這邊隨意選擇了一個吉祥數字88888。

我們用mapping來定義一個可以儲存鍵值對(key-value pair)的資料結構(類似Javascript中的{"0xaabbccddeeff": 888})，同時也需要分別指定address作為鍵的型別，指定uint256作為值的型別。和Javascript不同，型別定義好後不能隨時更改要儲存的型別。

contract SimpleToken {
  function SimpleToken() {
    balances[msg.sender] = INITIAL_SUPPLY;
  }
}

和合約同名的SimpleToken函式，就是SimpleToken這個合約的建構函式(constructor)。函式中我們拿msg.sender當作key，INITIAL_SUPPLY當作值，將所有的初始代幣INITIAL_SUPPLY都指定給msg.sender帳號。 msg是一個全域(Global)物件2，msg.sender表示用作呼叫當前函式的帳號。由於建構函式只有在合約部署時會被執行，因此這邊用到的msg.sender，也就代表著用來部署這個合約的帳號。

function transfer(address _to, uint256 _amount) {
  if (balances[msg.sender] < _amount) throw;
  balances[msg.sender] -= _amount;
  balances[_to] += _amount;
}

transfer函式定義了如何轉帳，只要指定要傳送的帳號與數目，就會從呼叫者手上把對應數目的代幣移轉到指定的帳號上。

graph LR 傳送者 -- 轉帳 --> 代幣合約 代幣合約 -.-> 修改傳送者和接收者餘額

if (balances[msg.sender] < _amount) throw;語句判斷帳戶中是否還有足夠轉出的餘額，若存款小於想轉出的數目，就丟出(throw)錯誤。這函式這麼寫當然還是過度簡化了，若要能實際使用，需要檢查更多可能的狀況。但就先這樣吧。

function balanceOf(address _owner) constant returns (uint256) {
  return balances[_owner];
}

balanceOf函式的作用，是讓使用者可以查詢任一帳號的餘額。透過傳入_owner帳號，可以查詢_owner帳號儲存在balances對照表中的值。

graph LR 傳送者 --> 代幣合約 代幣合約 -. 查詢結果 .-> 傳送者

如此一來，我們就寫好一個新加密代幣🔒💵合約囉！接下來要將合約編譯與部署到區塊鏈上。

編譯與部署

在migrations/目錄下建立一個3_deploy_token.js檔案，內容如下：

var SimpleToken = artifacts.require("SimpleToken");
module.exports = function(deployer) {
  deployer.deploy(SimpleToken);
};

現在可執行compile與migrate命令

$ truffle compile
...
$ truffle migrate
Using network 'development'.
Running migration: 3_deploy_token.js
  Deploying HelloToken...
  ... 0x2c4659528c68b4e43d1edff6c989fba05e8e7e56cc4085d408426d339b4e9ba4
  SimpleToken: 0x352fa9aa18106f269d944935503afe57a00a9a0d
Saving successful migration to network...
  ... 0x1434c1b61e9719f410fc6090ce37c0ec141a1738aba278dd320738e4a5d229fa
Saving artifacts...

如此一來我們已將SimpleToken代幣合約部署到testrpc上。

驗證

合約部署完成後，我們可以使用truffle console命令開啟console，輸入以下命令來驗證合約是否能照我們設計的方式運作。

$ truffle console
> let contract
> SimpleToken.deployed().then(instance => contract = instance)
> contract.balanceOf(web3.eth.coinbase)
{ [String: '88888'] s: 1, e: 4, c: [ 88888 ] }
> contract.balanceOf(web3.eth.accounts[1])
{ [String: '0'] s: 1, e: 0, c: [ 0 ] }
> contract.transfer(web3.eth.accounts[1], 123)
...
> contract.balanceOf(web3.eth.coinbase)
{ [String: '88765'] s: 1, e: 4, c: [ 88765 ] }
> contract.balanceOf.call(web3.eth.accounts[1])
{ [String: '123'] s: 1, e: 2, c: [ 123 ] }
>

講解

> let contract
> SimpleToken.deployed().then(instance => contract = instance)

這邊使用SimpleToken.deployed().then語句來取得SimpleToken合約的Instance(實例)，並存到contract變數中，以方便後續的呼叫。

> contract.balanceOf(web3.eth.coinbase)
{ [String: '88888'] s: 1, e: 4, c: [ 88888 ] }
> contract.balanceOf(web3.eth.accounts[1])
{ [String: '0'] s: 1, e: 0, c: [ 0 ] }

還記得啟動testrpc後預設會產生10個帳號(Accounts)嗎?。web3.eth.coinbase 代表操作者預設的帳號，即10個帳號中的第一個帳號web3.eth.accounts[0]。 這兩句的目的是在進行轉帳操作前，先查詢前兩個帳號所擁有的代幣餘額。透過呼叫balanceOf函式，可以看到第一個帳號(部署合約的帳號)裡存著所有的代幣。

> contract.transfer(web3.eth.accounts[1], 123)
...

接著使用transfer函式來傳送123個代幣到第二個帳號web3.eth.accounts[1]。如果轉帳成功，傳送者預設帳號中會減少123個代幣，接收者帳號中會增加123個代幣。

> contract.balanceOf(web3.eth.coinbase)
{ [String: '88765'] s: 1, e: 4, c: [ 88765 ] }
> contract.balanceOf.call(web3.eth.accounts[1])
{ [String: '123'] s: 1, e: 2, c: [ 123 ] }
>

我們再次透過呼叫balanceOf函式，查詢傳送者帳號和接收者帳號各自剩下的SimpleToken數目。發現轉帳真的成功了。

一堆安全漏洞💣，怎解?

寫智能合約看起來並不困難吧？但因為智能合約的運作是透明公開的，而且其中牽涉了代幣或金錢的流動，這提供了駭客很強的挑戰動機。

因此如果要妥善處理智能合約，會遇到的諸多安全問題。即使單純如本篇中的SimpleToken，也至少會遇到transfer函式中沒有禁止傳入負數金額，沒有檢查接收者帳號是否合法等等的問題。

有著一堆安全漏洞的合約，輕則執行失敗白花交易費用，嚴重則影響到合約中的代幣或以太幣。已有多起因為合約的漏洞，造成儲存在合約中的代幣或以太幣被駭客轉走，使得ICO失敗的案例。

有興趣可以查看參考資料4和5了解智能合約當前的一些最佳實現。

結語

看完這篇除了學到本篇講解的SimpleToken外，應該也可以大致看得懂truffle預設的MetaCoin.sol合約了。不同的細節可以查看solidity相關語法2。 下一篇會接著介紹如何使用經過驗證的函式庫，來建立一份可以放到乙太幣錢包👛的加密代幣🔒💵合約。

參考資料

蓋索林 Gasolin

Posted on  |    |   2,328 words, 1 min. read   |  

上一篇中介紹了智能合約📒是什麼，也概略描述了從編譯到部署智能合約的流程，接下來將介紹如何使用solidity語言來寫智能合約。

使用solidity語言撰寫智能合約

Ethereum上的智能合約需要使用solidity1語言來撰寫。雖然還有其他能用來撰寫智能合約的語言如Serpent(類Python)、lll(類Fortran)，但目前看到所有公開的智能合約都是使用solidity撰寫。

宣傳上說，solidity是一種類似Javascript的語言，而且圍繞著solidity的各種開發工具鏈，都是使用屬於Javascript生態系的npm來提供的。但我覺得solidity還是比較像Java或C#。 因為和Javascript不同，solidity與Java或C#同屬於強型別(Strong Type，在定義變數時需要指定型別)語言、在定義函式(function)時同樣需指定回傳的型別(type)、同樣也需要先編譯才能執行。這些特性都是Javascript所不具備的。

開發前的準備

本文將使用當前最活躍的智能合約開發框架truffle3為基礎來開發。之前提到過的ENS(Ethereum Name Service)5也是採用truffle框架。其他選擇還有embark4等。

就像一般網站或App開發一樣，在提供公開服務之前，開發者會在自己用於寫程式的電腦(又稱作本機)💻或透過測試網路🕸來測試程式執行的效果，測試完成後，才會部署到公開的網路上提供服務。 開發區塊鏈智能合約(程式)的過程也是如此。特別是公開鏈上所有寫入或讀取計算結果的操作都需要真金白銀(虛擬代幣)💸，而且根據網路狀況，每個公開鏈上的操作都需要要一小段反應時間(15秒 ~ 數分鐘)，這些等待頗浪費寶貴的開發時間⏳。 因此在開發的過程中，我們將使用testrpc6工具在電腦上模擬智能合約所需的乙太坊區塊鏈測試環境。

testrpc中也包含了Javascript版本的Ethereum虛擬機(Ethereum Virtual Machine)7，因此可以完整地執行智能合約😇。

此外，開發前還需準備一個合手的編輯器。我目前是使用Visual Studio Code搭配solidity插件來開發。solidity插件除了支援語法高亮之外，也會透過Solium11檢查並提示基本的語法錯誤，相當方便。其他編輯器應該也有類似的插件可選擇。

安裝所需工具

首先開發機上必須裝好Node.js，再使用以下命令安裝所需的工具：

$ npm install -g ethereumjs-testrpc truffle

啟動 Testrpc

安裝好後隨時可以使用testrpc命令來啟動乙太坊測試環境。

$ testrpc
Available Accounts
==================
(0) 0xa4d7ce9137e6f8de4fb1311595b33230be15be50
(1) 0x26c231bdd7c8a7304983b04694c3437b30331019
(2) 0xe238ccca936dcdbd48f0cf3a1e6f147d04b55527
(3) 0x769ed341bf83cc86e5037cb78388012d6e2d9cc9
(4) 0x72a084c80195de79e5cd8dca59488e67982f65d7
(5) 0xcfda0765b0a82721d2f59581f53846a12e392999
(6) 0x4b0349aea768b4e1ed4cec683f8f7dd112729fea
(7) 0x643c305f0b3844984d7f1f7b9f3ab93a73dfdfcf
(8) 0x2ee0a7974326604442dca127d02fac4957ab3e8a
(9) 0xe00e57db1772f6e81bcccc982e565a10ae26ab92
Private Keys
==================
(0) 7de56fb677edc8d0c7a1f3a6d5bcb8f73ce257d44996e9b5fc8ad414af38a22a
(1) 4401de20cf287d15d1c062005d866a35cd82e2a73f8cb43ec0cb90b117d1ec38
(2) 8f51f9100a81218343d44a047ae3b0be5d80d262a13fbef24dc569b3e335e820
(3) 241a0ff98dfb6f290dbee909c9a7a4eea2de3a2174e7cddf834868ea03f80fa9
(4) ce1108cc6763bc74658068a55b080c6ccbfb1bd26e609588b81c07d13affc70d
(5) f9614c1fd34224787e6c95bbe881fb28fd0fdc00808ef85d0430505f4a348690
(6) 4c1baad08f720f5c5754bb185e66490b45e3480aa3ec419e4b76f7a81118b296
(7) af9af2c6b519d49605cc58b719240299e5e8b9a89a7e94a85625734fc30c46bd
(8) 55ab79ae6de4fad5b98bc1dfd795b945ba8e7d92dcc88073f9e3fdfef471f69f
(9) e9299fb391c8830370991659780933e6b62269e32a8cbc55a29aa5f73df995a2
HD Wallet
==================
Mnemonic:      addict cherry medal cupboard bless reduce oven beauty egg gift pledge exact
Base HD Path:  m/44'/60'/0'/0/{account_index}

可以看到testrpc啟動後自動建立了10個帳號(Accounts)，與每個帳號對應的私鑰(Private Key)🔑。每個帳號中都有100個測試用的以太幣(Ether)💵。要注意testrpc僅運行在記憶體中，因此每次重開時都會回到全新的狀態。

一切準備就緒，我們可以開始建立第一份智能合約專案了。

建立專案

開啟另一個命令列視窗，輸入以下命令以建立專案：

$ mkdir demo
$ cd demo
$ truffle init

如此一來，我們已建立好第一份智能合約專案了。

在demo/資料夾下，可以看到contracts/資料夾，裡面放的是這個專案所包含的所有solidity程式。我們在contracts/資料夾中額外建立一個HelloWorld.sol檔案。（或者也可以用truffle create contract HelloWorld命令來建立）

HelloWorld.sol檔案內容如下：

pragma solidity ^0.4.11;
contract HelloWorld {
  function sayHello() returns (string) {
    return ("Hello World");
  }
}

講解

pragma solidity ^0.4.11;

第一行指名目前使用的solidity版本，不同版本的solidity可能會編譯出不同的bytecode。

contract HelloWorld {
  ...
}

contract關鍵字類似於其他語言中較常見的class。因為solidity是專為智能合約(Contact)設計的語言，宣告contract後即內建了開發智能合約所需的功能。也可以把這句理解為class HelloWorld extends Contract。

function sayHello() returns (string) {
  return ("Hello World");
}

函式的結構與其他程式類似，但如果有傳入的參數或回傳值，需要指定參數或回傳值的型別(type)。所有支援的型別可以查看參考資料10。

編譯

現在執行truffle compile命令，我們可以將HelloWorld.sol原始碼編譯成Ethereum bytecode。

$ truffle compile

編譯成功的話，在build/contracts/目錄下會多出HelloWorld.json這個檔案。（在Windows平台上執行truffle compile若遇到問題，可以查看參考資料9來解決。）

部署

truffle框架中提供了方便部署合約的腳本。打開migrations/2_deploy_contracts.js檔案(腳本使用Javascript撰寫)，將內容修改如下

var HelloWorld = artifacts.require("HelloWorld");
module.exports = function(deployer) {
  deployer.deploy(HelloWorld);
};

使用artifacts.require語句來取得準備部署的合約。使用deployer.deploy語句將合約部署到區塊鏈上。這邊HelloWorld是contract的名稱而不是檔名。因此可以用此語法讀入任一.sol檔案中的任一合約。

現在執行truffle migrate命令，

$ truffle migrate
Using network 'development'.
Running migration: 1_initial_migration.js
...
Saving successful migration to network...
Running migration: 2_deploy_contracts.js
...
Saving successful migration to network...
...
Saving artifacts...

如此一來合約已經部署到testrpc中。切換到testrpc視窗，可以看到testrpc有反應了。

與合約互動

truffle提供命令行工具，執行truffle console命令後，可用Javascript來和剛剛部署的合約互動。

$ truffle console
> let contract
> HelloWorld.deployed().then(instance => contract = instance)
> contract.sayHello.call()
'Hello World'
>

講解

> HelloWorld.deployed().then(instance => contract = instance)

truffle console中預載了truffle-contract12函式庫，以方便操作部署到區塊鏈上的合約。

這邊使用HelloWorld.deployed().then語句來取得HelloWorld合約的Instance(實例)，並存到contract變數中，以方便後續的呼叫。

上面用的是Javascript ES6+的語法，這句也可以寫成

HelloWorld.deployed().then(function(instance) {
  hello = instance;
});
> contract.sayHello.call()
'Hello World'

這邊直接呼叫contract.sayHello()也會得到一樣的結果。truffle-contract提供使用call()來讀取唯讀(read only)的資料，這樣就不需提供gas。因此如果遇到的操作需要向區塊鏈寫入資料，我們就不能用call語句了。

如此一來，我們已寫好並部署完成了第一個智能合約，也驗證了合約確實可以運作。

加入新方法

我們在HelloWorld.sol中再加入一個echo方法，echo方法接受輸入一個參數，並回傳傳送的參數。

function echo(string name) constant returns (string) {
  return name;
}

新的echo方法中傳入了一個name參數。我們也為echo方法加入一個constant宣告，表示呼叫這個方法並不會改變區塊鏈的狀態。如此一來，透過truffle-contract來呼叫此方法時，會自動選用call來呼叫，也不需要額外提供gas。

由於更新了合約內容，我們需要先重新新編譯一次，將編譯結果部署到testrpc上，再透過truffle console執行看看結果。

$ truffle compile
...
$ truffle migrate --reset
...
$ truffle console
> let contract
> HelloWorld.deployed().then(instance => contract = instance)
> contract.echo("yo man")
'yo man'
>

echo方法確實將我們輸入的內容回傳了。同時因為宣告了constant，我們不需要直接呼叫call()方法，truffle會自動選用call來呼叫。

另一點需要注意的，是這次如果還是用truffle migrate命令，我們會得到如下訊息：

$ truffle migrate
Using network 'development'.
Network up to date.

Truffle會告訴你現在網路上的合約都已是最新的，但事實上剛剛程式中新增的方法並沒有更新到區塊鏈上。要更新區塊鏈上已部署的程式，需要改寫migrations中的腳本，但現在還不到介紹migration的時候。還好我們開發用的區塊鏈是怎麼修改都沒關係的testrpc，可以使用truffle migrate --reset命令直接重新在testrpc上部署一次🎉。

結語

本篇設計的範例8相當簡單，但已達到完整地帶大家快速⚡️走一遍智能合約開發流程的目的。要透過智能合約實現各種功能，可以參考Solidity by example 和 Truffle getting started 網站學習更多的內容。也歡迎讀者留言，分享學習資源或提供建議。

下一篇會接著介紹如何建立一份簡單的加密代幣🔒💵合約。

參考資料