diff --git a/SUMMARY.md b/SUMMARY.md index 1a06ba0a..760fbd26 100644 --- a/SUMMARY.md +++ b/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) diff --git a/rewards/df-background.md b/rewards/df-background.md index 07a3db39..9efdc7e3 100644 --- a/rewards/df-background.md +++ b/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. +

I know this is a lot of info, but don't run away!

+ +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. -1. Buy the datasets (and use them to make $) — or work with people who can -1. Claim the rewards. +2. Lock OCEAN and stake veOCEAN on them. +3. Buy the datasets (and use them to make $) — or work with people who can +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: -– 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. +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. 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/) -- Can’t be in [purgatory](https://github.com/oceanprotocol/list-purgatory/blob/main/policies/README.md) + +* 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/) +* 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) \ No newline at end of file +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. + +

Ocean Reward Schedule for the next 20+ years

diff --git a/rewards/df-intro.md b/rewards/df-intro.md index 98b4609d..fc5f2b58 100644 --- a/rewards/df-intro.md +++ b/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. - -

I know this is a lot of info, but please don't leave!

- ### 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. @@ -32,13 +26,17 @@ Passive rewards are the OCEAN rewards paid to Data Farmers just for locking thei
+[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% | -

Publishing makes you even more OCEAN rewards

+### What are Publisher Rewards? -### Publisher Rewards - 2x Stake +

Publishing makes you *more* OCEAN rewards

-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.**_ - -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. +How is it calculated? _All the veOCEAN a Data Farmer has allocated to an asset they’ve published is **doubled for the rewards calculation.**_ 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. - -## 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/). diff --git a/rewards/veocean.md b/rewards/veocean.md index 8fc4a2d5..891ef33e 100644 --- a/rewards/veocean.md +++ b/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 **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. 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_ + + +

Flow of Value

The veOCEAN design is in accordance with the Web3 Sustainability Loop, which Ocean uses as its system-level design. diff --git a/user-guides/claim-ocean-rewards.md b/user-guides/claim-ocean-rewards.md index 1a429a8b..c31b8ff0 100644 --- a/user-guides/claim-ocean-rewards.md +++ b/user-guides/claim-ocean-rewards.md @@ -6,7 +6,7 @@ description: How to claim OCEAN token rewards from data farming 🧑‍🌾🥕
-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). 🤠 diff --git a/user-guides/how-to-data-farm.md b/user-guides/how-to-data-farm.md index 835e0caf..7e991610 100644 --- a/user-guides/how-to-data-farm.md +++ b/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