package core
|
|
|
|
import (
|
|
cm "github.com/tendermint/tendermint/consensus"
|
|
ctypes "github.com/tendermint/tendermint/rpc/core/types"
|
|
sm "github.com/tendermint/tendermint/state"
|
|
"github.com/tendermint/tendermint/types"
|
|
)
|
|
|
|
// Get the validator set at the given block height.
|
|
// If no height is provided, it will fetch the current validator set.
|
|
//
|
|
// ```shell
|
|
// curl 'localhost:26657/validators'
|
|
// ```
|
|
//
|
|
// ```go
|
|
// client := client.NewHTTP("tcp://0.0.0.0:26657", "/websocket")
|
|
// err := client.Start()
|
|
// if err != nil {
|
|
// // handle error
|
|
// }
|
|
// defer client.Stop()
|
|
// state, err := client.Validators()
|
|
// ```
|
|
//
|
|
// The above command returns JSON structured like this:
|
|
//
|
|
// ```json
|
|
// {
|
|
// "error": "",
|
|
// "result": {
|
|
// "validators": [
|
|
// {
|
|
// "proposer_priority": "0",
|
|
// "voting_power": "10",
|
|
// "pub_key": {
|
|
// "data": "68DFDA7E50F82946E7E8546BED37944A422CD1B831E70DF66BA3B8430593944D",
|
|
// "type": "ed25519"
|
|
// },
|
|
// "address": "E89A51D60F68385E09E716D353373B11F8FACD62"
|
|
// }
|
|
// ],
|
|
// "block_height": "5241"
|
|
// },
|
|
// "id": "",
|
|
// "jsonrpc": "2.0"
|
|
// }
|
|
// ```
|
|
func Validators(heightPtr *int64) (*ctypes.ResultValidators, error) {
|
|
// The latest validator that we know is the
|
|
// NextValidator of the last block.
|
|
height := consensusState.GetState().LastBlockHeight + 1
|
|
height, err := getHeight(height, heightPtr)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
validators, err := sm.LoadValidators(stateDB, height)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return &ctypes.ResultValidators{
|
|
BlockHeight: height,
|
|
Validators: validators.Validators}, nil
|
|
}
|
|
|
|
// DumpConsensusState dumps consensus state.
|
|
// UNSTABLE
|
|
//
|
|
// ```shell
|
|
// curl 'localhost:26657/dump_consensus_state'
|
|
// ```
|
|
//
|
|
// ```go
|
|
// client := client.NewHTTP("tcp://0.0.0.0:26657", "/websocket")
|
|
// err := client.Start()
|
|
// if err != nil {
|
|
// // handle error
|
|
// }
|
|
// defer client.Stop()
|
|
// state, err := client.DumpConsensusState()
|
|
// ```
|
|
//
|
|
// The above command returns JSON structured like this:
|
|
//
|
|
// ```json
|
|
// {
|
|
// "jsonrpc": "2.0",
|
|
// "id": "",
|
|
// "result": {
|
|
// "round_state": {
|
|
// "height": "7185",
|
|
// "round": "0",
|
|
// "step": "1",
|
|
// "start_time": "2018-05-12T13:57:28.440293621-07:00",
|
|
// "commit_time": "2018-05-12T13:57:27.440293621-07:00",
|
|
// "validators": {
|
|
// "validators": [
|
|
// {
|
|
// "address": "B5B3D40BE53982AD294EF99FF5A34C0C3E5A3244",
|
|
// "pub_key": {
|
|
// "type": "tendermint/PubKeyEd25519",
|
|
// "value": "SBctdhRBcXtBgdI/8a/alTsUhGXqGs9k5ylV1u5iKHg="
|
|
// },
|
|
// "voting_power": "10",
|
|
// "proposer_priority": "0"
|
|
// }
|
|
// ],
|
|
// "proposer": {
|
|
// "address": "B5B3D40BE53982AD294EF99FF5A34C0C3E5A3244",
|
|
// "pub_key": {
|
|
// "type": "tendermint/PubKeyEd25519",
|
|
// "value": "SBctdhRBcXtBgdI/8a/alTsUhGXqGs9k5ylV1u5iKHg="
|
|
// },
|
|
// "voting_power": "10",
|
|
// "proposer_priority": "0"
|
|
// }
|
|
// },
|
|
// "proposal": null,
|
|
// "proposal_block": null,
|
|
// "proposal_block_parts": null,
|
|
// "locked_round": "0",
|
|
// "locked_block": null,
|
|
// "locked_block_parts": null,
|
|
// "valid_round": "0",
|
|
// "valid_block": null,
|
|
// "valid_block_parts": null,
|
|
// "votes": [
|
|
// {
|
|
// "round": "0",
|
|
// "prevotes": "_",
|
|
// "precommits": "_"
|
|
// }
|
|
// ],
|
|
// "commit_round": "-1",
|
|
// "last_commit": {
|
|
// "votes": [
|
|
// "Vote{0:B5B3D40BE539 7184/00/2(Precommit) 14F946FA7EF0 /702B1B1A602A.../ @ 2018-05-12T20:57:27.342Z}"
|
|
// ],
|
|
// "votes_bit_array": "x",
|
|
// "peer_maj_23s": {}
|
|
// },
|
|
// "last_validators": {
|
|
// "validators": [
|
|
// {
|
|
// "address": "B5B3D40BE53982AD294EF99FF5A34C0C3E5A3244",
|
|
// "pub_key": {
|
|
// "type": "tendermint/PubKeyEd25519",
|
|
// "value": "SBctdhRBcXtBgdI/8a/alTsUhGXqGs9k5ylV1u5iKHg="
|
|
// },
|
|
// "voting_power": "10",
|
|
// "proposer_priority": "0"
|
|
// }
|
|
// ],
|
|
// "proposer": {
|
|
// "address": "B5B3D40BE53982AD294EF99FF5A34C0C3E5A3244",
|
|
// "pub_key": {
|
|
// "type": "tendermint/PubKeyEd25519",
|
|
// "value": "SBctdhRBcXtBgdI/8a/alTsUhGXqGs9k5ylV1u5iKHg="
|
|
// },
|
|
// "voting_power": "10",
|
|
// "proposer_priority": "0"
|
|
// }
|
|
// }
|
|
// },
|
|
// "peers": [
|
|
// {
|
|
// "node_address": "30ad1854af22506383c3f0e57fb3c7f90984c5e8@172.16.63.221:26656",
|
|
// "peer_state": {
|
|
// "round_state": {
|
|
// "height": "7185",
|
|
// "round": "0",
|
|
// "step": "1",
|
|
// "start_time": "2018-05-12T13:57:27.438039872-07:00",
|
|
// "proposal": false,
|
|
// "proposal_block_parts_header": {
|
|
// "total": "0",
|
|
// "hash": ""
|
|
// },
|
|
// "proposal_block_parts": null,
|
|
// "proposal_pol_round": "-1",
|
|
// "proposal_pol": "_",
|
|
// "prevotes": "_",
|
|
// "precommits": "_",
|
|
// "last_commit_round": "0",
|
|
// "last_commit": "x",
|
|
// "catchup_commit_round": "-1",
|
|
// "catchup_commit": "_"
|
|
// },
|
|
// "stats": {
|
|
// "last_vote_height": "7184",
|
|
// "votes": "255",
|
|
// "last_block_part_height": "7184",
|
|
// "block_parts": "255"
|
|
// }
|
|
// }
|
|
// }
|
|
// ]
|
|
// }
|
|
// }
|
|
// ```
|
|
func DumpConsensusState() (*ctypes.ResultDumpConsensusState, error) {
|
|
// Get Peer consensus states.
|
|
peers := p2pPeers.Peers().List()
|
|
peerStates := make([]ctypes.PeerStateInfo, len(peers))
|
|
for i, peer := range peers {
|
|
peerState, ok := peer.Get(types.PeerStateKey).(*cm.PeerState)
|
|
if !ok { // peer does not have a state yet
|
|
continue
|
|
}
|
|
peerStateJSON, err := peerState.ToJSON()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
peerStates[i] = ctypes.PeerStateInfo{
|
|
// Peer basic info.
|
|
NodeAddress: peer.NodeInfo().NetAddress().String(),
|
|
// Peer consensus state.
|
|
PeerState: peerStateJSON,
|
|
}
|
|
}
|
|
// Get self round state.
|
|
roundState, err := consensusState.GetRoundStateJSON()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return &ctypes.ResultDumpConsensusState{
|
|
RoundState: roundState,
|
|
Peers: peerStates}, nil
|
|
}
|
|
|
|
// ConsensusState returns a concise summary of the consensus state.
|
|
// UNSTABLE
|
|
//
|
|
// ```shell
|
|
// curl 'localhost:26657/consensus_state'
|
|
// ```
|
|
//
|
|
// ```go
|
|
// client := client.NewHTTP("tcp://0.0.0.0:26657", "/websocket")
|
|
// err := client.Start()
|
|
// if err != nil {
|
|
// // handle error
|
|
// }
|
|
// defer client.Stop()
|
|
// state, err := client.ConsensusState()
|
|
// ```
|
|
//
|
|
// The above command returns JSON structured like this:
|
|
//
|
|
// ```json
|
|
//{
|
|
// "jsonrpc": "2.0",
|
|
// "id": "",
|
|
// "result": {
|
|
// "round_state": {
|
|
// "height/round/step": "9336/0/1",
|
|
// "start_time": "2018-05-14T10:25:45.72595357-04:00",
|
|
// "proposal_block_hash": "",
|
|
// "locked_block_hash": "",
|
|
// "valid_block_hash": "",
|
|
// "height_vote_set": [
|
|
// {
|
|
// "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"
|
|
// }
|
|
// ]
|
|
// }
|
|
// }
|
|
//}
|
|
//```
|
|
func ConsensusState() (*ctypes.ResultConsensusState, error) {
|
|
// Get self round state.
|
|
bz, err := consensusState.GetRoundStateSimpleJSON()
|
|
return &ctypes.ResultConsensusState{RoundState: bz}, err
|
|
}
|
|
|
|
// Get the consensus parameters at the given block height.
|
|
// If no height is provided, it will fetch the current consensus params.
|
|
//
|
|
// ```shell
|
|
// curl 'localhost:26657/consensus_params'
|
|
// ```
|
|
//
|
|
// ```go
|
|
// client := client.NewHTTP("tcp://0.0.0.0:26657", "/websocket")
|
|
// err := client.Start()
|
|
// if err != nil {
|
|
// // handle error
|
|
// }
|
|
// defer client.Stop()
|
|
// state, err := client.ConsensusParams()
|
|
// ```
|
|
//
|
|
// The above command returns JSON structured like this:
|
|
//
|
|
// ```json
|
|
// {
|
|
// "jsonrpc": "2.0",
|
|
// "id": "",
|
|
// "result": {
|
|
// "block_height": "1",
|
|
// "consensus_params": {
|
|
// "block_size_params": {
|
|
// "max_txs_bytes": "22020096",
|
|
// "max_gas": "-1"
|
|
// },
|
|
// "evidence_params": {
|
|
// "max_age": "100000"
|
|
// }
|
|
// }
|
|
// }
|
|
// }
|
|
// ```
|
|
func ConsensusParams(heightPtr *int64) (*ctypes.ResultConsensusParams, error) {
|
|
height := consensusState.GetState().LastBlockHeight + 1
|
|
height, err := getHeight(height, heightPtr)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
consensusparams, err := sm.LoadConsensusParams(stateDB, height)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return &ctypes.ResultConsensusParams{
|
|
BlockHeight: height,
|
|
ConsensusParams: consensusparams}, nil
|
|
}
|