Struct LiquidStakingPool 

pub struct LiquidStakingPool { /* private fields */ }

Liquid staking pool manager

Manages the stTNZO liquid staking derivative for Tenzro Network.

Implementations

impl LiquidStakingPool

pub fn new(config: LiquidStakingConfig) -> Result<Self>

Create a new liquid staking pool

pub fn with_storage( config: LiquidStakingConfig, storage: Arc<dyn KvStore>, ) -> Result<Self>

Create a liquid staking pool with persistent backing in CF_TOKENS. Hydrates config, aggregate totals, per-holder balances, validator delegations, and pending withdrawal requests on construction.

pub fn update_config(&self, new_config: LiquidStakingConfig) -> Result<()>

Update the config (governance-driven). Validates and persists.

pub fn exchange_rate(&self) -> u128

Get the current exchange rate: TNZO per stTNZO.

exchange_rate = total_underlying_wei / total_sttnzo_supply

Returns the rate as a fixed-point number with 18 decimals. A rate of 1_000_000_000_000_000_000 (10^18) means 1:1.

pub fn deposit(&self, depositor: Address, tnzo_amount: u128) -> Result<u128>

Deposit TNZO and receive stTNZO.

The amount of stTNZO minted is calculated from the current exchange rate: sttnzo_amount = tnzo_amount * 10^18 / exchange_rate

pub fn request_withdrawal( &self, requester: Address, sttnzo_amount: u128, ) -> Result<WithdrawalRequest>

Request withdrawal: burn stTNZO and start unbonding.

The TNZO amount is calculated from the current exchange rate at request time. User must wait the unbonding period before claiming.

pub fn claim_withdrawal(&self, request_id: &str) -> Result<(Address, u128)>

Claim a completed withdrawal after the unbonding period.

Returns the TNZO amount to transfer to the user.

pub fn distribute_rewards( &self, reward_amount: u128, ) -> Result<RewardDistribution>

Distribute staking rewards to the pool.

This is called by the reward distributor when staking rewards are earned. The rewards increase the exchange rate (underlying TNZO goes up, stTNZO supply stays the same).

pub fn balance_of(&self, address: &Address) -> u128

Get stTNZO balance for an address

pub fn tnzo_value(&self, sttnzo_amount: u128) -> u128

Get the TNZO value of a stTNZO amount at the current exchange rate

pub fn stats(&self) -> LiquidStakingStats

Get pool statistics

pub fn add_validator(&self, validator: Address, amount: u128)

Add a validator delegation

pub fn validator_delegations(&self) -> Vec<(Address, u128)>

Get all validator delegations

pub fn transfer(&self, from: &Address, to: &Address, amount: u128) -> Result<()>

Transfer stTNZO between addresses

pub fn pending_withdrawals_for( &self, holder: &Address, ) -> Vec<WithdrawalRequest>

List all pending (unclaimed) withdrawal requests for a holder.

pub fn get_withdrawal(&self, request_id: &str) -> Option<WithdrawalRequest>

Look up a single withdrawal request by ID.

pub fn config(&self) -> LiquidStakingConfig

Read a snapshot of the current liquid staking config.

Trait Implementations

impl Debug for LiquidStakingPool

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LiquidStakingPool

fn default() -> Self

Returns the “default value” for a type.