# Reward The Reward contract contains the logic for distributing Sei delegation rewards to holders of stSei. After the Hub contract withdraws Sei delegation rewards to the Reward contract, the Hub contract can request all rewards to be redelegated, which then updates the stSei vs Sei exchange rate. ## Config

Key	Type	Description
owner	CanonicalAddr	The owner's address of the contract
hub_contract	CanonicalAddr	Contract address of Hub
reward_denom	String	Native token denomination for distributed bSei rewards
swap_contract	CanonicalAddr	Contract address of Swap Extension
swap_denoms	Vec<String>	The supported swap denoms type is configured as "usei"

## InitMsg ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] pub struct InstantiateMsg { pub hub_contract: String, pub reward_denom: String, pub swap_contract: String, pub swap_denoms: Vec, } ```

Key	Type	Description
hub_contract	String	Contract address of Hub
reward_denom	String	Native token denomination for distributed bSei rewards
swap_contract	String	Contract address of Swap Extension
swap_denoms	Vec<String>	The supported swap denoms type is configured as "usei"

## ExecuteMsg ### ClaimRewards Claims bSei holder's accrued rewards to the specified address. Sends rewards to the message sender if the `recipient` is not specified. ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum ExecuteMsg { /// return the accrued reward in uusd to the user. ClaimRewards { recipient: Option }, } ```

Key	Type	Description
recipient*	String	Recipient address of claimed bSei rewards

\* = optional ### UpdateConfig ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum ExecuteMsg { UpdateConfig { hub_contract: Option, reward_denom: Option, swap_contract: Option, }, } ```

Key	Type	Description
hub_contract*	String	Contract address of Hub
reward_denom*	String	Native token denomination for distributed bSei rewards
swap_contract*	String	Contract address of Swap Extension

\* = optional ### SetOwner Transfer ownership permissions to a new owner address. ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum ExecuteMsg { SetOwner { new_owner_addr: String, }, } ```

Key	Type	Description
new_owner_addr	String	The address of new owner

### AcceptOwnership The new owner accepts ownership permissions. ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum ExecuteMsg { AcceptOwnership {}, } ``` ### \[Internal] SwapToRewardDenom Swaps all withdrawn delegation rewards to `reward_denom`. Can only be issued by the `Hub` ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum ExecuteMsg { SwapToRewardDenom {}, } ``` | Key | Type | Desciption | | --- | ---- | ---------- | | | | | ### \[Internal] UpdateGlobalIndex Updates the global reward index based on the newly withdrawn rewards. Can only be issued by the [Rewards Dispatcher](broken://pages/bwqK9e6KOfutHx5u0qK4) ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum ExecuteMsg { UpdateGlobalIndex {}, } ```

Key	Type	Description

### \[Internal] IncreaseBalance Increases stored user's bSei balance. Stores the user's accrued rewards to pending rewards and updates user's reward index to the current global reward index. Can only be issued by the `Token`.

#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ExecuteMsg {
    IncreaseBalance { 
        address: String, 
        amount: Uint128
     },
}

Key	Type	Description
address	String	Address of user whose balance has increased
amount	Uint128	Amount of bINJ balance increased

### \[Internal] DecreaseBalance Decreases stored user's bSei balance. Stores the user's accrued rewards to pending rewards and updates user's reward index to the current global reward index. Can only be issued by the `Token`. ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum ExecuteMsg { DecreaseBalance { address: String, amount: Uint128 }, } ```

Key	Type	Description
address	String	Address of user whose balance has decreased
amount	Uint128	Amount of bINJ balance decreased

### UpdateSwapDenom Add or remove Native token denomination types supported by the [Swap Extension](broken://pages/aecTtgcR55hEz3feD4Y6).

#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ExecuteMsg {
    UpdateSwapDenom {
        swap_denom: String,
        is_add: bool,
    },
}

Key	Type	Description
swap_denom	String	Add or remove Native token denomination types
is_add	bool	"true" represents "add", and "false" represents "remove"

## QueryMsg ### Config Gets the contract configuration of `Reward`. ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum QueryMsg { Config {}, } ``` ### ConfigResponse ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] pub struct ConfigResponse { pub hub_contract: String, pub reward_denom: String, pub owner: String, pub swap_contract: String, } ```

Key	Type	Description
hub_contract	String	Contract address of Hub
reward_denom	String	Native token denomination for distributed bSei rewards
owner	String	The owner's address of the contract
swap_contract	String	The supported swap denoms type is configured as "usei"

### State Gets information about the contract's current state. ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum QueryMsg { State {}, } ``` ### StateResponse ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] pub struct StateResponse { pub global_index: Decimal, pub total_balance: Uint128, pub prev_reward_balance: Uint128, } ```

Key	Type	Description
global_index	Decimal	Current global reward index of bSei
total_balance	Uint128	Total bSei balance of all holders
prev_reward_balance	Uint128	kUSD balance of Reward contract at the end of last `UpdateGlobalIndex`

### AccruedRewards Gets the amount of rewards accrued to the specified bSei holder. ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum QueryMsg { AccruedRewards { address: String, }, } ```

Key	Type	Description
address	String	Address of bSei holder

### AccruedRewardsResponse ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] pub struct AccruedRewardsResponse { pub rewards: Uint128, } ```

Key	Type	Description
rewards	Uint128	Amount of `reward_denom` rewards accrued

### Holder Gets information about the specified bSei holder. ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum QueryMsg { Holder { address: String, }, } ```

Key	Type	Description
address	String	Address of bSei holder

### HolderResponse ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] pub struct HolderResponse { pub address: String, pub balance: Uint128, pub index: Decimal, pub pending_rewards: Decimal, } ```

Key	Type	Description
address	String	Address of bSei holder
balance	Uint128	bSei balance of holder
index	Decimal	Holder's reward index value
pending_rewards	Decimal	Amount of holder's pending rewards

### Holders Gets information about all bSei holders. ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum QueryMsg { Holders { start_after: Option, limit: Option, }, } ```

Key	Type	Description
start_after*	String	Address of bSei holder to start query
limit*	u32	Maximum number of query entries

\* = optional ### HoldersResponse ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] pub struct HoldersResponse { pub holders: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] pub struct HolderResponse { pub address: String, pub balance: Uint128, pub index: Decimal, pub pending_rewards: Decimal, } ```

Key	Type	Description
holders	Vec<HolderResponse>	Vector of holder informations

Key	Type	Description
address	String	Address of bSei holder
balance	Uint128	bSei balance of holder
index	Decimal	Holder's reward index value
pending_rewards	Decimal	Amount of holder's pending rewards

### NewOwner Query the address of the new owner. ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] #[serde(rename_all = "snake_case")] pub enum QueryMsg { NewOwner {}, } ``` ### NewOwnerResponse ```rust #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)] pub struct NewOwnerResponse { pub new_owner: String, } ```

Key	Type	Description
new_owner	String	The address of new owner

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.kryptonite.finance/developer/staking/reward.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.