openchannel_abort

openchannel_abort -- Command to abort a channel to a peer

SYNOPSIS

openchannel_abort channel_id

DESCRIPTION

openchannel_abort is a low level RPC command which initiates an abort for specified channel. It uses the openchannel protocol which allows for interactive transaction construction.

  • channel_id (hash): Channel id of the channel to be aborted.

RETURN VALUE

On success, an object is returned, containing:

  • channel_id (hash): The channel id of the aborted channel.
  • channel_canceled (boolean): Whether this is completely canceled (there may be remaining in-flight transactions).
  • reason (string): Usually "Abort requested", but if it happened to fail at the same time it could be different.

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.
  • 305: Peer is not connected.
  • 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_signed(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_abort -k "channel_id"="channelid0111200111200111200111200111200111200111200111200111200"
{
  "id": "example:openchannel_abort#1",
  "method": "openchannel_abort",
  "params": {
    "channel_id": "channelid0111200111200111200111200111200111200111200111200111200"
  }
}

Response:

{
  "channel_id": "channelid0111200111200111200111200111200111200111200111200111200",
  "channel_canceled": false,
  "reason": "Abort requested"
}

Core Lightning is Blockstream's open-source implementation of the Lightning Network optimised for performance. It is highly customizable through modular expandability.

© 2023 Core Lightning
All rights reserved.

X Twitter Logo Streamline Icon: https://streamlinehq.com

X

The official Core Lightning X(Twitter) handle to follow project updates and announcements.

Github Logo 2 Streamline Icon: https://streamlinehq.com

Github

Github repository for source code, issues, and contributions. Visit our project here to explore or contibute.

Telegram

Community-driven telegram group where most of the node operators hang out. Go to https://t.me/lightningd to join.

Discord

Community-driven discord server where the devs flock together. Go to https://discord.gg/V6ay9yNhBQ to join.