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


---

# 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.stafihub.io/welcome-to-stafihub/chain/cli-client/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.