Eclair Splicing Errors - Fix Splice-In and Splice-Out Issues

Eclair Splicing Errors - Fix Splice-In and Splice-Out Issues


What Is Eclair Channel Splicing?

Splicing allows you to add or remove funds from a Lightning channel without closing it. Eclair supports splice-in (add on-chain funds) and splice-out (withdraw to on-chain) via the BOLT splicing spec.

Common Errors

  • splice not supported by peer
  • invalid splice_init: funding amount too low
  • splice_locked timeout: peer did not confirm
  • cannot splice: channel not in NORMAL state

Check Splice Support

# Eclair CLI
eclair-cli channelinfo --channelId <id> | grep features

# Both peers must advertise option_splice
# Check peer features in connection log

Initiate a Splice-In

eclair-cli splicein \
  --channelId <channel_id> \
  --amountIn 500000

# amountIn in satoshis to add from on-chain wallet

Initiate a Splice-Out

eclair-cli spliceout \
  --channelId <channel_id> \
  --amountOut 200000 \
  --scriptPubKey <on-chain-address-script>

Fix: Channel Not in NORMAL State

# Wait for any pending HTLCs to resolve
eclair-cli channelinfo --channelId <id> | grep state

# State must be NORMAL before splicing
# If SYNCING, wait for peer reconnection

Need help with Eclair splicing? DM on Nostr for troubleshooting.

Report Page