nostr/nips
1
0
Fork 0
mirror of https://github.com/nostr-protocol/nips.git synced 2024-11-09 22:09:06 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity

Simplify claims

Browse Source
This commit is contained in:
Jon Staab 2024-02-26 09:37:17 -08:00
parent 6e3da0ffbe
commit 36fd27f06c
1 changed files with 8 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
43.md
View File

@ -2,44 +2,26 @@ NIP-43
====== ======
Relay Access Requests Relay Access Requests
----------------------------------- ---------------------
`draft` `optional` `draft` `optional`
This NIP defines a way for clients to request admission to relays enforcing authentication as defined in NIP 42 by Users MAY request access to relays using an ephemeral `kind 28935` event sent ONLY to the relay in question. Relay
signing an ephemeral event. access requests MUST have a `claim` tag containing an arbitrary string. `content` MAY be a message to the relay admin.
## Access Request Event The event's `created_at` MUST be the current time plus or minus a few minutes to prevent replay attacks. Clients MUST
check for relay support via NIP 11 to prevent non-compliant relays broadcasting invites to subscribers. These events MUST
This NIP defines kind `22243` events which are intended to allow clients to request admission to a relay. NOT be stored or relayed to subscribers.
Access requests MUST have a `claim` tag containing an invoice, invite code, or any other arbitrary string.
The event's `created_at` MUST be the current time plus or minus a few minutes to prevent replay attacks.
Clients MAY send a claim at any time, but MUST check for relay support via NIP 11 to avoid non-compliant
relays broadcasting invites to subscribers.
This event should be sent to a relay using the standard `EVENT` verb. This event should be sent to a relay using the standard `EVENT` verb.
```json ```json
{ {
"kind": 22243, "kind": 28934,
"content": "Optional message",
"tags": [ "tags": [
["claim", "<invoice id, invite code, or something else>"] ["claim", "<invoice id, invite code, or something else>"]
], ],
...other fields ...other fields
} }
``` ```
## Relay response
Upon receiving a claim, a relay MUST notify the client as to what the status of the claim is using an `OK` message.
Failed claims SHOULD use the same standard `"restricted: "` prefix specified by NIP 42.
Some examples:
```
["OK", <event-id>, false, "restricted: That invoice is expired."]
["OK", <event-id>, false, "restricted: That is an unsupported claim."]
["OK", <event-id>, true, "claim-ignored: You are already a member of this relay."]
["OK", <event-id>, true, "claim-accepted: Welcome to wss://relay.bunk.skunk!"]
```