Block - 获取指定区块数据
block接口用来获取指定高度的区块。如果未指定区块高度,该调用将返回最新区块。
API请求
GET /block
查询参数:
-height:要查询的区块的高度,int64,可选,默认值:0,表示最新区块
API响应
返回JSON对象,结构如下:
jsonrpc:JSONRPC版本,固定为"2.0"
id:API请求的ID编号
error:错误描述信息
result:应用信息结果block:区块对象,结构如下:last_commits:最近提交对象,结果如下:precommits:预提交数组
blockID:区块ID
data:区块数据对象,结构如下:txs:交易数组
header:区块头对象,结构如下:app_hash:应用哈希
chain_id:链ID
height:区块高度
time:时间戳
num_txs:交易数量
last_block_id:前区块ID
last_commit_hash:最近提交哈希
data_hash:数据哈希
validators_hash:验证节点哈希
block_meta:区块元数据对象,结构如下:header:头对象
block_id:区块ID
示例代码
使用curl调用Block接口,获取高度为10的区块数据:
~$ curl 'localhost:26657/block?height=10'
响应结果:
{
"error": "",
"result": {
"block": {
"last_commit": {
"precommits": [
{
"signature": {
"data": "12C0D8893B8A38224488DC1DE6270DF76BB1A5E9DB1C68577706A6A97C6EC34FFD12339183D5CA8BC2F46148773823DE905B7F6F5862FD564038BB7AE03BF50D",
"type": "ed25519"
},
"block_id": {
"parts": {
"hash": "3C78F00658E06744A88F24FF97A0A5011139F34A",
"total": "1"
},
"hash": "F70588DAB36BDA5A953D548A16F7D48C6C2DFD78"
},
"type": "2",
"round": "0",
"height": "9",
"validator_index": "0",
"validator_address": "E89A51D60F68385E09E716D353373B11F8FACD62"
}
],
"blockID": {
"parts": {
"hash": "3C78F00658E06744A88F24FF97A0A5011139F34A",
"total": "1"
},
"hash": "F70588DAB36BDA5A953D548A16F7D48C6C2DFD78"
}
},
"data": {
"txs": []
},
"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_meta": {
"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"
}
}
},
"id": "",
"jsonrpc": "2.0"
}