Monero Atomic Swaps CLI: tutorial passo-passo per lo scambio BTC↔XMR

Cosa sono gli Atomic Swap di Monero?

Gli atomic swap sono un metodo trustless per scambiare una criptovaluta con un'altra senza fare affidamento su un exchange centralizzato o intermediario. La parola "atomic" si riferisce al fatto che lo scambio si completa interamente o non avviene affatto. Non c'è possibilità che una parte riceva fondi mentre l'altra no. Per gli utenti Monero, gli atomic swap rappresentano il modo più decentralizzato per scambiare BTC con XMR o viceversa, senza fornire informazioni personali a terzi.

Il protocollo di atomic swap BTC-XMR è stato sviluppato dal team COMIT Network ed è disponibile come strumento a riga di comando dal 2021. Sebbene richieda una certa dimestichezza tecnica, il processo è semplice una volta compresi i passaggi. Questo tutorial ti guida attraverso ogni fase dell'esecuzione di un atomic swap via CLI. Il tutto senza KYC, senza registrazione e senza intermediari: la privacy finanziaria nella sua forma più pura.

Perché gli Atomic Swap sono importanti per la privacy

Nel contesto normativo attuale, molti exchange richiedono documentazione d'identità approfondita prima di permettere qualsiasi transazione. Gli atomic swap rappresentano una soluzione tecnica radicale: eliminano completamente la necessità di un intermediario fidato. Non esiste un'azienda che possa essere costretta a consegnare i tuoi dati personali, non esiste un database centralizzato con la tua storia di transazioni, non esiste un punto di fallimento unico.

Dal punto di vista normativo italiano, la Consob (Commissione Nazionale per le Società e la Borsa) e l'Agenzia delle Entrate (AdE) si interessano principalmente alle transazioni che coinvolgono servizi finanziari regolamentati. Gli atomic swap peer-to-peer operano in una zona tecnica distinta: non c'è servizio di custodia, non c'è intermediario e non c'è necessità di registrazione. Tuttavia, gli utenti italiani devono comunque dichiarare le plusvalenze derivanti da operazioni in criptovaluta nella propria dichiarazione dei redditi secondo le normative vigenti.

Prerequisiti

Prima di iniziare, assicurati di avere:

• Un computer con Linux, macOS o Windows (Linux è consigliato per la migliore compatibilità)
• Un wallet Bitcoin con i BTC da scambiare o un indirizzo per ricevere BTC
• Un wallet Monero con un indirizzo per ricevere XMR. Il wallet GUI o CLI standard di Monero funziona
• monero-wallet-rpc — Il server RPC del wallet Monero, usato dallo strumento di swap per interagire con il tuo wallet
• Connessione internet stabile — Il processo può richiedere da 30 minuti a diverse ore
• Pazienza — Gli atomic swap coinvolgono multiple transazioni on-chain con requisiti di conferma
• Conoscenza di base della riga di comando — Non è necessario essere esperti, ma devi sentirti a tuo agio con l'esecuzione di comandi in un terminale

Come funziona il protocollo: spiegazione tecnica

Prima di procedere all'installazione, è utile capire la logica crittografica alla base degli atomic swap. Il protocollo sfrutta due meccanismi chiave:

Hash Time-Locked Contracts (HTLC) su Bitcoin

Bitcoin supporta contratti intelligenti primitivi tramite il suo linguaggio di scripting. Gli HTLC permettono di creare una transazione che può essere spesa solo da chi conosce una chiave segreta specifica, entro un certo limite di tempo. Se la chiave non viene rivelata in tempo, i fondi vengono restituiti al mittente. Questo meccanismo garantisce l'atomicità: o entrambe le parti ricevono i loro fondi, o nessuna lo fa.

Adattatori di firma su Monero

Monero non supporta script complessi come Bitcoin, quindi il protocollo usa una tecnica crittografica più sofisticata chiamata adattatori di firma (signature adapters). Questi permettono di rivelare implicitamente la chiave segreta necessaria per completare lo swap monero quando viene eseguita la transazione Bitcoin, senza esporre direttamente la chiave privata sulla blockchain.

Installazione dello strumento CLI di Swap

Lo strumento principale per atomic swap BTC-XMR è mantenuto da COMIT Network.

Passo 1: Scaricare il binario

Visita la pagina ufficiale dei rilasci su GitHub (github.com/comit-network/xmr-btc-swap). Scarica il binario appropriato per il tuo sistema operativo. Per Linux x86_64, scarica il file swap_Linux_x86_64.tar.gz. Per macOS, cerca il file swap_Darwin_x86_64.tar.gz. Estrai l'archivio in una directory a tua scelta, ad esempio /usr/local/bin/ su Linux.

Passo 2: Verificare il download

Verifica sempre la firma crittografica o il checksum del software scaricato, specialmente per strumenti che gestiscono criptovalute. Il team COMIT pubblica file di checksum SHA256 per ogni versione. Puoi verificare il download con il comando sha256sum -c checksums.txt su Linux.

Passo 3: Configurare monero-wallet-rpc

Lo strumento di swap comunica con il tuo wallet Monero tramite monero-wallet-rpc. Scaricalo dalla pagina ufficiale di download di Monero (getmonero.org) e avvialo con il tuo file wallet usando il seguente comando di esempio:

./monero-wallet-rpc --wallet-file /percorso/al/wallet --rpc-bind-port 18083 --daemon-address node.moneroworld.com:18089 --rpc-login utente:password

Passo 4: Verificare l'installazione

Esegui il CLI di swap con il flag di aiuto per verificare che funzioni correttamente: ./swap --help. Dovresti vedere un elenco di comandi disponibili tra cui buy-xmr, list-sellers, resume e cancel-and-refund.

Trovare un fornitore di Swap

Gli atomic swap richiedono una controparte. Il CLI di swap usa un protocollo rendezvous per scoprire i fornitori disponibili sulla rete. Puoi elencare i fornitori con il comando:

./swap list-sellers --rendezvous-point /dnsaddr/swap.unstoppableswap.net

Il comando restituirà un elenco di fornitori con le loro informazioni di connessione, i tassi di cambio correnti, i limiti minimi e massimi in BTC e il loro tasso di completamento storico. Scegli un fornitore con un buon tasso di completamento e condizioni adatte alle tue esigenze. I tassi variano tra i fornitori, quindi vale la pena controllarne diversi prima di procedere.

Eseguire uno swap BTC verso XMR

Passo 1: Avviare lo swap

Esegui il comando buy-xmr specificando l'indirizzo del fornitore e l'importo di BTC che desideri scambiare:

./swap buy-xmr --seller /ip4/INDIRIZZO_IP/tcp/PORTA/p2p/PEER_ID --bitcoin-change-address TUO_INDIRIZZO_BTC --receive-address TUO_INDIRIZZO_XMR

Il CLI mostrerà il tasso corrente, l'importo di XMR che riceverai e un indirizzo Bitcoin dove inviare i tuoi BTC. Controlla attentamente tutti i dettagli prima di procedere.

Passo 2: Finanziare la transazione di blocco Bitcoin

Lo strumento genera una transazione di blocco Bitcoin (lock transaction). Devi finanziare questa transazione inviando esattamente l'importo di BTC indicato all'indirizzo mostrato. Il CLI monitorerà la mempool Bitcoin e notificherà quando la transazione verrà rilevata e poi confermata. Tipicamente sono necessarie 1-2 conferme Bitcoin.

Passo 3: Attendere il completamento del protocollo

Una volta confermata la transazione di blocco Bitcoin, il protocollo procede automaticamente attraverso diverse fasi:

• Fase 1: Il fornitore crea e trasmette la transazione di blocco Monero
• Fase 2: Il client verifica la transazione Monero e rivela la chiave segreta Bitcoin
• Fase 3: Il fornitore riscatta i Bitcoin usando la chiave segreta rivelata
• Fase 4: Il client usa la chiave segreta Monero (ora rivelata dall'azione del fornitore) per riscattare gli XMR

Il processo richiede tipicamente da 30 minuti a 2 ore, a seconda della congestione della rete Bitcoin.

Passo 4: Verificare il completamento

Al completamento con successo, il CLI conferma il trasferimento di XMR al tuo wallet Monero. I XMR richiedono 10 conferme prima di essere spendibili, il che richiede circa 20 minuti aggiuntivi. Verifica che il saldo nel tuo wallet Monero rifletta il nuovo importo ricevuto.

Gestione dei casi limite: Timelock di rimborso

Il protocollo include timelock che proteggono entrambe le parti. Il timelock Bitcoin tipico è di 72 blocchi (circa 12 ore) per il primo checkpoint e 144 blocchi (circa 24 ore) per la finestra di rimborso finale.

La regola critica è: mantieni il tool CLI in esecuzione fino al completamento o al rimborso. Se il tuo computer si spegne o perde la connessione durante lo swap, puoi riprendere usando il comando:

./swap resume --swap-id ID_DEL_TUO_SWAP

Se lo swap non si completa entro la finestra di timelock, puoi richiedere un rimborso con:

./swap cancel-and-refund --swap-id ID_DEL_TUO_SWAP

Questo comando pubblica la transazione di cancellazione e poi la transazione di rimborso, restituendo i tuoi BTC meno le commissioni di transazione.

Commissioni e tempistiche

• Commissioni Bitcoin — Variano in base alla congestione della rete. Aspettati di pagare commissioni per almeno 3-4 transazioni Bitcoin nell'intero processo
• Commissioni Monero — Tipicamente molto basse, nell'ordine di pochi centesimi di euro
• Spread del tasso — I fornitori offrono tipicamente dall'1 al 5 percento peggio del mercato spot
• Nessuna commissione di piattaforma — A differenza degli exchange centralizzati, non ci sono commissioni aggiuntive oltre allo spread del fornitore
• Tempo totale — Da 1 a 4 ore dalla trasmissione al completamento

Considerazioni sulla sicurezza

• Usa Monero over Tor per la privacy della connessione. Puoi configurare il CLI per usare Tor aggiungendo il flag --tor-socks5-port 9050
• Verifica il software scaricando solo da fonti ufficiali e verificando i checksum
• Backup dello stato swap — Il CLI salva automaticamente lo stato in una directory locale, ma assicurati di avere un backup prima di iniziare
• Inizia con piccoli importi per familiarizzare con il processo prima di gestire somme significative
• Non interrompere il processo a meno che non sia assolutamente necessario; usa sempre il comando di ripresa se hai bisogno di riavviare

Contesto normativo italiano (CONSOB/AdE/MiCA)

Per gli utenti italiani, è importante comprendere il quadro normativo in evoluzione per le criptovalute. Il regolamento europeo MiCA (Markets in Crypto-Assets), pienamente in vigore dal 2024, stabilisce regole chiare per i fornitori di servizi in cripto-attività (CASP). Tuttavia, le transazioni peer-to-peer come gli atomic swap non rientrano nella definizione di CASP, poiché non vi è intermediazione da parte di un'entità commerciale.

L'Agenzia delle Entrate italiana richiede la dichiarazione delle plusvalenze da criptovalute superiori a 2.000 euro nel periodo d'imposta, tramite il quadro RW del modello Unico. La Consob, pur monitorando il settore, si focalizza principalmente sugli emittenti di token e sugli exchange regolamentati, non sulle transazioni individuali peer-to-peer.

CLI Swaps vs MoneroSwapper

CLI atomic swap sono completamente trustless ma richiedono conoscenza tecnica, tempi più lunghi e la gestione attiva del processo. Presentano il massimo livello di decentralizzazione possibile, ma non sono adatti a chi non ha familiarità con la riga di comando.

MoneroSwapper offre un'interfaccia web user-friendly, esecuzione più veloce (tipicamente 5-30 minuti), supporto per multiple coppie di criptovalute e zero KYC. Per la stragrande maggioranza degli utenti che vogliono acquistare Monero privatamente senza complessità tecniche, MoneroSwapper è la soluzione ottimale.

La scelta dipende dalle tue priorità: se la massima decentralizzazione trustless è fondamentale e hai competenze tecniche, il CLI è la strada da percorrere. Se vuoi semplicità, velocità e comunque privacy completa senza KYC, MoneroSwapper è la via più efficiente per ottenere XMR.

Risoluzione dei problemi comuni

Durante l'esecuzione di atomic swap tramite CLI, potresti incontrare alcune difficoltà tecniche. Ecco i problemi più frequenti e come risolverli:

Connessione al fornitore fallita

Se il CLI non riesce a connettersi al fornitore, prova a usare un nodo rendezvous diverso o aspetta qualche minuto e riprova. I fornitori possono andare offline temporaneamente. Verifica che il tuo firewall non stia bloccando le connessioni in uscita sulle porte necessarie (tipicamente 9939 per il protocollo swap).

monero-wallet-rpc non risponde

Se il CLI segnala che non riesce a connettersi al wallet RPC, verifica che monero-wallet-rpc sia in esecuzione e che stia ascoltando sulla porta corretta. Controlla anche che le credenziali di autenticazione RPC corrispondano tra il server e il CLI di swap.

Transazione Bitcoin in sospeso troppo a lungo

Se la tua transazione di blocco Bitcoin rimane non confermata per ore, potrebbe essere necessario effettuare un Replace-By-Fee (RBF) per aumentare le commissioni. Tuttavia, fai attenzione: una volta avviato lo swap, modificare la transazione di blocco potrebbe complicare il processo. Consulta la documentazione ufficiale prima di intervenire.

Conclusione

Gli atomic swap BTC-XMR rappresentano una pietra miliare nello scambio decentralizzato di criptovalute. La possibilità di scambiare Bitcoin con Monero senza fidarsi di intermediari è uno strumento potente per la privacy finanziaria, perfettamente allineato con i valori fondamentali della comunità Monero. Con la maturazione dell'ecosistema, questa tecnologia diventerà sempre più accessibile.

Per ora, combinando il CLI con servizi come MoneroSwapper, gli utenti Monero hanno un robusto set di opzioni per acquisire e usare XMR privatamente, adattando la scelta alle proprie competenze tecniche e alle proprie esigenze specifiche.