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

FreeBSD Manual Pages

  
 
  

home | help
LIGHTNING-WITHDRAW(7)	      lightning-withdraw	 LIGHTNING-WITHDRAW(7)

NAME
       lightning-withdraw  -  Command  for withdrawing funds from the internal
       wallet

SYNOPSIS
       withdraw	destination satoshi [feerate] [minconf]	[utxos]

DESCRIPTION
       The withdraw RPC	command	sends funds from c-lightningas internal	wallet
       to the address specified	in destination.

       The address can be of any Bitcoin accepted type,	including bech32.

       satoshi	is  the	 amount	 to be withdrawn from the internal wallet (ex-
       pressed,	as name	suggests, in satoshi). The string all can be  used  to
       specify	withdrawal of all available funds. 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
       Felix _fixone@gmail.com>	is mainly responsible.

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

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

							 LIGHTNING-WITHDRAW(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-withdraw&sektion=7&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help