获取某一账本具体信息
首先通过本方法返回一个Request对象,然后通过submit方法获得某一账本的具体信息。
方法:requestLedger({});
参数:
参数 | 类型 | 说明 |
---|---|---|
ledger_index | Number | 井通区块高度 |
ledger_hash | String | 井通区块hash(与上面ledger_index二选一,若两个都写,以本字段为准) |
transactions | Boolean | 是否返回账本上的交易记录hash,默认false |
注:整体参数是Object类型,当参数都不填时,默认返回最新账本信息。
返回:Request对象
例子:
var jlib = require('jingtum-lib');
var Remote = jlib.Remote;
var remote = new Remote({server: 'ws://xxx:port', local_sign:true});
remote.connect(function(err, result) {
if (err) {
return console.log('err:',err);
}
//var req = remote.requestLedger({});//将默认返回最新账本信息
var req = remote.requestLedger({
ledger_index: 3637979,
transactions: true
});
req.submit(function(err, result) {
if(err) {console.log('err:',err);}
else if(result){
console.log(result);
}
});
});
返回结果:
{
accepted: true,
account_hash: '81A32C91AB405F1761A98088A92F307D40A1F77DEF43DD25DFD2E619B3DF390E',
close_time: 615463820,
close_time_human: '2019-Jul-03 10:10:20',
close_time_resolution: 10,
closed: true,
hash: 'FBE16D38BE8B8FAAC139D8162183D6DA4D0BC88DCD267644ADC4A95679458CCB',
ledger_hash: 'FBE16D38BE8B8FAAC139D8162183D6DA4D0BC88DCD267644ADC4A95679458CCB',
ledger_index: '3637979',
parent_hash: 'B0EE6597B5F0AD98A13C83AE7F1EAF1AECE7CAD10E0586E7EED9B7230A00E46DD',
seqNum: '3637979',
totalCoins: '600000000000000000',
total_coins: '600000000000000000',
transaction_hash: '05B107D3F0041A23C0D758A39290ED01B3E4BD686B7B978BF78C9461A9117A26',
transactions:
[ 'C79B437A27DEF0761F98421190D4FFDB2F4F9947C7089E6E9AF04D9BF3FCD70A' ]
}
返回结果说明:
参数 | 类型 | 说明 |
---|---|---|
accepted | Boolean | 区块是否已经产生 |
account_hash | String | 状态hash树根 |
close_time | Integer | 关闭时间 |
close_time_human | String | 关闭时间 |
close_time_resolution | Integer | 关闭周期 |
closed | Boolean | 账本是否已经关闭 |
hash | String | 账本hash |
ledger_hash | String | 账本hash |
ledger_index | String | 账本高度/区块高度 |
parent_hash | String | 上一区块hash值 |
seqNum | String | 账本高度/区块高度 |
totalCoins | String | 基础币总量 |
total_coins | String | 基础币总量 |
transaction_hash | String | 交易hash树根 |
transactions | Array | 该账本里的交易列表 |