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/incentives.md b/docs/gov/governance/incentives.md new file mode 100644 index 0000000000..44d2382753 --- /dev/null +++ b/docs/gov/governance/incentives.md @@ -0,0 +1,88 @@ +--- +sidebar_position: 6 +description: Earning OBOL Programmatic Incentives +--- + +# OBOL Programmatic Incentives Program + +Our aim is to encourage continuous participation and sustained support for Ethereum’s infrastructure network. The Obol Programmatic Incentives Program program is designed to be fair and transparent, acknowledging stakers for their participation in staking on DVs. + +## What is the OBOL Programmatic Incentives Program? + +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. + +## How do I participate in the OBOL Programmatic Incentives Program? + +You can participate in the OBOL Programmatic Incentives Program by: + +1. **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 existing stake eligible? + +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? + +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 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? + +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 [OBOL Token page](./obol-token.md) of the docs. + +## How are incentives calculated? + +OBOL incentives are based on validator staking rewards. They are calculated daily and tracked off-chain. The higher the effectiveness and uptime of your validators, the more incentives you will generate. + +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: + +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% 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? + +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 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? + +The minimum amount varies by staking protocol, please refer to each partner to determine the minimum amount of stake required. + +## What happens if my validator has downtime? + +Since OBOL incentives are tied to staking rewards, the amount of incentives earned is impacted by validator performance metrics like effectiveness and uptime. + +## Will my incentives be public? + +Yes, incentives are public and can be viewed through the Obol API, if you have the address of the protocol. + +## How can I increase my OBOL Programmatic Incentives? + +Incentives increase with more stake, as well as higher performance and uptime of your validators. + +## What are the benefits of using distributed validators? + +Distributed validators increase the security, resiliency, and decentralisation of Ethereum. Learn more at [obol.org/learn](https://obol.org/learn). + +## How can I get support if I have issues? + +Support is available through Obol’s [Discord](https://discord.gg/obol) and partners’ support channels. \ No newline at end of file diff --git a/docusaurus.config.js b/docusaurus.config.js index 6270ebd574..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', }, { @@ -233,6 +233,10 @@ const config = { to: '/sdk', from: '/docs/sdk', }, + { + to: '/gov/governance/incentives', + from: '/gov/governance/contributions', + }, //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 deleted file mode 100644 index de06315b2b..0000000000 --- a/versioned_docs/version-v1.2.0/gov/governance/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/versioned_docs/version-v1.2.0/gov/governance/incentives.md b/versioned_docs/version-v1.2.0/gov/governance/incentives.md new file mode 100644 index 0000000000..067ad28104 --- /dev/null +++ b/versioned_docs/version-v1.2.0/gov/governance/incentives.md @@ -0,0 +1,88 @@ +--- +sidebar_position: 6 +description: Earning OBOL Programmatic Incentives +--- + +# OBOL Programmatic Incentives Program + +Our aim is to encourage continuous participation and sustained support for Ethereum’s infrastructure network. The Obol Programmatic Incentives Program program is designed to be fair and transparent, acknowledging stakers for their participation in staking on DVs. + +## 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 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. + +## How do I participate in the OBOL Programmatic Incentives Program? + +You can participate in the OBOL Programmatic Incentives Program by: + +1. **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 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 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? + +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 [OBOL Token page](./obol-token.md) of the docs. + +## How are incentives calculated? + +OBOL incentives are based on validator staking rewards. They are calculated daily and tracked off-chain. The higher the effectiveness and uptime of your validators, the more incentives you will generate. + +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: + +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% 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? + +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 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? + +The minimum amount varies by staking protocol, please refer to each partner to determine the minimum amount of stake required. + +## What happens if my validator has downtime? + +Since OBOL incentives are tied to staking rewards, the amount of incentives earned is impacted by validator performance metrics like effectiveness and uptime. + +## Will my incentives be public? + +Yes, incentives are public and can be viewed through the Obol API, if you have the address of the protocol. + +## How can I increase my OBOL Programmatic Incentives? + +Incentives increase with more stake, as well as higher performance and uptime of your validators. + +## What are the benefits of using distributed validators? + +Distributed validators increase the security, resiliency, and decentralisation of Ethereum. Learn more at [obol.org/learn](https://obol.org/learn). + +## How can I get support if I have issues? + +Support is available through Obol’s [Discord](https://discord.gg/obol) and partners’ support channels. \ No newline at end of file