Tutorial do Lightning Loop: swaps submarinos

O que é o Lightning Loop?

O Lightning Loop (em inglês) é um serviço da Lightning Labs que permite fazer swaps submarinos entre a rede Lightning e o Bitcoin on-chain. Na prática, o Loop permite mover bitcoin entre os canais da Lightning e a blockchain sem fechar os canais. Isso resolve um dos problemas mais comuns de quem opera um nó.

O Loop tem duas operações principais:

• Loop Out: os sats passam de um canal da Lightning para um endereço on-chain. Assim, você ganha liquidez de entrada nos seus canais ao receber bitcoin on-chain.
• Loop In: o bitcoin on-chain passa para os seus canais da Lightning. Assim, você ganha liquidez de saída e repõe a capacidade esgotada dos canais.

As duas operações usam swaps submarinos, um mecanismo de troca atômica que garante que os dois lados do swap sejam concluídos ou que nenhum seja. Isso protege o valor do swap sem que você precise confiar na Lightning Labs. As taxas já pagas e, em um Loop Out, o pequeno adiantamento que o servidor cobra no início ficam fora dessa garantia (veja as perguntas frequentes abaixo).

Por que os swaps submarinos importam

Sem swaps submarinos, você só tem duas formas de rebalancear a liquidez na Lightning:

1. Fechar e reabrir canais. É caro, porque exige duas transações on-chain. Também interrompe o roteamento enquanto o canal estiver indisponível e demora por exigir várias confirmações.
2. Rebalanceamento circular. Você envia um pagamento do seu nó para você mesmo por outros nós. Funciona, mas tem limites. Precisa de rotas suficientes, custa taxas de roteamento e não acrescenta liquidez à rede.

Os swaps submarinos oferecem uma terceira opção que evita interrupções, acrescenta liquidez real e pode ser automatizada. O guia de gerenciamento de canais da Lightning explica em detalhes por que gerenciar a liquidez importa.

Pré-requisitos

• Um nó LND em funcionamento com a versão 0.19.0-beta ou posterior, exigida pelo Loop desde a versão v0.35.1, lançada em outubro de 2026
• Familiaridade básica com a linha de comando
• Pelo menos um canal aberto na Lightning com saldo para o swap
• Para um Loop In, fundos on-chain na carteira do LND. Em um Loop Out, você recebe os fundos nessa carteira, a menos que informe outro endereço

Se você usar o Umbrel, pode instalar o Loop pela loja de aplicativos como parte do Lightning Terminal, da Lightning Labs, que também oferece uma interface gráfica para o Loop. Caso contrário, execute-o pela linha de comando.

Como instalar o Loop

Método 1: loja de aplicativos do Umbrel

1. Abra o painel do Umbrel.
2. Vá até App Store.
3. Procure “Lightning Terminal” (da Lightning Labs). O Loop já vem integrado.
4. Clique em Install. O aplicativo se conecta automaticamente à instância do LND.
5. Abra o Lightning Terminal pelo painel do Umbrel e selecione Loop.

Método 2: instalação pela linha de comando

1. Baixe o binário do Loop nas versões oficiais da Lightning Labs. Em 8 de novembro de 2026, a versão mais recente que conferimos era a v0.35.3-beta:

wget https://github.com/lightninglabs/loop/releases/download/v0.35.3-beta/loop-linux-amd64-v0.35.3-beta.tar.gz
tar -xzf loop-linux-amd64-v0.35.3-beta.tar.gz
sudo cp loop-linux-amd64-v0.35.3-beta/loop /usr/local/bin/
sudo cp loop-linux-amd64-v0.35.3-beta/loopd /usr/local/bin/

2. Inicie o daemon do Loop. Ele se conecta à instância do LND em funcionamento:

loopd --network=mainnet

3. Verifique a conexão:

loop terms

Esse comando mostra as condições atuais dos swaps, incluindo valores mínimo e máximo, taxas e parâmetros do bloqueio temporal.

Como fazer um Loop Out (Lightning → on-chain)

O Loop Out é a operação mais comum. Ele move sats dos canais da Lightning para um endereço on-chain e, com isso, cria liquidez de entrada.

Passo 1: confira as condições atuais

loop quote out --verbose 500000

O resultado estima o custo de um Loop Out de 500.000 sats. A saída inclui:

• Taxa do serviço Loop: o valor que o servidor de swaps da Lightning Labs cobra. Para um Loop Out, a Lightning Labs divulga um intervalo de 0,05% a 0,5% do valor. A taxa exata depende de quanto tempo você pode esperar e das taxas on-chain (consultado em 8 de novembro de 2026).
• Taxa on-chain estimada: a taxa de mineração estimada para a transação on-chain.
• Taxa total estimada: a soma da taxa do serviço com a taxa on-chain. As taxas de roteamento do pagamento na Lightning vêm por fora.

Passo 2: execute o Loop Out

loop out --amt 500000 --conf_target 6

Parâmetros:

• --amt: valor em satoshis que você quer retirar pelo Loop Out.
• --conf_target: número de blocos que você define como alvo para a confirmação on-chain. Um alvo maior significa taxas on-chain menores. Use 6 para a velocidade normal ou 144 para ter como alvo o dia seguinte, com as taxas mais baixas.
• --addr (opcional): endereço on-chain específico para receber os fundos, como o da carteira fria. Se você omitir o endereço, o Loop envia os fundos para um novo endereço da carteira do LND.

Passo 3: acompanhe o progresso do swap

loop monitor

O comando mostra em tempo real o andamento do swap ativo. Um Loop Out passa por quatro etapas e o loop monitor mostra o estado em maiúsculas:

1. Seu nó paga (INITIATED): seu nó envia ao servidor Loop dois pagamentos pela Lightning que somam o valor do swap mais a taxa do Loop. O servidor cobra um pequeno adiantamento antes de bloquear bitcoins on-chain. O servidor ainda não pode cobrar o restante porque não conhece o segredo que o desbloqueia.
2. O Loop bloqueia os próprios bitcoins (ainda em INITIATED): o servidor Loop bloqueia o valor do swap on-chain em um HTLC, um contrato com bloqueio por hash e por tempo. Sem --fast, o servidor pode esperar até 30 minutos antes de bloquear o valor para agrupar as transações on-chain.
3. Seu nó resgata os fundos (PREIMAGE_REVEALED): quando o HTLC é confirmado, seu nó transfere os fundos on-chain para o endereço de destino. A transferência revela o segredo, chamado de pré-imagem.
4. O Loop cobra (SUCCESS): o servidor usa a pré-imagem para cobrar o pagamento do swap. O estado muda para SUCCESS quando seu resgate é confirmado. O canal agora tem mais liquidez de entrada.

O tempo depende principalmente de --conf_target. O Loop tenta fazer com que o resgate seja confirmado dentro desse número de blocos a partir do início do swap. Com 6, leva cerca de uma hora, porque sai um bloco a cada 10 minutos em média.

Passo 4: verifique os resultados

Quando o swap terminar, confira os saldos dos canais:

lncli listchannels | jq '.channels[] | {chan_id: .chan_id, local: .local_balance, remote: .remote_balance}'

O canal usado no swap deve mostrar um saldo local menor (liquidez de saída) e um saldo remoto maior (liquidez de entrada).

Como fazer um Loop In (on-chain → Lightning)

O Loop In move bitcoin on-chain para os canais da Lightning e repõe a liquidez de saída esgotada pelos gastos.

Passo 1: solicite uma cotação

loop quote in 500000

Passo 2: execute o Loop In

loop in --amt 500000 --conf_target 6

Passo 3: o pagamento on-chain

Por padrão, o Loop In paga o HTLC on-chain pela própria carteira do LND e mostra o endereço para você acompanhar o pagamento. Para fazer o pagamento a esse endereço usando outra carteira, adicione --external (sem --conf_target). Depois que a transação on-chain for confirmada, o servidor Loop paga você pela Lightning e o saldo do canal aumenta.

loop monitor

O servidor Loop paga você pela Lightning quando sua transação on-chain tem uma confirmação. Por isso, o tempo de espera depende da taxa em sat/vB que você escolheu. Com um --conf_target maior, você paga menos e espera mais.

Recursos avançados do Loop

Autoloop: gerenciamento automático da liquidez

O Autoloop é o modo automático do Loop que mantém a liquidez dos canais dentro dos limites definidos. Você define regras e o Autoloop cuida da execução dos swaps.

1. Defina regras de liquidez para um canal específico:

loop setrule [channel_id] --incoming_threshold=25 --outgoing_threshold=25

Essa regra manda o Autoloop iniciar um Loop Out (o tipo padrão) sempre que a liquidez de entrada do canal ficar abaixo de 25% da capacidade. O swap nunca reduz a liquidez de saída para menos de 25%. Cada swap busca o ponto médio entre os dois limites. Para uma regra que reponha a liquidez de saída com o Loop In, adicione --type=in.

2. Configure os parâmetros do Autoloop:

loop setparams --autobudget=50000 --autobudgetrefreshperiod=168h --feepercent=1

Parâmetros:

• --autobudget: máximo de sats que você pode gastar em taxas de swap por período do orçamento.
• --autobudgetrefreshperiod: frequência com que o orçamento reinicia (168h = semanal).
• --feepercent: porcentagem máxima do valor de cada swap que todas as taxas somadas podem consumir. Em um swap de 500.000 sats, 1% corresponde a 5.000 sats.

3. Ative o Autoloop:

loop setparams --autoloop=true

4. Confira o status do Autoloop:

loop suggestswaps

O resultado mostra quais canais acionariam swaps com as regras atuais.

Loop com o Lightning Terminal

Se você preferir uma interface gráfica, o Lightning Terminal, o aplicativo da Lightning Labs para o Umbrel no método 1, já vem com o Loop:

1. Abra o Lightning Terminal e clique em Loop no alto. Ele mostra os canais e seus saldos.
2. Mova o controle para a esquerda para fazer um Loop Out ou para o outro lado para um Loop In. Você também pode escolher quais canais esvaziar ou reabastecer.
3. Escolha o valor com o controle deslizante e selecione Loop. Você verá as taxas antes de confirmar.
4. Nas opções adicionais, defina a velocidade de confirmação (mais blocos, taxas menores) e, para um Loop Out, um endereço, como o do armazenamento a frio.
5. Clique em Submit e acompanhe o andamento do swap.

O Lightning Terminal também permite configurar o Autoloop com um orçamento de taxas por dia, semana ou mês. O ThunderHub não tem integração com o Loop. A página de swaps usava o Boltz, que está offline (consulte as alternativas ao Loop mais abaixo).

Estratégias para otimizar as taxas

As taxas do Loop têm três componentes: a taxa do servidor de swaps, paga à Lightning Labs, a taxa de mineração on-chain e, em um Loop Out, as taxas de roteamento do pagamento na Lightning. O guia completo de taxas da rede Lightning explica como as taxas funcionam na rede. Você pode reduzir o custo de várias formas:

• Use valores altos de conf_target: com --conf_target 144, o objetivo é confirmar no dia seguinte, o que reduz bastante a taxa on-chain. Para gerenciar a liquidez sem urgência, isso economiza muitos sats.
• Deixe --fast de fora: sem esse parâmetro, o servidor Loop pode esperar até 30 minutos antes de publicar o HTLC para agrupar as transações on-chain. Isso pode reduzir a taxa do swap.
• Monitore as taxas on-chain: faça os swaps em períodos de taxas baixas, no fim de semana ou de manhã cedo. Confira as condições da mempool antes de iniciar um swap.
• Ajuste o valor dos swaps: a taxa de mineração para resgatar os bitcoins é quase a mesma com qualquer valor, por isso swaps muito pequenos saem proporcionalmente caros. Trocar 500.000 sats ou mais por operação custa menos proporcionalmente do que fazer swaps pequenos com frequência.

Alternativas ao Loop

Há outros provedores de swaps submarinos além do Loop. Conhecer as alternativas ajuda a escolher a melhor ferramenta para a sua situação:

Serviço	Provedor	Valor mínimo do swap	Taxa típica	Integração
Lightning Loop	Lightning Labs	Cerca de 250.000 sats para o Loop Out (consulte loop terms)	De 0,05% a 0,5% no Loop Out, de 0,1% a 1% no Loop In	Nativa no LND
PeerSwap	Comunidade	Variável	Taxas on-chain mais o adicional do nó parceiro	Plugin para o CLN, daemon para o LND

O Boltz, um serviço não custodial de swaps entre a Lightning, o Bitcoin on-chain e a Liquid, era a opção habitual para swaps menores a partir de qualquer carteira, com valores mínimos menores que os do Loop e sem precisar de conta. Em 3 de agosto de 2026, desativou todos os swaps. Quando verificamos, em 8 de novembro de 2026, o serviço continuava offline, por isso saiu da tabela. As ferramentas que o usavam já se adaptaram. O RTL removeu as páginas do Boltz em outubro de 2026 e a ZEUS agora faz os swaps integrados por outros provedores que usam o software de código aberto do Boltz. Se sua carteira tiver um swap integrado, confira se funciona e teste primeiro com um valor pequeno.

O PeerSwap permite fazer swaps atômicos diretamente entre os dois nós de um canal, sem um servidor de terceiros. É a opção que menos exige confiança, mas o nó parceiro também precisa rodar o PeerSwap e permitir swaps com você. É um software ainda em beta e roda como plugin para o CLN ou como daemon separado junto com o LND. Além das taxas on-chain, o nó parceiro pode pedir um adicional. Por padrão, é de 0,2% em um swap de saída e zero em um de entrada (PeerSwap v7.0.2, consultado em 8 de novembro de 2026).

Como resolver problemas comuns

Swap preso no estado “Initiated”

O HTLC on-chain ainda não foi publicado. Sem --fast, o servidor Loop pode esperar até 30 minutos antes de publicá-lo para agrupar as transações on-chain. Dê esse tempo ao servidor. Se o swap não avançar, o prazo acaba e o swap é cancelado automaticamente. O valor do swap está seguro. O protocolo de swap atômico garante que o pagamento principal seja concluído ou devolvido. A exceção é o pequeno adiantamento. O servidor cobrou esse valor no começo do Loop Out e o swap atômico não o protege. Por isso, talvez você não o recupere se o swap ficar preso.

Taxas altas na cotação

As taxas do Loop sobem em períodos de demanda alta e taxas on-chain altas. Se a cotação parecer cara, espere as taxas on-chain baixarem ou use um conf_target maior. Se sua carteira tiver um serviço próprio de swaps, compare a cotação dela também.

Erro “No Suitable Channels”

O Loop Out exige um canal com saldo de saída suficiente para financiar o swap. Se nenhum canal tiver capacidade suficiente por conta própria, reduza o valor do swap ou rebalanceie os canais primeiro com um rebalanceamento circular.

Perguntas frequentes

Posso perder fundos em um swap do Loop?

O valor do swap não se perde. Os swaps submarinos usam contratos com bloqueio por hash e por tempo que tornam a troca atômica. O pagamento na Lightning e a transação on-chain são concluídos ou revertidos juntos. Se forem revertidos, o valor do swap volta para onde estava. Duas coisas ficam fora dessa proteção. Em um Loop Out, o servidor cobra um pequeno adiantamento no início. O Loop fica com ele se já tiver bloqueado os próprios bitcoins on-chain e seu nó não os resgatar antes do prazo. Também é possível que o adiantamento não volte se o swap for abandonado antes. Por isso, mantenha o loopd em execução até o swap terminar. As taxas já pagas, como as taxas de mineração de um swap que acaba reembolsado, também não voltam.

Quanto costuma custar um Loop Out?

Execute loop quote out --verbose 500000 para ver o preço atual. A Lightning Labs divulga um intervalo de 0,05% a 0,5% do valor para um Loop Out (consultado em 8 de novembro de 2026). Assim, para 500.000 sats, a taxa do serviço vai de 250 a 2.500 sats. A isso se somam a taxa de mineração para resgatar os bitcoins, que depende da mempool e da meta de confirmação, e as taxas de roteamento do pagamento na Lightning. No exemplo calculado pela própria Lightning Labs, um Loop Out de 300.000 sats custou 500 sats de taxa do serviço, 416 sats de taxa de mineração e 1.153 sats de taxas de roteamento.

Nós com Core Lightning podem usar o Loop?

O Lightning Loop foi projetado para o LND e não oferece suporte nativo ao CLN. No CLN, o PeerSwap oferece um gerenciamento de liquidez parecido como plugin em beta, mas só entre nós do canal que também rodam o software. O Boltz, que funcionava com qualquer implementação da Lightning, está offline desde 3 de agosto de 2026 (consultado em 8 de novembro de 2026). Sem um swap, fechar um canal transfere o saldo para on-chain ao custo do canal e de uma taxa de mineração.

Com que frequência devo usar o Loop?

A frequência depende do volume de pagamentos e de como você usa os canais. Nós de roteamento com volume alto podem fazer swaps toda semana. Nós pessoais voltados para gastos podem fazer swaps uma vez por mês ou com menos frequência. Se você usar o Autoloop, o sistema decide quando executar os swaps com base nos limites que você configurou. Monitore os saldos e faça swaps quando o desequilíbrio afetar a capacidade de rotear ou gastar.