From c407bd3c67830cfd245761f346f6c315b9342ca3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Fri, 10 Jan 2025 11:05:10 +0100 Subject: [PATCH 01/24] changing contributions to rewards --- docs/gov/community/contributions.md | 92 ------------------- docs/gov/governance/contributions.md | 82 +++++++++++++++++ docusaurus.config.js | 9 +- .../gov/governance/contributions.md | 62 ++++++------- 4 files changed, 116 insertions(+), 129 deletions(-) delete mode 100644 docs/gov/community/contributions.md create mode 100644 docs/gov/governance/contributions.md diff --git a/docs/gov/community/contributions.md b/docs/gov/community/contributions.md deleted file mode 100644 index de06315b2b..0000000000 --- a/docs/gov/community/contributions.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -sidebar_position: 6 -description: Earning Obol Contributions ---- - -# Obol Contributions Program - -*Our aim is to encourage continuous participation and sustained support for Ethereum’s consensus. The Obol Contributions program is therefore designed to be fair and transparent, without arbitrary gimmicks promoting short-term interest at the cost of long-term participation. Obol Contributions are meant to acknowledge all of the actors in the staking stack for their contribution to Ethereum’s decentralisation.* - -*Each Obol DV contributes 1% of the total staking reward it earns to the Obol Collective. This economic stream is the basis for recognized Contributions. By basing Contributions on staking rewards accumulated by validators (pubkeys), performance is factored in (i.e. effectiveness, uptime, etc.)* - -*Contributions are tracked in a centralised database off-chain, not on the blockchain as transferable or non-transferable tokens. Our [API endpoints](https://docs.obol.tech/api#tag/Address/operation/AddressController_getAddressContributions) enable users and protocols to query how much they have contributed. These endpoints are used to show individuals’ Contributions within the [Obol DV Launchpad](https://launchpad.obol.org) and partners’ staking platforms.* - -## What is the Obol Contributions Program? - -- An opportunity for every staker to participate in and get recognised for scaling and decentralising Ethereum by staking on Obol Distributed Validators (DVs). -- Stake deployed on Obol DVs will contribute 1% of staking rewards to the Obol Collective’s retroactive funding mechanism. -- Those contributions will be tracked and recognised, and serve as the basis for future governance and ownership in the Obol Collective. - -## How do I participate in the Obol Contributions Program? - -You can participate in the Obol Contributions Program by: - -1. **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/). This allows you to directly participate in the network's decentralisation efforts and earn contributions. You can also visit our [Squad Staking](https://squadstaking.com) page for inspiration and to find squad members. - -2. **Staking through Staking Partners**: By participating in staking through our partners, your staking rewards will also contribute to the Obol Collective. For the current list of staking partners, please visit [obol.org/contributions](https://obol.org/contributions). - -## How can I track my contributions? - -If you’re staking through a partner product, their dashboard will display your contributions. If you’re running your own DV, your contributions will be displayed on the [DV Launchpad](https://launchpad.obol.org/cluster/list/). - -## What benefits do I get from contributing? - -Contributions will serve as the basis for future ownership and governance of the Obol Collective’s retroactive funding mechanism. - -## How are contributions calculated? - -Contributions are based on 1% of validator rewards, which are contributed to the Obol Collective’s “1% for Decentralization” retroactive fund. (retroactivefunding.obol.eth) Contributions are calculated daily and tracked off-chain. This means that the higher the effectiveness and uptime of your validators, the more rewards (and thus contributions) you will generate. - -If the total rewards \( R \) for a validator are split among operators with percentages \( p_1, p_2, ..., p_n \), the contributions \( C \) for each operator can be calculated as: - -Cᵢ = R × pᵢ × 0.01 × 1.01 - -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. - -## I’m already running a mainnet Obol DV? What about me? - -If you are running an existing mainnet DV without the 1% split, you will not have tracked contributions and will need to deploy a new DV configuration to participate. - -## Wen Token? - -Obol Contributions are not a promise or indication of any future plans for an Obol Token. They are purely a recognition of your contribution to the security, resiliency, and decentralisation of Ethereum consensus through the adoption of Obol DVs. - -## What is the 1% for Decentralization retroactive funding program? - -Users of Obol distributed validator (DV) clusters contribute 1% of their staking rewards to a retroactive funding program. These funds will reward projects and innovations which add value and drive impact towards Ethereum’s decentralisation. Read more on our blog or on obol.org/governance. - -## Do I need to run my own validator to participate? - -No, you can stake on DVs and track your contributions through the partners listed on [obol.org/contributions](https://obol.org/contributions). 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 Contributions. 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 Contributions are tied to staking rewards, the amount of Contributions earned is impacted by on performance metrics like effectiveness and uptime. - -## Will my contributions be public? - -Yes, contributions can be viewed through the [Obol API](https://docs.obol.org/api#tag/Address/operation/AddressController_getAddressContributions), though specific visibility settings depend on the protocol. - -## How do I know my contributions are being counted accurately? - -Contributions are tracked based on validator rewards, and you can verify them through [our API](https://docs.obol.org/api#tag/Address/operation/AddressController_getAddressContributions). - -## How can I increase my contributions? - -Contributions increase with higher 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. - -## How can I get support if I have issues? - -Support is available through Obol’s [Discord](https://discord.gg/obol) and partners’ support channels. \ No newline at end of file diff --git a/docs/gov/governance/contributions.md b/docs/gov/governance/contributions.md new file mode 100644 index 0000000000..4417e7f1e5 --- /dev/null +++ b/docs/gov/governance/contributions.md @@ -0,0 +1,82 @@ +--- +sidebar_position: 6 +description: Earning Obol Contributions +--- + +# OBOL Rewards Program + +*Our aim is to encourage continuous participation and sustained support for Ethereum’s infrastructure network. The Obol Rewards program is designed to be fair and transparent, acknowledging stakers for their contribution.* + +*By basing OBOL Rewards on staking rewards accumulated by validators (pubkeys), performance is factored in (i.e. effectiveness, uptime, etc.)* + +*Rewards 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 rewards they have generated. These endpoints are used to show individuals’ rewards within the [Obol DV Launchpad](https://launchpad.obol.org) and partners’ staking platforms.* + +## What is the OBOL Rewards Program? + +OBOL rewards offer an opportunity for every staker to earn access to governance and ownership in the Obol Collective, by staking ETH on distributed validators. 3% of the supply of OBOL Tokens will be rewarded to stakers in the first year. + +## How do I participate in the OBOL Rewards Program? + +You can participate in the OBOL Rewards 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 Rewards. Visit our [Squad Staking](https://squadstaking.com) page for inspiration and to find squad members. + +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). + +## How can I track my rewards? + +If you’re running your own DV, your rewards will be displayed on the [DV Launchpad](https://launchpad.obol.org). If you’re staking through a partner product, they should display your rewards and distribute them to you. + +## 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 rewards calculated? + +OBOL Rewards 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 rewards you will generate. + +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 + +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. + +## I’m already running a mainnet Obol DV? What about me? + +If you are running an existing mainnet DV without the 1% split, you will not have tracked rewards and will need to deploy a new DV configuration to participate. + +## Do I need to run my own validator to participate? + +No, you can stake on DVs and track your rewards 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 rewards. 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 Rewards are tied to staking rewards, the amount of rewards earned is impacted by validator performance metrics like effectiveness and uptime. + +## Will my contributions be public? + +Yes, rewards 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. + +## How do I know my contributions are being counted accurately? + +OBOL Rewards 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 Rewards? + +Rewards 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](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. \ No newline at end of file diff --git a/docusaurus.config.js b/docusaurus.config.js index f347ac482f..42c6455583 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -237,7 +237,14 @@ const config = { 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', diff --git a/versioned_docs/version-v1.2.0/gov/governance/contributions.md b/versioned_docs/version-v1.2.0/gov/governance/contributions.md index de06315b2b..4417e7f1e5 100644 --- a/versioned_docs/version-v1.2.0/gov/governance/contributions.md +++ b/versioned_docs/version-v1.2.0/gov/governance/contributions.md @@ -3,41 +3,39 @@ sidebar_position: 6 description: Earning Obol Contributions --- -# Obol Contributions Program +# OBOL Rewards Program -*Our aim is to encourage continuous participation and sustained support for Ethereum’s consensus. The Obol Contributions program is therefore designed to be fair and transparent, without arbitrary gimmicks promoting short-term interest at the cost of long-term participation. Obol Contributions are meant to acknowledge all of the actors in the staking stack for their contribution to Ethereum’s decentralisation.* +*Our aim is to encourage continuous participation and sustained support for Ethereum’s infrastructure network. The Obol Rewards program is designed to be fair and transparent, acknowledging stakers for their contribution.* -*Each Obol DV contributes 1% of the total staking reward it earns to the Obol Collective. This economic stream is the basis for recognized Contributions. By basing Contributions on staking rewards accumulated by validators (pubkeys), performance is factored in (i.e. effectiveness, uptime, etc.)* +*By basing OBOL Rewards on staking rewards accumulated by validators (pubkeys), performance is factored in (i.e. effectiveness, uptime, etc.)* -*Contributions are tracked in a centralised database off-chain, not on the blockchain as transferable or non-transferable tokens. Our [API endpoints](https://docs.obol.tech/api#tag/Address/operation/AddressController_getAddressContributions) enable users and protocols to query how much they have contributed. These endpoints are used to show individuals’ Contributions within the [Obol DV Launchpad](https://launchpad.obol.org) and partners’ staking platforms.* +*Rewards 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 rewards they have generated. These endpoints are used to show individuals’ rewards within the [Obol DV Launchpad](https://launchpad.obol.org) and partners’ staking platforms.* -## What is the Obol Contributions Program? +## What is the OBOL Rewards Program? -- An opportunity for every staker to participate in and get recognised for scaling and decentralising Ethereum by staking on Obol Distributed Validators (DVs). -- Stake deployed on Obol DVs will contribute 1% of staking rewards to the Obol Collective’s retroactive funding mechanism. -- Those contributions will be tracked and recognised, and serve as the basis for future governance and ownership in the Obol Collective. +OBOL rewards offer an opportunity for every staker to earn access to governance and ownership in the Obol Collective, by staking ETH on distributed validators. 3% of the supply of OBOL Tokens will be rewarded to stakers in the first year. -## How do I participate in the Obol Contributions Program? +## How do I participate in the OBOL Rewards Program? -You can participate in the Obol Contributions Program by: +You can participate in the OBOL Rewards Program by: -1. **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/). This allows you to directly participate in the network's decentralisation efforts and earn contributions. You can also visit our [Squad Staking](https://squadstaking.com) page for inspiration and to find squad members. +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 Rewards. Visit our [Squad Staking](https://squadstaking.com) page for inspiration and to find squad members. -2. **Staking through Staking Partners**: By participating in staking through our partners, your staking rewards will also contribute to the Obol Collective. For the current list of staking partners, please visit [obol.org/contributions](https://obol.org/contributions). +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). -## How can I track my contributions? +## How can I track my rewards? -If you’re staking through a partner product, their dashboard will display your contributions. If you’re running your own DV, your contributions will be displayed on the [DV Launchpad](https://launchpad.obol.org/cluster/list/). +If you’re running your own DV, your rewards will be displayed on the [DV Launchpad](https://launchpad.obol.org). If you’re staking through a partner product, they should display your rewards and distribute them to you. -## What benefits do I get from contributing? +## What benefits do I get from the OBOL Token? -Contributions will serve as the basis for future ownership and governance of the Obol Collective’s retroactive funding mechanism. +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 contributions calculated? +## How are rewards calculated? -Contributions are based on 1% of validator rewards, which are contributed to the Obol Collective’s “1% for Decentralization” retroactive fund. (retroactivefunding.obol.eth) Contributions are calculated daily and tracked off-chain. This means that the higher the effectiveness and uptime of your validators, the more rewards (and thus contributions) you will generate. +OBOL Rewards 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 rewards you will generate. -If the total rewards \( R \) for a validator are split among operators with percentages \( p_1, p_2, ..., p_n \), the contributions \( C \) for each operator can be calculated as: +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 @@ -45,23 +43,15 @@ where pᵢ is the split percentage for the i-th operator. We multiply by 1.01 to ## I’m already running a mainnet Obol DV? What about me? -If you are running an existing mainnet DV without the 1% split, you will not have tracked contributions and will need to deploy a new DV configuration to participate. - -## Wen Token? - -Obol Contributions are not a promise or indication of any future plans for an Obol Token. They are purely a recognition of your contribution to the security, resiliency, and decentralisation of Ethereum consensus through the adoption of Obol DVs. - -## What is the 1% for Decentralization retroactive funding program? - -Users of Obol distributed validator (DV) clusters contribute 1% of their staking rewards to a retroactive funding program. These funds will reward projects and innovations which add value and drive impact towards Ethereum’s decentralisation. Read more on our blog or on obol.org/governance. +If you are running an existing mainnet DV without the 1% split, you will not have tracked rewards and will need to deploy a new DV configuration to participate. ## Do I need to run my own validator to participate? -No, you can stake on DVs and track your contributions through the partners listed on [obol.org/contributions](https://obol.org/contributions). More partners are coming soon. +No, you can stake on DVs and track your rewards 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 Contributions. The specific withdrawal policy will depend on the staking protocol used. +There is no penalty for exiting your validator. You simply stop accruing rewards. The specific withdrawal policy will depend on the staking protocol used. ## What is the minimum amount of ETH needed to stake? @@ -69,23 +59,23 @@ The minimum amount varies by staking protocol, please refer to each partner to d ## What happens if my validator has downtime? -Since Contributions are tied to staking rewards, the amount of Contributions earned is impacted by on performance metrics like effectiveness and uptime. +Since OBOL Rewards are tied to staking rewards, the amount of rewards earned is impacted by validator performance metrics like effectiveness and uptime. ## Will my contributions be public? -Yes, contributions can be viewed through the [Obol API](https://docs.obol.org/api#tag/Address/operation/AddressController_getAddressContributions), though specific visibility settings depend on the protocol. +Yes, rewards 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. ## How do I know my contributions are being counted accurately? -Contributions are tracked based on validator rewards, and you can verify them through [our API](https://docs.obol.org/api#tag/Address/operation/AddressController_getAddressContributions). +OBOL Rewards 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 contributions? +## How can I increase my OBOL Rewards? -Contributions increase with higher stake, as well as higher performance and uptime of your validators. +Rewards 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. +Distributed validators increase the security, resiliency, and decentralisation of Ethereum. Learn more at [obol.org/learn](obol.org/learn). ## How can I get support if I have issues? From 60c1d1f6fbefcd2fb795b9f6efecf4e06220db16 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Fri, 10 Jan 2025 12:48:12 +0100 Subject: [PATCH 02/24] fixing redirect --- docusaurus.config.js | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docusaurus.config.js b/docusaurus.config.js index 42c6455583..6122971c65 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -233,10 +233,6 @@ const config = { to: '/sdk', from: '/docs/sdk', }, - { - to: '/next/gov/community/contributions', - from: '/gov/governance/contributions', - }, { to: '/gov/governance/contributions', from: '/gov/community/contributions', From 9a37a721631ffabc99552de61d6563e78ce16413 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Fri, 10 Jan 2025 12:57:46 +0100 Subject: [PATCH 03/24] fixing http urls --- docs/gov/governance/contributions.md | 2 +- versioned_docs/version-v1.2.0/gov/governance/contributions.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/gov/governance/contributions.md b/docs/gov/governance/contributions.md index 4417e7f1e5..6fd3073aa8 100644 --- a/docs/gov/governance/contributions.md +++ b/docs/gov/governance/contributions.md @@ -75,7 +75,7 @@ Rewards increase with more stake, as well as higher performance and uptime of yo ## What are the benefits of using distributed validators? -Distributed validators increase the security, resiliency, and decentralisation of Ethereum. Learn more at [obol.org/learn](obol.org/learn). +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? diff --git a/versioned_docs/version-v1.2.0/gov/governance/contributions.md b/versioned_docs/version-v1.2.0/gov/governance/contributions.md index 4417e7f1e5..6fd3073aa8 100644 --- a/versioned_docs/version-v1.2.0/gov/governance/contributions.md +++ b/versioned_docs/version-v1.2.0/gov/governance/contributions.md @@ -75,7 +75,7 @@ Rewards increase with more stake, as well as higher performance and uptime of yo ## What are the benefits of using distributed validators? -Distributed validators increase the security, resiliency, and decentralisation of Ethereum. Learn more at [obol.org/learn](obol.org/learn). +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? From 1d33dc98faeca64c7a60d3b3ea081ec2d993a04b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Tue, 14 Jan 2025 11:53:38 +0100 Subject: [PATCH 04/24] changing "rewards" to "programmatic incentives" --- docs/gov/governance/contributions.md | 44 +++++++++---------- .../gov/governance/contributions.md | 44 +++++++++---------- 2 files changed, 44 insertions(+), 44 deletions(-) diff --git a/docs/gov/governance/contributions.md b/docs/gov/governance/contributions.md index 6fd3073aa8..bf1a40ca21 100644 --- a/docs/gov/governance/contributions.md +++ b/docs/gov/governance/contributions.md @@ -1,39 +1,39 @@ --- sidebar_position: 6 -description: Earning Obol Contributions +description: Earning OBOL Programmatic Incentives --- -# OBOL Rewards Program +# OBOL Programmatic Incentives Program -*Our aim is to encourage continuous participation and sustained support for Ethereum’s infrastructure network. The Obol Rewards program is designed to be fair and transparent, acknowledging stakers for their contribution.* +*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 contribution.* -*By basing OBOL Rewards on staking rewards accumulated by validators (pubkeys), performance is factored in (i.e. effectiveness, uptime, etc.)* +*By basing OBOL incentives on staking rewards accumulated by validators (pubkeys), performance is factored in (i.e. effectiveness, uptime, etc.)* -*Rewards 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 rewards they have generated. These endpoints are used to show individuals’ rewards within the [Obol DV Launchpad](https://launchpad.obol.org) and partners’ staking platforms.* +*Rewards 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.* -## What is the OBOL Rewards Program? +## What is the OBOL Programmatic Incentives Program? -OBOL rewards offer an opportunity for every staker to earn access to governance and ownership in the Obol Collective, by staking ETH on distributed validators. 3% of the supply of OBOL Tokens will be rewarded to stakers in the first year. +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. -## How do I participate in the OBOL Rewards Program? +## How do I participate in the OBOL Programmatic Incentives Program? -You can participate in the OBOL Rewards Program by: +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 Rewards. Visit our [Squad Staking](https://squadstaking.com) page for inspiration and to find squad members. +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. 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). -## How can I track my rewards? +## How can I track my OBOL incentives? -If you’re running your own DV, your rewards will be displayed on the [DV Launchpad](https://launchpad.obol.org). If you’re staking through a partner product, they should display your rewards and distribute them to you. +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. ## 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 rewards calculated? +## How are incentives calculated? -OBOL Rewards 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 rewards you will generate. +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. 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: @@ -43,15 +43,15 @@ where pᵢ is the split percentage for the i-th operator. We multiply by 1.01 to ## I’m already running a mainnet Obol DV? What about me? -If you are running an existing mainnet DV without the 1% split, you will not have tracked rewards and will need to deploy a new DV configuration to participate. +If you are running an existing mainnet DV without the 1% split, you will not have tracked incentives and will need to deploy a new DV configuration to participate. ## Do I need to run my own validator to participate? -No, you can stake on DVs and track your rewards through the partners listed on [obol.org/stake](https://obol.org/stake). More partners are coming soon. +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 rewards. The specific withdrawal policy will depend on the staking protocol used. +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? @@ -59,19 +59,19 @@ The minimum amount varies by staking protocol, please refer to each partner to d ## What happens if my validator has downtime? -Since OBOL Rewards are tied to staking rewards, the amount of rewards earned is impacted by validator performance metrics like effectiveness and uptime. +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, rewards 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. +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. ## How do I know my contributions are being counted accurately? -OBOL Rewards 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). +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 Rewards? +## How can I increase my OBOL Programmatic Incentives? -Rewards increase with more stake, as well as higher performance and uptime of your validators. +Incentives increase with more stake, as well as higher performance and uptime of your validators. ## What are the benefits of using distributed validators? diff --git a/versioned_docs/version-v1.2.0/gov/governance/contributions.md b/versioned_docs/version-v1.2.0/gov/governance/contributions.md index 6fd3073aa8..bf1a40ca21 100644 --- a/versioned_docs/version-v1.2.0/gov/governance/contributions.md +++ b/versioned_docs/version-v1.2.0/gov/governance/contributions.md @@ -1,39 +1,39 @@ --- sidebar_position: 6 -description: Earning Obol Contributions +description: Earning OBOL Programmatic Incentives --- -# OBOL Rewards Program +# OBOL Programmatic Incentives Program -*Our aim is to encourage continuous participation and sustained support for Ethereum’s infrastructure network. The Obol Rewards program is designed to be fair and transparent, acknowledging stakers for their contribution.* +*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 contribution.* -*By basing OBOL Rewards on staking rewards accumulated by validators (pubkeys), performance is factored in (i.e. effectiveness, uptime, etc.)* +*By basing OBOL incentives on staking rewards accumulated by validators (pubkeys), performance is factored in (i.e. effectiveness, uptime, etc.)* -*Rewards 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 rewards they have generated. These endpoints are used to show individuals’ rewards within the [Obol DV Launchpad](https://launchpad.obol.org) and partners’ staking platforms.* +*Rewards 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.* -## What is the OBOL Rewards Program? +## What is the OBOL Programmatic Incentives Program? -OBOL rewards offer an opportunity for every staker to earn access to governance and ownership in the Obol Collective, by staking ETH on distributed validators. 3% of the supply of OBOL Tokens will be rewarded to stakers in the first year. +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. -## How do I participate in the OBOL Rewards Program? +## How do I participate in the OBOL Programmatic Incentives Program? -You can participate in the OBOL Rewards Program by: +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 Rewards. Visit our [Squad Staking](https://squadstaking.com) page for inspiration and to find squad members. +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. 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). -## How can I track my rewards? +## How can I track my OBOL incentives? -If you’re running your own DV, your rewards will be displayed on the [DV Launchpad](https://launchpad.obol.org). If you’re staking through a partner product, they should display your rewards and distribute them to you. +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. ## 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 rewards calculated? +## How are incentives calculated? -OBOL Rewards 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 rewards you will generate. +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. 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: @@ -43,15 +43,15 @@ where pᵢ is the split percentage for the i-th operator. We multiply by 1.01 to ## I’m already running a mainnet Obol DV? What about me? -If you are running an existing mainnet DV without the 1% split, you will not have tracked rewards and will need to deploy a new DV configuration to participate. +If you are running an existing mainnet DV without the 1% split, you will not have tracked incentives and will need to deploy a new DV configuration to participate. ## Do I need to run my own validator to participate? -No, you can stake on DVs and track your rewards through the partners listed on [obol.org/stake](https://obol.org/stake). More partners are coming soon. +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 rewards. The specific withdrawal policy will depend on the staking protocol used. +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? @@ -59,19 +59,19 @@ The minimum amount varies by staking protocol, please refer to each partner to d ## What happens if my validator has downtime? -Since OBOL Rewards are tied to staking rewards, the amount of rewards earned is impacted by validator performance metrics like effectiveness and uptime. +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, rewards 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. +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. ## How do I know my contributions are being counted accurately? -OBOL Rewards 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). +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 Rewards? +## How can I increase my OBOL Programmatic Incentives? -Rewards increase with more stake, as well as higher performance and uptime of your validators. +Incentives increase with more stake, as well as higher performance and uptime of your validators. ## What are the benefits of using distributed validators? From 48f7b90b2994320350e4750c109bc233b2f3358e Mon Sep 17 00:00:00 2001 From: Max Sherwood <63233138+slugmann321@users.noreply.github.com> Date: Tue, 14 Jan 2025 22:31:16 +0100 Subject: [PATCH 05/24] Update docs/gov/governance/contributions.md Co-authored-by: Cryptoma <107747791+thomasheremans@users.noreply.github.com> --- docs/gov/governance/contributions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/gov/governance/contributions.md b/docs/gov/governance/contributions.md index bf1a40ca21..29e6847411 100644 --- a/docs/gov/governance/contributions.md +++ b/docs/gov/governance/contributions.md @@ -9,7 +9,7 @@ description: Earning OBOL Programmatic Incentives *By basing OBOL incentives on staking rewards accumulated by validators (pubkeys), performance is factored in (i.e. effectiveness, uptime, etc.)* -*Rewards 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.* +*Rewards 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 accumulated. These endpoints are used to show individuals’ incentives within the [Obol DV Launchpad](https://launchpad.obol.org) and partners’ staking platforms.* ## What is the OBOL Programmatic Incentives Program? From 33495a7b6dd22ec611778c4b76590ad9dfca9daa Mon Sep 17 00:00:00 2001 From: Max Sherwood <63233138+slugmann321@users.noreply.github.com> Date: Tue, 14 Jan 2025 22:31:25 +0100 Subject: [PATCH 06/24] Update docs/gov/governance/contributions.md Co-authored-by: Cryptoma <107747791+thomasheremans@users.noreply.github.com> --- docs/gov/governance/contributions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/gov/governance/contributions.md b/docs/gov/governance/contributions.md index 29e6847411..6ed5c37521 100644 --- a/docs/gov/governance/contributions.md +++ b/docs/gov/governance/contributions.md @@ -5,7 +5,7 @@ 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 contribution.* +*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 capital contribution.* *By basing OBOL incentives on staking rewards accumulated by validators (pubkeys), performance is factored in (i.e. effectiveness, uptime, etc.)* From 7a91e6c1ef0056ee8d15a791fab90578e27e51fd Mon Sep 17 00:00:00 2001 From: Max Sherwood <63233138+slugmann321@users.noreply.github.com> Date: Tue, 14 Jan 2025 22:31:36 +0100 Subject: [PATCH 07/24] Update docs/gov/governance/contributions.md Co-authored-by: Cryptoma <107747791+thomasheremans@users.noreply.github.com> --- docs/gov/governance/contributions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/gov/governance/contributions.md b/docs/gov/governance/contributions.md index 6ed5c37521..399ea9b0ee 100644 --- a/docs/gov/governance/contributions.md +++ b/docs/gov/governance/contributions.md @@ -13,7 +13,7 @@ description: Earning OBOL Programmatic Incentives ## 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. +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 ETH stakers on Obol DVs in the first year. ## How do I participate in the OBOL Programmatic Incentives Program? From 227390c37bdbf066dadf60551e71cd78efbad219 Mon Sep 17 00:00:00 2001 From: Max Sherwood <63233138+slugmann321@users.noreply.github.com> Date: Tue, 14 Jan 2025 22:31:47 +0100 Subject: [PATCH 08/24] Update docs/gov/governance/contributions.md Co-authored-by: Cryptoma <107747791+thomasheremans@users.noreply.github.com> --- docs/gov/governance/contributions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/gov/governance/contributions.md b/docs/gov/governance/contributions.md index 399ea9b0ee..a4d6da8572 100644 --- a/docs/gov/governance/contributions.md +++ b/docs/gov/governance/contributions.md @@ -25,7 +25,7 @@ You can participate in the OBOL Programmatic Incentives Program by: ## 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. +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 share of programmatic incentives and distribute them to you through their interface directly. ## What benefits do I get from the OBOL Token? From 70fadf9a5c1d9a1bd029ceb9fee54102b307be21 Mon Sep 17 00:00:00 2001 From: Max Sherwood <63233138+slugmann321@users.noreply.github.com> Date: Tue, 14 Jan 2025 22:31:53 +0100 Subject: [PATCH 09/24] Update docs/gov/governance/contributions.md Co-authored-by: Cryptoma <107747791+thomasheremans@users.noreply.github.com> --- docs/gov/governance/contributions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/gov/governance/contributions.md b/docs/gov/governance/contributions.md index a4d6da8572..4682957d51 100644 --- a/docs/gov/governance/contributions.md +++ b/docs/gov/governance/contributions.md @@ -33,7 +33,7 @@ OBOL Tokens serve as the basis for ownership and governance of the Obol Collecti ## 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. +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 accumulate. 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: From 9adaa447a8fa13d970308686f54aeefcf0e0eed2 Mon Sep 17 00:00:00 2001 From: Max Sherwood <63233138+slugmann321@users.noreply.github.com> Date: Tue, 14 Jan 2025 22:33:10 +0100 Subject: [PATCH 10/24] Update docs/gov/governance/contributions.md Co-authored-by: Cryptoma <107747791+thomasheremans@users.noreply.github.com> --- docs/gov/governance/contributions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/gov/governance/contributions.md b/docs/gov/governance/contributions.md index 4682957d51..7a2f33cc15 100644 --- a/docs/gov/governance/contributions.md +++ b/docs/gov/governance/contributions.md @@ -63,7 +63,7 @@ Since OBOL incentives are tied to staking rewards, the amount of incentives earn ## 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. +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 your are staking with or your own individual address if you are running your own DV. ## How do I know my contributions are being counted accurately? From d886ca8029fd3abd7732fb4b2efe9591e0dede49 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Tue, 14 Jan 2025 22:43:41 +0100 Subject: [PATCH 11/24] adding some bits --- docs/gov/governance/contributions.md | 22 ++++++++++--------- .../gov/governance/contributions.md | 14 +++++++----- 2 files changed, 20 insertions(+), 16 deletions(-) diff --git a/docs/gov/governance/contributions.md b/docs/gov/governance/contributions.md index 7a2f33cc15..331743bc97 100644 --- a/docs/gov/governance/contributions.md +++ b/docs/gov/governance/contributions.md @@ -5,15 +5,17 @@ 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 capital contribution.* +*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.)* -*Rewards 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 accumulated. These endpoints are used to show individuals’ incentives within the [Obol DV Launchpad](https://launchpad.obol.org) and partners’ staking platforms.* +*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.* ## 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 ETH stakers on Obol DVs in the first year. +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. + +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? @@ -23,9 +25,13 @@ You can participate in the OBOL Programmatic Incentives Program by: 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). +## 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. + ## 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 share of programmatic incentives and distribute them to you through their interface directly. +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. ## What benefits do I get from the OBOL Token? @@ -33,7 +39,7 @@ OBOL Tokens serve as the basis for ownership and governance of the Obol Collecti ## 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 accumulate. +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. 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: @@ -41,10 +47,6 @@ Cᵢ = R × pᵢ × 0.01 × 1.01 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. -## I’m already running a mainnet Obol DV? What about me? - -If you are running an existing mainnet DV without the 1% split, you will not have tracked incentives and will need to deploy a new DV configuration to participate. - ## 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. @@ -63,7 +65,7 @@ Since OBOL incentives are tied to staking rewards, the amount of incentives earn ## 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 your are staking with or your own individual address if you are running your own DV. +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. ## How do I know my contributions are being counted accurately? diff --git a/versioned_docs/version-v1.2.0/gov/governance/contributions.md b/versioned_docs/version-v1.2.0/gov/governance/contributions.md index bf1a40ca21..331743bc97 100644 --- a/versioned_docs/version-v1.2.0/gov/governance/contributions.md +++ b/versioned_docs/version-v1.2.0/gov/governance/contributions.md @@ -5,16 +5,18 @@ 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 contribution.* +*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.)* -*Rewards 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.* +*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.* ## 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. +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: @@ -23,6 +25,10 @@ You can participate in the OBOL Programmatic Incentives Program by: 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). +## 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. + ## 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. @@ -41,10 +47,6 @@ Cᵢ = R × pᵢ × 0.01 × 1.01 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. -## I’m already running a mainnet Obol DV? What about me? - -If you are running an existing mainnet DV without the 1% split, you will not have tracked incentives and will need to deploy a new DV configuration to participate. - ## 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. From 58b9d3db00d65a661ef4cd24332c2699b53bf9c3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Wed, 15 Jan 2025 10:22:07 +0100 Subject: [PATCH 12/24] renaming and adding redirect --- docs/gov/governance/{contributions.md => incentives.md} | 0 .../gov/governance/{contributions.md => incentives.md} | 0 2 files changed, 0 insertions(+), 0 deletions(-) rename docs/gov/governance/{contributions.md => incentives.md} (100%) rename versioned_docs/version-v1.2.0/gov/governance/{contributions.md => incentives.md} (100%) diff --git a/docs/gov/governance/contributions.md b/docs/gov/governance/incentives.md similarity index 100% rename from docs/gov/governance/contributions.md rename to docs/gov/governance/incentives.md diff --git a/versioned_docs/version-v1.2.0/gov/governance/contributions.md b/versioned_docs/version-v1.2.0/gov/governance/incentives.md similarity index 100% rename from versioned_docs/version-v1.2.0/gov/governance/contributions.md rename to versioned_docs/version-v1.2.0/gov/governance/incentives.md From c5359b8ac2353c932cd9b4bfb07a3f0b9fdf346d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Wed, 15 Jan 2025 10:26:26 +0100 Subject: [PATCH 13/24] adding Toma's feedback --- docs/gov/governance/incentives.md | 20 ++++++++++--------- .../gov/governance/incentives.md | 20 ++++++++++--------- 2 files changed, 22 insertions(+), 18 deletions(-) diff --git a/docs/gov/governance/incentives.md b/docs/gov/governance/incentives.md index 331743bc97..f64e05847f 100644 --- a/docs/gov/governance/incentives.md +++ b/docs/gov/governance/incentives.md @@ -5,11 +5,7 @@ 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.* +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. ## What is the OBOL Programmatic Incentives Program? @@ -21,13 +17,19 @@ Each week, 1/52 of 2.5% of the 500m OBOL Token supply will be distributed. Incen 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. +1. **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. -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). +2. **Staking through Staking Partners**: For the current list of staking partners, please visit [obol.org/stake](https://obol.org/stake). ## 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. +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. + +## How are incentives tracked? + +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. ## How can I track my OBOL incentives? @@ -43,7 +45,7 @@ OBOL incentives are based on validator staking rewards. They are calculated dail 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 +Oᵢ = R × pᵢ × 0.01 × 1.01 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. diff --git a/versioned_docs/version-v1.2.0/gov/governance/incentives.md b/versioned_docs/version-v1.2.0/gov/governance/incentives.md index 331743bc97..f64e05847f 100644 --- a/versioned_docs/version-v1.2.0/gov/governance/incentives.md +++ b/versioned_docs/version-v1.2.0/gov/governance/incentives.md @@ -5,11 +5,7 @@ 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.* +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. ## What is the OBOL Programmatic Incentives Program? @@ -21,13 +17,19 @@ Each week, 1/52 of 2.5% of the 500m OBOL Token supply will be distributed. Incen 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. +1. **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. -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). +2. **Staking through Staking Partners**: For the current list of staking partners, please visit [obol.org/stake](https://obol.org/stake). ## 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. +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. + +## How are incentives tracked? + +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. ## How can I track my OBOL incentives? @@ -43,7 +45,7 @@ OBOL incentives are based on validator staking rewards. They are calculated dail 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 +Oᵢ = R × pᵢ × 0.01 × 1.01 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. From 00e61b585c00c7889d46cc8c336e441fcc9d9159 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Wed, 15 Jan 2025 10:28:08 +0100 Subject: [PATCH 14/24] fixing redirect --- docusaurus.config.js | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/docusaurus.config.js b/docusaurus.config.js index 6122971c65..7e673c8e19 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -234,12 +234,8 @@ const config = { from: '/docs/sdk', }, { - to: '/gov/governance/contributions', - from: '/gov/community/contributions', - }, - { - to: '/gov/governance/contributions', - from: '/gov/governance/rewards', + to: '/gov/governance/incentives', + from: '/gov/governance/contributions', }, //Redirect from multiple old paths to the new path // { From 5d65900c9db8531cd6bb3d95581b031fb035146e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Wed, 15 Jan 2025 10:52:08 +0100 Subject: [PATCH 15/24] fix redirect --- docusaurus.config.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docusaurus.config.js b/docusaurus.config.js index 7e673c8e19..49b9964216 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -138,7 +138,7 @@ const config = { from: '/docs/faq/client_configurations', }, { - to: '/gov/governance/contributions', + to: '/gov/governance/incentives', from: '/docs/faq/contributions', }, { From 09cdcadbcda9bcd952a37d21687fb0ec6663b1b6 Mon Sep 17 00:00:00 2001 From: Max Sherwood <63233138+slugmann321@users.noreply.github.com> Date: Wed, 15 Jan 2025 11:37:24 +0100 Subject: [PATCH 16/24] Update docs/gov/governance/incentives.md Co-authored-by: Cryptoma <107747791+thomasheremans@users.noreply.github.com> --- docs/gov/governance/incentives.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/gov/governance/incentives.md b/docs/gov/governance/incentives.md index f64e05847f..d8dc04c04a 100644 --- a/docs/gov/governance/incentives.md +++ b/docs/gov/governance/incentives.md @@ -37,7 +37,7 @@ If you’re running your own DV, your incentives will be displayed on the [DV La ## 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. +OBOL Tokens serve as the basis for ownership and governance of the Obol Collective. Learn more on the [OBOL Token page](./obol-token.md) of the docs. ## How are incentives calculated? From c1aafbee5ad7ca88dd6e42b315f3c9cff5992212 Mon Sep 17 00:00:00 2001 From: Max Sherwood <63233138+slugmann321@users.noreply.github.com> Date: Wed, 15 Jan 2025 17:06:13 +0100 Subject: [PATCH 17/24] Update docs/gov/governance/incentives.md Co-authored-by: Luke Hackett --- docs/gov/governance/incentives.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/gov/governance/incentives.md b/docs/gov/governance/incentives.md index d8dc04c04a..db4ed171b6 100644 --- a/docs/gov/governance/incentives.md +++ b/docs/gov/governance/incentives.md @@ -47,7 +47,7 @@ If the total staking rewards \( R \) for a validator are split among operators w Oᵢ = R × pᵢ × 0.01 × 1.01 -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. +where pᵢ is the split percentage for the i-th operator. We multiply by 1.01 to ensure that the full 1% of rewards 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? From ac7e20b96e690cd8d2cd4de158e730168e58708b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Wed, 15 Jan 2025 17:09:04 +0100 Subject: [PATCH 18/24] incorporating Luke feedback --- docs/gov/governance/incentives.md | 8 ++++---- .../version-v1.2.0/gov/governance/incentives.md | 8 ++++---- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/gov/governance/incentives.md b/docs/gov/governance/incentives.md index db4ed171b6..c88c241e2f 100644 --- a/docs/gov/governance/incentives.md +++ b/docs/gov/governance/incentives.md @@ -65,13 +65,13 @@ The minimum amount varies by staking protocol, please refer to each partner to d 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? +## Will my incentives 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. +Yes, incentives are public and can be viewed through the Obol API, if you have the address of the protocol. -## How do I know my contributions are being counted accurately? +## How do I know my incentives 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). +OBOL incentives are tracked on a daily basis, based on validator staking rewards, and can be verified via our API. ## How can I increase my OBOL Programmatic Incentives? diff --git a/versioned_docs/version-v1.2.0/gov/governance/incentives.md b/versioned_docs/version-v1.2.0/gov/governance/incentives.md index f64e05847f..6aa39496ad 100644 --- a/versioned_docs/version-v1.2.0/gov/governance/incentives.md +++ b/versioned_docs/version-v1.2.0/gov/governance/incentives.md @@ -65,13 +65,13 @@ The minimum amount varies by staking protocol, please refer to each partner to d 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? +## Will my incentives 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. +Yes, incentives are public and can be viewed through the Obol API, if you have the address of the protocol. -## How do I know my contributions are being counted accurately? +## How do I know my incentives 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). +OBOL incentives are tracked on a daily basis, based on validator staking rewards, and can be verified via our API. ## How can I increase my OBOL Programmatic Incentives? From d1b5c0d262f3ff25ac119ec1feddba27e51309ae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Wed, 29 Jan 2025 12:00:41 +0100 Subject: [PATCH 19/24] adding new Feb 24th date --- docs/gov/governance/incentives.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/gov/governance/incentives.md b/docs/gov/governance/incentives.md index c88c241e2f..1473455e6c 100644 --- a/docs/gov/governance/incentives.md +++ b/docs/gov/governance/incentives.md @@ -9,7 +9,7 @@ Our aim is to encourage continuous participation and sustained support for Ether ## 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. +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 (2025). 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. @@ -17,13 +17,14 @@ Each week, 1/52 of 2.5% of the 500m OBOL Token supply will be distributed. Incen You can participate in the OBOL Programmatic Incentives Program by: -1. **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. +1. **Staking through Staking Partners**: For the current list of staking partners, please visit [obol.org/stake](https://obol.org/stake). -2. **Staking through Staking Partners**: For the current list of staking partners, please visit [obol.org/stake](https://obol.org/stake). +2. **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. -## 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. +## Is existing stake eligible? + +No, only new stake deposited after January 24th will accrue incentives. 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. ## How are incentives tracked? From b0e749fe32ed9f512f610efdb650dd69eaa675ca Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Wed, 29 Jan 2025 12:52:16 +0100 Subject: [PATCH 20/24] adding more details --- docs/gov/governance/incentives.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/gov/governance/incentives.md b/docs/gov/governance/incentives.md index 1473455e6c..2396515703 100644 --- a/docs/gov/governance/incentives.md +++ b/docs/gov/governance/incentives.md @@ -9,9 +9,9 @@ Our aim is to encourage continuous participation and sustained support for Ether ## 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 (2025). +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, or 12.5m OBOL, will be rewarded to stakers in the first year (2025). -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. +Each week, 1/52 of the 12.5m OBOL will be distributed, or about 240,385 OBOL. 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? @@ -26,6 +26,11 @@ You can participate in the OBOL Programmatic Incentives Program by: No, only new stake deposited after January 24th will accrue incentives. 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. +## How much OBOL will I receive per ETH staked on DVs? + +The amount of OBOL you receive per ETH staked depends on the total amount of ETH participating in the program. The 240,385 OBOL per week will be distributed evenly across all participating ETH, so your share of the total participating ETH will determine your share of the OBOL incentives. + + ## How are incentives tracked? By basing OBOL incentives on staking rewards accumulated by validators (pubkeys), performance is factored in (i.e. effectiveness, uptime, etc.) From 0d9f61ebcece0d831140c945ed8c7d2c78b9f379 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Wed, 29 Jan 2025 14:52:54 +0100 Subject: [PATCH 21/24] small changes --- docs/gov/governance/incentives.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/docs/gov/governance/incentives.md b/docs/gov/governance/incentives.md index 2396515703..5725dae0d2 100644 --- a/docs/gov/governance/incentives.md +++ b/docs/gov/governance/incentives.md @@ -24,7 +24,7 @@ You can participate in the OBOL Programmatic Incentives Program by: ## Is existing stake eligible? -No, only new stake deposited after January 24th will accrue incentives. 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. +Stake deposited after January 13th will accrue incentives. 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. ## How much OBOL will I receive per ETH staked on DVs? @@ -35,7 +35,7 @@ The amount of OBOL you receive per ETH staked depends on the total amount of ETH 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. +Incentives are tracked in a centralised database off-chain - our API endpoints 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. ## How can I track my OBOL incentives? @@ -61,7 +61,7 @@ No, you can stake on DVs and track your incentives through the partners listed o ## 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. +There is no penalty for withdrawing stake or 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? @@ -75,10 +75,6 @@ Since OBOL incentives are tied to staking rewards, the amount of incentives earn Yes, incentives are public and can be viewed through the Obol API, if you have the address of the protocol. -## How do I know my incentives are being counted accurately? - -OBOL incentives are tracked on a daily basis, based on validator staking rewards, and can be verified via our API. - ## How can I increase my OBOL Programmatic Incentives? Incentives increase with more stake, as well as higher performance and uptime of your validators. From 802d79f2b8ae565f4146ecdead9d0c775c2a6ec6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Wed, 29 Jan 2025 14:53:39 +0100 Subject: [PATCH 22/24] updating v1.2 version as well --- .../gov/governance/incentives.md | 30 ++++++++++--------- 1 file changed, 16 insertions(+), 14 deletions(-) diff --git a/versioned_docs/version-v1.2.0/gov/governance/incentives.md b/versioned_docs/version-v1.2.0/gov/governance/incentives.md index 6aa39496ad..5725dae0d2 100644 --- a/versioned_docs/version-v1.2.0/gov/governance/incentives.md +++ b/versioned_docs/version-v1.2.0/gov/governance/incentives.md @@ -9,27 +9,33 @@ Our aim is to encourage continuous participation and sustained support for Ether ## 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. +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, or 12.5m OBOL, will be rewarded to stakers in the first year (2025). -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. +Each week, 1/52 of the 12.5m OBOL will be distributed, or about 240,385 OBOL. 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**: 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. +1. **Staking through Staking Partners**: For the current list of staking partners, please visit [obol.org/stake](https://obol.org/stake). -2. **Staking through Staking Partners**: For the current list of staking partners, please visit [obol.org/stake](https://obol.org/stake). +2. **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. -## 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. +## Is existing stake eligible? + +Stake deposited after January 13th will accrue incentives. 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. + +## How much OBOL will I receive per ETH staked on DVs? + +The amount of OBOL you receive per ETH staked depends on the total amount of ETH participating in the program. The 240,385 OBOL per week will be distributed evenly across all participating ETH, so your share of the total participating ETH will determine your share of the OBOL incentives. + ## How are incentives tracked? 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. +Incentives are tracked in a centralised database off-chain - our API endpoints 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. ## How can I track my OBOL incentives? @@ -37,7 +43,7 @@ If you’re running your own DV, your incentives will be displayed on the [DV La ## 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. +OBOL Tokens serve as the basis for ownership and governance of the Obol Collective. Learn more on the [OBOL Token page](./obol-token.md) of the docs. ## How are incentives calculated? @@ -47,7 +53,7 @@ If the total staking rewards \( R \) for a validator are split among operators w Oᵢ = R × pᵢ × 0.01 × 1.01 -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. +where pᵢ is the split percentage for the i-th operator. We multiply by 1.01 to ensure that the full 1% of rewards 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? @@ -55,7 +61,7 @@ No, you can stake on DVs and track your incentives through the partners listed o ## 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. +There is no penalty for withdrawing stake or 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? @@ -69,10 +75,6 @@ Since OBOL incentives are tied to staking rewards, the amount of incentives earn Yes, incentives are public and can be viewed through the Obol API, if you have the address of the protocol. -## How do I know my incentives are being counted accurately? - -OBOL incentives are tracked on a daily basis, based on validator staking rewards, and can be verified via our API. - ## How can I increase my OBOL Programmatic Incentives? Incentives increase with more stake, as well as higher performance and uptime of your validators. From 976c3c273cdeb66cb7afde4b2164e34660c8e5f2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Thu, 30 Jan 2025 10:57:33 +0100 Subject: [PATCH 23/24] changes --- versioned_docs/version-v1.2.0/gov/governance/incentives.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/versioned_docs/version-v1.2.0/gov/governance/incentives.md b/versioned_docs/version-v1.2.0/gov/governance/incentives.md index 5725dae0d2..067ad28104 100644 --- a/versioned_docs/version-v1.2.0/gov/governance/incentives.md +++ b/versioned_docs/version-v1.2.0/gov/governance/incentives.md @@ -9,7 +9,7 @@ Our aim is to encourage continuous participation and sustained support for Ether ## 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, or 12.5m OBOL, will be rewarded to stakers in the first year (2025). +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, or 12.5m OBOL, will be rewarded to stakers in the first three years (2025, 2026, 2027). Each week, 1/52 of the 12.5m OBOL will be distributed, or about 240,385 OBOL. Incentives *need to be claimed* either via the DV Launchpad, or via the UI frontend of participating partners. From e9e3c7beb371c6a4d7d2d59cc6903c4c0218a716 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CMax?= <“max@obol.tech”> Date: Mon, 3 Feb 2025 14:58:31 +0100 Subject: [PATCH 24/24] adding Nick's feedback --- docs/gov/governance/incentives.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/gov/governance/incentives.md b/docs/gov/governance/incentives.md index 5725dae0d2..44d2382753 100644 --- a/docs/gov/governance/incentives.md +++ b/docs/gov/governance/incentives.md @@ -9,7 +9,7 @@ Our aim is to encourage continuous participation and sustained support for Ether ## 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, or 12.5m OBOL, will be rewarded to stakers in the first year (2025). +OBOL Programmatic Incentives offer an opportunity to earn OBOL Token incentives for staking on Distributed Validators. 12.5m OBOL Tokens, or 2.5% of the supply, will be rewarded to stakers in the first year (2025). Incentives will begin to be accrued on February 24th, 2025. Claiming of incentives will be possible shortly thereafter. Each week, 1/52 of the 12.5m OBOL will be distributed, or about 240,385 OBOL. Incentives *need to be claimed* either via the DV Launchpad, or via the UI frontend of participating partners. @@ -24,7 +24,7 @@ You can participate in the OBOL Programmatic Incentives Program by: ## Is existing stake eligible? -Stake deposited after January 13th will accrue incentives. 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. +All stake deposited after January 13th, 2025 is eligible to accrue incentives, once the program starts on February 24th, 2025. 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. ## How much OBOL will I receive per ETH staked on DVs?