GEB Docs

Searchâ€¦

The Money God League

Ungovernance

Incentives

Contract Variables Translation

System Contracts

Proxy Infrastructure

Helper Contracts

APIs

Keepers

Uni-V2 RAI/ETH Savior Details

The Uniswap V2 RAI/ETH savior allows users to deposit LP shares to protect their safe. Upon a liquidation attempt from a keeper, the savior will withdraw all RAI and ETH liquidity from Uniswap.

The saviour will then repay as much RAI debt as possible. If the Safe's collateralization ratio is still not at the target ratio that the Safe owner picked, the saviour will also add more ETH in the Safe. The keeper that triggered the saviour will then take a flat fee as reward for saving the Safe.

The savior does **not** guarantee that the safe will be saved. The user needs to make sure that they deposited enough LP tokens so the saviour can both reward the keeper that saves their position and bring the Safe's collateralization ratio to the target they picked.

Minimum Savior Balance Formula

In order to derive the formula for the minimum LP balance that can bring your Safe to a target CRatio, we use the following variables:

$P_{liq}$

â€‹$P_{RP}$

â€‹$P_{RAI}$

, $P_{ETH}$

â€‹$D$

â€‹$C$

â€‹$A_{cc}$

â€‹$R_{liq}$

, $R_{targ}$

â€‹$S_{RAI}$

, $S_{ETH}$

â€‹We first need to use the liquidation price formula:

$P_{liq} = \frac{DA_{cc}R_{liq}P_{rp}}{C}$

â€‹From here, we can reorganize the formula to isolate the debt and collateral amount in the Safe. We also use the Target Rebalance CRatio

$R_{tar}$

instead of the liquidation CRatio to know how much debt and collateral we need to save the Safe:$\frac{C_{sav}}{D_{save}} = \frac{A_{cc}R_{tar}P_{rp}}{P_{liq}}$

The savior will be withdrawing an amount of LP tokens to get

$D_{lp}$

RAI and $C_{LP}$

ETH. Therefore, the resulting debt and collateral in safe after and adding the proceeds from the LP shares will be: â€‹

$C_{save} = C + C_{lp}$

â€‹

$D_{save} = C - D_{lp}$

â€‹Which then gives us:

$\frac{C + C_{lp}}{D - D_{lp}} = \frac{A_{cc}R_{tar}P_{rp}}{P_{liq}}$

We will reuse this formula later. We now need to model the Uniswap pool dynamics to calculate the amount

$D_{lp}$

and $C_{LP}$

we would get from the savior LP shares at a given liquidation price. We start from the standard xy=k assumptions:$\begin{cases}K_{lp} = S_{ETH}S_{RAI}\\ S_{ETH}P_{ETH}= S_{RAI}P_{RAI}\end{cases}$

$\iff K_{LP} P_{ETH} = {S_{RAI}}^2 P_{RAI}$

$\iff S_{RAI} = \sqrt{K_{LP} \frac{P_{ETH}}{P_{RAI}}}$

And similarly:

$\iff S_{ETH} = \sqrt{K_{LP} \frac{P_{RAI}}{P_{ETH}}}$

We can now replace these results in the equation from the liquidation price:

$\frac{C + \sqrt{K_{LP} \frac{P_{RAI}}{P_{ETH}}} }{D - \sqrt{K_{LP} \frac{P_{ETH}}{P_{RAI}}} } = \frac{A_{cc}R_{tar}P_{rp}}{P_{liq}}$

We simplify the equation using

$p = \frac{P_{RAI}}{P_{ETH}}$

and $j=\frac{A_{cc}R_{tar}P_{rp}}{P_{liq}}$

â€‹$\frac{C + \sqrt{K_{LP}p } }{D - \sqrt{K_{LP} \frac{1}{p}} } = j$

We need to solve the equation above for

$K_{LP}$

.Using Wolfram Alpha:

solve(Divide[c+Sqrt[k*p],d-Sqrt[k*(Divide[1,p])]]=j,k) - Wolfram|Alpha

Wolfram_Alpha

â€‹We get 2 solutions:

$\begin{cases} K_{LP1}= \frac{p(C-Dj)^2}{(j-p)^2} \\ K_{LP2}= \frac{p(C-Dj)^2}{(j+p)^2} \end{cases}$

Since we're interested in the minimum balance of LP tokens, we keep only the second solution that will give the lowest balance possible. Last, we need to take the square root of

$K_{LP}$

â€‹to get the actual LP token balance:$Bal_{LPmin}= \sqrt{\frac{p(C-Dj)^2}{(j+p)^2}}=\sqrt{p} \frac{|C-Dj|}{j+p}$

Done! To that we have to add the flat $2000 keeper fee. Below is a calculation example:

The spreadsheet is available here, make a copy to test your own parameters: https://docs.google.com/spreadsheets/d/1flg9LidXvxcAInw4-AtDCEFniMGoZg9fIgm-x36S3CA/edit#gid=0â€‹

â€‹

Copy link

Contents

Minimum Savior Balance Formula