下面教程是打算在盡量牽涉可能少的以太坊的相關工具，主要使用web3.js這個以太坊提供的工具包，來完成合約的編譯，發布，合約方法調用的一整個流程。一方面來了解以太坊開發到底需要什么，另一方面來對web3.js的API有個基本的了解。由于所有其它工具都或多或少的是對web3.js的底層函數的包裝，所以對web3.js使用流程有個認識之后，也能更好的入門，使用相關的工具。
1. 準備工作
1.1 安裝Node.js
由于我們要使用web3.js[1]。這里使用Node來集成web3.js模塊（當然，你還可以使用其它的方式）。你可以通過參考官網文檔安裝[2]。
1.1.1 Ubuntu
如果你使用ubuntu，可以使用下述命令：
//安裝Node
sudo apt-get install nodejs
//安裝Node的包管理器
sudo apt-get install npm
1.1.2 MAC
如果你使用Homebrew，可以使用下述命令：
//安裝Node
brew install node
//安裝Node的包管理器
brew install npm
1.1.3 安裝檢查
安裝成功后，可以查看下當前的版本，確認正常安裝：
$ node -v
v7.2.0
1.2 以太坊的節點
由于整個合約代碼的執行需要一個虛擬機環境，所以在開始之前，我們不得不安裝一個實現了以太坊虛擬機的節點。
可以選擇一個輕量級的節點，比如EtherumJS TestRPC，它是一個完整的在內存中的區塊鏈僅僅存在于你開發的設備上。它在執行交易時是實時返回，而不等待默認的出塊時間，這樣你可以快速驗證你新寫的代碼，當出現錯誤時，也能即時反饋給你。
npm install -g ethereumjs-testrpc
安裝好后，你就可以通過testrpc命令來啟動了，啟動與大多數以太坊節點一樣，運行在localhost:8545。
如果你安裝geth這樣的客戶端也是可以的。
1.3 Web3的支持
安裝web3的模塊[1]：
npm install web3
2. 合約編譯
2.1 一個簡單的合約
我們打算用來測試的合約如下：
pragma solidity ^0.4.0;
contract Calc{
/*區塊鏈存儲*/
uint count;
/*執行會寫入數據，所以需要`transaction`的方式執行。*/
function add(uint a, uint b) returns(uint){
count++;
return a + b;
}
/*執行不會寫入數據，所以允許`call`的方式執行。*/
function getCount() constant returns (uint){
return count;
}
}
add()方法用來返回輸入兩個數據的和，并會對add()方法的調用次數進行計數。需要注意的是這個計數是存在區塊鏈上的，對它的調用需要使用transaction。
getCount()返回add()函數的調用次數。由于這個函數不會修改區塊鏈的任何狀態，對它的調用使用call就可以了。
2.2 編譯合約
由于合約是使用Solidity編寫，所以我們可以使用web3.eth.compile.solidity來編譯合約[3]：
//編譯合約
let source = "pragma solidity ^0.4.0;contract Calc{ /*區塊鏈存儲*/ uint count; /*執行會寫入數據，所以需要`transaction`的方式執行。*/ function add(uint a, uint b) returns(uint){ count++; return a + b; } /*執行不會寫入數據，所以允許`call`的方式執行。*/ function getCount() returns (uint){ return count; }}";
let calc = web3.eth.compile.solidity(source);
如果編譯成功，結果如下：
{
code: '0x606060405234610000575b607e806100176000396000f3606060405260e060020a6000350463771602f781146026578063a87d942c146048575b6000565b3460005760366004356024356064565b60408051918252519081900360200190f35b3460005760366077565b60408051918252519081900360200190f35b6000805460010190558181015b92915050565b6000545b9056',
info: {
source: 'pragma solidity ^0.4.0;contract Calc{ /*區塊鏈存儲*/ uint count; /*執行會寫入數據，所以需要`transaction`的方式執行。*/ function add(uint a, uint b) returns(uint){ count++; return a + b; } /*執行不會寫入數據，所以允許`call`的方式執行。*/ function getCount() returns (uint){ return count; }}',
language: 'Solidity',
languageVersion: '0.4.6+commit.2dabbdf0.Emscripten.clang',
compilerVersion: '0.4.6+commit.2dabbdf0.Emscripten.clang',
abiDefinition: [
[
Object
],
[
Object
]
],
userDoc: {
methods: {
}
},
developerDoc: {
methods: {
}
}
}
}
3. 發布合約
web3.js其實也像框架一樣對合約的操作進行了封裝。發布合約時，可以使用web3.eth.contract的new方法[4]。
let myContractReturned = calcContract.new({
data: deployCode,
from: deployeAddr
}, function(err, myContract) {
if (!err) {
// 注意：這個回調會觸發兩次
//一次是合約的交易哈希屬性完成
//另一次是在某個地址上完成部署
// 通過判斷是否有地址，來確認是第一次調用，還是第二次調用。
if (!myContract.address) {
console.log("contract deploy transaction hash: " + myContract.transactionHash) //部署合約的交易哈希值
// 合約發布成功
} else {
}
});
部署過程中需要主要的是，new方法的回調會執行兩次，第一次是合約的交易創建完成，第二次是在某個地址上完成部署。需要注意的是只有在部署完成后，才能進行方法該用，否則會報錯TypeError: myContractReturned.add is not a function。
4. 調用合約
由于web3.js封裝了合約調用的方法。我們可以使用可以使用web3.eth.contract的里的sendTransaction來修改區塊鏈數據。在這里有個坑，有可能會出現Error: invalid address，原因是沒有傳from，交易發起者的地址。在使用web3.js的API都需留意，出現這種找不到地址的，都看看from字段吧。
//使用transaction方式調用，寫入到區塊鏈上
myContract.add.sendTransaction(1, 2,{
from: deployeAddr
});
console.log("after contract deploy, call:" + myContract.getCount.call());
需要注意的是，如果要修改區塊鏈上的數據，一定要使用sendTransaction，這會消耗gas。如果不修改區塊鏈上的數據，使用call，這樣不會消耗gas。
5. 使用web3.js編譯，發布，調用的完整源碼
let Web3 = require('web3');
let web3;
if (typeof web3 !== 'undefined') {
web3 = new Web3(web3.currentProvider);
} else {
// set the provider you want from Web3.providers
web3 = new Web3(new Web3.providers.HttpProvider("http://localhost:8545"));
}
let from = web3.eth.accounts[0];
//編譯合約
let source = "pragma solidity ^0.4.0;contract Calc{ /*區塊鏈存儲*/ uint count; /*執行會寫入數據，所以需要`transaction`的方式執行。*/ function add(uint a, uint b) returns(uint){ count++; return a + b; } /*執行不會寫入數據，所以允許`call`的方式執行。*/ function getCount() constant returns (uint){ return count; }}";
let calcCompiled = web3.eth.compile.solidity(source);
console.log(calcCompiled);
console.log("ABI definition:");
console.log(calcCompiled["info"]["abiDefinition"]);
//得到合約對象
let abiDefinition = calcCompiled["info"]["abiDefinition"];
let calcContract = web3.eth.contract(abiDefinition);
//2. 部署合約
//2.1 獲取合約的代碼，部署時傳遞的就是合約編譯后的二進制碼
let deployCode = calcCompiled["code"];
//2.2 部署者的地址，當前取默認賬戶的第一個地址。
let deployeAddr = web3.eth.accounts[0];
//2.3 異步方式，部署合約
let myContractReturned = calcContract.new({
data: deployCode,
from: deployeAddr
}, function(err, myContract) {
if (!err) {
// 注意：這個回調會觸發兩次
//一次是合約的交易哈希屬性完成
//另一次是在某個地址上完成部署
// 通過判斷是否有地址，來確認是第一次調用，還是第二次調用。
if (!myContract.address) {
console.log("contract deploy transaction hash: " + myContract.transactionHash) //部署合約的交易哈希值
// 合約發布成功后，才能調用后續的方法
} else {
console.log("contract deploy address: " + myContract.address) // 合約的部署地址
//使用transaction方式調用，寫入到區塊鏈上
myContract.add.sendTransaction(1, 2,{
from: deployeAddr
});
console.log("after contract deploy, call:" + myContract.getCount.call());
}
// 函數返回對象`myContractReturned`和回調函數對象`myContract`是 "myContractReturned" === "myContract",
// 所以最終`myContractReturned`這個對象里面的合約地址屬性也會被設置。
// `myContractReturned`一開始返回的結果是沒有設置的。
}
});
//注意，異步執行，此時還是沒有地址的。
console.log("returned deployed didn't have address now: " + myContractReturned.address);
//使用非回調的方式來拿到返回的地址，但你需要等待一段時間，直到有地址，建議使用上面的回調方式。
/*
setTimeout(function(){
console.log("returned deployed wait to have address: " + myContractReturned.address);
console.log(myContractReturned.getCount.call());
}, 20000);
*/
//如果你在其它地方已經部署了合約，你可以使用at來拿到合約對象
//calcContract.at(["0x50023f33f3a58adc2469fc46e67966b01d9105c4"]);
關于作者
專注基于以太坊（Ethereum）的相關區塊鏈（Blockchain）技術，了解以太坊，Solidity，Truffle，web3.js。
個人博客: http://me.tryblockchain.org
版權所有，轉載注明出處
