NIP-27 especifica cómo incrustar referencias a entidades de Nostr dentro del contenido de notas de texto. Las referencias usan el esquema URI nostr: seguido de un identificador codificado en bech32 (npub, note, nevent, nprofile, naddr).

Cómo Funciona

Al componer una nota que menciona a otro usuario o referencia otro evento, la referencia se incrusta directamente en el contenido:

Check out this post by nostr:npub1... about nostr:note1...

Los clientes parsean estas referencias y las renderizan de forma apropiada, típicamente como enlaces clicables o tarjetas de perfil en línea. Las entidades referenciadas también pueden reflejarse en tags del evento para indexación o notificaciones, pero la especificación deja eso como opcional.

El NIP también cubre el parseo de hashtags. Los tags prefijados con # se extraen y agregan a los tags t del evento para búsqueda.

Tipos de Referencias

  • nostr:npub1... - Referencia a un perfil de usuario
  • nostr:note1... - Referencia a un evento de nota específico
  • nostr:nevent1... - Referencia a un evento con pistas de relay
  • nostr:nprofile1... - Referencia a un perfil con pistas de relay
  • nostr:naddr1... - Referencia a un evento direccionable

Por Qué Importa

NIP-27 separa lo que la gente lee de lo que los clientes almacenan. Un usuario puede escribir @name en un compositor enriquecido, pero el evento publicado puede contener una referencia estable nostr:nprofile... en content. Eso hace la referencia portable entre clientes sin depender de la sintaxis de mención de una aplicación.

Otro beneficio práctico es la resiliencia. Un nostr:nevent... o nostr:naddr... incrustado en texto lleva información suficiente para que otro cliente reconstruya el objetivo incluso si nunca ha visto el renderizado local original.

Notas de Interoperabilidad

  • Usa la forma NIP-21 en el contenido: nostr:<bech32-id>
  • Agrega tags p o q solo cuando tu cliente quiera notificaciones de mención o indexación de eventos más fuerte
  • No asumas que cada referencia en línea debe convertirse en una relación de respuesta. La especificación deja esa elección al cliente

Fuentes primarias:

Mencionado en:

Ver también: