Staking

Search…

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

rVote

Next - Chain

gRPC, REST, and Tendermint Endpoints

Last modified 5mo ago

Copy link

On this page

Available Commands

stafihubd query staking validator

Query a validator by validator address

stafihubd query staking validators

Query all validators

stafihubd query staking delegation

Query a delegation

stafihubd query staking delegations

Query all delegations of a delegator

stafihubd query staking delegations-to

Query all delegations to one validator

stafihubd query staking unbonding-delegation

Query an unbonding delegation record

stafihubd query staking unbonding-delegations

Query all unbonding delegations records of a delegator

stafihubd query staking unbonding-delegations-from

Query all unbonding delegations from a validator

stafihubd query staking redelegations-from

Query all outgoing redelegatations of a validator

stafihubd query staking redelegation

Query a redelegation record

stafihubd query staking redelegations

Query all redelegations records of a delegator

stafihubd query staking pool

Query the current staking pool values

stafihubd query staking params

Query the current staking parameters information

stafihubd query staking historical-info

Query historical info at given height

stafihubd tx staking create-validator

Create a validator

stafihubd tx staking edit-validator

Edit validator information

Upload validator avatar

stafihubd tx staking delegate

stafihubd tx staking unbond

Unbond some tokens from a validator

stafihubd tx staking redelegate

Redelegate some tokens to another validator