package cosmos.staking.v1beta1

Get desktop application:
View/edit binary Protocol Buffers messages

Msg defines the staking Msg service.

• rpc CreateValidator (MsgCreateValidator, MsgCreateValidatorResponse)

  tx.proto:19

  CreateValidator defines a method for creating a new validator.

  message MsgCreateValidator

  tx.proto:38

  MsgCreateValidator defines a SDK message for creating a new validator.

  • optional Description description = 1

  • optional CommissionRates commission = 2

  • string min_self_delegation = 3

  • string delegator_address = 4

  • string validator_address = 5

  • optional google.protobuf.Any pubkey = 6

  • optional base.v1beta1.Coin value = 7

  message MsgCreateValidatorResponse

  tx.proto:62

  MsgCreateValidatorResponse defines the Msg/CreateValidator response type.

  (message has no fields)

• rpc EditValidator (MsgEditValidator, MsgEditValidatorResponse)

  tx.proto:22

  EditValidator defines a method for editing an existing validator.

  message MsgEditValidator

  tx.proto:65

  MsgEditValidator defines a SDK message for editing an existing validator.

  • optional Description description = 1

  • string validator_address = 2

  • string commission_rate = 3

    We pass a reference to the new commission rate and min self delegation as it's not mandatory to update. If not updated, the deserialized rate will be zero with no way to distinguish if an update was intended. REF: #2373

  • string min_self_delegation = 4

  message MsgEditValidatorResponse

  tx.proto:85

  MsgEditValidatorResponse defines the Msg/EditValidator response type.

  (message has no fields)

• rpc Delegate (MsgDelegate, MsgDelegateResponse)

  tx.proto:26

  Delegate defines a method for performing a delegation of coins from a delegator to a validator.

  message MsgDelegate

  tx.proto:89

  MsgDelegate defines a SDK message for performing a delegation of coins from a delegator to a validator.

  • string delegator_address = 1

  • string validator_address = 2

  • optional base.v1beta1.Coin amount = 3

  message MsgDelegateResponse

  tx.proto:101

  MsgDelegateResponse defines the Msg/Delegate response type.

  (message has no fields)

• rpc BeginRedelegate (MsgBeginRedelegate, MsgBeginRedelegateResponse)

  tx.proto:30

  BeginRedelegate defines a method for performing a redelegation of coins from a delegator and source validator to a destination validator.

  message MsgBeginRedelegate

  tx.proto:105

  MsgBeginRedelegate defines a SDK message for performing a redelegation of coins from a delegator and source validator to a destination validator.

  • string delegator_address = 1

  • string validator_src_address = 2

  • string validator_dst_address = 3

  • optional base.v1beta1.Coin amount = 4

  message MsgBeginRedelegateResponse

  tx.proto:118

  MsgBeginRedelegateResponse defines the Msg/BeginRedelegate response type.

  • optional google.protobuf.Timestamp completion_time = 1

• rpc Undelegate (MsgUndelegate, MsgUndelegateResponse)

  tx.proto:34

  Undelegate defines a method for performing an undelegation from a delegate and a validator.

  message MsgUndelegate

  tx.proto:124

  MsgUndelegate defines a SDK message for performing an undelegation from a delegate and a validator.

  • string delegator_address = 1

  • string validator_address = 2

  • optional base.v1beta1.Coin amount = 3

  message MsgUndelegateResponse

  tx.proto:136

  MsgUndelegateResponse defines the Msg/Undelegate response type.

  • optional google.protobuf.Timestamp completion_time = 1

AuthorizationType defines the type of staking module authorization type Since: cosmos-sdk 0.43

Used in: StakeAuthorization

• AUTHORIZATION_TYPE_UNSPECIFIED = 0

  AUTHORIZATION_TYPE_UNSPECIFIED specifies an unknown authorization type

• AUTHORIZATION_TYPE_DELEGATE = 1

  AUTHORIZATION_TYPE_DELEGATE defines an authorization type for Msg/Delegate

• AUTHORIZATION_TYPE_UNDELEGATE = 2

  AUTHORIZATION_TYPE_UNDELEGATE defines an authorization type for Msg/Undelegate

• AUTHORIZATION_TYPE_REDELEGATE = 3

  AUTHORIZATION_TYPE_REDELEGATE defines an authorization type for Msg/BeginRedelegate

BondStatus is the status of a validator.

Used in: Validator

• BOND_STATUS_UNSPECIFIED = 0

  UNSPECIFIED defines an invalid validator status.

• BOND_STATUS_UNBONDED = 1

  UNBONDED defines a validator that is not bonded.

• BOND_STATUS_UNBONDING = 2

  UNBONDING defines a validator that is unbonding.

• BOND_STATUS_BONDED = 3

  BONDED defines a validator that is bonded.

Commission defines commission parameters for a given validator.

Used in: Validator

• optional CommissionRates commission_rates = 1

  commission_rates defines the initial commission rates to be used for creating a validator.

• optional google.protobuf.Timestamp update_time = 2

  update_time is the last time the commission rate was changed.

CommissionRates defines the initial commission rates to be used for creating a validator.

Used in: Commission, MsgCreateValidator

• string rate = 1

  rate is the commission rate charged to delegators, as a fraction.

• string max_rate = 2

  max_rate defines the maximum commission rate which validator can ever charge, as a fraction.

• string max_change_rate = 3

  max_change_rate defines the maximum daily increase of the validator commission, as a fraction.

DVPair is struct that just has a delegator-validator pair with no other data. It is intended to be used as a marshalable pointer. For example, a DVPair can be used to construct the key to getting an UnbondingDelegation from state.

Used in: DVPairs

• string delegator_address = 1

• string validator_address = 2

DVPairs defines an array of DVPair objects.

• repeated DVPair pairs = 1

DVVTriplet is struct that just has a delegator-validator-validator triplet with no other data. It is intended to be used as a marshalable pointer. For example, a DVVTriplet can be used to construct the key to getting a Redelegation from state.

Used in: DVVTriplets

• string delegator_address = 1

• string validator_src_address = 2

• string validator_dst_address = 3

DVVTriplets defines an array of DVVTriplet objects.

• repeated DVVTriplet triplets = 1

Delegation represents the bond with tokens held by an account. It is owned by one delegator, and is associated with the voting power of one validator.

Used in: DelegationResponse, GenesisState

• string delegator_address = 1

  delegator_address is the bech32-encoded address of the delegator.

• string validator_address = 2

  validator_address is the bech32-encoded address of the validator.

• string shares = 3

  shares define the delegation shares received.

DelegationResponse is equivalent to Delegation except that it contains a balance in addition to shares which is more suitable for client responses.

• optional Delegation delegation = 1

• optional base.v1beta1.Coin balance = 2

Description defines a validator description.

Used in: MsgCreateValidator, MsgEditValidator, Validator

• string moniker = 1

  moniker defines a human-readable name for the validator.

• string identity = 2

  identity defines an optional identity signature (ex. UPort or Keybase).

• string website = 3

  website defines an optional website link.

• string security_contact = 4

  security_contact defines an optional email for security contact.

• string details = 5

  details define other optional details.

GenesisState defines the staking module's genesis state.

• optional Params params = 1

  params defines all the paramaters of related to deposit.

• bytes last_total_power = 2

  last_total_power tracks the total amounts of bonded tokens recorded during the previous end block.

• repeated LastValidatorPower last_validator_powers = 3

  last_validator_powers is a special index that provides a historical list of the last-block's bonded validators.

• repeated Validator validators = 4

  delegations defines the validator set at genesis.

• repeated Delegation delegations = 5

  delegations defines the delegations active at genesis.

• repeated UnbondingDelegation unbonding_delegations = 6

  unbonding_delegations defines the unbonding delegations active at genesis.

• repeated Redelegation redelegations = 7

  redelegations defines the redelegations active at genesis.

• bool exported = 8

HistoricalInfo contains header and validator information for a given block. It is stored as part of staking module's state, which persists the `n` most recent HistoricalInfo (`n` is set by the staking module's `historical_entries` parameter).

• optional tendermint.types.Header header = 1

• repeated Validator valset = 2

LastValidatorPower required for validator set update logic.

Used in: GenesisState

• string address = 1

  address is the address of the validator.

• int64 power = 2

  power defines the power of the validator.

Params defines the parameters for the staking module.

Used in: GenesisState

• optional google.protobuf.Duration unbonding_time = 1

  unbonding_time is the time duration of unbonding.

• uint32 max_validators = 2

  max_validators is the maximum number of validators.

• uint32 max_entries = 3

  max_entries is the max entries for either unbonding delegation or redelegation (per pair/trio).

• uint32 historical_entries = 4

  historical_entries is the number of historical entries to persist.

• string bond_denom = 5

  bond_denom defines the bondable coin denomination.

• string min_commission_rate = 6

  min_commission_rate is the chain-wide minimum commission rate that a validator can charge their delegators

Pool is used for tracking bonded and not-bonded token supply of the bond denomination.

• string not_bonded_tokens = 1

• string bonded_tokens = 2

Redelegation contains the list of a particular delegator's redelegating bonds from a particular source validator to a particular destination validator.

Used in: GenesisState, RedelegationResponse

• string delegator_address = 1

  delegator_address is the bech32-encoded address of the delegator.

• string validator_src_address = 2

  validator_src_address is the validator redelegation source operator address.

• string validator_dst_address = 3

  validator_dst_address is the validator redelegation destination operator address.

• repeated RedelegationEntry entries = 4

  entries are the redelegation entries.

  redelegation entries

RedelegationEntry defines a redelegation object with relevant metadata.

Used in: Redelegation, RedelegationEntryResponse

• int64 creation_height = 1

  creation_height defines the height which the redelegation took place.

• optional google.protobuf.Timestamp completion_time = 2

  completion_time defines the unix time for redelegation completion.

• string initial_balance = 3

  initial_balance defines the initial balance when redelegation started.

• string shares_dst = 4

  shares_dst is the amount of destination-validator shares created by redelegation.

RedelegationEntryResponse is equivalent to a RedelegationEntry except that it contains a balance in addition to shares which is more suitable for client responses.

Used in: RedelegationResponse

• optional RedelegationEntry redelegation_entry = 1

• string balance = 4

RedelegationResponse is equivalent to a Redelegation except that its entries contain a balance in addition to shares which is more suitable for client responses.

• optional Redelegation redelegation = 1

• repeated RedelegationEntryResponse entries = 2

StakeAuthorization defines authorization for delegate/undelegate/redelegate. Since: cosmos-sdk 0.43

• optional base.v1beta1.Coin max_tokens = 1

  max_tokens specifies the maximum amount of tokens can be delegate to a validator. If it is empty, there is no spend limit and any amount of coins can be delegated.

• oneof validators

  validators is the oneof that represents either allow_list or deny_list

  • StakeAuthorization.Validators allow_list = 2

    allow_list specifies list of validator addresses to whom grantee can delegate tokens on behalf of granter's account.

  • StakeAuthorization.Validators deny_list = 3

    deny_list specifies list of validator addresses to whom grantee can not delegate tokens.

• AuthorizationType authorization_type = 4

  authorization_type defines one of AuthorizationType.

Validators defines list of validator addresses.

Used in: StakeAuthorization

• repeated string address = 1

UnbondingDelegation stores all of a single delegator's unbonding bonds for a single validator in an time-ordered list.

Used in: GenesisState

• string delegator_address = 1

  delegator_address is the bech32-encoded address of the delegator.

• string validator_address = 2

  validator_address is the bech32-encoded address of the validator.

• repeated UnbondingDelegationEntry entries = 3

  entries are the unbonding delegation entries.

  unbonding delegation entries

UnbondingDelegationEntry defines an unbonding object with relevant metadata.

Used in: UnbondingDelegation

• int64 creation_height = 1

  creation_height is the height which the unbonding took place.

• optional google.protobuf.Timestamp completion_time = 2

  completion_time is the unix time for unbonding completion.

• string initial_balance = 3

  initial_balance defines the tokens initially scheduled to receive at completion.

• string balance = 4

  balance defines the tokens to receive at completion.

ValAddresses defines a repeated set of validator addresses.

• repeated string addresses = 1

Validator defines a validator, together with the total amount of the Validator's bond shares and their exchange rate to coins. Slashing results in a decrease in the exchange rate, allowing correct calculation of future undelegations without iterating over delegators. When coins are delegated to this validator, the validator is credited with a delegation whose number of bond shares is based on the amount of coins delegated divided by the current exchange rate. Voting power can be calculated as total bonded shares multiplied by exchange rate.

Used in: GenesisState, HistoricalInfo

• string operator_address = 1

  operator_address defines the address of the validator's operator; bech encoded in JSON.

• optional google.protobuf.Any consensus_pubkey = 2

  consensus_pubkey is the consensus public key of the validator, as a Protobuf Any.

• bool jailed = 3

  jailed defined whether the validator has been jailed from bonded status or not.

• BondStatus status = 4

  status is the validator status (bonded/unbonding/unbonded).

• string tokens = 5

  tokens define the delegated tokens (incl. self-delegation).

• string delegator_shares = 6

  delegator_shares defines total shares issued to a validator's delegators.

• optional Description description = 7

  description defines the description terms for the validator.

• int64 unbonding_height = 8

  unbonding_height defines, if unbonding, the height at which this validator has begun unbonding.

• optional google.protobuf.Timestamp unbonding_time = 9

  unbonding_time defines, if unbonding, the min time for the validator to complete unbonding.

• optional Commission commission = 10

  commission defines the commission parameters.

• string min_self_delegation = 11

  min_self_delegation is the validator's self declared minimum self delegation.