Comment on page
staking
Staking module provides a set of subcommands to query 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 a validator by validator address
uptickd query staking validator [validator-addr] [flags]
Query all validators
uptickd query staking validators
Query a delegation based on delegator address and validator address.
uptickd query staking delegation [delegator-addr] [validator-addr] [flags]
Query a delegation
uptickd query staking delegation <uptick...> <uptickvaloper...>
Example Output:
Delegation:
Delegator: uptick1e7v3fn2yxxlzpmlgy9232neykpe57gzupas6z6
Validator: uptickvaloper1a3ep09wd27c7av77z90a6l5mlh58unk8qdtw5v
Shares: 1.0000000000000000000000000000
Height: 26
Query all delegations delegated from one delegator.
uptickd query staking delegations [delegator-addr] [flags]
Query all delegations of a delegator
uptickd query staking delegations <uptick...>
Query all delegations to one validator.
uptickd query staking delegations-to [validator-addr] [flags]
Query all delegations to one validator
uptickd query staking delegations-to <uptickvaloper...>
Example Output:
delegation_responses:
- balance:
amount: "1000000000000000000"
denom: auoc
delegation:
delegator_address: uptick1ehh5503n2rhpz8evfqpsa62kfqc58c5g02kjhd
shares: "1000000000000000000.000000000000000000"
validator_address: uptickvaloper1a3ep09wd27c7av77z90a6l5mlh58unk8qdtw5v
- balance:
amount: "300000000000000000000000000"
denom: auoc
delegation:
delegator_address: uptick1a3ep09wd27c7av77z90a6l5mlh58unk8n476cq
shares: "300000000000000000000000000.000000000000000000"
validator_address: uptickvaloper1a3ep09wd27c7av77z90a6l5mlh58unk8qdtw5v
pagination:
next_key: null
total: "0"
Query an unbonding-delegation record based on delegator and validator address.
uptickd query staking unbonding-delegation [delegator-addr] [validator-addr] [flags]
Query an unbonding delegation record
uptickd query staking unbonding-delegation <uptick...> <uptickvaloper...>
Query all unbonding delegations records of a delegator
uptickd query staking unbonding-delegations [delegator-addr] [flags]
Query all unbonding delegations from a validator
uptickd query staking unbonding-delegations-from [validator-addr] [flags]
Query all outgoing redelegations of a validator
uptickd query staking redelegations-from [validator-addr] [flags]
Query all outgoing redelegatations of a validator
uptickd query staking redelegations-from <uptickvaloper...>
Query a redelegation record based on delegator and source validator address and destination validator address.
uptickd query staking redelegation [delegator-addr] [src-validator-addr] [dst-validator-addr] [flags]
Query a redelegation record
uptickd query staking redelegation <uptick...> <uptickvaloper...> <uptickvaloper...>
Query all redelegations records of a delegator
uptickd query staking redelegations [delegator-addr] [flags]
Query the current staking pool values
uptickd query staking pool
Example Output:
bonded_tokens: "300000001000000000000000000"
not_bonded_tokens: "0"
Query the current staking parameters information
uptickd query staking params
Query historical info at given height
uptickd query staking historical-info [height] [flags]
Send a transaction to apply to be a validator and delegate a certain amount of iris to it.
uptickd 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 | The initial commission rate percentage |
--commission-max-rate | float | | 0 | The maximum commission rate percentage |
--commission-max-change-rate | float | | 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
uptickd tx staking create-validator --chain-id=<chain-id> --from=<key-name> --fees=0.3uptick --pubkey=<validator-pubKey> --commission-rate=0.1 --amount=100uptick --moniker=<validator-name>
TIPFollow the Mainnet instructions to learn more.
Edit an existing validator's settings, such as commission rate, name, etc.
uptickd tx staking edit-validator [flags]
Flags:
Name, shorthand | type | Required | Default | Description |
|---|---|---|---|---|
--commission-rate | float | | 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
uptickd tx staking edit-validator --from=<key-name> --chain-id=<chain-id> --fees=0.3uptick --commission-rate=0.10 --moniker=<validator-name>
Upload validator avatarPlease refer to How to upload my validator's logo to the Explorers
Delegate tokens to a validator.
uptickd tx staking delegate [validator-addr] [amount] [flags]
Unbond tokens from a validator.
uptickd tx staking unbond [validator-addr] [amount] [flags]
Transfer delegation from one validator to another.
TIPThere is nounbonding timeduring the redelegation, so you will not miss the rewards. But you can only redelegate once per validator, until a period (=unbonding time) exceed.
uptickd tx staking redelegate [src-validator-addr] [dst-validator-addr] [amount] [flags]
Last modified 5mo ago