"title":"Command to update a collab channel open",
"description":[
"`openchannel_update` is a low level RPC command which continues an open channel, as specified by *channel_id*. An updated *psbt* is passed in; any changes from the PSBT last returned (either from `openchannel_init` or a previous call to `openchannel_update`) will be communicated to the peer.",
"",
"Must be called after `openchannel_init` and before `openchannel_signed`.",
"",
"Must be called until *commitments_secured* is returned as true, at which point `openchannel_signed` should be called with a signed version of the PSBT returned by the last call to `openchannel_update`."
],
"request":{
"required":[
"channel_id",
"psbt"
],
"properties":{
"channel_id":{
"type":"hash",
"description":[
"Id of the channel."
]
},
"psbt":{
"type":"string",
"description":[
"Updated PSBT to be sent to the peer. May be identical to the PSBT last returned by either `openchannel_init` or `openchannel_update`."
]
}
}
},
"response":{
"required":[
"channel_id",
"psbt",
"commitments_secured",
"channel_type",
"funding_outnum"
],
"properties":{
"channel_id":{
"type":"hash",
"description":[
"The channel id of the channel."
]
},
"channel_type":{
"type":"object",
"description":[
"Channel_type as negotiated with peer."
],
"added":"v24.02",
"additionalProperties":false,
"required":[
"bits",
"names"
],
"properties":{
"bits":{
"type":"array",
"description":[
"Each bit set in this channel_type."
],
"added":"v24.02",
"items":{
"type":"u32",
"description":[
"Bit number."
]
}
},
"names":{
"type":"array",
"description":[
"Feature name for each bit set in this channel_type."
],
"added":"v24.02",
"items":{
"type":"string",
"enum":[
"static_remotekey/even",
"anchor_outputs/even",
"anchors_zero_fee_htlc_tx/even",
"scid_alias/even",
"zeroconf/even"
],
"description":[
"Name of feature bit."
]
}
}
}
},
"psbt":{
"type":"string",
"description":[
"The PSBT of the funding transaction."
]
},
"commitments_secured":{
"type":"boolean",
"description":[
"Whether the *psbt* is complete (if true, sign *psbt* and call `openchannel_signed` to complete the channel open)."
]
},
"funding_outnum":{
"type":"u32",
"description":[
"The index of the funding output in the psbt."
]
},
"close_to":{
"type":"hex",
"description":[
"Scriptpubkey which we have to close to if we mutual close."
]
},
"requires_confirmed_inputs":{
"type":"boolean",
"description":[
"Does peer require confirmed inputs in psbt?"
]
}
},
"allOf":[
{
"if":{
"properties":{
"commitments_secured":{
"type":"boolean",
"enum":[
true
]
}
}
},
"then":{
"additionalProperties":true,
"required":[
"channel_id",
"funding_outnum"
],
"properties":{
"commitments_secured":{},
"channel_id":{
"type":"hash",
"description":[
"The derived channel id."
]
},
"close_to":{
"type":"hex",
"description":[
"If a `close_to` address was provided to `openchannel_init` and the peer supports `option_upfront_shutdownscript`."
]
},
"funding_outnum":{
"type":"u32",
"description":[
"The index of the funding output for this channel in the funding transaction."
]
}
}
},
"else":{
"additionalProperties":false,
"properties":{
"commitments_secured":{}
}
}
}
]
},
"errors":[
"On error, the returned object will contain `code` and `message` properties,",
