LLM Friendly Documentation

LLM Friendly Documentation

Canonical endpoints

Example prompt

Install the Yearn Docs Skill

Codex

Claude Code

# LLM Friendly Documentation

This page makes it easy to share Yearn docs with an LLM using machine-readable endpoints built from the docs site.

## Canonical endpoints

- https://docs.yearn.fi/llms.txt

- https://docs.yearn.fi/ai/manifest.json

- https://docs.yearn.fi/ai/docs.jsonl

- https://docs.yearn.fi/ai/raw/

## Example prompt

```
Use https://docs.yearn.fi/llms.txt as the entry point. Read the linked AI endpoints to answer my question, and cite canonical Yearn docs URLs from https://docs.yearn.fi in your response.
```

## Install the Yearn Docs Skill

You can also install the Yearn docs skill, which is published from this docs site and gives instructions to query the docs:

- https://docs.yearn.fi/skills/yearn-docs-site-query/SKILL.md

- https://docs.yearn.fi/skills/yearn-docs-site-query/scripts/yearn_docs_query.py

### Codex

Give this to Codex as the steps to install:

```
SKILL_DIR="${CODEX_HOME:-$HOME/.codex}/skills/yearn-docs-site-query"mkdir -p "$SKILL_DIR/scripts"curl -fsSL https://docs.yearn.fi/skills/yearn-docs-site-query/SKILL.md -o "$SKILL_DIR/SKILL.md"curl -fsSL https://docs.yearn.fi/skills/yearn-docs-site-query/scripts/yearn_docs_query.py -o "$SKILL_DIR/scripts/yearn_docs_query.py"chmod +x "$SKILL_DIR/scripts/yearn_docs_query.py"
```

Restart Codex after installation so the new skill is loaded.

### Claude Code

Give this to Claude as the steps to install:

```
SKILL_DIR="$HOME/.claude/skills/yearn-docs-site-query"mkdir -p "$SKILL_DIR/scripts"curl -fsSL https://docs.yearn.fi/skills/yearn-docs-site-query/SKILL.md -o "$SKILL_DIR/SKILL.md"curl -fsSL https://docs.yearn.fi/skills/yearn-docs-site-query/scripts/yearn_docs_query.py -o "$SKILL_DIR/scripts/yearn_docs_query.py"chmod +x "$SKILL_DIR/scripts/yearn_docs_query.py"
```

In Claude Code, run `/help` and look for `/yearn-docs-site-query`.


Yearn Products

Yearn Products

yVaults

yLockers

# Yearn Products

![image](https://docs.yearn.fi/assets/images/blueknight-product-banner-82d147a2a02f3d9906201879381f9aca.png)

## yVaults

Yearn Vaults (aka yVaults) are capital pools that automatically generate yield based on opportunities present in the market. Vaults benefit users by socializing gas costs, automating the yield generation and rebalancing process, and automatically shifting capital as opportunities arise. End users do not need to have extensive knowledge of the underlying DeFi protocols and can use the vaults as passive-investing strategies.

Don't know what that means? Check out the yVault Docs (https://docs.yearn.fi/getting-started/products/yvaults/overview)
Yearn Vaults V3 dApp (https://yearn.fi/v3)
Yearn Vaults V2 dApp (https://yearn.fi/vaults)

## yLockers

yLockers are yVault products built to get the most out of DeFi protocol governance tokens based on Curve's Vote Escrow mechanics. Lock your tokens and get extra yield, but beware; They are in there to stay and can only be traded on decentralized exchanges.

Don't know what that means? Check out the yLockers Docs (https://docs.yearn.fi/getting-started/products/ylockers/overview)
Yearn yCRV dApp (https://ycrv.yearn.fi/)
Yearn yPRISMA dApp (https://yprisma.yearn.fi/)


veYB Migration Guide

veYB Migration Guide

Quick Start

Migrate veYB to yYB

Step 1

Step 2

Step 3

# veYB Migration Guide

Do you have a veYB position and want to migrate to yYB? You've come to the right place to learn how!

## Quick Start

- On the landing page, click Migrate (https://yyb.yearn.fi/app/migrate) to enter the yYB app's migration page.

- Click "Connect Wallet" (top right) to connect to your preferred wallet.

- When you see your wallet address instead of "Connect Wallet", you're connected.

## Migrate veYB to yYB

In order to make any veYB position transferrable, you must first clear existing gauge weight and max lock your YB. Once complete, you may migrate to yYB 1:1.

### Step 1

First, you need to remove your gauge weight allocations. If you have voted recently, you will need to wait 10 days since your last vote before you can clear your votes.

![image](https://docs.yearn.fi/assets/images/migration-step-1-bdf6b121e10a52f41c362b52ec602a4a.png)

### Step 2

Once you've cleared your votes, you will be instructed to lock your YB for the maximum duration (also known as "permalocking").

![image](https://docs.yearn.fi/assets/images/migration-step-2-0a105893f0ceaa3edadc1702637d4667.png)

### Step 3

You can now migrate your veYB to yYB by transferring your permalocked veYB to Yearn in exchange for yYB tokens at a 1:1 ratio.

![image](https://docs.yearn.fi/assets/images/migration-step-3-18d77529fe4038715d8ae6d9b93aaaff.png)


yYB Interface Guide

yYB Interface Guide

Quick Start

Stake yYB

1. Stake

2. Unstake

3. Claim Rewards

4. Get yYB

Auto-Compound yYB

1. Deposit

2. Withdraw

# yYB Interface Guide

## Quick Start

- On the landing page, click "Launch App" to enter the yYB app.

- Click "Connect Wallet" (top right) to connect to your preferred wallet.

- When you see your wallet address instead of "Connect Wallet", you're connected!

## Stake yYB

You'll begin on the "EARN crvUSD" tab, which is the home for yYB staking.

![image](https://docs.yearn.fi/assets/images/yyb-landing-7a5ff1843a56fbed186befaffd7a3280.png)

Inside this tab, you can perform the following actions:

- Stake

- Unstake

- Claim Rewards

- Get yYB

There's also a "Learn More" tab to the right of those 4 options and a helpful data panel on the right-hand side with the following information:

- Max Staking APR: The current APR for stakers with the maximum 2.5x boost

- Your Boost: The average boost of all your staked yYB - it will be somewhere between the minimum (0.5x) and the maximum (2.5x)

- Staked Amount: The total amount of yYB you have in the Yearn Boosted Staker

- Your APR: The current APR you are receiving based on your boost

- Claimable Rewards: The current $ value of your crvUSD rewards available to claim

- Total Staked: The total amount of yYB staked in the Yearn Boosted Staker

- Min/Max APR: The current minimum APR (based on 0.5x boost) and maximum APR (based on 2.5x boost)

- Total Rewards Last Week: The total $ value of crvUSD rewards shared between Yearn Boosted Staker users last week

### 1. Stake

First, you'll need some yYB. You can mint or buy yYB with YB via the zapper on the Get yYB (https://docs.yearn.fi/getting-started/products/ylockers/yyb/yyb-guide#4-get-yyb) tab.

![image](https://docs.yearn.fi/assets/images/yyb-stake-eec3d00c2e6bf0b23304b27abe198718.png)

You'll need to approve the Yearn Boosted Staker contract and then you can stake your yYB. Once staked, the data panel on the right-hand side will update to display your new boost multiplier, staked amount, and APR.

![image](https://docs.yearn.fi/assets/images/yyb-info-panel-bc618850921717ee58aac22249cbfb03.png)

### 2. Unstake

You're free to unstake your yYB at any time with no lock-ups or penalties.

![image](https://docs.yearn.fi/assets/images/yyb-unstake-b58becfb99e71f491b5b3b9e4cfaed54.png)

The total amount of yYB you have staked will appear below the unstaking field. To unstake your full balance, simply click the max button which will auto-fill the amount. Then click "Unstake" to receive your yYB tokens back to your wallet.

Again, the data panel on the right will update following your unstaking. A max unstake will reset your boost, staked amount and APR to zero. A partial unstake may increase your boost and APR as the least-weighted amounts are unstaked first.

### 3. Claim Rewards

You can view the $ value of your claimable rewards in this tab, as well as the amount in yvcrvUSD-2 vault tokens.

![image](https://docs.yearn.fi/assets/images/yyb-claim-c1513afb17b2605f95813fc76ee445cc.png)

As the vault earns yield, the price of your vault tokens will increase as there is more underlying crvUSD in the vault for you to redeem upon withdrawal. For example, 100 yvcrvUSD-2 could represent 150 crvUSD (~$150.00), dependent on the total cumulative earnings of the vault.

Your crvUSD rewards accrue week over week and are never lost if unclaimed. To claim them to your wallet, all you need to do is click "Claim All" and confirm the transaction .

### 4. Get yYB

Here you'll find an interface for Yearn's yYB zapper contract. You'll need to have YB tokens in your wallet in order to use it.

![image](https://docs.yearn.fi/assets/images/yyb-get-yyb-a22b7c37adee51ff2d817aea6a220192.png)

Using the zapper is as simple as clicking "Mint". Your CRV will then either be locked with Yearn (minting you new yYB at a 1:1 ratio) or swapped for yYB via the Curve pool (if this would output more yYB).

## Auto-Compound yYB

Clicking the "EARN yYB" tab switches you to our auto-compounding yYB V3 vault.

![image](https://docs.yearn.fi/assets/images/yvyyb-landing-7e02d3997d1cab315c5e47aa2c8857a0.png)

Inside this tab, you can perform the following actions

- Deposit

- Withdraw

There's also a helpful data panel on the right-hand side with the following information:

- Estimated Vault APY: The "live" APY of the vault, after fees, and with the compounding of returns taken into consideration

- Deposited Amount: The $ value of your yYB deposited in the vault

- Earned: The $ value of yYB you have earned whilst in the vault

- Total Deposits: The total amount of yYB deposited in the vault by all users

- TVL: The $ value of all yYB deposited in the vault

### 1. Deposit

You'll need to approve the vault contract to allow it to access your yYB and then you can go ahead and deposit your yYB.

![image](https://docs.yearn.fi/assets/images/yvyyb-deposit-76a24ed441914939636b0ecb7a1963ff.png)

And that's it. There's nothing more for you to do.

You'll receive "yvyYB" vault tokens to your wallet, which are like a deposit receipt. They represent your share of the yYB yVault. As the vault earns yield, the price of your vault tokens will increase as there is more underlying yYB in the vault for you to redeem upon withdrawal.

⚠Note: you can also buy yvyYB directly on your favorite dex aggregator like Cowswap

### 2. Withdraw

You can make a withdrawal from the vault at any time.

![image](https://docs.yearn.fi/assets/images/yvyyb-withdraw-7d22cddf1a5864e494b678b48814425f.png)

The total amount of yvyYB vault tokens you have in your wallet will appear below the withdraw field. To withdraw your full balance, simply click the max button which will auto-fill the amount. Then click "Withdraw" to receive yYB tokens back to your wallet.


yYB FAQ

yYB FAQ

When did yYB launch?

Where can I buy yYB?

What is YBS?

Can yYB users vote with their yYB?

What is yvcrvUSD-2?

What are the fees associated with yYB?

How do I unwrap my yYB?

# yYB FAQ

## When did yYB launch?

The contracts are live. Week 0 began on Thursday, December 18th, 2025. You can find relevant addresses here (https://docs.yearn.fi/developers/addresses/yyb-contracts).

## Where can I buy yYB?

yYB can be purchased through the following platforms:

- If you already have YB tokens, you can ZAP directly into yYB using Yearn's yYB zapper contract here (https://yyb.yearn.fi/app/get)

- Curve Finance (https://www.curve.finance/dex/ethereum/swap/?from=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee&to=0x22222222aea0076fca927a3f44dc0b4fdf9479d6) - The primary liquidity source for yYB

- CoW Swap (coming soon) - DEX aggregators like CoW Swap should also work well

## Can I transfer my existing veYB to Yearn for yYB?

Yes. veYB positions are represented as NFTs and these positions can be transferred.

If you have an existing veYB position, you can convert your veYB to yYB at a 1:1 rate here (https://yyb.yearn.fi/app/migrate), after completing these steps:

- Clear votes - Remove gauge weight allocations

- Max lock - Permalock your YB

## What is YBS?

YearnBoostedStaker (YBS) allows yYB holders to earn rewards in stablecoins (crvUSD) - compared to the auto-compounding version of yYB (yvyYB). You can read more about how each option works here (https://docs.yearn.fi/getting-started/products/ylockers/overview#ylocker-products).

## Should I stake my yYB directly or auto-compound it in the vault?

That's totally up to you and depends on your personal situation and preferences. Here are a few things to consider:

- Max Boost:

- Direct stakers will need to wait four weeks before their yYB is max boosted and earning the maximum staking APR displayed.

- Vault depositors join a single shared boost position that adjusts up and down as other users deposit and withdraw.

- Rewards:

- Direct stakers receive their yield in stablecoins, making them less exposed to the price fluctuations of the YB governance token and the yYB peg.

- Vault depositors are "all in" on yYB.

- Gas Fees:

- Direct stakers must manually claim their crvUSD stablecoin rewards. Although earned rewards automatically accumulate and earn interest, this requires at least one additional transaction and can be expensive, depending on gas pricing and network congestion.

- Vault depositors have their crvUSD stablecoin rewards claimed, swapped and reinvested into the yvyYB vault each week. And Yearn covers the gas.

- Composability:

- Direct stakers do not receive a receipt token in their wallet.

- Vault depositors receive back a yvyYB token into their wallet which has the potential to be accepted as collateral across DeFi.

## Can yYB users vote with their yYB?

No. User voting is not part of the yLockers system, instead...

- Gauge voting is automated to optimize for the maximum weekly vote incentive yield.

- Governance voting is handled by a team of core contributors on behalf of veYFI holders.

## What is yvcrvUSD-2?

yvcrvUSD-2 is a Yearn V3 vault that allows the crvUSD yield earned by the YBS strategy to auto-compound. Instead of getting naked crvUSD, you receive autocompounding yvcrvUSD.

## What are the fees associated with yYB?

INFO

For the first 13 weeks, Yearn are waiving all fees related to yYB. This means yYB users in YBS and yvyYB receive 100% of their share of Yearn veYB admin fees and vote incentives.

yYB performance fees will begin to be charged starting Thursday 26th March 2026.

When you stake yYB, a 10% performance fee is applied. Yield accumulates in the receiver contract throughout the week. The yield is distributed once per week, at which point 10% is sent to the Yearn treasury.

## Where does the yield come from and how does it flow?

The yield for yYB stakers comes from two main sources:

- Protocol Fees: Fees generated from the Yield Basis protocol

- Vote incentives: Incentives provided for voting power

All these yields are claimed to the yYB fee receiver

At the beginning of each week, the collected yield is converted to crvUSD (Curve Stablecoin), deposited into the yvcrvUSD-2 vault, and then distributed to stakers. This process occurs once per week, and the yield is claimable at the start of the following week.

## How do I unwrap my yYB?

Liquid locker tokens are not redeemable for the underlying locked tokens as they are continually max-locked into the underlying VE systems. But because they are liquid, they can be traded on decentralized exchanges, and bought and sold at market value.

## How are Yield Basis DAO governance votes handled in this system?

The Yearn governance multisig will retain the sole ability to cast votes in the Yield Basis DAO. They will do so with close consultation with the Crypto Risk Team and other Yield Basis DAO stakeholders to ensure risk is properly assessed and all votes promote the long-term interests of the Yield Basis DAO. While it is possible that the yYB system can be upgraded to someday grant these voting rights to yYB token holders (only if enforcing a sufficiently long lock time), there is no current plan to do so.


yYB Overview

yYB Overview

What is yYB?

Get yYB

Earn yield on yYB

Links

# yYB Overview

![image](https://docs.yearn.fi/assets/images/yyb-banner-00cbccab4a2b78c648155f0c3fff1803.png)

## What is yYB?

yYB is Yearn's veYB yLocker product. It is designed to tokenize the different benefits of a veYB position (https://docs.yieldbasis.com/user/veyb) in a simple, user-friendly way. Let's review the basics of liquid locker tokens like yYB:

- 1 yYB represents 1 veYB permalocked to Yearn

- They are not redeemable for the underlying locked YB

- They have no transfer restrictions and thus can always be swapped in DEX pools

yYB gives users access to veYB revenue sources (admin fees and vote incentives) without giving up the option to instantly exit their position. Depositing to yYB also allows Yearn to use the locked YB to actively participate in Yield Basis governance.

For more information about Yearn's Liquid Lockers, read the overview here (https://docs.yearn.fi/getting-started/products/ylockers/overview).

## Get yYB

yYB is a wrapped version of YB. But unlike other wrapped tokens like WETH, it cannot be unwrapped as it is forever max-locked into the veYB system. But, unlike veYB, it can be swapped on DEXes.

If you have YB tokens...

- You can convert them to yYB by minting yYB at a 1:1 rate here (https://yyb.yearn.fi/app/get)

- You can buy yYB via Curve or CowSwap, which may get you a better rate

If you have an existing veYB position...

- You can convert your veYB to yYB at a 1:1 rate here (https://yyb.yearn.fi/app/migrate) after completing these steps:

- Clear votes - Remove gauge weight allocations

- Max lock - Permalock your YB

## Earn yield on yYB

Yearn has two ways to earn yield on your yYB; depositing to the `YearnBoostedStaker` contract to earn crvUSD or depositing to the yYB Auto-Compounder vault (yvyYB) to earn more yYB. The differences and details are documented here (https://docs.yearn.fi/getting-started/products/ylockers/overview). Once you know which path you want to take, you can follow the step by step guide here (https://docs.yearn.fi/getting-started/products/ylockers/yyb/yyb-guide).

## Links

- Contract Addresses (https://docs.yearn.fi/developers/addresses/yyb-contracts)

- yYB UI (https://yyb.yearn.fi/)

- UI Source Code (https://github.com/yearn/ylockers-ui)

- Yearn Boosted Staker Source Code (https://github.com/yearn/yearn-boosted-staker)

- YB Monitor - veYB Locks (https://www.ybmonitor.com/veYB)

- yLockers Discord Channel (https://discord.com/channels/734804446353031319/1186417376275730552)


yPrisma

yPrisma

# yPrisma

warning

yPrisma has been deprecated and all PRISMA and yPRISMA tokens can be migrated to the native token of Resupply (RSUP).

Please head over to the ReSupply docs to find out how to migrate.

Guide on how to migrate from PRISMA, yPRISMA, or cvxPRISMA: https://docs.resupply.fi/how-to-guides/using-resupply/redeeming-prisma-for-vesting-rsup-tokens

The Redeem PRISMA feature allows users to convert their Prisma-based tokens (PRISMA, cvxPRISMA, and yPRISMA) into a vesting allocation of RSUP tokens. This process allows Prisma token holders to convert to RSUP tokens. This can be found here (https://resupply.fi/governance/rsup) below the Stake RSUP section. In order to see this section you must have a wallet with Prisma, cvxPrisma, or yPrisma connected.

If you still need to find something from the old yPRISMA project, you can find info here (https://docs.yearn.fi/getting-started/products/ylockers/yprisma/overview).


yCRV Interface Guide

yCRV Interface Guide

Quick Start

Stake yCRV

1. Stake

2. Unstake

3. Claim Rewards

4. Get yCRV

Auto-Compound yCRV

1. Deposit

2. Withdraw

CRV Vaults

# yCRV Interface Guide

## Quick Start

- On the landing page, click "Launch App" to enter the yCRV app.

- Click "Connect Wallet" (top right) to connect to your preferred wallet.

- When you see your wallet address instead of "Connect Wallet", you're connected!

## Stake yCRV

You'll begin on the "EARN crvUSD" tab, which is the home for yCRV staking.

![image](https://docs.yearn.fi/assets/images/ycrv-ybs-landing-68b86ea147fa6b73154484deb5514d2e.png)

Inside this tab, you can perform the following actions:

- Stake

- Unstake

- Claim Rewards

- Get yCRV

There's also a "Learn More" tab to the right of those 4 options and a helpful data panel on the right-hand side with the following information:

- Max Staking APR: The current APR for stakers with the maximum 2.5x boost

- Your Boost: The average boost of all your staked yCRV - it will be somewhere between the minimum (0.5x) and the maximum (2.5x)

- Staked Amount: The total amount of yCRV you have in the Yearn Boosted Staker

- Your APR: The current APR you are receiving based on your boost

- Claimable Rewards: The current $ value of your crvUSD rewards available to claim

- Total Staked: The total amount of yCRV staked in the Yearn Boosted Staker

- Min/Max APR: The current minimum APR (based on 0.5x boost) and maximum APR (based on 2.5x boost)

- Total Rewards Last Week: The total $ value of crvUSD rewards shared between Yearn Boosted Staker users last week

### 1. Stake

First, you'll need some yCRV. You can mint or buy yCRV with CRV via the zapper on the Get yCRV (https://docs.yearn.fi/getting-started/products/ylockers/ycrv/ycrv-guide#4-get-ycrv) tab. Alternatively, yCRV can be purchased directly through the following platforms:

- Curve Finance (https://curve.finance/#/ethereum/swap?from=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee&to=0xfcc5c47be19d06bf83eb04298b026f81069ff65b) - The primary liquidity source for yCRV

- CowSwap (https://swap.cow.fi/#/1/swap/ETH/YCRV) - DEX aggregators like CowSwap should also work well

![image](https://docs.yearn.fi/assets/images/stake-9b36862a96092d412fcbd45c3bd944a8.png)

You'll need to approve the Yearn Boosted Staker contract and then you can stake your yCRV. Once staked, the data panel on the right-hand side will update to display your new boost multiplier, staked amount, and APR.

![image](https://docs.yearn.fi/assets/images/data-panel-1-d1c22959b75fc2b8a58fc3095b41880d.png)

### 2. Unstake

You're free to unstake your yCRV at any time with no lock-ups or penalties.

![image](https://docs.yearn.fi/assets/images/unstake-511c316059a63784a392594cdb5f6c38.png)

The total amount of yCRV you have staked will appear below the unstaking field. To unstake your full balance, simply click the max button which will auto-fill the amount. Then click "Unstake" to receive your yCRV tokens back to your wallet.

Again, the data panel on the right will update following your unstaking. A max unstake will reset your boost, staked amount and APR to zero. A partial unstake may increase your boost and APR as the least-weighted amounts are unstaked first.

### 3. Claim Rewards

You can view the $ value of your claimable rewards in this tab, as well as the amount in yvcrvUSD-A vault tokens.

![image](https://docs.yearn.fi/assets/images/claim-rewards-c77b9a1fda2a7b8f7c927adb8c8afc96.png)

As the vault earns yield, the price of your vault tokens will increase as there is more underlying crvUSD in the vault for you to redeem upon withdrawal. For example, 100 yvcrvUSD-A could represent 150 crvUSD (~$150.00), dependent on the total cumulative earnings of the vault.

Your crvUSD rewards accrue week over week and are never lost if unclaimed. To claim them to your wallet, all you need to do is click "Claim All" and confirm the transaction .

### 4. Get yCRV

Here you'll find an interface for Yearn's yCRV zapper contract. You'll need to have CRV tokens in your wallet in order to use it.

![image](https://docs.yearn.fi/assets/images/get-ycrv-62eaa8ad8bf5fc641faa30ac57158999.png)

Using the zapper is as simple as clicking "Mint". Your CRV will then either be locked with Yearn (minting you new yCRV at a 1:1 ratio) or swapped for yCRV via the Curve pool (if this would output more yCRV).

## Auto-Compound yCRV

Clicking the "EARN yCRV" tab switches you to our auto-compounding yCRV V3 vault.

![image](https://docs.yearn.fi/assets/images/yvycrv-landing-acd18ff399e0ae8e3eb42bbf13809974.png)

Inside this tab, you can perform the following actions

- Deposit

- Withdraw

There's also a helpful data panel on the right-hand side with the following information:

- Estimated Vault APY: The "live" APY of the vault, after fees, and with the compounding of returns taken into consideration

- Deposited Amount: The $ value of your yCRV deposited in the vault

- Earned: The $ value of yCRV you have earned whilst in the vault

- Total Deposits: The total amount of yCRV deposited in the vault by all users

- TVL: The $ value of all yCRV deposited in the vault

### 1. Deposit

You'll need to approve the vault contract to allow it to access your yCRV and then you can go ahead and deposit your yCRV.

![image](https://docs.yearn.fi/assets/images/deposit-9329f2af97aff9a7e8a030f471f22094.png)

And that's it. There's nothing more for you to do.

You'll receive "yvyCRV" vault tokens to your wallet, which are like a deposit receipt. They represent your share of the yCRV yVault. As the vault earns yield, the price of your vault tokens will increase as there is more underlying yCRV in the vault for you to redeem upon withdrawal.

⚠Note: you can also buy yvyCRV directly on your favorite dex aggregator like Cowswap

### 2. Withdraw

You can make a withdrawal from the vault at any time.

![image](https://docs.yearn.fi/assets/images/withdraw-1a1abde5b1828bdf9e329c25c50f7b52.png)

The total amount of yvyCRV vault tokens you have in your wallet will appear below the withdraw field. To withdraw your full balance, simply click the max button which will auto-fill the amount. Then click "Withdraw" to receive yCRV tokens back to your wallet.

## CRV Vaults

At the bottom of the Earn page, you'll find a list of Yearn's CRV-based auto-compounding vaults.

![image](https://docs.yearn.fi/assets/images/list-crv-vaults-5af674e7554990b223d858dccf5e10aa.png)

Clicking on a vault will open up the vault detail page in a new tab. Here you can make deposits and withdrawals, as well as finding more data on the vault and strategies themselves.

![image](https://docs.yearn.fi/assets/images/ycrv-lp-vault-d387ec414e816b446668bf238f229e5b.png)

info

You can find more information on Yearn's vaults here (https://docs.yearn.fi/getting-started/products/yvaults/overview).


yCRV FAQ

yCRV FAQ

When will yCRV launch?

Where can I buy yCRV?

Can yCRV users vote with their yCRV?

What is yvcrvUSD?

What are the fees associated with yCRV?

How do I unwrap my yCRV?

# yCRV FAQ

### When will yCRV launch?

Contracts are live, you can find relevant addresses here (https://docs.yearn.fi/developers/addresses/ycrv-contracts).

### Where can I buy yCRV?

yCRV can be purchased through the following platforms:

- If you already have CRV tokens, you can ZAP directly into yCRV using Yearn's yCRV zapper contract here (https://yCRV.yearn.fi/app/get)

- Curve Finance (https://curve.finance/#/ethereum/swap?from=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee&to=0xfcc5c47be19d06bf83eb04298b026f81069ff65b) - The primary liquidity source for yCRV

- CowSwap (https://swap.cow.fi/#/1/swap/ETH/YCRV) - DEX aggregators like CowSwap should also work well

### What is YBS and how is the new version of yCRV different from the old one?

YearnBoostedStaker (YBS) is a new contract from Yearn that allows yCRV holders to earn rewards in stable-coins (crvUSD). It is a new option that yCRV holders can choose from in addition to the traditional auto-compounding version of yCRV (yvyCRV). You can read more about how each option works here (https://docs.yearn.fi/getting-started/products/ylockers/overview#ylocker-products)

### Should I stake my yCRV directly or auto-compound it in the vault?

That's totally up to you and depends on your personal situation and preferences. Here are a few things to consider:

- Max Boost:

- Direct stakers will need to wait four weeks before their yCRV is max boosted and earning the maximum staking APR displayed.

- Vault depositors join a single shared boost position, but this is unlikely to reach the maximum and will adjust up and down as other users deposit and withdraw.

- Rewards:

- Direct stakers receive their yield in stablecoins, making them less exposed to the price fluctuations of the underlying governance token and the yCRV peg.

- Vault depositors are "all in" on yCRV.

- Gas Fees:

- Direct stakers must manually claim their crvUSD stablecoin rewards. Although earned rewards automatically accumulate and earn interest, this requires at least one additional transaction and can be expensive, depending on gas pricing and network congestion.

- Vault depositors have their crvUSD stablecoin rewards claimed, swapped and reinvested into the yv-yCRV vault each week. And Yearn covers the gas.

- Composability:

- Direct stakers do not receive a receipt token in their wallet.

- Vault depositors receive back a yv-yCRV token into their wallet which has the potential to be accepted as collateral across DeFi.

### Can yCRV users vote with their yCRV?

No. User voting is not part of the yLockers system, instead...

- Gauge voting is automated to optimize for the maximum weekly vote incentive yield.

- Governance voting is handled by a team of core contributors on behalf of veYFI holders.

### Why is the yCRV peg currently below 1:1?

It is normal for a yToken such as yCRV (or any liquid locker token) to trade at a discount to the governance token it is built upon. The strength of the peg is dependent on the supply and demand of each yToken.

Each yLocker has been designed to create an attractive yToken that offers value to users and provides incentives to attract liquidity. However, we cannot control the market price of our yTokens.

### What is yvcrvUSD?

yvcrvUSD is a Yearn V3 vault that allows the crvUSD yield earned by the YBS strategy to auto-compound. Instead of getting naked crvUSD, you receive autocompounding yvcrvUSD.

### What are the fees associated with yCRV?

When you stake yCRV, a 10% performance fee is applied. Yield accumulates in the receiver contract throughout the week. The yield is distributed once per week, at which point 10% is sent to the Yearn treasury.

### Where does the yield come from and how does it flow?

The yield for yCRV stakers comes from two main sources:

- Protocol Fees: Fees generated from the CRV protocol

- Vote incentives: Incentives provided for voting power

All these yields are claimed to the yCRV fee receiver

At the beginning of each week, the collected yield is converted to crvUSD (CRV Stablecoin), deposited into the yvcrvUSD-A vault, and then distributed to stakers. This process occurs once per week, and the yield is claimable at the start of the following week.

### How do I unwrap my yCRV?

Liquid locker tokens are not redeemable for the underlying locked tokens as they are continually max-locked into the underlying VE systems. But because they are liquid, they can be traded on decentralized exchanges, and bought and sold at market value.

### I still have yveCRV and/or yvBOOST. What do I do?

yveCRV and yvBOOST have been deprecated and no longer receive yield. There is a migration path available to users. yCRV can be minted 1:1 from yveCRV. yCRV can be minted `1 * pricePerShare` of yvBOOST at the time of migration. There is a migration zap available here (https://ycrv.yearn.fi/app/get) to make this easy. If you are having trouble migrating, please come to the discord (https://discord.gg/yearn) and ask for assistance.

### How are Curve DAO governance votes handled in this system?

The Yearn governance multisig (https://etherscan.io/address/0xfeb4acf3df3cdea7399794d0869ef76a6efaff52) will retain the sole ability to cast votes in the Curve DAO. They will do so with close consultation with the Crypto Risk Team (https://twitter.com/cryptorisksteam) and other Curve DAO stakeholders to ensure risk is properly assessed and all votes promote the long-term interests of the Curve DAO. While it is possible that the yCRV system can be upgraded to someday grant these voting rights to yCRV token holders (only if enforcing a sufficiently long lock time), there is no current plan to do so.


yCRV Overview

yCRV Overview

What is yCRV?

Get yCRV

Earn Yield on yCRV

Links

# yCRV Overview

![image](https://docs.yearn.fi/assets/images/ycrv-banner-95f27cd91d706cee5f0bddddcdb0c175.png)

## What is yCRV?

yCRV is Yearn's veCRV yLocker product. It is designed to tokenize the different benefits of a veCRV position (https://resources.curve.finance/crv-token/vecrv/) in a simple, user-friendly way. Let's review the basics of liquid locker tokens like yCRV:

- 1 yCRV represents 1 veCRV max-locked to Yearn

- They are not redeemable for the underlying locked CRV

- They have no transfer restrictions and thus can always be swapped in DEX pools

yCRV allows Yearn to use your CRV tokens optimally within the Curve ecosystem to boost yields across all products and earn rewards from admin fees and voter incentives. Depositing to yCRV also allows Yearn to use the locked CRV to actively participate in Curve governance.

For more information about Yearn's Liquid Lockers, read the overview here (https://docs.yearn.fi/getting-started/products/ylockers/overview).

## Get yCRV

yCRV is a wrapped version of CRV. But unlike other wrapped tokens like WETH, it cannot be unwrapped as it is forever max-locked into the veCRV system. But, unlike veCRV, it can be swapped on DEXes.

If you have CRV tokens, you can convert them to yCRV either by minting yCRV at a 1:1 rate at https://ycrv.yearn.fi/app/get. You can also buy yCRV with CRV (or another token) using CowSwap (https://swap.cow.fi/#/1/swap/CRV/YCRV), which may get you a better rate.

## Earn Yield on yCRV

Yearn has 2 ways to earn yield on your yCRV; depositing to the `YearnBoostedStaker` contract to earn crvUSD or depositing to the yCRV Auto-Compounder vault (yvyCRV) to earn more yCRV. The Differences and details are documented here (https://docs.yearn.fi/getting-started/products/ylockers/overview). Once you know which path you want to take, you can follow the step by step guide here (https://docs.yearn.fi/getting-started/products/ylockers/ycrv/ycrv-guide).

info

The names yvyCRV and st-yCRV refer to the same thing: The Auto-compounding yCRV vault (https://etherscan.io/address/0x27B5739e22ad9033bcBf192059122d163b60349D#code). Websites and services may still use the old name (st-yCRV). We are working with ecosystem projects to change the name to yvyCRV universally, but until then, if you have concerns about your assets, be sure to check the contract address.

## Links

Contract Addresses (https://docs.yearn.fi/developers/addresses/ycrv-contracts)
yCRV UI (https://ycrv.yearn.fi)
UI Source Code (https://github.com/yearn/ylockers-ui-ycrv)
Yearn Boosted Staker Source Code (https://github.com/yearn/yearn-boosted-staker)
crvhub.com - Liquid Lockers Tracker (https://crvhub.com/wrappers)
yLockers Discord Channel (https://discord.com/channels/734804446353031319/1186417376275730552)


yLockers Overview

yLockers Overview

yLocker Products

Earning Yield with yLockers

Weights and Boosts

Rewards and Claiming

Fees

Unstaking

Deployment Addresses

# yLockers Overview

yLockers are a category of assets built by Yearn designed to tokenize locked governance positions in external DeFi protocols based on Curve's vote escrow (ve) model (https://resources.curve.finance/crv-token/vecrv/). This asset type is often called a "Liquid Locker".

To achieve this, Yearn has deployed a system of smart contracts that allows users to permissionlessly max-lock their governance tokens to Yearn in exchange for a yLocker token (e.g., yCRV, yPRISMA, etc.) at a rate of 1:1.

The benefit of doing this is to provide the end user with a fully transferrable and liquid token that can still receive a share of governance benefits like yield or voting power depending on the protocol. No longer is there a need to lock up your asset value for up to 4 full years!

⚠ Important: Liquid locker tokens are not redeemable for the underlying locked tokens. This is not possible. But because they are liquid, they can be traded on decentralized exchanges, and bought and sold at market value.

## yLocker Products

- yCRV (https://docs.yearn.fi/getting-started/products/ylockers/ycrv/overview)

- yPrisma (Deprecated) (https://docs.yearn.fi/getting-started/products/ylockers/yprisma/overview)

## Earning Yield with yLockers

Within the yLockers ecosystem, there are two distinct ways to earn yield:

- Deposit your yLocker tokens into YBS (earn stablecoins)

- Deposit your yLocker tokens into the Auto-Compounder Vault (earn yLocker tokens)

### Option 1: Deposit yLocker Tokens into YBS

Each week, Yearn's yLockers earn revenue from protocol fees and vote incentives. This revenue is converted into ecosystem stablecoins (crvUSD for yCRV) and distributed to yLocker stakers at the start of the week via the `YearnBoostedStaker`(YBS), a new contract which was launched in Spring 2024 following the passing of YIP-77 (https://snapshot.org/#/veyfi.eth/proposal/0xe79fb2ef4f21ef1e9cc30dd1522c9751c74b631c4782bccbbeb25185d4ddae1d).

To begin earning your share, all you need to do is stake your respective yLocker tokens in the staking contract. Take a look at the interface guides for your desired yLocker to get started. Want to learn how it all works under the hood? Read on Anon!

### Weights and Boosts

The longer you stake, the greater your boost! Yearn's yLocker staking contract incentivizes long-term users by boosting their yield (up to a maximum of 2.5x).

You'll reach max boost and achieve the maximum staking APR less than four weeks after depositing your yLocker tokens.

To calculate your boost, the staking contract maintains a weight for every deposit (which is a function of the amount of yLocker tokens you have staked and the duration since it was staked).

Stake weight increases by 50 points each week (at 00:00:00 UTC, Thursday) until the maximum weight is reached after 4 weeks. For security purposes, the rewards contract is designed to ignore staked amounts that have not yet reached a level of 1x boost (those in their first week). After the first week and once the stake weight has reached 100 points, rewards become claimable.

#### Let’s demonstrate with an example of how the weights work

In this example…

- YearnBoostedStaker is deployed with `maxGrowthWeeks` = 4

- You stake 100 yLocker tokens

On deposit, your initial weight will be 50. At 00:00:00 UTC the following Thursday, your weight will increase to 100, then 150, then 200, and finally 250 (on the fourth Thursday following your deposit).

weekbalanceweightboost0 (deposit week)100500x11001001.0x21001501.5x31002002.0x4 (final growth week)1002502.5x5 ...n1002502.5x

To keep it simple, the example above does not address what happens if you make a withdrawal or a second deposit. If, for example, you deposit 100 yLocker tokens every week for four weeks, you will then have four independent weight groups traveling through the system.

A withdraw will always retrieve yLocker tokens from your most recent (least weighted) deposit, leaving the higher weighted yLocker tokens to continue along.

Your total weight is equal to the sum of each of your deposit’s weight. And the total system weight is the sum of all user weight.

### Rewards and Claiming

Each week, Yearn claims its share of protocol fees and vote-maximized vote incentives. These are swapped for ecosystem stablecoins, wrapped as a yield-bearing Yearn V3 vault token, and deposited directly into the reward distributor contract.

yLocker stakers are entitled to the following rewards:

- 100% of their share of protocol fees

- 90% of their share of gauge votes will be used to earn vote-maximized vote incentives

- (the other 10% votes to support yLocker token liquidity)

Your rewards accrue week over week and are never lost if unclaimed. In fact, they begin earning you additional stablecoin yield from the moment we receive them! When claimed, Yearn V3 vault tokens will be received directly to your wallet.

⚠ Important: Yearn vaults can use multiple strategies to generate yield and may be exposed to more than one DeFi protocol. For more information on the various layers of smart contract risk involved, please refer to our risk documentation (https://docs.yearn.fi/developers/security/risks/).

### Fees

Every yLocker charges a 10% performance fee on the total revenue it receives each week.

### Unstaking

You're free to unstake your yLocker tokens at any time with no lock-ups or penalties.

You can also make partial withdrawals. If you have multiple amounts actively growing in different weeks, the withdrawal is made from the least-weighted amounts first.

### Option 2: Deposit your yLocker tokens into the Auto-Compounder Vault

Too busy to deal with staking, weights, and manual claims? Just want more yLocker tokens and the highest APYs? Then the simple yLocker auto-compounding vaults are for you!

These are Yearn V3 vaults (more info here (https://docs.yearn.fi/getting-started/products/yvaults/v3)) that have the capability to use multiple strategies to increase the yield on your yLocker tokens. However, in practice, it only requires one simple strategy to farm the `YearnBoostedStaker` staking contract.

Once a week, the vault claims its boosted share of stablecoins from the yLocker staker contract, swaps it for more yLocker tokens, and deposits it back into the staker. On top of that, the Auto-Compounder vault is whitelisted, allowing it to earn max boost immediately on all reinvested yLocker tokens.

The vault charges a 10% performance fee.

## Deployment Addresses

- yLockers Registry: 0x262be1d31d0754399d8d5dc63B99c22146E9f738 (https://etherscan.io/address/0x262be1d31d0754399d8d5dc63B99c22146E9f738)

- Or See individual yLocker pages for their specific deployed contracts


overview

overview

# overview


Curating On Term

Curating On Term

Live Vaults

# Curating On Term

![image](https://docs.yearn.fi/assets/images/term-c2099da4cf57251d75da26c6da8c13fa.jpg)

Term Finance enables noncustodial, fixed-rate over-collateralized lending on-chain. Yearn-curated Term Vaults take the deposited underlying asset and allocate it into a Yearn v3 allocator or a single-strategy vault. When a borrower requests funds, the requested amount is withdrawn from the underlying Yearn vault. The borrowing rate is targeted to be at least 1-2% more than the 30-day average APY of the Yearn vault where the funds are deposited. This design ensures that Term Vault depositors always earn at least the base yield provided by Yearn v3 vaults.

## Live Vaults

- USDS Vault (https://app.term.finance/vaults/0xe852db931ac6f02490a32695f09ee79a31f53821/1) on Mainnet


Curating On Morpho

Curating On Morpho

Morpho Vaults

Roles

User Flow

Yearn Morpho Lender Strategies

Live Morpho Vaults

YFI Maxi

# Curating On Morpho

![image](https://docs.yearn.fi/assets/images/morpho-9b910dcf139687e4ad7b168a74a301c8.jpg)

Morpho was the first chapter of our curation story. It has been a successful one, and will not be the last.

- $200M+ in assets. More info on DefiLlama (https://defillama.com/protocol/yearn-curating)

- 10+ vaults on 4 chains

- 5+ custom markets created

## Morpho Vaults

Morpho is a permissionless, isolated money market protocol where each market consists of a single collateral and a single loan asset. Morpho Vaults follow the ERC-4626 standard and lend deposited assets into these underlying Morpho markets. The markets are selected by the curator of the vault, who has the ability to reallocate funds, set supply caps, and add or remove markets.

### Roles

Yearn's Morpho vaults are managed by role:

- `Owner`: This role, which can update vault configurations, is assigned to Yearn's Security and Monitoring (SAM) 4/7 multisig, which has members from Yearn's different teams and is globally distributed.

- `Curator`: The curator role is set to a multisig 2/3 to enable flexibility and speed in managing the vaults.

- `Guardian`: This role that has the ability to pause a vault in case of emergency. Yearn's yChad multisig is the guardian for all our vaults. yChad is an optimal guardian because it has extensive experience managing similar, crucial roles for the rest of the Yearn ecosystem.

- `Reallocator`: This role that has the ability to reallocate the vault's assets. Our bots (managed by EOA) hold the `reallocator` role.

- `Timelock`: set to 72 hours to enable the Guardian and users to react if needed.

## User Flow

Users can engage with Yearn-curated Morpho Vaults in three ways:

-

Direct Deposit to Yearn-curated Morpho Vaults: Users can deposit directly (typically via the Morpho UI) into a Yearn-curated Morpho Vault.

- They earn native lending APY on their assets

- Plus MORPHO rewards

- Performance fees is 5-10% of the native lending APY, excluding rewards APY.

-

Deposit into Yearn Morpho Lender Strategies: These are a Yearn strategies that lend to Yearn-curated Morpho Vaults and auto-compound MORPHO rewards.

- Users earn native lending APY

- Plus additional yield from compounded MORPHO, converted into more of the underlying asset

- No additional performance fees are charged.

-

Deposit into Yearn V3 Allocator Vaults: Users can also deposit into a single-asset Yearn V3 Vault that dynamically allocates across multiple strategies.

- One of these strategies will be a Yearn Morpho Lender (from #2)

- This means their deposits ultimately flow into the Yearn-curated Morpho Vault

- They benefit from native lending APY and compounded MORPHO rewards, all wrapped inside a diversified yield-optimized strategy

- Yearn V3 vaults have a 10% performance fee because vaults funds are managed between multiple strategies and protocols. More info on Yearn V3 vaults (https://docs.yearn.fi/getting-started/products/yvaults/v3).

### Yearn Morpho Lender Strategies

To enjoy maximum yield, users can deposit into the Yearn Morpho Lender Strategy. Check out Yearn Morpho Compounder strategies (https://yearn.fi/v3?types=single&search=morpho%20yearn) and deposit to earn juicy yields.

### Live Morpho Vaults

If you prefer depositing directly into the Morpho vaults, we are live on the following chains:

- Mainnet (https://app.morpho.org/ethereum/earn?curatorAddressesFilter=0xe5e2Baf96198c56380dDD5E992D7d1ADa0e989c0%2C0xFEaE2F855250c36A77b8C68dB07C4dD9711fE36F%2C0x518C21DC88D9780c0A1Be566433c571461A70149%2C0xfd99a19Fcf577Be92fDAB4ef162c1644BB056885)

- Katana (https://app.morpho.org/katana/earn?curatorAddressesFilter=0xe5e2Baf96198c56380dDD5E992D7d1ADa0e989c0%2C0xFEaE2F855250c36A77b8C68dB07C4dD9711fE36F%2C0x518C21DC88D9780c0A1Be566433c571461A70149%2C0xfd99a19Fcf577Be92fDAB4ef162c1644BB056885)

- Base (https://app.morpho.org/base/earn?curatorAddressesFilter=0xe5e2Baf96198c56380dDD5E992D7d1ADa0e989c0%2C0xFEaE2F855250c36A77b8C68dB07C4dD9711fE36F%2C0x518C21DC88D9780c0A1Be566433c571461A70149%2C0xfd99a19Fcf577Be92fDAB4ef162c1644BB056885)

- Arbitrum (https://app.morpho.org/arbitrum/earn?curatorAddressesFilter=0xe5e2Baf96198c56380dDD5E992D7d1ADa0e989c0%2C0xFEaE2F855250c36A77b8C68dB07C4dD9711fE36F%2C0x518C21DC88D9780c0A1Be566433c571461A70149%2C0xfd99a19Fcf577Be92fDAB4ef162c1644BB056885)

### YFI Maxi

For Yearn lovers and YFI holders, we have a special Morpho Market YFI/USDC (https://app.morpho.org/ethereum/market/0x973e9dd45799efe8775417bcc420a3ab84a583587b2108985746e2fe201d0c83/yfi-usdc) where users can deposit YFI as collateral and borrow USDC.


Yearn Curation

Yearn Curation

Our Origin Story

Vault Tiers

How We Decide Where to Deploy Funds

Keeping Things Running Smoothly

Monitoring

Morpho and other Rewards

# Yearn Curation

![image](https://docs.yearn.fi/assets/images/yearning-f67db7f425e16c327c1ea73466b4bc45.jpg)

## Our Origin Story

Yearn Curation started from an internal need to handle risk scores for Yearn strategies that deposit into Morpho Vaults. Each vault has its own curator and each curator has different risk appetites. Morpho Vault code is immutable, but the vault's composition changes. Curators can add and remove markets from vaults, and allocations to markets can change so that the vaults no longer match their previous risk scores. So we need to be able to react and update risk scores dynamically. To handle this flow, we build a monitoring stack for the Morpho Vaults used by Yearn V3 strategies. This risk monitoring captures events and triggers alerts when these vaults are not behaving as expected. You can read about how our monitoring works in the monitoring section (https://docs.yearn.fi/getting-started/products/curating/introduction#monitoring) of this page, and on our GitHub repository (https://github.com/yearn/monitoring-scripts-py/tree/main/morpho).

With the monitoring stack already built, and the prerequisite knowledge about risk management already in-house, it made sense to take the next step and start curating on Morpho ourselves to make sure our strategies are always in line with our risk appetites.

## Vault Tiers

We sort our vaults into three risk tiers:

- Normie: These vaults stick mostly to the big, well-known crypto markets (“blue-chips”). The goal here is steady, reliable yield with the lowest possible chance of things going sideways.

- OG: These vaults dip into markets that offer potentially higher yields but come with a bit more risk. They correspond to Yearn’s internal “risk level 2”.

- Degen: These vaults are for those comfortable with higher risk for potentially even higher yields. They correspond to Yearn’s internal “risk level 3” and above.

## How We Decide Where to Deploy Funds

This is the most important thing we do. Choosing which markets to support and how much to send to each directly impacts the vault’s risk and its APY.

We don’t just guess! We use on-chain data and simulations to calculate how these markets perform. The simulations look at market liquidity, asset liquidity, defined caps, and more. Based on this, we can take a few actions:

- Adding New Markets: When we find a good, safe market that fits the vault’s risk level, we can add it in.

- Tweaking Allocations: Markets change! We constantly watch them and shift funds around to keep the vault optimized for the best risk-adjusted yield. Our automated systems check this hourly and reallocate if the potential APY boost is worth the gas cost. To avoid extremely high utilization, the optimization always targets a max of 95% utilization. This keeps the system liquid while still maintaining strong yield performance.

- Setting Supply Caps: We limit how much of the vault’s total funds can go into any single market. This prevents putting too many eggs in one basket. These caps aren’t static; they’re adjusted based on real-time on-chain liquidity and how close borrowers are to being liquidated. If slippage (the price impact of selling collateral during liquidations) looks high, we will lower the cap for that market.

## Keeping Things Running Smoothly

Once a vault is set up, the job isn’t done. Market conditions, borrowing demand, and risks can change fast, so we’re always monitoring and ready to make adjustments.

- Playing it Safe: We constantly check on-chain liquidity on DEXs for potential liquidation capacity and monitor borrower health on the Morpho market. We evaluate the collateral of risky positions and compare it with available on-chain DEX liquidity to adjust the cap accordingly. We also aim to avoid overly utilized markets to ensure there’s always some breathing room for withdrawals.

- Yield Optimization: We analyze which markets are offering the best returns for their risk level and shift funds accordingly. Our goal is always the best risk-adjusted yield, not just the highest yield. And we use our models to predict how yield might change based on time market allocation.

Our strategy boils down to deeply understanding and managing risk. We use:

- Frequent Data Checks: Looking at liquidity, volatility, potential slippage, risky positions.

- Automated Optimization: Our tools constantly work to find the best allocations and adjust safety caps.

- Sensible Guardrails: A 72-hour time-lock for major changes gives everyone time to react if needed, and specific roles (Guardian, Reallocator, Owner) ensure actions are taken by the right parties with the right permissions.

- Monitoring: We monitor assets and protocols that we use. From governance decisions to contract upgrades, on-chain liquidity to borrower health on the lending market, and other key risk factors.

By combining automated optimization with careful, real-time monitoring and a risk-first mindset, we aim to provide curated lending vaults that are both high-performing and aligned with Yearn’s safety standards. This means Yearn users can confidently use these vaults, and lending market users get access to expertly managed options.

### Monitoring

We don’t just guess what might happen – we build tools to watch it closely. Our monitoring system keeps tabs on important numbers and potential risks across all the DeFi protocols Yearn uses.

Our monitoring system is designed to track key metrics and potential risks across various DeFi protocols integrated with Yearn.
Capabilities include:

- Governance Tracking: Observing governance activities, including scheduled timelock transactions using Tenderly Alerts (https://docs.tenderly.co/alerts/intro-to-alerts), multisig queued transactions (https://github.com/yearn/monitoring-scripts-py/blob/main/safe/main.py) on safe, and critical function calls across protocols like Aave (https://github.com/yearn/monitoring-scripts-py/tree/main/aave), Compound (https://github.com/yearn/monitoring-scripts-py/tree/main/compound), Maker (https://github.com/yearn/monitoring-scripts-py/tree/main/maker), Morpho (https://github.com/yearn/monitoring-scripts-py/tree/main/morpho), Ethena (https://github.com/yearn/monitoring-scripts-py/tree/main/ethena) and others (https://github.com/yearn/monitoring-scripts-py/tree/main/README.md).

- Peg Stability: Checking exchange rates for LSTs/LRTs (https://github.com/yearn/monitoring-scripts-py/tree/main/lrt-pegs) (like stETH, ezETH) and stablecoins in key liquidity pools, alerting on significant depegs.

- Market Risk Metrics: For specific protocols like Morpho (https://github.com/yearn/monitoring-scripts-py/tree/main/morpho), Euler (https://github.com/yearn/monitoring-scripts-py/tree/main/euler), monitoring composite vault/market risk levels based on asset allocations and individual risk scores.

- Bad Debt Monitoring: Tracking protocol bad debt levels, often using external data sources like Risk DAO (https://github.com/Risk-DAO/simulation-results), alerting if thresholds are breached (https://github.com/yearn/monitoring-scripts-py/blob/main/bad-debt/bad-debt-trigger.py).

- Market Utilization: Monitoring asset utilization rates in lending markets and sending alerts when utilization approaches critical levels.

- Supply Caps: Calculating supply caps multiple times a day and alerting if the cap is too high and should be lowered. We don't immediately lower the supply cap in Morpho contracts, but we lower it in our internal reallocation configuration. This allows us to keep the vault's allocation below calculated caps and set higher caps if the market gets healthier without waiting for the 3-day timelock delay. If the caps remain high over a long period of time, we will lower the cap in the Morpho contracts to ensure maximum safety.

- Collateral Liquidity: Calculating liquidity multiple times a day to verify that collaterals backing risky borrowing positions have enough on-chain liquidity. This assures smooth liquidations for the borrowed asset without slippage, and minimizes the risk that a position becomes unprofitable to liquidate and lead to bad debt in lending vaults.

Alerts are primarily delivered via Telegram, triggered by scheduled GitHub Actions running Python scripts or real-time Tenderly alerts based on on-chain events.

For more details, check our GitHub monitoring repository (https://github.com/yearn/monitoring-scripts-py) and detailed documentation generated by DeepWiki (https://deepwiki.com/yearn/monitoring-scripts-py/). This is only part of our monitoring stack that we have open sourced.

### Morpho and other Rewards

Yearn pioneered the concept of auto-compounding strategies and yield optimization. Morpho markets provide additional rewards in the form of tokens, which can be auto-compounded for more underlying assets. Each deployed Morpho vault will have a corresponding Yearn vault. Deposit and get on with your life. The additional rewards will be compounded for you.


yBOLD

yBOLD

Get yBOLD

Earn Yield on yBOLD

How It Works

Why Use yBOLD?

Risks

Integrations

# yBOLD

yBOLD is Yearn's BOLD tokenized Stability pool product. It is designed to tokenize the different benefits of a BOLD-in-Stability-Pool position in a simple, user-friendly way. Let's review the basics of yBOLD:

- 1 yBOLD represents 1 BOLD deposited in one of Liquity V2's Stability Pools

- They are always redeemable for the underlying BOLD without any withdrawal fees or waiting period

- They have no transfer restrictions and thus can always be swapped in DEX pools or used in other DeFi integrations

## Get yBOLD

If you have BOLD tokens, you can convert them to yBOLD either by minting yBOLD at a 1:1 rate or buy yBOLD with BOLD (or another token) using CowSwap, which may or may not get you a better rate.

## Earn Yield on yBOLD

There are 2 main ways to earn yield on your yBOLD; (1) depositing to the Curve LP to earn trading fees and CRV emissions (AKA lp-yBOLD), or (2) staking it in the yBOLD Auto-Compounder vault (AKA ysyBOLD) to earn more yBOLD.

## How It Works

When you deposit BOLD into yBOLD, Yearn routes your funds into the different Liquity V2 Stability Pools. Revenue for Stability Pool depositors comes from (1) liquidation fees and (2) 75% of the system's interest rate earnings. When you stake yBOLD, you'll receive ysyBOLD (Staked Yearn BOLD). Over time, the value of ysyBOLD increases relative to yBOLD as rewards compound automatically.

## Why Use yBOLD?

TLDR: Highest rewards, lowest risk.

-

Auto-Compounding: Liquidation rewards and protocol earnings are automatically re-invested into the Stability Pool, growing your position.

-

Auto-optimizing: The allocation between the different stability pools is re-evaluated every 30 minutes and if there's a more profitable allocation, the vault makes the change automatically.

-

Optimized rewards dumping: Instead of using hardcoded swap paths, Yearn uses a Dutch Auction to allow for MEV bots to compete to provide you with the best price.

-

No oracles: No oracles are being used to price the collateral token rewards.

-

Immutable: yBOLD is designed with immutability in mind. A few months after launch, once we're confident no funny stuff happens, we'll revoke any privileged rights (which are almost non-existent anyway).

-

Composable: yBOLD and ysyBOLD can be integrated into DeFi protocols as a productive version of BOLD.

## Risks

-

Smart Contract Risk: yBOLD relies on smart contracts from both our wrapper and Liquity V2. Use at your own risk.

-

Protocol Risk: If Liquity V2 experiences bad debt or exploits, your yield (and principal) may be impacted.

-

Stability Pool Risk: If there are losses in the Stability Pool, or we are not able to sell the collateral rewards at a favorable price, the strategy could experience losses. If such a scenario ever happens, the strategy automatically works towards refunding any losses in yBOLD.

## Integrations

yBOLD and ysyBOLD can be used in protocols that support ERC-4626 tokens. If you're building an integration or need help, reach out on Telegram (https://t.me/yearnfinance/) or Discord (https://discord.gg/yearn).


Vault Tokens

Vault Tokens

V1 yVault Tokens

V2 yVault Tokens

V3 yVault Tokens

# Vault Tokens

yVault Tokens are like a deposit receipt. They represent a user's share of the yVault that they are participating in.

For example, if you deposit YFI in a yVault you will receive yvYFI in return. yvYFI would be the yVault Token.

If your yVault generates profit, the share price of your yVault tokens will increase. This happens because more underlying tokens are in the yVault to redeem upon withdrawal.

![""](https://i.imgur.com/3zkSnoE.png)

![""](https://i.imgur.com/yrGEVCr.png)

Once a user's liquidity is withdrawn from the yVault, their yVault Token will be burned. yVault Tokens are ERC-20 (https://ethereum.org/en/developers/docs/standards/tokens/erc-20/), meaning they can be transferred and traded as any other common Ethereum token.

The vault tokens have evolved between v1, v2, and v3, here are a couple of main differences:

## V1 yVault Tokens

- Each vault contract can use only 1 yield strategy contract.

- Vault tokens are prefixed with a leading `y`, so a v1 vault for USDC gives the user yUSDC.

## V2 yVault Tokens

- Each vault contract can use up to 20 yield strategy contracts.

- Vault tokens are prefixed with `yv`, so a v2 vault for USDC gives the user yvUSDC.

## V3 yVault Tokens

- All V3 vaults are ERC-4626 (https://ethereum.org/en/developers/docs/standards/tokens/erc-4626/) compliant.

- Vaults can be either multi-strategy (https://docs.yearn.fi/developers/v3/overview#definitions) or single-strategy (Tokenized Strategy) (https://docs.yearn.fi/developers/v3/overview#definitions).

- Multi-strategy vaults tokens are prefixed with `yv` and appended with a "category" (https://docs.yearn.fi/developers/v3/Integrating_v3#category), so a v3 vault for USDC with a category type of `1` gives the user `yvUSDC-1`.

- Single strategy vaults are prefixed with `ys`, so a v3 single strategy vault gives the user `ysUSDC`.


yVaults V3

yVaults V3

Overview

v3 yVault Improvements

Read More

# yVaults V3

![image](https://docs.yearn.fi/assets/images/v3-banner-93acc0166dd22853f5152eea551dd1b5.png)

## Overview

V3 Vaults are the newest, shiniest yVaults. More flexibility, better security, more Yearn goodness!

Yearn's v3 yVaults are a decentralized suite of yield-generating products built to fit any need. They are designed to be un-opinionated and customizable infrastructure for the world to build on, making yield generation as safe, efficient, and easy as possible for all parties.

Version 3 of yVaults iterates on Version 2 by increasing its robustness and developing Yearn’s path towards further decentralization, while keeping the same proven product (yield-bearing tokens). Version 3 has all the same functionality as Version 2, but with many more added benefits and improvements to continue to grow the Yearn ecosystem.

V3 also sees the introduction of "Tokenized Strategies". Strategies are now capable of being standalone 4626 vaults themselves. These single-strategy vaults can be used as stand-alone vaults or easily added as a strategy to a Multi-Strategy Vault.

![image](https://docs.yearn.fi/assets/images/yvaults-v3-more-detail-fe81f3237d78cfa8da477bb310d65da2.png)

## v3 yVault Improvements

Version 3 of yVaults improves on Version 2 by:

- Increasing vault modularity, allowing for smaller and safer pieces of code.

- Simplifying strategy creation, empowering strategists and reducing the chance for errors.

- Providing additional strategy functionality by implementing the Tokenized Strategy.

- Adopting ERC-4626 compatibility for easy integrations.

- Decreasing gas costs to report profits and update debts.

- Adding new product and vault types.

## Read More

V3 developer docs: https://docs.yearn.fi/developers/v3/overview

dApp: https://yearn.fi/v3

Guides V3 Interface Guide (https://docs.yearn.fi/getting-started/guides/using-yearn-v3)


yVaults v2

yVaults v2

Overview

v2 yVault Improvements

Read More

# yVaults v2

## Overview

The second iteration of yVaults are auto-compounding contracts that allow depositors to earn and compound yield on deposited assets. These are still the trusty workhorse vaults for Curve, Velodrome, and Aerodrome LP positions. They allow multiple strategies and can be automatically harvested, but they have mostly been superseded by the V3 (https://docs.yearn.fi/getting-started/products/yvaults/v3) architecture for single asset vaults and other more exotic asset types. They are not ERC-4626 compatible, nor as flexible as the newer V3 vaults.

![image](https://docs.yearn.fi/assets/images/yvaults-v2-9e37cc702495a17960aabd73daf83985.png)

## v2 yVault Improvements

- Up to 20 strategies per vault: This will increase the flexibility to manage capital efficiently during different market scenarios. Each strategy has a capital cap. This is useful to avoid over-allocating funds to a strategy that cannot increase APY anymore.

- Strategist and Guardian are the new Controllers: The Controller concept is not available in V2 yVaults and has been replaced by a Guardian and the Strategy creator (strategist). These 2 actors oversee strategy performance and are empowered to take action to improve capital management or act on critical situations.

- Automated vault housekeeping (Keep3r network): `harvest()` and `earn()` calls are now automated through the Keep3r bots network. These 2 function calls are used to purchase new underlying collateral by selling the earned tokens while moving the profits back to the vault and later into strategies. The Keep3r network takes the heavy lifting of doing these calls and running with the gas costs in exchange for Keep3r tokens. This approach unloads humans from these housekeeping tasks.

- No Withdrawal Fee: The one-time fee charged on balance upon withdrawal has been turned off for all vaults and only existed in the v1 iteration.

## Read More

V2 developer docs: https://docs.yearn.fi/developers/v2/getting-started

dApp: https://yearn.fi/vaults

Guides V2 Interface Guide (https://docs.yearn.fi/getting-started/guides/using-yearn-v2)


yVaults

yVaults

WHAT IS A yVAULT ANYWAY?

yVault Types

yVault Fee Structure

# yVaults

![Yearn Logo](https://docs.yearn.fi/img/logo.svg)

##### WHAT IS A yVAULT ANYWAY?

Yearn Vaults are like crypto savings accounts in cyberspace. You deposit your assets, and Yearn's smart contracts put them to work within the DeFi ecosystem, returning the earned yield back to you.

However, unlike a bank account - none of this takes place behind closed doors (no offense to doors). Decentralized Finance uses public blockchains, meaning you are in control of your assets and can see where they are at all times. Nothing is hidden and everything is auditable by anyone, at any time.

With the advent of v3, Vaults can now be made out of a single strategy for your assets, or a collection of multiple strategies which balance your funds between them. Users now have more control over where they want their funds to go and a wider range of risk appetites.

Go you!

Still Confused? Click here for an ELI-5 explainer (https://docs.yearn.fi/getting-started/products/yvaults/yvaults-faq#yvaults-eli-5)

## yVault Types

Over the years, Yearn has developed 3 versions of the yVault products: v1, v2, and v3. Super creative, we know!

-

v1 yVaults (https://docs.yearn.fi/developers/smart-contracts/deprecated/V1/introduction) are the OG vaults and are mostly phased out (deprecated in developer-speak).

-

v2 yVaults (https://docs.yearn.fi/getting-started/products/yvaults/v2) are the reliable, workhorse vaults that you know and love. They started focused on the Curve ecosystem and are still used when creating vaults for Curve pools.

-

v3 yVaults (https://docs.yearn.fi/getting-started/products/yvaults/v3) are the new cool vaults on the block. They are designed to interoperate using the ERC-4626 standard and have several new features to make them safer and easier to use and create.

## yVault Fee Structure

yVaults have 2 potential fees that can be charged on deposited funds:

Performance Fee: Deducted from yield earned every time a vault harvests a strategy.

Management Fee: Flat rate taken from vault deposits over a year. The fee is extracted by minting new shares of the vault, thereby diluting vault participants. This is done at the time of harvest, and calculated based on time since the previous harvest.

Prior to YIP-69 (https://gov.yearn.fi/t/yip-69-reduce-and-cap-fees-through-yrates/12588), vaults had 20% performance fees and 2% management fees, but this has changed and yVaults now have a dynamic fee structure.

Single asset vaults generally have no management fee. Fee values for all yVaults can be checked in real-time at yearn.fi (https://yearn.fi/)

-

On the yearn.fi (https://yearn.fi/) user interface, yield is displayed as net APY. This means that both fees and compounding returns are taken into consideration in the rates presented. Since harvests don't occur on a set basis, yield is usually estimated based on historical data. For more information, see How to Understand yVault ROI (https://docs.yearn.fi/getting-started/guides/how-apy-works)

-

For vaults deployed by the vault factory (https://docs.yearn.fi/developers/v2/vault-factory) the performance fee is 10% instead of 20%.


yVaults FAQ

yVaults FAQ

yVaults ELI-5

What is Gimme?

How Do Vault Tokens Work?

V1 yVault Tokens

V2 yVault Tokens

V3 yVault Tokens

# yVaults FAQ

## yVaults ELI-5

Yearn Vaults are contracts on the Ethereum blockchain—and the layer2 networks that sit atop it. They allow you to deposit cryptocurrency tokens you own and earn interest on them. When you deposit, your tokens are combined with other depositors' tokens and directed toward interest earning opportunities. How and which opportunities are chosen depends on the Strategies used by the vault. You receive a receipt token (aka a Vault Token) that can be used to retrieve your original deposit plus any interest earned.

## V1, V2, V3, Juiced... Whats the difference?

So many options! But don't worry, it isn't so complicated.

- V3 are the newest vaults. They are probably your best bet unless you can't find what you are looking for.

- V2 are older vaults, but are still used for Curve and Curve-based pools like Velodrome and Aerodrome.

- V1 vaults are the OG and not supported so you shouldn't even see them anywhere. If you do, or if you need to access funds deposited during DeFi summer, hop in the discord (https://discord.gg/yearn) and let us know.

- Juiced Vaults are (now deprecated) vaults built to use Ajna, which is a lending and borrowing protocol. They have their own frontend (https://juiced.yearn.fi/) and docs (https://docs.juiced.app/) so check those out. One thing to be aware of is that since Ajna is a lending platform, you may not be able to withdraw funds immediately if there is high borrowing demand.

## What is Gimme?

Gimme (https://gimme.mom/) is a (now deprecated) easy-to-use frontend focused on making Yearn super simple. It currently supports yVaults on Polygon and Base and will roll out other L2s soon. You can easily zap right into Yearn's single asset V3 vaults and start earning fast!

## How Do Vault Tokens Work?

yVault Tokens are like a deposit receipt. They represent a user's share of the yVault that they are participating in.

For example, if you deposit YFI in a yVault you will receive yvYFI in return. yvYFI would be the yVault Token.

If your yVault generates profit, the share price of your yVault tokens will increase. This happens because more underlying tokens are in the yVault to redeem upon withdrawal.

![image](https://i.imgur.com/3zkSnoE.png)

![image](https://i.imgur.com/yrGEVCr.png)

Once a user's assets are withdrawn from the yVault, their yVault Token will be burned. yVault Tokens are ERC-20 (https://ethereum.org/en/developers/docs/standards/tokens/erc-20/), meaning they can be transferred and traded as any other common Ethereum token.

The vault tokens have evolved between v1, v2, and v3, here are a couple of main differences:

### V1 yVault Tokens

- Each vault contract can use only 1 yield strategy contract.

- Vault tokens are prefixed with a leading `y`, so a v1 vault for USDC gives the user yUSDC.

### V2 yVault Tokens

- Each vault contract can use up to 20 yield strategy contracts.

- Vault tokens are prefixed with `yv`, so a v2 vault for USDC gives the user yvUSDC.

### V3 yVault Tokens

- All V3 vaults are ERC-4626 (https://ethereum.org/en/developers/docs/standards/tokens/erc-4626/) compliant.

- Vaults can be either multi-strategy (https://docs.yearn.fi/developers/v3/overview#definitions) or single-strategy (Tokenized Strategy) (https://docs.yearn.fi/developers/v3/overview#definitions).

- Multi-strategy vaults tokens are prefixed with `yv` and appended with a "category" (https://docs.yearn.fi/developers/v3/Integrating_v3#category), so a v3 vault for USDC with a category type of `1` gives the user `yvUSDC-1`.

- Single strategy vaults are prefixed with `ys`, so a v3 single strategy vault gives the user `ysUSDC`.

tip

Didn't find what you are looking for? Check out additional frequently asked questions and troubleshooting here (https://docs.yearn.fi/getting-started/guides/user-faq)


Yearn Principles

Yearn Principles

Trust

Autonomy

Do'ers, do.

Respect

Revere one another.

Creativity

Boxes are for squares.

Meritocracy

You are what you do.

Chaos

<3 Chaos.

Community

Humans and code.

# Yearn Principles

## Trust

## You can't build trustless systems without trust.

### Yearn runs on trust. Trust fosters strong connections and helps things run smoothly, allowing Yearn to circumvent the burdens of traditional corporate middle management. We move at the speed of trust because we believe it's the most efficient way to get things done - all our other principles are possible because we choose to trust each other.

![drawing of purple man](https://docs.yearn.fi/img/principles/trust.png)

## Autonomy

## Do'ers, do.

### Belief is great, but building is better. As a contributor, you are the person who knows what's best to do for Yearn. We don't wait for approvals or authorization, permission is self granted, and action is revered. As a self starter at Yearn you have nothing between you and the glorious horizon. The future belongs to those who do.

![drawing of man with axe and tree](https://docs.yearn.fi/img/principles/doers.png)

## Respect

## Revere one another.

### Conflict is inevitable, but it doesn't have to be destructive. We operate under the assumption that our fellow contributors are fundamentally good, reasonable, and trustworthy. Stir some hard work, talent and capability into the mix and it's easy to see why even when things go wrong, we always take the Most Respectful Interpretation of each others actions.

![drawing of woman holding weight](https://docs.yearn.fi/img/principles/revere.png)

## Creativity

## Boxes are for squares.

### Creativity is our competitive edge. When boldness is met with trust and empathy, magic occurs. We understand that the craziest ideas can spawn entirely new industries - Yearn is living proof of it. No thought is too crazy, no plan too weird, no ambition too out there. Yearn exists in a realm beyond nation state borders, but we're proud to let our freak flag fly.

![drawing of woman with flag and comet](https://docs.yearn.fi/img/principles/boxes.png)

## Meritocracy

## You are what you do.

### Yearn is a place that values ideas over identity. Whether you're a DeFi OG or a newb on the Discord, the best contributions will always be respected. We're all for personality, but never cult of personality. Here, work always trumps credentials - we don't care who you are, only what you do.

![drawing of woman holding mirror](https://docs.yearn.fi/img/principles/doers.png)

## Chaos

## <3 Chaos.

### Decentralization isn't just best for the protocol, it's also best for the people building it. The future doesn't look like a corporate strategy deck or some complex org chart. It looks like nature - messy, chaotic and full of surprises. Yearn find order from chaos, scaling in harmony with other orgs and the wider space.

![drawing of man dancing with fire](https://docs.yearn.fi/img/principles/chaos.png)

## Community

## Humans and code.

### The protocol isn't our only product. Yearn is a community of independent builders who are free to sprout new organizations and grow the network organically. Each day Yearn supports the flourishing DeFi ecosystem by uniting exceptional people around radical projects that make finance more flexible and accessible. This synergistic relationship guides Yearn to build its code and community with integrity.

![drawing of woman holding hoop](https://docs.yearn.fi/img/principles/code.png)


How to Add a Custom Token to MetaMask

How to Add a Custom Token to MetaMask

# How to Add a Custom Token to MetaMask

Follow the external guides provided by MetaMask:

- Automatic token detection (https://support.metamask.io/manage-crypto/tokens/how-to-display-tokens-in-metamask/#enhanced-token-detection)

- Adding a token using the search bar (https://support.metamask.io/manage-crypto/tokens/how-to-display-tokens-in-metamask/#adding-a-token-with-search)

- Adding a custom token (https://support.metamask.io/manage-crypto/tokens/how-to-display-tokens-in-metamask/#adding-a-token-with-address)

- Removing/hiding tokens (https://support.metamask.io/manage-crypto/tokens/how-to-display-tokens-in-metamask/#how-to-hide-tokens)

- Finding the token contract address (https://support.metamask.io/manage-crypto/tokens/how-to-display-tokens-in-metamask/#how-to-find-the-token-address)

- Adding a token using the block explorer (https://support.metamask.io/manage-crypto/tokens/how-to-display-tokens-in-metamask/#how-to-add-a-token-using-a-block-explorer)

- Adding a token using a coin listing site (https://support.metamask.io/manage-crypto/tokens/how-to-display-tokens-in-metamask/#how-to-add-a-token-using-a-coin-listing-site)


Using Yearn's V3 Vaults

Using Yearn's V3 Vaults

Connect your Wallet

Navigating to the V3 Vaults

Depositing

Withdrawing

Tools to track your funds

# Using Yearn's V3 Vaults

So you want to deposit into one of Yearn's V3 Vaults? You are in the right spot. Keep reading for a full walkthrough on how to use them.

## Connect your Wallet

First, Connect your wallet using the button at the top right corner. Multiple wallets are supported, but most people use MetaMask (https://metamask.io/), which can be downloaded for free as a Chrome extension or through the Apple and Android app stores. Make sure that your wallet is connected to the Ethereum network.

![image](https://docs.yearn.fi/assets/images/image1-5c2a69b817e827406c94cca274d4a79e.png)

## Navigating to the V3 Vaults

There is a big button, anon!

![image](https://docs.yearn.fi/assets/images/image2-8d8e684cdda9e5a7b4a8e3d2ce2e623f.png)

Our V3 vaults are currently on Ethereum, Arbitrum, Polygon, Base, and Katana, with more chains to come. Click on this button to select the network you would like to interact with:

![image](https://docs.yearn.fi/assets/images/image3-065336001fb6a97f34fc565328ca9ba6.png)

## Depositing

- Select the vault that you would like to deposit into. We will choose DAI for this walkthrough

![image](https://docs.yearn.fi/assets/images/image3_5-7f231800dabb44e3cbf2c980a21d0b31.png)

- Enter the amount of tokens you want to deposit into the vault. If you are depositing ETH, ensure you have enough ETH left over to pay for future transactions you might need to make.

![image](https://docs.yearn.fi/assets/images/image4-c287b8bec539a538f5ad7a0fb370d911.png)

- Click the 'Approve' or 'Deposit' button, depending on if you have previously approved.

![image](https://docs.yearn.fi/assets/images/image5-22dc7e601c4677cbb160664140e1b948.png)

- Your wallet will ask you to confirm the transaction. It should confirm within a minute, but if your transaction gets stuck, see this guide (https://support.metamask.io/transactions-and-gas/transactions/how-to-speed-up-or-cancel-a-pending-transaction/) on how to speed up or cancel the transaction.

![image](https://docs.yearn.fi/img/guides/using-yearn/v3/image6.png)

- When your transaction succeeds, you will see your deposited balance in the vault's interface, which should appear at the top of the vault list.

![image](https://docs.yearn.fi/assets/images/image7-61f629e798703a5331362f60657d3e3c.png)

## Withdrawing

When you're ready to withdraw:

- Select the vault that you would like to withdraw from. Click the "Withdraw" tab.

![image](https://docs.yearn.fi/assets/images/image8-2e3f823de5dedc191f004c70ebe0f11b.png)

- Enter the amount you want to withdraw, or click 'Max' to withdraw the entire balance.

- Click 'Withdraw'

- Your wallet will ask you to confirm the transaction. See step 4 above for more details.

- When your transaction succeeds, the tokens will show up in your wallet again.

## Tools to track your funds

If you would like to see how your USD balance changes while your assets are in a vault, connect your wallet to DeBank (https://debank.com/), Zerion (https://app.zerion.io/), Zapper.xyz (https://zapper.xyz), or a similar portfolio-tracking product. This is also the easiest way to tell how much profit the vault has made for you.


Using Yearn's V2 Vaults

Using Yearn's V2 Vaults

Connect Your Wallet

Navigate to the V2 Vaults

Depositing

Zapping into a Vault

Withdrawing

Tools to track your funds

# Using Yearn's V2 Vaults

So you want to deposit into on of Yearn's V2 Vaults? Great! You are in the right spot.

But before we start, are you sure you don't want to deposit into the V3 vaults? They are new and shiny with more features. You can find that walkthrough here (https://docs.yearn.fi/getting-started/guides/using-yearn-v3).

No? Ok then, keep reading for a full walkthrough on how to use V2.

## Connect Your Wallet

First, Connect your wallet using the button at the top right corner. Multiple wallets are supported, but most people use MetaMask (https://metamask.io/), which can be downloaded for free as a Chrome extension or through the Apple and Android app stores. Make sure that your wallet is connected to the Ethereum network.

![image](https://docs.yearn.fi/assets/images/image1-5c2a69b817e827406c94cca274d4a79e.png)

## Navigate to the V2 Vaults

There is a big button Anon!

![image](https://docs.yearn.fi/assets/images/image2-fcad20a3994587fe557a883eb2fb10d4.png)

Our v2 Vaults are currently on Ethereum, Fantom, Arbitrum, Base, and Optimism with more to come. Click on this button to select the network you would like to interact with:

![image](https://docs.yearn.fi/assets/images/image3-38b2c22111982e7196a92141c7b7f92c.png)

## Depositing

- Select the vault that you would like to deposit into. We will choose USDC for this walkthrough

![image](https://docs.yearn.fi/assets/images/image3_5-b45d5fe301757564117d4410571a37ee.png)

- Enter the amount of tokens you want to deposit into the vault. If you are depositing ETH, ensure you have enough ETH left over to pay for future transactions you might need to make.

![image](https://docs.yearn.fi/assets/images/image4-33140fcff786153bff732a68a50d7c08.png)

- Click the 'Approve' or 'Deposit' button, depending on if you have previously approved.

- Your wallet will ask you to confirm the transaction. It should confirm within a minute, but if your transaction gets stuck, see this guide (https://metamask.zendesk.com/hc/en-us/articles/360015489251-How-to-Speed-Up-or-Cancel-a-Pending-Transaction) on how to speed up or cancel the transaction.

![image](https://docs.yearn.fi/img/guides/using-yearn/v2/metamask-confirm.png)

- When your transaction succeeds, you will see your deposited balance in the vault's interface, which should appear at the top of the vault list.

![image](https://docs.yearn.fi/assets/images/image6-025a2fc3d9996390159398c7e941add4.png)

### Zapping into a Vault

If you don't have the required token for the vault that you would like to deposit in, Yearn provides a zapping feature so you can deposit any token into any vault (zapping fees are explicit in the UI):

![image](https://docs.yearn.fi/assets/images/image8-a37922e2c0b2f9c42423fcdd59e73ee5.png)

The Zap provider can be set on the same page:

![image](https://docs.yearn.fi/assets/images/image9-06164c7ae5d7ba6ad47a7b1d34071c30.png)

You can change slippage settings in the UI right next to the deposit/withdraw button:

![image](https://docs.yearn.fi/assets/images/image11-2e98968d3af20dc0fc1a3fabb4bdf018.png)

## Withdrawing

When you're ready to withdraw:

- Select the vault that you would like to withdraw from. Click the "Withdraw" tab.

![image](https://docs.yearn.fi/assets/images/image7-7a0b30d23f57712491d69e95bcfd01cc.png)

- Enter the amount you want to withdraw, or click 'Max' to withdraw the entire balance.

- Click 'Withdraw'

- Your wallet will ask you to confirm the transaction. See step 4 above for more details.

- When your transaction succeeds, the tokens will show up in your wallet again.

Zapping also works on withdrawal, so you can receive any desired token:

![image](https://docs.yearn.fi/assets/images/image10-74125e9a88f918631debaf32af0701ae.png)

## Tools to track your funds

If you would like to see how your USD balance changes while your assets are in a vault, connect your wallet to Zapper.fi (https://zapper.fi) or a similar portfolio-tracking product. This is also the easiest way to tell how much profit the vault has made for you.

Your balance WILL NOT increase continuously. Profit will be distributed to your share of the vault when the harvest() function is called, which happens on a fluctuating basis.

Community resources to monitor your returns:

- Zapper (https://zapper.fi/)

- Zerion (https://app.zerion.io/)

- DeBank (https://debank.com/)