Lightning Loop 流動性服務

Loop Out: Lightning -> On-chain

使用場景：

問題：出站容量用盡，無法發送支付

通道狀態：
  本地（你）: 100,000 sats
  遠端（對方）: 900,000 sats  <- 大部分在對方

解決方案：Loop Out 將閃電資金轉到鏈上

流程：

  You             Loop Server            Blockchain
   |                  |                      |
   | 1. Request Loop Out                     |
   |----------------->|                      |
   |                  |                      |
   | 2. Receive HTLC terms                   |
   |<-----------------|                      |
   |                  |                      |
   | 3. Lightning payment (locked)           |
   |=================>|                      |
   |                  |                      |
   |                  | 4. On-chain tx       |
   |                  |--------------------->|
   |                  |                      |
   |                  | 5. Tx confirmed      |
   |<-----------------------------------------|
   |                  |                      |
   | 6. Reveal preimage, complete swap       |
   |=================>|                      |

結果：
• 閃電通道：獲得出站容量
• 鏈上錢包：收到比特幣
• 通道不需要關閉

Loop In: On-chain -> Lightning

使用場景：

問題：入站容量不足，無法接收支付

通道狀態：
  本地（你）: 900,000 sats  <- 大部分在你
  遠端（對方）: 100,000 sats

解決方案：Loop In 將鏈上資金轉到閃電

流程：

  You             Loop Server            Blockchain
   |                  |                      |
   | 1. Request Loop In                      |
   |----------------->|                      |
   |                  |                      |
   | 2. Receive HTLC address                 |
   |<-----------------|                      |
   |                  |                      |
   | 3. Send on-chain tx                     |
   |------------------------------------------->
   |                  |                      |
   |                  | 4. After confirmation|
   |                  |<---------------------|
   |                  |                      |
   | 5. Lightning payment                    |
   |<=================|                      |
   |                  |                      |
   | 6. Reveal preimage                      |
   |=================>|                      |

結果：
• 閃電通道：獲得入站容量
• 鏈上錢包：減少比特幣
• 本地餘額增加

Loop 費用組成：

Loop Out 費用：

1. Loop 服務費：
   交換金額的百分比（約 0.1% - 0.5%）

2. 閃電路由費：
   支付路徑上的節點費用

3. 鏈上礦工費：
   Loop 服務器支付，計入總費用

範例（Loop Out 100,000 sats）：
• 服務費：~300 sats
• 路由費：~10 sats
• 礦工費：~500 sats（取決於費率）
• 總計：~810 sats

Loop In 費用：

1. Loop 服務費：
   通常低於 Loop Out

2. 你支付的鏈上礦工費：
   發送到 HTLC 地址的交易費

3. 閃電路由費：
   Loop 服務器支付給你的路徑費用

費用查詢：
# 查看當前費用
loop quote out 100000
loop quote in 100000

Loop CLI 命令：

安裝：
# 通常與 LND 一起安裝
# 或獨立安裝 loopd

查看報價：
# Loop Out 報價
loop quote out <amount_sats>

# Loop In 報價
loop quote in <amount_sats>

執行 Loop Out：
loop out \
  --amt <amount_sats> \
  --channel <channel_id> \   # 指定通道
  --addr <btc_address> \      # 接收地址
  --conf_target 6              # 確認目標

執行 Loop In：
loop in \
  --amt <amount_sats> \
  --last_hop <pubkey>          # 指定最後一跳

查看狀態：
# 列出進行中的 swap
loop listswaps

# 查看特定 swap
loop swapinfo <swap_id>

自動化：
# 自動 Loop（Autoloop）
loop setparams \
  --autoloop=true \
  --autobudget=100000 \
  --autoout=true

Autoloop 自動流動性管理：

工作原理：

loopd 持續監控通道餘額：

規則範例：
• 如果本地餘額 > 80%：觸發 Loop Out
• 如果本地餘額 < 20%：觸發 Loop In
• 預算限制：每月最多 X sats

自動執行 swap 保持通道平衡

配置：
loop setparams \
  --autoloop=true \
  --autobudget=500000 \        # 月預算
  --autobudgetrefreshsec=2592000 \ # 30 天刷新
  --autoout=true \             # 啟用自動 Loop Out
  --autoin=true \              # 啟用自動 Loop In
  --autohtlcconfirmations=3    # HTLC 確認數

通道規則：
# 為特定通道設置目標
loop setrule <channel_id> \
  --target_incoming=50 \      # 目標入站比例
  --target_outgoing=50         # 目標出站比例

查看建議：
# 查看 autoloop 會執行什麼
loop suggestswaps

Loop 安全機制：

原子交換保證：

HTLC 鏈接：
• 閃電 HTLC 和鏈上 HTLC 使用相同 hash
• 只有知道 preimage 才能領取兩邊
• 超時後資金自動退回

可能的結果：
• 成功：雙方都完成交換
• 超時：雙方都退回原狀
• 不可能：一方得到兩份

超時設置：

Loop Out：
• 鏈上 HTLC 超時：較長（保護用戶）
• 閃電 HTLC 超時：較短

Loop In：
• 鏈上 HTLC 超時：用戶設定
• 閃電 HTLC 超時：服務器設定

風險：
• 服務器不可用 -> swap 超時退回
• 鏈上擁堵 -> 可能需要等待更長
• 閃電路由失敗 -> 需要重試