Comment on page
gov
This module provides the basic functionalities for Governance.
Name | Description |
|---|---|
proposal | Query details of a single proposal |
proposals | Query proposals with optional filter |
vote | Query details of a single vote |
votes | Query votes on a proposal |
deposit | Query details of a deposit |
deposits | Query deposits on a proposal |
tally | Get the tally of a proposal vote |
param | Query the parameters (voting |
params | Query the parameters of the governance process |
proposer | Query which address proposed a proposal with a given ID. |
draft-proposal | Draft any type of proposal |
submit-proposal | Submit a proposal along with an initial deposit |
submit-legacy-proposal | Submit a legacy proposal along with an initial deposit |
deposit | Deposit tokens for an active proposal |
vote | Vote for an active proposal, options: yes/no/no_with_veto/abstain |
weighted-vote | Submit a weighted vote for a given governance proposal |
Query details of a proposal.
uptickd query gov proposal [proposal-id] [flags]
Query a proposal
uptickd query gov proposal <proposal-id>
Query proposals with optional filter.
uptickd query gov proposals [flags]
Name, shorthand | Type | Required | Default | Description |
|---|---|---|---|---|
--depositor | string | | | (optional) filter by proposals deposited on by depositor |
--limit | uint | | | pagination limit of proposals to query for (default 100) |
--status | string | | | (optional) filter proposals by proposal status, status: deposit_period/voting_period/passed/rejected |
--voter | string | | | (optional) filter by proposals voted on by voted |
Query all proposals
uptickd query gov proposals
Query proposals by conditions
uptickd query gov proposals --limit=3 --status=Passed --depositor=<uptick...>
Query details of a single vote.
uptickd query gov vote [proposal-id] [voter-addr] [flags]
Query a vote
uptickd query gov vote [proposal-id] [voter-addr] [flags]
Query votes on a proposal.
uptickd query gov votes [proposal-id] [flags]
Query all votes of a proposal
uptickd query gov votes <proposal-id>
Query details for all deposits on a proposal.
uptickd query gov deposits [proposal-id] [flags]
Query all deposits of a proposal
uptickd query gov deposits <proposal-id>
Query tally of votes on a proposal. You can find the proposal-id by running "uptickd query gov proposals".
uptickd query gov tally [proposal-id] [flags]
Query the statistics of a proposal
uptickd query gov tally <proposal-id>
Query the parameters (voting|tallying|deposit) of the governance process.
uptickd query gov param [param-type] [flags]
Example:
uptickd query gov param voting> uptickd query gov param tallying> uptickd query gov param deposit
Query the all the parameters for the governance process.
uptickd query gov params [flags]
Query which address proposed a proposal with a given ID.
uptickd query gov proposer [proposal-id] [flags]
The draft-proposal command allows users to draft any type of proposal. The command returns a draft_proposal.json, to be used by submit-proposal after being completed. The draft_metadata.json is meant to be uploaded to IPFS.
uptickd tx gov draft-proposal
The submit-proposal command allows users to submit a governance proposal along with some messages and metadata. Messages, metadata and deposit are defined in a JSON file.
uptickd tx gov submit-proposal [path/to/proposal.json] [flags]
where proposal.json contains:
{
"messages": [
{
"@type": "/cosmos.bank.v1beta1.MsgSend",
"from_address": "uptick1...",// The gov module module address
"to_address": "uptick1...",
"amount": [
{
"denom": "uptick",
"amount": "10"
}
]
}
],
"metadata": "AQ==",
"deposit": "10uptick"
}
The submit-legacy-proposal command allows users to submit a governance legacy proposal along with an initial deposit. Proposal title, description, type and deposit can be given directly or through a proposal JSON file. Available Commands: ,
client-create, client-upgrade, relayer-register, set-rules.Name, shorthand | Description |
|---|---|
community-pool-spend | Submit a community pool spend proposal |
param-change | Submit a parameter change proposal |
software-upgrade | Submit a software upgrade proposal |
cancel-software-upgrade | Cancel the current software upgrade proposal |
Submit a community pool spend proposal along with an initial deposit. The proposal details must be supplied via a JSON file.
uptickd tx gov submit-legacy-proposal community-pool-spend [proposal-file] [flags]
Where proposal.json contains:
{
"title": "Community Pool Spend",
"description": "Pay me some Atoms!",
"recipient": "uptick1sual70ma3pltk7zjdf6x4e7m6g3hpg6grm33fa",
"amount": "1000uptick",
"deposit": "1000uptick"
}
Submit a parameter proposal along with an initial deposit. The proposal details must be supplied via a JSON file. For values that contains objects, only non-empty fields will be updated.IMPORTANT: Currently parameter changes are evaluated but not validated, so it is very important that any "value" change is valid (ie. correct type and within bounds) for its respective parameter, eg. "MaxValidators" should be an integer and not a decimal.Proper vetting of a parameter change proposal should prevent this from happening (no deposits should occur during the governance process), but it should be noted regardless.
uptickd tx gov submit-legacy-proposal param-change [proposal-file] [flags]
Where proposal.json contains:
{
"title": "Staking Param Change",
"description": "Update max validators",
"changes": [
{
"subspace": "staking",
"key": "MaxValidators",
"value": 105
}
],
"deposit": "1000uptick"
}
Submit a software upgrade along with an initial deposit. Please specify a unique name and height for the upgrade to take effect.
uptickd tx gov submit-legacy-proposal software-upgrade [name] (--upgrade-height [height]) (--upgrade-info [info]) [flags]
Flags:
Name, shorthand | Type | Required | Default | Description |
|---|---|---|---|---|
--deposit | string | Yes | | Deposit of the proposal |
--title | string | Yes | | Title of proposal |
--description | string | Yes | | Description of proposal |
--upgrade-height | int | | | The height at which the upgrade must happen |
Cancel a software upgrade along with an initial deposit.
uptickd tx gov submit-legacy-proposal cancel-software-upgrade [flags]
Flags:
Name, shorthand | Type | Required | Default | Description |
|---|---|---|---|---|
--deposit | string | Yes | | Deposit of the proposal |
--title | string | Yes | | Title of proposal |
--description | string | Yes | | Description of proposal |
Submit a deposit for an active proposal. You can find the proposal-id by running "uptickd query gov proposals".
uptickd tx gov deposit [proposal-id] [deposit] [flags]
Deposit for an active proposal
uptickd tx gov deposit [proposal-id] [deposit]
Submit a vote for an active proposal. You can find the proposal-id by running "uptickd query gov proposals". Vote for an active proposal, options: yes/no/no_with_veto/abstain.
uptickd tx gov vote [proposal-id] [option] [flags]
Vote for an active proposal
uptickd tx gov vote <proposal-id> <option> --from=<key-name> --fees=0.3uptick
The weighted-vote command allows users to submit a weighted vote for a given governance proposal.
uptickd tx gov weighted-vote [proposal-id] [weighted-options] [flags]
Last modified 5mo ago