Folks Finance Docs 🇬🇧

HOW TO

Developer

Protocol architecture

Security

helpful guides

Borrow

Dynamics behind the borrow operation.

A user who has made a deposit obtaining an amount

$M$

of fToken can request a loan by locking them as collateral.At the time of the borrow request, named

$t_b$

, the user possesses a collateral amount $A_{t_b}$

correspondent to the amount $M$

of fToken multiplied by $I_{d_{t_b}}$

which is the deposit interest index at the time of borrowing $t_b$

:$A_{t_b} = M * I_{d_{t_b}}$

The collateral amount

$A_{t_b}$

, can be expressed in the borrowed token value following this formula:$Q_{t_b}=A_{t_b} * R_{\frac{Borrowed}{Deposited}_{t_b}}$

Where

$R_{\frac{Borrowed}{Deposited}_{t_b}}$

represents the conversion rate between the borrowed and the collateralized asset.Thresholds

S1 - Loan To Value

For **safety** reasons, the total amount of **borrowed** by the user; it is necessary to retain a portion of it within the protocol to safeguard the loan in case of negative fluctuations in the value of the collateralized asset and to guarantee the interest repayment. Therefore, a **safety threshold ****Loan to Value** (**LTV**).

$Q$

cannot be $S1$

is devised by the protocol. $S1$

is expressed in percentage form, e.g., $S1$

= 0.8 (i.e., 80%), which determines the The granted value is given by the following:

$A_{t_b} * S1 = M * I_{d_{t_b}} * S1$

Therefore, the borrowable amount

$BA$

is calculated as follows:$BA_t = M * R_{B2C_t}$

Where *orrowable to Collateral ratio*, and it is calculated as follows:

$R_{B2C_t}$

is the B$R_{B2C_t} = I_{d_t} * R_{\frac{Borrowed}{Deposited}_{t}} * S1$

So, the borrowable amount at the time of borrow is calculated as:

**or**

$BA_{t_b} = M * R_{B2C_{t_b}}$

$BA_{t_b} = A_{t_b}* R_{\frac{Borrowed}{Deposited}_{t_b}} * S1$

The critical value ** **represents the liquidation threshold, and it is given in percentage defined such that:

$S2$

$S1$

< $S2$

(e.g., $S1$

= 80%; $S2$

= 90%). When the borrowed amount plus accrued interest reaches down the amount $A_{t_b} * S2$

(in the same currency), the position is considered under-collateralized and must be liquidated.The quantity

$A_{t} * S2$

is the threshold of under-collateralization of the loan. Therefore, the equivalent amount in the borrowed asset is calculated as:$T_t = A_t * S2 * R_{{USDC}/{ALGO}_t}$

The user will have to pay interest on the loan. Regular payments are not required to simplify the protocol. However, the non-payments may correspond to a decrease in the collateral value, which must be kept above the *T *threshold. If the user does not pay interest or stabilize its collateral, a liquidator can repay the debt, acquiring collateral control.

Rebalance Threshold

Users can borrow more assets against the same collateral or reduce the locked up collateral if the Liquidation Margin is greater than:

$1-{S1}/{S2}<LM$

Borrow Balance

The variable state *Borrow Balance *

$BB_{t}$

represents the actual amount the user must repay to the platform to close the debt position. To clearly understand all the situations that a loan position could incur, four components are defined as follows:1.

$B_{t_n}$

which represents the actual value borrowed by the user, which is initially $B_{t_b} = BA_{t_b}$

. This is checked and updated only when one of the following occurs: Repay Loan (fully/partially or liquidate) and borrow additional asset (collateral value increased).2.

$C$

which is the amount of asset added (borrow additional asset) or subtracted (Repay loan/interest) from the borrow balance.3. *t* updated at the last loan operation N. It is calculated as an update of the previous borrow balance and the relative compounded interest, plus/minus the contribution of

$BB_{t_n}$

is the borrow balance of the loan at the time $C$

.$BB_{t_n} = BB_{t_{n-1}} *\frac{I_{b_t}}{I_{b_{t_n-1}}}
\pm C$

4.

$AI_{t_N}$

is the part of the user debt composed of the accrued interest on the borrowed amount . When the user repays, the accrued interest part of the payment is addressed to the reserve pool. $AI_{t_N} = BB_{t_{n-1}} *\frac{I_{b_t}}{I_{b_{t_n-1}}} - B_{t_{N-1}}$

Thresholds Parameters

The Borrow Cap is the global maximum borrowable amount for a given token pair, specified in the absolute terms using the borrowed asset.

Token Pairs (Col-Bor)

S1

S2

Borrow Cap

ALGO - USDC

0.7

0.8

ALGO - USDt

0.7

0.8

ALGO - goBTC

0.65

0.8

ALGO - goETH

0.65

0.8

ALGO-Planet

0.7

0.8

600,000

USDC - ALGO

0.7

0.8

USDC - USDt

0.85

0.95

USDC - goBTC

0.75

0.825

USDC - goETH

0.7

0.8

USDC-Planet

0.65

0.8

350,000

USDt - ALGO

0.7

0.8

USDt - USDC

0.85

0.95

USDt - goBTC

0.75

0.825

USDt - goETH

0.7

0.8

USDt-Planet

0.65

0.8

350,000

goBTC - ALGO

0.65

0.8

The S1 and S2 parameters are related to the collateralized-borrowed assets pair. Their value is established using an innovative algebraical model **specifically built for Folks Finance** that considers the covariance of the pairs of assets, market capitalization and liquidation risk.

Last modified 22d ago

Copy link