Skip to article content Fraxlend

Fraxlend liquidations exchange debt repayment for collateral when a loan breaches its LTV limit

Fraxlend liquidations allow third parties to repay an unhealthy loan and receive collateral when its loan-to-value ratio exceeds the pair's applicable limit. The collateral taken depends on the pair's fee rules and available collateral. Interest growth or a change in relative token prices can trigger eligibility. When collateral cannot cover the liquidation, unpaid debt can also reduce lenders' claims.

Updated -

Each isolated pair combines one lending asset with a different ERC-20 collateral token. Fraxlend Pair version 3.0.0 uses separate collateral-exhaustion branches and configurable fees, so the deployed pair's settings determine the specific liquidation outcome.

When does a Fraxlend loan become liquidatable?

A loan becomes liquidatable when the pair's liquidation solvency check finds that its debt exceeds the permitted value of its deposited collateral. Loan-to-value, or LTV, expresses debt value relative to collateral value. A nonzero maximum LTV below 100% allows intervention before debt consumes the collateral's full value. With a nonzero configured maximum, version 3.0.0 treats an LTV exactly equal to the limit as solvent.

The pair's maxLTV() value supplies the threshold. In version 3.0.0, maxLTV / 1000 expresses the raw setting as a percentage. The timelock can change this value unless the setter has been revoked, so the threshold at execution can differ from the threshold when borrowing began.

Debt and collateral in comparable units

An LTV calculation compares two values in the same unit: LTV = debt value / collateral value . Multiplying the ratio by 100 expresses it as a percentage. Debt includes capitalized interest, while collateral value uses the amount allocated to the borrower and the applicable exchange rate. A token balance alone does not supply either side's market value.

Borrow shares record the borrower's portion of total debt, and their conversion into Asset Tokens uses the borrow account's current amount-to-shares ratio. Lender fTokens represent a different claim and cannot substitute for borrow shares in a repayment calculation. Token decimals and the contract's rounding rules matter when reconciling raw balances.

Oracle prices at the liquidation boundary

Fraxlend Pair version 3.0.0 obtains low and high collateral-per-asset exchange rates from its configured dual oracle, then uses them differently.

The rate that permits liquidation

The liquidation function uses the lower exchange rate to test solvency and value the requested debt repayment in collateral units. For an unchanged Asset Token value, a falling Collateral Token value increases the collateral-per-asset exchange rate.

The rate that limits collateral removal

Borrowing and collateral removal with outstanding debt use the higher exchange rate for their final solvency check. An attempt to remove collateral can fail while the position is solvent at the lower rate used for liquidation.

Interest between balance updates

While interest accrues, capitalization increases the Asset Tokens owed for outstanding borrow shares. As debt grows, LTV can rise even if relative token prices stay unchanged. Utilization affects the borrowing rate through the pair's configured calculator, so the speed of debt growth can change during the loan. An unchanged borrow-share balance therefore does not establish an unchanged repayment amount. The liquidation function accrues interest before testing solvency. A balance viewed earlier can understate the debt that execution evaluates, and a lower future rate does not remove interest already capitalized.

Collateral top-ups and repayment alternatives

Adding collateral increases the denominator of LTV; repayment reduces its numerator. The available tokens and the borrower's intent to retain or sell deposited collateral determine which response fits.

Collateral top-ups and repayment alternatives at a glance
Response Effect on the position Required tokens or route
Add collateral Adds collateral without repaying debt Additional accepted Collateral Tokens
Repay directly Repays borrow shares without selling collateral The pair's Asset Tokens and a transfer allowance
Repay with deposited collateral Sells collateral to fund debt repayment An approved collateral-to-asset swap route

In version 3.0.0, repayment using deposited collateral requires an approved swapper and a path from the Collateral Token to the Asset Token. The operation must satisfy its minimum-output requirement, oracle-deviation check, and final solvency check. Because both debt and collateral change, selling collateral does not automatically improve the remaining ratio enough. Direct repayment avoids that swap when the payer already holds the lending asset.

Fees and the collateral award

Liquidation fees determine the premium in collateral associated with the debt that a liquidator repays. Version 3.0.0 first expresses the requested repayment in collateral units. It then tests whether the award calculated with cleanLiquidationFee would exhaust the borrower's collateral.

Collateral remains

If the clean-fee calculation leaves collateral, the contract calculates the award using dirtyLiquidationFee . The borrower retains the remainder allocated to the position; its health depends on the debt and collateral that remain.

Collateral runs out

The collateral-exhausting branch allocates all available collateral between the liquidator and any protocol fee. Any borrow shares that the liquidator does not repay can then require a debt write-off.

Version 3.0.0 calculates protocolLiquidationFee against the gross collateral award before subtracting that amount from the liquidator's payout. The contract credits this collateral fee to the pair's own account. Clean, dirty, and protocol fee settings can change through the timelock unless their setter has been revoked.

Does an LTV breach remove collateral immediately?

An LTV breach creates liquidation eligibility; a successful liquidation transaction performs the debt repayment and collateral transfer. A price crossing or an unhealthy display alone does not complete those transfers.

The version 3.0.0 liquidation function respects its liquidation pause and evaluates solvency after interest and oracle updates. If repayment or a collateral addition leaves the position solvent at the liquidation check, that liquidation attempt reverts.

Eligibility supplies no fixed execution time. Liquidator participation and the transaction's execution conditions determine whether a liquidation actually occurs.

Uncovered debt and lender losses

Debt restructuring applies when the collateral-exhausting branch leaves borrow shares that the liquidator does not repay. In version 3.0.0, a liquidation write-off reduces totalAsset.amount by the value of the unpaid debt. That adjustment reduces lender claims within the affected pair. With a positive clean liquidation fee, the exhaustion branch can apply before debt alone exceeds collateral value. Isolation keeps the pair's accounting separate; it does not reimburse its lenders. Debt clearance can therefore combine an actual repayment with a write-off, and the two amounts describe different economic outcomes.

The records that distinguish repayment from loss

The version 3.0.0 Liquidate event identifies the borrower and records the liquidator's collateral receipt, repayment amount, protocol collateral fee, and debt adjustments. Repayment amounts use Asset Token base units, while collateral receipts and fees use Collateral Token base units. Shares describe accounting claims, so a share count must not be read as a transferred token amount. The separate debt-adjustment fields identify amounts removed through write-off.

Illustration: The records that distinguish repayment from loss (Fraxlend liquidations)

View full-size image

A successful transaction receipt and its event logs record the execution; updated borrow shares and collateral balances show the remaining position. A submission identifier alone establishes no collateral movement.

The remaining position after execution

The borrower's obligations after liquidation depend on the debt and collateral that remain in the pair, including any debt adjustment.

Debt remains

Outstanding borrow shares continue to represent debt and accrue interest when interest accrual is active. A partial liquidation does not establish lasting solvency, because relative prices and capitalized interest can change the remaining LTV again. The available collateral and repayment funds determine the options for reducing that remaining exposure.

Debt has cleared

A zero borrow-share balance establishes that no borrowing debt remains in that position. Remaining collateral, if any, stays allocated to the borrower until withdrawal. Version 3.0.0 permits collateral removal without a price-dependent solvency check when no debt shares remain. A position cleared by collateral exhaustion may have nothing left to withdraw.

Fraxlend liquidations: the short answers

Can another account repay my Fraxlend debt before liquidation?

Another account can repay borrow shares for a specified borrower through repayAsset, provided repayment is not paused. The payer needs the pair's Asset Token and the required transfer allowance. The payment reduces the named borrower's debt. It does not transfer that borrower's collateral to the payer or grant the payer control over the position.

Do I need to approve someone liquidating my Fraxlend position?

A valid liquidation does not require the borrower's token-transfer approval. The liquidator supplies the repayment asset and needs its own token allowance. The pair's solvency test and liquidation controls govern execution. The borrower's earlier approval to deposit collateral does not create a separate right to veto a valid liquidation.

Does an oracle-deviation borrowing block also stop liquidation?

An oracle-deviation borrowing block does not itself disable liquidation in Fraxlend Pair version 3.0.0. The liquidation function updates oracle rates and uses the lower exchange rate without requiring the borrowing-allowed flag. The pair's liquidation pause and liquidation solvency check still apply. A borrowing restriction therefore does not establish protection from collateral seizure.

What does a zero maxLTV setting mean for liquidation eligibility?

In version 3.0.0, maxLTV equal to zero makes the solvency helper return true. The liquidation function then rejects the position as solvent. This special branch means that zero cannot be interpreted as an ordinary zero-percent borrowing threshold. It also does not establish permission to borrow through every other restriction on the pair.

Is the liquidation transaction deadline a repayment grace period?

The version 3.0.0 liquidation deadline limits that transaction's execution time; it gives the borrower no protected repayment period. The caller supplies a timestamp, and the transaction reverts if the block timestamp exceeds it. A different valid liquidation transaction can have a different deadline. Eligibility still follows the pair's solvency rules.

Has the collateral necessarily been sold when a liquidation succeeds?

A successful core liquidation transfers Collateral Tokens to the liquidator without requiring an exchange sale inside that liquidation call. A liquidator can separately arrange a sale or another use of those tokens. The collateral amount in the event therefore establishes a token receipt, not a realized sale price or the liquidator's net profit.

Why can lender losses occur without a lower fToken balance?

A liquidation write-off can reduce the underlying assets supporting each fToken while the lender keeps the same share count. In version 3.0.0, the write-off reduces the asset account's amount without reducing its asset shares. A smaller underlying-asset claim then backs each share. Interest income and losses therefore need separate accounting.

Will collateral deposited in another Fraxlend pair protect this loan?

Collateral in another isolated pair does not enter this loan's liquidation calculation. Each pair tracks its own userCollateralBalance and userBorrowShares for the borrower. Holdings elsewhere do not automatically increase the collateral credited to the affected position. A top-up improves this position's coverage only once the pair credits the collateral.