# Quick Start

Welcome to Const Protocol — a fixed-rate, order-book-based DeFi lending platform. This guide walks you through the entire flow from connecting your wallet to managing a lending position.

**Time to complete:** \~15 minutes on Testnet

{% hint style="info" %}
We recommend starting on Testnet (Sepolia) first. It's free, uses test tokens, and lets you explore every feature without risk.
{% endhint %}

***

## 1. Getting Started

### What is Const Protocol?

Const Protocol is a decentralized lending protocol where **suppliers** earn fixed-rate interest by filling **borrower** orders. Unlike variable-rate protocols (Aave, Compound), rates are agreed upon upfront through an order-matching system — no surprises.

### Prerequisites

Before you begin, make sure you have:

* [ ] A modern browser (Chrome, Firefox, or Brave)
* [ ] A wallet extension installed ([MetaMask](https://metamask.io/download/) recommended)
* [ ] A small amount of ETH for gas fees (free on Testnet — see Step 2)

### Connect Your Wallet

{% stepper %}
{% step %}

### Open the Const Protocol app

* **Testnet:** [https://constfi-fe-new.vercel.app](https://constfi-fe-new.vercel.app/en)
* **Mainnet:** *Coming soon...*
  {% endstep %}

{% step %}

### Click **Connect**

Click **Connect** in the top-right corner.
{% endstep %}

{% step %}

### Select your wallet provider

Select your wallet provider (e.g., MetaMask) from the popup.
{% endstep %}

{% step %}

### Approve the connection

Approve the connection request in your wallet.
{% endstep %}
{% endstepper %}

<figure><img src="https://3028039779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmTayVAQkA2pbUF3rUn9z%2Fuploads%2FZPusFpVUPOagxxzzr6Fo%2Fconstfi-homepage.png?alt=media&#x26;token=db7c0320-3b0f-4297-bee3-047a38ef4299" alt=""><figcaption></figcaption></figure>

### Switch Networks

After connecting, make sure you're on the correct network:

{% stepper %}
{% step %}

### Open the network selector

Click the **network indicator** next to your wallet address.
{% endstep %}

{% step %}

### Select the network

Select **Sepolia Testnet** (for testing) or **Ethereum Mainnet** (for real assets).
{% endstep %}

{% step %}

### Approve the switch

If prompted, approve the network switch in your wallet.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
You're ready when you see your wallet address and the correct network name displayed in the header.
{% endhint %}

***

## 2. Get Test Tokens (Testnet)

{% hint style="info" %}
Skip this section if you're using Mainnet with real assets.
{% endhint %}

You'll need two things on Sepolia Testnet: **test ETH** (for gas) and **test ERC-20 tokens** (to supply or use as collateral).

### Step 1: Get Sepolia ETH

Sepolia ETH is free. Use one of these faucets:

| Faucet              | Requirement       | Link                                                                                         |
| ------------------- | ----------------- | -------------------------------------------------------------------------------------------- |
| Google Cloud Faucet | Google account    | [cloud.google.com/faucet](https://cloud.google.com/application/web3/faucet/ethereum/sepolia) |
| Alchemy Faucet      | Alchemy account   | [alchemy.com/faucets](https://www.alchemy.com/faucets/ethereum-sepolia)                      |
| Infura Faucet       | Infura account    | [infura.io/faucet/sepolia](https://www.infura.io/faucet/sepolia)                             |
| Quicknode Faucet    | Quicknode account | [faucet.quicknode.com/ethereum/sepolia](https://faucet.quicknode.com/ethereum/sepolia)       |
| Chainlink Faucet    | Chainlink account | [faucets.chain.link/sepolia](https://faucets.chain.link/sepolia)                             |

{% stepper %}
{% step %}

### Visit a faucet

Visit any faucet above.
{% endstep %}

{% step %}

### Paste your wallet address

Paste your wallet address.
{% endstep %}

{% step %}

### Complete verification and send

Complete any verification and click **Send**.
{% endstep %}

{% step %}

### Wait for funds

Wait 10–30 seconds for the ETH to arrive.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
0.1 Sepolia ETH is more than enough for dozens of test transactions.
{% endhint %}

### Step 2: Claim Test ERC-20 Tokens

<figure><img src="https://3028039779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmTayVAQkA2pbUF3rUn9z%2Fuploads%2FGBTQBgle9i20dXwTIhrE%2Fconstfi-faucet-home.png?alt=media&#x26;token=99c87a1d-1eeb-4c3f-b4bc-726ae94ef66e" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Navigate to the Faucet page

Navigate to the **Faucet** page in the Const Protocol app (or visit [https://faucet.constfi.com](https://faucet.constfi.com/)).
{% endstep %}

{% step %}

### Select a token

Select the token you want to claim (e.g., USDC, USDT, WETH, WBTC).
{% endstep %}

{% step %}

### Enter your wallet address

Manually enter your wallet address or connect your wallet to claim the tokens.
{% endstep %}

{% step %}

### Claim the tokens

Click **Claim** and confirm the transaction in your wallet.
{% endstep %}

{% step %}

### Repeat as needed

Repeat for each token you need.
{% endstep %}
{% endstepper %}

<figure><img src="https://3028039779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmTayVAQkA2pbUF3rUn9z%2Fuploads%2F5gT5tXBXJkR905ioE7Sf%2Fconstfi-faucet-claimed.png?alt=media&#x26;token=00fa33ef-f8f4-4794-a01c-cde9da6b9aa0" alt=""><figcaption></figcaption></figure>

### Step 3: Verify Your Balances

Open your wallet or check the app dashboard to confirm:

* Sepolia ETH balance > 0
* Test token balances appear

If tokens don't show in MetaMask, add them manually using the contract addresses below:

| Token | Sepolia Contract Address                     |
| ----- | -------------------------------------------- |
| USDC  | `0xd4A6e9a9Dcddf6Ab97dBD47792349B92A6dfC820` |
| USDT  | `0x6FB00eE1AB7e0DfEa9a81fA5c095Cf2bd03C75c0` |
| WETH  | `0xf6081C62c44e85A025101c99FB9f74Afc36B23CA` |
| WBTC  | `0xC2C1d50Ce80C7418bB39A5eaF073E3870e2AbC7F` |

TODO: metask-assets.png, an example

{% hint style="success" %}
You're ready when you have Sepolia ETH and at least one test token in your wallet.
{% endhint %}

***

## 3. Supply Assets

Supplying (lending) assets earns you fixed-rate interest. You'll fill a borrower's order at an agreed-upon rate.

<figure><img src="https://3028039779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmTayVAQkA2pbUF3rUn9z%2Fuploads%2FWfHHfR4oQqwCFFiPafy9%2Fconstfi-dashboard-full.png?alt=media&#x26;token=97d04330-df1b-41b6-ac0e-cd166f71ae91" alt=""><figcaption></figcaption></figure>

### How It Works

1. A borrower creates a **borrow order** specifying the token, amount, interest rate, and term.
2. You, as a supplier, **fill the order** by providing the requested tokens.
3. At maturity, you receive your principal + the agreed interest.

### Steps

{% stepper %}
{% step %}

### Go to the Dashboard page

Go to the **Dashboard** page.
{% endstep %}

{% step %}

### Browse available Supply orders

Browse available Supply orders. Each Supply order shows:

* **Status** — the status of the order
* **Asset** — the asset being supplied
* **Amount** — the total supply amount of the order
* **Lent-out%** — the percentage of the order that has been lent out
* **Details button** — click to view the details of the order
  {% endstep %}

{% step %}

### Browse the Assets to Supply section

Browse the **Assets to Supply** section. Each asset shows:

* **Asset** — the asset being supplied
* **Wallet Balance** — the amount of the asset in your wallet
* **APY%** — the annual rate you'll earn
* **Loan Mode** — the loan mode of the supply order (Fixed/Variable)
* **Supply** button — click to supply the asset to the order
  {% endstep %}

{% step %}

### Create a new Supply order

* Select the **Max Loan Term** you want to supply
* Select the **Supply Asset** you want to supply
* Enter the **Supply Amount** you want to supply
* Enter the **Minimum APY** you want to earn
* Switch the **Rollover** option to enable auto-rollover
* Click the **Supply** button
* Approve the token spend — this is a one-time approval per token that allows the protocol to transfer your tokens.
  {% endstep %}

{% step %}

### Confirm and submit

* **Confirm** the supply transaction and sign the order in your wallet.
* **Submit** the order to the order book.
  {% endstep %}
  {% endstepper %}

<figure><img src="https://3028039779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmTayVAQkA2pbUF3rUn9z%2Fuploads%2F348vOhQSCwh6A65jMBi4%2Fconstfi-supply-flow.png?alt=media&#x26;token=500fc47f-be7a-46af-9111-5e8e795272d6" alt=""><figcaption></figcaption></figure>

#### Supply Details

When you click the **Details** button of a supply order, you will see the supply details of the order. And you can see the active positions of the order and the total earnings of the order.

<figure><img src="https://3028039779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmTayVAQkA2pbUF3rUn9z%2Fuploads%2FoMxTOG7f6ZetcbIsC0ce%2Fconstfi-supply-details.png?alt=media&#x26;token=b10adaca-04da-4fc8-9e32-5b6a88463316" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
You're committing real assets. Double-check the interest rate, term, and amount before confirming. Your funds will be locked until the loan matures or is repaid.
{% endhint %}

{% hint style="success" %}
You're done when your dashboard shows an active supply position with the expected interest rate and maturity date.
{% endhint %}

***

## 4. Borrow Assets

Borrowing lets you take a loan against your collateral at a known, fixed interest rate.

<figure><img src="https://3028039779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmTayVAQkA2pbUF3rUn9z%2Fuploads%2FWfHHfR4oQqwCFFiPafy9%2Fconstfi-dashboard-full.png?alt=media&#x26;token=97d04330-df1b-41b6-ac0e-cd166f71ae91" alt=""><figcaption></figcaption></figure>

### How It Works

1. You deposit **collateral** (e.g., WETH, WBTC, Uniswap LP tokens) into the protocol.
2. You create a **borrow order** specifying the token you want to borrow, the amount, your offered interest rate, the loan term, and the collateral you want to use.
3. Suppliers fill your order. Once matched, you receive the borrowed tokens.
4. You repay the loan (principal + interest) before the maturity date.

### Steps

{% stepper %}
{% step %}

### Go to the Dashboard page

Go to the **Dashboard** page.
{% endstep %}

{% step %}

### Browse available Borrow orders

Browse the available Borrow orders. Each Borrow order shows:

* **Status** — the status of the order
* **Asset** — the asset being borrowed
* **Value** — the total borrow amount of the order
* **Method** — the method of the order (Fixed/Variable)
* **Health Factor** — the health factor of the order
* **Details button** — click to view the details of the order
  {% endstep %}

{% step %}

### Browse the Assets to Borrow/Multiply section

Browse the **Assets to Borrow/Multiply** section. Each asset shows:

* **Asset** — the asset being borrowed/multiplied
* **Available** — the amount of the asset available to borrow/multiply
* **APY%** — the annual rate you'll pay
* **Loan Mode** — the loan mode of the borrow/multiply order (Fixed/Variable)
* **Borrow/Multiply** button — click to borrow/multiply the asset from the order
  {% endstep %}

{% step %}

### Choose a borrow type

**Two ways to create a borrow order:**

* Borrow order: Borrow single asset from the protocol.
* Multiply order: Multiply two assets from the protocol using Uniswap LP token.
  {% endstep %}

{% step %}

### Create a new Borrow order

* **Borrow Asset:** The asset you want to borrow from the protocol.
* **Collateral Items:** On the left side, you can see the collateral items you want to use for the borrow order.
  * You can add multiple collateral items by clicking the **Add Collateral** button.
  * You can remove a collateral item by clicking the **Remove** button.
* **Borrow Amount:** The amount you want to borrow from the protocol.
  * When you enter the borrow amount, the protocol will calculate the health factor based on the available collateral items automatically.
  * If the health factor is less than 1.0, you will not be able to create the borrow order.
* Enter the **Minimum APR** you want to pay.
  * You can apply the market APR if you select the **Use Market APR** option.
* Click the **Borrow** or **Approve\&Borrow** button.
* Approve the token spend — this is a one-time approval per token that allows the protocol to transfer your tokens.
* **Confirm** the borrow/multiply transaction and sign the order in your wallet.

<figure><img src="https://3028039779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmTayVAQkA2pbUF3rUn9z%2Fuploads%2FcfSzUrIwFJuEpwWPU0Sy%2Fconstfi-borrow-order.png?alt=media&#x26;token=38a0ec6d-ddca-42c1-b7ee-8c3f70d46e5e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Create a new Multiply order

* **Collateral Items:** On the left side, you can see the collateral items you want to use for the multiply order.
  * You can add multiple collateral items by clicking the **Add Collateral** button.
  * You can remove a collateral item by clicking the **Remove** button.
* **Multiply Target:** The target you want to multiply to.
  * You can select the **New Position** option to create a new Uniswap LP position.
  * You can select the **Existing Position** option to use an existing Uniswap LP position.
  * If you select the **New Position** option, you need to enter the following parameters:
    * **Token0:** The token0 of the Uniswap V3 LP position.
    * **Token1:** The token1 of the Uniswap V3 LP position.
    * **Fee Tier:** The fee tier of the Uniswap V3 LP position.
    * **Tick Lower:** The tick lower of the Uniswap V3 LP position.
    * **Tick Upper:** The tick upper of the Uniswap V3 LP position.
    * **Amount0:** The amount0 of the Uniswap V3 LP position.
    * **Amount1:** The amount1 of the Uniswap V3 LP position.
* **Multiplier:** The multiplier you want to use for the multiply order.
  * When you enter the multiplier, the protocol will calculate the health factor and handling fee based on the available collateral items and multiplier automatically.
  * If the health factor is less than 1.0, you will not be able to create the multiply order.
* Enter the **Maximum APR** you want to pay.
  * You need to enter the maximum APR for the token0 and token1.
  * You can apply the market APR if you select the **Use Market APR** option.
* Click the **Multiply** or **Approve\&Multiply** button.
* **Confirm** the multiply transaction and sign the order in your wallet.

<figure><img src="https://3028039779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmTayVAQkA2pbUF3rUn9z%2Fuploads%2FAQr22FgEGUwiwLeWF5f9%2Fconstfi-multiply-order.png?alt=media&#x26;token=49f0c96e-100d-4fec-a3ec-87c1c0a085a0" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Borrow Details

When you click the **Details** button of a borrow order, you will see the borrow details of the order. And you can see the active position, collateral, repayment and supplier information of the order.

<figure><img src="https://3028039779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmTayVAQkA2pbUF3rUn9z%2Fuploads%2Fr7OnXhGq0klZyQP0qYLT%2Fconstfi-borrow-details.png?alt=media&#x26;token=53775f80-8505-4a3a-b79a-48e2847014e9" alt=""><figcaption></figcaption></figure>

### Understand Your Health Factor

Once your borrow order is filled, your position has a **Health Factor** — a number representing how safe your position is.

| Health Factor | Status     | Action Needed                            |
| ------------- | ---------- | ---------------------------------------- |
| > 1.5         | 🟢 Safe    | No action needed                         |
| 1.0 – 1.5     | 🟡 Caution | Consider adding collateral or repaying   |
| < 1.0         | 🔴 Danger  | At risk of liquidation — act immediately |

The Health Factor depends on:

* Your collateral value (fluctuates with market price)
* Your borrowed amount
* The Loan-to-Value (LTV) ratio of your collateral token

{% hint style="warning" %}
If your Health Factor drops below 1.0, your collateral can be **liquidated** — partially sold to repay the loan. Monitor your position regularly.
{% endhint %}

{% hint style="success" %}
You're done when you see an active borrow position on your dashboard showing the borrowed amount, collateral, interest rate, and maturity date.
{% endhint %}

***

## 5. Manage Your Position

### Repay a Loan

{% stepper %}
{% step %}

### Go to your Dashboard or Positions page

Go to your **Dashboard** or **Positions** page.
{% endstep %}

{% step %}

### Find the position

Find the borrow position you want to repay.
{% endstep %}

{% step %}

### Click Repay

Click **Repay**.
{% endstep %}

{% step %}

### Enter the repayment amount

Enter the repayment amount (partial or full).
{% endstep %}

{% step %}

### Approve and confirm

Approve the token (if first time) and confirm the transaction.
{% endstep %}
{% endstepper %}

<figure><img src="https://3028039779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmTayVAQkA2pbUF3rUn9z%2Fuploads%2FyBu2lgEckjiWDJodJKod%2Fimage.png?alt=media&#x26;token=8b64d0cb-3d31-4345-a3bc-774bb80b168e" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://3028039779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmTayVAQkA2pbUF3rUn9z%2Fuploads%2FN3fNSp1LGqkn3JKMzdwc%2Fimage.png?alt=media&#x26;token=0ede3c15-fc69-4728-9756-5059b69171cc" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
Repaying early frees up your collateral and eliminates liquidation risk.
{% endhint %}

### Withdraw Collateral

After repaying a loan (or if your position has excess collateral):

{% stepper %}
{% step %}

### Go to your Positions page

Go to your **Positions** page.
{% endstep %}

{% step %}

### Click Withdraw

Click **Withdraw** next to your collateral.
{% endstep %}

{% step %}

### Enter the amount

Enter the amount to withdraw.
{% endstep %}

{% step %}

### Confirm the transaction

Confirm the transaction.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Withdrawing collateral reduces your Health Factor. Make sure it stays above 1.0 to avoid liquidation.
{% endhint %}

### What Happens at Maturity?

When a loan reaches its maturity date:

* **Borrower:** Must repay principal + interest. If not repaid, the position may face penalties or liquidation.
* **Supplier:** Receives principal + earned interest back to their wallet.

***

## 6. FAQ & Troubleshooting

### General

<details>

<summary>Q: Why did my transaction fail?</summary>

Check the error message in your wallet or block explorer. Common reasons:

* **Insufficient gas** — make sure you have enough ETH.
* **Token not approved** — approve the token before the transaction.
* **Order expired** — the borrow/supply order may have reached its deadline.
* **Slippage / state change** — the order was filled by someone else before your transaction landed.

</details>

<details>

<summary>Q: Why does signing not cost gas?</summary>

Const Protocol uses [EIP-712 typed data signatures](https://eips.ethereum.org/EIPS/eip-712) for order creation. This is an off-chain signature — it proves you authorized the order but doesn't interact with the blockchain. Gas is only spent when a counterparty matches and executes the order on-chain.

</details>

<details>

<summary>Q: What's the difference between Testnet and Mainnet?</summary>

|         | Testnet (Sepolia)    | Mainnet              |
| ------- | -------------------- | -------------------- |
| Tokens  | Free test tokens     | Real assets          |
| Gas     | Free Sepolia ETH     | Real ETH costs       |
| Risk    | None                 | Real financial risk  |
| App URL | \[TODO: testnet URL] | \[TODO: mainnet URL] |

</details>

### Token & Wallet Issues

<details>

<summary>Q: My test tokens don't appear in MetaMask.</summary>

MetaMask doesn't auto-detect all tokens. Add them manually:

1. Open MetaMask → **Assets** → **Import tokens**.
2. Paste the token contract address (see the table in Section 2).
3. MetaMask will auto-fill the symbol and decimals. Click **Add**.

</details>

<details>

<summary>Q: I can't switch to Sepolia network.</summary>

1. In MetaMask, click the network dropdown.
2. Make sure **Show test networks** is enabled in Settings → Advanced.
3. Select **Sepolia test network**.

</details>

### Position Issues

<details>

<summary>Q: My Health Factor is dropping — what should I do?</summary>

Your collateral value may be declining. You have two options:

1. **Add more collateral** to increase the Health Factor.
2. **Repay part of the loan** to reduce exposure.

</details>

<details>

<summary>Q: What happens if I get liquidated?</summary>

A portion of your collateral is sold to repay the borrowed amount. You keep the borrowed tokens, but lose the liquidated collateral. The remaining collateral (if any) stays in your position.

</details>

***

## Next Steps

* **Explore the Dashboard** — monitor all your positions in one place
* **Join the Community** — \[Coming soon] for support and discussions
* **Read the Docs** — \[Coming soon] for deeper protocol mechanics, risk parameters, and developer resources


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://constfi.gitbook.io/docs/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.