tendermint提供的RPC接口(二)

tendermint RPC

接上篇:tendermint提供的RPC接口(一)

 

四,Info

/health

说明:获取节点心跳,返回空为正常

示例:

C:\Users\ch>curl -s localhost:26657/health
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {}
}

 

/status

说明:获取节点信息

包括节点信息,公钥,最新区块hash,区块高度等等

示例:

C:\Users\ch>curl -s localhost:26657/status
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "node_info": {
      "protocol_version": {
        "p2p": "7",
        "block": "10",
        "app": "1"
      },
      "id": "fe807a7617494c46d38bc040801ab567cc330852",
      "listen_addr": "tcp://0.0.0.0:26656",
      "network": "test-chain-17UaI5",
      "version": "0.32.1",
      "channels": "4020212223303800",
      "moniker": "caohuan",
      "other": {
        "tx_index": "on",
        "rpc_address": "tcp://127.0.0.1:26657"
      }
    },
    "sync_info": {
      "latest_block_hash": "2211B8262B6246EF236DBBB641E056E5A664F0FF821428C8E4B8FBDB231DBA63",
      "latest_app_hash": "1400000000000000",
      "latest_block_height": "13",
      "latest_block_time": "2019-09-09T07:38:35.0507361Z",
      "catching_up": false
    },
    "validator_info": {
      "address": "214F0751415B6EEF19E4D81D9422B3C8EC5F3607",
      "pub_key": {
        "type": "tendermint/PubKeyEd25519",
        "value": "GDTnQdrcRX0wwZ13cudz3yHNuk0UHp9MbXwVnyDzKRY="
      },
      "voting_power": "10"
    }
  }
}

 

/net_info

说明:获取网络信息

示例:

C:\Users\ch>curl -s localhost:26657/net_info
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "listening": true,
    "listeners": [
      "Listener(@)"
    ],
    "n_peers": "0",
    "peers": []
  }
}

 

/blockchain

说明:获取区块信息

传入开始区块(minHeight)和截止区块(maxHeight)两个参数

示例:

C:\Users\ch>curl -s "localhost:26657/blockchain?minHeight=4&maxHeight=5"
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "last_height": "13",
    "block_metas": [
      {
        "block_id": {
          "hash": "6EF5FDE1482DD6CE24647DF998A8B5E7E7609307B2534309B10CA035BE7D7171",
          "parts": {
            "total": "1",
            "hash": "FF04D0225B8A0B43A019AC0C136C1D71A08B683ADD47FD0B324C93BC86A4D3A8"
          }
        },
        "header": {
          "version": {
            "block": "10",
            "app": "1"
          },
          "chain_id": "test-chain-17UaI5",
          "height": "5",
          "time": "2019-09-09T07:38:27.0507361Z",
          "num_txs": "1",
          "total_txs": "3",
          "last_block_id": {
            "hash": "61D7CDDE0B3280661BF2736A29AD7C38EC4860A4F080D4D840B11D3B9E2C1781",
            "parts": {
              "total": "1",
              "hash": "D0657ECD49F0946326A4E26977C4FC8E4606FD805315F5CEB666F45688C6B170"
            }
          },
          "last_commit_hash": "8136B24934FAF6DC6B94AC8E210AA18E09DEB35B9984B72EFB4674546838A449",
          "data_hash": "9ECB7139BD0145C32047E358F4D2EA9B6CEA94DBD6B429427CB70BC93115BA9F",
          "validators_hash": "B5A29881AA2292F54E7AD9487F194670110FBE6D0F154CEE5E72A94048184312",
          "next_validators_hash": "B5A29881AA2292F54E7AD9487F194670110FBE6D0F154CEE5E72A94048184312",
          "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F",
          "app_hash": "0400000000000000",
          "last_results_hash": "6E340B9CFFB37A989CA544E6BB780A2C78901D3FB33738768511A30617AFA01D",
          "evidence_hash": "",
          "proposer_address": "214F0751415B6EEF19E4D81D9422B3C8EC5F3607"
        }
      },
      {
        "block_id": {
          "hash": "61D7CDDE0B3280661BF2736A29AD7C38EC4860A4F080D4D840B11D3B9E2C1781",
          "parts": {
            "total": "1",
            "hash": "D0657ECD49F0946326A4E26977C4FC8E4606FD805315F5CEB666F45688C6B170"
          }
        },
        "header": {
          "version": {
            "block": "10",
            "app": "1"
          },
          "chain_id": "test-chain-17UaI5",
          "height": "4",
          "time": "2019-09-09T07:38:26.0507361Z",
          "num_txs": "1",
          "total_txs": "2",
          "last_block_id": {
            "hash": "97E69293BDE1207223E1A4AE41E078BACCB0615630B66DD93F32EC6CA4BE1F9F",
            "parts": {
              "total": "1",
              "hash": "48EC83BBD54C6BA29BCF4B09FDF265C324F0F9E949233320D37A223AB0E22096"
            }
          },
          "last_commit_hash": "4297ED68980EA06477F95024EE172D8F663E7350BF24A98C5CDD059FD03BF136",
          "data_hash": "94566C8B476C6BD469632EB5E95F756EE21516A2C8ABA09710C7860529F0B19F",
          "validators_hash": "B5A29881AA2292F54E7AD9487F194670110FBE6D0F154CEE5E72A94048184312",
          "next_validators_hash": "B5A29881AA2292F54E7AD9487F194670110FBE6D0F154CEE5E72A94048184312",
          "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F",
          "app_hash": "0200000000000000",
          "last_results_hash": "6E340B9CFFB37A989CA544E6BB780A2C78901D3FB33738768511A30617AFA01D",
          "evidence_hash": "",
          "proposer_address": "214F0751415B6EEF19E4D81D9422B3C8EC5F3607"
        }
      }
    ]
  }
}

 

/block

说明:获取某个具体的区块信息

参数height表示区块高度,不传或者传0时,默认为最新的区块高度

示例:

C:\Users\ch>curl -s "localhost:26657/block?height=10"
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "block_meta": {
      "block_id": {
        "hash": "31FB364FFDC92C8EC5F63FE54E430D2996A31D3A3DBA416B3D17E13A76C5A300",
        "parts": {
          "total": "1",
          "hash": "897CB6F0FEC7DCCFB1BD84933CBACA2064FEB8659925E7252F3AD8054BA1C655"
        }
      },
      "header": {
        "version": {
          "block": "10",
          "app": "1"
        },
        "chain_id": "test-chain-17UaI5",
        "height": "10",
        "time": "2019-09-09T07:38:32.0507361Z",
        "num_txs": "1",
        "total_txs": "8",
        "last_block_id": {
          "hash": "C781443961064AB326D14105C0B4AA31F80772EE9824D8962AF92993557A4AE4",
          "parts": {
            "total": "1",
            "hash": "CE457673AAFC5332A11C9DA2E3CD98652F85D1983C23E3016C9704DD004E4188"
          }
        },
        "last_commit_hash": "326DB19B9B3D90464C31EF70BF8CC892944C719DF2CC586944A047DD76D0C7E0",
        "data_hash": "9EE9AE5B6BE62129743563FB35B1BC7FB28E1217D551B5F3BC087F811A44F7C5",
        "validators_hash": "B5A29881AA2292F54E7AD9487F194670110FBE6D0F154CEE5E72A94048184312",
        "next_validators_hash": "B5A29881AA2292F54E7AD9487F194670110FBE6D0F154CEE5E72A94048184312",
        "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F",
        "app_hash": "0E00000000000000",
        "last_results_hash": "6E340B9CFFB37A989CA544E6BB780A2C78901D3FB33738768511A30617AFA01D",
        "evidence_hash": "",
        "proposer_address": "214F0751415B6EEF19E4D81D9422B3C8EC5F3607"
      }
    },
    "block": {
      "header": {
        "version": {
          "block": "10",
          "app": "1"
        },
        "chain_id": "test-chain-17UaI5",
        "height": "10",
        "time": "2019-09-09T07:38:32.0507361Z",
        "num_txs": "1",
        "total_txs": "8",
        "last_block_id": {
          "hash": "C781443961064AB326D14105C0B4AA31F80772EE9824D8962AF92993557A4AE4",
          "parts": {
            "total": "1",
            "hash": "CE457673AAFC5332A11C9DA2E3CD98652F85D1983C23E3016C9704DD004E4188"
          }
        },
        "last_commit_hash": "326DB19B9B3D90464C31EF70BF8CC892944C719DF2CC586944A047DD76D0C7E0",
        "data_hash": "9EE9AE5B6BE62129743563FB35B1BC7FB28E1217D551B5F3BC087F811A44F7C5",
        "validators_hash": "B5A29881AA2292F54E7AD9487F194670110FBE6D0F154CEE5E72A94048184312",
        "next_validators_hash": "B5A29881AA2292F54E7AD9487F194670110FBE6D0F154CEE5E72A94048184312",
        "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F",
        "app_hash": "0E00000000000000",
        "last_results_hash": "6E340B9CFFB37A989CA544E6BB780A2C78901D3FB33738768511A30617AFA01D",
        "evidence_hash": "",
        "proposer_address": "214F0751415B6EEF19E4D81D9422B3C8EC5F3607"
      },
      "data": {
        "txs": [
          "YXV0aG9yNz1jYW9odWFuNw=="
        ]
      },
      "evidence": {
        "evidence": null
      },
      "last_commit": {
        "block_id": {
          "hash": "C781443961064AB326D14105C0B4AA31F80772EE9824D8962AF92993557A4AE4",
          "parts": {
            "total": "1",
            "hash": "CE457673AAFC5332A11C9DA2E3CD98652F85D1983C23E3016C9704DD004E4188"
          }
        },
        "precommits": [
          {
            "type": 2,
            "height": "9",
            "round": "0",
            "block_id": {
              "hash": "C781443961064AB326D14105C0B4AA31F80772EE9824D8962AF92993557A4AE4",
              "parts": {
                "total": "1",
                "hash": "CE457673AAFC5332A11C9DA2E3CD98652F85D1983C23E3016C9704DD004E4188"
              }
            },
            "timestamp": "2019-09-09T07:38:32.0507361Z",
            "validator_address": "214F0751415B6EEF19E4D81D9422B3C8EC5F3607",
            "validator_index": "0",
            "signature": "caEDGKx6Nqr7Deg9u85aqcWMq+eIUyX6jTAA/y6bgJv6jkN2fWnLvKYOFRajdcsBqr2BwYpkyDLDMZcsmKmIAg=="
          }
        ]
      }
    }
  }
}

 

/block_results

说明:仅获取区块交易信息

参数height表示区块高度,不传或者传0时,默认为最新的区块高度

示例:

 


/commit

说明:获取指定高度的提交结果

参数height表示区块高度,不传或者传0时,默认为最新的区块高度

示例:

 


/validators

说明:获取在指定高度的validators

参数height表示区块高度,不传或者传0时,默认为最新的区块高度

示例:

C:\Users\ch>curl -s "localhost:26657/validators?height=10"
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "block_height": "10",
    "validators": [
      {
        "address": "214F0751415B6EEF19E4D81D9422B3C8EC5F3607",
        "pub_key": {
          "type": "tendermint/PubKeyEd25519",
          "value": "GDTnQdrcRX0wwZ13cudz3yHNuk0UHp9MbXwVnyDzKRY="
        },
        "voting_power": "10",
        "proposer_priority": "0"
      }
    ]
  }
}

 

/genesis

说明:获取创世参数

示例:

C:\Users\ch>curl -s "localhost:26657/genesis"
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "genesis": {
      "genesis_time": "2019-08-03T09:11:17.0099169Z",
      "chain_id": "test-chain-17UaI5",
      "consensus_params": {
        "block": {
          "max_bytes": "22020096",
          "max_gas": "-1",
          "time_iota_ms": "1000"
        },
        "evidence": {
          "max_age": "100000"
        },
        "validator": {
          "pub_key_types": [
            "ed25519"
          ]
        }
      },
      "validators": [
        {
          "address": "214F0751415B6EEF19E4D81D9422B3C8EC5F3607",
          "pub_key": {
            "type": "tendermint/PubKeyEd25519",
            "value": "GDTnQdrcRX0wwZ13cudz3yHNuk0UHp9MbXwVnyDzKRY="
          },
          "power": "10",
          "name": ""
        }
      ],
      "app_hash": ""
    }
  }
}

 

/dump_consensus_state

说明:获取共识状态

示例:

C:\Users\ch>curl -s "localhost:26657/dump_consensus_state"
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "round_state": {
      "height": "14",
      "round": "0",
      "step": 2,
      "start_time": "2019-09-09T07:38:28.4411925Z",
      "commit_time": "2019-09-09T07:38:27.4411925Z",
      "validators": {
        "validators": [
          {
            "address": "214F0751415B6EEF19E4D81D9422B3C8EC5F3607",
            "pub_key": {
              "type": "tendermint/PubKeyEd25519",
              "value": "GDTnQdrcRX0wwZ13cudz3yHNuk0UHp9MbXwVnyDzKRY="
            },
            "voting_power": "10",
            "proposer_priority": "0"
          }
        ],
        "proposer": {
          "address": "214F0751415B6EEF19E4D81D9422B3C8EC5F3607",
          "pub_key": {
            "type": "tendermint/PubKeyEd25519",
            "value": "GDTnQdrcRX0wwZ13cudz3yHNuk0UHp9MbXwVnyDzKRY="
          },
          "voting_power": "10",
          "proposer_priority": "0"
        }
      },
      "proposal": null,
      "proposal_block": null,
      "proposal_block_parts": null,
      "locked_round": "-1",
      "locked_block": null,
      "locked_block_parts": null,
      "valid_round": "-1",
      "valid_block": null,
      "valid_block_parts": null,
      "votes": [
        {
          "round": "0",
          "prevotes": [
            "nil-Vote"
          ],
          "prevotes_bit_array": "BA{1:_} 0/10 = 0.00",
          "precommits": [
            "nil-Vote"
          ],
          "precommits_bit_array": "BA{1:_} 0/10 = 0.00"
        },
        {
          "round": "1",
          "prevotes": [
            "nil-Vote"
          ],
          "prevotes_bit_array": "BA{1:_} 0/10 = 0.00",
          "precommits": [
            "nil-Vote"
          ],
          "precommits_bit_array": "BA{1:_} 0/10 = 0.00"
        }
      ],
      "commit_round": "-1",
      "last_commit": {
        "votes": [
          "Vote{0:214F0751415B 13/00/2(Precommit) 2211B8262B62 9BF9FF8FC46C @ 2019-09-09T07:38:36.0507361Z}"
        ],
        "votes_bit_array": "BA{1:x} 10/10 = 1.00",
        "peer_maj_23s": {}
      },
      "last_validators": {
        "validators": [
          {
            "address": "214F0751415B6EEF19E4D81D9422B3C8EC5F3607",
            "pub_key": {
              "type": "tendermint/PubKeyEd25519",
              "value": "GDTnQdrcRX0wwZ13cudz3yHNuk0UHp9MbXwVnyDzKRY="
            },
            "voting_power": "10",
            "proposer_priority": "0"
          }
        ],
        "proposer": {
          "address": "214F0751415B6EEF19E4D81D9422B3C8EC5F3607",
          "pub_key": {
            "type": "tendermint/PubKeyEd25519",
            "value": "GDTnQdrcRX0wwZ13cudz3yHNuk0UHp9MbXwVnyDzKRY="
          },
          "voting_power": "10",
          "proposer_priority": "0"
        }
      },
      "triggered_timeout_precommit": false
    },
    "peers": []
  }
}

 

/consensus_state

说明:获取共识状态

示例:

 


/consensus_params

说明:获取共识参数

参数height表示区块高度,不传或者传0时,默认为最新的区块高度

示例:

C:\Users\ch>curl -s "localhost:26657/consensus_params?height=10"
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "block_height": "14",
    "consensus_params": {
      "block": {
        "max_bytes": "22020096",
        "max_gas": "-1",
        "time_iota_ms": "1000"
      },
      "evidence": {
        "max_age": "100000"
      },
      "validator": {
        "pub_key_types": [
          "ed25519"
        ]
      }
    }
  }
}

 

​/unconfirmed_txs

说明:获取没有被确认的交易列表

参数limit限制返回最大数量

示例:

C:\Users\ch>curl -s "localhost:26657/unconfirmed_txs"
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "n_txs": "0",
    "total": "0",
    "total_bytes": "0",
    "txs": []
  }
}

 

/num_unconfirmed_txs

说明:获取没有被确认的交易条数

示例:

C:\Users\ch>curl -s "localhost:26657/num_unconfirmed_txs"
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "n_txs": "0",
    "total": "0",
    "total_bytes": "0",
    "txs": null
  }
}

 

/tx_search

说明:获取未确认的交易列表

参数:

query,查询条件,必填

prove,是否包含块中交易的证明,非必填,默认false

page,第几页,非必填,默认为1

per_page,每页多少数据,非必填,默认30

这个接口和/unconfirmed_txs相比,是可以分页的

示例:

 


/tx

说明:根据hash查询某笔交易

参数:

hash,交易hash,必填

prove,是否包含块中交易的证明,非必填,默认false

示例:

 


  • 发表于 2019-09-06 18:09
  • 阅读 ( 90 )
  • 分类:Tendermint

0 条评论

请先 登录 后评论
不写代码的码农
曹欢

区块链开发

1 篇文章

作家榜 »

  1. 社区运营-小以 623 文章
  2. 社区运营-小链 243 文章
  3. 涂晶 82 文章
  4. 于中阳Mercina-zy 79 文章
  5. 李晓琼 44 文章
  6. 兄弟连区块链培训 42 文章
  7. 吴寿鹤 38 文章
  8. John-smith 25 文章