docs: bring remaining Participate pages to verified mainnet values - #25012
Draft
AztecBot wants to merge 2 commits into
Draft
docs: bring remaining Participate pages to verified mainnet values#25012AztecBot wants to merge 2 commits into
AztecBot wants to merge 2 commits into
Conversation
This file contains hidden or 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
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.
Problem
The Participate section's token and governance pages carried testnet-era or simply wrong numbers, and the technical governance pages had no plain-language ramp for token holders. Follow-up to #24910 (retail onboarding), covering the rest of the section.
Every number in this PR was verified against ground truth rather than copied forward: the
v5-nextsource line (l1-contracts,spartan/environments/network-defaults.yml), the live mainnet contracts viaeth_call(GovernancegetConfiguration(), GovernanceProposerQUORUM_SIZE()/ROUND_SIZE(), RollupgetCheckpointReward()/getRewardConfig()/getExitDelay()/getActivationThreshold()/getSlotDuration()/getEpochDuration(), RewardBoostergetConfig(), tokentotalSupply()), and the live testnet Governance on Sepolia. An independent adversarial fact-review pass then re-derived every claim from scratch; it refuted none and its consistency findings are folded in.Factual corrections (docs were wrong vs. live chain)
getCheckpointReward()= 500e18,sequencerBps= 7000).token/economics.md,token/index.md,basics/blocks.md.a = 1,000, min share 100,000. Live RewardBooster (AZIP-5): +101,400/epoch, max 367,500,a = 250,000, min share 10,000,k = 1,000,000; decay 100,000/epoch confirmed in code.votingDelay/5 + votingDuration + executionDelay) is ~9.6 days.token/staking.md,token/voting.md,governance/voting.md,governance/index.md.governance/index.md,governance/proposal-lifecycle.md,token/voting.md.proposeWithLocknumbers documented from chain: 258,750,000 $AZTEC lock (2.5% of the verified 10.35B supply), 90-day lock delay.governance/voting.mdclaimed control was disabled "by passing the zero address as the GSE". Actual mechanism: zero beneficiary in the constructor permanently allows all beneficiaries (isAllBeneficiariesAllowed()returns true on mainnet).alpha.mdsaid a bounty was "being prepared"; it links the live Cantina program now.networks.md: governance parameter table extended with the verified grace period, voting quorum, required yea margin, minimum total power, and propose-with-lock rows for both networks, since participate pages now cite it for live values.Readability and consistency
proposal-lifecycle.md,governance/voting.md,gse.md,upgrades.md;contracts.md's stale "Work in Progress" banner replaced with source + deployed-addresses pointers.Notes for reviewers
Two divergences surfaced during verification, deliberately not "fixed" here because the chain is the source of truth for docs:
l1-contracts/script/deploy/DeploymentConfiguration.sol's mainnet branch onv5-nextspecifies a 30-day execution delay and 200M minimum votes, but the deployed mainnet Governance has 2 days and 100M. If the script is meant to mirror the live deployment, it doesn't.yarn-project/ethereum/src/contracts/governance.ts'sProposalStateenum is missingDroppable(Solidity value 6), so raw states 6/7 decode asDropped/Expiredand a trueExpired(8) fails the bounds check.Both are flagged for the owning teams; happy to file issues.
Testing
cspellclean on all touched files; internal anchors verified (/networks#governance-parameters,/networks#contract-addresses).docs-participate/.Created by claudebox · group:
slackbot· requested by Alejo Amiras · Slack thread