O NIP-19 define formatos amigáveis ​​para compartilhar identificadores Nostr. Essas strings codificadas em bech32 são usadas para exibição e compartilhamento, mas nunca são usadas no próprio protocolo (que usa hexadecimal).

Como funciona

Chaves hexadecimais brutas são propensas a erros de cópia e visualmente indistinguíveis. A codificação Bech32 adiciona um prefixo e uma soma de verificação legíveis por humanos, deixando claro que tipo de dados você está vendo e detectando muitos erros de cópia.

Os formulários básicos codificam um único valor de 32 bytes:

  • npub - Chave pública (sua identidade, segura para compartilhar)
  • nsec - Chave privada (manter segredo, usada para assinatura)
  • nota - ID do evento (refere-se a um evento específico)

Exemplo: O hexadecimal pubkey 3bf0c63f... torna-se npub180cvv07tjdrrgpa0j7j7tmnyl2yr6yr7l8j4s3evf6u64th6gkwsyjh6w6.

Os formulários estendidos usam codificação TLV para que possam transportar dicas de pesquisa junto com o próprio identificador:

  • nprofile - Perfil com dicas de relay
  • nevent - Evento com dicas de relay, autor pubkey e kind
  • naddr - Referência de evento endereçável com pubkey, kind, d tag e dicas de relay

Por que é importante

As dicas de relay não são autoritativas, mas geralmente decidem se um cliente pode buscar um evento compartilhado na primeira tentativa. É por isso que nevent, nprofile e naddr são geralmente melhores formatos de compartilhamento do que valores simples note ou npub quando o conteúdo reside fora do conjunto de relays atual do destinatário.

Outra distinção prática é a estabilidade. note aponta para um ID de evento imutável, enquanto naddr aponta para um evento endereçável que pode ser substituído ao longo do tempo. Para conteúdo longo, calendários ou anúncios de repositório, naddr geralmente é o tipo de link correto.

Notas de implementação

  • Use bech32 apenas para interfaces humanas: exibir, copiar/colar, códigos QR, URLs
  • Nunca use formatos bech32 em mensagens de protocolo, eventos ou respostas NIP-05
  • Toda comunicação de protocolo deve usar codificação hexadecimal
  • Ao gerar nevent/nprofile/naddr, inclua dicas de relay para melhor descoberta
  • Trate nsec como material secreto em todos os lugares. Um cliente nunca deve exibi-lo por padrão, registrá-lo ou incluí-lo nas exportações de suporte

Fontes primárias:

Mencionado em:

Veja também: