GITBOOK-284: change request with no subject merged in GitBook

SUMMARY.md

@@ -92,8 +92,8 @@
 * [🤑 DeFi](defi/README.md)
 * [💰 Rewards](rewards/README.md)
   * [Data Farming 101](rewards/df-intro.md)
-  * [veOCEAN](rewards/veocean.md)
   * [Data Farming Background](rewards/df-background.md)
+  * [What is veOCEAN?](rewards/veocean.md)
   * [Emissions & APYs](rewards/emissions-apys.md)
   * [Rewards Tutorial](rewards/veOcean-Data-Farming-Tutorial.md)
 * [🤝 Contribute](contribute/README.md)

rewards/df-background.md

@@ -1,36 +1,57 @@
 ---
-description: Data Farming (DF) incentivizes for growth of Data Consume Volume (DCV) in the Ocean ecosystem.
+description: >-
+  If you've gotten this far, then you're well on your way to getting a blackbelt
+  in Ocean Protocol's Data Farming dApp!
 ---
+
 # Data Farming Background
 
-It rewards OCEAN to stakers as a function of consume volume and liquidity. It’s like DeFi liquidity mining, but tuned for data consumption. DF’s aim is to achieve a minimum supply of data for network effects to kick in, and once the network flywheel is spinning, to increase growth rate.
+<figure><img src="../.gitbook/assets/please-dont-leave.gif" alt=""><figcaption><p>I know this is a lot of info, but don't run away!</p></figcaption></figure>
+
+Data Farming rewards OCEAN to participants as a function of consume volume and liquidity. It’s like DeFi liquidity mining, but tuned for asset consumption. Data Farming's aim is to achieve a minimum supply of data for network effects to kick in, and once the network flywheel is spinning, increase the growth rate.
 
 ## Active Work to Drive APY
 
 Data Farming is not a wholly passive activity. The name of the game is to drive Data Consume Volume (DCV). High APYs happen only when there is sufficiently high DCV. High DCV means publishing and consuming truly useful datasets (or algorithms).
 
 Thus, if you really want to max out your APY:
+
 1. Create & publish datasets (and make $ in selling them) — or work with people who can
-1. Lock OCEAN and stake veOCEAN on them.
+2. Lock OCEAN and stake veOCEAN on them.
-1. Buy the datasets (and use them to make $) — or work with people who can
+3. Buy the datasets (and use them to make $) — or work with people who can
-1. Claim the rewards.
+4. Claim the rewards.
 
 Driving DCV for publishing & consuming is your challenge. It will take real work. And then the reward is APY. It’s incentives all the way down :)
 
+### Measuring Data Farming's Success
+
+**Data Consume Volume (DCV)** is a metric for **the total $ amount spent on purchases of Ocean Market assets**, transaction fees, and more. As Ocean Market assets are purchased (i.e. consumed), then the more OCEAN rewards are distributed to Data Farmers.
+
 ## Reward Function
 
 The Reward Function (RF) governs how active rewards are allocated to stakers.
 
 Rewards are calculated as follows:
+
 1. Distribute OCEAN across each asset based on rank: highest-DCV asset gets most OCEAN, etc.
-1. For each asset and each veOCEAN holder:
+2. For each asset and each veOCEAN holder: – If the holder is a publisher, 2x the effective stake – Baseline rewards = (% stake in asset) \* (OCEAN for asset) – Bound rewards to the asset by 125% APY – Bound rewards by asset’s DCV \* 0.1%. This prevents wash consume.
-– If the holder is a publisher, 2x the effective stake
-– Baseline rewards = (% stake in asset) * (OCEAN for asset)
-– Bound rewards to the asset by 125% APY
-– Bound rewards by asset’s DCV * 0.1%. This prevents wash consume.
 
 You can find this code inside [calcrewards.py](https://github.com/oceanprotocol/df-py/blob/main/util/calcrewards.py) in the Ocean Protocol [df-py repo](https://github.com/oceanprotocol/df-py/)
 
+### Ranked Rewards
+
+In DF23 Ranked Rewards were introduced and smooth the reward distribution by using a logarithmic function.
+
+**Since rewards are distributed across the Top 100 assets, all participants (Publishers & Curators) are now incentivized to support a broader range of assets rather than optimizing on a single asset.**
+
+At the top-end, this helps increase quality and diversification of inventory.
+
+At the bottom-end, this eliminates some potential free-rider issues and smooths out the reward distribution.
+
+![Ranked Rewards](images/ranked\_rewards\_study.png)
+
+You can read more about the implementation [in this blog post](https://blog.oceanprotocol.com/data-farming-df22-completed-df23-started-reward-function-tuned-ffd4359657ee) and find the full study [in these slides](https://docs.google.com/presentation/d/1HIA2zV8NUPpCELmi2WFwnAbHmFFrcXjNQiCpEqJ2Jdg/).
+
 ## Data Assets that Qualify for DF
 
 Data assets that have veOCEAN allocated towards them get DF rewards.
@@ -38,24 +59,31 @@ Data assets that have veOCEAN allocated towards them get DF rewards.
 The data asset may be of any type — dataset (for static URIs), algorithm for Compute-to-Data, or any other Datatoken token-gated system. The data asset may be fixed price or free price. If fixed price, any token of exchange is alright (OCEAN, H2O, USDC, ..).
 
 To qualify for DF, a data asset must also:
-- Have been created by Ocean Smart contracts [deployed](https://github.com/oceanprotocol/contracts/blob/v4main/addresses/address.json) by OPF to [production networks](https://docs.oceanprotocol.com/discover/networks)
+
-- Be visible on [Ocean Market](https://market.oceanprotocol.com/)
+* Have been created by Ocean Smart contracts [deployed](https://github.com/oceanprotocol/contracts/blob/v4main/addresses/address.json) by OPF to [production networks](https://docs.oceanprotocol.com/discover/networks)
-- Can’t be in [purgatory](https://github.com/oceanprotocol/list-purgatory/blob/main/policies/README.md)
+* Be visible on [Ocean Market](https://market.oceanprotocol.com/)
+* Can’t be in [purgatory](https://github.com/oceanprotocol/list-purgatory/blob/main/policies/README.md)
 
 ## 4 Phases of Data Farming
 
 Data Farming has evolved over time and will continue to do so as the Emission Curve progresses. We are now in DF main, below are the previous phases and parameters incurred during the evolution of the Data Farming program.
 
-**DF Alpha - Rounds 1-4 (4 wks)**  
+**DF Alpha - Rounds 1-4 (4 wks)**\
 10K OCEAN rewards were budgeted per week. Counting started Thu June 16, 2022 and ended July 13, 2022. Rewards were distributed at the end of every week, for the activity of the previous week. It ran for 4 weeks. The aim was to test technology, learn, and onboard data publishers.
 
-**DF/VE Alpha - Rounds 5-8 (4 wks)**  
+**DF/VE Alpha - Rounds 5-8 (4 wks)**\
 10K OCEAN rewards were budgeted per week. Counting started Thu Sep 29, 2022 and ended Oct 27, 2022. Rewards were distributed at the end of every week, for the activity of the previous week. It ran for 4 weeks. The aim was to resume Data Farming along with veOCEAN, test the technology, onboard data publishers, and keep learning.
 
-**DF Beta - Rounds 9-28 (20 wks)**  
+**DF Beta - Rounds 9-28 (20 wks)**\
 Up to 100K OCEAN rewards were budget per week. Counting started Thu Oct 27, 2022 and ended March 15, 2023. It ran for 20 weeks. The aim was to test the effect of larger incentives, support ecosystem participation, while continue refining the underlying technology.
 
-**DF Main - Rounds 29-1000+**  
+**DF Main - Rounds 29-1000+**\
 Immediately followed the release of DF Beta on Thu Mar 16, 2023. Rewards begin at 150k per week and go to 1.1M OCEAN per week. DF Main emits 503.4M OCEAN worth of rewards and lasts for decades. Expected APY is 125% over many months (once fully ramped), staying generous over the long term.
 
-The amount of OCEAN released is determined by the emission schedule as defined by the [Emission Curve](emissions-apys.md#emissions--apys), and perhaps more easily uderstood in the [Reward Schedule](df-intro.md#reward-schedule)
+The amount of OCEAN released is determined by the emission schedule as defined by the [Emission Curve](emissions-apys.md#emissions--apys), and perhaps more easily understood in the Reward Schedule (see below).
+
+#### Reward Schedule
+
+The table below cross-references DF Round Number, Start Date, Phase & Week, Sub-Phase & Week, and OCEAN Rewards/Week.
+
+<figure><img src="../.gitbook/assets/rewards/reward_schedule.png" alt=""><figcaption><p> <em>Ocean Reward Schedule for the next 20+ years</em></p></figcaption></figure>

rewards/df-intro.md

@@ -1,5 +1,5 @@
 ---
-description: Get a blackbelt in Ocean Protocol's Data Farming dApp by reading our docs!
+description: Your first and favorite course in Ocean Protocol's Data Farming dApp
 ---
 
 # Data Farming 101
@@ -12,16 +12,10 @@ Data Farming (DF) is Ocean Protocol's **incentive system for curating high quali
 
 (If you are familiar with 'liquidity mining', then you will find that Data Farming is similar but tuned instead for the curation of high quality assets on the Ocean Market.)
 
-### How is Data Farming different from Yield Farming?
+### What's the difference between Data Farming and Yield Farming?
 
 Unlike yield farming in DeFi, data farming has real intrinsic utility for Ocean Protocol stakeholders: as Data Farmers determine which are the highest quality assets on the Ocean Market to purchase, then the Data Farmers earn active OCEAN rewards when these assets sell. It's this **curation of the "best" assets on the Ocean Market** that shortens the search times for those looking to shop on the Ocean Market. We also put in place an incentive system for Publishers of assets to gain **2x the rewards** in Data Farming, thus driving forward the addition of great assets on the OM.
 
-### Measuring Data Farming's Success
-
-**Data Consume Volume (DCV)** is a metric for **the total $ amount spent on purchases of Ocean Market assets**, transaction fees, and more. As Ocean Market assets are purchased (i.e. consumed), then the more OCEAN rewards are distributed to Data Farmers.
-
-<figure><img src="../.gitbook/assets/please-dont-leave.gif" alt=""><figcaption><p>I know this is a lot of info, but please don't leave!</p></figcaption></figure>
-
 ### Passive and Active Rewards
 
 Every week OCEAN rewards are paid out to Data Farmers in two different ways: **passive** rewards and **active** rewards. The two reward functions produce different variable APYs.&#x20;
@@ -32,13 +26,17 @@ Passive rewards are the OCEAN rewards paid to Data Farmers just for locking thei
 
 <figure><img src="../.gitbook/assets/passive-income.gif" alt=""><figcaption></figcaption></figure>
 
+[To start getting passive rewards, go here.](../user-guides/get-veocean-tokens.md)
+
 #### What are Active Rewards?
 
 Active rewards are OCEAN rewards paid to Data Farmers that allocate their veOCEAN tokens to Ocean Market assets. They're called Active rewards because the amount of rewards relies on the active participation of the Data Farmer to select and allocate veOCEAN to these assets. **Active rewards yield depends on the sales of allocated assets.** No sales = no rewards, so choose your favorites wisely & then allocate. Always DYOR.
 
-Active Rewards are governed and defined by the [Reward Function](df-background.md#reward-function).
+Active rewards are governed and defined by the [Reward Function](df-background.md#reward-function).
 
-#### Divvying Up the Goods
+[To start getting active rewards, go here.](../user-guides/how-to-data-farm.md)
+
+#### Splitting the Pie
 
 Each Data Farming weekly round has a pool of OCEAN rewards, and 50% of the pool is paid out in the form of passive rewards & 50% in the form of active rewards.
 
@@ -46,59 +44,15 @@ Each Data Farming weekly round has a pool of OCEAN rewards, and 50% of the pool
 | --------------- | -------------- |
 | 50%             | 50%            |
 
-<figure><img src="../.gitbook/assets/just-publish.gif" alt=""><figcaption><p>Publishing makes you even more OCEAN rewards</p></figcaption></figure>
+### What are Publisher Rewards?
 
-### Publisher Rewards - 2x Stake
+<figure><img src="../.gitbook/assets/just-publish.gif" alt=""><figcaption><p>Publishing makes you *more* OCEAN rewards</p></figcaption></figure>
 
-Data Farming strongly incentivizes publishing assets on the Ocean Market.
+Data Farming strongly incentivizes publishing assets on the Ocean Market by giving double the active rewards to Data Farmers that allocate to their own published assets.
 
-_All the veOCEAN a publisher has allocated to an asset they’ve published (i.e. staked) is treated as **2x the stake for rewards calculation.**_
+How is it calculated? _All the veOCEAN a Data Farmer has allocated to an asset they’ve published is **doubled for the rewards calculation.**_
-
-1. As a staker, due to their staked veOCEAN on their own assets (1x).
-2. As a publisher, for having veOCEAN staked on their own asset(1x).
-
-The final reward is then calculated and bundled together to be distributed.
 
 You can read more about the implementation [in this blog post](https://blog.oceanprotocol.com/data-farming-publisher-rewards-f2639525e508).
 
-### Where do I get my Data Farming rewards?
+## [GET STARTED DATA FARMING HERE.](https://df.oceandao.org)
 
-All OCEAN rewards for Data Farming are claimable on the [Rewards page](https://df.oceandao.org/rewards) of the Data Farming webapp on Ethereum mainnet.
-
-### When can I get my Data Farming rewards?
-
-OCEAN rewards are distributed on Thursday every week. Data Farmers may claim rewards every week, or wait many weeks to accumulate before claiming. (It’s all on-chain.)
-
-For your first time claiming rewards, **you must wait at least one entire week** from Thursday and up to two weeks, to be able to claim rewards.&#x20;
-
-## Data Farming Main
-
-[DF Main](https://blog.oceanprotocol.com/ocean-data-farming-main-is-here-49c99602419e) started on Mar 16, 2023 in DF Round 29 after graduating from the alpha and beta testing phases. DF29 has 150K OCEAN rewards available (a 2x increase from DF28). As DF Main progresses, rewards will increase to 300K (another 2x), then 600K (another 2x), then beyond 1.1M OCEAN/week (near 2x) then decaying over time.
-
-As of DF29 (Mar 16, 2023), wash consuming is not profitable. So, organically-generated Data Consume Volume is the main driver of active DF rewards.
-
-[Example APYs are 5–20%](emissions-apys.md#example-apys) between Passive & Active rewards.
-
-Full implementation of DF Main will be over many months, after which DF will be decentralized.
-
-DF Main lasts for decades.
-
-## Reward Schedule
-
-The table below cross-references DF Round Number, Start Date, Phase & Week, Sub-Phase & Week, and OCEAN Rewards/Week.
-
-![Rewards Schedule](../.gitbook/assets/rewards/reward\_schedule.png) _Ocean Reward Schedule for the next 20+ years_
-
-## Ranked Rewards
-
-In DF23 Ranked Rewards were introduced and smooth the reward distribution by using a logarithmic function.
-
-**Since rewards are distributed across the Top 100 assets, all participants (Publishers & Curators) are now incentivized to support a broader range of assets rather than optimizing on a single asset.**
-
-At the top-end, this helps increase quality and diversification of inventory.
-
-At the bottom-end, this eliminates some potential free-rider issues and smooths out the reward distribution.
-
-![Ranked Rewards](images/ranked\_rewards\_study.png)
-
-You can read more about the implementation [in this blog post](https://blog.oceanprotocol.com/data-farming-df22-completed-df23-started-reward-function-tuned-ffd4359657ee) and find the full study [in these slides](https://docs.google.com/presentation/d/1HIA2zV8NUPpCELmi2WFwnAbHmFFrcXjNQiCpEqJ2Jdg/).

rewards/veocean.md

@@ -1,10 +1,10 @@
 ---
-description: An overview of the governance token, veOCEAN (vote-escrowed).
+description: Let's discuss the "ve" in veOCEAN
 ---
 
-# veOCEAN
+# What is veOCEAN?
 
-veOCEAN is the vote escrowed capability of the $OCEAN token through veTokenomics model (vote-escrowed token economics). veOCEAN is used to participate in on-chain governance, and earn rewards within the Ocean Protocol ecosystem. veOCEAN is architected to be staked or 'locked' for a certain period of time and cannot be transferred or sold during the lock time that is determined by each user.
+veOCEAN is the <mark style="color:orange;">**vote escrowed**</mark> capability of the $OCEAN token through veTokenomics model (vote-escrowed token economics). veOCEAN is used to participate in on-chain governance, and earn rewards within the Ocean Protocol ecosystem. veOCEAN is architected to be staked or 'locked' for a certain period of time and cannot be transferred or sold during the lock time that is determined by each user.
 
 Holders of veOCEAN can use it to vote on proposals or delegate their voting power to other stakeholders. Additionally, there are be other benefits associated with holding and staking veOCEAN, such as access to passive & active rewards in data farming or discounts on fees within the network.
 
@@ -97,7 +97,9 @@ Data Farming rounds occur weekly; in line with this, there’s a new ve distribu
 
 The image below illustrates the flow of value. On the left, at time 0, the staker locks their OCEAN into the veOCEAN contract, and receives veOCEAN. In the middle, the staker receives OCEAN rewards every time there’s revenue to the Ocean Protocol Community (top), and also as part of Data Farming rewards (bottom). On the right, when the lock expires (e.g. 4 years) then the staker is able to move their OCEAN around again.
 
-![Flow of Value](../.gitbook/assets/rewards/flow\_of\_value.png) _Flow of Value_
+&#x20;
+
+<figure><img src="../.gitbook/assets/rewards/flow_of_value.png" alt=""><figcaption><p>Flow of Value</p></figcaption></figure>
 
 The veOCEAN design is in accordance with the Web3 Sustainability Loop, which Ocean uses as its system-level design.
 

user-guides/claim-ocean-rewards.md

@@ -6,7 +6,7 @@ description: How to claim OCEAN token rewards from data farming 🧑‍🌾🥕
 
 <figure><img src="../.gitbook/assets/underwater-treasure.gif" alt=""><figcaption></figcaption></figure>
 
-Ocean Protocol's Data Farming dapp dispenses rewards every Thursday to its participants. 💰 To claim your OCEAN token rewards for data farming, simply navigate to the Data Farming [Rewards page](https://df.oceandao.org/activerewards) and click the Claim OCEAN rewards buttons that will appear pink and clickable each Thursday. Yeehaw!
+Ocean Protocol's Data Farming dapp dispenses rewards **every Thursday** to its participants. 💰 To claim your OCEAN token rewards for data farming, simply navigate to the Data Farming [Rewards page](https://df.oceandao.org/activerewards) and click the Claim OCEAN rewards buttons that will appear pink and clickable each Thursday. Yeehaw!
 
 Want to begin [data farming](https://df.oceandao.org)? Start [here](get-veocean-tokens.md). 🤠
 

user-guides/how-to-data-farm.md

@@ -1,5 +1,5 @@
 ---
-description: How to capitalize with Ocean Protocol's Data Farming dapp
+description: How to capitalize with Ocean Protocol's Data Farming dApp
 ---
 
 # How to Data Farm