Configuração de endereço zap-receive: como receber sats no Nostr

Receber zaps é metade do que faz funcionar a camada econômica do Nostr. Enviar é a parte visível; receber é o que você se importa se posta conteúdo que merece gorjetas.

A configuração é simples, mas tem um modo de falha comum que responde pela maioria das perguntas de suporte "meus zaps não estão aparecendo". Este guia aborda a configuração e a depuração.

TL;DR. Obtenha uma carteira Lightning que suporte recibos de zap (Wallet of Satoshi, carteira Primal, Alby, carteira integrada nostr.blog). Cole o endereço Lightning da carteira no campo "Lightning address" do seu perfil Nostr. Salve. Teste com um pequeno zap de outra conta. O zap deve aparecer em sua postagem em alguns segundos.

Quando estiver pronto, pegue seu endereço @nostr.blog →

O que um endereço zap-receive realmente é

Duas coisas empacotadas juntas.

Um endereço Lightning. Formato como um email: yourname@domain.com. Este é um endpoint LNURL-pay. As carteiras dos remetentes o chamam para solicitar uma fatura; ele retorna uma fatura; o remetente paga; os sats chegam.

Um publicador de recibo de zap. Quando a solicitação do remetente inclui um evento zap-request Nostr (kind:9734), o serviço de recebimento deve, após o pagamento, publicar um recibo de zap assinado (kind:9735) para relés Nostr. Isto é o que torna o zap visível na postagem.

Um endereço Lightning sem o recurso publicador de recibo de zap é apenas um endereço Lightning. O dinheiro se move; nenhum sinal social aparece. Um endereço zap-receive completo faz ambos.

Carteiras que suportam recibos de zap

Até abril de 2026, as carteiras compatíveis com zap confiáveis são:

• Wallet of Satoshi. Publicação de recibo confiável desde início de 2023.
• Primal Wallet. Construída para Nostr; recibos funcionam por padrão.
• Alby (hospedado e auto-hospedado). Suporte forte para zap.
• carteira integrada nostr.blog. Recibos publicam automaticamente.
• Phoenix com plugin Nostr ou configuração específica.
• LNbits com a extensão Nostr Zaps (auto-hospedado).
• Alby Hub. Suporte completo para zap.

Carteiras sem suporte a zap (pagamento funciona, recibo não):

• Endereços genéricos de saque de exchange (Kraken, Coinbase, etc.)
• Algumas carteiras custodiais antigas anteriores a zaps
• Nós LND sem frontend LNURL zap-aware
• Faturas de nó Lightning bruto (sem endereço Lightning em absoluto)

Se sua carteira não está na primeira lista, espere que os recibos de zap falhem.

Passo a passo de configuração

Passos concretos para o caso mais comum: usar Wallet of Satoshi.

1. Instale Wallet of Satoshi. Escolha um nome de usuário; seu endereço Lightning se torna username@walletofsatoshi.com.
2. Copie o endereço Lightning da carteira (a tela Receive mostra).
3. Abra seu cliente Nostr. Vá para configurações de perfil.
4. Encontre o campo rotulado "Lightning address", "LN address" ou "Zap address". Cole seu endereço WoS lá.
5. Salve o perfil. O cliente publica um evento de perfil atualizado; relés o propagam.

O mesmo fluxo com qualquer outra carteira compatível com zap; apenas os passos específicos da carteira diferem.

Teste a configuração

Nunca assuma que zaps funcionam sem verificar. Teste em menos de dois minutos.

Opção 1: Zapeie você mesmo de uma segunda identidade Nostr (se tiver uma).

Opção 2: Peça a um amigo para zapear você 21 sats.

Opção 3: Use uma ferramenta de teste de zap Nostr (alguns clientes incluem um recurso "test zap" nas configurações da carteira).

Resultado esperado: em alguns segundos, o zap aparece ao lado de uma de suas postagens recentes com "21 sats" visível. O saldo da sua carteira também aumenta em aproximadamente 21 sats.

Se os sats chegarem mas nenhum zap aparecer na postagem: sua carteira não está publicando recibos de zap. Mude para uma compatível.

Se nenhum sat chegar e nenhum zap aparecer: o pagamento em si falhou. Isso é mais raro; verifique a carteira Lightning do remetente para mensagens de erro.

A falha mais comum

"Zapeei essa pessoa e o dinheiro chegou mas nenhum ícone de zap apareceu."

Quase sempre: o endereço Lightning do destinatário não publica recibos de zap.

Diagnóstico: pergunte ao destinatário qual carteira ele usa. Se estiver na lista de suportados, algo mais está errado. Se não estiver, essa é sua resposta.

Solução: o destinatário muda de carteira ou configura seu serviço para publicar recibos. O remetente já pagou; o dinheiro está na carteira do destinatário. Apenas o sinal social está faltando.

Este modo de falha responde pela maioria do tráfego de suporte relacionado a zap no Nostr. Vale a pena verificar sua própria configuração especificamente para este problema; muitos usuários não percebem que seu zap-receive está quebrado porque veem os sats chegarem em sua carteira e assumem que tudo está funcionando.

Por que alguns serviços não publicam recibos

Um recibo de zap é um evento Nostr. Para publicá-lo, o serviço Lightning precisa:

1. Uma chave privada Nostr (para assinar recibos)
2. Conexões com relés Nostr
3. Conhecimento do evento zap-request que o remetente anexou
4. Um processo que dispara a publicação de recibo no recebimento do pagamento

Este é código e infraestrutura extra comparado a uma carteira Lightning pura. Serviços anteriores a zaps (2022 e anteriores) nem todos retrofitaram o recurso. Serviços construídos para uso Lightning não-Nostr não têm razão para distribuí-lo.

O resultado: dois ecossistemas Lightning com sobreposição. Todos os publicadores de zap são endereços Lightning; nem todos os endereços Lightning são publicadores de zap.

Endereços Lightning com domínio personalizado

Se você quiser alice@yourdomain.com em vez de alice@walletofsatoshi.com, você precisa de um serviço Lightning que permita usar seu próprio domínio. Opções:

• Execute seu próprio servidor LNURL-pay (LNbits com extensões, BTCPay Server, configuração customizada). Controle completo; requer hospedagem.
• Alby Hub com domínio personalizado. Auto-hospede Alby Hub, configure um domínio personalizado, aponte DNS.
• Alguns serviços gerenciados oferecem preços de domínio personalizado. Verifique a documentação de cada serviço.

Para a maioria dos usuários, o sufixo walletofsatoshi.com ou similar está bem. O domínio personalizado é polimento de marca, não uma melhoria funcional.

Combinando zap-receive com NIP-05

Você pode ter:

• Seu identificador verificado Nostr: alice@nostr.blog (NIP-05)
• Seu endereço zap-receive: wildfox123@walletofsatoshi.com (Lightning)

Estes não precisam corresponder. Servem propósitos diferentes (identidade vs pagamento) e frequentemente residem em provedores diferentes.

Alguns usuários preferem corresponder. Serviços que oferecem ambos (nostr.blog oferece ambos, por exemplo) permitem usar alice@nostr.blog para ambos NIP-05 e Lightning. Limpeza de marca, não um requisito técnico.

Testando seu endereço Lightning externamente

Cole seu endereço Lightning em um testador de endereço Lightning. Vários existem:

• lightningaddress.com tem uma ferramenta de busca
• Vários clientes Nostr incluem um recurso "verify my Lightning address" nas configurações
• Você pode testar manualmente tendo alguém enviar um pagamento Lightning regular (não-zap) para o endereço

Se o endereço aceita pagamentos regulares, a parte básica de Lightning funciona. Se também publica recibos de zap em solicitações de zap, a parte de zap funciona.

A maioria dos usuários só precisa do teste básico; a parte de zap é verificada pelo primeiro zap real bem-sucedido.

Após a configuração

Uma vez que seu endereço zap-receive estiver configurado e testado, você terminou. Zaps chegam, recibos são publicados, tudo é automático.

Coisas para monitorar ocasionalmente:

• Saldo. Sua carteira acumula zaps; retire-a para armazenamento frio ou uma carteira não-custodial periodicamente se o saldo crescer significativamente.
• Status do serviço. Se seu provedor de carteira ficar offline, zaps enviados durante a interrupção podem falhar ou chegar atrasados.
• Exibição do cliente. Clientes Nostr diferentes renderizam recibos de zap diferentemente; o que é visível em Damus pode parecer diferente em Amethyst.

Tudo isto é menor. A experiência típica é que zaps simplesmente funcionam.

Se você alterar endereços zap-receive mais tarde

A migração é fácil. Passos:

1. Configure a nova carteira; obtenha o novo endereço Lightning.
2. Atualize seu perfil Nostr com o novo endereço.
3. Aguarde alguns minutos para a atualização do perfil se propagar para relés.
4. Novos zaps agora vão para a nova carteira.
5. Retire qualquer saldo remanescente da carteira antiga para a nova (ou para armazenamento frio).

Zaps enviados após a atualização do perfil vão para a nova carteira. Zaps que aconteceram de correr a atualização podem ir para a antiga por um minuto ou dois. Perda negligenciável; o sistema é tolerante.

Você pode alterar quantas vezes quiser. O endereço Lightning não é um compromisso; é apenas um ponteiro.