基于星云链的智能合约与Dapp（十）——内置库调用

BigNumber

BigNumber 模块构建于 bignumber.js之上，用来处理任意精度的十进制和非十进制运算。合约可以直接使用 BigNumber 来处理交易和其他转账操作中涉及到的数值计算。

x = new BigNumber(123.4567)
y = BigNumber('123456.7e-3')
z = new BigNumber(x)
x.isEqualTo(y) && y.isEqualTo(z) && x.isEqualTo(z)      // true

a = new BigNumber(1011, 2)          // "11"
b = new BigNumber('zz.9', 36)       // "1295.25"
c = x.plus(y)                       // "1306.25"

new BigNumber(Number.MAX_VALUE.toString(2), 2)

// Precision loss from using numeric literals with more than 15 significant digits.   
new BigNumber(1.0000000000000001);                 // '1'
new BigNumber(88259496234518.57);                  // '88259496234518.56'
new BigNumber(99999999999999999999);               // '100000000000000000000'

// Precision loss from using numeric literals outside the range of Number values.
new BigNumber(2e+308);                             // 'Infinity'
new BigNumber(1e-324);                             // '0'

// Precision loss from the unexpected result of arithmetic with Number values.
new BigNumber(0.7 + 0.1);                          // '0.7999999999999999' 

Storage

storage 模块用来支持Nebulas上的数据持久化存储。功能上类似于传统的键值存储系统，当然存储需要消耗一定的 GAS。LocalContractStorage 是可以直接在合约中使用的内置storage对象，可存储的数据类型包括数字、字符串和 JavaScript 对象（需要序列化为字符串）。链上数据只能被存储它们的合约访问和修改。具体内容参见：基于星云链的智能合约与Dapp（五）——智能合约存储区

Blockchain

Blockchain 模块用来获取当前正在执行的合约内的交易和区块信息。另外，还提供了若干有用的方法，如从合约账户中转出 NAS，进行地址格式验证等。

Blockchain 有两个属性：

1.block 执行合约的当前区块，它具有下列属性：

• timestamp 区块时间戳
• height 区块高度

2.transaction 执行合约的当前交易，它具有下列属性：

• hash 交易哈希值
• from 交易源地址
• to 交易目的地址，对于合约调用就是合约地址
• value 交易数值，字符串， 合约内用BigNumber存储计算
• nonce 交易的 nonce 值
• timestamp 交易时间戳
• gasPrice 交易的 gasPrice，字符串，合约内用 BigNumber 存储计算
• gasLimit 交易的 gasLimit，字符串，合约内用 BigNumber 存储计算

Blockchain 还提供了两个方法：

1.transfer(address, value) 将 NAS 从合约转出到address对应的账户。

• 参数 address：接收 NAS 的 Nebulas 账户地址
• 参数 value：转移数值，一个 BigNumber 对象
  返回：0 – 转移成功，1 – 转移失败

2.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: 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)

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: function () {
        // 实际被存储的topic是“chain.contract.topic”
        Event.Trigger("topic",
            {
                Data: {
                    value: "Event test."
                }
            }
        );
    }
};
module.exports = BankVaultContract;

控制台(Console)

console 模块提供了一个简单的调试控制台，类似JavaScript 控制台。console 将所有接收到的args以指定级别打印到 Nebulas Logger 上。

• console.log([…args]) — — info 级别
• console.debug([…args]) — — debug 级别
• console.warn([…args]) — — warn 级别
• console.error([…args]) — — error 级别
• console.info([…args]) — — 与console.log()类似