LND Stuck Payment Fix — HTLC Timeout Guide

Stuck HTLC? Step-by-step resolution for LND.

1. Find stuck HTLCs

lncli listchannels | python3 -c "import json,sys; [print(c['chan_id'][:8], len(c.get('pending_htlcs',[]))) for c in json.load(sys.stdin)['channels'] if c.get('pending_htlcs')]"

2. Check expiry vs current block height

lncli getinfo shows block_height. Compare to HTLC expiry_height. If expiry passed: auto-resolves. Otherwise wait or force-close.

3. Force-close (last resort, 24h+ stuck only)

lncli closechannel --force CHANNEL_POINT

This triggers 144-block CSV lockup. Funds return after ~24 hours.

Want a full audit?

$9 LND audit: HTLC analysis, graph staleness, fee policy, phantom liquidity. USDT TRC-20, done in 1 hour.

→ Service page