> For the complete documentation index, see [llms.txt](https://docs.clovis.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clovis.network/onboarding/how-to-get-started-on-clovis-testnet.md). # How to Get Started on Clovis Testnet Clovis is designed to act as a cross-chain hub for assets, helping position liquidity across supported networks so funds can access the strongest opportunities without manual bridging. Instead of moving funds between chains yourself, Clovis vaults demonstrate how liquidity can flow across networks over time. For example, opportunities for an asset may shift from one chain to another, and vault funds can be positioned accordingly. Because of this design, assets may not always remain on the original chain you deposited from. When withdrawing, you can choose to withdraw on the chain where your assets currently reside, select a different supported destination chain, or bridge assets manually if you prefer. This guide walks you through the steps to start using Clovis, from connecting your wallet to depositing into Earn vaults, managing positions, bridging assets, and borrowing against supported collateral. By the end, you’ll have testnet assets and be able to explore Clovis features across supported chains. 💡 This process only takes a few minutes and uses testnet assets. *** ## 1. Connect Your Wallet Open [Clovis testnet](https://testnet.clovis.network/) and connect a supported wallet.
* **Recommended:** OKX, MetaMask, or Rabby Wallet (auto-detects tokens and provides a smoother testnet experience) *** ## 2. Get Testnet Gas and Assets Before interacting with Clovis, you will need testnet gas and supported testnet assets, such as USDC, USDT, WETH, or the tokenized BTC asset available on your selected network. Refer to the Faucet guide for step-by-step instructions: 👉 [**Clovis Testnet Faucet guide**](/onboarding/how-to-get-started-on-clovis-testnet/clovis-testnet-faucet-guide.md) *** ## 3. Deposit Into a Vault Earn vaults allow you to deposit supported testnet assets, including stablecoins, WETH, and tokenized BTC assets, to demonstrate earning yield and test how funds move within Clovis.
1. Navigate to the **Earn** page 2. Select a supported asset and vault 3. Enter the deposit amount 4. Approve the asset if required 5. Confirm the deposit transaction
After depositing, you receive yield-bearing vault shares represented by a `cloToken`, such as `cloUSDC` for a USDC vault. The exact `cloToken` name depends on the deposited asset and selected vault. You can view and manage your position in the **Portfolio** tab. The Portfolio shows your active positions, `cloToken` shares, yield information, and the current location of the underlying assets. A position can optionally be locked to earn a Lock Reward. The Base yield continues to be reflected in the `cloToken` share price. ### Position Lifecycle A vault position can follow one of these paths: **Flexible position:** Deposit → Flexible Position → Withdraw **Locked position:** Deposit → Lock → Unlock or Early Exit → Flexible Position → Withdraw **Collateralized position:** Deposit → Receive `cloToken` Shares → Supply as Collateral → Borrow → Repay Debt and Withdraw Collateral → Flexible Position → Withdraw Unlock or Early Exit returns the `cloToken` shares to the Flexible position. Withdraw is a separate step that redeems the `cloToken` shares for the underlying asset and sends it to your wallet. *** ## 4. Bridge from Another Chain (Optional) If your assets are on another supported chain, you can use the bridge to move them before depositing. Bridging lets you demonstrate how Clovis moves liquidity across supported networks and understand cross-chain asset movement within vault strategies.
1. Navigate to the **Bridge** page 2. Select source and destination chain 3. Enter the amount 4. Approve and confirm the transaction You can track the status of your bridge in the **Transactions** tab, which shows history, timestamps, and status updates. *** ## 5. Borrow Against Your Position (Optional) Borrowing lets you use a supported Earn position as collateral to access another testnet asset without first withdrawing your position from the vault. After depositing into an Earn vault, you receive `cloToken` shares that represent your position. Supported `cloToken` shares can be supplied as collateral in an available borrow market. Available borrow markets depend on the vaults and asset pairs currently deployed. Before borrowing, make sure you have: * An active position in a supported Earn vault * Available `cloToken` shares * Testnet gas on the selected network
1. Navigate to the **Borrow** page 2. Select an available borrow market 3. Supply and approve your `cloToken` collateral 4. Enter the amount you want to borrow 5. Review your available borrowing power and position details 6. Approve and confirm the transaction
Your supplied collateral, borrowed amount, and available borrowing power appear in the **Portfolio** tab. ### Repaying and Withdrawing Collateral Users can repay all or part of their outstanding debt. They can also withdraw all or part of their supplied collateral, provided the remaining position stays within the permitted borrowing limits.
1. Navigate to the **Borrow** page and open your position 2. Enter the amount you want to repay 3. Enter the amount of collateral you want to withdraw, if applicable 4. Select the source network 5. Review the resulting collateral, debt, Health Factor, borrow rate, and liquidation price 6. Approve the asset if required 7. Confirm the **Repay & Withdraw Collateral** transaction The interface shows the maximum amount of collateral currently available to withdraw. This amount depends on the remaining debt, collateral value, and position health. You can repay debt, withdraw available collateral, or combine both actions using **Repay & Withdraw Collateral**. When using **Repay & Withdraw Collateral**, the repayment may still succeed even if the collateral withdrawal encounters an error. Check your updated position before attempting the transaction again. Withdrawing `cloToken` collateral from the borrow market does not redeem the underlying asset. To receive the underlying asset in your wallet, return to the Earn position and complete a separate Withdraw action. *** ## 6. Check Your Portfolio After depositing, you can monitor your positions in the **Portfolio** tab. The Portfolio page displays all active positions associated with your wallet.
You can use this page to: * View and manage your Earn and borrow positions * Monitor `cloToken` shares and yield information * Track where the underlying assets are currently located across supported chains * Review supplied collateral, borrowed balances, and available borrowing power * Unlock a position after maturity or use Early Exit before maturity * Withdraw the underlying asset after the `cloToken` shares have been returned to the Flexible position *** ## FAQ #### Do I Need Real Funds to Test Clovis? No. Clovis uses testnet assets that have no real value. #### Does Unlock Send the Underlying Asset Directly to My Wallet? No. Unlocking returns the `cloToken` shares to the Flexible position. You must complete a separate Withdraw step to redeem the underlying asset to your wallet. #### Why Can’t I Borrow? This is usually caused by: * No active position in a supported Earn vault * The selected `cloToken` is not supported as collateral in that borrow market * Collateral has not been supplied or approved * The borrow amount is above your available borrowing power * Insufficient liquidity in the selected borrow market * Missing testnet gas for the transaction * Your wallet is connected to the wrong network Select an available borrow market, supply and approve the supported `cloToken` collateral, and check your available borrowing power before entering the borrow amount. #### Can I Repay or Withdraw Collateral Partially? Yes. You can repay part or all of your outstanding debt and withdraw part or all of your available collateral. The remaining position must stay within the permitted borrowing limits. The interface shows the maximum collateral currently available to withdraw and previews the resulting debt, Health Factor, borrow rate, and liquidation price. You can perform either action separately or use **Repay & Withdraw Collateral** to combine them. When using the combined action, repayment may still succeed even if the collateral withdrawal encounters an error, so check your updated position before trying again. #### What Happens if My Collateral Value Drops? Your position health decreases if the collateral value falls or the borrowed balance increases. If the position falls below the liquidation threshold, part of your collateral may be liquidated to repay the outstanding borrow. To reduce the risk, you can: * Supply additional collateral * Repay part of the borrowed amount You can monitor your position health in the **Portfolio** tab. #### Why Can’t I Withdraw My Underlying Asset? This is usually caused by: * Your position is still locked * The `cloToken` shares have not yet been returned to the Flexible position * The `cloToken` shares are currently supplied as collateral * The requested collateral withdrawal would leave the borrow position outside its permitted borrowing limits * Missing testnet gas for the transaction * Your wallet is connected to the wrong network * A temporary network or transaction delay If the position was locked, first use Unlock after maturity or Early Exit before maturity. If the `cloToken` shares are being used as collateral, repay part or all of the outstanding debt and withdraw an available amount of collateral from the borrow position. The interface displays the maximum amount currently available to withdraw. Once the `cloToken` shares are available in the Flexible position, use Withdraw to redeem the underlying asset to your wallet. #### What Happens When I Use Early Exit? On the current testnet, Early Exit has a 0% fee. However, the Lock Reward is forfeited. The principal and Base yield reflected in the `cloToken` share price are not deducted. After Early Exit, the `cloToken` shares are returned to the Flexible position. You can then use Withdraw to redeem the underlying asset. #### Why Can’t I Deposit Into a Vault? This is usually caused by: * Missing testnet gas for the transaction * Insufficient balance of the selected asset * Token approval not completed * No available vault for the selected asset and network * Your wallet is connected to the wrong network Make sure you have claimed the selected testnet asset, selected an available vault, and approved the token before depositing. #### Why Can’t I Bridge Assets? Bridge issues may occur due to: * Missing testnet gas on the source chain * Wallet connected to the wrong source or destination network * Insufficient token balance * Temporary bridge congestion or delays You can check the **Transactions** tab to track bridge status and progress. #### Why Does the BTC Asset Have a Different Name on Each Network? The tokenized BTC asset uses a different symbol depending on the selected network: | Network | Tokenized BTC Asset | | ------------ | ------------------- | | BNB Testnet | BTCB | | Base Sepolia | cbBTC | | Sepolia | WBTC | | Sei Testnet | WBTC | These are testnet assets with no real-world value. #### How Long Do Testnet Transactions Take? Deposits, withdrawals, borrows, repayments, and bridges may take anywhere from a few seconds to several minutes, depending on network conditions and the type of transaction. #### Where Should I Report Bugs? If you believe you found a product bug, please use the **Send Feedback** button located at the bottom right of the page. ![image.png](/files/bLiKWQPAEGHjtuzGvsft) This will open a form where you can provide details and screenshots. If needed, you can also report the issue in the **bug-reports** [Discord](https://discord.gg/yei) channel as a secondary option. *** ## What’s Next? Now that you’ve completed the basics, here are a few ways to continue exploring Clovis: #### Explore More Features * Deposit stablecoins, WETH, or a supported tokenized BTC asset into an Earn vault * Bridge supported assets across available networks * Test the full Earn position lifecycle: Deposit, Lock, Unlock or Early Exit, and Withdraw * Supply supported `cloToken` shares as collateral and borrow another testnet asset * Repay a borrow and withdraw your collateral * Withdraw the underlying asset to a supported network #### Stay Updated * Follow [announcements](https://discord.com/channels/1230430080514396161/1230430080514396164) for feature updates and testnet campaigns * Check the [blog](https://www.clovis.network/blog) for product insights and release notes #### Join the Community * Connect with other testers and share feedback in [Discord](https://discord.com/invite/yei) * Follow our [X](https://x.com/YeiFinance) for updates and ecosystem news