# 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](/validators/mainnet.md) 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>
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.junonetwork.io/cli/modules/staking.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.