gov

The governance module provides tools for querying, submitting, and voting on proposals

Available Commands

Name
Description

Query details of a single proposal

Query proposals with optional filter

Query details of a single vote

Query votes on a proposal

Query details of a deposit

Query deposits on a proposal

Get the tally of a proposal vote

Query the parameters (voting

Query the parameters of the governance process

Query which address proposed a proposal with a given ID.

Submit a proposal along with an initial deposit

Deposit tokens for an active proposal

Vote for an active proposal, options: yes/no/no_with_veto/abstain

junod query gov proposal

Query details of a single governance proposal:

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

Flags:

Name, shorthand
Type
Required
Default
Description

--depositor

Address

Filter proposals by depositor address

--limit

uint

100

Limit to the latest [number] of proposals. Default to all proposals

--status

string

Filter proposals by status

--voter

Address

Filter proposals by voter address

junod query gov proposals

Query all proposals:

junod query gov proposals

Query proposals with conditions filters:

junod query gov proposals --limit=3 --status=Passed --depositor=<juno...>

junod query gov vote

Query details of a single vote.

junod query gov vote [proposal-id] [voter-addr] [flags]

junod query gov votes

Query votes on a proposal.

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

junod query gov deposit

Query details for a single proposal deposit on a proposal by its identifier.

junod query gov deposit [proposal-id] [depositer-addr] [flags]

junod query gov deposits

Query details for all deposits on a proposal.

junod query gov deposits [proposal-id] [flags]

junod query gov tally

Query tally of votes on a proposal.

junod query gov tally [proposal-id] [flags]

junod query gov param

Query the parameters (voting | tallying | deposit) of the governance process.

junod query gov param [param-type] [flags]

Example:

# query voting parameters
junod query gov param voting

# query tallying parameters
junod query gov param tallying

# query deposit parameters
junod query gov param deposit

junod query gov params

Query the all the parameters for the governance process.

junod query gov params [flags]

junod query gov proposer

Query which address proposed a proposal with a given ID.

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

junod tx gov submit-proposal

Submit a proposal along with an initial deposit. Proposal title, description, type and deposit can be given directly or through a proposal JSON file. Available Commands:

Name
Description

cancel-software-upgrade

Cancel the current software upgrade proposal

community-pool-spend

Submit a community pool spend proposal

param-change

Submit a parameter change proposal

software-upgrade

Submit a software upgrade proposal

junod tx gov submit-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.

junod tx gov submit-proposal community-pool-spend <path/to/proposal.json> --from=<key_or_address>

Where proposal.json contains, for example:

{
    "title": "Community Pool Spend",
    "description": "Send me tokens, to benefit the Juno community",
    "recipient": "juno1ludczrvlw36fkur9vy49lx4vjqhppn30h42ufg",
    "amount": "1000000ujuno",
    "deposit": "1000ujuno"
}

junod tx gov submit-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.

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.

junod tx gov submit-proposal param-change <path/to/proposal.json> --from=<key_or_address>

Where proposal.json contains, for example:

{
    "title": "Staking Param Change",
    "description": "Update max validators",
    "changes": [
        {
        "subspace": "staking",
        "key": "MaxValidators",
        "value": 105
        }
    ],
    "deposit": "1000ujuno"
}

junod tx gov submit-proposal software-upgrade

Submit a software upgrade along with an initial deposit. Please specify a unique name and height OR time for the upgrade to take effect.

junod tx gov submit-proposal software-upgrade [name] (--upgrade-height [height] | --upgrade-time [time]) (--upgrade-info [info]) [flags]

Flags:

Name, shorthand
Type
Required
Default
Description

--deposit

Coin

Yes

Deposit of the proposal

--title

string

Yes

Title of proposal

--description

string

Yes

Description of proposal

--upgrade-height

int64

The height at which the upgrade must happen (not to be used together with --upgrade-time)

--time

string

The time at which the upgrade must happen (not to be used together with --upgrade-height)

--info

string

Optional info for the planned upgrade such as commit hash, etc.

TIP

To enable nodes managed by forbole/cosmovisor to undertake an automatic upgrade, where the operator has the required environment variable set.

Store an os/architecture -> binary URI map in the upgrade plan info field as JSON under the "binaries" key, eg:

{
  "binaries": {
    "linux/amd64":"https://example.com/juno.zip?checksum=sha256:aec070645fe53ee3b3763059376134f058cc337247c978add178b6ccdfb0019f"
  }
}

junod tx gov submit-proposal cancel-software-upgrade

Cancel a software upgrade along with an initial deposit.

junod tx gov submit-proposal cancel-software-upgrade [flags]

Flags:

Name, shorthand
Type
Required
Default
Description

--deposit

Coin

Yes

Deposit of the proposal

--title

string

Yes

Title of proposal

--description

string

Yes

Description of proposal

junod tx gov deposit

Submit a deposit for an active proposal. You can find the proposal-id by running junod query gov proposals.

junod tx gov deposit [proposal-id] [deposit] [flags]

junod tx gov vote

Submit a vote for an active proposal. You can find the proposal-id by running junod query gov proposals. Vote for an active proposal, options: (yes | no | no_with_veto | abstain).

junod tx gov vote [proposal-id] [option] [flags]

Example vote, voting yes on proposal number 1:

junod tx gov vote 1 yes --from=<key_or_address> --fees=1juno

Last updated