| description |
|---|
The staking module provides a set of subcommands to query the staking state and send staking transactions. |
| 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 |
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"
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``
Query a delegation based on delegator address and validator address.
junod query staking delegation [delegator-addr] [validator-addr]
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
Query all delegations delegated from one delegator.
junod query staking delegations [delegator-address] [flags]
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"
Query all delegations to one validator.
junod query staking delegations-to [validator-address] [flags]
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
Query an unbonding-delegation record based on delegator and validator address.
junod query staking unbonding-delegation [delegator-addr] [validator-addr] [flags]
junod query staking unbonding-delegation <juno...> <junovaloper...>
junod query staking unbonding-delegations <juno...>
junod query staking unbonding-delegations-from <junovaloper...>
Query all outgoing redelegations of a validator
junod query staking redelegations-from [validator-address] [flags]
junod query staking redelegations-from <junovaloper...>
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]
junod query staking redelegation <juno...> <junovaloper...> <junovaloper...>
junod query staking redelegations <juno...>
junod query staking pool
Returns something similar to:
bonded_tokens: "1547447152807"
not_bonded_tokens: "67232814293"
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 <height>
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 |
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>
{% hint style="info" %} TIP
Refer to mainnet instructions for detailed information. {% endhint %}
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 |
junod tx staking edit-validator --from=<key-name> --chain-id=juno --fees=1juno --commission-rate=0.10 --moniker=<validator-name>
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>
Unbond tokens from a validator.
junod tx staking unbond [validator-addr] [amount] [flags]
junod tx staking unbond <junovaloper...> 1000000ujuno --from=<key-name> --chain-id=juno
Transfer delegation from one validator to another.
{% hint style="info" %} 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.
{% endhint %}
junod tx staking redelegate [src-validator-addr] [dst-validator-addr] [amount] [flags]
junod tx staking redelegate <junovaloper...> <junovaloper...> 1000000ujuno --chain-id=juno --from=<key-name>