摘要：星云計劃智能合約代碼入門卡酷少星云團隊已經發布了數個庫來幫助大家更容易編寫智能合約。參數級別參數級別參數級別參數級別參數別名如何調用合約以上就是與智能合約相關的內置功能模塊介紹。

卡酷少
Wechat:13260325501

星云團隊已經發布了數個庫來幫助大家更容易編寫智能合約。這意味著我們不需要從頭開始來創建任何一個智能合約，節省了很多精力。但這些庫里面的內容我們需要逐個了解。

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

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

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

LocalContractStorage 支持三個操作：

set，實現存儲功能，類似于put

get，實現讀取功能

del，實現刪除數據功能

“use strict”;
var BankVaultContract = function () {
  // 無內容
};
BankVaultContract.prototype = {//prototype里有三個方法：get，set，delete
  init: function() {
      // 無內容
  },
  set: function(name, value) { //set，存儲數據
  // 以下“增查刪”操作都以name=”robin”, value=10000為例
  //LocalContractStorage一個封裝包，“.set”是帶哦用set方法
      LocalContractStorage.set(“name”, name);
      // put 操作相當于 set
      LocalContractStorage.put(“value”, value);
  },
  get: function() {//get，獲取數據
      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’
      // 刪除操作之后數據就不能被讀取
  }
};
module.exports = BankVaultContract;

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

Blockchain 有兩個屬性：

block 執行合約的當前區塊

它具有下列屬性：

— timestamp 區塊時間戳

— height 區塊高度

2.transaction 執行合約的當前交易

它具有下列屬性：

— hash 交易哈希值

— from 交易源地址

— to 交易目的地址，對于合約調用就是合約地址

— value 交易數值，字符串， 合約內用BigNumber存儲計算

— nonce 交易的 nonce 值

— timestamp 交易時間戳

— gasPrice 交易的 gasPrice，字符串，合約內用 BigNumber 存儲計算

— gasLimit 交易的 gasLimit，字符串，合約內用 BigNumber 存儲計算

Blockchain 還提供了兩個方法：

transfer(address, value) 將 NAS 從合約轉出到address對應的賬戶。

參數 address：接收 NAS 的 Nebulas 賬戶地址

參數 value：轉移數值，一個 BigNumber 對象

返回：0 – 轉移成功，1 – 轉移失敗

verifyAddress(address) 驗證參數 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 模塊用來記錄在合約執行過程中產生的事件。被記錄的事件存儲在鏈上的事件Trie結構中，可以通過事件查詢方法 rpc.getEventsByHash 獲取所有事件。通過Event模塊輸出的事件其最終Topic由用戶自定義topic加固定前綴 chain.contract. 兩部分構成 。

使用方法如下：

//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 模塊提供了一個簡單的調試控制臺，類似于網頁瀏覽器提供的 JavaScript 控制臺。console 將把所有接收到的 args 以指定級別打印到 Nebulas Logger 上。

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

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

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

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

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

以上就是與智能合約相關的內置功能模塊介紹。接下來，我們將簡單說明下如何調用合約。

首先通過啟動本地節點加入 Nebulas 的主網或測試網，啟動本地節點。

節點啟動后，調用任何合約函數前首先使用 [unlockAccount()]

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

然后你就可以使用 sendTransaction() 函數來執行智能合約調用了。

// 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
//運行結果
{
“result”:{“txhash”:”b55358c2e12c1d48d4e6beaee7002a59138294fb2896ea8059ff5277553af59f”,”contract_address”:””}
}