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:19

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

  message MsgSubmitProposal

  tx.proto:35

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

  • optional google.protobuf.Any content = 1

    content is the proposal's content.

  • repeated base.v1beta1.Coin initial_deposit = 2

    initial_deposit is the deposit value that must be paid at proposal submission.

  • string proposer = 3

    proposer is the account address of the proposer.

  message MsgSubmitProposalResponse

  tx.proto:58

  MsgSubmitProposalResponse defines the Msg/SubmitProposal response type.

  • uint64 proposal_id = 1

    proposal_id defines the unique id of the proposal.

• rpc Vote (MsgVote, MsgVoteResponse)

  tx.proto:22

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

  message MsgVote

  tx.proto:64

  MsgVote defines a message to cast a vote.

  • uint64 proposal_id = 1

    proposal_id defines the unique id of the proposal.

  • string voter = 2

    voter is the voter address for the proposal.

  • VoteOption option = 3

    option defines the vote option.

  message MsgVoteResponse

  tx.proto:84

  MsgVoteResponse defines the Msg/Vote response type.

  (message has no fields)

• rpc VoteWeighted (MsgVoteWeighted, MsgVoteWeightedResponse)

  tx.proto:27

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

  message MsgVoteWeighted

  tx.proto:89

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

  • uint64 proposal_id = 1

    proposal_id defines the unique id of the proposal.

  • string voter = 2

    voter is the voter address for the proposal.

  • repeated WeightedVoteOption options = 3

    options defines the weighted vote options.

  message MsgVoteWeightedResponse

  tx.proto:111

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

  (message has no fields)

• rpc Deposit (MsgDeposit, MsgDepositResponse)

  tx.proto:30

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

  message MsgDeposit

  tx.proto:114

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

  • uint64 proposal_id = 1

    proposal_id defines the unique id of the proposal.

  • string depositor = 2

    depositor defines the deposit addresses from the proposals.

  • repeated base.v1beta1.Coin amount = 3

    amount to be deposited by depositor.

  message MsgDepositResponse

  tx.proto:138

  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:16

  Proposal queries proposal details based on ProposalID.

  message QueryProposalRequest

  query.proto:57

  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:63

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

  • optional Proposal proposal = 1

• rpc Proposals (QueryProposalsRequest, QueryProposalsResponse)

  query.proto:21

  Proposals queries all proposals based on given status.

  message QueryProposalsRequest

  query.proto:68

  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:87

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

  • repeated Proposal proposals = 1

    proposals defines all the requested governance proposals.

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

    pagination defines the pagination in the response.

• rpc Vote (QueryVoteRequest, QueryVoteResponse)

  query.proto:26

  Vote queries voted information based on proposalID, voterAddr.

  message QueryVoteRequest

  query.proto:96

  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 voter address for the proposals.

  message QueryVoteResponse

  query.proto:108

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

  • optional Vote vote = 1

    vote defines the queried vote.

• rpc Votes (QueryVotesRequest, QueryVotesResponse)

  query.proto:31

  Votes queries votes of a given proposal.

  message QueryVotesRequest

  query.proto:114

  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:123

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

  • repeated Vote votes = 1

    votes defines the queried votes.

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

    pagination defines the pagination in the response.

• rpc Params (QueryParamsRequest, QueryParamsResponse)

  query.proto:36

  Params queries all parameters of the gov module.

  message QueryParamsRequest

  query.proto:132

  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:139

  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:41

  Deposit queries single deposit information based proposalID, depositAddr.

  message QueryDepositRequest

  query.proto:149

  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:161

  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:46

  Deposits queries all deposits of a single proposal.

  message QueryDepositsRequest

  query.proto:167

  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:176

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

  • repeated Deposit deposits = 1

    deposits defines the requested deposits.

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

    pagination defines the pagination in the response.

• rpc TallyResult (QueryTallyResultRequest, QueryTallyResultResponse)

  query.proto:51

  TallyResult queries the tally of a proposal vote.

  message QueryTallyResultRequest

  query.proto:185

  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:191

  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

  proposal_id defines the unique id of the proposal.

• string depositor = 2

  depositor defines the deposit addresses from the proposals.

• repeated base.v1beta1.Coin amount = 3

  amount to be deposited by depositor.

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 parameters of related to deposit.

• optional VotingParams voting_params = 6

  params defines all the parameters of related to voting.

• optional TallyParams tally_params = 7

  params defines all the parameters of related to tally.

Proposal defines the core field members of a governance proposal.

Used in: GenesisState, QueryProposalResponse, QueryProposalsResponse

• uint64 proposal_id = 1

  proposal_id defines the unique id of the proposal.

• optional google.protobuf.Any content = 2

  content is the proposal's content.

• ProposalStatus status = 3

  status defines the proposal status.

• optional TallyResult final_tally_result = 4

  final_tally_result is the final tally result of the proposal. When querying a proposal via gRPC, this field is not populated until the proposal's voting period has ended.

• optional google.protobuf.Timestamp submit_time = 5

  submit_time is the time of proposal submission.

• optional google.protobuf.Timestamp deposit_end_time = 6

  deposit_end_time is the end time for deposition.

• repeated base.v1beta1.Coin total_deposit = 7

  total_deposit is the total deposit on the proposal.

• optional google.protobuf.Timestamp voting_start_time = 8

  voting_start_time is the starting time to vote on a proposal.

• optional google.protobuf.Timestamp voting_end_time = 9

  voting_end_time is the end time of voting on a proposal.

ProposalStatus enumerates the valid statuses of a proposal.

Used in: Proposal, QueryProposalsRequest

• PROPOSAL_STATUS_UNSPECIFIED = 0

  PROPOSAL_STATUS_UNSPECIFIED defines the default proposal 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

  yes is the number of yes votes on a proposal.

• string abstain = 2

  abstain is the number of abstain votes on a proposal.

• string no = 3

  no is the number of no votes on a proposal.

• string no_with_veto = 4

  no_with_veto is the number of no with veto votes on a proposal.

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

• string title = 1

  title of the proposal.

• string description = 2

  description associated with the proposal.

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

  proposal_id defines the unique id of the proposal.

• string voter = 2

  voter is the voter address of the proposal.

• 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

  options is the weighted vote options. 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

  Duration 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

  option defines the valid vote options, it must not contain duplicate vote options.

• string weight = 2

  weight is the vote weight associated with the vote option.