Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

changing contributions to rewards #505

Open
wants to merge 25 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 11 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
92 changes: 0 additions & 92 deletions docs/gov/community/contributions.md

This file was deleted.

84 changes: 84 additions & 0 deletions docs/gov/governance/contributions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
---
sidebar_position: 6
description: Earning OBOL Programmatic Incentives
---

# OBOL Programmatic Incentives Program

*Our aim is to encourage continuous participation and sustained support for Ethereum’s infrastructure network. The Obol Programmatic Incentives Program program is designed to be fair and transparent, acknowledging stakers for their participation in staking on DVs.*

*By basing OBOL incentives on staking rewards accumulated by validators (pubkeys), performance is factored in (i.e. effectiveness, uptime, etc.)*

*Incentives are tracked in a centralised database off-chain - our [API endpoints](https://docs.obol.tech/api#tag/Address/operation/AddressController_getAddressContributions) enable users and protocols to query how much incentives they have generated. These endpoints are used to show individuals’ incentives within the [Obol DV Launchpad](https://launchpad.obol.org) and partners’ staking platforms.*

slugmann321 marked this conversation as resolved.
Show resolved Hide resolved
## What is the OBOL Programmatic Incentives Program?

OBOL Programmatic Incentives offer an opportunity for every staker to earn access to governance and ownership in the Obol Collective, by staking ETH on distributed validators. 2.5% of the supply of OBOL Tokens will be rewarded to stakers in the first year.
slugmann321 marked this conversation as resolved.
Show resolved Hide resolved

Each week, 1/52 of 2.5% of the 500m OBOL Token supply will be distributed. Incentives *need to be claimed* either via the DV Launchpad, or via the UI frontend of participating partners.

## How do I participate in the OBOL Programmatic Incentives Program?

You can participate in the OBOL Programmatic Incentives Program by:

1. **Running your own DV Cluster**: Running your own DV Cluster: You can create and manage your own DV cluster using our [DV Launchpad](https://launchpad.obol.org), for example using a [DappNode](https://dappnode.com/) or other hardware. This allows you to directly participate in the network's decentralisation efforts and earn OBOL incentives. Visit our [Squad Staking](https://squadstaking.com) page for inspiration and to find squad members.
slugmann321 marked this conversation as resolved.
Show resolved Hide resolved

2. **Staking through Staking Partners**: Staking through Staking Partners: For the current list of staking partners, please visit [obol.org/stake](https://obol.org/stake).
slugmann321 marked this conversation as resolved.
Show resolved Hide resolved

## Is stake from the previous Contributions program eligible?

No, existing stake within protocols as of the snapshot date of January 13th is not eligible. Only new stake that was deposited after January 13th is eligible. The exception is stake deposited directly on DVs, outside of staking protocols. (via our DV Launchpad, for example). Such stake is eligible regardless of when it was deposited.
slugmann321 marked this conversation as resolved.
Show resolved Hide resolved

## How can I track my OBOL incentives?

If you’re running your own DV, your incentives will be displayed on the [DV Launchpad](https://launchpad.obol.org). If you’re staking through a partner product, they should display your incentives and distribute them to you.
slugmann321 marked this conversation as resolved.
Show resolved Hide resolved

## What benefits do I get from the OBOL Token?

OBOL Tokens serve as the basis for ownership and governance of the Obol Collective. Learn more on the [token page](./obol-token.md) of the docs.

## How are incentives calculated?

OBOL incentives are based on validator staking rewards. They are calculated daily and tracked off-chain. The higher the effectiveness and uptime of your validators, the more incentives you will generate.
slugmann321 marked this conversation as resolved.
Show resolved Hide resolved

If the total staking rewards \( R \) for a validator are split among operators with percentages \( p_1, p_2, ..., p_n \), the rewards \( O \) for each operator can be calculated as:

Cᵢ = R × pᵢ × 0.01 × 1.01
slugmann321 marked this conversation as resolved.
Show resolved Hide resolved

where pᵢ is the split percentage for the i-th operator. We multiply by 1.01 to ensure that the full 1% contribution is accurately distributed among operators, compensating for the initial deduction of 1% from the total rewards.

## Do I need to run my own validator to participate?

No, you can stake on DVs and track your incentives through the partners listed on [obol.org/stake](https://obol.org/stake). More partners are coming soon.

## Can I withdraw my staked ETH at any time?

There is no penalty for exiting your validator. You simply stop accruing incentives. The specific withdrawal policy will depend on the staking protocol used.

## What is the minimum amount of ETH needed to stake?

The minimum amount varies by staking protocol, please refer to each partner to determine the minimum amount of stake required.

## What happens if my validator has downtime?

Since OBOL incentives are tied to staking rewards, the amount of incentives earned is impacted by validator performance metrics like effectiveness and uptime.

## Will my contributions be public?

Yes, incentives are public and can be viewed through the [Obol API](https://docs.obol.org/api#tag/Address/operation/AddressController_getAddressContributions), if you have the address of the protocol.
slugmann321 marked this conversation as resolved.
Show resolved Hide resolved

## How do I know my contributions are being counted accurately?

OBOL incentives are tracked based on validator staking rewards, and you can verify them through [our API](https://docs.obol.org/api#tag/Address/operation/AddressController_getAddressContributions).

## How can I increase my OBOL Programmatic Incentives?

Incentives increase with more stake, as well as higher performance and uptime of your validators.

## What are the benefits of using distributed validators?

Distributed validators increase the security, resiliency, and decentralisation of Ethereum. Learn more at [obol.org/learn](https://obol.org/learn).

## How can I get support if I have issues?

Support is available through Obol’s [Discord](https://discord.gg/obol) and partners’ support channels.
9 changes: 6 additions & 3 deletions docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -234,10 +234,13 @@ const config = {
from: '/docs/sdk',
},
{
to: '/next/gov/community/contributions',
from: '/gov/governance/contributions',
to: '/gov/governance/contributions',
from: '/gov/community/contributions',
},
{
to: '/gov/governance/contributions',
from: '/gov/governance/rewards',
},

//Redirect from multiple old paths to the new path
// {
// to: '/docs/newDoc2',
Expand Down
Loading
Loading