From 8f9326a440572b49bf10d38200fdb599e4976628 Mon Sep 17 00:00:00 2001 From: Marco Guaspari Worms Date: Tue, 20 Feb 2024 13:11:38 -0300 Subject: [PATCH] Docs Refactor (#388) * update intro * update vaults information * vaults updates 2 * update ycrv * move woofy to r&d section * update broken erc20 link * update ycrv lp info * add veToken holdings * add info about zapping fees * update custom token guides * fix ycrv factory pool link * add refactor files * update titles * update titles * update header * move v3 up * fix: yearn.vision info * fix: wording ycrv overview * lowercase * delete extra word * add polygon network * fix: ycrv sidebar * update ylockers headers * refactor r & d to deprecated * update yEarn * update woofy page * remove: llama pay info * refactor v3 sidebar * fix dead link * fix dead link * Update sidebarsContributing.js * Update sidebarsGettingStarted.js * Update veyfi.md * Update veyfi.md * Update sidebarsGettingStarted.js * Create veyfi.md * Update sidebarsGettingStarted.js * Delete docs/contributing/governance/veyfi.md * update homepage * update footer * Update docusaurus.config.js * Update docusaurus.config.js * update snapshot link * Update homepageFeatures.js * update intro vaults link * Update yearn-data.md remove dead links form data page --------- Co-authored-by: 0xBasically <0xBasic@yearn.finance> --- docs/contributing/operations/budget.md | 2 - .../developers/v2}/yearn-api.md | 0 docs/developers/v2/yearn-data.md | 8 -- .../developers/v2}/yearn-lens.md | 0 .../how-to-add-a-custom-token-to-metamask.md | 56 ++------ docs/getting-started/intro.md | 5 + .../products}/veyfi.md | 6 +- .../products/ylockers/ycrv/faq.md | 8 +- .../products/ylockers/ycrv/overview.md | 14 +- .../products/ylockers/yprisma/overview.md | 2 +- .../products/yvaults/overview.md | 4 +- docs/getting-started/products/yvaults/v3.md | 7 +- .../products/yvaults/vault-factory.md | 2 +- .../products/yvaults/vault-tokens.md | 59 +++------ .../products/yvaults/vaults-and-strategies.md | 12 -- docs/getting-started/using-yearn.md | 12 +- .../delegated-funding-dao-vaults.md | 2 +- .../{r-and-d => deprecated}/stablecredit.md | 0 .../{r-and-d => deprecated}/vecrv-boosts.md | 6 +- .../deprecated}/woofy.md | 4 + .../{r-and-d => deprecated}/yearn.md | 4 +- docs/resources/{ => deprecated}/ygift.md | 4 + .../{r-and-d => deprecated}/ytrade.md | 2 +- docusaurus.config.js | 61 +++++---- sidebars/sidebarsContributing.js | 5 - sidebars/sidebarsDevelopers.js | 78 ++++++----- sidebars/sidebarsGettingStarted.js | 48 +++++-- sidebars/sidebarsResources.js | 5 +- src/homepageFeatures.js | 18 +-- .../version-0.4.6/yearn-sdk/yearn-stack.md | 125 ------------------ 30 files changed, 203 insertions(+), 356 deletions(-) rename {versioned_docs/version-0.4.6 => docs/developers/v2}/yearn-api.md (100%) rename {versioned_docs/version-0.4.6/yearn-lens => docs/developers/v2}/yearn-lens.md (100%) rename docs/{contributing/governance => getting-started/products}/veyfi.md (99%) delete mode 100644 docs/getting-started/products/yvaults/vaults-and-strategies.md rename docs/resources/{r-and-d => deprecated}/delegated-funding-dao-vaults.md (95%) rename docs/resources/{r-and-d => deprecated}/stablecredit.md (100%) rename docs/resources/{r-and-d => deprecated}/vecrv-boosts.md (98%) rename docs/{getting-started/products => resources/deprecated}/woofy.md (98%) rename docs/resources/{r-and-d => deprecated}/yearn.md (97%) rename docs/resources/{ => deprecated}/ygift.md (98%) rename docs/resources/{r-and-d => deprecated}/ytrade.md (96%) delete mode 100644 versioned_docs/version-0.4.6/yearn-sdk/yearn-stack.md diff --git a/docs/contributing/operations/budget.md b/docs/contributing/operations/budget.md index 8397fff413..58501ca0d9 100644 --- a/docs/contributing/operations/budget.md +++ b/docs/contributing/operations/budget.md @@ -9,6 +9,4 @@ The team recommendations to make requests are: - When coordinating efforts with others, apply as a team (not as separate individuals) - Shorter timeframes of 1 to 3 months may have better rates of approval -All Yearn payments streams can be visualized at our [LlamaPay Streams Dashboard](https://llamapay.io/streams?chainId=1&address=ychad.eth) - ### [Send a budget request on GitHub](https://github.com/yearn/budget/issues/new/choose) \ No newline at end of file diff --git a/versioned_docs/version-0.4.6/yearn-api.md b/docs/developers/v2/yearn-api.md similarity index 100% rename from versioned_docs/version-0.4.6/yearn-api.md rename to docs/developers/v2/yearn-api.md diff --git a/docs/developers/v2/yearn-data.md b/docs/developers/v2/yearn-data.md index 0291e900b6..533318e302 100644 --- a/docs/developers/v2/yearn-data.md +++ b/docs/developers/v2/yearn-data.md @@ -27,11 +27,3 @@ yDaemon is a RESTful API that hydrates subgraph responses with more data, like A - **Source:** https://github.com/yearn/ydaemon - **Docs:** https://ydaemon.yearn.farm/ - **Guide:** https://medium.com/iearn/ydaemon-one-api-to-unify-all-yearn-data-4fc74dc9a33b - -### yDaemon Data Sources - -To build the yDaemon API, data is fetched from several Yearn data sources: -- [Yearn Subgraph](https://thegraph.com/explorer/subgraph?id=5xMSe3wTNLgFQqsAc5SCVVwT4MiRb5AogJCuSN9PjzXF) as the base data source. -- [Yearn Meta](https://github.com/yearn/yearn-meta) for some basic data and information updated by the Yearn team. -- [Yearn API](https://api.yearn.fi/) for the APY computation. -- [Yearn Lens Oracle](https://etherscan.io/address/0xca11bde05977b3631167028862be2a173976ca11) for tokens and vault prices. diff --git a/versioned_docs/version-0.4.6/yearn-lens/yearn-lens.md b/docs/developers/v2/yearn-lens.md similarity index 100% rename from versioned_docs/version-0.4.6/yearn-lens/yearn-lens.md rename to docs/developers/v2/yearn-lens.md diff --git a/docs/getting-started/guides/how-to-add-a-custom-token-to-metamask.md b/docs/getting-started/guides/how-to-add-a-custom-token-to-metamask.md index c058c6d218..eec207507c 100644 --- a/docs/getting-started/guides/how-to-add-a-custom-token-to-metamask.md +++ b/docs/getting-started/guides/how-to-add-a-custom-token-to-metamask.md @@ -1,49 +1,11 @@ # How to Add a Custom Token to MetaMask -Here's how you add a custom token to MetaMask. - -## Visual Walkthrough - -### Method One -1\) Click on the `Fox` icon to bring up the Metamask prompt. - -![](https://i.imgur.com/R4K0STZ.png) - -2\) Click on the etherscan icon (besides the `Fox` icon) to view token contract details. - -3\) Confirm the token and click `Add Token`. - -![](https://i.imgur.com/W0MsHOP.png) - -### Method Two -1\) Open MetaMask and click `Assets` to see the tokens in your wallet. - -![](https://i.imgur.com/N34iMar.png) - -2\) Scroll down to the bottom and click `Add Token`. - -![](https://i.imgur.com/hRd2MD7.png) - -3\) Click `Custom Token`. - -![](https://i.imgur.com/rGbV1eT.png) - -4\) Paste the contract address for yUSD **0x5dbcF33D8c2E976c6b560249878e6F1491Bca25c** into the `Token Contract Address` field. - -![](https://i.imgur.com/6H2JhRN.png) - -5\) Click `Edit` to change the Token Symbol. - -![](https://i.imgur.com/E12XN8x.png) - -6\) Type in **yUSD** and click `Next`. - -![](https://i.imgur.com/kNkrqj3.png) - -7\) Hooray! Now you can see your balance of yUSD. Click `Add Tokens` to finish up. - -![](https://i.imgur.com/gkt6KME.png) - -8\) You're done. You'll now see yUSD in your assets list so it's easier to track and use. - -![](https://i.imgur.com/ZgtftOw.png) +Follow the external guides provided by MetaMask: + +- [Automatic token detection](https://support.metamask.io/hc/en-us/articles/360015489031-How-to-display-tokens-in-MetaMask#h_01FWH48EA3JNK6V5JXCR6XVWZD) +- [Adding a token using the search bar](https://support.metamask.io/hc/en-us/articles/360015489031-How-to-display-tokens-in-MetaMask#h_01FWH48R495MR9DQEDHJ89QNDA) +- [Adding a custom token](https://support.metamask.io/hc/en-us/articles/360015489031-How-to-display-tokens-in-MetaMask#h_01FWH492CHY60HWPC28RW0872H) +- [Removing/hiding tokens](https://support.metamask.io/hc/en-us/articles/360015489031-How-to-display-tokens-in-MetaMask#h_01FWH499MRDT5QC4R3KNPQNRWB) +- [Finding the token contract address](https://support.metamask.io/hc/en-us/articles/360015489031-How-to-display-tokens-in-MetaMask#h_01FWKCA7MJG5HT2MSZZ8DJ0QCF) +- [Adding a token using the block explorer](https://support.metamask.io/hc/en-us/articles/360015489031-How-to-display-tokens-in-MetaMask#h_01FWH752DWRBMH57M6DZRFSPQD) +- [Adding a token using a coin listing site](https://support.metamask.io/hc/en-us/articles/360015489031-How-to-display-tokens-in-MetaMask#h_01G13EJA2ZSJD1A743FVNCASNS) \ No newline at end of file diff --git a/docs/getting-started/intro.md b/docs/getting-started/intro.md index 35406b98c8..996a25d7f4 100644 --- a/docs/getting-started/intro.md +++ b/docs/getting-started/intro.md @@ -4,10 +4,15 @@ Yearn Finance is DeFi’s premier yield aggregator. Giving individuals, DAOs and The protocol is maintained by various independent developers and is governed by YFI holders. You can find brief descriptions of Yearn's core products, the governance process, and links to active communication channels below. +- https://yearn.fi/ + ## Vaults Yearn Vaults 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 also do not need to have proficient knowledge of the underlying protocols involved or DeFi, thus the Vaults represent a passive-investing strategy. +- Yearn Vaults V3: https://yearn.fi/v3 +- Yearn Vaults V2: https://yearn.fi/vaults + ## Governance The Yearn ecosystem is controlled by YFI token holders who submit and vote on off-chain proposals that govern the ecosystem. Proposals that generate majority support \(>50% of the vote\) are implemented by a 9-member multi-signature wallet. Changes must be signed by 6 out of the 9 wallet signers to be implemented. The members of the multi-signature wallet were voted in by YFI holders and are subject to change from future governance votes. Please refer to the [multisig documentation](https://docs.yearn.fi/security/multisig) for the list of multisig signers. For more info about the governance process, please consult the [Governance FAQ](https://docs.yearn.fi/resources/faq#governance) and [YIP-61: Governance 2.0](https://gov.yearn.fi/t/yip-61-governance-2-0/10460). diff --git a/docs/contributing/governance/veyfi.md b/docs/getting-started/products/veyfi.md similarity index 99% rename from docs/contributing/governance/veyfi.md rename to docs/getting-started/products/veyfi.md index afb9e10655..aad9bf15ce 100644 --- a/docs/contributing/governance/veyfi.md +++ b/docs/getting-started/products/veyfi.md @@ -1,4 +1,4 @@ -# veYFI +# Overview veYFI incorporates [YIP-56: Buyback and Build](https://gov.yearn.fi/t/yip-56-buyback-and-build/8929) funds into YFI tokenomics. Users can lock YFI tokens and receive veYFI, which allows them to boost vault rewards and vote on where bought-back YFI will be sent. @@ -8,7 +8,7 @@ Contract Address: [`0x90c1f9220d90d3966fbee24045edd73e1d588ad5`](https://ethersc Governance Forum Thread: https://gov.yearn.fi/t/yip-65-evolving-yfi-tokenomics -## Overview +## veYFI Overview - Receives bought-back YFI as reward. - Locking is similar to the ve-style program of Curve. @@ -90,7 +90,7 @@ dYFI (previously specified as oYFI) is a token introduced as part of Yearn's veY - Governance Forum Thread: https://gov.yearn.fi/t/yip-73-activate-veyfi-rewards-with-oyfi-gauges -### Overview +### dYFI Overview - Implements the ERC-20 standard. - Gives its bearer the right to redeem an equivalent YFI in exchange for ETH. diff --git a/docs/getting-started/products/ylockers/ycrv/faq.md b/docs/getting-started/products/ylockers/ycrv/faq.md index 00ef9b4994..eff84b06ed 100644 --- a/docs/getting-started/products/ylockers/ycrv/faq.md +++ b/docs/getting-started/products/ylockers/ycrv/faq.md @@ -1,9 +1,7 @@ -# yCRV FAQ - -## Launch and Migration +# Launch and Migration FAQ ### When will yCRV launch? -Contracts are live, you can find relevant addresses [here](https://docs.yearn.fi/getting-started/products/ycrv/overview#addresses). +Contracts are live, you can find relevant addresses [here](https://docs.yearn.fi/getting-started/products/ylockers/ycrv/overview#addresses). ### Should I migrate now from yveCRV and yvBOOST? Yes! Incentives have moved to the new system. yveCRV and yvBOOST will no longer receive yield. @@ -18,4 +16,4 @@ No. After the cut-over date, all incentives will move to the new yCRV system. Nope! You can migrate anytime in the future. Contracts are trustless and migrations cannot be stopped. ### 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. \ No newline at end of file +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. diff --git a/docs/getting-started/products/ylockers/ycrv/overview.md b/docs/getting-started/products/ylockers/ycrv/overview.md index db836c6808..2c39c8d94e 100644 --- a/docs/getting-started/products/ylockers/ycrv/overview.md +++ b/docs/getting-started/products/ylockers/ycrv/overview.md @@ -1,4 +1,4 @@ -# yCRV +# Overview ![](https://i.imgur.com/ni42qE6.png) @@ -18,14 +18,14 @@ _or_ - Migrate from legacy tokens [yveCRV and yvBOOST](#how-yvecrv-and-veboost-functionality-was-migrated-to-ycrv). -Both operations mint yCRV to the user at a 1:1 rate. Users migrating from yvBOOST can use the zap at [y.finance](https://y.finance) to efficiently unwrap their tokens to yveCRV and migrates to yCRV in a single step. Of course, users can also choose to purchase yCRV from the new Curve factory pool [here](https://curve.fi/factory/192). +Both operations mint yCRV to the user at a 1:1 rate. Users migrating from yvBOOST can use the zap at https://yearn.fi/ycrv to efficiently unwrap their tokens to yveCRV and migrate to yCRV in a single step. Of course, users can also choose to purchase yCRV from the new Curve factory pool: https://curve.fi/#/ethereum/pools/factory-v2-280/deposit ### 'Activated'-tokens Yearn passes all benefits of its veCRV position on to yCRV users who hold one of its **activated-tokens:** - [**st-yCRV (Staking Rewards):**](#staked-ycrv) [yVault](https://medium.com/iearn/yearn-finance-explained-what-are-vaults-and-strategies-96970560432) that receives admin fees and bribes from locked CRV. -- [**lp-yCRV (Liquidity Pool Rewards):**](#lpd-ycrvcrv) yVault for CRV/yCRV LP tokens, autocompounds emissions and fees. +- [**lp-yCRV (Liquidity Pool Rewards):**](#lpd-ycrvcrv) yVault for CRV LP tokens, autocompounds emissions and fees. > Note: a third activated token, vl-yCRV, was planned but not rolled out due to a lack of demand. @@ -46,7 +46,7 @@ Under the hood, st-yCRV is a Yearn v2 vault, allowing users to sit back, relax a ![](https://i.imgur.com/3JNhzWR.png) -Liquidity Pool'd yCRV provides liquidity to the new CRV/yCRV pool on Curve, and lp-yCRV holders receive this LP fees and emissions. When you zap to this token, under the hood, you are entering an LP position in the yCRV/CRV pool and depositing the LP tokens into the lp-yCRV yVault. +Liquidity Pool'd yCRV provides liquidity to the new CRV pool on Curve, and lp-yCRV holders receive this LP fees and emissions. When you zap to this token, under the hood, you are entering an LP position in the yCRV/CRV pool and depositing the LP tokens into the lp-yCRV yVault. This is also a Yearn v2 vault with a strategy that deposits all CRV emissions generated back into the pool to grow the position. Like st-yCRV this is designed to be a set and forget token that auto harvests and auto compound rewards. @@ -54,7 +54,7 @@ Yearn will mark 1 veCRV worth of voting power for every 1 yCRV in this position ## How yveCRV and yvBOOST functionality was migrated to yCRV -yveCRV and yvBOOST are being deprecated, and there is a migration path available to users. The functionality of both was integrated into [st-yCRV](#staked-ycrv) so if you are looking for the same benefits check the [guide](https://docs.yearn.fi/getting-started/products/ycrv/guide) on how to migrate from the legacy tokens using yearn's UI +yveCRV and yvBOOST are being deprecated, and there is a migration path available to users. The functionality of both was integrated into [st-yCRV](#staked-ycrv) so if you are looking for the same benefits check the [guide](https://docs.yearn.fi/getting-started/products/ylockers/ycrv/guide) on how to migrate from the legacy tokens using yearn's UI ![](https://i.imgur.com/Htl3AgP.png) @@ -62,11 +62,11 @@ yveCRV and yvBOOST are being deprecated, and there is a migration path available - **yCRV:** [0xFCc5c47bE19d06BF83eB04298b026F81069ff65b](https://etherscan.io/token/0xFCc5c47bE19d06BF83eB04298b026F81069ff65b) - **st-yCRV (vault):** [0x27B5739e22ad9033bcBf192059122d163b60349D](https://etherscan.io/token/0x27B5739e22ad9033bcBf192059122d163b60349D) -- **lp-yCRV (DEPRECATED):** [0xc97232527B62eFb0D8ed38CF3EA103A6CcA4037e](https://etherscan.io/token/0xc97232527B62eFb0D8ed38CF3EA103A6CcA4037e) +- **lp-yCRV (DEPRECATED, The v2 pool is more efficient and has a price oracle):** [0xc97232527B62eFb0D8ed38CF3EA103A6CcA4037e](https://etherscan.io/token/0xc97232527B62eFb0D8ed38CF3EA103A6CcA4037e) - **lp-yCRV v2 (vault):** [0x6E9455D109202b426169F0d8f01A3332DAE160f3](https://etherscan.io/token/0x6E9455D109202b426169F0d8f01A3332DAE160f3) - **CRV/yCRV Curve Pool:** [0x453D92C7d4263201C69aACfaf589Ed14202d83a4](https://etherscan.io/token/0x453D92C7d4263201C69aACfaf589Ed14202d83a4) - **ZapYCRV.vy :** [0x01D7f32B6E463c96c00575fA97B8224326C6A6B9](https://etherscan.io/token/0x01D7f32B6E463c96c00575fA97B8224326C6A6B9) -- **yCRV Interface:** http://y.finance/ +- **yCRV Interface:** https://yearn.fi/ycrv ## Read More diff --git a/docs/getting-started/products/ylockers/yprisma/overview.md b/docs/getting-started/products/ylockers/yprisma/overview.md index b7b65a927b..667cee93dd 100644 --- a/docs/getting-started/products/ylockers/yprisma/overview.md +++ b/docs/getting-started/products/ylockers/yprisma/overview.md @@ -1,4 +1,4 @@ -# yPRISMA +# Overview Claim and deposit at [yprisma.yearn.fi](https://yprisma.yearn.fi) diff --git a/docs/getting-started/products/yvaults/overview.md b/docs/getting-started/products/yvaults/overview.md index 5df8f1d6b0..edbe133601 100644 --- a/docs/getting-started/products/yvaults/overview.md +++ b/docs/getting-started/products/yvaults/overview.md @@ -23,7 +23,9 @@ The old structure used before the changes brought by [YIP-69](https://gov.yearn. | Management Fee | 0% | | Performance Fee | 20% | -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 estimated based on historical data. For more information, see [How to Understand yVault ROI](https://docs.yearn.fi/getting-started/guides/how-to-understand-yvault-roi) +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-to-understand-yvault-roi) + +- For vaults deployed by the vault [factory](https://docs.yearn.fi/getting-started/products/yvaults/vault-factory) the performance fee is 10% instead of 20%. ## v2 yVault Improvements diff --git a/docs/getting-started/products/yvaults/v3.md b/docs/getting-started/products/yvaults/v3.md index 68d3993156..dac2cab49b 100644 --- a/docs/getting-started/products/yvaults/v3.md +++ b/docs/getting-started/products/yvaults/v3.md @@ -1,4 +1,5 @@ -# Vaults Version 3 +# Overview + Version 3 yVaults iterates on Version 2 by increasing robustness and developing Yearn’s path towards further decentralization, while keeping the same proven product (yield-bearing tokens) that abstract builders and users from the hard work of yield farming. Version 3 will both be able to have 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". In V3 the strategies are now capable of being standalone 4626 vaults themselves. These single-strategy vaults can be used as stand-alone vaults or as a function of the 4626 standard easily added as a strategy to any of the multi-strategy "Allocator Vaults". @@ -37,10 +38,10 @@ Periphery Modules are a separate layer of optional contracts to use with vaults [Tokenized Strategy Specification](https://github.com/yearn/tokenized-strategy/blob/master/SPECIFICATION.md) -**For More information visit the [V3 section](https://docs.yearn.fi/developers/v3/overview) of the docs.** +# Read More +**For more information visit the V3 developer section: https://docs.yearn.fi/developers/v3/overview** -# Read More - https://github.com/yearn/yearn-vaults-v3 - https://github.com/yearn/tokenized-strategy - https://medium.com/iearn/yearnv3-motivation-and-design-107840cb4844 diff --git a/docs/getting-started/products/yvaults/vault-factory.md b/docs/getting-started/products/yvaults/vault-factory.md index 8f51061524..deabc6189e 100644 --- a/docs/getting-started/products/yvaults/vault-factory.md +++ b/docs/getting-started/products/yvaults/vault-factory.md @@ -145,7 +145,7 @@ Follow these steps to create a new vault with the UI: -4. Sign the transaction and the vault will be created +4. Sign the transaction and the vault will be created (the signing interface is specific to your wallet provider, this one is [Frame](https://frame.sh/)) diff --git a/docs/getting-started/products/yvaults/vault-tokens.md b/docs/getting-started/products/yvaults/vault-tokens.md index 401819bcc8..b57430d6f9 100644 --- a/docs/getting-started/products/yvaults/vault-tokens.md +++ b/docs/getting-started/products/yvaults/vault-tokens.md @@ -4,57 +4,28 @@ **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 there are more underlying tokens in the yVault to redeem upon withdrawal. +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) -_The yvYFI token at [Etherscan](https://etherscan.io/token/0xE14d13d8B3b85aF791b2AADD661cDBd5E6097Db1#readContract), showing its name, total assets and price per share._ +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. -Once a user's liquidity is withdrawn from the yVault, their yVault Token will be burned. yVault Tokens are [ERC20](https://docs.ethhub.io/built-on-ethereum/erc-token-standards/erc20/), 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 -| Vault | Input Token | Output Token | -| :--- | :--- | :--- | -| YFI | [YFI](https://etherscan.io/token/0x0bc529c00c6401aef6d220be8c6ea1667f6ad93e) | [yvYFI](https://etherscan.io/token/0xE14d13d8B3b85aF791b2AADD661cDBd5E6097Db1) | -| 1INCH | [1INCH](https://etherscan.io/token/0x111111111117dc0aa78b770fa6a738034120c302) | [yv1INCH](https://etherscan.io/token/0xB8C3B7A2A618C552C23B1E4701109a9E756Bab67) | -| WETH | [WETH](https://etherscan.io/token/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2) | [yvWETH](https://etherscan.io/token/0xa258C4606Ca8206D8aA700cE2143D7db854D168c) | -| USDC | [USDC](https://etherscan.io/token/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48) | [yvUSDC](https://etherscan.io/token/0x5f18c75abdae578b483e5f43f12a39cf75b973a9) | -| HEGIC | [HEGIC](https://etherscan.io/token/0x584bC13c7D411c00c01A62e8019472dE68768430) | [HEGIC](https://etherscan.io/token/0x584bC13c7D411c00c01A62e8019472dE68768430) | -| DAI | [DAI](https://etherscan.io/token/0x6b175474e89094c44da98b954eedeac495271d0f) | [yvDAI](https://etherscan.io/token/0xdA816459F1AB5631232FE5e97a05BBBb94970c95) | -| WBTC | [WBTC](https://etherscan.io/token/0x2260fac5e5542a773aa44fbcfedf7c193bc2c599) | [WBTC yVault](https://etherscan.io/token/0xcb550a6d4c8e3517a939bc79d0c7093eb7cf56b5) | -| USDT | [USDT](https://etherscan.io/token/0xdac17f958d2ee523a2206206994597c13d831ec7) | [yvUDST](https://etherscan.io/token/0x7Da96a3891Add058AdA2E826306D812C638D87a7) | -| crvIB | [Curve Iron Bank Pool](https://etherscan.io/token/0x5282a4ef67d9c33135340fb3289cc1711c13638c) | [yCurve-IronBank](https://etherscan.io/token/0x27b7b1ad7288079A66d12350c828D3C00A6F07d7) | -| crvSETH | [Curve sETH Pool](https://etherscan.io/token/0xa3d87fffce63b53e0d54faa1cc983b7eb0b74a9c) | [yvCurve-sETH](https://etherscan.io/token/0x986b4AFF588a109c09B50A03f42E4110E29D353F) | -| crvstETH | [Curve stETH Pool](https://etherscan.io/token/0x06325440d014e39736583c165c2963ba99faf14e) | [yvCurve-stETH](https://etherscan.io/token/0xdcd90c7f6324cfa40d7169ef80b12031770b4325) | -| crvSBTC | [Curve sBTC Pool](https://etherscan.io/token/0x075b1bb99792c9e1041ba13afef80c91a1e70fb3) | [yvCurve-sBTC](https://etherscan.io/token/0x8414Db07a7F743dEbaFb402070AB01a4E0d2E45e) | -| crvRENBTC | [Curve renBTC Pool](https://etherscan.io/token/0x49849c98ae39fff122806c06791fa73784fb3675) | [yvCurve-renBTC](https://etherscan.io/token/0x7047F90229a057C13BF847C0744D646CFb6c9E1A) | -| crvOBTC | [Curve oBTC Pool](https://etherscan.io/token/0x2fe94ea3d5d4a175184081439753de15aef9d614) | [yvCurve-oBTC](https://etherscan.io/token/0xe9Dc63083c464d6EDcCFf23444fF3CFc6886f6FB) | -| crvPBTC | [Curve pBTC Pool](https://etherscan.io/token/0xde5331ac4b3630f94853ff322b66407e0d6331e8) | [yvCurve-pBTC](https://etherscan.io/token/0x3c5DF3077BcF800640B5DAE8c91106575a4826E6) | -| crvTBTC | [Curve tBTC Pool](https://etherscan.io/token/0x64eda51d3Ad40D56b9dFc5554E06F94e1Dd786Fd) | [yvCurve-tBTC](https://etherscan.io/token/0x23D3D0f1c697247d5e0a9efB37d8b0ED0C464f7f) | -| crvFRAX | [Curve FRAX Pool](https://etherscan.io/token/0xd632f22692fac7611d2aa1c0d552930d43caed3b) | [yvCurve-FRAX](https://etherscan.io/token/0xB4AdA607B9d6b2c9Ee07A275e9616B84AC560139) | -| crvLUSD | [Curve LUSD Pool](https://etherscan.io/token/0xed279fdd11ca84beef15af5d39bb4d4bee23f0ca) | [yvCurve-LUSD](https://etherscan.io/token/0x5fA5B62c8AF877CB37031e0a3B2f34A78e3C56A6) | -| crvSAAVE | [Curve sAave Pool](https://etherscan.io/token/0x02d341ccb60faaf662bc0554d13778015d1b285c) | [yvCurve-sAave](https://etherscan.io/token/0xb4D1Be44BfF40ad6e506edf43156577a3f8672eC) | -| crvBBTC | [Curve BBTC Pool](https://etherscan.io/token/0x410e3e86ef427e30b9235497143881f717d93c2a) | [yvCurve-BBTC](https://etherscan.io/token/0x8fA3A9ecd9EFb07A8CE90A6eb014CF3c0E3B32Ef) | -| yvBOOST | [Yearn Compounding veCRV](https://etherscan.io/token/0xc5bddf9843308380375a611c18b50fb9341f502a) | [yvBOOST](https://etherscan.io/token/0x9d409a0A012CFbA9B15F6D4B36Ac57A46966Ab9a) | +- 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. -## V1 yVault Tokens +## V3 yVault Tokens -| Vault | Input Token | Output Token | -| :----------- | :------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- | -| crvLINK | [linkCRV](https://etherscan.io/token/0xcee60cfa923170e4f8204ae08b4fa6a3f5656f3a) | [yvlinkCRV](https://etherscan.io/token/0x96Ea6AF74Af09522fCB4c28C269C26F59a31ced6) | -| crvUSDP | [usdp3CRV](https://etherscan.io/token/0x7Eb40E450b9655f4B3cC4259BCC731c63ff55ae6) | [yvusdp3CRV](https://etherscan.io/token/0x1B5eb1173D2Bf770e50F10410C9a96F7a8eB6e75) | -| crvANKR | [ankrCRV](https://etherscan.io/token/0xaA17A236F2bAdc98DDc0Cf999AbB47D47Fc0A6Cf) | [yvankrCRV](https://etherscan.io/token/0xE625F5923303f1CE7A43ACFEFd11fd12f30DbcA4) | -| yCRV\(yUSD\) | [yDAI+yUSDC+yUSDT+yTUSD](https://etherscan.io/token/0xdF5e0e81Dff6FAF3A7e52BA697820c5e32D806A8) | [yyDAI+yUSDC+yUSDT+yTUSD](https://etherscan.io/token/0x5dbcf33d8c2e976c6b560249878e6f1491bca25c) | -| crvMUSD | [musd3CRV](https://etherscan.io/token/0x1AEf73d49Dedc4b1778d0706583995958Dc862e6) | [yvmusd3CRV](https://etherscan.io/token/0x0FCDAeDFb8A7DfDa2e9838564c5A1665d856AFDF) | -| crvGUSD | [gusd3CRV](https://etherscan.io/token/0xD2967f45c4f384DEEa880F807Be904762a3DeA07) | [yvgusd3CRV](https://etherscan.io/token/0xcC7E70A958917cCe67B4B87a8C30E6297451aE98) | -| crvDUSD | [dusd3CRV](https://etherscan.io/token/0x3a664Ab939FD8482048609f652f9a0B0677337B9) | [yvdusd3CRV](https://etherscan.io/address/0x8e6741b456a074F0Bc45B8b82A755d4aF7E965dF#code) | -| crvUSDN | [usdn3CRV](https://etherscan.io/token/0x4f3E8F405CF5aFC05D68142F3783bDfE13811522) | [yvusdn3CRV](https://etherscan.io/token/0xFe39Ce91437C76178665D64d7a2694B0f6f17fE3) | -| crvUSDT | [ust3CRV](https://etherscan.io/token/0x94e131324b6054c0D789b190b2dAC504e4361b53) | [yvusdt3CRV](https://etherscan.io/token/0xF6C9E9AF314982A4b38366f4AbfAa00595C5A6fC) | -| crvHUSD | [husd3CRV](https://etherscan.io/token/0x5B5CFE992AdAC0C9D48E05854B2d91C73a003858) | [yvhusd3CRV](https://etherscan.io/token/0x39546945695DCb1c037C836925B355262f551f55) | -| crvBUSD | [yDAI+yUSDC+yUSDT+yBUSD \(bCrv\)](https://etherscan.io/token/0x3B3Ac5386837Dc563660FB6a0937DFAa5924333B) | [yyDAI+yUSDC+yUSDT+yBUSD](https://etherscan.io/token/0x2994529C0652D127b7842094103715ec5299bBed) | -| crvSUSD | [crvPlain3andSUSD \(sCrv\)](https://etherscan.io/token/0xC25a3A3b969415c80451098fa907EC722572917F) | [yvcrvPlain3andSUSD](https://etherscan.io/token/0x5533ed0a3b83F70c3c4a1f69Ef5546D3D4713E44) | -| 3Crv | [3Crv](https://etherscan.io/token/0x6c3F90f043a72FA612cbac8115EE7e52BDe6E490) | [y3Crv](https://etherscan.io/token/0x9cA85572E6A3EbF24dEDd195623F188735A5179f) | -| crvEURS | [eursCRV](https://etherscan.io/token/0x194eBd173F6cDacE046C53eACcE9B953F28411d1) | [yveursCRV](https://etherscan.io/token/0x98B058b2CBacF5E99bC7012DF757ea7CFEbd35BC) | -| crvHBTC | [hCRV](https://etherscan.io/token/0xb19059ebb43466C323583928285a49f558E572Fd) | [yvhCRV](https://etherscan.io/token/0x46AFc2dfBd1ea0c0760CAD8262A5838e803A37e5) | +- The strategy contract is [ERC-4626](https://ethereum.org/en/developers/docs/standards/tokens/erc-4626/) compliant (we call it a "Tokenized Strategy"). +- A strategy can act as a vault with only 1 strategy. +- A strategy can act as a vault for many strategies. +- Vault tokens are still prefixed with `yv`, so a v3 vault for USDC gives the user yvUSDC. \ No newline at end of file diff --git a/docs/getting-started/products/yvaults/vaults-and-strategies.md b/docs/getting-started/products/yvaults/vaults-and-strategies.md deleted file mode 100644 index 628f10408e..0000000000 --- a/docs/getting-started/products/yvaults/vaults-and-strategies.md +++ /dev/null @@ -1,12 +0,0 @@ -# Vaults and Strategies - -After depositing, your funds first go to the vault contract and then are deployed to one or more strategy contracts. Guardians and strategists monitor deposits to ensure optimal returns and to be available during critical situations. - -**Vault and Strategies Introduction:** [What are Vaults and Strategies?](https://medium.com/iearn/yearn-finance-explained-what-are-vaults-and-strategies-96970560432) - -**Vault and Strategies Contracts:** [Yearn Watch](https://yearn.watch/) - - -**Vault and Strategies Descriptions:** [The Vaults at Yearn](https://vaults.yearn.fi/) - -**Strategy Descriptions Glossary:** [How to Understand Strategies Descriptions](https://docs.yearn.fi/getting-started/guides/how-to-understand-strategies-descriptions) diff --git a/docs/getting-started/using-yearn.md b/docs/getting-started/using-yearn.md index 6b5810169a..de079d3d32 100644 --- a/docs/getting-started/using-yearn.md +++ b/docs/getting-started/using-yearn.md @@ -1,16 +1,16 @@ # Using Yearn -Thanks to a feature called 'zap', it's extremely easy to deposit into any vault with almost any token. +Thanks to a feature called 'zap', depositing into any vault with almost any token is effortless. Here's how it works: -First, **Connect your wallet** using the button at the top right corner. Multiple types of 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. +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://github.com/yearn/yearn-devdocs/assets/7863230/3b537d18-bbfe-449a-8d6d-d6b53c44e056) ## Yearn is multi-chain -Our products are currently on Ethereum, Fantom, Arbitrum, and Optimism with more to come. +Our products are currently on Ethereum, Fantom, Arbitrum, Optimism, and Polygon with more to come. Click on this button to select the network you would like to interact with: @@ -19,7 +19,7 @@ Click on this button to select the network you would like to interact with: ## If you **already have the required token** for the vault that you would like to deposit in: 1. Select the vault that you would like to deposit into. -2. Enter the amount of tokens you want to deposit into the vault. If you are depositing ETH, make sure you have enough ETH left over to pay for future transactions that you might need to make. +2. 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://github.com/yearn/yearn-devdocs/assets/7863230/b829c7f3-078c-4674-be24-3763443a4299) @@ -30,7 +30,7 @@ Click on this button to select the network you would like to interact with:

-6. 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. +5. 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://github.com/yearn/yearn-devdocs/assets/7863230/5b2c2308-0384-4446-ab12-2fc23d8cc829) @@ -47,7 +47,7 @@ When you're ready to withdraw: ## 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 with any token into any vault: +Yearn provides a zapping feature so you can deposit any token into any vault (zapping fees are explicit in the UI): ![image](https://github.com/yearn/yearn-devdocs/assets/7863230/63cb991c-71de-4840-8bf2-38084e7ab907) diff --git a/docs/resources/r-and-d/delegated-funding-dao-vaults.md b/docs/resources/deprecated/delegated-funding-dao-vaults.md similarity index 95% rename from docs/resources/r-and-d/delegated-funding-dao-vaults.md rename to docs/resources/deprecated/delegated-funding-dao-vaults.md index 522cbe9352..3b5555c712 100644 --- a/docs/resources/r-and-d/delegated-funding-dao-vaults.md +++ b/docs/resources/deprecated/delegated-funding-dao-vaults.md @@ -1,5 +1,5 @@ --- -description: In development +status: On Hold (No Active Development or R&D) --- # Delegated Funding DAO Vaults diff --git a/docs/resources/r-and-d/stablecredit.md b/docs/resources/deprecated/stablecredit.md similarity index 100% rename from docs/resources/r-and-d/stablecredit.md rename to docs/resources/deprecated/stablecredit.md diff --git a/docs/resources/r-and-d/vecrv-boosts.md b/docs/resources/deprecated/vecrv-boosts.md similarity index 98% rename from docs/resources/r-and-d/vecrv-boosts.md rename to docs/resources/deprecated/vecrv-boosts.md index 1ff1481b50..b149a25c64 100644 --- a/docs/resources/r-and-d/vecrv-boosts.md +++ b/docs/resources/deprecated/vecrv-boosts.md @@ -1,4 +1,8 @@ -# veCRV Boosts (deprecated) +--- +Status: Deprecated +--- + +# veCRV Boosts > **This page is outdated since yveCRV was deprecated in favour of yCRV. Check the new yCRV [page](https://docs.yearn.fi/getting-started/products/ycrv/overview).** diff --git a/docs/getting-started/products/woofy.md b/docs/resources/deprecated/woofy.md similarity index 98% rename from docs/getting-started/products/woofy.md rename to docs/resources/deprecated/woofy.md index a9d4fb3e3e..ed76791dcc 100644 --- a/docs/getting-started/products/woofy.md +++ b/docs/resources/deprecated/woofy.md @@ -1,3 +1,7 @@ +--- +Status: Deprecated +--- + # Woofy The WOOFY token is the blue dog companion token of YFI. Utilizing special Woof technology, it allows two-way conversion between the two tokens, allowing holders to be exposed to YFI in a fluffier package. diff --git a/docs/resources/r-and-d/yearn.md b/docs/resources/deprecated/yearn.md similarity index 97% rename from docs/resources/r-and-d/yearn.md rename to docs/resources/deprecated/yearn.md index b36cde102a..74743f3d5e 100644 --- a/docs/resources/r-and-d/yearn.md +++ b/docs/resources/deprecated/yearn.md @@ -1,8 +1,8 @@ --- -description: Deprecated +Status: Deprecated --- -# yEarn (deprecated) +# yEarn Earn is a lending aggregator that strives to attain the highest yield for supported coins \(DAI, USDC, USDT, TUSD, sUSD, or wBTC\) at all times. It does this by programmatically shifting these coins between several lending protocols \([AAVE](https://aave.com), [dYdX](https://dydx.exchange/), and [Compound](https://compound.finance)\) operating on the Ethereum blockchain. diff --git a/docs/resources/ygift.md b/docs/resources/deprecated/ygift.md similarity index 98% rename from docs/resources/ygift.md rename to docs/resources/deprecated/ygift.md index b7c7b4aaa9..fb8bd7b39c 100644 --- a/docs/resources/ygift.md +++ b/docs/resources/deprecated/ygift.md @@ -1,3 +1,7 @@ +--- +Status: Deprecated +--- + # yGift Brighten someone's day by sending a virtual gift. yGift is an NFT (Non-Fungible Token) that can be used to reward someone for their work, or to simply share some love. diff --git a/docs/resources/r-and-d/ytrade.md b/docs/resources/deprecated/ytrade.md similarity index 96% rename from docs/resources/r-and-d/ytrade.md rename to docs/resources/deprecated/ytrade.md index 95833c383b..864a3d9517 100644 --- a/docs/resources/r-and-d/ytrade.md +++ b/docs/resources/deprecated/ytrade.md @@ -1,5 +1,5 @@ --- -description: Not recommended for retail use +Status: Not recommended for retail use --- # yTrade diff --git a/docusaurus.config.js b/docusaurus.config.js index ce4a24ca1c..679de0217a 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -49,7 +49,7 @@ module.exports = { label: 'Introduction', }, { - to: 'developers/v2/getting-started', + to: 'developers/v3/overview', label: 'Develop', }, { @@ -86,40 +86,31 @@ module.exports = { style: 'light', links: [ { - title: 'Developers', + title: 'GitHub', items: [ { - label: 'Open Issues', - href: 'https://contribute.yearn.rocks/', + label: 'V3 Vaults', + href: 'https://github.com/yearn/yearn-vaults-v3', }, { - label: '#strategies - Discord', - href: 'https://discord.gg/b8ENPNqG5c', - }, - ], - }, - { - title: 'GitHub', - items: [ - { - label: 'yearn-vaults', - href: 'https://github.com/yearn/yearn-vaults', + label: 'V3 Tokenized Strategy', + href: 'https://github.com/yearn/tokenized-strategy', }, { - label: 'foundry-tokenized--strategy-mix', + label: 'V3 Strategy Mix: Foundry', href: 'https://github.com/yearn/tokenized-strategy-foundry-mix', }, { - label: 'apeworx-tokenized-strategy-mix', + label: 'V3 Strategy Mix: Ape', href: 'https://github.com/yearn/tokenized-strategy-ape-mix', }, { - label: 'yearn-watch', - href: 'https://github.com/yearn/yearn-watch', + label: 'V2 Vaults', + href: 'https://github.com/yearn/yearn-vaults', }, { - label: 'yearn-finance-v3', - href: 'https://github.com/yearn/yearn-finance-v3', + label: 'V2 Strategy Mix', + href: 'https://github.com/yearn/brownie-strategy-mix', }, { label: 'yearn-security', @@ -135,20 +126,36 @@ module.exports = { title: 'Ecosystem', items: [ { - label: 'Vaults', + label: 'V3 Vaults', + href: 'https://yearn.fi/v3', + }, + { + label: 'V2 Vaults', href: 'https://yearn.fi/vaults', }, + { + label: 'Juiced Vaults', + href: 'https://juiced.yearn.fi/', + }, + { + label: 'veYFI', + href: 'https://veyfi.yearn.fi/', + }, { label: 'yETH', href: 'https://yeth.yearn.fi/', }, { - label: 'YFI Stats', - href: 'https://www.yfistats.com/', + label: 'yCRV', + href: 'https://ycrv.yearn.fi/', + }, + { + label: 'yPrisma', + href: 'https://yprisma.yearn.fi/', }, { - label: 'Bowswap', - href: 'https://bowswap.finance/', + label: 'yBribe', + href: 'https://ybribe.yearn.fi/', }, ], }, @@ -177,7 +184,7 @@ module.exports = { }, { label: 'Snapshot voting', - href: 'https://snapshot.org/#/ybaby.eth', + href: 'https://snapshot.org/#/veyfi.eth', }, ], }, diff --git a/sidebars/sidebarsContributing.js b/sidebars/sidebarsContributing.js index f9809ef590..ff924a1b2e 100644 --- a/sidebars/sidebarsContributing.js +++ b/sidebars/sidebarsContributing.js @@ -6,8 +6,6 @@ module.exports = { type: 'category', label: 'Operations', items: [ - 'operations/osc-levels', - 'operations/decision-making', 'operations/budget', ], }, @@ -15,11 +13,8 @@ module.exports = { type: 'category', label: 'Governance', items: [ - 'governance/governance-and-operations', 'governance/proposal-process', - 'governance/proposal-repository', 'governance/yfi', - 'governance/veyfi', ], }, { diff --git a/sidebars/sidebarsDevelopers.js b/sidebars/sidebarsDevelopers.js index a4a58242e3..d47401e940 100644 --- a/sidebars/sidebarsDevelopers.js +++ b/sidebars/sidebarsDevelopers.js @@ -1,45 +1,59 @@ module.exports = { mySidebar: [ - 'v2/getting-started', - 'v2/additional-resources', { type: 'category', - label: 'Procedures', + label: 'yVaults Version 3', items: [ - 'v2/SPECIFICATION', - 'v2/DEPLOYMENT', - 'v2/OPERATIONS', - 'v2/EMERGENCY', - 'v2/naming-convention', - 'v2/ledger-plugin', - ], - }, - { - type: 'link', - label: 'Smart Contracts', - href: '/vaults/smart-contracts/BaseStrategy', - }, - { - type: 'category', - label: 'Yearn Data Services', - items: [ - 'v2/yearn-data', - 'v2/subgraph-info', - 'v2/entities', - 'v2/queries', + 'v3/overview', + 'v3/protocol_fees', + 'v3/vault_management', + 'v3/strategy_writing_guide', ], }, - 'v2/hacking-with-yearn', - 'v2/fork-yearn-ui', - 'v2/yswaps', { type: 'category', - label: 'V3', + label: 'yVaults Version 2', items: [ - 'v3/overview', - 'v3/strategy_writing_guide', - 'v3/protocol_fees', - 'v3/vault_management', + 'v2/getting-started', + 'v2/additional-resources', + { + type: 'category', + label: 'Procedures', + items: [ + 'v2/SPECIFICATION', + 'v2/DEPLOYMENT', + 'v2/OPERATIONS', + 'v2/EMERGENCY', + 'v2/naming-convention', + 'v2/ledger-plugin', + ], + }, + { + type: 'link', + label: 'Smart Contracts', + href: '/vaults/smart-contracts/BaseStrategy', + }, + { + type: 'category', + label: 'Yearn Data Services', + items: [ + 'v2/yearn-data', + { + type: 'category', + label: 'Subgraph', + items: [ + 'v2/subgraph-info', + 'v2/entities', + 'v2/queries', + ], + }, + 'v2/yearn-lens', + 'v2/yearn-api', + ], + }, + 'v2/hacking-with-yearn', + 'v2/fork-yearn-ui', + 'v2/yswaps', ], }, ], diff --git a/sidebars/sidebarsGettingStarted.js b/sidebars/sidebarsGettingStarted.js index c6729156f6..1f3707d047 100644 --- a/sidebars/sidebarsGettingStarted.js +++ b/sidebars/sidebarsGettingStarted.js @@ -11,10 +11,28 @@ module.exports = { label: 'yVaults', items: [ 'products/yvaults/overview', - 'products/yvaults/vaults-and-strategies', 'products/yvaults/vault-tokens', - 'products/yvaults/vault-factory', - 'products/yvaults/v3', + { + type: 'category', + label: 'yVaults Version 3', + items: [ + 'products/yvaults/v3', + ], + }, + { + type: 'category', + label: 'yVaults Version 2', + items: [ + 'products/yvaults/vault-factory', + ], + }, + ], + }, + { + type: 'category', + label: 'veYFI', + items: [ + 'products/veyfi', ], }, { @@ -29,12 +47,23 @@ module.exports = { label: 'yLockers', items: [ 'products/ylockers/overview', - 'products/ylockers/ycrv/overview', - 'products/ylockers/ycrv/faq', - 'products/ylockers/ycrv/guide', - 'products/ylockers/yprisma/overview', - 'products/ylockers/yprisma/farming', - + { + type: 'category', + label: 'yCRV', + items: [ + 'products/ylockers/ycrv/overview', + 'products/ylockers/ycrv/faq', + 'products/ylockers/ycrv/guide' + ], + }, + { + type: 'category', + label: 'yPRISMA', + items: [ + 'products/ylockers/yprisma/overview', + 'products/ylockers/yprisma/farming' + ], + }, ], }, { @@ -46,7 +75,6 @@ module.exports = { 'products/ybribe/faq', ], }, - 'products/woofy', ], }, { diff --git a/sidebars/sidebarsResources.js b/sidebars/sidebarsResources.js index a0cbca1d20..375ca35e37 100644 --- a/sidebars/sidebarsResources.js +++ b/sidebars/sidebarsResources.js @@ -9,10 +9,9 @@ module.exports = { }, { type: 'category', - label: 'R & D', - items: [{ type: 'autogenerated', dirName: 'r-and-d' }], + label: 'Deprecated Projects', + items: [{ type: 'autogenerated', dirName: 'deprecated' }], }, - 'ygift', { type: 'link', href: 'https://github.com/yearn/yearn-pm/tree/master/financials/reports', diff --git a/src/homepageFeatures.js b/src/homepageFeatures.js index 99ab8c2588..ac94bde294 100644 --- a/src/homepageFeatures.js +++ b/src/homepageFeatures.js @@ -9,11 +9,11 @@ export default [ }, { title: 'Vaults & Strategies', - description: 'An overview on how Yearn Vaults and its strategies work.', + description: 'An overview on how Yearn vaults and strategies work.', to: './developers/v3/overview', }, { - title: 'Yearn Risk Scores', + title: 'Risk Scores', description: 'Learn about the Yearn risk framework for assessing DeFi yield strategies.', to: './resources/risks/risk-score', }, @@ -23,19 +23,19 @@ export default [ title: 'Build', rows: [ { - title: 'New Strategies', - description: 'Get started building with vaults and strategies.', - to: './developers/v3/strategy_writing_guide', + title: 'Vaults', + description: 'Get started building V3 vaults.', + to: './developers/v3/vault_management', }, { - title: 'Yearn Data', - description: 'Learn about the Yearn data services like yDaemon and the subgraphs', - to: './developers/v2/yearn-data', + title: 'Strategies', + description: 'Get started building V3 strategies.', + to: './developers/v3/strategy_writing_guide', }, { title: 'veYFI', description: 'Participate in Yearn governance and learn how boosted yield works.', - to: './contributing/governance/veyfi', + to: './getting-started/products/veyfi', }, ], } diff --git a/versioned_docs/version-0.4.6/yearn-sdk/yearn-stack.md b/versioned_docs/version-0.4.6/yearn-sdk/yearn-stack.md deleted file mode 100644 index b64fc676aa..0000000000 --- a/versioned_docs/version-0.4.6/yearn-sdk/yearn-stack.md +++ /dev/null @@ -1,125 +0,0 @@ -# Yearn Stack + FE Features - -Yearn SDK integrates several components, both on-chain and off-chain. - -## Backend stack - -

- Backend Chart -

- -### On Chain - -- 🔍 Yearn Lens - - Oracle - - Helpers - - Adapters - - Vaults V1 - - Vaults V2 - - Iron Bank - -### On IPFS - -

- IPFS Metadata -

- -- Yearn Metadata is a lightweight storage for all the stuff that would have been hardcoded in v2 frontend, including but not limited to: - - custom messages for deposits / withdrawals - - custom copywriting for special assets - - strategy descriptions / diagrams - - disabling asset interactions -- Yearn Frontend - -### Off Chain - -- Yearn Exporter: stores (and displays) stats about yearn assets, exposing: - - historical TVL - - historical APY -- Yearn Subgraph: stores all historical data for users -- Zapper Integration - -## Backend features - -### Resilience powered by on-chain data and IPFS storage - -- Critical data (assets, positions, vault deprecations) will be fetched exclusively from the chain / IPFS - - maximizing uptime - - reducing reliance on other services -- Historical TVL, historical APY and other non critical data will be stored off chain and fetched dinamically. - -#### On-chain assets and positions - -- Lens does what the old off-chain API does, but directly on-chain. This will speed up the fetching time and greatly reduce our reliance on scheduled jobs in servers. - -#### IPFS CI/CD for frontend and metadata - -- Frontend and hardcoded values will be stored in IPFS utilizing a similar system to the one [introduced](https://github.com/Uniswap/interface) by Uniswap. - -### Historical APY and TVL - -- Yearn Exporter provides a simple backend solution for storing real-time stats from yearn products. -- Metrics are stored in a timeseries database and will be exposed by an api, accessible by SDK and third-party. - -### SDK, aggregator of many datasources - -- SDK will provide a simple interface for all integrators, including ourselves. -- Read methods will seamlessly integrate with all datasources, while keeping coherent datastructures. -- Write methods talk directly to assets on chain. Execution of write transactions will trigger refresh events so data freshness of frontend (or other integration platforms) will still be preserved. - -### Historical User Earnings - -- Yearn Subgraph leverages thegraph to store historical user data that can be aggregated to display historical earnings. - -### Metadata - -- New way to store all the information that would generally be hard coded directly in the frontend. -- Data is now encoded in predefined schemas that are checked at every change. - -#### Strategy descriptions - -We can store Strategy information directly on IPFS so they can be then be queried and rendered the frontend. - -```json -{ - "$schema":"strategy", - "name":"Idle Finance Reinvest", - "description":"Supplies {{token}} to [Idle Finance](https://idle.finance) to earn IDLE and COMP. Earned tokens are harvested, sold for more {{token}} which is deposited back into the strategy.", - "protocols":["IdleFinance"] -} -``` - -#### Assets management - -We can store Asset informations so in critical situations we can toggle interactions and add custom messages. - -```json -{ - "$schema": "vault", - "comment": "Curve EURS", - "hideAlways": false, - "depositsDisabled": false, - "withdrawalsDisabled": false, - "order": 18, - "migrationAvailable": false, - "allowZapIn": true, - "allowZapOut": true, - "retired": false, - "displayName": "Curve EURS" -} -``` - - -### Front End stack - -

- Backend Chart -

- - -### Front End Features - - -

- Frontend Chart -