nostr/nips
1
0
Fork 0
mirror of https://github.com/nostr-protocol/nips.git synced 2024-12-22 16:35:52 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity
4b9718ff34
nips/22.md
Vitor Pamplona 4b9718ff34 refined language
2024-08-20 16:48:47 -04:00

2.5 KiB
Raw Blame History

NIP-22

Connection Limitations

draft optional

Upon connection, and at any point during the connection, the Relay can send a LIMITS payload to the Client reflecting the current state of the user's rights in the relay.

["LIMITS", { <limit_properties> }]

Where limit_properties includes properties that are specifically designed to change the way Clients communicate. Options are:

  • can_write: <true|false>, If false, Clients MUST NOT publish events to the relay.
  • can_read: <true|false>, If false, Clients MUST NOT send REQ commands to the relay.

  • accepted_event_kinds: [<unsigned int>, <unsigned int>, ...], Clients MUST filter publishing events by these types.
  • blocked_event_kinds: [<unsigned int>, <unsigned int>, ...], Clients MUST remove these types from publishing actions.

  • min_pow_difficulty: <int>: Clients MUST filter publishing events to have PoW (number of bits equal to zero) >= this value

  • max_message_length: <int>, Clients MUST filter publishing events and crop/chunk REQ filters by this length.
  • max_subscriptions: <int>, Clients MUST reduce the number of subscriptions to this amount.
  • max_filters: <int>, Clients MUST crop/chunk REQ filters by this amount.
  • max_limit: <int>, Clients MUST clump each filter's limit value to this number and use since and until to get additional results.
  • max_event_tags: <int>, Clients MUST filter publishing events by this .tags length.
  • max_content_length: <int>, Clients MUST filter publishing events by this .content length.

  • created_at_msecs_ago: <int, milliseconds>, Clients MUST only send events whose .created_at is > than now - this number
  • created_at_msecs_ahead: <int, milliseconds>, Clients MUST only send events whose .created_at is < than now + this number

  • filter_rate_limit: <int, milliseconds>: Clients MUST debounce filter changes after this amount in milliseconds.
  • publishing_rate_limit: <int, milliseconds>: Clients MUST debounce publishing events by this amount in milliseconds.

  • required_tags: [ [ <key>, <value, optional> ], [ <key>, <value, optional> ] ], Clients MUST filter publishing events to contain all listed tag names and values.

This payload SHOULD be cached in the Client's Relay connection object and updated as many times as the relay requests. Clients should use the information here to apply filters when sending events and REQs to the relay.