Beef up pol docs #297
Draft
Beef up pol docs #297
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
larrythecucumber321
requested review from
camiinthisthang and
codingwithmanny
and removed request for
codingwithmanny
Signed-off-by: Camila <[email protected]>
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
camiinthisthang
approved these changes
Sep 26, 2024
| 2. [Berps](/learn/dapps/berps) - Depositing `$HONEY` into Berps Honey Vault | ||
| 3. [Bend](/learn/dapps/bend) - Borrow `$HONEY` | ||
| 4. The _Active Validator_ distributes `$BGT` to its choice of _Reward Vaults_, defined by the validator in a _Cutting Board_ (a list of addresses and distribution percentages to different Reward Vaults). | ||
| 5. A _Liquidity Provider_ may supply liquidity, such as depositing in a BEX pool. Ex: Providing `$HONEY` and `$BERA` liquidity, for which they receive a receipt token (`$HONEY-WBERA LP`). |
There was a problem hiding this comment.
Suggested change
| 5. A _Liquidity Provider_ may supply liquidity, such as depositing in a BEX pool. Ex: Providing `$HONEY` and `$BERA` liquidity, for which they receive a receipt token (`$HONEY-WBERA LP`). | |
| 5. A _Liquidity Provider_ may supply liquidity, such as depositing assets in a BEX pool. Ex: Providing `$HONEY` and `$BERA` liquidity, for which they receive a receipt token (`$HONEY-WBERA LP`). |
| 3. [Bend](/learn/dapps/bend) - Borrow `$HONEY` | ||
| 4. The _Active Validator_ distributes `$BGT` to its choice of _Reward Vaults_, defined by the validator in a _Cutting Board_ (a list of addresses and distribution percentages to different Reward Vaults). | ||
| 5. A _Liquidity Provider_ may supply liquidity, such as depositing in a BEX pool. Ex: Providing `$HONEY` and `$BERA` liquidity, for which they receive a receipt token (`$HONEY-WBERA LP`). | ||
| 6. The _Liquidity Provider_ stakes the receipt token with the _Reward Vault_ making them eligible to receive `$BGT` based on their contribution. |
There was a problem hiding this comment.
Suggested change
| 6. The _Liquidity Provider_ stakes the receipt token with the _Reward Vault_ making them eligible to receive `$BGT` based on their contribution. | |
| 6. The _Liquidity Provider_ stakes the receipt token with the _Reward Vault_, making them eligible to receive `$BGT` based on their contribution. |
| 1. A _Prospective Validator_ will provide an initial gas token bond (`$BERA`) to secure the network and gain eligibility to produce blocks. All active validators have an equal chance to be selected to propose a block. | ||
| 2. An _Active Validator_ is chosen at random and proposes a new block. | ||
| 1. A _Prospective Validator_ stakes an initial bond (`$BERA`) to secure the network and gain eligibility to produce blocks, becoming an _Active Validator_. | ||
| 2. An _Active Validator_ is chosen at random and proposes a new block. All validators have an equal chance of being chosen. |
There was a problem hiding this comment.
Suggested change
| 2. An _Active Validator_ is chosen at random and proposes a new block. All validators have an equal chance of being chosen. | |
| 2. An _Active Validator_ is chosen at random to proposes a new block. All validators have an equal chance of being chosen. |
| 4. The _Active Validator_ distributes `$BGT` to its choice of _Reward Vaults_, defined by the validator in a _Cutting Board_ (a list of addresses and distribution percentages to different Reward Vaults). | ||
| 5. A _Liquidity Provider_ may supply liquidity, such as depositing in a BEX pool. Ex: Providing `$HONEY` and `$BERA` liquidity, for which they receive a receipt token (`$HONEY-WBERA LP`). | ||
| 6. The _Liquidity Provider_ stakes the receipt token with the _Reward Vault_ making them eligible to receive `$BGT` based on their contribution. | ||
| 7. The `$BGT` that was distributed to the Reward Vault is claimable by the _Liquidity Provider_, making them a _BGT Holder_. |
There was a problem hiding this comment.
Suggested change
| 7. The `$BGT` that was distributed to the Reward Vault is claimable by the _Liquidity Provider_, making them a _BGT Holder_. | |
| 7. The `$BGT` that was distributed to the _Reward Vault_ is claimable by the _Liquidity Provider_, making them a _BGT Holder_. |
| Validators earn through three primary means: | ||
|
|
||
| 1. Gas fees and priority fees | ||
| 2. Collecting incentives provided by protocols for directing `$BGT` rewards to their [Reward Vaults](/learn/pol/rewardvaults) | ||
| 3. Taking a commission on the total `$BGT` earned from building a block | ||
| 2. A percentage of `$BGT` block emissions (fixed at the chain level across validators) |
There was a problem hiding this comment.
Suggested change
| 2. A percentage of `$BGT` block emissions (fixed at the chain level across validators) | |
| 2. A percentage of `$BGT` block emissions that is fixed at the chain level across validators |
|
|
||
| ### Validator Incentives 💎 | ||
|
|
||
| As discussed in [$BGT](/learn/pol/tokens/bgt), emissions are distributed per block based on the `$BGT` delegation weight of the validator selected to propose the block. Each block's proposing validator has the right to distribute the block's `$BGT` rewards to any Reward Vault(s) they choose, and collect any associated incentives provided by protocols. There is an equal chance for any validator to propose a block. | ||
| Emissions are distributed per block based on the [$BGT](/learn/pol/tokens/bgt) delegation weight of the validator proposing that block. That validator has the right to distribute the block's `$BGT` rewards to any Reward Vault(s) they choose, and collect any associated incentives provided by protocols. There is an equal random chance for any validator to propose a block. |
There was a problem hiding this comment.
Suggested change
| Emissions are distributed per block based on the [$BGT](/learn/pol/tokens/bgt) delegation weight of the validator proposing that block. That validator has the right to distribute the block's `$BGT` rewards to any Reward Vault(s) they choose, and collect any associated incentives provided by protocols. There is an equal random chance for any validator to propose a block. | |
| Emissions are distributed per block based on the [$BGT](/learn/pol/tokens/bgt) delegation weight of the validator proposing that block. The block-proposing validator has the right to distribute the block's `$BGT` rewards to any Reward Vault(s) they choose, and collect any associated incentives provided by protocols. There is an equal random chance for any validator to propose a block. |
|
|
||
| Validators' `$BGT` delegation weight initially starts at 0, such that validators do not distribute `$BGT` to Reward Vaults when proposing blocks. However, by demonstrating that they are seeking out the most profitable Reward Vaults to direct `$BGT` to, and by passing on a portion of these rewards to `$BGT` delegators, they can attract a greater delegation. | ||
| Validators, by demonstrating that they are seeking out the most profitable Reward Vaults to direct `$BGT` to, and by passing on received incentives to their delegators (from which validators take a commission), can attract a greater delegation. |
There was a problem hiding this comment.
Suggested change
| Validators, by demonstrating that they are seeking out the most profitable Reward Vaults to direct `$BGT` to, and by passing on received incentives to their delegators (from which validators take a commission), can attract a greater delegation. | |
| Validators can attract greater delegation by demonstrating that they are seeking out the most profitable Reward Vaults to direct `$BGT` to, and by passing on received incentives to their delegators (from which validators take a commission). |
|
|
||
| ### Ecosystem Alignment ⚖️ | ||
|
|
||
| Validators in PoL are more than just "validating" the network, they have the opportunity to partner with protocols to promote their liquidity on Berachain. Lastly, they must earn the favor of users (i.e. `$BGT` holders and farmers) in order to effectively distribute `$BGT` rewards to Reward Vaults and earn incentives. | ||
| Validators in PoL are more than just "validating" the network, they have the opportunity to partner with protocols to promote their liquidity on Berachain. They must earn the favor of users (i.e. `$BGT` holders and farmers) in order to optimally distribute `$BGT` rewards to Reward Vaults and earn incentives (for both themselves and delegates). |
There was a problem hiding this comment.
Suggested change
| Validators in PoL are more than just "validating" the network, they have the opportunity to partner with protocols to promote their liquidity on Berachain. They must earn the favor of users (i.e. `$BGT` holders and farmers) in order to optimally distribute `$BGT` rewards to Reward Vaults and earn incentives (for both themselves and delegates). | |
| Validators in PoL are more than just "validating" the network; they have the opportunity to partner with protocols to promote their liquidity on Berachain. They must earn the favor of users (i.e. `$BGT` holders and farmers) in order to optimally distribute `$BGT` rewards to Reward Vaults and earn incentives (for both themselves and delegates). |
| 2. _Validator A_ receives 5% of the 1000 `$BGT` (50 `$BGT`), according to the commission elected by the validator | ||
| 3. _Validator A_ distributes the remainder (950 `$BGT`) to Reward Vaults according to their _Cutting Board_ distribution | ||
| 4. _Validator A_ receives _incentives_ from protocols for directing `$BGT` to their Reward Vaults (e.g. 10,000 `$HONEY`) | ||
| 5. _Validator A_ takes a 7% commission on the incentives (e.g. 700 `$HONEY`), and distributes the remainder (e.g. 9,300 `$HONEY`) to their `$BGT` delegators pro-rata |
There was a problem hiding this comment.
Suggested change
| 5. _Validator A_ takes a 7% commission on the incentives (e.g. 700 `$HONEY`), and distributes the remainder (e.g. 9,300 `$HONEY`) to their `$BGT` delegators pro-rata | |
| 5. _Validator A_ takes a 7% commission on the incentives (e.g. 700 `$HONEY`), and distributes the remainder (e.g. 9,300 `$HONEY`) to their `$BGT` delegators pro rata |
|
|
||
| PoL borrows from the Proof-of-Stake (PoS) concept of securing a chain by providing an initial stake with the native gas token. PoL builds upon PoS by introducing an additional soulbound governance token that both determines the potential reward weight for a staker, through delegation by others, and is rewarded to parties that have provided liquidity to the chain through governed reward vaults. | ||
| PoL borrows from the Proof-of-Stake (PoS) concept of securing a chain by providing an initial stake with the native gas token ([BERA](/learn/pol/tokens/bera)). PoL builds upon PoS by introducing an additional soulbound governance ([BGT](/learn/pol/tokens/bgt)) token that both determines the rewards influence of validators (through delegation by users), and which is rewarded to users that have provided liquidity on Berachain (and subsequently staked in "Reward Vaults"). |
There was a problem hiding this comment.
Suggested change
| PoL borrows from the Proof-of-Stake (PoS) concept of securing a chain by providing an initial stake with the native gas token ([BERA](/learn/pol/tokens/bera)). PoL builds upon PoS by introducing an additional soulbound governance ([BGT](/learn/pol/tokens/bgt)) token that both determines the rewards influence of validators (through delegation by users), and which is rewarded to users that have provided liquidity on Berachain (and subsequently staked in "Reward Vaults"). | |
| PoL borrows from the Proof-of-Stake (PoS) concept of securing a chain by providing an initial stake with the native gas token ([$BERA](/learn/pol/tokens/bera)). PoL builds upon PoS by introducing an additional soulbound governance ([$BGT](/learn/pol/tokens/bgt)) token that both determines the rewards influence of validators (through delegation by users) and is rewarded to users that have provided liquidity on Berachain (and subsequently staked in "Reward Vaults"). |
| This separates token responsibility for gas and security from tokens used to govern chain rewards. | ||
|
|
||
| For Berachain, that is the native gas token [`$BERA`](/learn/pol/tokens/bera), and the non-transferrable Berachain Governance Token ([`$BGT`](/learn/pol/tokens/bgt)). | ||
| This separates tokens responsible for gas and security ([`BERA`](/learn/pol/tokens/bera)) from tokens used to incentive productive activity and govern the ecosystem ([`BGT`](/learn/pol/tokens/bgt)). |
There was a problem hiding this comment.
Suggested change
| This separates tokens responsible for gas and security ([`BERA`](/learn/pol/tokens/bera)) from tokens used to incentive productive activity and govern the ecosystem ([`BGT`](/learn/pol/tokens/bgt)). | |
| PoL separates tokens responsible for gas and security ([`$BERA`](/learn/pol/tokens/bera)) from tokens used to incentive productive activity and govern the ecosystem ([`$BGT`](/learn/pol/tokens/bgt)). |
|  | ||
|
|
||
| ## Aligning Protocols, Users and Validators 🤝 | ||
|
|
||
| PoL creates networks of symbiotic relationships where the network's incentives are shared amongst ecosystem stakeholders, which validators play a key role in orchestrating: |
There was a problem hiding this comment.
Suggested change
| PoL creates networks of symbiotic relationships where the network's incentives are shared amongst ecosystem stakeholders, which validators play a key role in orchestrating: | |
| PoL creates networks of symbiotic relationships where the network's incentives are shared amongst ecosystem stakeholders, in which validators play a key role in orchestrating: |
| PoL creates networks of symbiotic relationships where the network's incentives are shared amongst ecosystem stakeholders, which validators play a key role in orchestrating: | ||
|
|
||
| - Validators partner with everyday Berachain users, as validators' ability to allocate rewards is determined by the `$BGT` delegated to them (obtained exclusively through supplying liquidity to PoL-enabled protocols). | ||
| - Protocols offer _Incentives_ to validators, in exchange for directing `$BGT` emissions to their specific _Reward Vaults_, which increases deposits in the protocol. |
There was a problem hiding this comment.
Suggested change
| - Protocols offer _Incentives_ to validators, in exchange for directing `$BGT` emissions to their specific _Reward Vaults_, which increases deposits in the protocol. | |
| - Protocols offer _Incentives_ to validators in exchange for directing `$BGT` emissions to their specific _Reward Vaults_, which increases deposits in the protocol. |
codingwithmanny
requested changes
Sep 26, 2024
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
What changes are made in this PR? Is it a feature or a bug fix?
Does it close a specific issue?
Example:
Contribution
Let us know your wallet address/ENS: