摘要：星云計劃智能合約代碼入門卡酷少星云團隊已經(jīng)發(fā)布了數(shù)個庫來幫助大家更容易編寫智能合約。參數(shù)級別參數(shù)級別參數(shù)級別參數(shù)級別參數(shù)別名如何調(diào)用合約以上就是與智能合約相關(guān)的內(nèi)置功能模塊介紹。

卡酷少
Wechat:13260325501

星云團隊已經(jīng)發(fā)布了數(shù)個庫來幫助大家更容易編寫智能合約。這意味著我們不需要從頭開始來創(chuàng)建任何一個智能合約，節(jié)省了很多精力。但這些庫里面的內(nèi)容我們需要逐個了解。

BigNumber 模塊構(gòu)建于 bignumber.js之上，用來處理任意精度的十進制和非十進制運算。合約可以直接使用BigNumber 來處理交易和其他轉(zhuǎn)賬操作中涉及到的數(shù)值計算。

var value = new BigNumber(0);//創(chuàng)建bigNumber對象
value.plus(1);//調(diào)用方法
…

storage 模塊用來支持 Nebulas 上的數(shù)據(jù)持久化存儲。功能上類似于傳統(tǒng)的鍵值存儲系統(tǒng)。存儲不是免費的，需要消耗一定的 GAS。LocalContractStorage 是可以直接在合約中使用的內(nèi)置storage對象，可存儲的數(shù)據(jù)類型包括數(shù)字、字符串和 JavaScript 對象（需要序列化為字符串，JSON轉(zhuǎn)譯）。鏈上數(shù)據(jù)只能被存儲它們的合約訪問和修改，也就是自己的合約地址只能調(diào)用和修改自己合約里的內(nèi)容。

LocalContractStorage 支持三個操作：

set，實現(xiàn)存儲功能，類似于put

get，實現(xiàn)讀取功能

del，實現(xiàn)刪除數(shù)據(jù)功能

“use strict”;
var BankVaultContract = function () {
  // 無內(nèi)容
};
BankVaultContract.prototype = {//prototype里有三個方法：get，set，delete
  init: function() {
      // 無內(nèi)容
  },
  set: function(name, value) { //set，存儲數(shù)據(jù)
  // 以下“增查刪”操作都以name=”robin”, value=10000為例
  //LocalContractStorage一個封裝包，“.set”是帶哦用set方法
      LocalContractStorage.set(“name”, name);
      // put 操作相當于 set
      LocalContractStorage.put(“value”, value);
  },
  get: function() {//get，獲取數(shù)據(jù)
      var name = LocalContractStorage.get(“name”);
      console.log(name);  // 打印 ‘robin’
      var value = LocalContractStorage.get(“value”);
     console.log(value); // 打印 ‘10000’
  },
  del: function() {//del，刪除
      var result = LocalContractStorage.del(“name”);
      console.log(result); // 打印 ‘robin’
      // delete 操作相當于 del
      result = LocalContractStorage.delete(“value”);
      console.log(result); // 打印 ‘10000’
      // 刪除操作之后數(shù)據(jù)就不能被讀取
  }
};
module.exports = BankVaultContract;

Blockchain模塊用來獲取當前正在執(zhí)行的合約內(nèi)的交易和區(qū)塊信息。另外，還提供了幾個有用的方法，例如從合約賬戶中轉(zhuǎn)出 NAS，進行地址格式驗證等。

Blockchain 有兩個屬性：

block 執(zhí)行合約的當前區(qū)塊

它具有下列屬性：

— timestamp 區(qū)塊時間戳

— height 區(qū)塊高度

2.transaction 執(zhí)行合約的當前交易

它具有下列屬性：

— hash 交易哈希值

— from 交易源地址

— to 交易目的地址，對于合約調(diào)用就是合約地址

— value 交易數(shù)值，字符串， 合約內(nèi)用BigNumber存儲計算

— nonce 交易的 nonce 值

— timestamp 交易時間戳

— gasPrice 交易的 gasPrice，字符串，合約內(nèi)用 BigNumber 存儲計算

— gasLimit 交易的 gasLimit，字符串，合約內(nèi)用 BigNumber 存儲計算

Blockchain 還提供了兩個方法：

transfer(address, value) 將 NAS 從合約轉(zhuǎn)出到address對應(yīng)的賬戶。

參數(shù) address：接收 NAS 的 Nebulas 賬戶地址

參數(shù) value：轉(zhuǎn)移數(shù)值，一個 BigNumber 對象

返回：0 – 轉(zhuǎn)移成功，1 – 轉(zhuǎn)移失敗

verifyAddress(address) 驗證參數(shù) address 是否為一個有效的 Nebulas 地址。

返回：1 – 地址有效，0 – 地址無效

‘use strict’;
var BankVaultContract = function () {};//聲明類
BankVaultContract.prototype = {//類的方法
   init: function () {
       console.log(‘init: Blockchain.block.height = ‘ + Blockchain.block.height);
       console.log(‘init: Blockchain.transaction.from = ‘ + Blockchain.transaction.from);
   },
   //這里給出兩個方法：transfer和 verifyaddress
   transfer: function (address, value) {
       var result = Blockchain.transfer(address, value);
       console.log(“transfer result:”, result);
   },
   verifyAddress: function (address) {
    var result = Blockchain.verifyAddress(address);
       console.log(“verifyAddress result:”, result);
   }
};
module.exports = BankVaultContract;

Event 模塊用來記錄在合約執(zhí)行過程中產(chǎn)生的事件。被記錄的事件存儲在鏈上的事件Trie結(jié)構(gòu)中，可以通過事件查詢方法 rpc.getEventsByHash 獲取所有事件。通過Event模塊輸出的事件其最終Topic由用戶自定義topic加固定前綴 chain.contract. 兩部分構(gòu)成 。

使用方法如下：

//Event.Trigger(topic, obj);
//topic：用戶定義的topic
//obj：JSON 對象

‘use strict’;
var BankVaultContract = function () {};//聲明類
BankVaultContract.prototype = {

   init: function () {},
//這里只有一個testevent方法
//testevent里又一個event.Trigger()
//event.Trigger里有("topic"，{ data{} })
testEvent: function() {
       // 實際被存儲的topic是“chain.contract.topic”
       Event.Trigger(“topic“, {
   Data: {
value: “Event test.”
   }
       });
   }
};
module.exports = BankVaultContract;

console 模塊提供了一個簡單的調(diào)試控制臺，類似于網(wǎng)頁瀏覽器提供的 JavaScript 控制臺。console 將把所有接收到的 args 以指定級別打印到 Nebulas Logger 上。

console.log([參數(shù))?—?— info 級別

console.debug([參數(shù))?—?— debug 級別

console.warn([參數(shù))?—?— warn 級別

console.error(參數(shù))?—?— error 級別

console.info(參數(shù))?—?— console.log() 別名

以上就是與智能合約相關(guān)的內(nèi)置功能模塊介紹。接下來，我們將簡單說明下如何調(diào)用合約。

首先通過啟動本地節(jié)點加入 Nebulas 的主網(wǎng)或測試網(wǎng)，啟動本地節(jié)點。

節(jié)點啟動后，調(diào)用任何合約函數(shù)前首先使用 [unlockAccount()]

(https://github.com/nebulasio/...` 方法解鎖賬戶。

然后你就可以使用 sendTransaction() 函數(shù)來執(zhí)行智能合約調(diào)用了。

// Request
//終端命令行
curl -i -H ‘Accept: application/json’ -X POST http://localhost:8685/v1/admin/transaction -H ‘Content-Type: application/json’ -d ‘{“from”:”n1NZttPdrJCwHgFN3V6YnSDaD5g8UbVppoC”,”to”:”n1qsgj2C5zmYzS9TSkPTnp15bhCCocRPwno”, “value”:”100″,”nonce”:8,”gasPrice”:”1000000″,”gasLimit”:”2000000″,”contract”:{“function”:”testEvent”,”args”:”[]”}}’
// Result
//運行結(jié)果
{
“result”:{“txhash”:”b55358c2e12c1d48d4e6beaee7002a59138294fb2896ea8059ff5277553af59f”,”contract_address”:””}
}