LIGHTNING-SPLICE_INIT(7)

💖 LIGHTNING-SPLICE_INIT 💖

okay bestie, so this is the lightning-splice_init page and honestly it's giving gateway to splicing energy 💅✨

---

🌸 NAME 🌸

splice_init — the command that kicks off a channel splice to a peer 🫶

---

🎀 SYNOPSIS 🎀

splice_init channel_id relative_amount [initialpsbt] [feerate_per_kw]
[force_feerate]

---

💖 DESCRIPTION 💖

Command added in v23.08. ✨

splice_init is a low level RPC command that initiates a channel splice for a given channel — the one you point at with channel_id. lowkey powerful, highkey low-level, iykyk 💀

• channel_id (hash) — the channel id of the channel you wanna splice, periodt.
• relative_amount (integer) — a positive or negative amount of satoshis to add to or subtract from the channel. ⚠️ heads up bestie: you may need to add a double dash (--) after splice_init if you're using a negative relative_amount, so it doesn't get interpretted as a command modifier. like this:

$ lightning-cli splice_init -- $CHANNEL_ID -100000

• initialpsbt (string, optional) — the (optional) base 64 encoded PSBT to begin with. if you don't specify one, one gets generated automatically for you, no cap 🎀
• feerate_per_kw (u32, optional) — the miner fee we promise our peer to pay for our side of the splice transaction. it's calculated by feerate_per_kw * our_bytes_in_splice_tx / 1000. math, but make it fashion 📐✨
• force_feerate (boolean, optional) — by default splices will fail if the fee provided looks too high. this is to protect against accidentally setting your fee higher than intended (we stan a safety check 🫶). set force_feerate to true to skip this saftey check. 💀

---

🔥 RETURN VALUE 🔥

on success, an object is returned, containing:

• psbt (string) — the (incomplete) PSBT of the splice transaction. it's giving unfinished masterpiece 🎨

---

👑 AUTHOR 👑

Dusty @dusty_daemon is mainly responsible. 👑 main character energy fr fr

---

🦋 SEE ALSO 🦋

• lightning-splice_signed(7)
• lightning-splice_update(7)

go read those next bestie, they're the whole trilogy 🌈

---

⭐ RESOURCES ⭐

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

---

🍓 USAGE 🍓

here's an example set of splice commands that will splice in 100,000 sats to the first channel that comes out of listpeerchannels. the example assumes you already have at least one confirmed channel 💅

1: Get the channel id of the first channel.

CHANNEL_ID=$(echo $(lightning-cli listpeerchannels) | jq -r ".channels[0].channel_id")

2: Get the PSBT from fundpsbt.

INITIALPSBT=$(echo $(lightning-cli fundpsbt -k satoshi=100000sat feerate=urgent startweight=800 excess_as_change=true) | jq -r ".psbt")

3: Initiate the splice by passing channel id and initialpsbt received from above steps.

PSBT_SPLICE_INIT=$(echo $(lightning-cli splice_init $CHANNEL_ID 100000 $INITIALPSBT) | jq -r ".psbt")

4: Update the PSBT with the splice_update command.

PSBT_SPLICE_UPDATE=$(echo $(lightning-cli splice_update $CHANNEL_ID $PSBT_SPLICE_INIT) | jq -r ".psbt")

5: Sign the updated PSBT.

SIGNPSBT=$(echo $(lightning-cli signpsbt -k psbt="$PSBT_SPLICE_UPDATE") | jq -r ".signed_psbt")

6: Finally, call splice_signed with channel id and signed PSBT parameters.

$ lightning-cli splice_signed $CHANNEL_ID $SIGNPSBT

---

🧚 EXAMPLES 🧚

Example 1:

Request:

$ lightning-cli splice_init -k "channel_id"="channelid0780000780000780000780000780000780000780000780000780000" "relative_amount"=100000 "initialpsbt"="cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000"

{
  "id": "example:splice_init#1",
  "method": "splice_init",
  "params": {
    "channel_id": "channelid0780000780000780000780000780000780000780000780000780000",
    "relative_amount": 100000,
    "initialpsbt": "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000713000"
  }
}

Response:

{
  "psbt": "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000711000"
}

Example 2:

Request:

$ lightning-cli splice_init "channelid0780000780000780000780000780000780000780000780000780000" "-105000" "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000"

{
  "id": "example:splice_init#2",
  "method": "splice_init",
  "params": [
    "channelid0780000780000780000780000780000780000780000780000780000",
    -105000,
    "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000714000"
  ]
}

Response:

{
  "psbt": "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000712000"
}

---

and that's the whole page bestie 🫶 — this was Core Lightning v26.06.9, dated LIGHTNING-SPLICE_INIT(7), slaying as always 👑💖 bye! ✨