Create initial Learning Sui Tokenomics overview #2101
Merged
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
Adding the image in a separate PR Will split these contents as specified once in
github-actions
bot
added
the
Type: Documentation
Clay-Mysten
added
the
Priority: High
huitseeker
reviewed
May 21, 2022
There was a problem hiding this comment.
This would probably look a lot better by having proper typesetting, but that would probably be a revision by @econmysten. I'll let him close on the review, because I know he wanted links thrown in.
doc/src/learn/tokenomics/index.md
Outdated
Comment on lines
153
to
162
| 1. During each epoch: Users submit transactions to the Sui platform and validators process them. For each transaction, users pay the associated computation and storage gas fees. In cases where users delete previous transaction data, users obtain a partial rebate of their storage fees. Validators observe the behavior of other validators and evaluate each other’s performance. | ||
| 1. At the end of each epoch: The protocol distributes stake rewards to participants of the proof-of-stake mechanism. This occurs through two main steps: | ||
| 1. The total amount of stake rewards is calculated as the sum of computation fees accrued throughout the epoch plus the epoch’s stake reward subsidies. The latter component is optional in that it will disappear in the long run as the amount of SUI in circulation reaches its total supply. | ||
| 1. The total amount of stake rewards is distributed across various entities. Importantly, remember that the storage fund is taken into account in the calculation of the epoch’s total stake. However, the storage fund is not owned by any entities in the way that delegated SUI is. Instead, Sui’s economic model distributes the stake rewards accruing to the storage fund – a share (1-alpha)% of the total stake rewards – to validators in order to compensate them for their storage costs. Of these rewards, a share gamma% is paid out to validators while the remaining (1-gamma)% is used to reinvest in the fund’s capital. Finally, assume that validators charge a commission delta% on SUI token holders as a fee for delegation. The split of stake rewards across participants is given by: | ||
|
|
||
| DelegatorRewards = (1-delta)*alpha*StakeRewards | ||
|
|
||
| ValidatorRewards = (delta*alpha + gamma*(1-alpha))*StakeRewards | ||
|
|
||
| Reinvestment = (1-gamma)*(1-alpha)*StakeRewards |
There was a problem hiding this comment.
See, this is precisely why I'm so excited about Github's support of math syntax with simple '$$' characters:
https://github.blog/2022-05-19-math-support-in-markdown/
This would look SO MUCH BETTER with that.
There was a problem hiding this comment.
@huitseeker have updated with typesetting, thanks!
doc/src/learn/tokenomics/index.md
Outdated
|
|
||
| The computation gas price ComputationPrice[t] captures the cost of one unit of computation in SUI units. This price is set at the transaction level and submitted by the user in two parts: | ||
|
|
||
| ComputationPrice[t] = ReferencePrice + Tip[t], with Tip[t]>-ReferencePrice |
There was a problem hiding this comment.
I've pinged @econmysten elsewhere, but this one has me scratching my head.
introduced typesetting for the math notation. NOTE: for some reason it does not work in listed items (e.g. check-out some of the \gamma), any thoughts why?
econmysten
approved these changes
May 23, 2022
econmysten
approved these changes
May 23, 2022
huitseeker
reviewed
May 23, 2022
There was a problem hiding this comment.
@econmysten Thanks for the typesetting update. Please review the typesetting of greeks: gamm and alpha in particular seems to not have gone through
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.
Adding the image in a separate PR
Will split these contents as specified once in