获取某一账本具体信息

首先通过本方法返回一个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 该账本里的交易列表