WebsiteDiscordGithub
Edit

Delegating

On mainnet, you can delegate uscrt to a validator. These delegators can receive part of the validator's fee revenue. To learn more read about the Cosmos Token Model.

Query Validators

You can query the list of all validators of a specific chain:

secretcli q staking validators

If you want to get the information of a single validator you can check it with:

secretcli q staking validator <validator-address>

Note: _ A list of validators on the pulsar-3 Secret Network testnet can be found here._

Bond Tokensw

On the Secret Network mainnet, we delegate uscrt, where 1scrt = 1000000uscrt. Here's how you can bond tokens to a validator (i.e. delegate):

secretcli tx staking delegate \
	<validator-operator-address>
	<amount> \
	--from=<key-alias>

Example:

secretcli tx staking delegate \
	secretvaloper1l2rsakp388kuv9k8qzq6lrm9taddae7fpx59wm \
	1000uscrt \
	--from <key-alias>

<validator-operator-address> is the operator address of the validator to which you intend to delegate. If you are running a full node, you can find this with:

Where <key-alias> is the name of the key you specified when you initialized secretd.

While tokens are bonded, they are pooled with all the other bonded tokens in the network. Validators and delegators obtain a percentage of shares that equal their stake in this pool.

Withdraw Rewards

To withdraw the delegator rewards:

Query Delegations

Once you've submitted a delegation to a validator, you can see it's information by using the following command:

Example:

Or if you want to check all your current delegations with distinct validators:

Unbond Tokens

There currently is in place a 21 days unbonding rule, during which no rewards are handed out.

If for any reason the validator misbehaves, or you just want to unbond a certain amount of tokens, use this following command:

The unbonding will be automatically completed when the unbonding period passes.

Query Unbonding-Delegations

Once you begin an unbonding-delegation, you can see it's information by using the following command:

Or if you want to check all your current unbonding-delegations with distinct validators:

Additionally, you can get all the unbonding-delegations from a particular validator:

Redelegate Tokens

A redelegation is a type delegation that allows you to bond illiquid tokens from one validator to another:

Here you can also redelegate a specific shares-amount or a shares-fraction with the corresponding flags.

The redelegation will be automatically completed when the unbonding period has passed.

Query Redelegations

Once you begin an redelegation, you can see it's information by using the following command:

Or if you want to check all your current unbonding-delegations with distinct validators:

Additionally, you can get all the outgoing redelegations from a particular validator:

Query Parameters

Parameters define high level settings for staking. You can get the current values by using:

With the above command you will get the values for:

  • Unbonding time

  • Maximum numbers of validators

  • Coin denomination for staking

Example:

All these values will be subject to updates though a governance process by ParameterChange proposals.

Query Pool

A staking Pool defines the dynamic parameters of the current state. You can query them with the following command:

With the pool command you will get the values for:

  • Not-bonded and bonded tokens

  • Token supply

  • Current annual inflation and the block in which the last inflation was processed

  • Last recorded bonded shares

Query Delegations To Validator

You can also query all of the delegations to a particular validator:

Example:

\

PreviousMintingNextRestake

Last updated

Was this helpful?