eth-total-supply icon indicating copy to clipboard operation
eth-total-supply copied to clipboard

We should clarify terms so as to avoid confusing readers

Open tjayrush opened this issue 4 years ago • 1 comments

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.

tjayrush avatar Aug 16 '20 13:08 tjayrush