Liquidations

The Health Factor and Liquidation process on Alloc8 play a vital role in safeguarding user accounts and maintaining financial stability within the platform. Here's a comprehensive overview of these essential components:

Liquidation Threshold

liquidation Threshold is the Loan-to-value ratio for each asset, this helps the protocol ensure the safety of the lenders and keep the volatility of an asset as a factor.

// LT = 100% - Liquidation protocol Fee(1.5%) - Liquidation Liquidator Fee (3.5)

Based on the volatility of the asset the liquidation threshold can be changed.

Health Factor

The Manager employs a cross-margin approach to assess an account's liquidatable status. It calculates equity by summing up collateral, investment, and credit values, requiring equity to exceed the loan value by a certain threshold to maintain solvency. The Health Factor provides a numeric representation of account health, where values below 1 or close to it may trigger liquidation. Higher values indicate safer positions.

// Hf (t) = ∑(i) (a(i)(t) ∗ p(i)(t) ∗ LT(i)(t)) / Debt in Underlying * Accrued interest

Where,

Hf(t) is the health factor at t,

a(i)(t) is the asset in the credit account at time t,

p(i)(t) is the price of the ith asset at t,

LT(i)(t) is the liquidation Threshold of an asset at t

Liquidation Process

  • Liquidation commences when an account's health factor hits 1.

  • During liquidation, all account actions, including depositing, withdrawing collateral, borrowing, claiming, and depositing into strategies, are disabled.

  • Strategy withdrawals are executed by the liquidation module.

  • Account owners can prevent complete liquidation by depositing collateral and using the repay function to clear their debt, transitioning the account back to a healthy state.

  • In the liquidation process:

    • Vault positions are unwound and converted to the underlying associated with the credit account.

    • Collateral is automatically converted to the underlying to repay any debt

  • Upon debt repayment, the account is marked as healthy, and any remaining collateral or assets can be claimed by the account owner.

  • A 5% fee of the notional amount liquidated is charged to the alloc8 as a liquidation fee, with waived fees for bad debt generated for lenders, Out of this fee 1.5% goes to the protocol treasury and the rest is given to the initiator of the liquidation.

Improving Loan Health

Liquidations protect liquidity providers' capital from directional market risks. You can improve your loan health by:

  1. Adding Collateral: Increase the Health Factor by depositing more collateral, typically in the form of underlying associated with the credit account.

  2. Decreasing Debt: Repay the debt taken initially to reduce the leverage that you had taken initially.

Oracles

Price feeds are sourced from the following providers:

  • Api3

  • chainlink

All assets use the classic push model, which means that the provider has the price pushed on-chain every so often, given some set of parameters. Alloc8 contracts that rely on this pricing pull from these providers.

Alloc8 uses chainlink aggregator v3 as the primary solution for asset pricing. Api3's dAPIs are used as a backup. These are on-chain decentralized data feeds sourced directly fron and maintained from by the protocols and and the Oracle.

Each of these Oracles has a heartbeat and deviation threshold to ensure that the data is lively.

Last updated