staking

The staking module provides a set of subcommands to query the 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

junod query staking validator

Query a validator by validator address

Query information for validator address <junovaloper...>:

junod query staking validator <junovaloper...>

Will return something similar to:

commission:
  commission_rates:
    max_change_rate: "0.010000000000000000"
    max_rate: "0.200000000000000000"
    rate: "0.110000000000000000"
  update_time: "2021-07-01T09:06:42.110582713Z"
consensus_pubkey:
  '@type': /cosmos.crypto.ed25519.PubKey
  key: +vZPP6QFMUUkCO+MyMdOZGUzuNLAB98ruw6Rjfvnk60=
delegator_shares: "10647850539.181674918343698393"
description:
  details: ""
  identity: FEE30F35994C320D
  moniker: nullmames
  security_contact: ""
  website: ""
jailed: false
min_self_delegation: "1"
operator_address: junovaloper1ludczrvlw36fkur9vy49lx4vjqhppn30ggunj3
status: BOND_STATUS_BONDED
tokens: "10331782033"
unbonding_height: "631804"
unbonding_time: "2021-08-25T00:26:38.283926951Z"

junod query staking validators

Query all validators

The following will return information for ALL validators:

junod query staking validators

The returned values will be similar to those from junod query staking validator``

junod query staking delegation

Query a delegation based on delegator address and validator address.

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

Query a delegation

The following will return delegations for a delegator to a particular validator address <junovaloper...> :

junod query staking delegation <juno...> <junovaloper...>

Returns something similar to:

balance:
  amount: "9159423104"
  denom: ujuno
delegation:
  delegator_address: juno1ludczrvlw36fkur9vy49lx4vjqhppn30h42ufg
  shares: "9439626961.941610808328957187"
  validator_address: junovaloper1ludczrvlw36fkur9vy49lx4vjqhppn30ggunj3

junod query staking delegations

Query all delegations delegated from one delegator.

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

Query all delegations of a delegator

The following command will return all delegations from a delegators address <juno...>:

junod query staking delegations <juno...>

Will return something similar to:

delegation_responses:
- balance:
    amount: "1100000"
    denom: ujuno
  delegation:
    delegator_address: juno1ludczrvlw36fkur9vy49lx4vjqhppn30h42ufg
    shares: "1100000.000000000000000000"
    validator_address: junovaloper1ms8tvfkerhyf6mca2qc79t7mr3eh9dsr79mjf2
- balance:
    amount: "9166092794"
    denom: ujuno
  delegation:
    delegator_address: juno1ludczrvlw36fkur9vy49lx4vjqhppn30h42ufg
    shares: "9446500690.213833508382324426"
    validator_address: junovaloper1ludczrvlw36fkur9vy49lx4vjqhppn30ggunj3
pagination:
  next_key: null
  total: "0"

junod query staking delegations-to

Query all delegations to one validator.

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

Query all delegations to one validator

The following command will return all delegations to a validator address <junovaloper...>:

junod query staking delegations-to <junovaloper...>

Will return something similar to:

delegation_responses:
- balance:
    amount: "990000675"
    denom: ujuno
  delegation:
    delegator_address: juno1qnshaxp9w7aecthj2sn4c0uct07urg3tsd2rqs
    shares: "1020286644.656983874857994825"
    validator_address: junovaloper1ludczrvlw36fkur9vy49lx4vjqhppn30ggunj3
- balance:
    amount: "180180122"
    denom: ujuno
  delegation:
    delegator_address: juno1na45quuuzuv5xtzl5qqp9zep9rkluqykwtcgd3
    shares: "185692169.327571065224155062"
    validator_address: junovaloper1ludczrvlw36fkur9vy49lx4vjqhppn30ggunj3

junod query staking unbonding-delegation

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

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

Query an unbonding delegation record

junod query staking unbonding-delegation <juno...> <junovaloper...>

junod query staking unbonding-delegations

Query all unbonding delegations records of a delegator

junod query staking unbonding-delegations <juno...>

junod query staking unbonding-delegations-from

Query all unbonding delegations from a validator

junod query staking unbonding-delegations-from <junovaloper...>

junod query staking redelegations-from

Query all outgoing redelegations of a validator

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

Query all outgoing redelegatations of a validator

junod query staking redelegations-from <junovaloper...>

junod query staking redelegation

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

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

Query a redelegation record

junod query staking redelegation <juno...> <junovaloper...> <junovaloper...>

junod query staking redelegations

Query all redelegations records of a delegator

junod query staking redelegations <juno...>

junod query staking pool

Query the current staking pool values

junod query staking pool

Returns something similar to:

bonded_tokens: "1547447152807"
not_bonded_tokens: "67232814293"

junod query staking params

Query the current staking parameters information

junod query staking params

Returns something similar to:

bond_denom: ujuno
historical_entries: 10000
max_entries: 7
max_validators: 125
unbonding_time: 1814400s

junod query staking historical-info

Query historical info at given height

junod query staking historical-info <height>

junod tx staking create-validator

Send a transaction to apply to be a validator and delegate a certain amount of juno to it.

junod 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

junod tx staking create-validator --chain-id=juno --from=<key-name> --fees=0.025juno --pubkey=<validator-pubKey> --commission-rate=0.1 --amount=100000000ujuno --moniker=<validator-name>

TIP

Refer to mainnet instructions for detailed information.

junod tx staking edit-validator

Edit an existing validator's settings, such as commission rate, name, etc.

junod 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

junod tx staking edit-validator --from=<key-name> --chain-id=juno --fees=1juno --commission-rate=0.10 --moniker=<validator-name>

junod tx staking delegate

Delegate tokens to a validator.

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

junod tx staking delegate <junovaloper...> <amount> --chain-id=juno --from=<key-name>

junod tx staking unbond

Unbond tokens from a validator.

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

Unbond some tokens from a validator

junod tx staking unbond <junovaloper...> 1000000ujuno --from=<key-name> --chain-id=juno 

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

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

Redelegate some tokens to another validator

junod tx staking redelegate <junovaloper...> <junovaloper...> 1000000ujuno --chain-id=juno --from=<key-name>