autonity / docs.autonity.org

Documentation for the Autonity Go Client (AGC)
https://docs.autonity.org
2 stars 5 forks source link

Clarify Validator economics - receiving accounts for validator revenue receipts #186

Closed cmjc closed 2 months ago

cmjc commented 5 months ago

Description

Context

When a validator serves as committee member, they receive income from 4 sources:

Income stream Receiving account Distribution Description
staking rewards treasury account epoch end This is from their own self-bonded stake
commission revenue treasury account epoch end This is commission on staking rewards for the total bonded stake bonded to the validator taken according to the validator's commission rate
priority fee tips validator identifier account block finalisation When a block proposer, priority fees for transactions included in the block are transferred directly to the validator node address, the validator identifier account
slashing rewards treasury account epoch end As the reporting validator of an accountable fault a validator may receive slashing rewards. The staking rewards for offending validator for the epoch are forfeited and become the slashing rewards sent to the reporting validator

This information could be more clearly stated in https://docs.autonity.org/concepts/validator/#validator-economics.

It is currently covered in 2 places:

Rationale

It should be clearly stated in https://docs.autonity.org/concepts/validator/#validator-economics. which accounts receive validator revenue.

Implementation

Revise Validator economics.

Clarify block proposer rewards.

cmjc commented 3 months ago

Specific edits for this issue and #178 are in commits 5dd43bfcf08cc257ffe6c9a906e4ca45ccbf6cdf and a5b59e2d31928bbcb2681f119ef638dd711686a4 in PR #199