package core
|
|
|
|
import (
|
|
cm "github.com/tendermint/tendermint/consensus"
|
|
"github.com/tendermint/tendermint/p2p"
|
|
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:46657/validators'
|
|
// ```
|
|
//
|
|
// ```go
|
|
// client := client.NewHTTP("tcp://0.0.0.0:46657", "/websocket")
|
|
// state, err := client.Validators()
|
|
// ```
|
|
//
|
|
// The above command returns JSON structured like this:
|
|
//
|
|
// ```json
|
|
// {
|
|
// "error": "",
|
|
// "result": {
|
|
// "validators": [
|
|
// {
|
|
// "accum": 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) {
|
|
storeHeight := blockStore.Height()
|
|
height, err := getHeight(storeHeight, heightPtr)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
validators, err := sm.LoadValidators(stateDB, height)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return &ctypes.ResultValidators{height, validators.Validators}, nil
|
|
}
|
|
|
|
// DumpConsensusState dumps consensus state.
|
|
// UNSTABLE
|
|
//
|
|
// ```shell
|
|
// curl 'localhost:46657/dump_consensus_state'
|
|
// ```
|
|
//
|
|
// ```go
|
|
// client := client.NewHTTP("tcp://0.0.0.0:46657", "/websocket")
|
|
// 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": "AC26791624DE60",
|
|
// "value": "SBctdhRBcXtBgdI/8a/alTsUhGXqGs9k5ylV1u5iKHg="
|
|
// },
|
|
// "voting_power": 10,
|
|
// "accum": 0
|
|
// }
|
|
// ],
|
|
// "proposer": {
|
|
// "address": "B5B3D40BE53982AD294EF99FF5A34C0C3E5A3244",
|
|
// "pub_key": {
|
|
// "type": "AC26791624DE60",
|
|
// "value": "SBctdhRBcXtBgdI/8a/alTsUhGXqGs9k5ylV1u5iKHg="
|
|
// },
|
|
// "voting_power": 10,
|
|
// "accum": 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": "AC26791624DE60",
|
|
// "value": "SBctdhRBcXtBgdI/8a/alTsUhGXqGs9k5ylV1u5iKHg="
|
|
// },
|
|
// "voting_power": 10,
|
|
// "accum": 0
|
|
// }
|
|
// ],
|
|
// "proposer": {
|
|
// "address": "B5B3D40BE53982AD294EF99FF5A34C0C3E5A3244",
|
|
// "pub_key": {
|
|
// "type": "AC26791624DE60",
|
|
// "value": "SBctdhRBcXtBgdI/8a/alTsUhGXqGs9k5ylV1u5iKHg="
|
|
// },
|
|
// "voting_power": 10,
|
|
// "accum": 0
|
|
// }
|
|
// }
|
|
// },
|
|
// "peers": [
|
|
// {
|
|
// "node_address": "30ad1854af22506383c3f0e57fb3c7f90984c5e8@172.16.63.221:46656",
|
|
// "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 := p2pSwitch.Peers().List()
|
|
peerStates := make([]ctypes.PeerStateInfo, len(peers))
|
|
for i, peer := range peers {
|
|
peerState := peer.Get(types.PeerStateKey).(*cm.PeerState)
|
|
peerStateJSON, err := peerState.ToJSON()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
peerStates[i] = ctypes.PeerStateInfo{
|
|
// Peer basic info.
|
|
NodeAddress: p2p.IDAddressString(peer.ID(), peer.NodeInfo().ListenAddr),
|
|
// Peer consensus state.
|
|
PeerState: peerStateJSON,
|
|
}
|
|
}
|
|
// Get self round state.
|
|
roundState, err := consensusState.GetRoundStateJSON()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return &ctypes.ResultDumpConsensusState{roundState, peerStates}, nil
|
|
}
|
|
|
|
// ConsensusState returns a concise summary of the consensus state.
|
|
// UNSTABLE
|
|
//
|
|
// ```shell
|
|
// curl 'localhost:46657/consensus_state'
|
|
// ```
|
|
//
|
|
// ```go
|
|
// client := client.NewHTTP("tcp://0.0.0.0:46657", "/websocket")
|
|
// 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{bz}, err
|
|
}
|