Skip to content

closechannel

dcrlncli closechannel - Close an existing channel.

Usage

   dcrlncli closechannel [command options] funding_txid [output_index]

Description

Close an existing channel. The channel can be closed either cooperatively, or unilaterally --force.

A unilateral channel closure means that the latest commitment transaction will be broadcast to the network. As a result, any settled funds will be time locked for a few blocks before they can be spent.

In the case of a cooperative closure, One can manually set the fee to be used for the closing transaction via either the --conf_target or --atoms_per_byte arguments. This will be the starting value used during fee negotiation. This is optional.

To view which funding_txids or output_indexes can be used for a channel close, see the channel_point values within the listchannels command output. The format for a channel_point is funding_txid:output_index.

Options

Option Info
--funding_txid value The txid of the channel’s funding transaction
--output_index value The output index for the funding output of the funding transaction (default: 0)
--force Attempt an uncooperative closure
--block Block until the channel is closed
--conf_target value (Optional) The number of blocks that the transaction should confirm in, will be used for fee estimation (default: 0)
--atoms_per_byte value (Optional) A manual fee expressed in atom/byte that should be used when crafting the transaction (default: 0)