oceanprotocol
/
docs
mirror of https://github.com/oceanprotocol/docs.git
1
0
Fork 0
Code Releases Activity

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

This commit is contained in:
Veronica Manuel 2023-05-25 12:17:36 +00:00 committed by gitbook-bot
parent 5470879f98
commit e05ca12a5f
No known key found for this signature in database
GPG Key ID: 07D2180C7B12D0FF
3 changed files with 37 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
.gitbook/assets/cash-flow.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 706 KiB

BIN
.gitbook/assets/hustlin.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.3 MiB

70
rewards/df-background.md
View File

@ -8,65 +8,67 @@ description: >-
<figure><img src="../.gitbook/assets/neo-kinda-martial-arts.gif" alt=""><figcaption><p>Like Neo, you have great potential.</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.
## How to Maximize Your Yield
## Max Out Your Yields
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).
If you only lock your OCEAN tokens to get passive yield, then you're leaving money on the table. Data Farming rewards farmers that allocate their veOCEAN tokens to assets that **generate revenue** on the Ocean Market. (No revenue, no rewards.) In addition, Data Farming incentivizes **publishing** assets on the Ocean Market too - you get **2x the allocation power** when you allocate to an asset that you publish!
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
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.
1. Lock your OCEAN for veOCEAN to claim weekly Passive Rewards
2. Create & publish assets (and make $ in selling them) — or work with people who can
3. Lock OCEAN and stake veOCEAN on your published assets for weekly Active 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 :)
## Those assets don't sell themselves!
### Measuring Data Farming's Success
Marketing your assets to buyers is your challenge. Just because you list them on the Ocean Market doesn't mean that they will sell. It will take real work. Your reward is great APY. It’s incentives all the way down :)
**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/hustlin.gif" alt=""><figcaption></figcaption></figure>
## Reward Function
## Measuring Data Farming's Success
The Reward Function (RF) governs how active rewards are allocated to stakers.
**Data Consume Volume (DCV)** is a our term for **the total $ amount spent on purchases of Ocean Market assets**, transaction fees, and more. The higher DCV of Ocean Market assets, then the more OCEAN rewards are distributed to Data Farmers. It's that simple!
Rewards are calculated as follows:
## How Rewards are Calculated
1. Distribute OCEAN across each asset based on rank: highest-DCV asset gets most OCEAN, etc.
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.
The Reward Function (RF) governs how active rewards are allocated to Data Farmers.
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/)
**Rewards are calculated as follows:**
### Ranked Rewards
1. Distribute OCEAN across each asset **based on rank**: highest-DCV asset gets most OCEAN, etc.
2. For each asset and each veOCEAN holder: If the holder is a publisher, 2x the effective allocation – Baseline rewards = (% allocation in asset) \* (OCEAN for asset) – Bound rewards to the asset by 125% APY – Bound rewards by asset’s DCV \* 0.1%.
In DF23 Ranked Rewards were introduced and smooth the reward distribution by using a logarithmic function.
For mathematicians and coders, 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/)!
**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.**
### What are Ranked Rewards?
In Data Farming Round 23 Ranked Rewards were introduced to smooth out the reward distribution by using a logarithmic function.
**Since rewards are distributed across the Top 100 assets, all data farmers (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](../.gitbook/assets/rewards/ranked_rewards_study.png)
![Ranked Rewards](../.gitbook/assets/rewards/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/).
You can read more about the why, what, and how of Ranked Rewards [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
## Assets that Qualify for Data Farming
Data assets that have veOCEAN allocated towards them get DF rewards.
Data assets that have veOCEAN allocated towards them get Data Farming active 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, ..).
The asset may be of any type — dataset, algorithm for Compute-to-Data, or any other Datatoken token-gated system. The asset may be fixed price or free price. If fixed price, any token of exchange is alright (OCEAN, H2O, USDC, etc).
To qualify for DF, a data asset must also:
To qualify for DF, an 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)
## 4 Phases of Data Farming
## A Brief History 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.
Data Farming has evolved over time and will continue to do so as the Emission Curve progresses. Below are the phases and parameters incurred during the evolution of the Data Farming program. We are now in the DF Main phase.
**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.
@ -78,12 +80,14 @@ Data Farming has evolved over time and will continue to do so as the Emission Cu
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+**\
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.
We are now in DF Main which 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 understood in the Reward Schedule (see below).
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 below.
#### Reward Schedule
### Reward Schedule
The table below cross-references DF Round Number, Start Date, Phase & Week, Sub-Phase & Week, and OCEAN Rewards/Week.
The table below shows the total amount of OCEAN rewards that will be distributed among Passive and Active rewards each week. The table 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>
<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>
<figure><img src="../.gitbook/assets/cash-flow.gif" alt=""><figcaption></figcaption></figure>