docs(validators): add staking penalties & quarantine recovery pages#433
docs(validators): add staking penalties & quarantine recovery pages#433MuncleUscles wants to merge 2 commits into
Conversation
Adds two validator-ops pages so operators can look up quarantine, ban, idleness, and strike semantics on docs.genlayer.com — previously the slashing concept page never used any of those terms. - staking-penalties: idleness strike system, quarantine vs temporary vs permanent ban, the slashing schedule (lazy + 2-epoch time-locked), and a table mapping monitoring status to on-chain protocol states. - quarantine-recovery: operator runbook to diagnose (strikes vs below-minimum vs not-primed/version/RPC), recover per cause, and know when to escalate to permanent ban. Wires both into pages/validators/_meta.json and cross-links from the setup guide, the Genesis Epoch 0 section of the staking guide, and the slashing concept page. Facts sourced from the genlayer-consensus staking-system spec (v0.6-dev).
✅ Deploy Preview for genlayer-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
Warning Review limit reached
Next review available in: 49 minutes Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available. How can I continue?After more reviews become available, a review can be triggered using the To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews. How do review limits work?CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability. For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window. Please refer docs for additional details. Review details⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (6)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
1 participant
Description
Validators searching docs.genlayer.com for quarantine / ban / idleness / strike semantics previously found nothing — the slashing concept page is short and never uses any of those terms. This PR fixes that by adding two validator-ops pages and cross-linking them from the pages operators already read.
New pages:
pages/validators/staking-penalties.mdx— "Staking Mechanics: Penalties & Validator Lifecycle"validatorPrime(), ~2 epochs later) and the full slashing schedule (idleness / failure-to-reveal / deterministic violation / incorrect result / failed appeal) with the 80/20 self-delegated split.pages/validators/quarantine-recovery.mdx— "Quarantine Recovery"Navigation & cross-links:
pages/validators/_meta.json(after Setup Guide).setup-guide.mdx(intro + Managing Your Validator), the Genesis Epoch 0 section and Related Resources ofdevelopers/staking-guide.mdx, and theslashing.mdxconcept page (which now introduces idleness / quarantine / ban vocabulary and links out).Facts are sourced from the genlayer-consensus staking-system spec (
docs/spec/04-staking-system.md, v0.6-dev). Governance-tunable and testnet values are labelled "reference/default"; nothing is fabricated. All numbers that could drift are described qualitatively or flagged as governance parameters.Validation:
scripts/list-docs-routes.jsregisters both new routes (154 total);scripts/generate-full-docs.jspasses (209 pages), and both pages appear in the per-page.mdmirrors, thevalidators/llms-full.txtbundle, andllms.txtwith descriptions. All internal links resolve to real pages.Release Notes
Added two validator documentation pages — "Staking Mechanics: Penalties & Validator Lifecycle" and "Quarantine Recovery" — documenting idleness strikes, quarantine, temporary/permanent bans, the slashing schedule, and an operator recovery runbook. Cross-linked from the setup guide, staking guide, and slashing concept page.
Types of Changes
Checklist
generate-full-docs.jsandlist-docs-routes.jspass; new routes register; internal links resolve).