docs: document delinquent relay status across spec

2026-04-20 18:06:43 +05:45
parent ca26d41eef
commit 086c8f080d
4 changed files with 14 additions and 6 deletions
@@ -44,6 +44,14 @@ Notes:

 - Sets relay status to `inactive`
 - Logs activity as `(deactivate_relay, relay_id)`
+- Used for user/admin-initiated deactivation only
+
+## `pub fn mark_relay_delinquent(&self, relay: &Relay) -> Result<()>`
+
+- Sets relay status to `delinquent`
+- Logs activity as `(deactivate_relay, relay_id)`
+- Used exclusively by the billing system when a relay's subscription becomes past due
+- `delinquent` relays are automatically reactivated via `activate_relay` when payment is received

 ## `pub fn activate_relay(&self, relay: &Relay) -> Result<()>`