openchannel_signed -- Command to conclude a channel open
SYNOPSIS
openchannel_signed channel_id signed_psbt
DESCRIPTION
openchannel_signed is a low level RPC command which concludes a channel open with the specified peer. It uses the v2 openchannel protocol, which allows for interactive transaction construction.
This command should be called after openchannel_update returns commitments_secured true.
This command will broadcast the finalized funding transaction, if we receive valid signatures from the peer.
- channel_id (hash): Id of the channel.
- signed_psbt (string): The PSBT returned from
openchannel_update(where commitments_secured was true) with partial signatures or finalized witness stacks included for every input that we contributed to the PSBT.
RETURN VALUE
On success, an object is returned, containing:
- channel_id (hash): The channel id of the channel.
- tx (hex): The funding transaction.
- txid (txid): The txid of the tx.
ERRORS
On error, the returned object will contain code and message properties, with code being one of the following:
- -32602: If the given parameters are wrong.
- -1: Catchall nonspecific error.
- 303: Funding transaction broadcast failed.
- 305: Peer is not connected.
- 309: PSBT missing required fields.
- 311: Unknown channel id.
- 312: Channel in an invalid state
AUTHOR
Lisa Neigut [email protected] is mainly responsible.
SEE ALSO
lightning-openchannel_init(7), lightning-openchannel_update(7), lightning-openchannel_abort(7), lightning-openchannel_bump(7), lightning-fundchannel_start(7), lightning-fundchannel_complete(7), lightning-fundchannel(7), lightning-fundpsbt(7), lightning-utxopsbt(7), lightning-multifundchannel(7)
RESOURCES
Main web site: https://github.com/ElementsProject/lightning
EXAMPLES
Example 1:
Request:
lightning-cli openchannel_signed -k "channel_id"="6ed0fa56ef2d9b805a6f7a389c3ac4eac30af9dfa9303508c75f077a75f23c79" "signed_psbt"="cHNidP8BAgQCAAAAAQMEogAAAAEEAQEBBQECAQYBAwH7BAIAAAAAAQBxAgAAAAEaYvzABO/Tmns/5Pj+Lu8mq0dBTwbgXn7sIOgQk3YHjgEAAAAA/f///wLlIfTSAAAAABYAFPJ2kvsnSXL4xIO6Sg17Xv463zn+AMLrCwAAAAAWABRK3/BFe6ndrO3PwSwcSEUCKwcapqEAAAABAR8AwusLAAAAABYAFErf8EV7qd2s7c/BLBxIRQIrBxqmIgICX8bedYC8/yBbGe4GFc6HDk79eIa2z4xeZ+Hav0EpbMNHMEQCICJsjfI3P4s1loubB4tFUcw0/GcUHjG8Ok6ZvAXzNuNQAiA4ZYh85tIjCLRsd/bHniDxBnm4gtHe4XMBCWbSD+OFegEiBgJfxt51gLz/IFsZ7gYVzocOTv14hrbPjF5n4dq/QSlswwhK3/BFAAAAAAEOIIsb3ULOUMbRMvbUNrl5Qwl4J4r8OFN6snLDF13hxp5JAQ8EAQAAAAEQBP3///8M/AlsaWdodG5pbmcBCI48H9MjBmYQAAEDCEFZ3AsAAAAAAQQiUSAhRMdFLywdQWRnadh7FjvXdHxnvH4DVNY84L97IMFBOiEH1uFZdChJrnh0JA7LYVkwZBWhFt6mDYHwlvWL+GneHoYJAFKisbEEAAAADPwJbGlnaHRuaW5nAQiQPB/TIwZmEAABAwhAQg8AAAAAAAEEIgAgZ39EM2qkj2R6eylrL3yjvBuWGjwmoGk+btb3KO6w1zkM/AlsaWdodG5pbmcBCL0EbgYVB9kiAA=="{
"id": "example:openchannel_signed#1",
"method": "openchannel_signed",
"params": {
"channel_id": "6ed0fa56ef2d9b805a6f7a389c3ac4eac30af9dfa9303508c75f077a75f23c79",
"signed_psbt": "cHNidP8BAgQCAAAAAQMEogAAAAEEAQEBBQECAQYBAwH7BAIAAAAAAQBxAgAAAAEaYvzABO/Tmns/5Pj+Lu8mq0dBTwbgXn7sIOgQk3YHjgEAAAAA/f///wLlIfTSAAAAABYAFPJ2kvsnSXL4xIO6Sg17Xv463zn+AMLrCwAAAAAWABRK3/BFe6ndrO3PwSwcSEUCKwcapqEAAAABAR8AwusLAAAAABYAFErf8EV7qd2s7c/BLBxIRQIrBxqmIgICX8bedYC8/yBbGe4GFc6HDk79eIa2z4xeZ+Hav0EpbMNHMEQCICJsjfI3P4s1loubB4tFUcw0/GcUHjG8Ok6ZvAXzNuNQAiA4ZYh85tIjCLRsd/bHniDxBnm4gtHe4XMBCWbSD+OFegEiBgJfxt51gLz/IFsZ7gYVzocOTv14hrbPjF5n4dq/QSlswwhK3/BFAAAAAAEOIIsb3ULOUMbRMvbUNrl5Qwl4J4r8OFN6snLDF13hxp5JAQ8EAQAAAAEQBP3///8M/AlsaWdodG5pbmcBCI48H9MjBmYQAAEDCEFZ3AsAAAAAAQQiUSAhRMdFLywdQWRnadh7FjvXdHxnvH4DVNY84L97IMFBOiEH1uFZdChJrnh0JA7LYVkwZBWhFt6mDYHwlvWL+GneHoYJAFKisbEEAAAADPwJbGlnaHRuaW5nAQiQPB/TIwZmEAABAwhAQg8AAAAAAAEEIgAgZ39EM2qkj2R6eylrL3yjvBuWGjwmoGk+btb3KO6w1zkM/AlsaWdodG5pbmcBCL0EbgYVB9kiAA=="
}
}Response:
{
"tx": "020000000001018b1bdd42ce50c6d132f6d436b979430978278afc38537ab272c3175de1c69e490100000000fdffffff024159dc0b000000002251202144c7452f2c1d41646769d87b163bd7747c67bc7e0354d63ce0bf7b20c1413a40420f0000000000220020677f44336aa48f647a7b296b2f7ca3bc1b961a3c26a0693e6ed6f728eeb0d739024730440220226c8df2373f8b35968b9b078b4551cc34fc67141e31bc3a4e99bc05f336e35002203865887ce6d22308b46c77f6c79e20f10679b882d1dee173010966d20fe3857a0121025fc6de7580bcff205b19ee0615ce870e4efd7886b6cf8c5e67e1dabf41296cc3a2000000",
"txid": "22bd4079635afdbc5bbbe144b545f3bc7f6522bb95d676d3cb76682913c5e111",
"channel_id": "6ed0fa56ef2d9b805a6f7a389c3ac4eac30af9dfa9303508c75f077a75f23c79"
}Example 2:
Request:
lightning-cli openchannel_signed "6ed0fa56ef2d9b805a6f7a389c3ac4eac30af9dfa9303508c75f077a75f23c79" "cHNidP8BAgQCAAAAAQMESgAAAAEEAQEBBQECAQYBAwH7BAIAAAAAAQBxAgAAAAEaYvzABO/Tmns/5Pj+Lu8mq0dBTwbgXn7sIOgQk3YHjgEAAAAA/f///wLlIfTSAAAAABYAFPJ2kvsnSXL4xIO6Sg17Xv463zn+AMLrCwAAAAAWABRK3/BFe6ndrO3PwSwcSEUCKwcapqEAAAABAR8AwusLAAAAABYAFErf8EV7qd2s7c/BLBxIRQIrBxqmIgICX8bedYC8/yBbGe4GFc6HDk79eIa2z4xeZ+Hav0EpbMNHMEQCICnFfMTyv12Ztg4YsV1KItsnWO5KJ810ppmU9IRGeKIuAiBCX8sdXk0LvJs+KuvBTbUy1YGElfeX+DWD8/P9ZlNI+AEiBgJfxt51gLz/IFsZ7gYVzocOTv14hrbPjF5n4dq/QSlswwhK3/BFAAAAAAEOIIsb3ULOUMbRMvbUNrl5Qwl4J4r8OFN6snLDF13hxp5JAQ8EAQAAAAEQBP3///8M/AlsaWdodG5pbmcBCJY8H9MjBmYQAAEDCGINzQsAAAAAAQQiUSBuCf3Q1/13sw9JPs2LmjXONgvYxW4ccMzjSpkfFXrqyCEHIruuJqWKR4a9Sdk4H+meCA3sVWo6sRVEPHdKVJk79SgJACMmCfcFAAAADPwJbGlnaHRuaW5nAQiYPB/TIwZmEAABAwiAhB4AAAAAAAEEIgAgZ39EM2qkj2R6eylrL3yjvBuWGjwmoGk+btb3KO6w1zkM/AlsaWdodG5pbmcBCL8EbgYVB9kiAA=="{
"id": "example:openchannel_signed#2",
"method": "openchannel_signed",
"params": [
"6ed0fa56ef2d9b805a6f7a389c3ac4eac30af9dfa9303508c75f077a75f23c79",
"cHNidP8BAgQCAAAAAQMESgAAAAEEAQEBBQECAQYBAwH7BAIAAAAAAQBxAgAAAAEaYvzABO/Tmns/5Pj+Lu8mq0dBTwbgXn7sIOgQk3YHjgEAAAAA/f///wLlIfTSAAAAABYAFPJ2kvsnSXL4xIO6Sg17Xv463zn+AMLrCwAAAAAWABRK3/BFe6ndrO3PwSwcSEUCKwcapqEAAAABAR8AwusLAAAAABYAFErf8EV7qd2s7c/BLBxIRQIrBxqmIgICX8bedYC8/yBbGe4GFc6HDk79eIa2z4xeZ+Hav0EpbMNHMEQCICnFfMTyv12Ztg4YsV1KItsnWO5KJ810ppmU9IRGeKIuAiBCX8sdXk0LvJs+KuvBTbUy1YGElfeX+DWD8/P9ZlNI+AEiBgJfxt51gLz/IFsZ7gYVzocOTv14hrbPjF5n4dq/QSlswwhK3/BFAAAAAAEOIIsb3ULOUMbRMvbUNrl5Qwl4J4r8OFN6snLDF13hxp5JAQ8EAQAAAAEQBP3///8M/AlsaWdodG5pbmcBCJY8H9MjBmYQAAEDCGINzQsAAAAAAQQiUSBuCf3Q1/13sw9JPs2LmjXONgvYxW4ccMzjSpkfFXrqyCEHIruuJqWKR4a9Sdk4H+meCA3sVWo6sRVEPHdKVJk79SgJACMmCfcFAAAADPwJbGlnaHRuaW5nAQiYPB/TIwZmEAABAwiAhB4AAAAAAAEEIgAgZ39EM2qkj2R6eylrL3yjvBuWGjwmoGk+btb3KO6w1zkM/AlsaWdodG5pbmcBCL8EbgYVB9kiAA=="
]
}Response:
{
"tx": "020000000001018b1bdd42ce50c6d132f6d436b979430978278afc38537ab272c3175de1c69e490100000000fdffffff02620dcd0b000000002251206e09fdd0d7fd77b30f493ecd8b9a35ce360bd8c56e1c70cce34a991f157aeac880841e0000000000220020677f44336aa48f647a7b296b2f7ca3bc1b961a3c26a0693e6ed6f728eeb0d73902473044022029c57cc4f2bf5d99b60e18b15d4a22db2758ee4a27cd74a69994f4844678a22e0220425fcb1d5e4d0bbc9b3e2aebc14db532d5818495f797f83583f3f3fd665348f80121025fc6de7580bcff205b19ee0615ce870e4efd7886b6cf8c5e67e1dabf41296cc34a000000",
"txid": "adb534d97dfb0727398191d2c47ce4ae402bd945ce67a1d5583f0b3c8b4b3cea",
"channel_id": "6ed0fa56ef2d9b805a6f7a389c3ac4eac30af9dfa9303508c75f077a75f23c79"
}