DefaultBondStrategy

Overview

DefaultBondStrategy defines the logic for managing bond-based strategies only focused on deposits and withdrawals. It allocates funds to different bonds in specified ratios and facilitates user withdrawals efficiently.

Key Features

  • Bond Allocation: Deposits into various bonds based on predefined ratios.

  • Withdrawal Management: Supports instant user withdrawals by processing them through the processWithdrawals function.

Error Definition

  • InvalidCumulativeRatio: Raised in setData function when the cumulative ratio for bond allocations does not sum up correctly.

Core Methods

  1. View Functions

    • Q96(): Returns the constant Q96 (2^96) for precise ratio calculations.

    • vault(): Returns the address of the associated vault.

    • erc20TvlModule(): Returns the address of the ERC20TvlModule.

    • bondModule(): Returns the address of the bond module managing transactions.

    • tokenToData(address): Retrieves bond data associated with a specific token.

  2. Configuration Functions

    • setData(address, Data[]): Sets bond allocation data for a given token. The cumulative ratio of all bonds must sum up to Q96.

  3. Withdrawal Functions

    • processAll(): Processes all pending withdrawals for all users by withdrawing from bonds and through the vault, executing corresponding Vault function and depositing all tokens back into bonds according to ratios.

    • processWithdrawals(address[]): Processes withdrawals for a specific list of users.

Data Structure

  1. Data

    • bond (address): Address of the bond receiving the allocated funds.

    • ratioX96 (uint256): Ratio of funds to allocate to this bond, with 96-bit precision.

Events

  1. Bond Allocation Events:

    • DefaultBondStrategySetData(address, IDefaultBondStrategy.Data[], uint256): Emitted when bond allocation data is set for a specific token.

      • token: Address of the token associated with the bond data.

      • data: Array of Data structures representing the bond allocation.

      • timestamp: Timestamp when the data was set.

  2. Withdrawal Processing Events:

    • DefaultBondStrategyProcessWithdrawals(address[], uint256): Emitted when user withdrawals are processed.

      • users: Array of user addresses.

      • timestamp: Timestamp of the withdrawal processing.