package crescent.liquidstaking.v1beta1

Get desktop application:
View/edit binary Protocol Buffers messages

Msg defines the liquid staking Msg service.

• rpc LiquidStake (MsgLiquidStake, MsgLiquidStakeResponse)

  tx.proto:16

  LiquidStake defines a method for performing a delegation of coins from a delegator to whitelisted validators.

  message MsgLiquidStake

  tx.proto:25

  MsgLiquidStake defines a SDK message for performing a liquid stake of coins from a delegator to whitelisted validators.

  • string delegator_address = 1

  • optional cosmos.base.v1beta1.Coin amount = 2

  message MsgLiquidStakeResponse

  tx.proto:34

  MsgLiquidStakeResponse defines the Msg/LiquidStake response type.

  (message has no fields)

• rpc LiquidUnstake (MsgLiquidUnstake, MsgLiquidUnstakeResponse)

  tx.proto:20

  LiquidUnstake defines a method for performing an undelegation of liquid staking from a delegate.

  message MsgLiquidUnstake

  tx.proto:38

  MsgLiquidUnstake defines a SDK message for performing an undelegation of liquid staking from a delegate.

  • string delegator_address = 1

  • optional cosmos.base.v1beta1.Coin amount = 2

  message MsgLiquidUnstakeResponse

  tx.proto:47

  MsgLiquidUnstakeResponse defines the Msg/LiquidUnstake response type.

  • optional google.protobuf.Timestamp completion_time = 1

Query defines the gRPC query service for the liquidstaking module.

• rpc LiquidValidators (QueryLiquidValidatorsRequest, QueryLiquidValidatorsResponse)

  query.proto:25

  LiquidValidators returns liquid validators with states of the liquidstaking module.

  message QueryLiquidValidatorsRequest

  query.proto:69

  QueryLiquidValidatorsRequest is the request type for the Query/LiquidValidators RPC method.

  (message has no fields)

  message QueryLiquidValidatorsResponse

  query.proto:72

  QueryLiquidValidatorsResponse is the response type for the Query/LiquidValidators RPC method.

  • repeated LiquidValidatorState liquid_validators = 1

• rpc Params (QueryParamsRequest, QueryParamsResponse)

  query.proto:14

  Params returns parameters of the liquidstaking module.

  message QueryParamsRequest

  query.proto:61

  QueryParamsRequest is the request type for the Query/Params RPC method.

  (message has no fields)

  message QueryParamsResponse

  query.proto:64

  QueryParamsResponse is the response type for the Query/Params RPC method.

  • optional Params params = 1

• rpc States (QueryStatesRequest, QueryStatesResponse)

  query.proto:48

  States returns states of the liquidstaking module.

  message QueryStatesRequest

  query.proto:77

  QueryStatesRequest is the request type for the Query/States RPC method.

  (message has no fields)

  message QueryStatesResponse

  query.proto:80

  QueryStatesResponse is the response type for the Query/States RPC method.

  • optional NetAmountState net_amount_state = 1

• rpc VotingPower (QueryVotingPowerRequest, QueryVotingPowerResponse)

  query.proto:36

  VotingPower returns voting power of staking and liquid staking module's of the voter that can be exercised.

  message QueryVotingPowerRequest

  query.proto:85

  QueryVotingPowerRequest is the request type for the Query/States RPC method.

  • string voter = 1

  message QueryVotingPowerResponse

  query.proto:90

  QueryVotingPowerResponse is the response type for the Query/States RPC method.

  • optional VotingPower voting_power = 1

GenesisState defines the liquidstaking module's genesis state.

• optional Params params = 1

  params defines all the parameters for the liquidstaking module

• repeated LiquidValidator liquid_validators = 2

LiquidValidator defines a Validator that can be the target of LiquidStaking and LiquidUnstaking, Active, Weight, etc. fields are derived as functions to deal with by maintaining consistency with the state of the staking module.

Used in: GenesisState

• string operator_address = 1

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

LiquidValidatorState is type LiquidValidator with state added to return to query results.

Used in: QueryLiquidValidatorsResponse

• string operator_address = 1

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

• string weight = 2

  weight specifies the weight for liquid staking, unstaking amount

• ValidatorStatus status = 3

  status is the liquid validator status

• string del_shares = 4

  del_shares define the delegation shares of the validator

• string liquid_tokens = 5

  liquid_tokens define the token amount worth of delegation shares of the validator (slashing applied amount)

NetAmountState is type for net amount raw data and mint rate, This is a value that depends on the several module state every time, so it is used only for calculation and query and is not stored in kv.

Used in: QueryStatesResponse

• string mint_rate = 1

  mint_rate is bTokenTotalSupply / NetAmount

• string btoken_total_supply = 2

  btoken_total_supply returns the total supply of btoken(liquid_bond_denom)

• string net_amount = 3

  net_amount is proxy account's native token balance + total liquid tokens + total remaining rewards + total unbonding balance

• string total_del_shares = 4

  total_del_shares define the delegation shares of all liquid validators

• string total_liquid_tokens = 5

  total_liquid_tokens define the token amount worth of delegation shares of all liquid validator (slashing applied amount)

• string total_remaining_rewards = 6

  total_remaining_rewards define the sum of remaining rewards of proxy account by all liquid validators

• string total_unbonding_balance = 7

  total_unbonding_balance define the unbonding balance of proxy account by all liquid validator (slashing applied amount)

• string proxy_acc_balance = 8

  proxy_acc_balance define the balance of proxy account for the native token

Params defines the set of params for the liquidstaking module.

Used in: GenesisState, QueryParamsResponse

• string liquid_bond_denom = 1

  LiquidBondDenom specifies the denomination of the token receiving after LiquidStaking, The value is calculated through NetAmount.

• repeated WhitelistedValidator whitelisted_validators = 2

  WhitelistedValidators specifies the validators elected to become Active Liquid Validators.

• string unstake_fee_rate = 3

  UnstakeFeeRate specifies the fee rate when liquid unstake is requested, unbonded by subtracting it from unbondingAmount

• string min_liquid_staking_amount = 5

  MinLiquidStakingAmount specifies the minimum number of coins to be staked to the active liquid validators on liquid staking to minimize decimal loss and consider gas efficiency.

ValidatorStatus enumerates the status of a liquid validator.

Used in: LiquidValidatorState

• VALIDATOR_STATUS_UNSPECIFIED = 0

  VALIDATOR_STATUS_UNSPECIFIED defines the unspecified invalid status.

• VALIDATOR_STATUS_ACTIVE = 1

  VALIDATOR_STATUS_ACTIVE defines the active, valid status

• VALIDATOR_STATUS_INACTIVE = 2

  VALIDATOR_STATUS_INACTIVE defines the inactive, invalid status

VotingPower is type for current voting power of the voter including staking module's voting power and liquid staking module's voting power, It depends on the amount of delegation of staking module, the bonded state of the delegated validator, the value of btoken(liquid_bond_denom), and the pool coin and farming position containing btoken..

Used in: QueryVotingPowerResponse

• string voter = 1

  voter defines the address of the voter; bech encoded in JSON.

• string staking_voting_power = 2

  staking_voting_power return the voting power of staking that can be exercised.

• string liquid_staking_voting_power = 3

  liquid_staking_voting_power return the voting power of liquid staking that can be exercised.

• string validator_voting_power = 4

  validator_voting_power return the voting power of the validator if the voter is the validator operator that can be exercised.

WhitelistedValidator consists of the validator operator address and the target weight, which is a value for calculating the real weight to be derived according to the active status. In the case of inactive, it is calculated as zero.

Used in: Params

• string validator_address = 1

  validator_address defines the bech32-encoded address that whitelisted validator

• string target_weight = 2

  target_weight specifies the target weight for liquid staking, unstaking amount, which is a value for calculating the real weight to be derived according to the active status