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

What Is Channel Splicing in Eclair?

Splicing allows you to add or remove funds from an existing channel without closing it. Eclair supports splice-in (deposit) and splice-out (withdraw) via the experimental splicing protocol.

Common Errors

• splice rejected: feature not supported by peer
• splice_locked timeout: peer did not confirm splice
• insufficient funds for splice-out: reserve not met
• splice aborted: concurrent HTLC in flight

Fix: Check Peer Splice Support

# Eclair CLI - check peer features
eclair-cli peers | python3 -c "
import json,sys
for p in json.load(sys.stdin):
  feats = p.get('features',{})
  splice = 'splicing' in str(feats).lower()
  print(p['nodeId'][:16], 'splice:', splice)
"

Fix: Resolve HTLC Conflicts

# Wait for all pending HTLCs to resolve before splicing
eclair-cli channels | python3 -c "
import json,sys
for c in json.load(sys.stdin):
  htlcs = c.get('data',{}).get('commitments',{}).get('localCommit',{}).get('spec',{}).get('htlcs',[])
  if htlcs: print(c['channelId'][:16], len(htlcs), 'htlcs pending')
"

Initiate a Splice-In

# Add funds to existing channel
eclair-cli spliceIn --channelId=<channel_id> --amountSatoshis=500000

Initiate a Splice-Out

# Withdraw from channel to on-chain address
eclair-cli spliceOut --channelId=<channel_id> --amountSatoshis=200000 --scriptPubKey=<address>

Need help with Eclair splicing? DM on Nostr.