> For the complete documentation index, see [llms.txt](https://docs.stafihub.io/welcome-to-stafihub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stafihub.io/welcome-to-stafihub/chain/cli-client/staking.md).

# Staking

Staking module provides a set of subcommands to query staking state and send staking transactions.

## Available Commands

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

## stafihubd query staking validator

### Query a validator by validator address

```bash
stafihubd query staking validator <iva...>
```

## stafihubd query staking validators

### Query all validators

```bash
stafihubd query staking validators
```

## stafihubd query staking delegation

Query a delegation based on delegator address and validator address.

```bash
stafihubd query staking delegation [delegator-addr] [validator-addr]
```

### Query a delegation

```bash
stafihubd query staking delegation <iaa...> <iva...>
```

Example Output:

```bash
Delegation:
  Delegator:  iaa13lcwnxpyn2ea3skzmek64vvnp97jsk8qrcezvm
  Validator:  iva15grv3xg3ekxh9xrf79zd0w077krgv5xfzzunhs
  Shares:     1.0000000000000000000000000000
  Height:     26
```

## stafihubd query staking delegations

Query all delegations delegated from one delegator.

```bash
stafihubd query staking delegations [delegator-address] [flags]
```

### Query all delegations of a delegator

```bash
stafihubd query staking delegations <iaa...>
```

## stafihubd query staking delegations-to

Query all delegations to one validator.

```bash
stafihubd query staking delegations-to [validator-address] [flags]
```

### Query all delegations to one validator

```bash
stafihubd query staking delegations-to <iva...>
```

Example Output:

```bash
Delegation:
  Delegator:  iaa13lcwnxpyn2ea3skzmek64vvnp97jsk8qrcezvm
  Validator:  iva1yclscskdtqu9rgufgws293wxp3njsesxxlnhmh
  Shares:     100.0000000000000000000000000000
  Height:     0
Delegation:
  Delegator:  iaa1td4xnefkthfs6jg469x33shzf578fed6n7k7ua
  Validator:  iva1yclscskdtqu9rgufgws293wxp3njsesxxlnhmh
  Shares:     1.0000000000000000000000000000
  Height:     26
```

## stafihubd query staking unbonding-delegation

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

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

### Query an unbonding delegation record

```bash
stafihubd query staking unbonding-delegation <iaa...> <iva...>
```

## stafihubd query staking unbonding-delegations

### Query all unbonding delegations records of a delegator

```bash
stafihubd query staking unbonding-delegations <iaa...>
```

## stafihubd query staking unbonding-delegations-from

### Query all unbonding delegations from a validator

```bash
stafihubd query staking unbonding-delegations-from <iva...>
```

## stafihubd query staking redelegations-from

Query all outgoing redelegations of a validator

```bash
stafihubd query staking redelegations-from [validator-address] [flags]
```

### Query all outgoing redelegatations of a validator

```bash
stafihubd query staking redelegations-from <iva...>
```

## stafihubd query staking redelegation

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

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

### Query a redelegation record

```bash
stafihubd query staking redelegation <iaa...> <iva...> <iva...>
```

## stafihubd query staking redelegations

### Query all redelegations records of a delegator

```bash
stafihubd query staking redelegations <iaa...>
```

## stafihubd query staking pool

### Query the current staking pool values

```bash
stafihubd query staking pool
```

Example Output:

```bash
Pool:
  Loose Tokens:   1409493892.759816067399143966
  Bonded Tokens:  590526409.65743521209068061
  Token Supply:   2000020302.417251279489824576
  Bonded Ratio:   0.2952602076
```

## stafihubd query staking params

### Query the current staking parameters information

```bash
stafihubd query staking params
```

## stafihubd query staking historical-info

### Query historical info at given height

```bash
stafihubd query staking historical-info <height>
```

## stafihubd tx staking create-validator

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

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

```bash
stafihubd tx staking create-validator --chain-id=stafihub --from=<key-name> --fees=0.3fis --pubkey=<validator-pubKey> --commission-rate=0.1 --amount=100fis --moniker=<validator-name>
```

:::tip Follow the Mainnet instructions to learn more. :::

## stafihubd tx staking edit-validator

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

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

```bash
stafihubd tx staking edit-validator --from=<key-name> --chain-id=stafihub --fees=0.3fis --commission-rate=0.10 --moniker=<validator-name>
```

### Upload validator avatar

Please refer to How to upload my validator's logo to the Explorers

## stafihubd tx staking delegate

Delegate tokens to a validator.

```bash
stafihubd tx staking delegate [validator-addr] [amount] [flags]
```

```bash
stafihubd tx staking delegate <iva...> <amount> --chain-id=stafihub --from=<key-name> --fees=0.3fis
```

## stafihubd tx staking unbond

Unbond tokens from a validator.

```bash
stafihubd tx staking unbond [validator-addr] [amount] [flags]
```

### Unbond some tokens from a validator

```bash
stafihubd tx staking unbond <iva...> 10fis --from=<key-name> --chain-id=stafihub --fees=0.3fis
```

## stafihubd tx staking redelegate

Transfer delegation from one validator to another.

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

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

### Redelegate some tokens to another validator

```bash
stafihubd tx staking redelegate <iva...> <iva...> 10fis --chain-id=stafihub --from=<key-name> --fees=0.3fis
```