gov

This module provides the basic functionalities for Governance.

Available Commands

NameDescription

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

uptickd query gov proposal

Query details of a proposal.

uptickd query gov proposal [proposal-id] [flags]

Query a proposal

uptickd query gov proposal <proposal-id>

uptickd query gov proposals

Query proposals with optional filter.

uptickd query gov proposals [flags]
Name, shorthandTypeRequiredDefaultDescription

--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...>

uptickd query gov vote

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]

uptickd query gov votes

Query votes on a proposal.

uptickd query gov votes [proposal-id] [flags]

Query all votes of a proposal

uptickd query gov votes <proposal-id>

uptickd query gov deposits

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>

uptickd query gov tally

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>

uptickd query gov param

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

uptickd query gov params

Query the all the parameters for the governance process.

uptickd query gov params [flags]

uptickd query gov proposer

Query which address proposed a proposal with a given ID.

uptickd query gov proposer [proposal-id] [flags]

uptickd tx gov draft-proposal

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

uptickd tx gov submit-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"
}

uptickd tx gov submit-legacy-proposal

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, shorthandDescription

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

uptickd tx gov submit-legacy-proposal community-pool-spend

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"
}

uptickd tx gov submit-legacy-proposal param-change

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"
}

uptickd tx gov submit-legacy-proposal software-upgrade

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, shorthandTypeRequiredDefaultDescription

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

uptickd tx gov submit-legacy-proposal cancel-software-upgrade

Cancel a software upgrade along with an initial deposit.

uptickd tx gov submit-legacy-proposal cancel-software-upgrade [flags]

Flags:

Name, shorthandTypeRequiredDefaultDescription

--deposit

string

Yes

Deposit of the proposal

--title

string

Yes

Title of proposal

--description

string

Yes

Description of proposal

uptickd tx gov deposit

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]

uptickd tx gov vote

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

uptickd tx gov weighted-vote

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 updated