# gov

## Available Commands

| Name                                            | Description                                                         |
| ----------------------------------------------- | ------------------------------------------------------------------- |
| [proposal](#juno-query-gov-proposal)            | Query details of a single proposal                                  |
| [proposals](#juno-query-gov-proposals)          | Query proposals with optional filter                                |
| [vote](#juno-query-gov-vote)                    | Query details of a single vote                                      |
| [votes](#juno-query-gov-votes)                  | Query votes on a proposal                                           |
| [deposit](#juno-query-gov-deposit)              | Query details of a deposit                                          |
| [deposits](#juno-query-gov-deposits)            | Query deposits on a proposal                                        |
| [tally](#juno-query-gov-tally)                  | Get the tally of a proposal vote                                    |
| [param](#juno-query-gov-param)                  | Query the parameters (voting                                        |
| [params](#juno-query-gov-params)                | Query the parameters of the governance process                      |
| [proposer](#juno-query-gov-proposer)            | Query which address proposed a proposal with a given ID.            |
| [submit-proposal](#juno-tx-gov-submit-proposal) | Submit a proposal along with an initial deposit                     |
| [deposit](#juno-tx-gov-deposit)                 | Deposit tokens for an active proposal                               |
| [vote](#juno-tx-gov-vote)                       | Vote for an active proposal, options: yes/no/no\_with\_veto/abstain |

### junod query gov proposal <a href="#juno-query-gov-proposal" id="juno-query-gov-proposal"></a>

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 <a href="#juno-query-gov-proposals" id="juno-query-gov-proposals"></a>

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 <a href="#juno-query-gov-vote" id="juno-query-gov-vote"></a>

Query details of a single vote.

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

### junod query gov votes <a href="#juno-query-gov-votes" id="juno-query-gov-votes"></a>

Query votes on a proposal.

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

### junod query gov deposit <a href="#juno-query-gov-deposit" id="juno-query-gov-deposit"></a>

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 <a href="#juno-query-gov-deposits" id="juno-query-gov-deposits"></a>

Query details for all deposits on a proposal.

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

### junod query gov tally <a href="#juno-query-gov-tally" id="juno-query-gov-tally"></a>

Query tally of votes on a proposal.

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

### junod query gov param <a href="#juno-query-gov-param" id="juno-query-gov-param"></a>

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 <a href="#juno-query-gov-params" id="juno-query-gov-params"></a>

Query the all the parameters for the governance process.

```
junod query gov params [flags]
```

### junod query gov proposer <a href="#juno-query-gov-proposer" id="juno-query-gov-proposer"></a>

Query which address proposed a proposal with a given ID.

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

### junod tx gov submit-proposal <a href="#juno-tx-gov-submit-proposal" id="juno-tx-gov-submit-proposal"></a>

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 <a href="#juno-tx-gov-submit-proposal-community-pool-spend" id="juno-tx-gov-submit-proposal-community-pool-spend"></a>

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 <a href="#juno-tx-gov-submit-proposal-param-change" id="juno-tx-gov-submit-proposal-param-change"></a>

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.

{% hint style="warning" %}
**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.
{% endhint %}

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 <a href="#juno-tx-gov-submit-proposal-software-upgrade" id="juno-tx-gov-submit-proposal-software-upgrade"></a>

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

{% hint style="info" %}
**TIP**

To enable nodes managed by [forbole/cosmovisor](https://github.com/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"
  }
}
```

{% endhint %}

#### junod tx gov submit-proposal cancel-software-upgrade <a href="#juno-tx-gov-submit-proposal-cancel-software-upgrade" id="juno-tx-gov-submit-proposal-cancel-software-upgrade"></a>

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 <a href="#juno-tx-gov-deposit" id="juno-tx-gov-deposit"></a>

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 <a href="#juno-tx-gov-vote" id="juno-tx-gov-vote"></a>

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