upleb.uk

Public git repos — served from a NIP-34 GRASP relay at git.upleb.uk

summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--20.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/20.md b/20.md
index e76942a..9a96f6d 100644
--- a/20.md
+++ b/20.md
@@ -68,6 +68,19 @@ Event rejected, insufficient proof-of-work difficulty
68 ["OK", "b1a649ebe8...", false, "pow: difficulty 26 is less than 30"] 68 ["OK", "b1a649ebe8...", false, "pow: difficulty 26 is less than 30"]
69 69
70 70
71
72Client Handling
73---------------
74
75`messages` are meant for humans, with `reason:` prefixes so that clients can be slightly more intelligent with what to do with them. For example, with a `rate-limited:` reason the client may not show anything and simply try again with a longer timeout.
76
77For the `pow:` prefix it may query relay metadata to get the updated difficulty requirement and try again in the background.
78
79For the `invalid:` and `blocked`: prefix the client may wish to show these as styled error popups.
80
81The prefixes include a colon so that the message can be cleanly separated from the prefix by taking everything after `:` and trimming it.
82
83
71Future Extensions 84Future Extensions
72----------------- 85-----------------
73 86