"title":"Command to initiate a channel to a peer",
"warning":"experimental-splicing only",
"description":[
"`splice_init` is a low level RPC command which initiates a channel splice for a given channel specified by `channel_id`."
],
"request":{
"required":[
"channel_id",
"relative_amount"
],
"properties":{
"channel_id":{
"type":"hash",
"description":[
"The channel id of the channel to be spliced."
]
},
"relative_amount":{
"type":"integer",
"description":[
"A positive or negative amount of satoshis to add or subtract from the channel. Note you may need to add a double dash (--) after splice_init if using a negative *relative_amount* so it is not interpretted as a command modifier. For example: ```shell lightning-cli splice_init -- $CHANNEL_ID -100000 ```."
]
},
"initialpsbt":{
"type":"string",
"description":[
"The (optional) base 64 encoded PSBT to begin with. If not specified, one will be generated automatically."
]
},
"feerate_per_kw":{
"type":"u32",
"description":[
"The miner fee we promise our peer to pay for our side of the splice transaction. It is calculated by `feerate_per_kw` * our_bytes_in_splice_tx / 1000."
]
},
"force_feerate":{
"type":"boolean",
"description":[
"By default splices will fail if the fee provided looks too high. This is to protect against accidentally setting your fee higher than intended. Set `force_feerate` to true to skip this saftey check."
]
}
}
},
"response":{
"required":[
"psbt"
],
"properties":{
"psbt":{
"type":"string",
"description":[
"The (incomplete) PSBT of the splice transaction."
]
}
}
},
"example_usage":[
"Here is 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.",
"Here is an example set of splice commands that will splice out 100,000 sats from first channel that comes out of `listpeerchannels`. The example assumes you already have at least one confirmed channel.",
