2 JSON-RPC API
2.5 账本接口
2.5.1 获取当前已验证区块
请求:
{
"method": "ledger",
"params": [
{
"ledger_index": "validated",
"accounts": false,
"full": false,
"transactions": false,
"expand": false,
"owner_funds": false
}
]
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| ledger_hash | string | 账本哈希 |
| ledger_index | unsignedint，object | 账本高度 |
| full | bool | （可选）如果true，返回整个分类帐的完整信息。如果未指定分类帐版本，则忽略。默认为false。（相当于启用transactions，accounts和expand。）警告：这是一个非常大量的数据 - 大约几百兆！ |
| accounts | bool | （可选）如果true，返回分类帐中账号的信息。如果未指定分类帐版本，则忽略。默认为false。警告：这会返回大量数据！ |
| transactions | bool | （可选）如果true，返回指定分类帐版本中的交易信息。默认为false。如果未指定分类帐版本，则忽略 |
| expand | bool | （可选）为交易/账号信息提供完整的JSON格式信息，而不是仅提供哈希值。默认为false。除非您请求交易，账号或两者，否则忽略 |
| owner_funds | bool | （可选）如果true，owner_funds在响应中包含OfferCreate交易的元数据中的字段。默认为false。除非包含交易并且expand为true，否则忽略 |
| binary | bool | （可选）如果true，以二进制格式（十六进制字符串）而不是JSON格式返回交易信息 |
| queue | bool | （可选）如果true，则在结果中包含一系列排队交易 |
响应结果:
{
"result": {
"ledger": {
"accepted": true,
"account_hash": "83219E37D5919FEBA7DF54D86535433CF672AECD3102189E7BD0C1AC9837ABD2",
"close_flags": 0,
"close_time": 619177700,
"close_time_human": "2019-Aug-15 09:48:20",
"close_time_resolution": 10,
"closed": true,
"fee_pool": "0",
"hash": "8C538A91E18C73B206FD83883813C11662B6528A721D09EB66101B5AD96B35DF",
"ledger_hash": "8C538A91E18C73B206FD83883813C11662B6528A721D09EB66101B5AD96B35DF",
"ledger_index": "467939",
"parent_close_time": 619177690,
"parent_hash": "33357F22A540960BF59005C953E811AFC8FED5A842EB63D4CCDC9D1051ECB68E",
"seqNum": "467939",
"totalCoins": "100000000000000000",
"total_coins": "100000000000000000",
"transaction_hash": "0000000000000000000000000000000000000000000000000000000000000000"
},
"ledger_hash": "8C538A91E18C73B206FD83883813C11662B6528A721D09EB66101B5AD96B35DF",
"ledger_index": 467939,
"status": "success",
"validated": true
}
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| ledger | object | 支付执行结果标题 |
| ledger.account_hash | string | 此分类帐中所有账号状态信息的十六进制哈希值 |
| ledger.accountState | array | （除非已请求，否则将被忽略）此分类帐中的所有账号状态信息 |
| ledger.close_flags | int | 与关闭此分类帐相关的标志位 |
| ledger.close_time | int | 此分类账关闭的时间 |
| ledger.close_time_human | string | 此分类账以人类可读的格式关闭的时间 |
| ledger.close_time_resolution | int | 帳本关闭时间在这么多秒内四舍五入 |
| ledger.closed | bool | 此分类账是否已经关闭 |
| ledger.ledger_hash | string | 整个分类帐的唯一标识哈希 |
| ledger.ledger_index | string | 此分类帐的分类帐索引，作为带引号的整数 |
| ledger.parent_close_time | int | 前一个分类帐关闭的时间 |
| ledger.parent_hash | string | 紧接在此之前的分类帐的唯一标识哈希 |
| ledger.total_coins | string | 网络中HWT的总数，作为带引号的整数 |
| ledger.transaction_hash | string | 此分类帐中包含的交易信息的十六进制哈希值 |
| ledger_hash | string | 整个分类帐的唯一标识哈希 |
| ledger_index | number | 此分类帐的分类帐索引 |