O NIP-30 define como os clientes exibem emojis personalizados em eventos Nostr. Emoji personalizados são referenciados no conteúdo do evento usando códigos de acesso (:shortcode:) e resolvidos por meio de emoji tags mapeando cada código de acesso para um URL de imagem.

Como funciona

Um evento que usa emoji personalizado inclui emoji tags junto com as referências de shortcode no conteúdo:

{
  "content": "Hello :gleam: world :nostrich:",
  "tags": [
    ["emoji", "gleam", "https://example.com/gleam.png"],
    ["emoji", "nostrich", "https://example.com/nostrich.png"]
  ]
}

Os clientes substituem :gleam: e :nostrich: no conteúdo renderizado por imagens embutidas dos URLs especificados. Os códigos de acesso devem ser alfanuméricos (com separadores de sublinhado permitidos) e os URLs das imagens devem apontar para imagens pequenas e quadradas adequadas para exibição in-line.

Conjuntos de emojis

Emoji personalizados podem ser organizados em conjuntos nomeados publicados como eventos substituíveis parametrizados kind 30030. Cada conjunto agrupa emojis relacionados sob um identificador d tag:

{
  "kind": 30030,
  "tags": [
    ["d", "nostr-animals"],
    ["emoji", "nostrich", "https://example.com/nostrich.png"],
    ["emoji", "nostrcat", "https://example.com/nostrcat.png"]
  ]
}

Uma atualização de março de 2026 (PR #2247) adicionou referências de endereço de conjunto de emoji opcionais no emoji tags, permitindo que os clientes abram o conjunto de origem para navegação ou marcação quando um usuário clica em um emoji.

Notas de interoperabilidade

Emoji personalizados são um recurso de apresentação, não uma garantia de transporte. Se um cliente não entender o NIP-30 ou não conseguir buscar o URL da imagem, ele ainda deverá mostrar o texto :shortcode: bruto. Essa alternativa é a razão pela qual os códigos de acesso legíveis são importantes.

O tag é evento local, a menos que faça referência a um conjunto. A reutilização de :fire: em dois eventos diferentes não implica um significado global compartilhado, a menos que ambos apontem para a mesma imagem ou conjunto. Os clientes devem primeiro resolver a definição de emoji do evento atual.

Reações

Os emojis personalizados NIP-30 também funcionam em eventos de reação kind 7. Uma reação com content definida como um shortcode e um emoji tag correspondente é renderizada como uma reação emoji personalizada no evento referenciado:

{
  "kind": 7,
  "content": ":fire:",
  "tags": [
    ["emoji", "fire", "https://example.com/fire.gif"],
    ["e", "<event-id>"]
  ]
}

Fontes primárias:

Mencionado em: