Tutorial de Lightning Loop: swaps submarinos

¿Qué es Lightning Loop?

Lightning Loop (en inglés) es un servicio de Lightning Labs que permite hacer swaps submarinos entre la red Lightning y Bitcoin on-chain. En la práctica, Loop te permite mover bitcoin entre tus canales de Lightning y la blockchain sin cerrar los canales. Así resuelve uno de los problemas más frecuentes de quien opera un nodo.

Loop tiene dos operaciones principales:

Loop Out: los sats pasan de un canal de Lightning a una dirección on-chain. Así creas liquidez de entrada en tus canales al recibir bitcoin on-chain.
Loop In: el bitcoin on-chain pasa a tus canales de Lightning. Así creas liquidez de salida y recuperas la capacidad agotada de los canales.

Dos swaps de 500 000 sats en un canal de 1 000 000 de sats. En un Loop Out, de Lightning a on-chain, 500 000 sats más las comisiones salen de tu lado del canal y llegan a Loop por Lightning. Tu saldo baja de 900 000 a algo menos de 400 000. Loop devuelve a tu billetera 500 000 sats on-chain, descontada la comisión minera por reclamarlos. Así ganas margen para recibir. En un Loop In, de on-chain a Lightning, de la billetera on-chain de tu nodo salen 500 000 sats más la comisión minera. Loop te paga por Lightning 500 000 sats menos la comisión del servicio. Así, tu lado del canal pasa de 100 000 a algo menos de 600 000. Ganas margen para enviar. El canal sigue abierto en ambos casos y solo cambia el reparto del saldo. — **Loop Out deja margen para recibir. Loop In deja margen para enviar.** Ambas operaciones son swaps con el servidor Loop de Lightning Labs. Entregas sats en una capa y los recuperas en la otra, descontadas las comisiones, sin cerrar el canal.

Las dos operaciones usan swaps submarinos, un mecanismo de intercambio atómico que garantiza que se completen ambas partes del swap o ninguna. Eso protege el importe del swap sin que tengas que confiar en Lightning Labs. Quedan fuera de esa garantía las comisiones ya pagadas y, en un Loop Out, el pequeño anticipo que el servidor cobra al principio (consulta las preguntas frecuentes más abajo).

Por qué importan los swaps submarinos

Sin swaps submarinos, solo tienes dos formas de reequilibrar tu liquidez en Lightning:

Cerrar y volver a abrir canales. Es caro, porque requiere dos transacciones on-chain. También interrumpe el enrutamiento mientras el canal no está disponible y tarda por las varias confirmaciones que necesita.
Reequilibrio circular. Envías un pago de tu nodo a ti mismo a través de otros nodos. Funciona, pero tiene límites. Necesita rutas suficientes, cuesta comisiones de enrutamiento y no añade liquidez a la red.

Los swaps submarinos ofrecen una tercera opción que evita interrupciones, añade liquidez real y puede automatizarse. La guía de gestión de canales de Lightning explica en profundidad por qué importa la liquidez.

Tres formas de reequilibrar tu liquidez. Primera, cerrar y volver a abrir. Cierras un canal, esperas y abres otro con tus sats. Un canal nuevo empieza con todo el saldo de tu lado. Por eso no te da margen para recibir. Hacen falta dos transacciones on-chain y, por tanto, dos comisiones mineras. No tienes canal hasta que se confirma el nuevo. Segunda, el reequilibrio circular. Te pagas a ti mismo. El pago sale por un canal y vuelve por otro. Los canales siguen abiertos y pagas comisiones de enrutamiento, pero necesitas una ruta y los sats solo pasan de un canal tuyo a otro. Tercera, un swap submarino. Cambias sats de Lightning por bitcoin on-chain o al revés. El canal sigue abierto, pagas una comisión de swap y otra minera, y puedes automatizarlo con Autoloop. — **Solo el swap mantiene abierto el canal y cambia la cantidad que tienes en Lightning.** Cerrar y volver a abrir te deja sin canal durante un tiempo. El canal nuevo empieza con todo el saldo de tu lado. Un reequilibrio circular solo mueve sats entre tus propios canales. Por eso tu saldo total sigue igual.

Requisitos

Un nodo LND en funcionamiento con la versión 0.19.0-beta o posterior. Loop la exige desde su versión v0.35.1, publicada en octubre de 2026
Conocimientos básicos de la línea de comandos
Al menos un canal de Lightning abierto con saldo para el swap
Para un Loop In, fondos on-chain en tu billetera de LND. En un Loop Out, recibes los fondos en esa billetera, salvo que indiques otra dirección

Si usas Umbrel, puedes instalar Loop desde la tienda de aplicaciones como parte de Lightning Terminal, de Lightning Labs, que también le da una interfaz gráfica. Si no, ejecútalo desde la línea de comandos.

Instalar Loop

Método 1: tienda de aplicaciones de Umbrel

Abre el panel de Umbrel.
Ve a App Store.
Busca «Lightning Terminal» (de Lightning Labs). Loop viene integrado.
Haz clic en Install. La aplicación se conecta automáticamente a tu instancia de LND.
Abre Lightning Terminal desde el panel de Umbrel y elige Loop.

Método 2: instalación por línea de comandos

Descarga el binario de Loop desde las publicaciones oficiales de Lightning Labs. v0.35.3-beta era la versión más reciente cuando lo comprobamos el 8 de noviembre de 2026:

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/

Inicia el proceso en segundo plano de Loop. Se conecta a tu instancia de LND en funcionamiento:

loopd --network=mainnet

Verifica la conexión:

loop terms

Este comando muestra las condiciones actuales de los swaps, incluidos los importes mínimo y máximo, las comisiones y los parámetros del bloqueo temporal.

Hacer un Loop Out (Lightning → on-chain)

Loop Out es la operación más habitual. Mueve sats desde tus canales de Lightning a una dirección on-chain y crea liquidez de entrada en el proceso.

Paso 1: consulta las condiciones actuales

loop quote out --verbose 500000

El resultado estima el costo de sacar 500 000 sats con un Loop Out. Incluye estos datos:

Comisión del servicio Loop: lo que cobra el servidor de swaps de Lightning Labs. Para un Loop Out, Lightning Labs publica un intervalo entre el 0,05 % y el 0,5 % del importe. La cifra concreta depende de cuánto puedas esperar y de las comisiones on-chain (comprobado el 8 de noviembre de 2026).
Comisión on-chain estimada: la comisión minera estimada para la transacción on-chain.
Comisión total estimada: la suma de la comisión del servicio y la comisión on-chain. Las comisiones de enrutamiento del pago de Lightning se cobran aparte.

Paso 2: ejecuta el Loop Out

loop out --amt 500000 --conf_target 6

Parámetros:

--amt: importe en satoshis que quieres sacar con Loop Out.
--conf_target: número de bloques que fijas como objetivo para la confirmación on-chain. Un objetivo más alto implica comisiones on-chain más bajas. Usa 6 para una velocidad normal o 144 para apuntar al día siguiente, con las comisiones más bajas.
--addr (opcional): dirección on-chain concreta en la que quieres recibir los fondos, como la de tu billetera fría. Si la omites, Loop envía los fondos a una dirección nueva de tu billetera de LND.

Paso 3: sigue el progreso del swap

loop monitor

El comando muestra en tiempo real el progreso del swap activo. Un Loop Out pasa por cuatro etapas y loop monitor muestra el estado en mayúsculas:

Tu nodo paga (INITIATED): tu nodo envía al servidor Loop dos pagos por Lightning que suman el importe del swap más la comisión de Loop. El servidor cobra un pequeño anticipo antes de bloquear bitcoins on-chain. Todavía no puede cobrar el resto porque desconoce el secreto que lo desbloquea.
Loop bloquea sus bitcoins (sigue en INITIATED): el servidor Loop bloquea el importe del swap on-chain en un HTLC, un contrato con bloqueo por hash y por tiempo. Sin --fast, puede esperar hasta 30 minutos antes de hacerlo para agrupar sus transacciones on-chain.
Tu nodo reclama los fondos (PREIMAGE_REVEALED): una vez que se confirma el HTLC, tu nodo transfiere los fondos on-chain a la dirección de destino. La transferencia revela el secreto, llamado preimagen.
Loop cobra (SUCCESS): el servidor usa la preimagen para cobrar el pago del swap. El estado cambia a SUCCESS cuando se confirma tu reclamación. Tu canal ya tiene más liquidez de entrada.

Un Loop Out de 500 000 sats en cuatro pasos que pasan de Lightning a la blockchain y de vuelta. Primero, en Lightning, tu nodo paga a Loop 500 000 sats más la comisión. Loop cobra un pequeño anticipo de inmediato, pero aún no puede cobrar el resto. El resto queda retenido. Segundo, on-chain, Loop bloquea 500 000 sats propios en un contrato on-chain, un HTLC, que solo puedes abrir con tu secreto antes de un plazo límite. Tercero, on-chain, una vez que se confirma el HTLC, tu nodo reclama los bitcoins a tu dirección y así revela el secreto. Cuarto, en Lightning, Loop usa el secreto para cobrar el pago retenido y el swap termina. loop monitor muestra INITIATED en los pasos 1 y 2, PREIMAGE_REVEALED en el paso 3 y SUCCESS en el paso 4. Si tu nodo no reclama los bitcoins antes del plazo, Loop los recupera, el pago retenido se cancela y Loop se queda con el anticipo. — **Loop solo puede cobrar tu pago después de que tu nodo haya reclamado los bitcoins.** Al reclamarlos, revelas el secreto que desbloquea el pago, así que ninguna parte puede quedarse con ambos. Si no usas --fast, Loop puede esperar hasta 30 minutos antes del paso 2 para agrupar sus transacciones on-chain.

El tiempo que tarda depende sobre todo de --conf_target. Loop busca que tu reclamación se confirme dentro de ese número de bloques desde que empieza el swap. Con 6, tarda alrededor de una hora, porque los bloques llegan en promedio cada 10 minutos.

Paso 4: verifica los resultados

Cuando termine el swap, comprueba los saldos de tus canales:

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

El canal que usaste para el swap debería mostrar un saldo local menor (liquidez de salida) y un saldo remoto mayor (liquidez de entrada).

Hacer un Loop In (on-chain → Lightning)

Loop In mueve bitcoin on-chain a tus canales de Lightning y recupera la liquidez de salida que agotaste al gastar.

Paso 1: pide una cotización

loop quote in 500000

Paso 2: ejecuta Loop In

loop in --amt 500000 --conf_target 6

Paso 3: el pago on-chain

Por defecto, Loop In paga el HTLC on-chain desde tu propia billetera de LND y te muestra la dirección para que puedas seguirlo. Para enviar el pago a esa dirección desde otra billetera, añade --external (sin --conf_target). Cuando la transacción on-chain se confirma, el servidor Loop te paga por Lightning y aumenta tu saldo en el canal.

loop monitor

El servidor Loop te paga por Lightning cuando tu transacción on-chain tiene una confirmación. Así que la espera depende de la tasa de comisión que elegiste. Con un --conf_target más alto, pagas menos y tardas más.

Funciones avanzadas de Loop

Autoloop: gestión automática de la liquidez

Autoloop es el modo automático de Loop que mantiene la liquidez de tus canales dentro de los límites que fijas. Defines unas reglas y Autoloop se encarga de ejecutar los swaps.

Define reglas de liquidez para un canal concreto:

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

Esta regla indica a Autoloop que inicie un Loop Out (el tipo predeterminado) cuando la liquidez de entrada del canal baje del 25 % de su capacidad. La liquidez de salida nunca baja del 25 % por el swap. Cada swap apunta al punto medio entre ambos límites. Para definir una regla que reponga la liquidez de salida con Loop In, añade --type=in.

Una regla de Autoloop con un límite de entrada del 25 % y otro de salida del 25 %, en un canal de 1 000 000 de sats. Antes, hay 900 000 sats de tu lado y 100 000 del otro, así que la liquidez de entrada es del 10 %, por debajo del 25 % que activa la regla. Autoloop saca 400 000 sats con Loop Out. Después, hay unos 500 000 en cada lado y la liquidez de entrada ronda el 50 %, a medio camino entre ambos límites. Autoloop nunca deja que tu lado baje del 25 %. Solo actúa cuando lo activas y respeta tu presupuesto de comisiones. — **Una regla 25/25 activa Loop Out si la liquidez de entrada baja del 25 % y apunta al punto medio.** Nunca deja que tu lado baje del 25 %. Una regla con --type=in funciona al revés. Repone tu lado con un Loop In cuando la liquidez de salida baja de su límite.

Configura los parámetros de Autoloop:

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

Parámetros:

--autobudget: máximo de sats que puedes gastar en comisiones de swap durante cada periodo del presupuesto.
--autobudgetrefreshperiod: cada cuánto se reinicia el presupuesto (168h = cada semana).
--feepercent: porcentaje máximo del importe de cada swap que pueden sumar todas sus comisiones. En un swap de 500 000 sats, el 1 % son 5000 sats.

Activa Autoloop:

loop setparams --autoloop=true

Comprueba el estado de Autoloop:

loop suggestswaps

El resultado muestra qué canales activarían swaps con tus reglas actuales.

Loop con Lightning Terminal

Si prefieres una interfaz gráfica, Lightning Terminal, la aplicación de Lightning Labs para Umbrel del método 1, lleva Loop integrado:

Abre Lightning Terminal y haz clic en Loop en la parte superior. Verás tus canales y sus saldos.
Mueve el control hacia la izquierda para un Loop Out o hacia el otro lado para un Loop In. También puedes elegir en qué canales quieres vaciar o rellenar tu lado.
Elige el importe con el control deslizante y selecciona Loop. Verás las comisiones antes de confirmar.
En las opciones adicionales, fija la velocidad de confirmación (más bloques, comisiones más bajas) y, para un Loop Out, una dirección, como la de tu almacenamiento en frío.
Haz clic en Submit y sigue el progreso del swap.

Lightning Terminal también permite configurar Autoloop con un presupuesto de comisiones por día, semana o mes. ThunderHub carece de integración con Loop. Su página de swaps usaba Boltz, que está sin conexión (consulta las alternativas a Loop más abajo).

Estrategias para optimizar las comisiones

Las comisiones de Loop tienen tres componentes: la comisión del servidor de swaps, que se paga a Lightning Labs, la comisión minera on-chain y, en un Loop Out, las comisiones de enrutamiento del pago de Lightning. La guía completa de comisiones de la red Lightning explica cómo funcionan en la red. Puedes reducir el costo de varias formas:

Lo que cuesta un Loop Out de 500 000 sats, siguiendo el recorrido del dinero. El pago sale de tu nodo por Lightning y pasa por otros nodos, que cobran comisiones de enrutamiento. --max_swap_routing_fee pone un tope a esas comisiones, que no aparecen en el total de la cotización. Loop se queda con la comisión del servicio, que fija para cada swap. Sube con las comisiones on-chain y --fast puede encarecerla. Loop bloquea los bitcoins en un contrato on-chain, un HTLC, y tu nodo los reclama a tu billetera. Para ello, paga una comisión a los mineros. Un --conf_target más alto cuesta menos y tarda más. La comisión es casi igual para cualquier importe. El anticipo forma parte de los 500 000 y no cuenta como comisión, salvo si el swap falla porque tu nodo nunca reclamó los bitcoins de Loop. Los swaps más grandes y menos frecuentes reparten la comisión minera entre más sats. — **Tres comisiones que pagas en tres puntos del recorrido.** La cotización de Loop muestra la comisión del servicio y la comisión minera. Las comisiones de enrutamiento del pago de Lightning se suman a esas dos. La minera es la que más puedes controlar.

Usa valores altos de conf_target: con --conf_target 144, el objetivo es confirmar al día siguiente, lo que reduce bastante la comisión on-chain. Si no te urge gestionar la liquidez, esto ahorra muchos sats.
Omite --fast: sin ese parámetro, el servidor Loop puede esperar hasta 30 minutos antes de publicar el HTLC para agrupar sus transacciones on-chain. Eso puede reducir la comisión del swap.
Vigila las comisiones on-chain: haz los swaps en momentos de comisiones bajas, durante el fin de semana o a primera hora. Comprueba el estado de la mempool antes de iniciar un swap.
Ajusta el importe de los swaps: la comisión minera para reclamar los bitcoins es casi igual con cualquier importe, así que los swaps muy pequeños resultan proporcionalmente caros. Intercambiar 500 000 sats o más por operación resulta proporcionalmente más barato que hacer swaps pequeños con frecuencia.

Alternativas a Loop

Hay más proveedores de swaps submarinos además de Loop. Conocer las alternativas te ayuda a elegir la herramienta que mejor encaje en tu situación:

Servicio	Proveedor	Importe mínimo del swap	Comisión habitual	Integración
Lightning Loop	Lightning Labs	Unos 250 000 sats para Loop Out (consulta `loop terms`)	Del 0,05 % al 0,5 % para Loop Out, del 0,1 % al 1 % para Loop In	Nativa en LND
PeerSwap	Comunidad	Variable	Comisiones on-chain más el recargo del otro nodo del canal	Complemento para CLN, proceso en segundo plano para LND

Boltz, un servicio de swaps sin custodia entre Lightning, Bitcoin on-chain y Liquid, solía ser la opción habitual para swaps pequeños desde cualquier billetera, con mínimos más bajos que Loop y sin cuenta. El 3 de agosto de 2026 suspendió todos sus swaps y seguía sin conexión cuando lo comprobamos el 8 de noviembre de 2026, así que ya no figura en la tabla. Las herramientas que lo usaban ya se adaptaron. RTL quitó sus páginas de Boltz en octubre de 2026 y ZEUS ahora ejecuta los swaps integrados a través de otros proveedores que usan el software de código abierto de Boltz. Si tu billetera lleva un servicio de swaps integrado, comprueba que funcione y prueba primero con un importe pequeño.

PeerSwap permite hacer swaps atómicos directamente entre los dos nodos de un canal, sin un servidor de terceros. Es la opción que menos confianza exige, pero el otro nodo del canal también tiene que ejecutar PeerSwap y aceptar swaps contigo. Sigue siendo software en fase beta y funciona como complemento para CLN o como proceso independiente junto a LND. Además de las comisiones on-chain, el otro nodo puede pedir un recargo. El valor predeterminado es del 0,2 % en un swap de salida y cero en uno de entrada (PeerSwap v7.0.2, comprobado el 8 de noviembre de 2026).

Cómo resolver problemas habituales

Swap atascado en el estado «Initiated»

El HTLC on-chain aún no se ha publicado. Sin --fast, el servidor Loop puede esperar hasta 30 minutos antes de publicarlo para agrupar sus transacciones on-chain. Dale ese tiempo. Si el swap no avanza, se agota el plazo y se cancela automáticamente. El importe del swap está a salvo. El protocolo de swap atómico garantiza que el pago principal se complete o se devuelva. La excepción es el pequeño anticipo. El servidor lo cobró al inicio del Loop Out y el swap atómico no lo protege, así que puede que no lo recuperes si el swap se atasca.

Comisiones altas en la cotización

Las comisiones de Loop suben en periodos de alta demanda y comisiones on-chain altas. Si la cotización te parece cara, espera a que bajen las comisiones on-chain o usa un conf_target más alto. Si tu billetera tiene su propio servicio de swaps, compara también su cotización.

Error «No Suitable Channels»

Loop Out necesita un canal con saldo de salida suficiente para financiar el swap. Si ningún canal tiene capacidad suficiente por sí solo, reduce el importe del swap o reequilibra tus canales primero con un reequilibrio circular.

Parte de nuestro curso gratuito de Bitcoin: la lección Cómo operar un nodo Lightning: gana sats y contribuye a la red, del curso Red Lightning y nodos de Bitcoin, trata este tema en profundidad.

Preguntas frecuentes

¿Puedo perder fondos en un swap de Loop?

El importe del swap no se pierde. Los swaps submarinos usan contratos con bloqueo por hash y por tiempo que hacen atómico el intercambio. El pago de Lightning y la transacción on-chain se completan ambos o se revierten ambos. Si se revierten, el importe del swap vuelve a donde estaba. Hay dos cosas que quedan fuera de esa protección. En un Loop Out, el servidor cobra un pequeño anticipo al principio. Loop se queda con él si ya bloqueó sus bitcoins on-chain y tu nodo no los reclama antes del plazo. También es posible que no recuperes el anticipo si el swap se abandona antes. Por eso, mantén loopd en ejecución hasta que se complete el swap. Las comisiones ya pagadas, como las comisiones de minería de un swap que acaba en reembolso, tampoco se recuperan.

¿Cuánto suele costar un Loop Out?

Ejecuta loop quote out --verbose 500000 para ver el precio actual. Lightning Labs publica un intervalo del 0,05 % al 0,5 % del importe para un Loop Out (comprobado el 8 de noviembre de 2026). Así, para 500 000 sats, la comisión del servicio va de 250 a 2500 sats. A eso se suman la comisión minera para reclamar los bitcoins, que depende de la mempool y del objetivo de confirmación, y las comisiones de enrutamiento del pago de Lightning. En el ejemplo calculado por Lightning Labs, un Loop Out de 300 000 sats costó 500 sats de comisión del servicio, 416 sats de comisión minera y 1153 sats de comisiones de enrutamiento.

¿Pueden usar Loop los nodos Core Lightning?

Lightning Loop está diseñado para LND y no admite CLN de forma nativa. En CLN, PeerSwap ofrece una gestión de liquidez parecida como complemento en fase beta, pero solo entre nodos de un canal que también lo ejecuten. Boltz, que funcionaba con cualquier implementación de Lightning, está sin conexión desde el 3 de agosto de 2026 (comprobado el 8 de noviembre de 2026). Si no haces un swap, cerrar el canal mueve el saldo on-chain a cambio de perder el canal y pagar una comisión minera.

¿Con qué frecuencia conviene usar Loop?

La frecuencia depende de tu volumen de pagos y de cómo uses los canales. Un nodo de enrutamiento con mucho volumen puede hacer swaps cada semana. Un nodo personal para gastar puede hacerlos una vez al mes o con menos frecuencia. Si usas Autoloop, el sistema decide cuándo ejecutarlos según los límites que hayas definido. Vigila los saldos y haz swaps cuando el desequilibrio afecte a tu capacidad para enrutar o gastar.

Categoría: Red Lightning y segunda capa