Staking

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

Available Commands

NameDescription

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, shorthandtypeRequiredDefaultDescription

--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, shorthandtypeRequiredDefaultDescription

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