-
Notifications
You must be signed in to change notification settings - Fork 170
Update how-to-delegate.mdx #1149
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
|
@andrearodwork is attempting to deploy a commit to the Mina Foundation's projects Team on Vercel. A member of the Team first needs to authorize it. |
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
45930
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I added a couple of straight-up suggested changes that you can just click "accept" on and merge in.
I left some other comments that are more open ended. Writing down values like 720 Mina and 2-4 weeks when they will be subject to change in the future sets the state for this content to be obsolete someday. Do you have a content review calendar or some process to stay on top of that? Would it suffice to say "the block reward [link to more info]" and "after the next full epoch [link to more info]", or is that too annoying to the user?
I'm fine either way, but I want to confirm you've considered it.
| - **No lock-up period** - Your MINA stays in your wallet and remains accessible | ||
| - **No slashing risk** - Tokens aren’t taken for validator downtime or misbehavior | ||
| - **Earn rewards by helping secure the Mina network** - delegating your MINA supports decentralization and may yield variable staking returns (historically ~7% annually, depending on validator performance and network conditions). | ||
| - **Support decentralization** - Help secure and decentralize the Mina network |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is ok, but I would even say "even if you don't stake Mina, your wallet may still be called upon to produce a block. If you aren't delegating your stake, no block will be produced, and the network will have an empty slot." Or something to really drive home how this helps. It's not an abstract thing.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Got it. Maybe I can add a note/sentence after all of these bullets. However, I think that the average beginner may not know what the affects of an empty slot means. Would this edit be correct?
"Even if you don't stake Mina, your wallet may still be called upon to produce a block. If you aren't delegating or staking, no block will be produced and no transactions get processed in that slot. By delegating or staking your MINA, you ensure it actively helps produce blocks and secure the network."
If that sounds good to you, feel free to make the edit yourself so Im not blocking.
| 2. The validator uses your stake weight to increase their chances of producing blocks | ||
| 3. When the validator wins a block (720 MINA reward), they distribute rewards proportionally to all delegators | ||
| 4. The validator takes a commission fee and you receive your share of the remaining rewards | ||
| 5. It takes **2-4 weeks** for your delegation to become active on the network |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
2-4 weeks -> 1-2 weeks with Mesa
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good shout about the changes coming up. I'm going to add a note like in line 100 with this disclaimer. Text will be: "Note: Values like staking rewards, epoch duration, and APY are subject to change with network upgrades. After the upcoming Mesa upgrade, block rewards will decrease from 720 to 360 MINA per block, and epoch duration will reduce from 2-4 weeks to 1-2 weeks."
We typically will review content when big changes like this are made so I'd like to be specific so that it's beginner-friendly. But I also added in an open-ended note that it can change in general too.
Co-authored-by: Coby <contact@45930.xyz>
Co-authored-by: Coby <contact@45930.xyz>
Added note to clarify that values are subject to change with upgrades, clarified the impact by staking/delegating, and one slight word change suggested by legal (historically --> recently)
Updates to 'How to Delegate' docs page approved by Maki and legal at o1Labs. Purpose is to provide more thorough instructions for beginners and add links to find validators.