Configurazione dell'indirizzo di ricezione zap: come ricevere sats su Nostr

Ricevere zap è metà di ciò che rende funzionante il livello economico di Nostr. Inviare è la parte visibile; ricevere è quello che ti importa se pubblichi contenuti che meritano una mancia.

La configurazione è semplice ma ha una modalità di errore comune che rappresenta la maggior parte delle domande di supporto "i miei zap non vengono visualizzati". Questa guida illustra la configurazione e la risoluzione dei problemi.

TL;DR. Ottieni un portafoglio Lightning che supporta le ricevute di zap (Wallet of Satoshi, portafoglio Primal, Alby, portafoglio integrato di nostr.blog). Incolla l'indirizzo Lightning del portafoglio nel campo "Indirizzo Lightning" del tuo profilo Nostr. Salva. Testa con un piccolo zap da un altro account. Lo zap dovrebbe apparire nel tuo post entro pochi secondi.

Quando sei pronto, prendi il tuo indirizzo @nostr.blog →

Che cos'è effettivamente un indirizzo di ricezione zap

Due cose riunite insieme.

Un indirizzo Lightning. Formato come un'email: tuonome@dominio.com. Questo è un endpoint LNURL-pay. I portafogli dei mittenti lo chiamano per richiedere una fattura; restituisce una fattura; il mittente la paga; i sats arrivano.

Un editore di ricevute di zap. Quando la richiesta del mittente include un evento zap-request Nostr (kind:9734), il servizio ricevente deve, dopo il pagamento, pubblicare una ricevuta di zap firmata (kind:9735) ai relay Nostr. È questo che rende lo zap visibile nel post.

Un indirizzo Lightning senza la funzione di editore di ricevute di zap è solo un indirizzo Lightning. Il denaro si muove; nessun segnale sociale appare. Un indirizzo di ricezione zap completo fa entrambi.

Portafogli che supportano le ricevute di zap

A partire da aprile 2026, i portafogli affidabili compatibili con zap sono:

• Wallet of Satoshi. Pubblicazione affidabile di ricevute da inizio 2023.
• Portafoglio Primal. Costruito per Nostr; le ricevute funzionano per impostazione predefinita.
• Alby (ospitato e self-hosted). Forte supporto zap.
• Portafoglio integrato di nostr.blog. Le ricevute vengono pubblicate automaticamente.
• Phoenix con plugin Nostr o configurazione specifica.
• LNbits con l'estensione Nostr Zaps (self-hosted).
• Alby Hub. Supporto completo dei zap.

Portafogli senza supporto zap (il pagamento funziona, la ricevuta no):

• Indirizzi generici di prelievo da exchange (Kraken, Coinbase, ecc.)
• Alcuni vecchi portafogli custodiali che precedono gli zap
• Nodi LND senza un frontend LNURL consapevole dei zap
• Fatture Lightning grezze (nessun indirizzo Lightning affatto)

Se il tuo portafoglio non è nella prima lista, aspettati che le ricevute di zap non funzionino.

Procedura di configurazione

Passaggi concreti per il caso più comune: usando Wallet of Satoshi.

1. Installa Wallet of Satoshi. Scegli un nome utente; il tuo indirizzo Lightning diventa nomeutente@walletofsatoshi.com.
2. Copia l'indirizzo Lightning dal portafoglio (la schermata Receive lo mostra).
3. Apri il tuo client Nostr. Vai alle impostazioni del profilo.
4. Trova il campo etichettato "Indirizzo Lightning", "Indirizzo LN" o "Indirizzo Zap". Incolla il tuo indirizzo WoS lì.
5. Salva il profilo. Il client pubblica un evento di profilo aggiornato; i relay lo propagano.

Lo stesso flusso con qualsiasi altro portafoglio compatibile con zap; solo i passaggi specifici del portafoglio differiscono.

Testa la configurazione

Non dare mai per scontato che gli zap funzionino senza verificare. Testa in meno di due minuti.

Opzione 1: Zappa te stesso da una seconda identità Nostr (se ne hai una).

Opzione 2: Chiedi a un amico di pagare uno zap di 21 sats.

Opzione 3: Usa uno strumento di test zap Nostr (alcuni client includono una funzione "test zap" nelle impostazioni del portafoglio).

Risultato previsto: entro pochi secondi, lo zap appare accanto a uno dei tuoi post recenti con "21 sats" visibile. Il saldo del tuo portafoglio aumenta anche di circa 21 sats.

Se i sats arrivano ma nessuno zap appare nel post: il tuo portafoglio non sta pubblicando ricevute di zap. Passa a uno compatibile.

Se nessun sat arriva e nessuno zap appare: il pagamento stesso ha fallito. Questo è più raro; controlla i messaggi di errore nel portafoglio Lightning del mittente.

L'errore più comune

"Ho pagato uno zap a questa persona e il denaro è arrivato ma nessuna icona di zap è apparsa."

Quasi sempre: l'indirizzo Lightning del destinatario non pubblica le ricevute di zap.

Diagnosi: chiedi al destinatario quale portafoglio usa. Se è nella lista supportata, qualcosa d'altro è sbagliato. Se non è presente, quella è la tua risposta.

Soluzione: il destinatario cambia portafoglio o configura il suo servizio per pubblicare le ricevute. Il mittente ha già pagato; il denaro è nel portafoglio del destinatario. Solo il segnale sociale manca.

Questa modalità di errore rappresenta la maggior parte del traffico di supporto correlato ai zap su Nostr. Vale la pena controllare specificamente la tua configurazione per questo problema; molti utenti non si rendono conto che la loro ricezione di zap è interrotta perché vedono i sats arrivare nel loro portafoglio e presumono che tutto stia funzionando.

Perché alcuni servizi non pubblicano le ricevute

Una ricevuta di zap è un evento Nostr. Per pubblicarla, il servizio Lightning ha bisogno di:

1. Una chiave privata Nostr (per firmare le ricevute)
2. Connessioni ai relay Nostr
3. Conoscenza dell'evento zap-request che il mittente ha allegato
4. Un processo che attiva la pubblicazione della ricevuta al ricevimento del pagamento

Questo è codice infrastrutturale aggiuntivo rispetto a un portafoglio Lightning puro. I servizi che precedono gli zap (2022 e prima) non hanno tutti aggiunto la funzione. I servizi costruiti per l'uso Lightning non-Nostr non hanno motivo di spedirla.

Il risultato: due ecosistemi Lightning con sovrapposizione. Tutti gli editori di zap sono indirizzi Lightning; non tutti gli indirizzi Lightning sono editori di zap.

Indirizzi Lightning con dominio personalizzato

Se desideri alice@tuodominio.com invece di alice@walletofsatoshi.com, hai bisogno di un servizio Lightning che ti consenta di usare il tuo dominio. Opzioni:

• Esegui il tuo server LNURL-pay (LNbits con estensioni, BTCPay Server, configurazione personalizzata). Controllo completo; richiede hosting.
• Alby Hub con dominio personalizzato. Self-host Alby Hub, configura un dominio personalizzato, punta il DNS.
• Alcuni servizi gestiti offrono prezzi per dominio personalizzato. Consulta la documentazione di ciascun servizio.

Per la maggior parte degli utenti, il suffisso walletofsatoshi.com o simile va bene. Il dominio personalizzato è un perfezionamento del branding, non un miglioramento funzionale.

Combinazione di ricezione zap con NIP-05

Puoi avere:

• Il tuo identificatore verificato Nostr: alice@nostr.blog (NIP-05)
• Il tuo indirizzo di ricezione zap: wildfox123@walletofsatoshi.com (Lightning)

Non è necessario che corrispondano. Servono scopi diversi (identità vs pagamento) e spesso risiedono presso provider diversi.

Alcuni utenti preferiscono farli corrispondere. I servizi che offrono entrambi (nostr.blog offre entrambi, ad esempio) ti permettono di usare alice@nostr.blog sia per NIP-05 che per Lightning. Pulizia del branding, non un requisito tecnico.

Test del tuo indirizzo Lightning esternamente

Incolla il tuo indirizzo Lightning in uno strumento di test dell'indirizzo Lightning. Ne esistono diversi:

• lightningaddress.com ha uno strumento di ricerca
• Vari client Nostr includono una funzione "verifica il mio indirizzo Lightning" nelle impostazioni
• Puoi eseguire manualmente il test facendo in modo che qualcuno invii un pagamento Lightning regolare (non zap) all'indirizzo

Se l'indirizzo accetta pagamenti regolari, la parte Lightning di base funziona. Se pubblica anche ricevute di zap su richieste di zap, la parte zap funziona.

La maggior parte degli utenti ha bisogno solo del test di base; la parte zap viene verificata dal primo vero zap che ha successo.

Dopo la configurazione

Una volta impostato e testato l'indirizzo di ricezione zap, hai finito. Gli zap arrivano, le ricevute vengono pubblicate, tutto è automatico.

Cose da monitorare occasionalmente:

• Saldo. Il tuo portafoglio accumula zap; trasferisci il saldo in cold storage o in un portafoglio non custodiale periodicamente se il saldo diventa significativo.
• Stato del servizio. Se il tuo provider di portafoglio non è in linea, gli zap inviati durante l'interruzione potrebbero fallire o arrivare in ritardo.
• Visualizzazione del client. Diversi client Nostr rendono diversamente le ricevute di zap; quello che è visibile su Damus potrebbe sembrare diverso su Amethyst.

Tutti questi sono aspetti minori. L'esperienza tipica è che gli zap funzionano semplicemente.

Se cambi l'indirizzo di ricezione zap in seguito

La migrazione è facile. Passaggi:

1. Configura il nuovo portafoglio; ottieni il nuovo indirizzo Lightning.
2. Aggiorna il tuo profilo Nostr con il nuovo indirizzo.
3. Attendi alcuni minuti affinché l'aggiornamento del profilo si propughi ai relay.
4. I nuovi zap ora vanno al nuovo portafoglio.
5. Ritira il saldo rimanente dal vecchio portafoglio al nuovo (o al cold storage).

Gli zap inviati dopo l'aggiornamento del profilo vanno al nuovo portafoglio. Gli zap che si sono imbattuti nell'aggiornamento potrebbero andare al vecchio per un minuto o due. Una perdita trascurabile; il sistema è indulgente.

Puoi cambiare con la frequenza che desideri. L'indirizzo Lightning non è un impegno; è solo un puntatore.