Staking

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

Available Commands

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

stafihubd query staking validator

Query a validator by validator address

stafihubd query staking validator <iva...>

stafihubd query staking validators

Query all validators

stafihubd query staking validators

stafihubd query staking delegation

Query a delegation based on delegator address and validator address.

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

Query a delegation

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

Example Output:

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

stafihubd query staking delegations

Query all delegations delegated from one delegator.

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

Query all delegations of a delegator

stafihubd query staking delegations <iaa...>

stafihubd query staking delegations-to

Query all delegations to one validator.

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

Query all delegations to one validator

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

Example Output:

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.

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

Query an unbonding delegation record

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

stafihubd query staking unbonding-delegations

Query all unbonding delegations records of a delegator

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

stafihubd query staking unbonding-delegations-from

Query all unbonding delegations from a validator

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

stafihubd query staking redelegations-from

Query all outgoing redelegations of a validator

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

Query all outgoing redelegatations of a validator

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.

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

Query a redelegation record

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

stafihubd query staking redelegations

Query all redelegations records of a delegator

stafihubd query staking redelegations <iaa...>

stafihubd query staking pool

Query the current staking pool values

stafihubd query staking pool

Example Output:

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

stafihubd query staking params

stafihubd query staking historical-info

Query historical info at given height

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.

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

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.

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

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.

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

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

stafihubd tx staking unbond

Unbond tokens from a validator.

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

Unbond some tokens from a validator

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

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

Redelegate some tokens to another validator

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