diff --git a/docs/contributing/contribute.md b/docs/contributing/contribute.md index d9456a54b2..50c4314f64 100644 --- a/docs/contributing/contribute.md +++ b/docs/contributing/contribute.md @@ -94,8 +94,8 @@ This is complementary to the above, but it's not directly related to creating st #### List of Yearn Data Tools -- yDaemon API, [GitHub](https://github.com/yearn/ydaemon) -- Kong API, [GitHub](https://github.com/yearn/kong) +- [yDaemon API](https://docs.yearn.fi/developers/data-services/ydaemon), [GitHub](https://github.com/yearn/ydaemon) +- [Kong API](https://docs.yearn.fi/developers/data-services/kong), [GitHub](https://github.com/yearn/kong) ### Old Legacy Products and Websites diff --git a/docs/contributing/contributor-tools.md b/docs/contributing/contributor-tools.md index 15efb1ce32..7fa683ce0b 100644 --- a/docs/contributing/contributor-tools.md +++ b/docs/contributing/contributor-tools.md @@ -27,13 +27,6 @@ Start participating in public discussions by joining the recommended channels be - Ask for feedback. - Provide progress updates. -### Meetings - -Yearn contributors host meetings when necessary on Google Hangouts. These are not centrally organized and arise organically within discussions between contributors or teams, as such, invitations are up to the individuals organizing these discussions. Invitations are sent to contributors by Discord or Telegram and Google Calendar automatically schedules the event and sends reminders. - -- [Jitsi Meet](https://meet.jit.si) -- [Google Meet](https://meet.google.com/_meet) - ## Writing Platforms ### HackMD @@ -155,29 +148,6 @@ If you are using Google Docs to write, consider using Visual Studio Code and ins **Pro Tip:** For a document's final draft, name it "Final draft, moving to GitHub." Post a link to the HackMD file or a relevant page on GitHub. -### Miscellaneous - -#### Important Links - -- [GitHub Desktop](https://desktop.github.com/) -- [Broken Link Checker](https://ahrefs.com/broken-link-checker) -- [Code Blocks](https://gsuite.google.com/marketplace/app/code_blocks/100740430168?pann=cwsdp&hl=en): for formatting blocks of code in a doc or adding Markdown. -- [Markdown Conversion](https://github.com/lmmx/gdocs2md-html): for Google Drive. - - A long [stack-exchange thread](https://webapps.stackexchange.com/questions/44047/how-can-google-docs-and-markdown-play-nice) on this use case. -- [DrawIO](https://draw.io/): Open source software using Google Drive for creating flowcharts and schemas. -- [Figma](https://www.figma.com/): Creates visual mockups, especially for team collaboration. - -#### Wallets and 3rd Party Services - -- [Metamask](https://metamask.io/): Wallet for sending and receiving YFI -- [Zerion](https://zerion.io/): For checking Yearn Treasury statistics. - -#### Keyboard Shortcuts - -- [Mac Shortcuts](https://www.mediaatelier.com/CheatSheet/?ref=producthunt) -- [Windows Shortcuts](https://cheatkeys.com/) -- [Use The Keyboard](https://usethekeyboard.com/): Open-source collection of keyboard shortcuts for Mac apps, Windows programs, and websites. - ### Acknowledgments This document could not be possible without the amazing work done by the MakerDAO team as this document is mostly based on their [Contributor Tools Guide](https://github.com/makerdao/community-portal/blob/r2d/content/en/contribute/content/contributor-tools.mdx). diff --git a/docs/contributing/documentation/working-on-docs.md b/docs/contributing/documentation/working-on-docs.md index 0e9faf4422..a80ba0c28c 100644 --- a/docs/contributing/documentation/working-on-docs.md +++ b/docs/contributing/documentation/working-on-docs.md @@ -4,8 +4,6 @@ Yearn's documentation repository is hosted on GitHub in order to foster and encourage open source collaboration. -_Note for translators: Non-english docs are stored in separate branches. When merging your changes, direct your pull request to the corresponding branch_ - ## Working with HackMD In order to contribute to Yearn docs, you will need to be able to write with Markdown syntax. It's extremely easy to learn. Use this [cheat sheet](https://www.markdownguide.org/cheat-sheet/) to get started. @@ -88,5 +86,5 @@ Cloning a repository is ideal if you are working on more than one page. ![](https://i.imgur.com/r8JuC84.jpg) -15. Make sure the base repository is 'yearn/yearn-devdocs' and the base is 'master'. (unless you are contributing to translated versions, in which case, the base should be the name of the language you are translating) The head repository should be 'your-username/yearn-devdocs' and the compare should be 'your-branch-name' +15. Make sure the base repository is 'yearn/yearn-devdocs' and the base is 'master'. The head repository should be 'your-username/yearn-devdocs' and the compare should be 'your-branch-name' 16. Make sure that your PR has all of the information needed to contextualize the change and that your changes comply with the [Writing Style Guide](/contributing/documentation/writing-style-guide). Once you create a pull request, it will be sent to the repo admins who can approve it to be merged into the live site. diff --git a/docs/contributing/documentation/writing-style-guide.md b/docs/contributing/documentation/writing-style-guide.md index 5a1fa7c3ce..ccb4fdadda 100644 --- a/docs/contributing/documentation/writing-style-guide.md +++ b/docs/contributing/documentation/writing-style-guide.md @@ -170,7 +170,7 @@ When bulleted and numbered lists contain complete sentences, capitalize the firs ### Links -- Use [absolute links](https://docs.microsoft.com/en-us/contribute/how-to-write-links) and standard web URLs when referencing external resources. +- Use [absolute links](https://learn.microsoft.com/en-us/contribute/content/how-to-write-links) and standard web URLs when referencing external resources. - Create descriptive hyperlinks and avoid generic language. - **Correct - Descriptive:** Learn more at [Yearn Documentation](https://docs.yearn.fi/) - **Incorrect - Generic:** Learn more [here](https://docs.yearn.fi/). diff --git a/docs/contributing/governance/governance-and-operations.md b/docs/contributing/governance/governance-and-operations.md index 8a2b96eeda..914ee5d53b 100644 --- a/docs/contributing/governance/governance-and-operations.md +++ b/docs/contributing/governance/governance-and-operations.md @@ -4,9 +4,9 @@ Since [YIP-61: Governance 2.0](https://gov.yearn.fi/t/yip-61-governance-2-0/10460) passed on April 25th, 2021, yearn began the transition into a **multi-DAO** structure, managed by **constrained delegation**. This approach allows protocol development not to be stiffened by bureaucracy while maintaining a sufficient level of decentralization. -Multi-DAO refers to the fluid number of decentralized autonomous organizations (DAOs) that contribute to the protocol in some unique way. These independent groups consist of YFI holders, yTeams and the Multisig. +Multi-DAO refers to the fluid number of decentralized autonomous organizations (DAOs) that contribute to the protocol in some unique way. These independent groups consist of stYFI holders, yTeams and the Multisig. -- **YFI holders** vote for changes to the protocol or the governance structure +- **stYFI holders** vote for changes to the protocol or the governance structure - **yTeams** focus on specific aspects of the protocol or relevant operations - **Multisig** members execute or veto any onchain decisions @@ -14,12 +14,12 @@ Token holders have an ultimate say over what yTeams exist, who is part of the Mu A simplified flow of governance would look like this: - 1. YFI holders create, destroy and define limitations of yTeams + 1. stYFI holders create, destroy and define limitations of yTeams 2. yTeam notifies yTx of a decision 3. yTx creates a delegated transaction and send it to the Multisig 4. Multisig executes or vetos the transaction -With [veYFI](/contributing/governance/veyfi) launch, governance moved from using YFI to veYFI as voting power. +Governance voting power has evolved over time: from YFI, to [veYFI](/contributing/governance/veyfi), and currently [stYFI](/contributing/governance/styfi). ## DAO Responsibilities @@ -27,7 +27,7 @@ With [veYFI](/contributing/governance/veyfi) launch, governance moved from using ### Token Holders -[YFI](/contributing/governance/yfi) token-holders duty is to create and vote for proposals that improve the protocol. +[stYFI](/contributing/governance/styfi) token-holders duty is to create and vote for proposals that improve the protocol. | Proposals | Descriptions | @@ -75,7 +75,7 @@ Each yTeam is assigned specific decision-making powers, defined by YIP-61: | yDev | Add Strategies | Add new strategies to vaults | | yTx | Delegate Transactions | Create delegated transactions for the multisig to sign and execute | | yPeople | Pay Team | Create, deploy, modify, or terminate Yearn compensation packages | -| yBudget | Set Budgets | Create budgets for coordinape, grants, hiring, operations, or other workstreams | +| yBudget | Set Budgets | Create budgets for grants, hiring, operations, or other workstreams | | yFarm | Farm Treasury | Farm with the treasury and make decisions on airdrops | | yOps | Ratify yTeam Signers | Formally approve or remove signers for each yTeam | @@ -96,7 +96,6 @@ Yearn continuously paves the way towards an ideal balance of DAO decentralizatio - Multisig consensus mechanisms that allow each yTeam to have execution power - Move from proxy voting to onchain voting - tokenize decision-making powers as NFTs -- Utilize [Coordinape](https://coordinape.com/) for things like budget allocation and compensation ## Read More diff --git a/docs/contributing/governance/migrating-from-veyfi.md b/docs/contributing/governance/migrating-from-veyfi.md index 4bc8fd1186..c4086a042a 100644 --- a/docs/contributing/governance/migrating-from-veyfi.md +++ b/docs/contributing/governance/migrating-from-veyfi.md @@ -1,6 +1,6 @@ # Migrate from veYFI -This page covers the **legacy veYFI → current system** migration flow as implemented in the Yearn governance dashboards today. +This page covers the **legacy veYFI → stYFI** migration flow as implemented in the Yearn governance dashboards today. ## Where to migrate diff --git a/docs/contributing/governance/proposal-process.md b/docs/contributing/governance/proposal-process.md index f159d1071a..83bdb723d4 100644 --- a/docs/contributing/governance/proposal-process.md +++ b/docs/contributing/governance/proposal-process.md @@ -1,6 +1,6 @@ # Proposal Process -[stYFI](/contributing/governance/styfi) token holders govern the Yearn ecosystem through offchain proposals and votes via [Snapshot](https://snapshot.org/#/s:styfi.eth). Proposals that generate majority support (>50% of the vote) are expected to be implemented by the proposed relevant parties. The 9-member [yChad multi-signature wallet](/developers/security/multisig) is then empowered to execute all related transactions after their own review. The [members of the multi-signature wallet](/developers/security/multisig#members) are voted in by YFI holders and are subject to change via future governance votes. +[stYFI](/contributing/governance/styfi) token holders govern the Yearn ecosystem through offchain proposals and votes via [Snapshot](https://snapshot.org/#/s:styfi.eth). Proposals that generate majority support (>50% of the vote) are expected to be implemented by the proposed relevant parties. The 9-member [yChad multi-signature wallet](/developers/security/multisig) is then empowered to execute all related transactions after their own review. The [members of the multi-signature wallet](/developers/security/multisig#members) are voted in by stYFI holders and are subject to change via future governance votes. ## Discussion @@ -33,15 +33,15 @@ The default template for proposals can be found on [GitHub](https://github.com/y **Resources**: - [Proposal How-To](https://gov.yearn.fi/t/proposal-how-to/106) -- [YIP 0: YIP Purpose and Guidelines](https://yips.yearn.fi/YIPS/yip-0) -- [YIP 44: Improve YIP Categories](https://yips.yearn.fi/YIPS/yip-44) +- [YIP 0: YIP Purpose and Guidelines](/contributing/governance/yips/yip-0) +- [YIP 44: Improve YIP Categories](/contributing/governance/yips/yip-44) - [YIP 55: Formalize the YIP Introduction and Voting Process](https://gov.yearn.fi/t/yip-55-formalize-the-yip-process/7959) ## Voting #### How do I vote? -- Holding [veYFI](/contributing/governance/veyfi) enables you to vote on Yearn's [Snapshot](https://snapshot.org/#/s:styfi.eth) page +- Holding [stYFI](/contributing/governance/styfi) enables you to vote on Yearn's [Snapshot](https://snapshot.org/#/s:styfi.eth) page #### What’s the difference between voting for a poll on the forum and an offchain vote? diff --git a/docs/contributing/governance/proposal-repository.md b/docs/contributing/governance/proposal-repository.md index 1c6c3e9bd6..b18f79894e 100644 --- a/docs/contributing/governance/proposal-repository.md +++ b/docs/contributing/governance/proposal-repository.md @@ -8,18 +8,18 @@ Proposals are listed in reverse numerical order, with the most recent first. Sel | Number | Title | Author | Outcome | | --- | --- | --- | --- | -| [91](/contributing/governance/yips/yip-91) | yTranche | Vaults Team | [Active](https://snapshot.org/#/s:styfi.eth/proposal/0xa348d353b66f46c6957a938a42fbf860eaffc855cd9163d8042780f65ea72612) | +| [91](/contributing/governance/yips/yip-91) | yTranche | Vaults Team | [Passed](https://snapshot.org/#/s:styfi.eth/proposal/0xa348d353b66f46c6957a938a42fbf860eaffc855cd9163d8042780f65ea72612) | | [90](/contributing/governance/yips/yip-90) | yETH Optimistic Recovery Plan | 0xPickles | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0xe76f57663ce9311eb830ef097812702cbbb55fccbb280d254cdfc1f2c11c261a) | | [89](/contributing/governance/yips/yip-89) | Proposal to Rotate Multisig Signers | wavey | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0x02ac9f5cc91ad090938195c37e17fd24941a668082b2b6b58f20e11e32d73003) | | [88](/contributing/governance/yips/yip-88) | Governance Overhaul: ⓷ Incentives | 0xPickles, governance team contributors | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0x9b3a40326411eea6c51ec389a802ed695de53961fa49f6d3525e256513d0a7f9) | | [88](/contributing/governance/yips/yip-88) | Governance Overhaul: ⓶ stYFI | 0xPickles, governance team contributors | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0x9b3a40326411eea6c51ec389a802ed695de53961fa49f6d3525e256513d0a7f9) | | [88](/contributing/governance/yips/yip-88) | Governance Overhaul: ⓵ DAO Restructuring | 0xPickles, governance team contributors | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0x9b3a40326411eea6c51ec389a802ed695de53961fa49f6d3525e256513d0a7f9) | | [87](/contributing/governance/yips/yip-87) | Convert ychad.eth into a BORG | MetaLeX | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0x4726de81255b4be972e0b7bb9f03fac222cfbcef9bd1e148e647be4b8b1fb47d) | -| [86](/contributing/governance/yips/yip-86) | Resupply Bad Debt Repayment Loan | dudesahn | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0xe2fc56f50b1c434ca2f80d07542b66b5ff035b22891c8d6ebb79afca62664d02) | +| [86](/contributing/governance/yips/yip-86) | Resupply Bad Debt Repayment Loan | [dudesahn](https://github.com/dudesahn) | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0xe2fc56f50b1c434ca2f80d07542b66b5ff035b22891c8d6ebb79afca62664d02) | | [85](/contributing/governance/yips/yip-85) | Disable Protocol Fees on Yearn V3 | V3 Protocol Team | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0xa3223b388c484ea8a81b60bb88cda99f23d6d06b4b9798b4d0acafaa2207b686) | | [84](/contributing/governance/yips/yip-84) | Proposal to rotate multisig signer | wavey | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0xeecd2a9ca79f9b22071d79d436a7e5ccc56593eb4c3bc8ef1b57c8389809a101) | | [83](/contributing/governance/yips/yip-83) | Bearn BIP YIP #2 | Schlag | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0x872f23d57eea829e5fb0a5e0868f805efdb231d8a3c9e39820dd33432ccd629c) | -| [82](/contributing/governance/yips/yip-82) | The BIP YIP, Bearn Finance | The yBera Boyzzzz | [Rejected](https://snapshot.org/#/s:veyfi.eth/proposal/0x24ae3413fcf92bcb92cbbe8845d0684a4e8d36c7f164b4afee6c45c629f16f83) | +| [82](/contributing/governance/yips/yip-82) | The BIP YIP, Bearn Finance | Schlag | [Rejected](https://snapshot.org/#/s:veyfi.eth/proposal/0x24ae3413fcf92bcb92cbbe8845d0684a4e8d36c7f164b4afee6c45c629f16f83) | | [81](/contributing/governance/yips/yip-81) | Prepare for Full On-Chain Governance | 0xPickles | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0x6f3082db2cef3e0c254e569580d063cb14130a92d0bf1729bef342a386e419f2) | | [80](/contributing/governance/yips/yip-80) | Sonne Hack Victims Revised Proposal | Yearninger | [Rejected](https://snapshot.org/#/s:veyfi.eth/proposal/0x2a9ecea04244b83ed8f1ef6b4f62e9ee9a31d16c5ef3b52d00e3a185e78df78e) | | [79](/contributing/governance/yips/yip-79) | Multisig Compensation and Rotation | wavey | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0xc7ded2863a10154b6b520921af4ada48d64d74e5b7989f98cdf073542b2e4411) | @@ -32,34 +32,34 @@ Proposals are listed in reverse numerical order, with the most recent first. Sel | [72](/contributing/governance/yips/yip-72) | Launch yETH | 0xkorin, 0xPickles | [Passed](https://snapshot.org/#/s:veyfi.eth/proposal/0x8969cde98d5d8a7be745e442a3288ce0cf3b35bf99ab72265f66c96d117a0f78) | | [71](/contributing/governance/yips/yip-71) | Activate veYFI | darkghosty, flashfish, jiji, saltyfacu | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/0xc50b60f712adb8568f10f565fc467e8c5d8fe1f4920683696f81c7920397942a) | | [70](/contributing/governance/yips/yip-70) | ApeWorX <> Yearn Partnership | fubuloubu, defidipshit | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/0x1d34233f80a83c3fc4e41583ba115bfd51d3308c7b35249198cab0e49cd527f3) | -| [69](/contributing/governance/yips/yip-69) | Reduce and cap fees through yRates | 0xJiji, banteg, flashfish, jiji, jmonteer, newmickymousse, saltyfacu, wavey | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/0xe4c2c990eaf4bb4a7a8031c461f5db820bae08fd7b81441d56e8cc0378c44afe) | +| [69](/contributing/governance/yips/yip-69) | Reduce and cap fees through yRates | banteg, flashfish, jiji, jmonteer, newmickymousse, saltyfacu, wavey | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/0xe4c2c990eaf4bb4a7a8031c461f5db820bae08fd7b81441d56e8cc0378c44afe) | | [68](/contributing/governance/yips/yip-68) | Rotate multisig signers | [banteg](https://github.com/banteg) | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/0xc5386b7237f6c90359c56ac6dcb942b99a56a4de8ca60d109f4b999716148734) | -| [67](/contributing/governance/yips/yip-67) | Contribute to the Nomic Foundation | FrancoNomic | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/0xd1988feec955cb93d42b63b7b4845d35da8f60859f55ec18b3d5609ecd4eb9e2) | -| [66](/contributing/governance/yips/yip-66) | Streamlining contributor compensation | 0xJiji + 14 authors from the Compensation group | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/0x804d3765e70d6e4f0f0a225222dadd396cd328595d5fd097b732b36fdf8e6af6) | -| [65](/contributing/governance/yips/yip-65) | Evolving YFI Tokenomics (veYFI) | 0xJiji, banteg, daryllautk, HAtTip3675, onlylarping, vany365, Wot_Is_Goin_On | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/0x8f7417fa5565d9f46e16618503e8808c36d51b2a9e8217a68c632d7c090d69d9) | +| [67](/contributing/governance/yips/yip-67) | Contribute $400,000 to Nomic Foundation | FrancoNomic | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/0xd1988feec955cb93d42b63b7b4845d35da8f60859f55ec18b3d5609ecd4eb9e2) | +| [66](/contributing/governance/yips/yip-66) | Streamlining contributor compensation | 15 members of the Compensation group inc @0xJiji | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/0x804d3765e70d6e4f0f0a225222dadd396cd328595d5fd097b732b36fdf8e6af6) | +| [65](/contributing/governance/yips/yip-65) | Evolving YFI Tokenomics | 0xJiji, banteg, daryllautk, HAtTip3675, onlylarping, vany365, Wot_Is_Goin_On | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/0x8f7417fa5565d9f46e16618503e8808c36d51b2a9e8217a68c632d7c090d69d9) | | [64](/contributing/governance/yips/yip-64) | Adjust fees on non-stablecoin yVaults | wavey, philbert, saltyfacu | [Rejected](https://snapshot.org/#/s:ybaby.eth/proposal/0xfe7296601d199b89a8aa53f95d6243ef935d736bea2f13109979d8d5098017d2) | | [63](/contributing/governance/yips/yip-63) | Fund Builder-First Legal Activism DAO | Andre Cronje, tracheopteryx, lex_node, Judge Jowday, S. Brennan, Birdman_Haxxor | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/QmPK9AqeoV6v5xeuiTeFcj9Px7y87KMQ1gGhvHft2GMtqE) | | [62](/contributing/governance/yips/yip-62) | Change Two Multisig Signers | [tracheopteryx](https://github.com/tracheopteryx), [banteg](https://github.com/banteg), [lehnberg](https://github.com/lehnberg), [milkyklim](https://github.com/milkyklim) | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/QmddCbGYbkooZ1zp8oYnbBz6frXLRc9xbkapXcuZcdzmMF) | | [61](/contributing/governance/yips/yip-61) | Governance 2.0 | [tracheopteryx](https://github.com/tracheopteryx), [lex_node](https://github.com/lex-node) | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/QmSMyYeKrRpnA7Xn56o2NtbCUzxmhzCupL7LxMA1reXxq4) | | [60](/contributing/governance/yips/yip-60) | Airdrops to Yearn Vaults | [lehnberg](https://github.com/lehnberg) | [Passed](https://snapshot.org/#/s:ybaby.eth/proposal/QmNqAqRKMFcoRjaRYAKCVETij6sjJ4S1293kbpYDMVvcjB) | | [59](/contributing/governance/yips/yip-59) | Temporarily extend Multisig empowerment | [lehnberg](https://github.com/lehnberg) | [Passed](https://snapshot.org/#/s:yearn/proposal/QmdRCXH6BQpNcucoZqAtS5hQKjckE2428qiZoWjxmJXbs3) | -| [57](/contributing/governance/yips/yip-57) | Funding Yearn's Future | aleks-blockchaincap, Artem K, dudesahn, ekrenzke, lehnberg, Klim K, Ryan Watkins, srs-parafi, tracheopteryx, vooncer, yfi-cent | [Passed](https://snapshot.org/#/s:yearn/proposal/QmX8oYTSkaXSARYZn7RuQzUufW9bVVQtwJ3zxurWrquS9a) | -| [56](/contributing/governance/yips/yip-56) | BABY: Buyback and Build | [lex_node](https://github.com/lex-node), [tracheopteryx](https://github.com/tracheopteryx), [Artem K](https://github.com/banteg), [Klim K](https://github.com/milkyklim), [Ryan Watkins](https://twitter.com/RyanWatkins_), [lehnberg](https://github.com/lehnberg) | [Passed](https://snapshot.org/#/s:yearn/proposal/Qmb6gBzjvgLMazSrQQGVcjutLNdkVyM2Lh6yckMzdoaHWZ) | -| [55](/contributing/governance/yips/yip-55) | Formalize the YIP Process | [franklin](https://github.com/franklin501) | [Passed](https://snapshot.org/#/s:yearn/proposal/QmZA8zJtLPqQAHi1jMdYX9MdMQ1ZmtRP8zuHccm6HFSzpF) | +| [57](/contributing/governance/yips/yip-57) | Funding Yearn’s Future | aleks-blockchaincap, [banteg](https://github.com/banteg), [dudesahn](https://github.com/dudesahn), ekrenzke, lehnberg, Klim K, Ryan Watkins, srs-parafi, tracheopteryx, vooncer, yfi-cent | [Passed](https://snapshot.org/#/s:yearn/proposal/QmX8oYTSkaXSARYZn7RuQzUufW9bVVQtwJ3zxurWrquS9a) | +| [56](/contributing/governance/yips/yip-56) | BABY: Buyback and Build Yearn | [lex_node](https://github.com/lex-node), [tracheopteryx](https://github.com/tracheopteryx), [banteg](https://github.com/banteg), [Klim K](https://github.com/milkyklim), [Ryan Watkins](https://twitter.com/RyanWatkins_), [lehnberg](https://github.com/lehnberg) | [Passed](https://snapshot.org/#/s:yearn/proposal/Qmb6gBzjvgLMazSrQQGVcjutLNdkVyM2Lh6yckMzdoaHWZ) | +| [55](/contributing/governance/yips/yip-55) | Formalize the YIP Process | [franklin](https://github.com/franklin501), [dudesahn](https://github.com/dudesahn) | [Passed](https://snapshot.org/#/s:yearn/proposal/QmZA8zJtLPqQAHi1jMdYX9MdMQ1ZmtRP8zuHccm6HFSzpF) | | [54](/contributing/governance/yips/yip-54) | Formalize Operations Funding | [banteg](https://github.com/banteg), [lehnberg](https://github.com/lehnberg), [lex_node](https://github.com/lex-node), [milkyklim](https://github.com/milkyklim), [tracheopteryx](https://github.com/tracheopteryx) | [Passed](https://snapshot.org/#/s:yearn/proposal/QmW2ZPfGrcNxVLvT2jm9fmvNwQLD9PrdToQDU8DNPp6Ckg) | -| [53](/contributing/governance/yips/yip-53) | yAcademy: Planting the Seed of a Sustainably Secure Future for Yearn and Beyond | aliatiia | [Passed](https://snapshot.org/#/s:yearn/proposal/QmPTAfJCq3UtFZqY3jdgNEJsxc6yuHwfESnQyjjkoccZrJ) | +| [53](/contributing/governance/yips/yip-53) | yAcademy | aliatiia | [Passed](https://snapshot.org/#/s:yearn/proposal/QmPTAfJCq3UtFZqY3jdgNEJsxc6yuHwfESnQyjjkoccZrJ) | | [52](/contributing/governance/yips/yip-52) | Make Strategist Skin in Game Partner for Make Benefit of Glorious Brain of Yearn | [banteg](https://github.com/banteg), [lehnberg](https://github.com/lehnberg), [milkyklim](https://github.com/milkyklim) | [Passed](https://snapshot.org/#/s:yearn/proposal/QmbAq6jPB6ocrihjkDo5TLNF4D4w9dw1HsEsJ7vwdwd9g3) | -| [51](/contributing/governance/yips/yip-51) | Set Vault v2 Fee Structure | [banteg](https://github.com/banteg), [lehnberg](https://github.com/lehnberg), [milkyklim](https://github.com/milkyklim), [tracheopteryx](https://github.com/tracheopteryx) | [Passed](https://snapshot.org/#/s:yearn/proposal/QmSaYHR97LDMDvg9xeTfdNZw6aqL9njxBKM6JVFtCYxKvB) | +| [51](/contributing/governance/yips/yip-51) | Set Vault v2 fee structure | [banteg](https://github.com/banteg), [lehnberg](https://github.com/lehnberg), [milkyklim](https://github.com/milkyklim), [tracheopteryx](https://github.com/tracheopteryx) | [Passed](https://snapshot.org/#/s:yearn/proposal/QmSaYHR97LDMDvg9xeTfdNZw6aqL9njxBKM6JVFtCYxKvB) | | [45](/contributing/governance/yips/yip-45) | Add a bounty for proposing YIPs that are implemented | [Sunil Srivatsa](https://github.com/alphastorm) | Passed | | [44](/contributing/governance/yips/yip-44) | Improve YIP categories | [Sam Bacha](mailto:sam@freighttrust.com) | Passed | | [43](/contributing/governance/yips/yip-43) | Improve YIP categories | [Sam Bacha](mailto:sam@freighttrust.com) | Rejected | | [42](/contributing/governance/yips/yip-42) | Add RenBTC to yVaults | [Azeem](https://github.com/zu-ctrl) | Rejected | | [41](/contributing/governance/yips/yip-41) | Temporarily Empower Multisig | [tracheopteryx](https://github.com/tracheopteryx), [Joe Mahon](https://github.com/Substreight), [franklin501](https://github.com/franklin501), Michael Anderson, Vance Spencer | Passed | -| [40](/contributing/governance/yips/yip-40) | Replace inactive multisig signers | [cp287](https://github.com/illlefr4u), [Artem K](https://github.com/banteg) | Passed | +| [40](/contributing/governance/yips/yip-40) | Replace inactive multisig signers | [cp287](https://github.com/illlefr4u), [banteg](https://github.com/banteg) | Passed | | [39](/contributing/governance/yips/yip-39) | Add Curve sBTC Pool LP-Tokens yVault | [uhmpeps](https://github.com/az) | Passed | | [38](/contributing/governance/yips/yip-38) | Distribute / Keep Balancer Rewards | [Klim K](https://github.com/milkyklim) | Passed | -| [37](/contributing/governance/yips/yip-37) | Participate in CRV governance and 2.5x CRV reward boost | [Andre Cronje](https://github.com/andrecronje), [Artem K](https://github.com/banteg) | Passed | -| [36](/contributing/governance/yips/yip-36) | System rewards as operational capital | [Andre Cronje](https://github.com/andrecronje), iTo, [n00b](https://github.com/jchi18), [Artem K](https://github.com/banteg) | Passed | +| [37](/contributing/governance/yips/yip-37) | Participate in CRV governance and 2.5x CRV reward boost | [Andre Cronje](https://github.com/andrecronje), [banteg](https://github.com/banteg) | Passed | +| [36](/contributing/governance/yips/yip-36) | System rewards as operational capital | [Andre Cronje](https://github.com/andrecronje), iTo, [n00b](https://github.com/jchi18), [banteg](https://github.com/banteg) | Passed | | [35](/contributing/governance/yips/yip-35) | Distribute Donations vs Purchase YFI | [Andre Cronje](https://github.com/andrecronje), [Klim K](https://github.com/milkyklim) | Passed | | [34](/contributing/governance/yips/yip-34) | Add Synthetix (SNX) to yVaults | [Substreight](https://github.com/substreight) | Passed | | [33](/contributing/governance/yips/yip-33) | Add LINK to yVaults | [franklin](https://github.com/franklin501) | Passed | diff --git a/docs/contributing/governance/veYFI-comp-summary.md b/docs/contributing/governance/veYFI-comp-summary.md index e6423ed0aa..e87328f2ed 100644 --- a/docs/contributing/governance/veYFI-comp-summary.md +++ b/docs/contributing/governance/veYFI-comp-summary.md @@ -294,7 +294,7 @@ For users who prefer not to manage individual locks and veYFI decay, **liquid lo ### Snapshot Voting -- **[veYFI Snapshot Page](https://snapshot.org/#/veyfi.eth)** +- **[veYFI Snapshot Page](https://snapshot.org/#/veyfi.eth)** (legacy — for current voting see [s:styfi.eth](https://snapshot.org/#/s:styfi.eth)) ### Contract Addresses @@ -302,7 +302,7 @@ For users who prefer not to manage individual locks and veYFI decay, **liquid lo ### Audits -- **[veYFI StateMind Audit](https://github.com/yearn/yearn-security/blob/master/audits/202208_yAcademy_yearn-veyfi/yAcademy_-_yearn_veyfi_review.pdf)** +- **[veYFI StateMind Audit](https://github.com/statemindio/public-audits/blob/main/Yearn%20Finance/2022-07-08_Yearn_veYFI(Voting_and_RewardPool).pdf)** - **[veYFI yAcademy Audit](https://github.com/yearn/yearn-security/blob/master/audits/202208_yAcademy_yearn-veyfi/yAcademy_-_yearn_veyfi_review.pdf)** - **[dYFI ChainSecurity Audit](https://old.chainsecurity.com/wp-content/uploads/2023/03/Yearn-Smart-Contract-Audit-oYfi-ChainSecurity.pdf)** diff --git a/docs/contributing/governance/veYFI-intro.md b/docs/contributing/governance/veYFI-intro.md index 2895132a3d..61c1722370 100644 --- a/docs/contributing/governance/veYFI-intro.md +++ b/docs/contributing/governance/veYFI-intro.md @@ -7,7 +7,7 @@ For the current governance staking UX, see [stYFI](/contributing/governance/styf If you have a legacy veYFI lock, see [Migrate from veYFI](/contributing/governance/migrating-from-veyfi). ::: -veYFI is a time-locked version of the YFI token that grants access to governance, yield boosts, and rewards. It is based on [Curve's vote escrow (ve) model](https://resources.curve.finance/crv-token/vecrv/) and each YFI token can be locked for up to 4 years (technically longer, but there is no added voting or earning power gained by locking for more than 4 years). The length of lock determines how much veYFI is received per locked YFI. One YFI locked for four+ years converts to one veYFI. This relationship scales linearly, so one YFI locked for two years converts to 0.5 veYFI, one year converts to 0.25 veYFI, and so forth. +veYFI is a time-locked version of the YFI token that grants access to governance, yield boosts, and rewards. It is based on [Curve's vote escrow (ve) model](https://resources.curve.finance/) and each YFI token can be locked for up to 4 years (technically longer, but there is no added voting or earning power gained by locking for more than 4 years). The length of lock determines how much veYFI is received per locked YFI. One YFI locked for four+ years converts to one veYFI. This relationship scales linearly, so one YFI locked for two years converts to 0.5 veYFI, one year converts to 0.25 veYFI, and so forth. ## veYFI Benefits @@ -15,7 +15,7 @@ Locking YFI for veYFI has 3 main benefits: Voting power, Yield boosts on funds d ### veYFI Voting -veYFI is the governance token of Yearn. It is used to vote on YFI emissions distributions and other governance items in [snapshot](https://snapshot.org/#/veyfi.eth). For more information on Yearn's governance process, head over to the [governance section of the docs](/contributing/governance/proposal-process). +veYFI was the governance token of Yearn, used to vote on YFI emissions distributions and other governance items in [snapshot](https://snapshot.org/#/veyfi.eth). For information on Yearn's current governance process, which now uses stYFI, see the [governance section of the docs](/contributing/governance/proposal-process). ### veYFI Yield Boosts on Yearn Deposits diff --git a/docs/contributing/governance/veyfi.md b/docs/contributing/governance/veyfi.md index b80193a745..1783441371 100644 --- a/docs/contributing/governance/veyfi.md +++ b/docs/contributing/governance/veyfi.md @@ -38,7 +38,7 @@ veYFI incorporates [YIP-56: Buyback and Build](https://gov.yearn.fi/t/yip-56-buy - Penalty Formula: `min(75%, lock_duration_left / 4 years * 100%)` - veYFI holders are eligible to receive a share of the early exit penalties. - veYFI holders are eligible to receive a share of gauge dYFI rewards from unused boosts. -- Now that veYFI has been implemented, only veYFI is accepted voting power in Yearn Governance. +- When the veYFI system was active, only veYFI was accepted as voting power in Yearn Governance (since superseded by stYFI as of YIP-88). ## dYFI as Gauges Reward diff --git a/docs/contributing/governance/yfi.md b/docs/contributing/governance/yfi.md index d81ea4f424..3aafb53537 100644 --- a/docs/contributing/governance/yfi.md +++ b/docs/contributing/governance/yfi.md @@ -23,11 +23,11 @@ When the YFI token contract was deployed, users of various DeFi protocols were a YFI was designed with a minting function built in. Originally, this function was solely controlled by Andre Cronje, but shortly after the token emissions began, that control was handed to a multisig wallet. -Because the intention behind YFI was to completely decentralize control, there were no concrete plans for emissions after the initial 30,000 YFI were distributed. [YIP-1](https://yips.yearn.fi/YIPS/yip-1) approved a weekly distribution of YFI, but the execution of that proposal required a second decision about how to distribute, which did not come to fruition. +Because the intention behind YFI was to completely decentralize control, there were no concrete plans for emissions after the initial 30,000 YFI were distributed. [YIP-1](/contributing/governance/yips/yip-1) approved a weekly distribution of YFI, but the execution of that proposal required a second decision about how to distribute, which did not come to fruition. ### Phasing out YFI staking revenue -Starting with [YIP-36](https://yips.yearn.fi/YIPS/yip-36), a portion of staking rewards were redirected to the multisig wallet in order to fund operational expenses. When the multisig wallet had a buffer of $500,000, rewards were distributed to token holders. +Starting with [YIP-36](/contributing/governance/yips/yip-36), a portion of staking rewards were redirected to the multisig wallet in order to fund operational expenses. When the multisig wallet had a buffer of $500,000, rewards were distributed to token holders. [YIP-56](https://snapshot.org/#/yearn/proposal/Qmb6gBzjvgLMazSrQQGVcjutLNdkVyM2Lh6yckMzdoaHWZ) disbanded the staking system all-together and opted for a buyback system. This directed more capital to Yearn's treasury while benefiting token holders by taking YFI off of the open market. With this, the YFI Governance Vault was retired, and holders were allowed to participate in governance while holding YFI elsewhere. diff --git a/docs/contributing/governance/yips/yip-52.md b/docs/contributing/governance/yips/yip-52.md index 1f7c74f8cc..ca7cd3ad40 100644 --- a/docs/contributing/governance/yips/yip-52.md +++ b/docs/contributing/governance/yips/yip-52.md @@ -12,7 +12,7 @@ sidebar_position: -52 | Outcome | **Passed** | | Authors | banteg, lehnberg, milkyklim | | Created | 2020-11-09 | -| Forum discussion | [View discussion](https://gov.yearn.fi/t/yip-52-make-strategist-skin-in-game-partner-for-make-benefit-of-glorious-brain-of-yearn/) | +| Forum discussion | [View discussion](https://gov.yearn.fi/t/yip-52-make-strategist-skin-in-game-partner-for-make-benefit-of-glorious-brain-of-yearn/7856) | | Snapshot vote | [View vote](https://snapshot.org/#/s:yearn/proposal/QmbAq6jPB6ocrihjkDo5TLNF4D4w9dw1HsEsJ7vwdwd9g3) | | Vote result | Accept proposal: 1,341.94; Reject proposal: 260.13 | | Source | [Source](https://github.com/yearn/YIPS/blob/master/YIPS/yip-52.md) | diff --git a/docs/contributing/governance/yips/yip-53.md b/docs/contributing/governance/yips/yip-53.md index b3f06fe24d..3040716530 100644 --- a/docs/contributing/governance/yips/yip-53.md +++ b/docs/contributing/governance/yips/yip-53.md @@ -12,7 +12,7 @@ sidebar_position: -53 | Outcome | **Passed** | | Authors | aliatiia | | Created | 2020-11-11 | -| Forum discussion | [View discussion 1](https://gov.yearn.fi/t/yip-53-yacademy-planting-the-seed-of-a-sustainably-secure-future-for-yearn-and-beyond), [View discussion 2](https://gov.yearn.fi/t/lets-poach-samczsun-and-plant-the-seed-for-an-auditing-academy/5507) | +| Forum discussion | [View discussion 1](https://gov.yearn.fi/t/yip-53-yacademy-planting-the-seed-of-a-sustainably-secure-future-for-yearn-and-beyond/7929), [View discussion 2](https://gov.yearn.fi/t/lets-poach-samczsun-and-plant-the-seed-for-an-auditing-academy/5507) | | Snapshot vote | [View vote](https://snapshot.org/#/s:yearn/proposal/QmPTAfJCq3UtFZqY3jdgNEJsxc6yuHwfESnQyjjkoccZrJ) | | Vote result | Launch yAcademy: 937.09; Do not launch yAcademy: 0.1 | | Source | [Source](https://github.com/yearn/YIPS/blob/master/YIPS/yip-53.md) | diff --git a/docs/contributing/governance/yips/yip-91.md b/docs/contributing/governance/yips/yip-91.md index 398905daf8..a352bc23c2 100644 --- a/docs/contributing/governance/yips/yip-91.md +++ b/docs/contributing/governance/yips/yip-91.md @@ -9,12 +9,12 @@ sidebar_position: -91 | Metadata | Details | | --- | --- | | YIP | 91 | -| Outcome | **Active** | +| Outcome | **Passed** | | Authors | Vaults Team | | Created | 2026-07-06 | | Forum discussion | [View discussion](https://gov.yearn.fi/t/yip-91-ytranche/14659) | | Snapshot vote | [View vote](https://snapshot.org/#/s:styfi.eth/proposal/0xa348d353b66f46c6957a938a42fbf860eaffc855cd9163d8042780f65ea72612) | -| Vote result | For: 182.73; Against: 0; Abstain: 0 | +| Vote result | For: 1155.89; Against: 11.98; Abstain: 0 | | Source | [Source](https://gov.yearn.fi/t/yip-91-ytranche/14659) | _Authors: Vaults Team_ @@ -27,8 +27,8 @@ yTranche is a generalized, CLO-inspired tranching framework purpose-built for th ## Status -**Discussion** -This proposal is currently in the discussion phase. As per our voting rules outlined in YIP-55, it will be in discussion for at least 3 days with a non-binding forum poll to gauge sentiment before it can be assigned a YIP number and move to Snapshot for a binding vote by stYFI holders. +**Passed** +This proposal followed the voting rules outlined in YIP-55: after at least 3 days of discussion with a non-binding forum poll to gauge sentiment, it was assigned a YIP number and moved to Snapshot for a binding vote by stYFI holders, where it passed. ## Abstract diff --git a/docs/contributing/introduction.md b/docs/contributing/introduction.md index 1aba193d3e..a08b6a562b 100644 --- a/docs/contributing/introduction.md +++ b/docs/contributing/introduction.md @@ -6,4 +6,4 @@ Yearn is a collective of developers, users, thinkers, and doers all working towa ## Governance -The Yearn ecosystem is controlled by YFI token holders who submit and vote on offchain 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](/developers/security/multisig) for the list of multisig signers. For more info about the governance process, please consult the [multisig members list](/developers/security/multisig) and [YIP-61: Governance 2.0](https://gov.yearn.fi/t/yip-61-governance-2-0/10460). +The Yearn ecosystem is controlled by stYFI token holders who submit and vote on offchain 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 stYFI holders and are subject to change from future governance votes. Please refer to the [multisig documentation](/developers/security/multisig) for the list of multisig signers. For more info about the governance process, please consult the [multisig members list](/developers/security/multisig) and [YIP-61: Governance 2.0](https://gov.yearn.fi/t/yip-61-governance-2-0/10460). diff --git a/docs/contributing/operations/decision-making.md b/docs/contributing/operations/decision-making.md index fcbbf6b5fa..386ddddb43 100644 --- a/docs/contributing/operations/decision-making.md +++ b/docs/contributing/operations/decision-making.md @@ -27,7 +27,7 @@ Here are some examples for the four categories of decisions that emerge from thi ### Onchain -All possible gated onchain decisions are organized by Gov 2.0 into discrete and transferable objects called 'Decision-Making Powers' or just 'powers' for short. These powers are objects --- abstractions just above the specific transactions that embody the actual decisions. As we use this new system, we can decide to make these objects more or less granular. Currently YFI holders have the 'Manage Powers' decision-making power, so changes to each power is decided via YFI vote. But, YFI holders could vote to delegate the 'Manage Powers' power, or a subset of it, to a yTeam in the future. +All possible gated onchain decisions are organized by Gov 2.0 into discrete and transferable objects called 'Decision-Making Powers' or just 'powers' for short. These powers are objects --- abstractions just above the specific transactions that embody the actual decisions. As we use this new system, we can decide to make these objects more or less granular. Currently stYFI holders have the 'Manage Powers' decision-making power, so changes to each power is decided via stYFI vote. But, stYFI holders could vote to delegate the 'Manage Powers' power, or a subset of it, to a yTeam in the future. ### Offchain @@ -143,4 +143,4 @@ The conflict resolution process has 3 phases: 1. If they can't find a solution agreeable to both, they nominate a colleague they both trust to act as a mediator. The mediator doesn't impose a decision. Rather he or she supports the participants in coming to their own solution. 1. If mediation fails, a panel of topic-relevant colleagues is convened. Again the panel does not impose a solution. -If no resolution is found after these three phases, the two people may call in a senior contributor they both trust to the panel to add moral weight (but again, not to impose a solution). And in the exceedingly rare case that this final step be insufficient, other yearn organs may need to get involved, such as yPeople or yOps. +If no resolution is found after these three phases, the two people may call in a senior contributor they both trust to the panel to add moral weight (but again, not to impose a solution). And in the exceedingly rare case that this final step be insufficient, other yearn organs may need to get involved, such as other Yearn teams. diff --git a/docs/developers/security/multisig.md b/docs/developers/security/multisig.md index 45fc1a98e7..1400a64c74 100644 --- a/docs/developers/security/multisig.md +++ b/docs/developers/security/multisig.md @@ -2,7 +2,7 @@ ## How it works -The multisig is implemented by a 6-of-9 multi-signature wallet. The members of the multi-signature wallet were voted in by YFI holders and are subject to change from future governance votes. Specific powers are delegated to the governance multisig, as defined by [Governance 2.0](https://gov.yearn.fi/t/yip-41-temporarily-empower-multisig/3630). +The multisig is implemented by a 6-of-9 multi-signature wallet. The members of the multi-signature wallet were voted in by YFI holders and are subject to change from future governance votes. Specific powers are delegated to the governance multisig, as defined by [Governance 2.0](https://gov.yearn.fi/t/yip-61-governance-2-0/10460). The multisig is implemented as a Gnosis Safe. The multisig's assets, transactions, and signers can be viewed using [Gnosis's Web UI](https://app.safe.global/home?safe=eth:0xFEB4acf3df3cDEA7399794D0869ef76A6EfAff52). If there is a need to trustlessly audit Yearn's multisig (without trusting the Gnosis site), the Gnosis Safe web app source code can be found on GitHub [here](https://github.com/safe-global/safe-wallet-web). diff --git a/sidebars/sidebarsContributing.js b/sidebars/sidebarsContributing.js index 92d0f86519..7738997e49 100644 --- a/sidebars/sidebarsContributing.js +++ b/sidebars/sidebarsContributing.js @@ -19,6 +19,7 @@ module.exports = { type: 'category', label: 'Governance', items: [ + 'governance/governance-and-operations', 'governance/proposal-process', { type: 'category',