Loopscale Vaults offer users a passive and efficient way to earn fixed-rate lending yield across multiple Loopscale Markets. Users deposit into a Vault optimized by a Vault Curator who is responsible for defining eligible markets and loan terms.
This documentation is for partners building credit products with Loopscale and describes the architecture, lifecycle, risk controls, and programmatic guardrails for Loopscale Vaults.
Collateral Management
Up to 200 collateral assets may be permissioned per vault, each with an assigned oracle. Curators may define:- Loan-to-Value (LTV): The maximum borrow value relative to deposited collateral value (also impacts how much collateral can be withdrawn from an outstanding loan).
- Liquidation Threshold (LQT): The point at which liquidation is legal.
- Oracles: Separate oracle accounts as well as staleness and variance criteria may be used for pricing and liquidations. Oracles must match a Loopscale-verified market configuration, as listed in the Oracles section of the docs.
- Maximum Allocation: Per-asset loan exposure caps limit concentration for amount of principal at risk against any individual collateral asset.
- Interest rates: Per-asset, per-duration interest rates can be set. Will apply to new loans or refinanced/rolled over loans.
Liquidity Management
Vault liquidity can be actively shaped to balance yield generation and withdrawal readiness. Curators may define:- Loan Durations and Rates: Curators set which maturities are available in the order book and the rates for each tenor.
- Liquidity Buffer: A portion of the vault can be reserved as idle liquidity to satisfy withdrawals, typically 2.5–7.5% of deposits.
- Idle Yield: Unutilized funds may be allocated to external protocols (e.g. Marginfi) to earn incremental yield, though this introduces additional counterparty risk.
- Refinancing at Maturity: If liquidity falls below the configured buffer, maturing loans are refinanced to other lenders or vaults to preserve withdrawal capacity.
- Deposit Caps: Limits on total deposits accepted into the vault.
- Supply and Borrow Caps: Limits on principal supplied or borrowed over 1h and 24h windows, and in total. Each window starts with the first action after the previous one expires.
- Withdrawal Caps: Limits on withdrawals over 1h and 24h windows. There’s no aggregate withdrawal cap.
- Pause Switches: Ability to halt deposits or new loan originations. Disabling deposits takes effect immediately. Disabling originations is a strategy settings change, so it goes through the timelock.
- Timelock Buffers: Parameter changes that increase risk (e.g. higher LTVs, expanded collateral sets) and changes to strategy settings wait 24 hours before taking effect. Risk-reducing changes like lower LTVs have no delay. See Timelock delays for the full list.
Curation Fees
- Origination Fee: A fixed, one-time fee proportional to principal size, added to the borrower’s principal on new loan originations (not refinances). The curator earns the share of it set by the vault’s principal fee, and the rest accrues to depositors. The principal fee isn’t editable in the Vault Manager UI.
- Interest Fee: A variable share of accrued interest, configurable up to 100% of total interest generated.
Liquidations
Liquidations for loans on vaults are no different than the rest of the protocol, the liquidation framework is designed to ensure orderly resolution of insufficiently collateralized loans.- Health Enforcement: Monitor loan health factors defined by LTV and liquidation thresholds. Liquidations are triggered when collateral falls below required coverage.
- Settlement: Liquidations involve the partial or full repayment of a debt in order to claim some/all collateral
- Whitelisted Access: Liquidators must be whitelisted by Loopscale in order to be able to trigger a liquidation.
- Fees: Liquidations follow a quasi-reverse dutch auction structure that rewards the liquidator proportionally to the percent below the liquidation ratio they are. This incentivizes less aggressive liquidations but in a competitive marketplace, liquidators are ultimately racing to determine a fair fee value at which they’re willing to liquidate.