Skip to content

Conversation

@andrearodwork
Copy link
Contributor

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.

@vercel
Copy link

vercel bot commented Nov 19, 2025

@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.

@vercel
Copy link

vercel bot commented Nov 20, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs2 Ready Ready Preview Comment Nov 20, 2025 8:33pm

Copy link
Contributor

@45930 45930 left a 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
Copy link
Contributor

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.

Copy link
Contributor Author

@andrearodwork andrearodwork Nov 24, 2025

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
Copy link
Contributor

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

Copy link
Contributor Author

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.

andrearodwork and others added 3 commits November 24, 2025 07:48
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)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants