Client

CLI

A user can query and interact with the staking module using the CLI.

Query

The query commands allows users to query staking state.

simd query staking --help

Example:

simd query staking delegation cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj

Example Output:

balance:
  amount: "10000000000"
  denom: stake
delegation:
  delegator_address: cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p
  shares: "10000000000.000000000000000000"
  validator_address: cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj

delegations

The delegations command allows users to query delegations for an individual delegator on all validators.

Usage:

Example:

Example Output:

delegations-to

The delegations-to command allows users to query delegations on an individual validator.

Usage:

Example:

Example Output:

historical-info

The historical-info command allows users to query historical information at given height.

Usage:

Example:

Example Output:

params

The params command allows users to query values set as staking parameters.

Usage:

Example:

Example Output:

pool

The pool command allows users to query values for amounts stored in the staking pool.

Usage:

Example:

Example Output:

redelegation

The redelegation command allows users to query a redelegation record based on delegator and a source and destination validator address.

Usage:

Example:

Example Output:

redelegations

The redelegations command allows users to query all redelegation records for an individual delegator.

Usage:

Example:

Example Output:

redelegations-from

The redelegations-from command allows users to query delegations that are redelegating from a validator.

Usage:

Example:

Example Output:

unbonding-delegation

The unbonding-delegation command allows users to query unbonding delegations for an individual delegator on an individual validator.

Usage:

Example:

Example Output:

unbonding-delegations

The unbonding-delegations command allows users to query all unbonding-delegations records for one delegator.

Usage:

Example:

Example Output:

unbonding-delegations-from

The unbonding-delegations-from command allows users to query delegations that are unbonding from a validator.

Usage:

Example:

Example Output:

validator

The validator command allows users to query details about an individual validator.

Usage:

Example:

Example Output:

validators

The validators command allows users to query details about all validators on a network.

Usage:

Example:

Example Output:

Transactions

The tx commands allows users to interact with the staking module.

create-validator

The command create-validator allows users to create new validator initialized with a self-delegation to it.

Usage:

Example:

delegate

The command delegate allows users to delegate liquid tokens to a validator.

Usage:

Example:

edit-validator

The command edit-validator allows users to edit an existing validator account.

Usage:

Example:

redelegate

The command redelegate allows users to redelegate illiquid tokens from one validator to another.

Usage:

Example:

unbond

The command unbond allows users to unbond shares from a validator.

Usage:

Example:

cancel unbond

The command cancel-unbond allow users to cancel the unbonding delegation entry and delegate back to the original validator.

Usage:

Example:

gRPC

A user can query the staking module using gRPC endpoints.

Validators

The Validators endpoint queries all validators that match the given status.

Example:

Example Output:

Validator

The Validator endpoint queries validator information for given validator address.

Example:

Example Output:

ValidatorDelegations

The ValidatorDelegations endpoint queries delegate information for given validator.

Example:

Example Output:

ValidatorUnbondingDelegations

The ValidatorUnbondingDelegations endpoint queries delegate information for given validator.

Example:

Example Output:

Delegation

The Delegation endpoint queries delegate information for given validator delegator pair.

Example:

Example Output:

UnbondingDelegation

The UnbondingDelegation endpoint queries unbonding information for given validator delegator.

Example:

Example Output:

DelegatorDelegations

The DelegatorDelegations endpoint queries all delegations of a given delegator address.

Example:

Example Output:

DelegatorUnbondingDelegations

The DelegatorUnbondingDelegations endpoint queries all unbonding delegations of a given delegator address.

Example:

Example Output:

Redelegations

The Redelegations endpoint queries redelegations of given address.

Example:

Example Output:

DelegatorValidators

The DelegatorValidators endpoint queries all validators information for given delegator.

Example:

Example Output:

Validator

The Validator endpoint queries validator information for given validator address.

Example:

Example Output:

ValidatorDelegations

The ValidatorDelegations endpoint queries delegate information for given validator.

Example:

Example Output:

ValidatorUnbondingDelegations

The ValidatorUnbondingDelegations endpoint queries delegate information for given validator.

Example:

Example Output:

Delegation

The Delegation endpoint queries delegate information for given validator delegator pair.

Example:

Example Output:

UnbondingDelegation

The UnbondingDelegation endpoint queries unbonding information for given validator delegator.

Example:

Example Output:

DelegatorDelegations

The DelegatorDelegations endpoint queries all delegations of a given delegator address.

Example:

Example Output:

DelegatorUnbondingDelegations

The DelegatorUnbondingDelegations endpoint queries all unbonding delegations of a given delegator address.

Example:

Example Output:

Redelegations

The Redelegations endpoint queries redelegations of given address.

Example:

Example Output:

DelegatorValidators

The DelegatorValidators endpoint queries all validators information for given delegator.

Example:

Example Output:

DelegatorValidator

The DelegatorValidator endpoint queries validator information for given delegator validator

Example:

Example Output:

HistoricalInfo

Example:

Example Output:

Pool

The Pool endpoint queries the pool information.

Example:

Example Output:

Params

The Params endpoint queries the pool information.

Example:

Example Output:

REST

A user can query the staking module using REST endpoints.

DelegatorDelegations

The DelegtaorDelegations REST endpoint queries all delegations of a given delegator address.

Example:

Example Output:

Redelegations

The Redelegations REST endpoint queries redelegations of given address.

Example:

Example Output:

DelegatorUnbondingDelegations

The DelegatorUnbondingDelegations REST endpoint queries all unbonding delegations of a given delegator address.

Example:

Example Output:

DelegatorValidators

The DelegatorValidators REST endpoint queries all validators information for given delegator address.

Example:

Example Output:

DelegatorValidator

The DelegatorValidator REST endpoint queries validator information for given delegator validator pair.

Example

Example Output:

HistoricalInfo

The HistoricalInfo REST endpoint queries the historical information for given height.

Example:

Example Output:

Parameters

The Parameters REST endpoint queries the staking parameters.

Example:

Example Output:

Pool

The Pool REST endpoint queries the pool information.

Example:

Example Output:

Validators

The Validators REST endpoint queries all validators that match the given status.

Example:

Example Output:

Validator

The Validator REST endpoint queries validator information for given validator address.

Example:

Example Output:

ValidatorDelegations

The ValidatorDelegations REST endpoint queries delegate information for given validator.

Example:

Example Output:

Delegation

The Delegation REST endpoint queries delegate information for given validator delegator pair.

Example:

Example Output:

UnbondingDelegation

The UnbondingDelegation REST endpoint queries unbonding information for given validator delegator pair.

Example:

Example Output:

ValidatorUnbondingDelegations

The ValidatorUnbondingDelegations REST endpoint queries unbonding delegations of a validator.

Example:

Example Output:

Last updated