# gov

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

# rebusd query gov proposal

Query details of a single governance proposal:

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

Flags:

Name, shorthand	Type	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

# rebusd query gov proposals

Query all proposals:

rebusd query gov proposals

Query proposals with conditions filters:

rebusd query gov proposals --limit=3 --status=Passed --depositor=<rebus...>

# rebusd query gov vote

Query details of a single vote.

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

# rebusd query gov votes

Query votes on a proposal.

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

# rebusd query gov deposit

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

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

# rebusd query gov deposits

Query details for all deposits on a proposal.

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

# rebusd query gov tally

Query tally of votes on a proposal.

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

# rebusd query gov param

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

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

Example:

# query voting parameters
rebusd query gov param voting

# query tallying parameters
rebusd query gov param tallying

# query deposit parameters
rebusd query gov param deposit

# rebusd query gov params

Query the all the parameters for the governance process.

rebusd query gov params [flags]

# rebusd query gov proposer

Query which address proposed a proposal with a given ID.

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

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

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

rebusd 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 Rebus community",
    "recipient": "rebus1ludczrvlw36fkur9vy49lx4vjqhppn30h42ufg",
    "amount": "1000000urebus",
    "deposit": "1000urebus"
}

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

rebusd 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": "1000urebus"
}

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

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

Flags:

Name, shorthand	Type	Required	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/rebus.zip?checksum=sha256:aec070645fe53ee3b3763059376134f058cc337247c978add178b6ccdfb0019f"
  }
}

# rebusd tx gov submit-proposal cancel-software-upgrade

Cancel a software upgrade along with an initial deposit.

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

Flags:

Name, shorthand	Type	Required	Description
--deposit	Coin	Yes	Deposit of the proposal
--title	string	Yes	Title of proposal
--description	string	Yes	Description of proposal

# rebusd tx gov deposit

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

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

# rebusd tx gov vote

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

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

Example vote, voting yes on proposal number 1:

rebusd tx gov vote 1 yes --from=<key_or_address> --fees=1rebus