nostrfy

Gruppi NIP-29

Gruppi NIP-29: spazi di chat chiusi in cui solo i membri possono scrivere, con eventi di moderazione e snapshot dello stato del gruppo firmati dal relay.

Abilitare i gruppi

  1. Esegui nostrfy genkey per impostare relay.private_key (obbligatorio — senza di essa i metadati del gruppo non vengono generati).
  2. Riavvia il relay.

Come funzionano i gruppi

I gruppi vengono creati e moderati tramite eventi. Da questi eventi di moderazione il relay genera istantanee firmate dal relay che i client usano per la visualizzazione:

EventoDescrizione
kind:9007Crea gruppo (il creatore diventa admin)
kind:9000 / 9001Aggiungi membro (con ruoli) / rimuovi membro
kind:9002Modifica i metadati (nome, descrizione, pubblico/privato, ...)
kind:9005Elimina evento (moderazione)
kind:9008Elimina gruppo (i suoi eventi memorizzati vengono eliminati)
kind:9009Crea codice di invito
kind:9010Aggiorna l’elenco dei messaggi fissati in alto
kind:9021 / 9022Richiesta di ingresso / richiesta di uscita

Istantanee firmate dal relay

  • kind:39000 — metadati del gruppo (nome, impostazioni di visibilità, ...)
  • kind:39001 — elenco admin
  • kind:39002 — elenco membri
  • kind:39005 — eventi fissati in alto

Impostazioni di visibilità del gruppo

TagSignificato
privateSolo i membri possono leggere i messaggi
restrictedSolo i membri possono scrivere
hiddenI metadati sono nascosti ai non membri
closedLe richieste di ingresso non sono approvate automaticamente (codici di invito obbligatori)
livekitIl gruppo ha una stanza audio/video LiveKit

Sottogruppi

I gruppi possono essere gerarchici — annidati con tag parent / child. I cicli vengono rifiutati automaticamente.

Uscire da un gruppo
Qualsiasi membro — incluso l’ultimo admin del gruppo — può uscire con kind:9022 e viene rimosso automaticamente; se l’ultimo admin esce, il gruppo resta senza admin. Nomina prima un altro admin, oppure elimina il gruppo con kind:9008, oppure recupera un gruppo senza admin firmando un evento di moderazione con la chiave propria del relay (relay.private_key, la pubkey del relay stesso annunciata in NIP-11). Vedi risoluzione dei problemi per la procedura.