Frequently Asked Questions and Troubleshooting
I don't see my deposit, where is it?
If you deposited into a Yearn Vault and then click the "withdraw" tab and don't see your tokens, don't worry, they are probably staked!
The default "deposit" action in yVaults with a gauge or other extra rewards is to deposit your tokens in the yVault and stake the yVault token for extra rewards. To see your yVault tokens, click on the "veYFI BOOST" tab (it may be named something else like "staking BOOST") next to the withdraw tab. You should be able to unstake your vault tokens there and then withdraw.
Update your default deposit settings
If you want to change the default deposit behavior to only deposit and not also stake the vault tokens, you can change that setting by clicking on the gear icon to the right of the tabs and unchecking "stake automatically" at the bottom of the menu that opens up.
My veYFI rewards are lower than expected, Why?
veYFI rewards are variable depending on how much veYFI your wallet holds. If you don't have veYFI, you will only get 10% of the maximum reward amount shown. In the image below, note the range of rewards APY. Without any veYFI, a deposit will earn a 1.16% boost, paid in dYFI.
If you don't have veYFI, you can deposit and stake your tokens using liquid lockers. By doing this you use the liquid locker's veYFI to boost your deposit.
Read more about veYFI, boosts, dYFI and liquid lockers on the veYFI page
And remember, you have to consider transaction costs when using Yearn. If using Ethereum mainnet, prices for transactions vary from a few dollars to tens or hundreds of dollars, depending on chain congestion (Yearn has no control over this). If you are depositing lower amounts (<$500-1000), you may want to consider using Yearn on an L2 so fees don't negate your interest earned.
A Website Interaction isn't Working
If an interaction on the website isn't working or your transaction doesn't go through on the Yearn UI (stuck with a spinning loading circle), there are a few things you can do:
- Perform a hard refresh on the web page:
ctrl+shift+R
on Windows,cmd+shift+R
on Mac. - Try using a different browser or wallet provider.
- If on mobile, try using the desktop version, and vice versa
- Change your wallet RPC for the network you are transacting on. This is the data endpoint that your wallet talks to to pull blockchain data.
- Here is a website with lists of different chain RPCs: https://chainlist.org/
- If you connect your wallet to the chainlist site, you can add new RPCs directly from there.
- If none of the above work, you can interact with Yearn smart contracts via a block explorer. See the next entry for more information on how to do that.
Using a block explorer to interact with Yearn contracts
Using a block explorer is advanced and if you have not used one before, we only recommend it to withdraw from a vault that you cannot access from the yearn.fi website, or in an emergency. Yearn, and its website, are in active developement, so issues with the website should be fixed quickly upon reporting them. For many issues it is better to wait for a website fix.
If you need help, come by the discord and open a support ticket.
All of the smart contracts that you will interact with from Yearn's website live on Ethereum or one of its layer-2 networks. We have worked to make the experience of interacting with the contracts as easy as possible via the website, but sometimes something goes wrong and the website may not work. If that happens, you can interact with the underlying contracts directly with a block explorer like Etherscan.
Each network has its block explorer, and many have more than one. The most popular is Etherscan and most networks have a version of it for their users to use.
Network Name | Etherscan URL |
---|---|
Ethereum Mainnet | https://etherscan.io/ |
Polygon | https://polygonscan.com |
Optimism | https://optimistic.etherscan.io |
Base | https://basescan.org |
Arbitrum | https://arbiscan.io/ |
GnosisChain | https://gnosisscan.io/ |
Fantom | https://ftmscan.com |
All of these sites should look and feel and work the same way.
Finding the right Smart Contract
You can find the address of the smart contract that you want to interact with on the Yearn website. It is a 42-digit alphanumeric string. If you navigate to a vault page, the address is listed directly below the name. Click on the address to copy it to the clipboard.
You should confirm that your vault tokens are not staked. On the yearn website, make sure that they show up when trying to withdraw. If not they could be staked in a rewards contract. You can also withdraw from staking contracts on etherscan, but that is outside the scope of this article. So if this applies to you, come to the discord and open a ticket and someone will be able to walk you through the process.
Once you have it copied, go to etherscan.io (or its equivalent for other chains) and paste it into the search bar. Then hit enter and it will bring up a page with information about the contract.
Interacting with the Contract
On the landing page, you can see recent transactions that have interacted with the contract.
To interact with the contract, you will need to click on the Contract
button.
Once you click on the Contract
button you will see 3 new tabs: Code
, Read Contract (as Proxy)
, and Write Contract (as Proxy)
.
- The
Code
tab will show you the source code for the smart contract - The
Read
tab allows you to query values on the contract like the contract name, user balances, etc. - The
Write
tab allows you to perform transactions using the contract, like depositing and withdrawing.
To confirm you are looking at the correct contract, click the Read
tab and find the name
function in the list and click on it. It should show the vault name (i.e. yvUSDC-1 yVault)
Withdrawing from a vault using Etherscan
-
Click on the
Read Contract as Proxy
button. -
Click on the 🔴
Connect to Web3
button and connect the wallet you used to deposit.
-
There are different steps depending on what version vault you are using, so lets check the version.
- Find the apiVersion field and click on it.
- If the number starts with 0 (i.e. 0.4.6) then it is a V2 vault.
- If the number starts with 3 (i.e. 3.0.4) then it is a V3 vault.
Once you know the vault type, go on to the next step.
If a V2 Vault:
- Click on
Write Contract as Proxy
- Find the first
withdraw
function. This one should only have a button that says "Write" with no additional fields. - Click
Write
and submit the transaction in your wallet.
Once the transaction is approved you will be fully withdrawn from the Vault.
If a V3 Vault:
- Withdrawing from V3 vaults requires 3 arguments to withdraw: The amount, the owner, and the recipient.
- Both the owner and the recipient will be your wallet address.
- To get the amount, you need get your total balance by clicking on
balanceOf
and then entering your wallet address in the address field. Click query and you should get a long number that is your balance. Copy this balance to use in later steps. - Click on
Write Contract as Proxy
- find the first
redeem
function. It will have 3 fields for arguments. Enter the copiedbalanceOf
value into theshares
field, and your wallet address into both thereceiver
andowner
fields. - Click
Write
and submit the transaction in your wallet.
Once the transaction is approved you will be fully withdrawn from the Vault.
I have rSWELL tokens in a Yearn Vault but don't see them anywhere
If you are looking at a wallet or portfolio tracker like Debank, Zerion, or Zapper and it shows you have Swell tokens in a V3 yearn Vault, you need to go to the Swell website to withdraw them: https://app.swellnetwork.io/stake/rswell
The rSWELL vault was built on Yearn V3 contracts but was not deployed by yearn, so we don't show it on our website, but they will!
I see I have a DSProxy but don't know what that is
A DSProxy is a "smart account" similar to a gnosis safe that was used by projects like DefiSaver, instaDapp, Balancer, and others. You most likely have a wallet that controls it.
You may be able to access and operate your DSProxy using the defisaver website.