package cosmos.gov.v1beta1

Get desktop application:
View/edit binary Protocol Buffers messages

Msg defines the bank Msg service.

• rpc SubmitProposal (MsgSubmitProposal, MsgSubmitProposalResponse)

  tx.proto:15

  SubmitProposal defines a method to create new proposal given a content.

  message MsgSubmitProposal

  tx.proto:31

  MsgSubmitProposal defines an sdk.Msg type that supports submitting arbitrary proposal Content.

  • optional google.protobuf.Any content = 1

  • repeated base.v1beta1.Coin initial_deposit = 2

  • string proposer = 3

  message MsgSubmitProposalResponse

  tx.proto:47

  MsgSubmitProposalResponse defines the Msg/SubmitProposal response type.

  • uint64 proposal_id = 1

• rpc Vote (MsgVote, MsgVoteResponse)

  tx.proto:18

  Vote defines a method to add a vote on a specific proposal.

  message MsgVote

  tx.proto:52

  MsgVote defines a message to cast a vote.

  • uint64 proposal_id = 1

  • string voter = 2

  • VoteOption option = 3

  message MsgVoteResponse

  tx.proto:64

  MsgVoteResponse defines the Msg/Vote response type.

  (message has no fields)

• rpc VoteWeighted (MsgVoteWeighted, MsgVoteWeightedResponse)

  tx.proto:23

  VoteWeighted defines a method to add a weighted vote on a specific proposal. Since: cosmos-sdk 0.43

  message MsgVoteWeighted

  tx.proto:69

  MsgVoteWeighted defines a message to cast a vote. Since: cosmos-sdk 0.43

  • uint64 proposal_id = 1

  • string voter = 2

  • repeated WeightedVoteOption options = 3

  message MsgVoteWeightedResponse

  tx.proto:83

  MsgVoteWeightedResponse defines the Msg/VoteWeighted response type. Since: cosmos-sdk 0.43

  (message has no fields)

• rpc Deposit (MsgDeposit, MsgDepositResponse)

  tx.proto:26

  Deposit defines a method to add deposit on a specific proposal.

  message MsgDeposit

  tx.proto:86

  MsgDeposit defines a message to submit a deposit to an existing proposal.

  • uint64 proposal_id = 1

  • string depositor = 2

  • repeated base.v1beta1.Coin amount = 3

  message MsgDepositResponse

  tx.proto:99

  MsgDepositResponse defines the Msg/Deposit response type.

  (message has no fields)

Query defines the gRPC querier service for gov module

• rpc Proposal (QueryProposalRequest, QueryProposalResponse)

  query.proto:14

  Proposal queries proposal details based on ProposalID.

  message QueryProposalRequest

  query.proto:55

  QueryProposalRequest is the request type for the Query/Proposal RPC method.

  • uint64 proposal_id = 1

    proposal_id defines the unique id of the proposal.

  message QueryProposalResponse

  query.proto:61

  QueryProposalResponse is the response type for the Query/Proposal RPC method.

  • optional Proposal proposal = 1

• rpc Proposals (QueryProposalsRequest, QueryProposalsResponse)

  query.proto:19

  Proposals queries all proposals based on given status.

  message QueryProposalsRequest

  query.proto:66

  QueryProposalsRequest is the request type for the Query/Proposals RPC method.

  • ProposalStatus proposal_status = 1

    proposal_status defines the status of the proposals.

  • string voter = 2

    voter defines the voter address for the proposals.

  • string depositor = 3

    depositor defines the deposit addresses from the proposals.

  • optional base.query.v1beta1.PageRequest pagination = 4

    pagination defines an optional pagination for the request.

  message QueryProposalsResponse

  query.proto:85

  QueryProposalsResponse is the response type for the Query/Proposals RPC method.

  • repeated Proposal proposals = 1

  • optional base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

• rpc Vote (QueryVoteRequest, QueryVoteResponse)

  query.proto:24

  Vote queries voted information based on proposalID, voterAddr.

  message QueryVoteRequest

  query.proto:93

  QueryVoteRequest is the request type for the Query/Vote RPC method.

  • uint64 proposal_id = 1

    proposal_id defines the unique id of the proposal.

  • string voter = 2

    voter defines the oter address for the proposals.

  message QueryVoteResponse

  query.proto:105

  QueryVoteResponse is the response type for the Query/Vote RPC method.

  • optional Vote vote = 1

    vote defined the queried vote.

• rpc Votes (QueryVotesRequest, QueryVotesResponse)

  query.proto:29

  Votes queries votes of a given proposal.

  message QueryVotesRequest

  query.proto:111

  QueryVotesRequest is the request type for the Query/Votes RPC method.

  • uint64 proposal_id = 1

    proposal_id defines the unique id of the proposal.

  • optional base.query.v1beta1.PageRequest pagination = 2

    pagination defines an optional pagination for the request.

  message QueryVotesResponse

  query.proto:120

  QueryVotesResponse is the response type for the Query/Votes RPC method.

  • repeated Vote votes = 1

    votes defined the queried votes.

  • optional base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

• rpc Params (QueryParamsRequest, QueryParamsResponse)

  query.proto:34

  Params queries all parameters of the gov module.

  message QueryParamsRequest

  query.proto:129

  QueryParamsRequest is the request type for the Query/Params RPC method.

  • string params_type = 1

    params_type defines which parameters to query for, can be one of "voting", "tallying" or "deposit".

  message QueryParamsResponse

  query.proto:136

  QueryParamsResponse is the response type for the Query/Params RPC method.

  • optional VotingParams voting_params = 1

    voting_params defines the parameters related to voting.

  • optional DepositParams deposit_params = 2

    deposit_params defines the parameters related to deposit.

  • optional TallyParams tally_params = 3

    tally_params defines the parameters related to tally.

• rpc Deposit (QueryDepositRequest, QueryDepositResponse)

  query.proto:39

  Deposit queries single deposit information based proposalID, depositAddr.

  message QueryDepositRequest

  query.proto:146

  QueryDepositRequest is the request type for the Query/Deposit RPC method.

  • uint64 proposal_id = 1

    proposal_id defines the unique id of the proposal.

  • string depositor = 2

    depositor defines the deposit addresses from the proposals.

  message QueryDepositResponse

  query.proto:158

  QueryDepositResponse is the response type for the Query/Deposit RPC method.

  • optional Deposit deposit = 1

    deposit defines the requested deposit.

• rpc Deposits (QueryDepositsRequest, QueryDepositsResponse)

  query.proto:44

  Deposits queries all deposits of a single proposal.

  message QueryDepositsRequest

  query.proto:164

  QueryDepositsRequest is the request type for the Query/Deposits RPC method.

  • uint64 proposal_id = 1

    proposal_id defines the unique id of the proposal.

  • optional base.query.v1beta1.PageRequest pagination = 2

    pagination defines an optional pagination for the request.

  message QueryDepositsResponse

  query.proto:173

  QueryDepositsResponse is the response type for the Query/Deposits RPC method.

  • repeated Deposit deposits = 1

  • optional base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

• rpc TallyResult (QueryTallyResultRequest, QueryTallyResultResponse)

  query.proto:49

  TallyResult queries the tally of a proposal vote.

  message QueryTallyResultRequest

  query.proto:181

  QueryTallyResultRequest is the request type for the Query/Tally RPC method.

  • uint64 proposal_id = 1

    proposal_id defines the unique id of the proposal.

  message QueryTallyResultResponse

  query.proto:187

  QueryTallyResultResponse is the response type for the Query/Tally RPC method.

  • optional TallyResult tally = 1

    tally defines the requested tally.

Deposit defines an amount deposited by an account address to an active proposal.

Used in: GenesisState, QueryDepositResponse, QueryDepositsResponse

• uint64 proposal_id = 1

• string depositor = 2

• repeated base.v1beta1.Coin amount = 3

DepositParams defines the params for deposits on governance proposals.

Used in: GenesisState, QueryParamsResponse

• repeated base.v1beta1.Coin min_deposit = 1

  Minimum deposit for a proposal to enter voting period.

• optional google.protobuf.Duration max_deposit_period = 2

  Maximum period for Atom holders to deposit on a proposal. Initial value: 2 months.

GenesisState defines the gov module's genesis state.

• uint64 starting_proposal_id = 1

  starting_proposal_id is the ID of the starting proposal.

• repeated Deposit deposits = 2

  deposits defines all the deposits present at genesis.

• repeated Vote votes = 3

  votes defines all the votes present at genesis.

• repeated Proposal proposals = 4

  proposals defines all the proposals present at genesis.

• optional DepositParams deposit_params = 5

  params defines all the paramaters of related to deposit.

• optional VotingParams voting_params = 6

  params defines all the paramaters of related to voting.

• optional TallyParams tally_params = 7

  params defines all the paramaters of related to tally.

Proposal defines the core field members of a governance proposal.

Used in: GenesisState, QueryProposalResponse, QueryProposalsResponse

• uint64 proposal_id = 1

• optional google.protobuf.Any content = 2

• ProposalStatus status = 3

• optional TallyResult final_tally_result = 4

• optional google.protobuf.Timestamp submit_time = 5

• optional google.protobuf.Timestamp deposit_end_time = 6

• repeated base.v1beta1.Coin total_deposit = 7

• optional google.protobuf.Timestamp voting_start_time = 8

• optional google.protobuf.Timestamp voting_end_time = 9

ProposalStatus enumerates the valid statuses of a proposal.

Used in: Proposal, QueryProposalsRequest

• PROPOSAL_STATUS_UNSPECIFIED = 0

  PROPOSAL_STATUS_UNSPECIFIED defines the default propopsal status.

• PROPOSAL_STATUS_DEPOSIT_PERIOD = 1

  PROPOSAL_STATUS_DEPOSIT_PERIOD defines a proposal status during the deposit period.

• PROPOSAL_STATUS_VOTING_PERIOD = 2

  PROPOSAL_STATUS_VOTING_PERIOD defines a proposal status during the voting period.

• PROPOSAL_STATUS_PASSED = 3

  PROPOSAL_STATUS_PASSED defines a proposal status of a proposal that has passed.

• PROPOSAL_STATUS_REJECTED = 4

  PROPOSAL_STATUS_REJECTED defines a proposal status of a proposal that has been rejected.

• PROPOSAL_STATUS_FAILED = 5

  PROPOSAL_STATUS_FAILED defines a proposal status of a proposal that has failed.

TallyParams defines the params for tallying votes on governance proposals.

Used in: GenesisState, QueryParamsResponse

• bytes quorum = 1

  Minimum percentage of total stake needed to vote for a result to be considered valid.

• bytes threshold = 2

  Minimum proportion of Yes votes for proposal to pass. Default value: 0.5.

• bytes veto_threshold = 3

  Minimum value of Veto votes to Total votes ratio for proposal to be vetoed. Default value: 1/3.

TallyResult defines a standard tally for a governance proposal.

Used in: Proposal, QueryTallyResultResponse

• string yes = 1

• string abstain = 2

• string no = 3

• string no_with_veto = 4

TextProposal defines a standard text proposal whose changes need to be manually updated in case of approval.

• string title = 1

• string description = 2

Vote defines a vote on a governance proposal. A Vote consists of a proposal ID, the voter, and the vote option.

Used in: GenesisState, QueryVoteResponse, QueryVotesResponse

• uint64 proposal_id = 1

• string voter = 2

• VoteOption option = 3

  Deprecated: Prefer to use `options` instead. This field is set in queries if and only if `len(options) == 1` and that option has weight 1. In all other cases, this field will default to VOTE_OPTION_UNSPECIFIED.

• repeated WeightedVoteOption options = 4

  Since: cosmos-sdk 0.43

VoteOption enumerates the valid vote options for a given governance proposal.

Used in: MsgVote, Vote, WeightedVoteOption

• VOTE_OPTION_UNSPECIFIED = 0

  VOTE_OPTION_UNSPECIFIED defines a no-op vote option.

• VOTE_OPTION_YES = 1

  VOTE_OPTION_YES defines a yes vote option.

• VOTE_OPTION_ABSTAIN = 2

  VOTE_OPTION_ABSTAIN defines an abstain vote option.

• VOTE_OPTION_NO = 3

  VOTE_OPTION_NO defines a no vote option.

• VOTE_OPTION_NO_WITH_VETO = 4

  VOTE_OPTION_NO_WITH_VETO defines a no with veto vote option.

VotingParams defines the params for voting on governance proposals.

Used in: GenesisState, QueryParamsResponse

• optional google.protobuf.Duration voting_period = 1

  Length of the voting period.

WeightedVoteOption defines a unit of vote for vote split. Since: cosmos-sdk 0.43

Used in: MsgVoteWeighted, Vote

• VoteOption option = 1

• string weight = 2