2020-09-09 12:26:14 +02:00
|
|
|
lightning-multiwithdraw -- Command for withdrawing to multiple addresses
|
|
|
|
|
========================================================================
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
|
2022-01-26 18:18:49 +01:00
|
|
|
**multiwithdraw** *outputs* [*feerate*] [*minconf*] [*utxos*]
|
2020-09-09 12:26:14 +02:00
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
|
2022-04-06 07:09:48 +02:00
|
|
|
The **multiwithdraw** RPC command sends funds from Core Lightning's internal
|
2020-09-09 12:26:14 +02:00
|
|
|
wallet to the addresses specified in *outputs*,
|
|
|
|
|
which is an array containing objects of the form `{address: amount}`.
|
|
|
|
|
The `amount` may be the string *"all"*, indicating that all onchain funds
|
|
|
|
|
be sent to the specified 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
|
|
|
|
|
*urgent* (aim for next block), *normal* (next 4 blocks or so) or *slow*
|
2021-10-24 11:44:56 +02:00
|
|
|
(next 100 blocks or so) to use lightningd's internal estimates: *normal*
|
2020-09-09 12:26:14 +02:00
|
|
|
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. Omitting
|
|
|
|
|
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
|
|
|
|
|
------------
|
|
|
|
|
|
2021-06-16 03:10:17 +02:00
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-START)
|
|
|
|
|
On success, an object is returned, containing:
|
|
|
|
|
- **tx** (hex): The raw transaction which was sent
|
|
|
|
|
- **txid** (txid): The txid of the **tx**
|
2021-09-03 12:07:59 +02:00
|
|
|
|
2021-06-16 03:10:17 +02:00
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-END)
|
2020-09-09 12:26:14 +02:00
|
|
|
|
|
|
|
|
On failure, an error is reported and the withdrawal transaction is not
|
|
|
|
|
created.
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
------
|
|
|
|
|
|
2021-06-29 16:34:20 +02:00
|
|
|
ZmnSCPxj <<ZmnSCPxj@protonmail.com>> is mainly responsible.
|
2020-09-09 12:26:14 +02:00
|
|
|
|
|
|
|
|
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>
|
2022-07-13 17:45:39 +02:00
|
|
|
[comment]: # ( SHA256STAMP:1fe5147036f714c8f9185dd482a1bfa3e3ac5c4d0b6603fba1bc2b78de591b8f)
|
