Links

gov

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

Available Commands

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

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.
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.
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 modified 6mo ago