Tendermint RPC API文档

在线工具推荐: Three.js AI纹理开发包 - YOLO合成数据生成器 - GLTF/GLB在线编辑 - 3D模型格式在线转换 - 可编程3D场景编辑器

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

示例代码

使用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"
}