Plugin Boltz su BTCPay Server: guida completa agli swap Bitcoin
Plugin Boltz su BTCPay Server: swap Lightning ⚡ e on-chain Bitcoin
Il plugin Boltz è uno degli strumenti più potenti disponibili su BTCPay Server per chi gestisce un nodo Lightning Network. Permette di eseguire atomic swap non-custodial tra Lightning e on-chain Bitcoin, risolvendo uno dei problemi più comuni nella gestione dei canali: la liquidità.
Cos'è un atomic swap?
Un atomic swap è uno scambio di fondi tra due parti (o tra due layer dello stesso network) che avviene in modo trustless e atomico: o si completa interamente, o non avviene affatto. Non esiste scenario intermedio in cui i fondi vengono persi.
Boltz utilizza HTLC (Hash Time-Locked Contracts) per garantire questa proprietà. In pratica, i fondi sono bloccati crittograficamente fino al completamento dello swap. Se qualcosa va storto, tornano automaticamente al mittente.
Tipi di swap disponibili
⚡ Submarine Swap — Lightning → On-chain
Invia satoshi dal tuo canale Lightning e ricevili on-chain. È il tipo di swap più usato per svuotare i canali quando si riempiono di liquidità in entrata.
- Ideale per consolidare fondi nel cold wallet
- Mantiene i canali sempre pronti a ricevere nuovi pagamenti
- Commissioni trasparenti e visibili prima della conferma
🔄 Reverse Swap — On-chain → Lightning
Invia satoshi on-chain e ricevili nel tuo canale Lightning. Serve per ricaricare la liquidità in uscita quando i canali sono scarichi e non riesci a inviare pagamenti.
- Ideale per merchant che inviano spesso pagamenti Lightning
- Nessun bisogno di aprire nuovi canali
- Funziona con qualsiasi wallet on-chain
🔗 Chain Swap — On-chain → On-chain
Sposta fondi tra due indirizzi on-chain in modo atomico. Utile per consolidare UTXO o spostare fondi tra wallet diversi senza passare per exchange.
- Nessun KYC, nessun account esterno
- Trustless: i fondi non passano mai per server di terzi
- Compatibile con qualsiasi wallet Bitcoin
Perché usare Boltz invece di un exchange?
| Caratteristica | Exchange centralizzato | Boltz (non-custodial) |
|---|---|---|
| Custodia fondi | Sì (exchange) | No (sempre tuoi) |
| KYC richiesto | Sì | No |
| Rischio controparte | Alto | Zero |
| Privacy | Bassa | Alta |
| Velocità | Minuti/ore | Minuti |
| Integrazione BTCPay | No | Nativa |
Come installare il plugin Boltz su BTCPay Server
- Accedi al tuo pannello BTCPay Server come amministratore
- Vai su Server Settings → Plugins
- Cerca Boltz nella lista dei plugin disponibili
- Clicca Install e attendi il riavvio
- Vai su Boltz → Settings nel menu laterale
- Configura l'endpoint:
https://boltz.exchange(default) - Imposta le soglie automatiche di swap
- Attiva gli swap automatici ✅
Configurazione delle soglie automatiche
La funzionalità più potente di Boltz su BTCPay è la possibilità di impostare soglie automatiche: quando la liquidità del canale supera o scende sotto una certa soglia, Boltz esegue automaticamente uno swap senza intervento manuale.
Esempio di configurazione tipica:
- Swap automatico Lightning → On-chain quando il canale supera 80% di capacità
- Swap automatico On-chain → Lightning quando il canale scende sotto 20% di capacità
Requisiti tecnici
- BTCPay Server v1.12.0 o superiore
- Nodo Lightning Network attivo (LND o CLN)
- Accesso amministratore all'istanza BTCPay
- Fondi sufficienti per coprire le commissioni di swap
Vuoi che lo configuriamo per te?
Il nostro team può installare e configurare il plugin Boltz sulla tua istanza BTCPay Server, impostare le soglie automatiche e guidarti nell'utilizzo quotidiano.