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 }