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

What Is Eclair Channel Splicing?

Splicing lets you add or remove funds from an existing Lightning channel without closing it. Eclair supports splice-in (add funds) and splice-out (withdraw funds on-chain) via interactive tx construction.

Common Errors

• splice not supported by peer
• InvalidSpliceRequest: insufficient funds
• SpliceFailed: remote did not send splice_ack
• channel not in NORMAL state, cannot splice

Check Peer Splice Support

# Eclair API: check peer features
curl -u :password http://localhost:8080/peers | python3 -c "
import json,sys
for p in json.load(sys.stdin):
  feats = p.get('features',{})
  splice = 'splice_prototype' in str(feats) or '0x229' in str(feats)
  print(p['nodeId'][:20], 'splice:', splice)
"

Trigger a Splice-In

# Add 100000 sats to existing channel
curl -u :password -X POST http://localhost:8080/splice \
  -d channelId=<channel_id> \
  -d amountIn=100000 \
  -d amountOut=0 \
  -d lockTime=0

Trigger a Splice-Out

# Withdraw 50000 sats to on-chain address
curl -u :password -X POST http://localhost:8080/splice \
  -d channelId=<channel_id> \
  -d amountIn=0 \
  -d amountOut=50000 \
  -d scriptPubKey=<your_address>

Troubleshooting

• Peer must also run Eclair or a splice-compatible implementation
• Channel must be in NORMAL state (not closing or offline)
• Requires sufficient on-chain wallet balance for splice-in
• Splice tx must confirm before channel resumes routing

Need help with Eclair splicing? DM on Nostr.