> For the complete documentation index, see [llms.txt](https://docs.kryptonite.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kryptonite.finance/developer/seilor-token/staking.md). # Staking Lock LP tokens to obtain veSEILOR tokens. The total amount of rewards is determined based on the configuration of this contract and the boost locking time. LP tokens can be withdrawn in advance, but the rewards cannot be withdrawn until they expire according to the lock. ## Config ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] pub struct StakingConfig { pub gov: Addr, // Immutable variables for staking and rewards tokens pub staking_token: Addr, pub rewards_token: Addr, pub boost: Addr, pub fund: Addr, pub reward_controller_addr: Addr, pub new_gov: Option, } ```
KeyTypeDescription
govAddrThe address of the governance contract
staking_tokenAddrThe address of the token contract to be staked
rewards_tokenAddrThe address of the token contract to be rewarded
boostAddrThe address of contract boost
fundAddrThe address of contract fund
reward_controller_addrAddrThe address controlling the amount of SEILOR token rewards for each mining.
new_gov*AddrThe address of the new governance contract
\* = optional ## InitMsg ```rust #[cw_serde] pub struct InstantiateMsg { pub gov: Option, pub staking_token: Addr, pub rewards_token: Addr, pub boost: Addr, pub fund: Addr, pub reward_controller_addr: Addr, pub duration: Uint128, } ``` ```json { "gov": "sei1...", "staking_token": "sei1...", "rewards_token": "sei1...", "boost": "sei1...", "fund": "sei1...", "reward_controller_addr": "sei1...", "duration": "2592000" } ```
KeyTypeDescription
govAddrThe address of the governance contract
staking_tokenAddrThe address of the token contract to be staked
rewards_tokenAddrThe address of the token contract to be rewarded
boostAddrThe address of contract boost
fundAddrThe address of contract fund
reward_controller_addrAddrThe address controlling the amount of SEILOR token rewards for each mining
durationUint128The duration of this batch mining reward
## ExecuteMsg ### Receive ```rust #[cw_serde] pub enum ExecuteMsg { /// Receives a message of type [`Cw20ReceiveMsg`] Receive(Cw20ReceiveMsg), } #[cw_serde] pub struct Cw20ReceiveMsg { pub sender: String, pub amount: Uint128, pub msg: Binary, } ``` 
{
  "receive": {
    "cw20_receive_msg": {
        "sender": "sei1...",
        "amount": "1000000",
        "msg": "eyJ0eXBlIjoiY3cyMCIsImFtb3VudCI6IjEwMDAwMCJ9"
      }
  }
}
KeyTypeDescription
senderStringThe sender's address
amountUint128Amount to be sent
msgBinaryMessage to be sent
### UpdateStakingConfig ```rust #[cw_serde] pub enum ExecuteMsg { UpdateStakingConfig { config_msg: UpdateStakingConfigStruct, }, } #[cw_serde] pub struct UpdateStakingConfigStruct { pub gov: Option, pub staking_token: Option, pub rewards_token: Option, pub boost: Option, pub fund: Option, pub reward_controller_addr: Option, } ``` 
{
  "update_staking_config": {
    "config_msg": {
          "gov": "sei1...",
          "staking_token": "sei1...",
          "rewards_token": "sei1...",
          "boost": "sei1...",
          "fund": "sei1...",
          "reward_controller_addr": "sei1..."
      }
  }
}
KeyTypeDescription
govAddrThe address of the governance contract
staking_tokenAddrThe address of the token contract to be staked
rewards_tokenAddrThe address of the token contract to be rewarded
boostAddrThe address of contract boost
fundAddrThe address of contract fund
reward_controller_addrAddrThe address controlling the amount of SEILOR token rewards for each mining
### UpdateStakingState ```rust #[cw_serde] pub enum ExecuteMsg { UpdateStakingState { duration: Uint128, }, } ``` ```json { "update_staking_state": { "duration": "2592000" } } ```
KeyTypeDescription
durationUint128The duration of this batch mining reward
### GetReward ```rust #[cw_serde] pub enum ExecuteMsg { GetReward {}, } ``` ```json { "get_reward": {} } ``` ### Withdraw ```rust #[cw_serde] pub enum ExecuteMsg { Withdraw { amount: Uint128, }, } ``` ```json { "withdraw": { "amount": "1000000" } } ```
KeyTypeDescription
amountUint128Amount to be withdrew
### NotifyRewardAmount ```rust #[cw_serde] pub enum ExecuteMsg { NotifyRewardAmount { amount: Uint128, }, } ``` ```json { "notify_reward_amount": { "amount": "1000000" } } ```
KeyTypeDescription
amountUint128The total allocation of mining rewards for this batch
## QueryMsg ```rust #[cw_serde] #[derive(QueryResponses)] pub enum QueryMsg { #[returns(RewardPerTokenResponse)] RewardPerToken {}, } ``` ```json { "reward_per_token": {} } ``` ### RewardPerTokenResponse ```rust #[cw_serde] pub struct RewardPerTokenResponse { pub reward_per_token: Uint128, } ``` ``` { "reward_per_token": "1000000" } ```
KeyTypeDescription
reward_per_tokenUint128The rate of reward for each token
### LastTimeRewardApplicable ```rust #[cw_serde] #[derive(QueryResponses)] pub enum QueryMsg { #[returns(LastTimeRewardApplicableResponse)] LastTimeRewardApplicable {}, } ``` ```json { "last_time_reward_applicable": {} } ``` ### LastTimeRewardApplicableResponse ```rust #[cw_serde] pub struct LastTimeRewardApplicableResponse { pub last_time_reward_applicable: Uint128, } ``` ```json { "last_time_reward_applicable": "1000000" } ```
KeyTypeDescription
last_time_reward_applicableUint128Last time reward applicable
### GetBoost ```rust #[cw_serde] #[derive(QueryResponses)] pub enum QueryMsg { #[returns(GetBoostResponse)] GetBoost { account: Addr }, } ``` ``` { "get_boost": { "account": "sei1..." } } ``` ### GetBoostResponse ```rust #[cw_serde] pub struct GetBoostResponse { pub boost: Uint128, } ``` ``` { "boost": "1000000" } ```
KeyTypeDescription
boostUint128boost value
### Earned ```rust #[cw_serde] #[derive(QueryResponses)] pub enum QueryMsg { #[returns(EarnedResponse)] Earned { account: Addr }, } ``` ```json { "earned": { "account": "sei1..." } } ```
KeyTypeDescription
accountAddrThe user's address
### EarnedResponse ```rust #[cw_serde] pub struct EarnedResponse { pub earned: Uint128, } ``` ``` { "earned": "1000000" } ```
KeyTypeDescription
earnedUint128The amount of rewards that the user has already received.
### QueryStakingConfig ```rust #[cw_serde] #[derive(QueryResponses)] pub enum QueryMsg { #[returns(StakingConfigResponse)] QueryStakingConfig {}, } ``` ``` { "query_staking_config": {} } ``` ### StakingConfigResponse ```rust #[cw_serde] pub struct StakingConfigResponse { pub gov: Addr, pub staking_token: Addr, pub rewards_token: Addr, pub boost: Addr, pub fund: Addr, pub reward_controller_addr: Addr, } ``` ``` { "gov": "sei1...", "staking_token": "sei1...", "rewards_token": "sei1...", "boost": "sei1...", "fund": "sei1...", "reward_controller_addr": "sei1..." } ```
KeyTypeDescription
govAddrThe address of the governance contract
staking_tokenAddrThe address of the token contract to be staked
rewards_tokenAddrThe address of the token contract to be rewarded
boostAddrThe address of contract boost
fundAddrThe address of contract fund
reward_controller_addrAddrThe address controlling the amount of SEILOR token rewards for each mining.
new_gov*AddrThe address of the new governance contract
\* = optional ### QueryStakingState ```rust #[cw_serde] #[derive(QueryResponses)] pub enum QueryMsg { #[returns(StakingStateResponse)] QueryStakingState {}, } ``` ``` { "query_staking_state": {} } ``` ### StakingStateResponse ```rust #[cw_serde] pub struct StakingStateResponse { pub duration: Uint128, pub finish_at: Uint128, pub updated_at: Uint128, pub reward_rate: Uint256, pub reward_per_token_stored: Uint128, pub total_supply: Uint128, } ``` ```json { "duration": "1000000", "finish_at": "1000000", "updated_at": "1000000", "reward_rate": "1000000", "reward_per_token_stored": "1000000", "total_supply": "1000000" } ```
KeyTypeDescription
durationUint128Duration of rewards to be paid out (in seconds) 2_592_000 = 30 days
finish_atUint128Timestamp of when the rewards finish
update_atUint128last updated time
reward_rateUint256Reward to be paid out per second
reward_per_token_storedUint128Sum of (reward rate * dt * 1e6 / total supply)
total_supplyUint128The total amount of staked tokens.
### GetUserUpdatedAt ```rust #[cw_serde] #[derive(QueryResponses)] pub enum QueryMsg { #[returns(GetUserUpdatedAtResponse)] GetUserUpdatedAt { account: Addr }, } ``` ``` { "get_user_updated_at": { "account": "sei1..." } } ```
KeyTypeDecription
accountAddrThe user's address
### GetUserUpdatedAtResponse ```rust #[cw_serde] pub struct GetUserUpdatedAtResponse { pub updated_at: Uint128, } ``` ``` { "updated_at": "1000000" } ```
KeyTypeDescription
updated_atUint128last updated time for user
### GetUserRewardPerTokenPaid ```rust #[cw_serde] #[derive(QueryResponses)] pub enum QueryMsg { #[returns(GetUserRewardPerTokenPaidResponse)] GetUserRewardPerTokenPaid { account: Addr }, } ``` ``` { "get_user_reward_per_token_paid": { "account": "sei1..." } } ```
KeyTypeDescription
accountAddrthe user's address
### GetUserRewardPerTokenPaidResponse ```rust #[cw_serde] pub struct GetUserRewardPerTokenPaidResponse { pub reward_per_token_paid: Uint128, } ``` ``` { "reward_per_token_paid": "1000000" } ```
KeyTypeDescription
reward_per_token_paidUint128Calculating the reward rate per Staking token for a specific user after applying the boost
### BalanceOf ```rust #[cw_serde] #[derive(QueryResponses)] pub enum QueryMsg { #[returns(BalanceOfResponse)] BalanceOf { account: Addr }, } ``` ```json { "balance_of": { "account": "sei1..." } } ```
KeyTypeDescription
accountAddrthe user's address
### BalanceOfResponse ```rust #[cw_serde] pub struct BalanceOfResponse { pub balance_of: Uint128, } ``` ```json { "balance_of": "1000000" } ```
KeyTypeDescription
balance_ofUint128the balance of the user's address