diff --git a/docs/ejection-scenarios.md b/docs/ejection-scenarios.md new file mode 100644 index 0000000..1e0fc98 --- /dev/null +++ b/docs/ejection-scenarios.md @@ -0,0 +1,107 @@ +--- +title: Ejection Scenarios +slug: /nodes/ejection-scenarios +--- + +# Ejection Scenarios + +:::info +This document outlines various scenarios that may cause a validator to be ejected from the Puffer protocol and the Ethereum network. Understanding these scenarios is crucial for maintaining validator status and avoiding unwanted exits. +::: + +## Overview + +Validator ejection is the process where a validator is forced to exit from active validation duties. This can occur through protocol rules, performance issues, or detected malicious behavior. + +## Common Ejection Scenarios + +### 1. Balance-Related Ejection + +:::danger +If a Node Operator does not top-up their validator within 5mins of the balance dropping below 8VT per validator, all their active validators will be ejected from the active validator set. +::: + +This is a core Puffer protocol rule designed to ensure validators maintain sufficient stake for network security. + +### 2. Voluntary Exit + +:::tip +Node operators can initiate a controlled exit through their validator client when they wish to stop validating. +::: + +The process involves: +- Generating exit message +- Signing with validator keys +- Broadcasting to the network +- Waiting in exit queue + +### 3. Protocol Violations + +:::caution +Serious protocol violations result in immediate ejection and possible slashing penalties. +::: + +Common violations include: +- Double signing blocks +- Proposing multiple blocks for the same slot +- Attesting to conflicting blocks +- Sustained poor performance or downtime + +### 4. Guardian-Initiated Ejection + +Puffer Guardians may trigger ejection under these circumstances: +- Consistent failure to meet performance metrics +- Detection of malicious behavior +- Violation of protocol rules or terms of service +- Non-compliance with protocol updates + +## Handling Ejection Scenarios + +### For Voluntary Exits + +
+Steps for Voluntary Exit + +1. Claim all pending rewards +2. Follow validator client's exit procedure +3. Monitor exit queue status +4. Secure remaining funds post-exit + +
+ +### For Involuntary Ejections + +
+Recovery Steps + +1. Check Puffer Dashboard for ejection cause +2. Address technical issues if applicable +3. Contact support for disputed ejections +4. Secure remaining stake and rewards +5. Review re-entry requirements if desired + +
+ +## Prevention Best Practices + +:::tip Best Practices +1. Regular system maintenance and updates +2. Continuous monitoring of validator performance +3. Proper security measures implementation +4. Maintaining stable network connectivity +5. Following all protocol guidelines +::: + +## Additional Resources + +
+Helpful Links + +- [Puffer Dashboard](https://launchpad.puffer.fi/Dashboard) +- [Technical Requirements](/nodes/requirements) + +
+ +:::note +While ejection from the protocol doesn't always mean loss of staked ETH, certain scenarios (particularly slashing) can result in significant penalties. Always follow best practices to protect your stake. +::: diff --git a/sidebars.js b/sidebars.js index a8ecc4e..ab06631 100644 --- a/sidebars.js +++ b/sidebars.js @@ -42,7 +42,7 @@ const sidebars = { { type: "category", label: "Node Operators", - items: ["requirements", "setup", "registration", "noop-rewards", "purchase-vts"], + items: ["requirements", "setup", "registration", "noop-rewards", "purchase-vts", "ejection-scenarios"], }, { type: "category",