core-lightning/doc/lightning-withdraw.7.txt
Mark Beckwith 8f0ef1636f Added wallet related error codes
New codes: FUND_MAX_EXCEEDED, FUND_CANNOT_AFFORD, FUND_DUST_LIMIT_UNMET.

The error message "Cannot afford fee" was not exactly correct because
it would also occur if the amount requested could not be afforded.  So
I changed it to the more generic "Cannot afford transaction".

Other things:

* Fixed off-by-one satoshi in fundchannel manpage.
* Changed 'arror' to 'error' because we are not pirates.
2018-06-18 12:33:25 +02:00

56 lines
1.3 KiB
Plaintext

LIGHTNING-WITHDRAW(7)
====================
:doctype: manpage
NAME
----
lightning-withdraw - Command for withdrawing funds from the
internal wallet.
SYNOPSIS
--------
*withdraw* 'destination' 'satoshi'
DESCRIPTION
-----------
The *withdraw* RPC command sends funds from c-lightning's
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 (expressed, as name suggests, in satoshi).
The string 'all' can be used to specify withdrawal of all
available funds.
RETURN VALUE
------------
On success, an object with attributes 'tx' and 'txid' will
be returned.
'tx' represents the raw bitcoin, fully signed, transaction
and 'txid' represent the bitcoin transaction id.
On failure, an error is reported and the channel is not funded.
The following error codes may occur:
* -1. Catchall nonspecific error.
* 301. There are not enough funds in the internal wallet (including fees) to
create the transaction.
* 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)
RESOURCES
---------
Main web site: https://github.com/ElementsProject/lightning