> For the complete documentation index, see [llms.txt](https://zentrafinance.gitbook.io/zentra/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zentrafinance.gitbook.io/zentra/getting-started/user-guides.md).

# User Guides

## User Guides

Step-by-step tutorials to help you get started with Zentra Finance. From wallet setup to advanced strategies, these guides cover everything you need to know.

### Quick Start

| Step | Action            | Description                                 |
| ---- | ----------------- | ------------------------------------------- |
| 1    | **Wallet Setup**  | Get a wallet compatible with Citrea network |
| 2    | **Bridge Assets** | Move assets to Citrea network               |
| 3    | **Use Zentra**    | Lend or borrow assets                       |
| 4    | **Stake ZNT**     | Earn rewards                                |

### Prerequisites

Before using Zentra, you'll need:

| Requirement        | Description                           |
| ------------------ | ------------------------------------- |
| **Web3 Wallet**    | MetaMask, Rabby, or compatible wallet |
| **Citrea Network** | Add Citrea to your wallet             |
| **Assets**         | ctUSD, USDC or wcBTC on Citrea        |
| **Gas**            | Small amount of cBTC for transactions |

### Available Guides

#### Beginner

**How to Lend** - Learn how to supply assets and earn yield.

* Connect wallet
* Deposit assets
* Earn APY + ZNT rewards

**How to Borrow** - Learn how to borrow against your collateral.

* Supply collateral
* Enable collateral
* Borrow assets

#### Intermediate

**How to Stake** - Learn how to stake ZNT for protocol rewards.

* Choose staking pool
* Stake ZNT tokens
* Claim rewards

### Network Setup

#### Adding Citrea to MetaMask

<https://chainlist.org/?search=citrea>

### Getting Assets on Citrea

#### Option 1: Bridge from Bitcoin

Use the official Citrea bridge to move BTC to Citrea as wcBTC.

1. Go to <https://citrea.xyz/bridge>
2. Connect your wallet
3. Enter amount to bridge
4. Confirm transaction
5. Wait for confirmation

#### DEX Swap

If you have cBTC, swap for other assets on Satsuma DEX.

1. Go to[ https://satsuma.exchange](https://satsuma.exchange/)
2. Connect wallet
3. Swap cBTC for USDC or ctUSD

### Common Tasks

#### Check Your Position

1. Go to [zentra.finance](https://zentra.finance)
2. Connect wallet
3. View dashboard for:
   * Supplied assets
   * Borrowed assets
   * Health Factor
   * Earned rewards

#### Claim ZNT Rewards

1. Go to Zentra dashboard
2. Find "Rewards" section
3. Click "Claim"
4. Confirm transaction

#### Monitor Health Factor

Your Health Factor is displayed on the dashboard:

| Display             | Meaning |
| ------------------- | ------- |
| 🟢 Green (> 2.0)    | Safe    |
| 🟡 Yellow (1.5-2.0) | Good    |
| 🟠 Orange (1.1-1.5) | Caution |
| 🔴 Red (< 1.1)      | Danger  |

### Troubleshooting

#### Transaction Failed

| Issue              | Solution                    |
| ------------------ | --------------------------- |
| Insufficient gas   | Add more cBTC to wallet     |
| Slippage too low   | Increase slippage tolerance |
| Network congestion | Wait and retry              |

#### Can't Connect Wallet

| Issue          | Solution              |
| -------------- | --------------------- |
| Wrong network  | Switch to Citrea      |
| Wallet locked  | Unlock wallet         |
| Browser issues | Try different browser |

#### Position Not Showing

| Issue               | Solution                |
| ------------------- | ----------------------- |
| Transaction pending | Wait for confirmation   |
| Wrong account       | Check connected address |
| Cache issues        | Refresh page            |

### Safety Tips

| Tip                    | Why                                   |
| ---------------------- | ------------------------------------- |
| **Verify URLs**        | Only use zentra.finance               |
| **Check transactions** | Review before signing                 |
| **Start small**        | Test with small amounts first         |
| **Secure wallet**      | Use hardware wallet for large amounts |
| **Monitor positions**  | Check Health Factor regularly         |
| **Never share keys**   | No one from Zentra will ask for them  |

### Get Help

| Channel     | Use For                             |
| ----------- | ----------------------------------- |
| **Discord** | <https://discord.gg/zentra.finance> |
| **Twitter** | <https://x.com/ZentraFinance>       |