Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LIGHTNING-MULTIWITHDRAW(7)  lightning-multiwithdraw LIGHTNING-MULTIWITHDRAW(7)

NAME
       lightning-multiwithdraw - Command for withdrawing to multiple addresses

SYNOPSIS
       multiwithdraw outputs  [feerate]	[minconf] [utxos]

DESCRIPTION
       The  multiwithdraw  RPC command sends funds from	c-lightningas internal
       wallet to the addresses specified in outputs, which is  an  array  con-
       taining	objects	 of the	form {address: amount}.	 The amount may	be the
       string "all", indicating	that all onchain funds be sent to  the	speci-
       fied address.  Otherwise, it is in satoshi precision; it	can be a whole
       number, a whole number ending in	sat, a whole number ending in 000msat,
       or a number with	1 to 8 decimal places ending in	btc.

       feerate is an optional feerate to use. It can be	one of the strings ur-
       gent (aim for next block), normal (next 4 blocks	or so) or  slow	 (next
       100 blocks or so) to use	lightningdas internal estimates: normal	is the
       default.

       Otherwise, feerate is a number, with an optional	 suffix:  perkw	 means
       the  number  is interpreted as satoshi-per-kilosipa (weight), and perkb
       means it	is interpreted bitcoind-style as  satoshi-per-kilobyte.	 Omit-
       ting the	suffix is equivalent to	perkb.

       minconf specifies the minimum number of confirmations that used outputs
       should have. Default is 1.

       utxos specifies the utxos to be used to be withdrawn from, as an	 array
       of "txid:vout". These must be drawn from	the node's available UTXO set.

RETURN VALUE
       On success, an object with attributes tx	and txid will be returned.

       tx  represents the raw bitcoin, fully signed, transaction and txid rep-
       resent the bitcoin transaction id.

       On failure, an error is reported	and the	withdrawal transaction is  not
       created.

       The following error codes may occur:

	      o	     -1: Catchall nonspecific error.

	      o	     301:  There  are  not enough funds	in the internal	wallet
		     (including	fees) to create	the transaction.

	      o	     302: The dust limit is not	met.

AUTHOR
       ZmnSCPxj	< ZmnSCPxj@protonmail.com > is mainly responsible.

SEE ALSO
       lightning-listfunds(7), lightning-fundchannel(7), lightning-newaddr(7),
       lightning-txprepare(7), lightning-withdraw(7).

RESOURCES
       Main web	site: https://github.com/ElementsProject/lightning

						    LIGHTNING-MULTIWITHDRAW(7)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | AUTHOR | SEE ALSO | RESOURCES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=lightning-multiwithdraw&sektion=7&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help