# staking

## Available Commands

| Name                                                                         | Description                                                                                   |
| ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| [validator](#iris-query-staking-validator)                                   | Query a validator                                                                             |
| [validators](#iris-query-staking-validators)                                 | Query for all validators                                                                      |
| [delegation](#iris-query-staking-delegation)                                 | Query a delegation based on address and validator address                                     |
| [delegations](#iris-query-staking-delegations)                               | Query all delegations made from one delegator                                                 |
| [delegations-to](#iris-query-staking-delegations-to)                         | Query all delegations to one validator                                                        |
| [unbonding-delegation](#iris-query-staking-unbonding-delegation)             | Query an unbonding-delegation record based on delegator and validator address                 |
| [unbonding-delegations](#iris-query-staking-unbonding-delegations)           | Query all unbonding-delegations records for one delegator                                     |
| [unbonding-delegations-from](#iris-query-staking-unbonding-delegations-from) | Query all unbonding delegatations from a validator                                            |
| [redelegations-from](#iris-query-staking-redelegations-from)                 | Query all outgoing redelegatations from a validator                                           |
| [redelegation](#iris-query-staking-redelegation)                             | Query a redelegation record based on delegator and a source and destination validator address |
| [redelegations](#iris-query-staking-redelegations)                           | Query all redelegations records for one delegator                                             |
| [pool](#iris-query-staking-pool)                                             | Query the current staking pool values                                                         |
| [params](#iris-query-staking-params)                                         | Query the current staking parameters information                                              |
| [historical-info](#iris-query-staking-historical-info)                       | Query historical info at given height                                                         |
| [create-validator](#iris-tx-staking-create-validator)                        | Create new validator initialized with a self-delegation to it                                 |
| [edit-validator](#iris-tx-staking-edit-validator)                            | Edit existing validator account                                                               |
| [delegate](#iris-tx-staking-delegate)                                        | Delegate liquid tokens to an validator                                                        |
| [unbond](#iris-tx-staking-unbond)                                            | Unbond shares from a validator                                                                |
| [redelegate](#iris-tx-staking-redelegate)                                    | Redelegate illiquid tokens from one validator to another                                      |

### junod query staking validator <a href="#iris-query-staking-validator" id="iris-query-staking-validator"></a>

#### Query a validator by validator address <a href="#query-a-validator-by-validator-address" id="query-a-validator-by-validator-address"></a>

Query information for validator address `<junovaloper...>`:

```
junod query staking validator <junovaloper...>
```

Will return something similar to:

```
commission:
  commission_rates:
    max_change_rate: "0.010000000000000000"
    max_rate: "0.200000000000000000"
    rate: "0.110000000000000000"
  update_time: "2021-07-01T09:06:42.110582713Z"
consensus_pubkey:
  '@type': /cosmos.crypto.ed25519.PubKey
  key: +vZPP6QFMUUkCO+MyMdOZGUzuNLAB98ruw6Rjfvnk60=
delegator_shares: "10647850539.181674918343698393"
description:
  details: ""
  identity: FEE30F35994C320D
  moniker: nullmames
  security_contact: ""
  website: ""
jailed: false
min_self_delegation: "1"
operator_address: junovaloper1ludczrvlw36fkur9vy49lx4vjqhppn30ggunj3
status: BOND_STATUS_BONDED
tokens: "10331782033"
unbonding_height: "631804"
unbonding_time: "2021-08-25T00:26:38.283926951Z"
```

### junod query staking validators <a href="#iris-query-staking-validators" id="iris-query-staking-validators"></a>

#### Query all validators <a href="#query-all-validators" id="query-all-validators"></a>

The following will return information for ALL validators:

```
junod query staking validators
```

The returned values will be similar to those from [`junod query staking validator`](#iris-query-staking-validator)\`\`

### junod query staking delegation <a href="#iris-query-staking-delegation" id="iris-query-staking-delegation"></a>

Query a delegation based on delegator address and validator address.

```
junod query staking delegation [delegator-addr] [validator-addr]
```

#### Query a delegation <a href="#query-a-delegation" id="query-a-delegation"></a>

The following will return delegations for a delegator to a particular validator address `<junovaloper...>` :

```
junod query staking delegation <juno...> <junovaloper...>
```

Returns something similar to:

```
balance:
  amount: "9159423104"
  denom: ujuno
delegation:
  delegator_address: juno1ludczrvlw36fkur9vy49lx4vjqhppn30h42ufg
  shares: "9439626961.941610808328957187"
  validator_address: junovaloper1ludczrvlw36fkur9vy49lx4vjqhppn30ggunj3
```

### junod query staking delegations <a href="#iris-query-staking-delegations" id="iris-query-staking-delegations"></a>

Query all delegations delegated from one delegator.

```
junod query staking delegations [delegator-address] [flags]
```

#### Query all delegations of a delegator <a href="#query-all-delegations-of-a-delegator" id="query-all-delegations-of-a-delegator"></a>

The following command will return all delegations from a delegators address `<juno...>`:

```
junod query staking delegations <juno...>
```

Will return something similar to:

```
delegation_responses:
- balance:
    amount: "1100000"
    denom: ujuno
  delegation:
    delegator_address: juno1ludczrvlw36fkur9vy49lx4vjqhppn30h42ufg
    shares: "1100000.000000000000000000"
    validator_address: junovaloper1ms8tvfkerhyf6mca2qc79t7mr3eh9dsr79mjf2
- balance:
    amount: "9166092794"
    denom: ujuno
  delegation:
    delegator_address: juno1ludczrvlw36fkur9vy49lx4vjqhppn30h42ufg
    shares: "9446500690.213833508382324426"
    validator_address: junovaloper1ludczrvlw36fkur9vy49lx4vjqhppn30ggunj3
pagination:
  next_key: null
  total: "0"
```

### junod query staking delegations-to <a href="#iris-query-staking-delegations-to" id="iris-query-staking-delegations-to"></a>

Query all delegations to one validator.

```
junod query staking delegations-to [validator-address] [flags]
```

#### Query all delegations to one validator <a href="#query-all-delegations-to-one-validator" id="query-all-delegations-to-one-validator"></a>

The following command will return all delegations to a validator address `<junovaloper...>`:

```
junod query staking delegations-to <junovaloper...>
```

Will return something similar to:

```
delegation_responses:
- balance:
    amount: "990000675"
    denom: ujuno
  delegation:
    delegator_address: juno1qnshaxp9w7aecthj2sn4c0uct07urg3tsd2rqs
    shares: "1020286644.656983874857994825"
    validator_address: junovaloper1ludczrvlw36fkur9vy49lx4vjqhppn30ggunj3
- balance:
    amount: "180180122"
    denom: ujuno
  delegation:
    delegator_address: juno1na45quuuzuv5xtzl5qqp9zep9rkluqykwtcgd3
    shares: "185692169.327571065224155062"
    validator_address: junovaloper1ludczrvlw36fkur9vy49lx4vjqhppn30ggunj3
```

### junod query staking unbonding-delegation <a href="#iris-query-staking-unbonding-delegation" id="iris-query-staking-unbonding-delegation"></a>

Query an unbonding-delegation record based on delegator and validator address.

```
junod query staking unbonding-delegation [delegator-addr] [validator-addr] [flags]
```

#### Query an unbonding delegation record <a href="#query-an-unbonding-delegation-record" id="query-an-unbonding-delegation-record"></a>

```
junod query staking unbonding-delegation <juno...> <junovaloper...>
```

### junod query staking unbonding-delegations <a href="#iris-query-staking-unbonding-delegations" id="iris-query-staking-unbonding-delegations"></a>

#### Query all unbonding delegations records of a delegator <a href="#query-all-unbonding-delegations-records-of-a-delegator" id="query-all-unbonding-delegations-records-of-a-delegator"></a>

```
junod query staking unbonding-delegations <juno...>
```

### junod query staking unbonding-delegations-from <a href="#iris-query-staking-unbonding-delegations-from" id="iris-query-staking-unbonding-delegations-from"></a>

#### Query all unbonding delegations from a validator <a href="#query-all-unbonding-delegations-from-a-validator" id="query-all-unbonding-delegations-from-a-validator"></a>

```
junod query staking unbonding-delegations-from <junovaloper...>
```

### junod query staking redelegations-from <a href="#iris-query-staking-redelegations-from" id="iris-query-staking-redelegations-from"></a>

Query all outgoing redelegations of a validator

```
junod query staking redelegations-from [validator-address] [flags]
```

#### Query all outgoing redelegatations of a validator <a href="#query-all-outgoing-redelegatations-of-a-validator" id="query-all-outgoing-redelegatations-of-a-validator"></a>

```
junod query staking redelegations-from <junovaloper...>
```

### junod query staking redelegation <a href="#iris-query-staking-redelegation" id="iris-query-staking-redelegation"></a>

Query a redelegation record based on delegator and source validator address and destination validator address.

```
junod query staking redelegation [delegator-addr] [src-validator-addr] [dst-validator-addr] [flags]
```

#### Query a redelegation record <a href="#query-a-redelegation-record" id="query-a-redelegation-record"></a>

```
junod query staking redelegation <juno...> <junovaloper...> <junovaloper...>
```

### junod query staking redelegations <a href="#iris-query-staking-redelegations" id="iris-query-staking-redelegations"></a>

#### Query all redelegations records of a delegator <a href="#query-all-redelegations-records-of-a-delegator" id="query-all-redelegations-records-of-a-delegator"></a>

```
junod query staking redelegations <juno...>
```

### junod query staking pool <a href="#iris-query-staking-pool" id="iris-query-staking-pool"></a>

#### Query the current staking pool values <a href="#query-the-current-staking-pool-values" id="query-the-current-staking-pool-values"></a>

```
junod query staking pool
```

Returns something similar to:

```
bonded_tokens: "1547447152807"
not_bonded_tokens: "67232814293"
```

### junod query staking params <a href="#iris-query-staking-params" id="iris-query-staking-params"></a>

#### Query the current staking parameters information <a href="#query-the-current-staking-parameters-information" id="query-the-current-staking-parameters-information"></a>

```
junod query staking params
```

Returns something similar to:

```
bond_denom: ujuno
historical_entries: 10000
max_entries: 7
max_validators: 125
unbonding_time: 1814400s
```

### junod query staking historical-info <a href="#iris-query-staking-historical-info" id="iris-query-staking-historical-info"></a>

#### Query historical info at given height <a href="#query-historical-info-at-given-height" id="query-historical-info-at-given-height"></a>

```
junod query staking historical-info <height>
```

### junod tx staking create-validator <a href="#iris-tx-staking-create-validator" id="iris-tx-staking-create-validator"></a>

Send a transaction to apply to be a validator and delegate a certain amount of `juno` to it.

```
junod tx staking create-validator [flags]
```

**Flags:**

| Name, shorthand              | type   | Required | Default | Description                                                                                      |
| ---------------------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------ |
| --amount                     | string | Yes      |         | Amount of coins to bond                                                                          |
| --commission-rate            | float  | Yes      | 0.0     | The initial commission rate percentage                                                           |
| --commission-max-rate        | float  |          | 0.0     | The maximum commission rate percentage                                                           |
| --commission-max-change-rate | float  |          | 0.0     | The maximum commission change rate percentage (per day)                                          |
| --min-self-delegation        | string |          |         | The minimum self delegation required on the validator                                            |
| --details                    | string |          |         | Optional details                                                                                 |
| --genesis-format             | bool   |          | false   | Export the transaction in gen-tx format; it implies --generate-only                              |
| --identity                   | string |          |         | Optional identity signature (ex. UPort or Keybase)                                               |
| --ip                         | string |          |         | Node's public IP. It takes effect only when used in combination with                             |
| --node-id                    | string |          |         | The node's ID                                                                                    |
| --moniker                    | string | Yes      |         | Validator name                                                                                   |
| --pubkey                     | string | Yes      |         | Go-Amino encoded hex PubKey of the validator. For Ed25519 the go-amino prepend hex is 1624de6220 |
| --website                    | string |          |         | Optional website                                                                                 |
| --security-contact           | string |          |         | The validator's (optional) security contact email                                                |

#### Create a validator <a href="#create-a-validator" id="create-a-validator"></a>

```
junod tx staking create-validator --chain-id=juno --from=<key-name> --fees=0.025juno --pubkey=<validator-pubKey> --commission-rate=0.1 --amount=100000000ujuno --moniker=<validator-name>
```

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

Refer to [mainnet](https://topmonks.gitbook.io/junodocs/validators/mainnet) instructions for detailed information.
{% endhint %}

### junod tx staking edit-validator <a href="#iris-tx-staking-edit-validator" id="iris-tx-staking-edit-validator"></a>

Edit an existing validator's settings, such as commission rate, name, etc.

```
junod tx staking edit-validator [flags]
```

**Flags:**

| Name, shorthand       | type   | Required | Default | Description                                           |
| --------------------- | ------ | -------- | ------- | ----------------------------------------------------- |
| --commission-rate     | float  |          | 0.0     | Commission rate percentage                            |
| --moniker             | string |          |         | Validator name                                        |
| --identity            | string |          |         | Optional identity signature (ex. UPort or Keybase)    |
| --website             | string |          |         | Optional website                                      |
| --details             | string |          |         | Optional details                                      |
| --security-contact    | string |          |         | The validator's (optional) security contact email     |
| --min-self-delegation | string |          |         | The minimum self delegation required on the validator |

#### Edit validator information <a href="#edit-validator-information" id="edit-validator-information"></a>

```
junod tx staking edit-validator --from=<key-name> --chain-id=juno --fees=1juno --commission-rate=0.10 --moniker=<validator-name>
```

### junod tx staking delegate <a href="#iris-tx-staking-delegate" id="iris-tx-staking-delegate"></a>

Delegate tokens to a validator.

```
junod tx staking delegate [validator-addr] [amount] [flags]
```

```
junod tx staking delegate <junovaloper...> <amount> --chain-id=juno --from=<key-name>
```

### junod tx staking unbond <a href="#iris-tx-staking-unbond" id="iris-tx-staking-unbond"></a>

Unbond tokens from a validator.

```
junod tx staking unbond [validator-addr] [amount] [flags]
```

#### Unbond some tokens from a validator <a href="#unbond-some-tokens-from-a-validator" id="unbond-some-tokens-from-a-validator"></a>

```
junod tx staking unbond <junovaloper...> 1000000ujuno --from=<key-name> --chain-id=juno 
```

### junod tx staking redelegate <a href="#iris-tx-staking-redelegate" id="iris-tx-staking-redelegate"></a>

Transfer delegation from one validator to another.

{% hint style="info" %}
TIP

There is no `unbonding time` during the redelegation, so you will not miss the rewards. But you can only redelegate once per validator, until a period (= `unbonding time`) exceed.
{% endhint %}

```
junod tx staking redelegate [src-validator-addr] [dst-validator-addr] [amount] [flags]
```

#### Redelegate some tokens to another validator <a href="#redelegate-some-tokens-to-another-validator" id="redelegate-some-tokens-to-another-validator"></a>

```
junod tx staking redelegate <junovaloper...> <junovaloper...> 1000000ujuno --chain-id=juno --from=<key-name>
```
