oceanprotocol/docs
1
0
Fork 0
mirror of https://github.com/oceanprotocol/docs.git synced 2024-11-26 19:49:26 +01:00
Code Releases Activity

Fix #1436: [DF] Remove Passive DF & Volume DF; just Predictoor DF now (PR #1437)

Browse Source 
Fix #1436
This commit is contained in:
Trent McConaghy 2024-05-03 16:17:42 +02:00 committed by GitHub
commit f0f96064ac
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
16 changed files with 20 additions and 1016 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
README.md
View File

@ -57,7 +57,7 @@ layout: landing
</tr>
<tr>
<td><a href="data-farming/">data farming</a></td>
<td>Earn OCEAN rewards by locking OCEAN, curating data, and predicting.</td>
<td>Earn OCEAN rewards by predicting (and more streams to come)</td>
<td></td>
<td></td>
<td><a href="data-farming/">data farming</a></td>

51
data-farming/README.md
View File

@ -1,68 +1,39 @@
---
description: Earn OCEAN rewards by locking OCEAN, curating data, and making predictions.
description: Earn OCEAN rewards by predicting (and more streams to come).
cover: ../.gitbook/assets/cover/data_farming_banner.png
coverY: 0
---
# What is Data Farming?
**Data Farming (DF) is Ocean's incentive program.** It rewards OCEAN to participants who lock OCEAN into veOCEAN, curate data, or make predictions -- all in the name of driving **data consume volume** (DCV). DF is a bit like DeFi liquidity mining, but tuned for DCV.
## ⚠️ ASI Merge Update
Ocean Protocol is joining with Fetch and SingularityNET to form the Superintelligence Alliance, with a unified token $ASI. This is pending a vote of “yes” from the Fetch and SingularityNET communities, a process that will take several weeks. [This Mar 27, 2024 article](https://blog.oceanprotocol.com/ocean-protocol-is-joining-the-superintelligence-alliance-767c82693f24) describes the key mechanisms.
There are important implications for veOCEAN and Data Farming. The article [“Superintelligence Alliance Updates to Data Farming and veOCEAN”](https://blog.oceanprotocol.com/superintelligence-alliance-updates-to-data-farming-and-veocean-68d7b29c5100) elaborates.
Changes during voting period:
- **Passive DF and Volume DF rewards are paused** as of DF83, until the voting process completes.
- **veOCEAN lock and lock-update actions are disabled** on the DF app. We recomand users to **DO NOT INTERACT DIRECTLY WITH THE SMART CONTRACTS.**
- **Predictoor DF will continue** regardless of voting outcome.
How the vote outcome is going to affect Data Farming?
- **If "yes": veOCEAN, Passive DF, and active DF will be retired**. Each address that has locked OCEAN for veOCEAN and is holding veOCEAN will be made whole by an **OCEAN airdrop** of (1.25^years_til_unlock — 1) * num_OCEAN_locked.
- **If "no": Passive DF & Volume DF will resume** as-is. There will be rewards based on the weeks of DF pause.
(What follows here, and in other DF docs, is the documentation as if there are no changes. Therefore as you read them, understand that things change in light of the ASI Merge.)
---
**Data Farming (DF) is Ocean's incentive program.** It rewards OCEAN to participants who make predictions (and more streams to come).
**[The DF webapp](https://df.oceandao.org)** is where users perform most DF actions.
There is currently 300,000 OCEAN / week available for DF rewards.
## DF Streams & Budgets
DF is organized into two streams: Passive DF and Active DF. Each has 50% of the DF budget. Passive DF allows for passive earning potential. Active DF requires more engagement; it has several substreams, each with its own activity.
DF currently has one stream:
Here are all streams & substreams. The links lead to dedicated pages.
1. **[Passive DF](passivedf.md).** 150,000 OCEAN per week. Lock OCEAN for **veOCEAN**; rewards are pro-rata to veOCEAN holdings.
1. **Active DF.** 150,000 OCEAN per week. It has these substreams:
1. **[Volume DF](volumedf.md).** Allocate veOCEAN towards data assets with high DCV, ie "curate data". Rewards are a function of DCV and veOCEAN stake. 112.5K OCEAN/week.
1. **[Predictoor DF](predictoordf.md).** Run prediction bots to earn continuously. 37.5K OCEAN/week.
- **[Predictoor DF](predictoordf.md).** Run prediction bots to earn continuously. 37.5K OCEAN/week.
All streams and substreams repeat **weekly** that start on Thursdays 00:00 at UTC and end on Wed at 23:59 UTC.
**[Claiming rewards](claim-rewards.md)**. You can claim rewards each Thursday, or wait and claim many weeks' of rewards at once.
Active DF's substreams can -- and do -- evolve over time. It's chronicled [here](https://blog.oceanprotocol.com/ocean-data-farming-series-c7922f1d0e45).
Streams can -- and do -- evolve over time. It's chronicled [here](https://blog.oceanprotocol.com/ocean-data-farming-series-c7922f1d0e45).
## Reward Schedule & APYs
## Future Streams
**[Reward Schedule](reward-schedule.md)**. The 300,000 OCEAN / week currently available for DF rewards will increase over time to over 1.1M OCEAN / week.
We plan to scale up Predictoor DF rewards over time, especially as it hits development milestones. See [Ocean 2024 roadmap](https://blog.oceanprotocol.com/ocean-protocol-update-2024-e463bf855b03), sec 2.2.
**[Yields](apys.md)**. Historically, APYs are 5-20%. APYs vary week to week. APY depends on total OCEAN staked, duration of OCEAN lock, DCV, what DF streams you participate in, and other factors.
Other potential DF incentives include for running Unified Backend nodes (roadmap, sec 3.2), and for decentralized large-scale model training to support a world model on ground-truth physics (roadmap, sec 2.2).
## Networks
OCEAN rewards for all DF streams & substreams are on Ethereum mainnet. One exception: rewards for Predictoor DF are on Oasis Sapphire.
To engage in Predictoor DF, users submit Predictions on Oasis Sapphire.
Users engage in different networks, depending on the DF stream:
- Passive DF: veOCEAN is deployed on Ethereum mainet. Users lock OCEAN for veOCEAN on Ethereum mainnet
- Volume DF: users can allocate veOCEAN to data assets on Etherum mainnet, Polygon, BSC, Moonriver, Energy Web Chain, or Sapphire.
- Predictoor DF: users submit predictions on Sapphire.
Rewards for Predictoor DF are on Oasis Sapphire as well (it's intertwined).
The [networks docs](../discover/networks/README.md) have more info about networks.
@ -75,7 +46,7 @@ The [networks docs](../discover/networks/README.md) have more info about network
----
_Next: [Passive DF (and veOCEAN)](passivedf.md)_
_Next: [Predictoor DF](predictoordf.md)_
_Back: [Docs main](../README.md)_

76
data-farming/apys-guide.md
View File

@ -1,76 +0,0 @@
---
description: >-
From emissions, estimate APYs
---
<figure><img src="../.gitbook/assets/gif/mafs.gif" alt=""><figcaption><p>K.I.S.S.</p></figcaption></figure>
# Guide to Estimating APYs
Recall that APY is Annual Percentage Yield, and WPY is Weekly Percentage Yield.
**This page provides guidance to estimate APYs.**
### Estimating APY from WPYs
Here are a couple ways to estimate APY from WPYs: _with_ compounding, and without.
**APY with compounding.**
- If you were to take OCEAN rewards for given week and immediately put them back into Data Farming, then your rewards will **compound** every week.
- Then, `APY = (1.0 + WPY for week 1) * (1.0 + WPY for week 2) * ... * (1.0 WPY for week 52) - 1.0.
- Assuming equal WPY per week, `APY = (1.0 + WPY)^52 - 1.0`. Use 52.25 not 52.0 if you wish.
- For WPY of 0.005, then `APY = (1.0 + 0.005)^52 - 1.0 = 0.296 = 29.6%`.
- This assumes zero gas fees. That's reasonable given that staking & claiming are one-time transactions.
**APY without compounding.**
- If you don't do compounding, then `APY = (WPY for week 1) + (WPY for week 2) + ... + (WPY for week 52)`.
- Assuming equal WPY per week, `APY = WPY * 52`.
- For WPY of 0.05, then `APY = 0.005 * 52 = 0.260 = 26.0%`.
- This assumes zero gas fees. This works if you have a large amount of veOCEAN, and therefore large weekly OCEAN rewards, compared to gas fees. If that's not the case, so that gas fees don't destroy your profits, then you should (a) compound less often (b) use gas when it's cheapest, [see here](https://www.useweb3.xyz/gas).
### Estimating Passive DF APYs
The [Passive DF page](https://df.oceandao.org/passive-df) estimates profit & APY for you, as you explore different values of # OCEAN, lock time, and number of compounds. It accounts for gas costs.
You'll find that if # OCEAN is too small or lock time is too short, profit and APY will be <0 because gas fees will overwhelm rewards. Conversely, higher OCEAN locked and longer lock times will make APY larger.
### Estimating Volume DF APYs
APY from Volume DF is a bit more complicated and depend on many factors that are currently hard to predict accurately. It is unlikely for the user to get a practical result, which is why we don't offer a tool to estimate this value right now.
You can easily expand the spreadsheet above to support a basic, naive calculations for Volume DF Rewards such as adding a fixed-rate.
To help solve this challenge, [we built a dashboard](https://df.oceandao.org/volume-df) that shows historical and ongoing summaries of APY, Data Consume Volume, and veOCEAN allocations per-round.
<figure><img src="../.gitbook/assets/data-farming/curate-datasets.png" alt=""><figcaption><p>Curate like a Pro.</p></figcaption></figure>
Finally, you can [review df-web code](https://github.com/oceanprotocol/df-web/blob/main/src/utils/rewards.js) to understand how the APYs on the UI are calculated.
### Estimating Predictoor DF APYs
**Predictoor and staking.** Staking is a fundamental component of Predictoor: when someone makes a prediction, they must have an OCEAN stake amount accompanying that prediction.
Amount of stake increases potential gain and potential loss. For a given prediction, the more one stakes, the more they earn if they're right; and the more they lose if wrong. Earnings if right are also a function of Predictoor data feed sales revenue.
Predictoor has staking independent of Data Farming. Therefore, yield comes even without DF. Then, _Predictoor DF_ acts as _extra_ sales revenue for Predictoor data feeds; and yield with Predictoor DF is even higher.
**Yield for predictoors.** We can apply the yield formula for each prediction:
`yield = (start amount + gained amount) / (start amount) - 1.0`
Where in Predictoor and Predictoor DF, values are:
- `start amount` = OCEAN staked in prediction
- `gained amount` = `revenue * stake / (all users stake) - fee` if correct, `stake` if incorrect
**Be careful!** Yield can be negative if one's stake far exceeds revenue, even with a highly accurate model. But, if one has right-sized stakes and an accurate model, then yield can be quite healthy.
**Rapid compounding.** In other DF streams, rewards come weekly; so compounding is weekly. In Predictoor and Predictoor DF, a predictoor's revenue (rewards) come every epoch (every 5min or 1h). Therefore compounding in Predictoor could be _very_ fast, for much healthier yields yet.
**Estimation fidelity.** Since Predictoor is so young, we don't have detailed estimates of Predictoor APYs yet. We're excited to see where this takes us:)
----
_Next: [FAQ](faq.md)_
_Back: [APYs](apys.md)_

35
data-farming/apys-plot.md
View File

@ -1,35 +0,0 @@
---
description: >-
Modeling APYs
---
<figure><img src="../.gitbook/assets/gif/making-money-is-fun.gif" alt=""><figcaption><p></p></figcaption></figure>
# Estimated APY vs Time
The plot below shows estimated APY over time. It brings together data from the [OCEAN reward schedule](reward-schedule.md) and estimates of **amount staked (yellow line** in plot).
**Green is total APY** from passive and active rewards. **Passive rewards (black)** provides a great baseline with upside in **active rewards (green)**. For example, in DF29 wash consume became unprofitable and led to a drop in DCV and therefore active rewards.
<figure><img src="../.gitbook/assets/data-farming/example_apys.png" alt="" width="563"><figcaption><p><em>Green: estimated APYs (passive + active). Black: estimated APYs (just passive). Yellow: estimated staking</em> </p></figcaption></figure>
**It's an estimate.**
- That's ok! As the great statistician G.E. Box said, "All models are wrong, some are useful".
- APYs are an estimate because they depend on both DF rewards and OCEAN locked. Both of those are estimates, as follows.
- For simplicity, the model assumes that Active DF rewards are solely composed of Volume DF using the whole Active DF budget [1].
- OCEAN locked and lock time is not known for future weeks; it must be estimated [2].
**OCEAN lock time greatly affects APY.**
- The numbers above assume that all locked OCEAN is **locked for 4 years**, so that 1 OCEAN → 1 veOCEAN.
- But APY could be much worse or more if you lock for shorter durations. Divide by 4 if you lock for 1 year. [3] elaborates.
**Raw model.** All the plots are calculated from [this Google Sheet](https://docs.google.com/spreadsheets/d/1F4o7PbV45yW1aPWOJ2rwZEKkgJXbIk5Yq7tj8749drc/edit#gid=1051477754).
# Notes
[1] For better accuracy, one would need to account for Predictoor DF. However, this gets more complex because Predictoor DF is highly dependent on prediction accuracy.
[2] We modeled OCEAN locked by observing linear growth from DF week 5 (when OCEAN locking was introduced) to week 28: OCEAN locked grew from 7.89M OCEAN to 34.98M OCEAN respectively, or 1.177M more OCEAN locked per week. The true values of OCEAN locked was last updated on DF week 29. For more accuracy, that could be updated to the values since then.
[3] Here are approximate bounds: If you lock for 4 years, and everyone else locks for 2, then multiply expected APY by 2. If you lock for 4 years and others for 1, then multiply by 4. Conversely, if you lock for 2 years and everyone else for 4, then divide your expected APY by 2. If you lock for 1 year and others for 4, then divide by 4. The numbers assume that you’re actively allocating veOCEAN allocation towards high-DCV data assets. For passive locking or low-DCV data assets, divide APY by 2 (approximate).

55
data-farming/apys.md
View File

@ -1,55 +0,0 @@
---
description: >-
From emissions, estimate APYs
---
# APYs
<figure><img src="../.gitbook/assets/gif/many-penguins.gif" alt=""><figcaption><p>Multiply, and multiply again. And again.</p></figcaption></figure>
**This page** is about APYs. There's also [estimates of APY vs time](apys-plot.md) and [a guide to estimating APYs](apys-guide.md).
# About APYs
### Source of Rewards
Rewards are earned by users that participate in one or more Data Farming streams. Passive DF allows passive holding of veOCEAN; Active DF streams require more work from the user.
Historically, annual percentage yields (APYs) are 5-20%. See for yourself: in [DF app](https://df.oceandao.org/activerewards) and scroll down to "Data Farming History".
You can do your own APY estimations. In Passive DF, APY is highly dependent on the locked amount *and* duration of lock. In other DF streams, there are other factors.
### Definition of Yield, WPY, APY
A **yield** is the relative gain in value compared to the amount you started with, minus costs. Specifically:
`yield = (start amount + gained amount - costs) / (start amount) - 1.0`
For example, if you start with 1000 OCEAN, have 6 OCEAN gross revenue, and 1 OCEAN costs (net 5 OCEAN):
`yield = (1000 + 6 - 1) / (1000) - 1.0 = 0.005`
We can express yield as a percentage simply by multiplying by 100 (%). For example, yield of `0.005` in percentage is `0.005 * 100% = 0.5%`.
The yield for one week is **Weekly Percentage Yield**, or **WPY**. For example, if you started with 1000 OCEAN and netted 5 OCEAN from DF, in one week, then your WPY = 0.005 = 0.5%.
The yield for one year is **Annual Percentage Yield**, or **APY**. APY can be estimated from WPYs. Assuming no compounding, `APY = WPY*52`.
### Costs
Costs should not be under-estimated. Eg if you're only doing Passive DF, and you lock a small amount of OCEAN for a short time, costs may exceed your gross income.
**Costs include:**
- Gas fees for transactions (txs) on the various chains. Eg veOCEAN, passive DF rewards, and Volume DF rewards are on Ethereum mainnet. Predictoor DF is on Sapphire mainnet.
- Txs include: locking OCEAN, claiming passive rewards, claiming active rewards, and withdrawing rewards.
- To compound returns, these txs need to be repeated. The ideal frequency to compound rate is whatever maximizes your yield - which depends on how much OCEAN you've locked, tx fees, etc.
- Cost of compute hardware to run Predictoors, e.g. on cloud services
The **[guide to estimate APYs](apys-guide.md)** drills deeper into estimating APYs.
----
_Next: [APYs Guide](apys-guide.md)_
_Back: [Reward Schedule](reward-schedule.md)_

41
data-farming/claim-rewards.md
View File

@ -1,41 +0,0 @@
---
description: Unbox your OCEAN rewards
---
# Claim Rewards in DF
<figure><img src="../.gitbook/assets/gif/underwater-treasure.gif" alt=""><figcaption></figcaption></figure>
**This page describes how to claim DF rewards.** (Predictoor DF is an exception, [see here](predictoordf-guide.md).)
To claim rewards, go to DF webapp's **[Rewards page](https://df.oceandao.org/rewards)** and click "Claim OCEAN rewards" button.
Detailed instructions are below.
### Step 1 - Navigate to the Data Farming Rewards page
Go to [https://df.oceandao.org/](https://df.oceandao.org), and click the Rewards [link](https://df.oceandao.org/rewards) at the top of the page.
<figure><img src="../.gitbook/assets/data-farming/Rewards-Tab.png" alt=""><figcaption><p>Click the Rewards link at the top of the page</p></figcaption></figure>
### Step 2 - Click the pink 'Claim # OCEAN' buttons 🛎️
At the bottom of the 'Passive Rewards' and 'Active Rewards' panels are the 'Claim # OCEAN' buttons that appear pink and clickable on Thursdays.
This is where you click to claim your rewards! Easy peasy. You will need to approve the transactions with your wallet.
<figure><img src="../.gitbook/assets/data-farming/claim-rewards.png" alt=""><figcaption><p>Click the pink Claim # Ocean buttons</p></figcaption></figure>
### First time claiming?
You will need to wait at least one week, but not more than two weeks to claim your rewards for the first time. Check back on Thursday!
### Forgot to claim?
If you forget to claim your OCEAN rewards, then do not worry because they continue to accumulate! It's all fine. You can claim them anytime after Thursday. 😃
----
_Next: [Reward Schedule](reward-schedule.md)_
_Back: [Predictoor DF Guide](predictoordf-guide.md)_

50
data-farming/delegate.md
View File

@ -1,50 +0,0 @@
---
description: >-
Give another wallet power to allocate veOCEAN
---
# Delegation in Volume DF
<figure><img src="../.gitbook/assets/gif/underwater-buddy-peewee.gif" alt=""><figcaption></figcaption></figure>
## About Delegation
Delegation is a tool for Volume DF.
**[Here's the delegation page](https://df.oceandao.org/delegate) in the DF webapp.**
## Why Delegate?
Consider these challenges:
- Your veOCEAN is on a hardware wallet and you want a "hot" software wallet to auto-delegate based on data consume volume, to increase APY
- You have >1 wallets and it's a pain to switch among them for delegating
Delegation solves that. "To delegate" means "to transfer veOCEAN Allocation Power to another wallet address" for a limited period.
When you delegate, you delegate 100% of your veOCEAN Allocation power.
{% hint style="info" %}
If you delegate 100% of your Allocation Power, your allocations will not count until the delegation expires. The delegation expiration date is the same as your veOCEAN Lock End Date at the time of delegation. If necessary, you can extend your Lock End Date before delegating. You can also cancel your delegation at any time 💪.
Once delegated, rewards will be sent to the wallet address you delegated to. Then, the delegation receiver is in charge of your active rewards and is responsible for returning those back to you should you choose to do so.
{% endhint %}
### Steps to Delegate
Follow these steps to delegate your veOCEAN:
1. Go to the [Data Farming dApp](https://df.oceandao.org).
2. Navigate to the [Delegate page](https://df.oceandao.org/delegate).
3. In the 'Receiver wallet address' field, enter the wallet address you wish to delegate to
4. Click the 'Delegate' button, and sign the transaction with your wallet.
5. (Optional) Cancel the delegation to regain your allocation power before the delegation expires.
### What if someone delegates to you?
If you receive veOCEAN allocation power from other wallets, then you will receive their active rewards.
You _cannot_ re-delegate this veOCEAN further downstream.&#x20;
<figure><img src="../.gitbook/assets/data-farming/veOCEAN-Delegation.png" alt=""><figcaption></figcaption></figure>

233
data-farming/faq.md
View File

@ -12,9 +12,6 @@ description: Frequently Asked Questions about Data Farming
Its precise meaning depends on the DF stream.
- Passive DF: stake OCEAN = lock OCEAN into veOCEAN
- Volume DF: stake OCEAN on asset = allocate veOCEAN towards an asset
- Challenge DF: (there is no staking)
- Predictoor DF: put OCEAN into a prediction transaction
</details>
@ -25,9 +22,6 @@ Its precise meaning depends on the DF stream.
As with any system, inherent risks exist. We try to minimize them, as follows.
- Passive DF: uses veCRV contracts which have been battle-tested in high volume since 2020.
- Volume DF: doesn't change veOCEAN behavior. Rather, separate contracts "see" the veOCEAN staked to compute amount of rewards.
- Challenge DF: no funds at risk
- Predictoor DF: you stake a small amount of OCEAN in each epoch (eg every 5min). If issues arise, you can get out quickly.
</details>
@ -46,31 +40,12 @@ No. IL is typically associated with providing liquidity to decentralized exchang
<summary>What APYs can I expect?</summary>
Historically, annual percentage yields (APYs) are 5-20%. See [APY docs](apys.md) for details.
For Predictoor DF, it varies a lot based on your prediction accuracy, and more.
</details>
<details>
<summary>When I claim my OCEAN, do I need to restake them manually, or are they auto-compounded?</summary>
They are not auto-compounded.
They can be claimed/redeposited whenever you want. If you don't claim, they just stack up. There is no loss.
The [APY docs](apys.md) provide formulae on compounding vs. not.
</details>
<details>
<summary>Are rewards paid out in veOCEAN or OCEAN?</summary>
All rewards in Data Farming are paid out in OCEAN and can be claimed at the every epoch.
</details>
<details>
<summary>Can the DF rewards change during a given week?</summary>
No. At the beginning of a new DF round, rules are laid out, either implicitly if no change from the previous round, or explicitly in a blog post if there are new rules.
@ -81,215 +56,17 @@ Caveat: it’s "no" at least in theory! Sometimes there may be tweaks if there i
<details>
<summary>I locked 10,000 OCEAN but only received 0.1 OCEAN as a reward. What gives? </summary>
If you've locked 10,000 OCEAN for a short period, it's possible to see a near-0% APY.
To boost your APY, consider locking your OCEAN for a more extended period. It's not only about the amount you lock but also **the duration of the lock that matters most**. Longer lock periods yield more significant results.
</details>
<details>
<Summary>I locked my OCEAN for veOCEAN but can't see the rewards. What am I missing?</Summary>
Please hang in there and stay patient, as it can take almost two weeks to receive your first reward. 😊
</details>
<details>
<summary>High gas fields hurt my yield! What is the best time to avoid high gas fees?</summary>
When gas is cheap. [Here](https://www.useweb3.xyz/gas) is data on gas prices.
Also, remember that you don't need to claim rewards and re-stake every week. You could do it less frequently to avoid gas fees. (Balance this with the benefits of compounding.)
</details>
<details>
<summary>Where do I learn more about the OCEAN reward schedule?</summary>
In its [docs page](reward-schedule.md).
</details>
### Passive DF (and veOCEAN)
<details>
<summary>How much OCEAN do I need to lock to earn yield?</summary>
There is no minimum amount. The rewards will depend on the amount you lock.
You will get passive rewards by default when you lock OCEAN. And you can get Volume DF rewards if you allocate veOCEAN to data assets.
</details>
<details>
<summary>If I lock my OCEAN for 6 months and the price of OCEAN goes up during that time, will my staked tokens increase in value as well?</summary>
Yes. When you stake OCEAN, you'll receive them back at the end of the lock-up period. If the value increases during this time, your OCEAN will appreciate in worth. The same principle applies in reverse if the value decreases
</details>
<details>
<summary>What's the amount of veOCEAN one can get for locking 1 OCEAN?</summary>
1 veOCEAN if you lock for 4 years.
</details>
<details>
<summary>If I withdraw before the unlock date, what happens to my veOCEAN and rewards?</summary>
You can't withdraw before the unlock date.
</details>
<details>
<summary>Is there a way to transform veOCEAN to OCEAN gradually over the lock period?</summary>
No, you can't convert your veOCEAN to OCEAN during the lock period. When the lock period concludes, you gain access to all your locked OCEAN.
</details>
<details>
<summary>Is it possible to only participate in Passive Rewards?</summary>
Yes.
And, you participate by default in Passive Rewards when you lock OCEAN.
But to maximize your rewards, you will also need to engage in the other streams.
</details>
<details>
<summary>Where do I learn more about veOCEAN & Passive DF?</summary>
In its [docs page](passivedf.md).
</details>
### Volume DF
<details>
<summary>What data assets are eligible for Volume DF?</summary>
The data asset may be of any type — data feed, API, file, etc. 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.
</details>
<details>
<summary>Do I only receive Volume DF rewards if the datasets I've staked on have DCV?</summary>
Yes, correct.
</details>
<details>
<summary>How do I analyze projects and decide where to allocate? Do I look at current and past APYs, or is there more to consider? </summary>
Curators can select datasets to stake on based on previous DCV, publisher reputation, and more.
You can see DCV stats in the DF webapp's [Volume DF page](https://df.oceandao.org/volume-df).
Finally, Predictoor data feeds are promising, since they have good baseline volume due to Predictoor DF.
</details>
<details>
<summary>The datatoken price may change throughout the week. What price is taken in the DCV calculation?</summary>
The price is taken at the same time as each consume. E.g. if a data asset has three consumes, where the price was 1 OCEAN when the first consume happened, and the price was 10 OCEAN when the other consumes happened, then the total DCV for the asset is 1 + 10 + 10 = 21.
</details>
<details>
<summary>How long does it take for the system to update round allocations for veOCEAN?</summary>
Allocations happen instantly.
However, your voting power is counted progressively throughout the week and requires you to keep your veOCEAn allocated on datasets for it to work.
</details>
<details>
<summary>Where do I learn more about Volume DF?</summary>
In its [docs page](volumedf.md).
</details>
### Challenge DF
<details>
<summary>Where do I learn more about Challenge DF?</summary>
In its [docs page](challengedf.md).
</details>
### Predictoor DF
<details>
<summary>Where do I learn more about Predictoor DF?</summary>
In its [docs page](predictoordf.md).
</details>
### Parameters & Stats
<details>
<summary>Where can I find the veOCEAN and DF contracts?</summary>
They are deployed on the Ethereum mainnet, alongside other Ocean contract deployments. [Here](https://github.com/oceanprotocol/contracts/blob/main/addresses/address.json) is the full list of contract deployments.
</details>
<details>
<summary>What % of OCEAN is currently locked?</summary>
[autobotocean.com](https://autobotocean.com/veOcean) has those stats, and more.
</details>
<details>
<summary>What is the official veOCEAN epoch start_time?</summary>
veFeeDistributor has a start\_time of 1663804800 (Thu Sep 22 2022 00:00:00).
</details>
## Notes
[1] The initial version of Data Farming - in DF Alpha phase (DF1-DF4) - _did_ involve providing liquidity to datatoken pools, and therefore did incur risk of Impermanent Loss (IL). For this reason and others, we moved away from pools, to veOCEAN for the DF/VE Alpha phase and beyond (>=DF5). Therefore there has been no IL risk since then. [Here are details](https://blog.oceanprotocol.com/veocean-is-launching-data-farming-is-resuming-abed779211e3).
----
Congrats! You've completed reading Data Farming docs.
_Next: Jump to [Docs main](../README.md) and click on your interest._
_Next: Jump to [DF main](README.md)._
_Back: [APYs Guide](apys-guide.md)_
_Or: Jump to [Docs main](../README.md) and click on your interest._
_Back: [Predictoor DF Guide](predictoordf-guide.md)_

65
data-farming/liquid-staking.md
View File

@ -1,65 +0,0 @@
---
description:
---
<figure><img src="../.gitbook/assets/gif/love-ice-melting.gif" width=25% alt=""><figcaption><p></p></figcaption></figure>
# Liquid Staking
This page is about liquid staking of veOCEAN using psdnOCEAN.
### Background & Motivation
Once you lock OCEAN, you get veOCEAN.
Unlike OCEAN, veOCEAN cannot be traded or transferred. This is by design, to reconcile near-term and long-term incentives. Commit to holding OCEAN longer, and you earn more in the near term.
But what if there _was_ a way to have lots of locked OCEAN, yet get tradeability? That's the idea of "liquid staking". In many ways, it's the best of both worlds.
### Liquid Staking in Ocean
**psdnOCEAN is a "liquid staking wrapper" for veOCEAN:**
- It holds veOCEAN
- And it allows transfers (using ERC20 interface)
psdnOCEAN is a product by [H2O](https://www.h2odata.xyz//), a team separate from - and collaborating with - the Ocean core team.
While you can't trade veOCEAN, **you can trade psdnOCEAN.**
### How to get OCEAN -> psdnOCEAN
You can lock OCEAN for psdnOCEAN via [the H2O "convert" dapp](https://liquid-staking.h2odata.xyz/convert/ocean).
### How to get psdnOCEAN -> OCEAN
psdnOCEAN can be traded in exchanges, for both psdnOCEAN -> OCEAN, and vice versa.
The main exchange option is the [OCEAN-psdnOCEAN Balancer pool](https://app.balancer.fi/#/ethereum/swap?outputCurrency=0x51Fa2efd62ee56a493f24AE963eAce7D0051929E).
- [Here are pool details.](https://app.balancer.fi/#/ethereum/pool/0xf8c4cd95c7496cb7c8d97202cf7e5b8da2204c2b00020000000000000000039e).
⚠️Be careful - if liquidity is low you will experience high slippage.
### Rewards to psdnOCEAN holders
Since psdnOCEAN holds veOCEAN, then Passive DF rewards go to that psdnOCEAN-held veOCEAN according to the usual Passive DF rules.
Over time, psdnOCEAN may also get rewards from other DF streams or protocols too.
### psdnOCEAN Resources
[Here's](https://blog.oceanprotocol.com/psdnocean-the-first-liquid-staking-wrapper-by-the-h2o-team-is-now-live-a3330e15fa5c) the original psdnOCEAN announcement.
psdnOCEAN contract & token info can be found at:
- [Etherscan](https://etherscan.io/token/0x51fa2efd62ee56a493f24ae963eace7d0051929e)
- [CoinGecko](https://www.coingecko.com/en/coins/poseidon-ocean)
- [GeckoTerminal](https://www.geckoterminal.com/eth/pools/0xf8c4cd95c7496cb7c8d97202cf7e5b8da2204c2b)
----
_Next: [Volume DF](volumedf.md)_
_Back: [Passive DF Guide](passivedf-guide.md)_

59
data-farming/passivedf-guide.md
View File

@ -1,59 +0,0 @@
---
description: >-
Get veOCEAN to use the Data Farming dApp and make yield!
---
# Guide to Passive DF
<figure><img src="../.gitbook/assets/gif/aquaman-gold.gif" alt="" width="250"><figcaption><p>Get your gold. Get your veOCEAN.</p></figcaption></figure>
In order to **get yield in DF**, you will need to lock your OCEAN first! When you lock your OCEAN, you get **veOCEAN** and **weekly passive OCEAN rewards** in return. veOCEAN is a token used in Ocean Protocol's Data Farming dApp to **generate even more yield,** called **Volume DF rewards**, for allocating your veOCEAN to your favorite assets and get a portion of their sales!
### Don't have OCEAN yet? Get those first!
#### Step 1 - Get OCEAN
- Acquire OCEAN via a decentralized exchange (DEX) such as Uniswap or a centralized exchange (CEX) such as Binance, Coinbase, etc.
#### Step 2 - Send to your self-custody wallet
- Send your OCEAN to a self-custody wallet of yours that supports ERC-20 tokens, like Metamask for example.
### Where the rubber meets the road 🚗💨
Not much of a reader? Watch and learn, friend
{% embed url="https://www.youtube.com/watch?v=zAQlPHkK3og" fullWidth="false" %}
Watch and learn, friend
{% endembed %}
#### Step 3 - Go to Ocean Protocol's Data Farming dApp
- Go to [https://df.oceandao.org/](https://df.oceandao.org/)
#### Step 4 - Connect Your Wallet + Lock your OCEAN for veOCEAN
- Click on the purple circles in the interactive demo to walk through the steps for locking your OCEAN for veOCEAN.
{% embed url="https://app.arcade.software/share/FUSkygksSRsJHwle1zFs" fullWidth="false" %}
{% endembed %}
In this step you will:
- Enter the amount of OCEAN that you are going to lock up
- Select a Lock End Date indicating how many weeks you’re going to lock up your OCEAN. (As the Lock End Date goes farther into the future, your Lock Multiplier increases).
- Click on the checkbox to agree to the disclaimer.
- Click the pink “Approve # OCEAN” button
- Accept the transaction in your wallet.
- Click the “Create Lock” button.
- Accept the transaction in your wallet.
Congratulations! You have now locked your OCEAN for veOCEAN and are generating passive yield automatically. You can [claim your passive OCEAN rewards](claim-rewards.md) every Thursday - note that your first time claiming rewards will require at least one week, but not more than 2 weeks of wait!
----
_Next: [Liquid Staking](liquid-staking.md)_
_Back: [Passive DF (and veOCEAN)](passivedf.md)_

109
data-farming/passivedf.md
View File

@ -1,109 +0,0 @@
---
description: >-
Earn passively by locking veOCEAN for OCEAN
---
# Passive Data Farming (and veOCEAN)
<figure><img src="../.gitbook/assets/gif/aquaman-fade.gif" alt=""><figcaption><p>I've got veOCEAN, my work is done.</p></figcaption></figure>
**This page** is about Passive DF, and veOCEAN. There's also a [user guide page](passivedf-guide.md), and a [page for liquid staking](liquid-staking.md).
# About veOCEAN and Passive DF
Here, Data Farmers earn OCEAN rewards by locking their OCEAN for veOCEAN for a period of time. That's it! It's low effort, ie passive.
veOCEAN is non-transferable. You can’t sell it or send it to other addresses.
**Yield** is gross income minus costs, divided by OCEAN locked up.
- **Gross income** comes from passive DF rewards. This in turn depends on how much veOCEAN you hold compared to others. veOCEAN depends on:
- how much OCEAN you've locked. More OCEAN -> more rewards.
- how long you've locked it for. Longer lock -> more rewards. 4 years for max rewards.
- how recently you've refreshed your locked OCEAN. More recent -> more rewards.
- **Costs** are gas fees for transactions (txs) on Ethereum mainnet (where veOCEAN runs).
- In Passive DF, txs include: locking OCEAN, claiming rewards, and withdrawing rewards.
- Costs should not be under-estimated. If you lock a small amount of OCEAN for a short time, costs may exceed your gross income.
- To compound returns, these txs need to be repeated. The ideal frequency to compound rate is whatever maximizes your yield - which depends on how much OCEAN you've locked, tx fees, etc.
**APY** is "Annual Percent Yield". Where the [DF app](https://df.oceandao.org) shows APYs, these values are calculated assuming an initial 4-year lock up period with a weekly schedule of compounding rewards into an updated 4-year lock. This estimate works provided current: number of users, reward emissions, and other reward parameters stay constant while excluding all tx fees. See the [APYs](apys.md) page to understand APYs better.
The rest of this page has details.
### veOCEAN Time Locking
The longer you lock OCEAN for, the more veOCEAN you get. You can lock OCEAN for as short as two weeks, and as long as four years. (On the DF dapp [veOCEAN page](https://df.oceandao.org/veocean), "Lock Multiplier" represents the percentage amount of veOCEAN received per OCEAN locked.)
| Years | Lock Multiplier | veOCEAN |
| ---- | --------------- | ------- |
| 1 | 0.25x | 0.25 |
| 2 | 0.50x | 0.50 |
| 3 | 0.75x | 0.75 |
| 4 | 1.00x | 1.00 |
veOCEAN cannot be transferred or sold.
At the end of your 4 years, your OCEAN is unlocked. **You will not be able to retrieve your locked OCEAN until the Lock End Date you selected on the dApp!**
After the Lock End Date, then you can withdraw your principal OCEAN on the [veOCEAN page](https://df.oceandao.org/veocean) on the left side panel.
### Linear Decay
Your veOCEAN balance will slowly start declining as soon as you receive it.
veOCEAN balance decreases linearly over time until the Lock End Date. For example, when your lock time has lapsed by 50%, you will have 50% of your original veOCEAN balance.
When your lock time ends your veOCEAN balance will hit 0, and your OCEAN can be withdrawn.
If you lock 1.0 OCEAN for 4 years, you get 1.0 veOCEAN at the start.
| Years Passed | veOCEAN Left |
| ------------ | ------------ |
| 1 year | 0.75 |
| 2 years | 0.50 |
| 3 years | 0.25 |
| 4 years | 0.00 |
You can’t lose your OCEAN through Impermanent Loss (IL). It is merely locked.
### Replenishing veOCEAN
To achieve optimal APY, you would want to periodically update your 4-year lock back to 4 years, where there is no veOCEAN decay.
You can also add more OCEAN to your vault when updating an existing vault.
### Passive DF Reward Distrubtion
Passive DF rewards are claimable on the Ethereum mainnet.
DF rounds are weekly. In line with this, there’s a [`ve`](https://github.com/oceanprotocol/df-py/tree/main/contracts/ve) distribution “epoch” every week. This affects when you can first claim rewards. Specifically, if you lock OCEAN on day x, you’ll be able to claim rewards on the first ve epoch that begins after day x+7.
Put another way, from the time you lock OCEAN, you must wait at least a week, and up to two weeks, to be able to claim rewards. (This behavior is inherited from veCRV. Here’s the [code](https://github.com/oceanprotocol/df-py/tree/main/contracts/ve)).
### Flow of Value
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.
<figure><img src="../.gitbook/assets/data-farming/flow_of_value.png" alt=""><figcaption><p>Flow of Value</p></figcaption></figure>
### Background of veOCEAN Idea
It's been a long-held goal to reconcile near-term and long-term incentives. This is not an easy task.
Curve Finance's [veCRV](https://curve.readthedocs.io/dao-fees.html) was one of the first to do a great job at this, and have high usage and liquidity. So, [veOCEAN contracts](https://github.com/oceanprotocol/contracts/tree/main/contracts/ve) use veCRV code.
### veOCEAN Contract Security
veOCEAN core contracts have zero changes to veCRV code, on purpose: the veCRV contracts have been battle-tested since inception (2020). Nearly 500 million USD is locked across all forks of veCRV, with the leading DeFi protocols adopting this standard. veCRV contracts [have been audited by Trail of Bits and Quantstamp](https://github.com/curvefi/curve-dao-contracts#audits-and-security).
We have built [a new contract](https://github.com/oceanprotocol/contracts/blob/main/contracts/ve/veAllocate.sol) for users to allocate their veOCEAN towards data assets. These new contracts do not control the veOCEAN core contracts at all. In the event of a breach, the only funds at risk would be the rewards distributed for a single week; and we would be able to redirect future funds to a different contract.
We have an [ongoing bug bounty via Immunefi](https://immunefi.com/bounty/oceanprotocol/) for Ocean software, including veOCEAN and DF components. If you identify an issue, please report it there and get rewarded.
----
_Next: [Guide to Passive DF](passivedf-guide.md)_
_Back: [DF Main](README.md)_

2
data-farming/predictoordf-guide.md
View File

@ -29,6 +29,6 @@ In Predictoor DF (and Predictoor proper), you run prediction bots to earn contin
----
_Next: [Claim Rewards](claim-rewards.md)_
_Next: Jump to [DF FAQ](faq.md)._
_Back: [Predictoor DF](predictoordf.md)_

47
data-farming/predictoordf.md
View File

@ -9,12 +9,10 @@ description: >-
# Predictoor DF Overview
**Predictoor DF** is a substream of Active DF that amplifies predictoors’ earnings, via extra sales to Ocean Predictoor data feeds.
**Predictoor DF** is a DF stream that amplifies predictoors’ earnings, via extra sales to Ocean Predictoor data feeds.
Predictoor DF has 37,500 OCEAN weekly rewards (ongoing) and 20,000 ROSE weekly rewards (throughout 2024).
The higher baseline sales makes Volume DF and Passive DF more attractive.
## Introduction
**[Ocean Predictoor](../predictoor/README.md)** data feeds predict whether BTC, ETH etc will rise or fall 5min or 1h into the future. These feeds are crowdsourced by “predictoors”: people running AI-powered prediction bots.
@ -23,8 +21,6 @@ The higher baseline sales makes Volume DF and Passive DF more attractive.
You should be familiar with both Predictoor and DF before reading on.
**Predictoor Data Farming is a substream of Active DF. It amplifies existing predictoors’ earnings based on their accuracy and stake.**
## Predictoor DF Timing
Predictoor DF started counting on Nov 9, 2023, at the beginning of Data Farming Round 63 (DF63). It runs indefinitely.
@ -52,47 +48,8 @@ Predictoor DF has two components: [OCEAN](https://oceanprotocol.com/about-us/oce
The [Predictoor DF user guide](predictoordf-guide.md) tells how to get started as a predictoor, and how to claim rewards.
## How to Earn More $ Via Passive DF & Volume DF
Predictoor DF makes [Active DF](../data-farming/volumedf.md) more attractive, and in turn [Passive DF](../data-farming/passivedf.md). You should be familiar with both before reading on.
**Predictoor DF makes Volume DF more attractive than status quo**, because the volume-based bounds on weekly rewards trends tend to be markedly higher for prediction feeds. (The Appendix has details.)
**Curating is straightforward.** Ocean assets with high DCV are easy to identify: it's the 20 OPF-published prediction feeds. This makes the choice of veOCEAN allocation easy: point to those 20 assets.
**Doing Volume DF gives Passive DF rewards too**, of course.
The net result: Predictoor DF means earnings potential from Predictoor DF, Volume DF, and Passive DF.
## Appendix: On DCV Bounds of Prediction Feeds
**Predictoor DF makes Volume DF more attractive than status quo.** Active DF's rewards are bounded by `DCV_bound` which in turn is bound by sales volume and fees. In Predictoor DF, both those factors are raised; this raises the bounds in Volume DF; this in turn means higher earning potential. Let's elaborate.
At one time, Volume DF had a "wash consume" problem, where people published and consumed their own datasets. [DF9](https://blog.oceanprotocol.com/data-farming-df8-completed-df9-started-reward-function-tuned-d74b5134b5d1) onwards address this, by putting a bounds on weekly rewards:
> `DCV_bound = DCV * m`
Where `m` = `DCV_bounding_multiplier` = `Ocean community fee (0.1%) + publish market fee`
This stopped wash consume 💪 because it became unprofitable to _do_ wash consume: fees eat up all potential profits.
A low `DCV` (data consume volume) or a low `m` (publish market fee) mean low `DCV_bound`.
Predictoor DF makes both `DCV` and `m` higher!
- **`DCV` is higher:** the 37.5K OCEAN/week counts as consume volume
- **`m` is higher:** publish market fee is 20% for prediction feeds
Therefore `DCV_bound` is higher. Specifically: `DCV_bound = 37500 * (0.001 + 0.20) = 7537.5 OCEAN`. In other words, at least 7537.5 OCEAN is available for Volume DF in any given week.
## Notes
The BTC/USDT 5m and 1h feeds follow the same Volume DF mechanics as the other feeds, despite being free on the webapp.
Details: the BTC feeds _are_ priced at the smart contract level. The webapp receives datatokens for those feeds and makes the prediction values public. Because the BTC feeds _are_ priced, then: their DCV is non-negligible; allocating veOCEAN to them makes sense; and Volume DF rewards accrue to them as well.
----
_Next: [Predictoor DF Guide](predictoordf-guide.md)_
_Back: [Volume DF Guide](volumedf-guide.md)_
_Back: [DF Main](README.md)_

81
data-farming/reward-schedule.md
View File

@ -1,81 +0,0 @@
---
description: >-
Know the OCEAN reward schedule, towards understanding yields
---
# OCEAN Reward Schedule
<figure><img src="../.gitbook/assets/gif/cash-flow.gif" alt=""><figcaption></figcaption></figure>
## Overview
DF proceeds one round at a time. Each round is weekly.
Rewards are distributed at the end of every week, for the activity of the previous week.
The reward schedule = the emission schedule, definining the weekly OCEAN budget for DF. DF currently rewards 300K OCEAN per round. Over time, rewards will increase to be as high as 1.1M OCEAN / week, then decay over time Bitcoin-style.
DF rounds are grouped into four phases: DF Alpha, DF/VE Alpha, DF Beta, and DF Main. We are now in the "DF Main" phase.
The table below shows OCEAN rewards per round, and corresponding phase.
<figure><img src="../.gitbook/assets/data-farming/reward_schedule.png" alt=""><figcaption><p><em>Ocean Reward Schedule for the next 20+ years</em></p></figcaption></figure>
### DF Phases
Each of the first three phases -- DF Alpha, DF/VE Alpha, and DF Beta phases -- had a fixed value. Each of these ran for 4-20 weeks. The final phase -- DF Main -- runs for decades with a Bitcoin-like emissions-schedule (plus a burn-in-period).
### Phase: DF Alpha - Rounds 1-4 (4 wks)
- 10K OCEAN rewards per week.
- Counting started Thu June 16, 2022 and ended July 13, 2022. It ran for 4 weeks. DF was temporarily paused after this, for time to put veOCEAN into place.
- The aim was to test technology, learn, and onboard data publishers.
### Phase: DF/VE Alpha - Rounds 5-8 (4 wks)
- 10K OCEAN rewards were per week.
- Counting started Thu Sep 29, 2022 and ended Oct 27, 2022. It ran for 4 weeks.
- The aim was to resume Data Farming with veOCEAN, test the technology, onboard data publishers, and keep learning.
### Phase: DF Beta - Rounds 9-28 (20 wks)
- Up to 100K OCEAN rewards per week.
- Counting started on Oct 27, 2022, ie the day DF/VE Alpha ended. Counting ended on March 15, 2023. It ran for 20 weeks.
- The aim was to test the effect of larger incentives, and support ecosystem participation, while continually refining the underlying technology.
### Phase: DF Main - Rounds 29-1000+
- Rewards began at 150K OCEAN per week, and go up to 1.1M OCEAN per week. Total emissions are 503.M OCEAN.
- Counting started on March 15, 2023, ie the day DF Beta ended. It runs for decades.
- DF Main's schedule mimics Bitcoin including a half-life of 4 years. Unlike Bitcoin, there is a _burn-in period_ to ratchet up value-at-risk versus time. Burn-in is implemented via four sub-phases: DF Main 1, 2, 3 and 4 with multipliers of 10%, 25%, 50%, and 100% respectively.
- DF Main 1 emits 150K OCEAN per week. It runs 12 months.
- DF Main 2 starts on Mar 14, 2024 (DF80). Rewards go 2x, to 300K OCEAN / week. It runs 6 months.
- DF Main 3 starts on Sep 12, 2024 (DF106). Rewards go 2x, to 600K OCEAN / week. It runs 6 months.
- DF Main 4 starts on Mar 13, 2025 (DF132). Rewards begin at 1.1M OCEAN / week then halve every four years. It runs for decades.
## Visualize Emissions: First 5 years
Let’s visualize emissions!
The image below shows the first 5 years (including all DF Phases). The y-axis is OCEAN released each week. It’s log-scaled to easily see the differences. The x-axis is time, measured in weeks. In weeks 0–29, we can see the distinct phases for DF Alpha (DF1 // week 0), DF/VE Alpha (DF5 // week 4), DF Beta (DF9 // week 8), DF Main 1 (DF29 // week 28), DF Main 2 (DF80 // week 79), DF Main 3 (DF106 // week 105), and DF Main 4 (DF132 // week 131).
<figure><img src="../.gitbook/assets/data-farming/emissions_first_5years.png" alt="" width="540"><figcaption><p><em>OCEAN released to DF per week — first 5 years</em></p></figcaption></figure>
## Visualize Emissions: First 20 years
The image below is like the previous one: OCEAN released per week. But now, we show for the first 20 years. Week 131 onwards is DF Main 4. We can see that the y-value divides by two (“halvens”) every four years.
<figure><img src="../.gitbook/assets/data-farming/emissions_first_20years.png" alt="" width="563"><figcaption><p><em>OCEAN released to DF per week — first 20 years</em></p></figcaption></figure>
## Visualize Total OCEAN released
The image below shows the total OCEAN released by DF for the first 20 years. The y-axis is log-scaled to capture both the small initial rewards and exponentially larger values later on. The x-axis is also log-scaled so that we can more readily see how the curve converges over time.
<figure><img src="../.gitbook/assets/data-farming/emissions_lifetime.png" alt="" width="563"><figcaption><p><em>Total OCEAN released to DF — first 20 years</em></p></figcaption></figure>
## Further resources
The blog post ["Data Farming Main is here"](https://blog.oceanprotocol.com/ocean-data-farming-main-is-here-49c99602419e) provides further detail yet.
----
_Next: [APYs](apys.md)_
_Back: [Claim Rewards](claim-rewards.md)_

48
data-farming/volumedf-guide.md
View File

@ -1,48 +0,0 @@
---
description: >-
Curate datasets in Data Farming and earn
---
# Guide to Volume DF
<figure><img src="../.gitbook/assets/gif/avatar-pick-whale.gif" alt=""><figcaption>Pick your whale</figcaption></figure>
In Volume DF, you allocate veOCEAN to data assets with high data consume volume (DCV). You do this via the DF dApp.
We'll show you how!
#### Step 1 - Navigate to the DF dApp
- Go to [https://df.oceandao.org](https://df.oceandao.org)
#### Step 2 - Connect your wallet
- Connect your wallet to the dApp, on Ethereum mainnet
#### Step 3 - Click the Volume DF tab in the top menu
<figure><img src="../.gitbook/assets/data-farming/volumeDF-page.png" alt=""><figcaption><p>Click the Volume DF page link in the menu</p></figcaption></figure>
#### Step 4 - Select the assets which you would like to allocate to by toggling the percentage allocation at the end of the row
- On the rightmost column, toggle the percentage of your total Allocation Power that you wish to allocate to each asset of your choice. You will **get a portion of the sales** of each asset that you allocate to!
- Note that if you allocate to an asset that YOU published, then you will get an **effective 2x allocation boost**.
- If you are a publisher and curating your own asset, your asset may be styled differently in the UI.
<figure><img src="../.gitbook/assets/data-farming/allocations.png" alt=""><figcaption><p>Toggle the percentage of your veOCEAN that you would like to allocate to each asset</p></figcaption></figure>
#### Step 5 - Click the Update Allocations button
- Click the pink Update Allocations button
- Sign the transactions with your wallet & pay the gas fees
<figure><img src="../.gitbook/assets/data-farming/update-allocations.png" alt=""><figcaption><p>Click the Update Allocations button</p></figcaption></figure>
That's it! You've successfully allocated (aka "voted on") your favorite assets in the Ocean ecosystem using your veOCEAN and are generating active rewards yield. Now, just wait until next Thursday to see if you can [claim any OCEAN rewards](claim-rewards.md) on the Active Rewards section of the [Rewards page](https://df.oceandao.org/rewards) for your portion of the assets' sales. Remember that your first time claiming rewards will require at least one week, but not more than 2 weeks of wait!
----
_Next: [Predictoor DF](predictoordf.md)_
_Back: [Volume DF](volumedf.md)_

82
data-farming/volumedf.md
View File

@ -1,82 +0,0 @@
---
description: >-
Choose your fav data assets, earn more
---
# Volume Data Farming
<figure><img src="../.gitbook/assets/gif/avatar-plugin.gif" alt=""><figcaption><p>Make your selection and commit. Good things will come.</p></figcaption></figure>
**This page** is about Volume DF. There's also a [user guide page](volumedf-guide.md) and a [page for delegation](delegate.md).
# About Volume DF
We've already covered [Passive DF](passivedf.md), which is a great start to earn from your locked OCEAN (veOCEAN).
_Volume_ DF lets you can earn more yet, with that same veOCEAN.
In Volume DF, you allocate veOCEAN to data assets with high data consume volume (DCV). This acts as _data curation_.
### How to Maximize Volume DF rewards
Here are tactics:
- Only allocate to assets that actually qualify for DF. The "Assets that qualify" section below has details.
- Allocate to assets with high DCV. Predictoor data feeds are a good bet.
- Lock more OCEAN.
- Lock OCEAN for longer. For example, a 4-year lock is 4x more reward than 1-year.
- Refresh your OCEAN locks often. This is needed since veOCEAN degrades with time.
- Frequently claim your OCEAN rewards then lock it. Be careful: too often may make gas fees > OCEAN rewards.
- Publish your own assets; you get 2x rewards for such assets. [Here are details](https://blog.oceanprotocol.com/data-farming-publisher-rewards-f2639525e508).
<br>
<figure><img src="../.gitbook/assets/gif/hustlin.gif" alt=""><figcaption></figcaption></figure>
### Delegate veOCEAN
You can delegate your veOCEAN from one wallet to another. This is handy if you have a hardware wallet holding veOCEAN, and you want a "hot" software wallet to automatically re-allocate more often. There are other uses too.
[Here's how to delegate](delegate.md).
### Assets that Qualify for Volume DF
Data assets that have veOCEAN allocated towards them get Volume DF rewards.
The asset may be of any type — dataset, data feed, a C2D algorithm, or other. It may be fixed price or free. If fixed price, any token of exchange is alright (OCEAN, H2O, USDC, etc). If free, then gas used for consume is the "volume".
To qualify for DF, an asset must also:
* Have been created by Ocean smart contracts [deployed](https://github.com/oceanprotocol/contracts/blob/main/addresses/address.json) by OPF to [production networks](../discover/networks/README.md)
* The asset must be listed on Ocean Market
* Can’t be in [purgatory](https://github.com/oceanprotocol/list-purgatory/blob/main/policies/README.md)
### How Rewards are Calculated
The Reward Function (RF) governs how Volume DF rewards are allocated.
_Rewards are calculated as follows:_
1. Distribute OCEAN across each asset **based on rank**: highest-DCV asset gets the most OCEAN, second-highest-DCV gets second-most, etc. [Here are details](https://blog.oceanprotocol.com/data-farming-df22-completed-df23-started-reward-function-tuned-ffd4359657ee).
1. For each asset and each veOCEAN holder:
1. If the holder is a publisher, 2x the effective allocation
1. Baseline rewards = (% allocation in asset) \* (OCEAN for an asset)
1. Bound rewards to the asset by 125% APY
1. Bound rewards by asset’s `DCV` \* (% allocation in asset) \* `DCV_multiplier`.
Step 2.4 is to prevent wash consume. `DCV_multiplier` is a function of fees, with a value of 1.005 for Predictoor feeds, and 0.001 for other data assets.
Any OCEAN budgeted for Volume DF that wasn’t rewarded goes back into the DF pot for future DF rounds.
The actual code is in [calcrewards.py](https://github.com/oceanprotocol/df-py/blob/main/df_py/volume/calc_rewards.py) in df-py repo.
When DF restarts each Thursday, the global allocation towards each asset resets back to zero and then starts counting up again until the end of the round. After allocating your veOCEAN to different datasets, it will take time for your voting power to be accounted for.
----
_Next: [Volume DF Guide](volumedf-guide.md)_
_Back: [Liquid Staking](liquid-staking.md)_