eth-total-supply
eth-total-supply copied to clipboard
We should clarify terms so as to avoid confusing readers
There's a fair bit of confusion in the community about how this calculation works. I suggest we all agree on the same set of terms for the various components of the calculation.
One source would be the Yellow Paper, although I think that is pretty poorly done and most likely the source of most of the confusion.
Another source is EthHub (https://docs.ethhub.io/ethereum-basics/monetary-policy/) which may or may not have establish wording for the various components.
A third source would be ourselves, but if we do that, we should feed our work back into EthHub.
In my work, I use these terms:
| Field | Meaning |
|---|---|
| blockNumber | the block number of the record |
| timestamp | the timestamp of the block |
| period | the date of the timestamp above |
| baseReward | the base reward issuance ignoring uncleReward |
| nephewReward | the additional reward given to the beneficiary (miner) of the block for included uncles |
| blockReward | the total reward delivered to the beneficiary (winning miner) |
| uncleReward | the reward issued to the miners of each uncle blocks (if any) |
| issuance | the total new issuance for the block |
Totally open to discussion.
A few other term to define:
| Field | Meaning |
|---|---|
| beneficiary | the winning miner |
| parent block | the current block being rewarded (blockNumber above) |
| uncle block | a block appearing in the uncle's list of a canonical block |
| nephew block | a block that 'has one or more uncles'. Note: nephewBlocks are not 'children of uncles' |
| uncle miner | the address that appears in the 'miner' field of an uncle block |
| uncle block number | the block number that appears in the uncle block |