Yield Token Position

Documentation Index

Fetch the complete documentation index at: https://v2-docs.exponent.finance/llms.txt

Use this file to discover all available pages before exploring further.

​

YieldTokenPosition

pub struct YieldTokenPosition {
    /// Link to address that owns this position
    pub owner: Pubkey,

    /// Link to vault that manages the YT
    pub vault: Pubkey,

    /// Track the YT balance of the user here
    pub yt_balance: u64,

    /// Tracker for interest earned (paid in SY)
    pub interest: YieldTokenTracker,

    /// Tracker for emissions earned (paid in emission tokens)
    pub emissions: Vec<YieldTokenTracker>,
}

​

YieldTokenTracker

pub struct YieldTokenTracker {
    /// The index is the per-share value of the SY token
    /// Note that the YT balance must be converted to the equivalent SY balance
    pub last_seen_index: Number,

    /// Staged tokens that may be withdrawn
    pub staged: u64,
}

​

Fields

​

YieldTokenPosition

​

YieldTokenTracker

​

How Yield Accrual Works

1. Deposit YT — User deposits YT into the position. The yt_balance increases and the tracker’s last_seen_index is set to the vault’s current rate.
2. Stage Yield — When stageYtYield is called, the position calculates earned interest since the last staging:
   • Interest earned = change in exchange rate applied to the YT balance (converted to SY equivalent)
   • Emission rewards = change in emission indexes applied to the total SY balance
   • Earned amounts are added to the staged field of each tracker
3. Collect — The staged amount can be withdrawn via collectInterest or collectEmission. The staged field is decremented by the collected amount.

​

Interest Calculation

earned_sy = yt_balance * (1/last_seen_rate - 1/final_rate)
scaled_sy = earned_sy * (final_rate / current_rate)  // if current > final