Skip to content

Commit

Permalink
GITBOOK-433: Adding Rollover, Leverager and Deleverager to Guides -> …
Browse files Browse the repository at this point in the history
…Features
  • Loading branch information
Pilar Rodríguez authored and gitbook-bot committed Aug 8, 2023
1 parent bc7f744 commit 3454d20
Show file tree
Hide file tree
Showing 3 changed files with 67 additions and 0 deletions.
2 changes: 2 additions & 0 deletions SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,11 @@
* [Bad Debt Clearing](guides/features/automatic-bad-debt-clearing.md)
* [Dynamic Close Factor](guides/features/dynamic-close-factor.md)
* [Earnings Accumulator](guides/features/earnings-accumulator.md)
* [Cross-Asset Leverager & Deleverager](guides/features/cross-asset-leverager-and-deleverager.md)
* [Liquidity Reserve](guides/features/liquidity-reserve.md)
* [Rewards Distribution Model](guides/features/rewards-distribution-model.md)
* [Rate Manipulation Prevention](guides/features/rate-manipulation-prevention.md)
* [Rollover](guides/features/rollover.md)
* [💲 Fixed Rate Operations](guides/fixed-rate-operations/README.md)
* [📥 Deposits](guides/fixed-rate-operations/deposits.md)
* [📤 Borrows](guides/fixed-rate-operations/borrows.md)
Expand Down
43 changes: 43 additions & 0 deletions guides/features/cross-asset-leverager-and-deleverager.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# Cross-Asset Leverager & Deleverager

The Leverage and Deleverage features allow users to increase or decrease positions in a single transaction. Using these strategies, users can perform several operations in the same transaction: same asset leverage, same asset deleverage, cross-asset leverage, and cross-asset deleverage, saving up to 20 transactions, depending on the market, asset, ratio, and amount they choose.

## Leverage Feature

The Leverage function allows users to increase their exposure to different assets in only one transaction without having to manually perform numerous deposits and borrows.

{% embed url="https://youtu.be/ALrdOTN05M0" %}

### Single-Asset Leverage <a href="#1871" id="1871"></a>

This feature can be used to boost the return of the user’s exposure to a specific asset in just one transaction. By selecting their desired leverage factor, the [DebtManager](https://docs.exact.ly/guides/periphery/debtmanager) smart contract will increase the user’s deposit by the chosen number (by borrowing the appropriate amount).

_For instance, if a user has 100 USDC and selects a 3.0x leverage, their deposit will increase to 300 USDC, while their borrowed amount becomes 200 USDC._

### Cross-Asset Leverage <a href="#17f1" id="17f1"></a>

The cross-asset leverage enables users to leverage their positions across different assets. Typically, users deposit one asset, such as wstETH, and borrow another, such as ETH. By leveraging this feature, users can increase their exposure to the borrowed asset or even take long or short positions on specific assets.

_E.g., if a user deposits USDC and borrows ETH, which is then sold to deposit more USDC, they effectively short ETH. If the price of ETH subsequently decreases, the user can repay their borrowed ETH with less USDC, resulting in a profit._

## Deleverage Feature <a href="#20fa" id="20fa"></a>

This feature complements the Leverage function by offering users an easy way to repay their debts using their deposited assets as collateral.

{% embed url="https://youtu.be/3sM5q2BoFUg" %}

### Single-Asset Deleverage <a href="#133d" id="133d"></a>

The same asset Deleverage feature enables users to reduce their leverage exposure on the same asset.

_For instance, if a user initially leverages a 100 USDC deposit at a 4x ratio, resulting in a deposit of 400 USDC and a borrow of 300 USDC, they can utilize the same asset deleverage to move the leverage ratio from 4x to 1x. As a result, after the deleveraging transaction, the user will end up with a 100 USDC deposit._

### Cross-Asset Deleverage <a href="#2971" id="2971"></a>

Using Cross-asset deleverage, users can reduce their leverage exposure across different assets. In addition, to adjusting the leverage ratio, users can also choose to withdraw a specific amount of funds during the deleveraging process.

_For example, if a user wants to move from a 4x to a 1x leverage ratio and withdraws their entire 100 USDC deposit, the transaction would result in zero deposits, zero borrows, and 100 USDC directly available back in their wallet._

## Permit Model

These features are possible through the [DebtManager](https://docs.exact.ly/guides/periphery/debtmanager) smart contract. For security reasons, this contract uses ['permits'](https://help.1inch.io/en/articles/5435386-permit-712-signed-token-approvals-and-how-they-work-on-1inch) for approvals related to allowing you to transfer tokens on your behalf and perform withdrawals or borrows from a Market. Permits are signatures spent when the user completes the transaction, and the approved amount is always exact. After the leverage or deleverage operation is completed, the DebtManager no longer has any allowance over tokens, withdraws or borrows.
22 changes: 22 additions & 0 deletions guides/features/rollover.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Rollover

The Rollover brings an enhanced level of flexibility and control to Exactly Protocol's users, allowing them to strategically decide when and where they want to rollover their loans.

{% embed url="https://youtu.be/knGj2uTOyos" %}

## **What Exactly can users do using rollover?** <a href="#1504" id="1504"></a>

* **Transition from uncertainty to certainty:** Users can convert any variable-rate loan into a fixed-rate loan with a specific maturity date.
* **Embrace flexibility:** Users can convert any fixed-rate loan into a variable pool, transforming their position into a variable-rate loan.
* **Opt for a Different Maturity Date:** Users can move any fixed-rate loan into another fixed-rate loan as long as the new fixed-rate pool has a different maturity date from the current one. \
_For instance, if you hold a fixed-rate loan maturing on July 05, 2023, you can refinance this loan by shifting your debt to another fixed-rate pool maturing on September 27, 2023._

## Partial Loan Refinancing <a href="#1230" id="1230"></a>

One point to be highlighted is that our users can also choose whether they want to refinance the total amount of their loan or just a portion of it.

For instance, if you hold a 100 USD fixed-rate loan due to mature on July 05, you can decide to refinance only a fraction of the total loan amount. Let’s say you choose to rollover just 40 USDC; you can smoothly transfer this selected part to another fixed-rate pool, perhaps one with a later maturity date.

## Permit Model

This feature is possible through the [DebtManager](https://docs.exact.ly/guides/periphery/debtmanager) smart contract. For security reasons, this contract uses ['permits'](https://help.1inch.io/en/articles/5435386-permit-712-signed-token-approvals-and-how-they-work-on-1inch) for approvals related to allowing you to transfer tokens on your behalf and perform withdrawals or borrows from a Market. Permits are signatures spent when the user completes the transaction, and the approved amount is always exact. After the leverage or deleverage operation is completed, the DebtManager no longer has any allowance over tokens, withdraws or borrows.

0 comments on commit 3454d20

Please sign in to comment.