2021-9-24 前端達人
web3.js是以太坊提供的一個Javascript庫，它封裝了以太坊的JSON RPC API，提供了一系列與區塊鏈交互的Javascript對象和函數，包括查看網絡狀態，查看本地賬戶、查看交易和區塊、發送交易、編譯/部署智能合約、調用智能合約等，其中最重要的就是與智能合約交互的API。
下面就介紹如何使用web3.js提供的接口調用智能合約。
系統和軟件
-
Ubuntu 16.04 64位
-
nodejs 6.10.0
-
npm 3.10.10
示例合約
本文以下面的MetaCoin合約為例，說明在應用中使用web3.js操作智能合約的方法。
-
// 本文中用到的MetaCoin合約
-
pragma solidity ^0.4.2;
-
-
contract MetaCoin {
-
mapping (address => uint) balances;
-
-
event Transfer(address indexed _from, address indexed _to, uint256 _value);
-
-
function MetaCoin() {
-
balances[tx.origin] = 10000;
-
}
-
-
function sendCoin(address receiver, uint amount) returns(bool sufficient) {
-
if (balances[msg.sender] < amount) return false;
-
balances[msg.sender] -= amount;
-
balances[receiver] += amount;
-
Transfer(msg.sender, receiver, amount);
-
return true;
-
}
-
-
function getBalance(address addr) returns(uint) {
-
return balances[addr];
-
}
-
}
這個合約有三個函數：
MetaCoin：構造函數，在合約被部署到區塊鏈時執行
getBalance：返回某賬戶的余額，它只讀數據，不會修改數據
sendCoin：向另一個賬戶發送指定數量的MetaCoin，它會改變狀態變量balances
啟動一個以太坊節點，將上面的合約部署到區塊鏈中，并記錄下合約的地址，可以通過truffle部署，具體參考這篇文章。 接下來就可以按照下面的步驟在項目中通過web3.js來使用這個合約。
添加web3到項目中
首先新建一個Nodejs項目并初始化：
-
$ mkdir web3test && cd web3test
-
$ npm init
會提示輸入項目信息，全部默認即可。
接下來下載web3.js到項目中：
$ npm install web3 --save 以上命令會將web3.js下載到web3test/node_modules目錄下，其中–save參數會web3.js添加到package.json配置文件中。
創建web3對象
要使用web3.js與區塊鏈交互，需要先創建web3對象，然后連接到以太坊節點。 在web3test目錄下新建index.js文件，在其中輸入以下代碼：
-
var Web3 = require("web3");
-
// 創建web3對象
-
var web3 = new Web3();
-
// 連接到以太坊節點
-
web3.setProvider(new Web3.providers.HttpProvider("http://localhost:8545"));
獲取已部署的合約實例
要使用智能合約，必須先從區塊鏈中獲取到合約實例，獲取合約實例需要合約的ABI和合約的地址：
-
// 合約ABI
-
var abi = [{"constant":false,"inputs":[{"name":"receiver","type":"address"},{"name":"amount","type":"uint256"}],"name":"sendCoin","outputs":[{"name":"sufficient","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"addr","type":"address"}],"name":"getBalance","outputs":[{"name":"","type":"uint256"}],"payable":false,"type":"function"},{"inputs":[],"payable":false,"type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"name":"_from","type":"address"},{"indexed":true,"name":"_to","type":"address"},{"indexed":false,"name":"_value","type":"uint256"}],"name":"Transfer","type":"event"}];
-
// 合約地址
-
var address = "0xb2cdd356e58280906ce53e1665697b50f88aac56";
-
// 通過ABI和地址獲取已部署的合約對象
-
var metacoin = web3.eth.contract(abi).at(address);
metacoin就是獲取到的合約對象實例，此時metacoin對象中就包含了與合約函數同名的Javascript函數，之后就可以通過metacoin對象來調用合約中的函數了。
調用合約函數
MetaCoin合約中有兩個函數：getBalance和sendCoin，可以通過metacoin對象直接調用這兩個函數。
首先來看getBalance，由于getBalance函數只是從區塊鏈中讀數據，而不修改數據，因此我們通過在getBalance后面加上.call()的方式調用：
-
var account_one = web3.eth.accounts[0];
-
var account_one_balance = metacoin.getBalance.call(account_one);
-
console.log("account one balance: ", account_one_balance.toNumber());
這里：
在getBalance后加上.call()來顯式指明用call的方式調用
通過call的方式調用可以得到getBalance函數的返回值
通過call的方式調用的函數只在節點本地虛擬機中執行，不會產生交易，不會花費費用，不會修改數據
下面來看sendCoin函數，由于sendCoin要修改合約內部的數據，所以要使sendCoin生效，必須要向區塊鏈發送交易，可以在sendCoin后面加上.sendTransaction()來指明這是一筆交易：
-
var account_one = web3.eth.accounts[0];
-
var account_two = web3.eth.accounts[1];
-
// 提交交易到區塊鏈，會立即返回交易hash，但是交易要等到被礦工收錄到區塊中后才生效
-
var txhash = metacoin.sendCoin.sendTransaction(account_two, 100, {from:account_one});
-
console.log(txhash);
這里：
在sendCoin函數后加上.sendTransaction()指明要向區塊鏈發送交易
合約代碼中sendCoin函數只有兩個參數，而在web3中通過.sendTransaction()調用合約函數的時候需要增加最后一個參數，它是一個javascript對象，里面可以指定from/value/gas等屬性，上面的例子用from來指定交易的發送者
上面的調用語句執行后，會向區塊鏈提交一筆交易，這筆交易的發送者是account_one，接收者是metacoin的地址，交易的作用是以account_two和100作為參數執行合約的sendCoin函數
函數會立即返回交易的hash，表明交易已經提交到區塊鏈，但是并不知道交易何時處理完成，交易要等到被曠工收錄到區塊中后才會生效
監聽合約事件
當通過.sendTransaction()調用合約的時候，交易會被提交到區塊鏈進行處理，這個處理需要一定的時間，如果需要等交易完成之后再執行其他操作，就必須要知道交易何時完成，那么如何知道交易何時完成呢？可以通過監聽合約事件來實現。
在合約中可以定義事件，事件可以帶有參數，在合約函數內部完成某些操作時，可以觸發事件，向外界傳達一些信息。例如，在MetaCoin合約中定義了一個事件叫做Transfer，表示一個轉賬的事件，它帶有三個參數：交易的發送者、接受者、轉賬數量。在sendCoin函數中，轉賬成功后就會觸發Transfer事件，將對應的參數傳給該事件，這樣外部監聽到事件后，可以取出事件的參數來獲得交易發送者、接收者、數量。同時事件中還帶有其他信息，比如交易hash等。
在web3中使用事件，要首先獲取事件對象，然后監聽事件，如果事件發生，就會在回調函數中獲取到事件信息：
-
// 獲取事件對象
-
var myEvent = metacoin.Transfer();
-
// 監聽事件，監聽到事件后會執行回調函數
-
myEvent.watch(function(err, result) {
-
if (!err) {
-
console.log(result);
-
} else {
-
console.log(err);
-
}
-
myEvent.stopWatching();
-
});
-
-
// 輸出：
-
{ address: '0xb2cdd356e58280906ce53e1665697b50f88aac56',
-
blockNumber: 651,
-
transactionIndex: 0,
-
transactionHash: '0xcc71bc2824cc84d1ee831c46189e3a80cf0af05697ba0370693aa97390c8067b',
-
blockHash: '0x1d53f04206f3926d0f311b1230a9dd0b0c5aadac35b169a6a609e384ab130c6f',
-
logIndex: 0,
-
removed: false,
-
event: 'Transfer',
-
args:
-
{ _from: '0x68b73956d704007514e9257813bdc58cdf3c969a',
-
_to: '0x9c3c1a2f5ef913fac44f0348a78f68d835f3f26e',
-
_value: { [String: '100'] s: 1, e: 2, c: [Object] } } }
從輸出可以看出，獲取到的事件信息包括事件的參數、事件名、區塊號、交易hash等。
通過檢測事件中的transactionHash與調用合約函數返回的交易hash是否一致，可以判定某一筆交易是否已完成：
-
var account_one = web3.eth.accounts[0];
-
var account_two = web3.eth.accounts[1];
-
-
var account_one_balance = metacoin.getBalance.call(account_one);
-
console.log("account one balance:", account_one_balance.toNumber());
-
-
var txhash = metacoin.sendCoin.sendTransaction(account_two, 100, { from: account_one });
-
-
var myEvent = metacoin.Transfer();
-
myEvent.watch(function (err, result) {
-
if (!err) {
-
if (result.transactionHash == txhash) {
-
var account_one_balance = metacoin.getBalance.call(account_one);
-
console.log("account one balance after sendCoin:", account_one_balance.toNumber());
-
}
-
} else {
-
console.log(err);
-
}
-
myEvent.stopWatching();
-
});
-
-
// 輸出：
-
account one balance: 7000
-
account one balance after sendCoin: 6900
watch中的回調函數如果被執行，說明事件已被觸發，也就是說某筆交易已經處理完，檢查交易hash是否一致，可以判定產生這個事件的交易是否是自己發送的交易，如果是，就可以進行其他操作，比如查詢最新的余額
分享此文一切功德，皆悉回向給文章原作者及眾讀者.
轉自：csdn
免責聲明：藍藍設計尊重原作者，文章的版權歸原作者。如涉及版權問題，請及時與我們取得聯系，我們立即更正或刪除。
藍藍設計( www.gyxygd.cn )是一家專注而深入的界面設計公司，為期望卓越的國內外企業提供卓越的UI界面設計、BS界面設計 、 cs界面設計 、 ipad界面設計 、 包裝設計 、 圖標定制 、 用戶體驗 、交互設計、 網站建設 、平面設計服務
藍藍設計的小編 http://www.gyxygd.cn