Computing Supply & Borrows

Search…
Monitoring Instructions:
RefreshReserve - handles all the tracking work and updates ratio
RefreshObligation - computes obligation balances based on reserve ratios
For Supply:
cToken Ratio acts as a % ownership of the LP
For a pool with 99 USDC, if you deposit 1 USDC, you will own 1% of the pool
When the RefreshReserve occurs, the pool now has 110 USDC. Your 1% is now worth 1.1 USDC.
Total Reserves / cTokens Minted 
For Borrows:
APY is used to update CumulativeBorrowRate as an index
When borrowing, calculate the initial CumulativeBorrowRate (let's say 1)
RefreshReserve → Updates the CumulativeBorrowRate (let's say its 1.02)
Obligation borrows would be increased by *1.02/1 or 2%
/// Compound current borrow rate over elapsed slots
    fn compound_interest(
        &mut self,
        current_borrow_rate: Rate,
        slots_elapsed: u64,
    ) -> ProgramResult {
        let slot_interest_rate = current_borrow_rate.try_div(SLOTS_PER_YEAR)?;
        let compounded_interest_rate = Rate::one()
            .try_add(slot_interest_rate)?
            .try_pow(slots_elapsed)?;
        self.cumulative_borrow_rate_wads = self
            .cumulative_borrow_rate_wads
            .try_mul(compounded_interest_rate)?;
        self.borrowed_amount_wads = self
            .borrowed_amount_wads
            .try_mul(compounded_interest_rate)?;
        Ok(())
    }
}
Why: For efficiency, the RefreshReserve just has to update the cToken Rate or the CumulativeBorrowRate instead of updating every obligation’s supply or borrow numbers. Tracking is only done at the ratio/index level, and never at an individual level unless changes to the user's positions are being made.
Architecture - Previous
User Instructions
Next - Architecture
cTokens
Last modified 2mo ago
Copy link