Staking

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

Available Commands

Name
Description

Query a validator

Query for all validators

Query a delegation based on address and validator address

Query all delegations made from one delegator

Query all delegations to one validator

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

Query all unbonding-delegations records for one delegator

Query all unbonding delegatations from a validator

Query all outgoing redelegatations from a validator

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

Query all redelegations records for one delegator

Query the current staking pool values

Query the current staking parameters information

Query historical info at given height

Create new validator initialized with a self-delegation to it

Edit existing validator account

Delegate liquid tokens to an validator

Unbond shares from a validator

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

Last updated