Merge pull request #290 from interlay/dan/lending

feat: lending user guide

Author: nud3l

docs/_assets/img/guide/lending-page-enable-collateral.png

@@ -28,6 +28,7 @@
   * [Wallets / Explorers](guides/wallets-explorers.md)
   * [Transfers](guides/transfers.md)
   * [Bridge](guides/bridge.md)
+  * [Lending](guides/lending.md)
   * [Staking](guides/stake.md)
   * [Governance](guides/governance.md)
   * [Crowdloans](guides/crowdloans.md)

docs/_assets/img/guide/lending-page-ibtc-collateral.png

@@ -0,0 +1,105 @@
+# Lend and Borrow
+
+The lending protocol allows users to trustlessly lend and borrow. Assets that are supplied to the lending pool start earning interest immediately, and can be used as a security deposit for over-collateralized borrowing. Borrowers can repay their loan at any time, along with the interest they owe, while lenders can only withdraw their deposit if there is more liquidity left in the pool (i.e. not borrowed) than the amount to be withdrawn. Interest rates are variable and depend on the supply and demand of each asset.
+
+At the end of this guide you will have:
+
+- [x] [Supplied an asset and started earning interest](#_3-deposit-to-a-lending-market)
+- [x] [Enabled the deposit as borrow collateral](#_4-enable-the-collateral-toggle)
+- [x] [Borrowed using the collateral](#_5-borrow)
+- [x] [Repaid a loan](#_6-repay-a-loan)
+- [x] [Withdrawn part of the supplied amount](#_7-withdraw-a-deposit)
+
+## Prerequisites
+
+Make sure you have a compatible [wallet plugin](guides/wallets-explorers.md#substrate-wallets) installed.
+
+## Lend and Borrow
+
+### 1. Go to the lending page
+
+<!-- tabs:start -->
+#### **Interlay**
+
+Coming soon!
+
+#### **Kintsugi**
+
+Coming soon!
+
+#### **Testnet-Kintsugi**
+
+[kintnet.interlay.io/lending](https://kintnet.interlay.io/lending)
+
+#### **Testnet-Interlay**
+
+[testnet.interlay.io/lending](https://testnet.interlay.io/lending)
+<!-- tabs:end -->
+
+There are three markets available in the screenshot attached. You can take a look at the various interest rates and decide which ones you are interested in supplying or borrowing.
+
+![The Lending page](../_assets/img/guide/lending-page-initial.png)
+
+### 2. Bring tokens for lending and transaction fees
+
+You will need some tokens to pay for transaction fees (KINT on Kintsugi, INTR on Interlay). Additionally, you also need tokens to deposit into the lending pool.
+
+<!-- tabs:start -->
+#### **Interlay**
+
+A list of exchanges with INTR listings can be found on [Coingecko](https://www.coingecko.com/en/coins/interlay). Those exchanges should also have the assets in the Interlay lending markets listed.
+
+#### **Kintsugi**
+
+A list of exchanges with KINT listings can be found on [Coingecko](https://www.coingecko.com/en/coins/kintsugi). Those exchanges should also have the assets in the Kintsugi lending markets listed.
+
+
+#### **Testnet**
+
+On testnet, you can obtain some tokens (KINT/INTR, KBTC/IBTC, KSM/DOT, USDT) by clicking on the "Tokens Faucet" button on the right-hand side of the top bar.
+<!-- tabs:end -->
+
+### 3. Deposit to a lending market
+
+Select a lending market and enter the amount you wish to supply.
+
+![Lend IBTC](../_assets/img/guide/lending-page-lend-ibtc.png)
+
+Observe the "My Lend Positions" table that has been populated with the deposit. 
+
+![My Lend Position IBTC](../_assets/img/guide/lending-page-my-lend-ibtc.png)
+
+
+### 4. Enable the collateral toggle
+
+!> **Attention:** Deposits that are enabled as collateral are subject to liquidation when the borrowed balance becomes undercollateralized.
+
+In the "My Lend Positions" table, in the "Collateral" column, click on the toggle of the deposit you wish to enable as collateral. Doing so will allow you to take out an overcollateralized loan that is backed by this deposit.
+
+![Enable Collateral Toggle](../_assets/img/guide/lending-page-enable-collateral.png)
+
+If there are deposits in multiple asset types, it is easy to see which one is enabled as collateral and which one is not. 
+
+![IBTC enabled as collateral](../_assets/img/guide/lending-page-ibtc-collateral.png)
+
+
+### 5. Borrow
+
+Select an asset from the "Borrow Markets" table and enter the amount you wish to borrow. Note that if the loan-to-value ratio increases too much, your collateral deposits could get liquidated.
+
+The loan is now visible in the "My Borrow Positions" table.
+
+![IBTC Loan](../_assets/img/guide/lending-page-ibtc-loan.png)
+
+### 6. Repay a loan
+
+When you are ready to repay a loan, click on an item in the "My Borrow Positions" and enter an amount. There is a graph that shows how your loan-to-value (LTV) ratio will improve as a result. 
+
+![IBTC Loan](../_assets/img/guide/lending-page-repay.png)
+
+
+### 7. Withdraw a deposit
+
+Click on an item in the "My Lend Positions" and select the "Withdraw" tab. You can withdraw the full deposit by clicking on the blue amount next to the "Limit:" text, or do a partial withdraw by entering a custom amount. Depending on the interest rates, you should be able to withdraw more than the initially deposited amount.
+
+![Withdraw Loan](../_assets/img/guide/lending-page-withdraw.png)