BlockchainInfo - 查询区块链
BlockchainInfo
返回高度在minHeight和maxHeight之间的区块头,
结果降序排列,高位区块在前,低位区块在后。
API请求
GET /blockchain
查询参数:
- minHeight:起始区块高度
- maxHeight:截止区块高度
API响应
返回JSON对象,结构如下:
- jsonrpc:JSONRPC版本,固定为"2.0"
- id:API请求的ID编号
- error:错误描述信息
- result:应用信息结果
- block_metas:区块元数据数组,每个成员结构如下:
- header:区块头
- block_id:区块ID
- block_metas:区块元数据数组,每个成员结构如下:
示例代码
使用curl调用BlockchainInfo接口,查询高度为10的区块数据:
~$ curl 'localhost:26657/blockchain?minHeight=10&maxHeight=10'
响应结果:
{
"error": "",
"result": {
"block_metas": [
{
"header": {
"app_hash": "",
"chain_id": "test-chain-6UTNIN",
"height": "10",
"time": "2017-05-29T15:05:53.877Z",
"num_txs": "0",
"last_block_id": {
"parts": {
"hash": "3C78F00658E06744A88F24FF97A0A5011139F34A",
"total": "1"
},
"hash": "F70588DAB36BDA5A953D548A16F7D48C6C2DFD78"
},
"last_commit_hash": "F31CC4282E50B3F2A58D763D233D76F26D26CABE",
"data_hash": "",
"validators_hash": "9365FC80F234C967BD233F5A3E2AB2F1E4B0E5AA"
},
"block_id": {
"parts": {
"hash": "277A4DBEF91483A18B85F2F5677ABF9694DFA40F",
"total": "1"
},
"hash": "96B1D2F2D201BA4BC383EB8224139DB1294944E5"
}
}
],
"last_height": "5493"
},
"id": "",
"jsonrpc": "2.0"
}