LIGHTNING-SPLICEOUT(7)

📦
version 26.06.9 · 2 versions
, in nixpkgs unstable

💸 LIGHTNING-SPLICEOUT(7) — ok so we're yeeting sats out of a channel

bestie, this is lightning-spliceout, a manual page, and it's giving "moving money on purpose." Buckle up 🎀

✨ NAME ✨

spliceout — the command to splice funds out of a channel 💅

🦋 SYNOPSIS 🦋

spliceout channel amount [destination] [force_feerate]

🌸 DESCRIPTION 🌸

Okay so first things first: this command was added in v26.04, so if you're on something ancient, that's why it's not answering you 🙈

And here's the official word: spliceout is the command to move funds into a channel. (That's literally what the page says, bestie — we just report it 💀)

The arguments, one by one, no skips:

  • channel (string) — a channel identifier or a channel query. Same format as the one used in dev-splice, so no new muscle memory needed ✨
  • amount (string) — the amount in satoshis taken from the channel. Again, same format as used in dev-splice.
  • destination (string, optional) — where the funds go. Defaults to wallet, which sends the funds to your onchain wallet 👛. Give it a bitcoin address and the funds go to that address instead. Give it a channel identifier and the funds go to another channel. Format is the same as used in dev-splice, iykyk.
  • force_feerate (boolean, optional) — by default, splices fail if the fee provided looks too high. This exists to protect you from accidentally setting your fee higher than you meant to, which, oop 😭. Set force_feerate to true to skip this saftey check.
Listen. That fee check is there for a reason. It's the seatbelt. Don't unbuckle it unless you truly mean it 🔥

👑 RETURN VALUE 👑

On success, you get an object back, and it contains:

  • psbt (string, optional) — the final psbt
  • tx (string, optional) — the final transaction in hex
  • txid (string, optional) — the txid of the final transaction

Three little optional besties. That's the bag 🫶

🧚 AUTHOR 🧚

Dusty @dusty_daemon is mainly responsible. Iconic behavior, no notes 💖

🌈 SEE ALSO 🌈

⭐ RESOURCES ⭐

Main web site: https://github.com/ElementsProject/lightning

🔥 USAGE 🔥

Okay so the actual vibe: spliceout is the command to take funds from a channel. It takes amount funds from the specified channel and puts them somewhere. That's the whole bit 💫

The default destination is your onchain wallet. By specifying the destination as a bitcoin address, the funds will be sent to the specified address. By specifying the destination as a channel identifier, the funds will be sent to the specified channel. This accomplishes a simple "cross-splice" — literally so satisfying to watch 🎀

The fee for the transaction will be taken from channel funds. Noted, filed, remembered 🧠✨

and that's the page, bestie — go forth and splice responsibly 💅

this lil masterpiece ships with Core Lightning v26.06.9, and it's the LIGHTNING-SPLICEOUT(7) manual page, so you'll always know exactly which door you walked through 🦋💜

📦 where this page comes from