1 files changed, 24 insertions, 1 deletions

diff --git a/.env.example b/.env.example
index 993399a..fb954c0 100644
--- a/.env.example
+++ b/.env.example
@@ -254,4 +254,27 @@
 #   NGIT_REPOSITORY_BLACKLIST=npub1spam...
 #   NGIT_REPOSITORY_BLACKLIST=npub1alice.../bad-repo
 #   NGIT_REPOSITORY_BLACKLIST=malware-repo,spam-repo
-# NGIT_REPOSITORY_BLACKLIST=
\ No newline at end of file
+# NGIT_REPOSITORY_BLACKLIST=
+
+# ============================================================================
+# EVENT BLACKLIST
+# ============================================================================
+
+# Blacklist events from specific authors (npubs)
+# Comma-separated list of npubs whose events are rejected
+# ALL events from these authors are blocked from both relay storage and purgatory
+#
+# Event blacklist takes precedence over ALL other validation:
+#   - Blacklisted events are rejected before any other policy checks
+#   - Applies to announcements, state events, PRs, and all other event types
+#   - Events never reach purgatory (rejected immediately)
+#
+# Rejection reason:
+#   - "Event author <npub> is blacklisted"
+#
+# CLI: --event-blacklist <list>
+# Default: (empty - no events are blacklisted by author)
+# Examples:
+#   NGIT_EVENT_BLACKLIST=npub1spam...
+#   NGIT_EVENT_BLACKLIST=npub1spam...,npub1abuser...
+# NGIT_EVENT_BLACKLIST=
\ No newline at end of file