Add a paragraph about slashing in runtime disputes section from the guide (#6531)

* Add a paragraph about slashing in runtime disputes section from the guide * Add definition for inconclusive
2026-06-12 20:31:13 +00:00 · 2023-01-11 13:37:57 +02:00
parent 1cb1d03c08
commit 15ecfb2c02
1 changed files with 16 additions and 1 deletions
@@ -123,4 +123,19 @@ applied:
   as a measure not to import one sided disputes. A dispute is raised only if there are two opposing votes so if the
   client is not sending them the dispute is a potential spam.
 4. Remove unconfirmed disputes - if a dispute contains less votes than the byzantine threshold it is removed. This is
-   also a spam precaution. A legitimate client will send only confirmed disputes to the runtime.
+   also a spam precaution. A legitimate client will send only confirmed disputes to the runtime.
+
+# Rewards and slashing
+
+After the disputes are filtered the validators participating in the disputes are rewarded and more importantly the
+offenders are slashed. Generally there can be two types of punishments:
+* "against valid" - the offender claimed that a valid candidate is invalid.
+* "for invalid" - the offender claimed that an invalid candidate is valid.
+
+A dispute might be inconclusive. This means that it has timed out without being confirmed. A confirmed dispute is one
+containing votes more than the byzantine threshold (1/3 of the active validators). Validators participating in
+inconclusive disputes are not slashed. Thanks to the applied filtering (described in the previous section) one can be
+confident that there are no spam disputes in the runtime. So if a validator is not voting it is due to another reason
+(e.g. being under DoS attack). There is no reason to punish such validators with a slash.
+
+*Implementation note*: Slashing is performed in `process_checked_dispute_data` from `Disputes` pallet.