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<any>]) — — info 级别
- console.debug([…args<any>]) — — debug 级别
- console.warn([…args<any>]) — — warn 级别
- console.error([…args<any>]) — — error 级别
- console.info([…args<any>]) — — 与console.log()类似
