multiwithdraw -- Command for withdrawing to multiple addresses
SYNOPSIS
multiwithdraw outputs [feerate] [minconf] [utxos]
DESCRIPTION
The multiwithdraw RPC command sends funds from Core Lightning's internal wallet to the addresses specified in outputs.
- outputs (array of outputdescs): An array containing objects of the form
{address: amount}. Theamountmay 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.:- (outputdesc, optional)
- feerate (feerate, optional): Feerate used for the withdrawals. See NOTES in lightning-feerates(7) for possible values. The default is normal.
- minconf (u32, optional): Minimum number of confirmations that used outputs should have. The default is 1.
- utxos (array of outpoints, optional):
- (outpoint, optional): 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.
- (outpoint, optional): Utxos to be used to be withdrawn from, as an array of
RETURN VALUE
On success, an object is returned, containing:
- tx (hex): The raw transaction which was sent.
- txid (txid): The txid of the tx.
ERRORS
On failure, an error is reported and the withdrawal transaction is not created.
- -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
ZmnSCPxj [email protected] 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
EXAMPLES
Example 1:
Request:
lightning-cli multiwithdraw -k "outputs"='[{"bcrt1qns45s47jmuf4nqr8azkd09gg5zw432v797hvkn": "2222000msat"}, {"bcrt1qp456dsxx6gd6w2ga0x4xhhy8c4lpe05mffzns3": "3333000msat"}]' "utxos"='["3b91271a226af9df1e9bbc03bac9ef300f2702f6b46803e1d94aa58849591890:0", "73ac468dcaccc3d69f7f6977958d2b4cb86f27c22ba1456ee273cb31591c76d3:0", "88c5963d6e1b0790375d5ce51c7fdd58b9b241c104754d2b704aee8cbdc5e7b5:1", "dc446777a9b3d6d5962f502f5d22f66b01452389c1bbe8460491e7376f44a1eb:0", "fbaf109442b357d7330d4ec8b5e9fb7c832a03c16acde0acd369a80db9fce5eb:0"]'{
"id": "example:multiwithdraw#1",
"method": "multiwithdraw",
"params": {
"outputs": [
{
"bcrt1qns45s47jmuf4nqr8azkd09gg5zw432v797hvkn": "2222000msat"
},
{
"bcrt1qp456dsxx6gd6w2ga0x4xhhy8c4lpe05mffzns3": "3333000msat"
}
],
"utxos": [
"3b91271a226af9df1e9bbc03bac9ef300f2702f6b46803e1d94aa58849591890:0",
"73ac468dcaccc3d69f7f6977958d2b4cb86f27c22ba1456ee273cb31591c76d3:0",
"88c5963d6e1b0790375d5ce51c7fdd58b9b241c104754d2b704aee8cbdc5e7b5:1",
"dc446777a9b3d6d5962f502f5d22f66b01452389c1bbe8460491e7376f44a1eb:0",
"fbaf109442b357d7330d4ec8b5e9fb7c832a03c16acde0acd369a80db9fce5eb:0"
]
}
}Response:
{
"tx": "020000000001059018594988a54ad9e10368b4f602270f30efc9ba03bc9b1edff96a221a27913b0000000000fdffffffd3761c5931cb73e26e45a12bc2276fb84c2b8d9577697f9fd6c3ccca8d46ac730000000000fdffffffb5e7c5bd8cee4a702b4d7504c141b2b958dd7f1ce55c5d3790071b6e3d96c5880100000000fdffffffeba1446f37e7910446e8bbc1892345016bf6225d2f502f96d5d6b3a9776744dc0000000000fdffffffebe5fcb90da869d3ace0cd6ac1032a837cfbe9b5c84e0d33d757b3429410affb0000000000fdffffff04ae080000000000001600149c2b4857d2df13598067e8acd79508a09d58a99ef2ee1f0c000000002251202ab3adb880519a5732472961e1390696b80348919bfd199e2df2f72b1f859042050d0000000000001600140d69a6c0c6d21ba7291d79aa6bdc87c57e1cbe9ba8610000000000002251206cf1dba6969a1debda0517436b77130526e82f6274b0be58d793a59d93c2a6f90140c5221a0ad0a074835b790e7ebcf2ee355302c3a637849ae3e054a09d980060f4be6ba90e9ba1ce80814bbad9eb153fe27df7f70a28845e6395d4c97dd56b18bb0247304402201ed0af18a5906e6d4a796e90abc40ea8f4aed17f62cadeb13f09ea375522914a022054ebe6267f3a23617ea28285e0a9563c4f47a14bcfbc56cb1f492e1d8d52f696012103c5d701f1940388572500a95225afa67b50ff03c38b9c9b33173e2f9d17d5a54a0140d3d0de2b41abf8b5e2187d87b4a2b7dacc4b7b01a748a53ba8197c8bf1c20ed24a04641bb93bfb04a10f126e7337667743f02390e267fd97106ff4bd64bfc1ac014069c067302591de04192df1d52a96a6e04a61fd8ffe5406ce3e5111abd35a0349fd5f19db3b80ef202b702031b0b60eafffcca8a110332bfec32e1c14dca6a4de024730440220571393a9747496371127d83663a3b439f2f29937dff193ddd6f00df36e8586c002201552b364cb5509c57062a80d5c28b2bc9aa2cb56d03b9fe3c3663cb8e59269650121034df804f92ee77a88102ceedc645c2210bbd04350d6e426b6e501e8f556586c5d92000000",
"txid": "71970302962a7b051a558dd18974ddda042860b1550141c0a4dd7d7710c25571"
}Example 2:
Request:
lightning-cli multiwithdraw -k "outputs"='[{"bcrt1pdk37mwl3zqvfag8t0j27rr2w4ns6whgcc4tczw64w3dmsckwedaqnppfvn": 1000}, {"bcrt1qunncjk3vmakww704ccszexw78cankdhgkj35qz": 1000}, {"bcrt1q990egft7752dasld04z5n38wycawzm5yxkv7ra": 1000}, {"bcrt1q9de2vn9lr6vz3c3hkvs9d0exvw9ty72z3dcrl0": 1000}, {"bcrt1q59qr4f77dfa8n6yeghmdjtu399lhn4ey8q8gta": 1000}, {"bcrt1pp9vda67u3tsp7jhjc2s6kp2z8ceq4wjfsc7susmkh49pek295zgslzuw27": 1000}, {"bcrt1qcy7lnzsf7c58mcmmuq95m22wvegnsssqmp6tuf": 1000}]' "utxos"='["71970302962a7b051a558dd18974ddda042860b1550141c0a4dd7d7710c25571:1", "71970302962a7b051a558dd18974ddda042860b1550141c0a4dd7d7710c25571:3"]'{
"id": "example:multiwithdraw#2",
"method": "multiwithdraw",
"params": {
"outputs": [
{
"bcrt1pdk37mwl3zqvfag8t0j27rr2w4ns6whgcc4tczw64w3dmsckwedaqnppfvn": 1000
},
{
"bcrt1qunncjk3vmakww704ccszexw78cankdhgkj35qz": 1000
},
{
"bcrt1q990egft7752dasld04z5n38wycawzm5yxkv7ra": 1000
},
{
"bcrt1q9de2vn9lr6vz3c3hkvs9d0exvw9ty72z3dcrl0": 1000
},
{
"bcrt1q59qr4f77dfa8n6yeghmdjtu399lhn4ey8q8gta": 1000
},
{
"bcrt1pp9vda67u3tsp7jhjc2s6kp2z8ceq4wjfsc7susmkh49pek295zgslzuw27": 1000
},
{
"bcrt1qcy7lnzsf7c58mcmmuq95m22wvegnsssqmp6tuf": 1000
}
],
"utxos": [
"71970302962a7b051a558dd18974ddda042860b1550141c0a4dd7d7710c25571:1",
"71970302962a7b051a558dd18974ddda042860b1550141c0a4dd7d7710c25571:3"
]
}
}Response:
{
"tx": "020000000001027155c210777ddda4c0410155b1602804dadd7489d18d551a057b2a96020397710100000000fdffffff7155c210777ddda4c0410155b1602804dadd7489d18d551a057b2a96020397710300000000fdffffff09e8030000000000002251206da3edbbf110189ea0eb7c95e18d4eace1a75d18c557813b55745bb862cecb7a939e1f0c00000000225120d2d0f24d9a3e596e2fbc0819e8894c83c5c583eb862d90156a5e129239194dd5e8030000000000002251200958deebdc8ae01f4af2c2a1ab05423e320aba49863d0e4376bd4a1cd945a091e803000000000000160014a1403aa7de6a7a79e89945f6d92f91297f79d724e803000000000000160014c13df98a09f6287de37be00b4da94e6651384200e8030000000000001600142b72a64cbf1e9828e237b32056bf26638ab27942e803000000000000160014295f94257ef514dec3ed7d4549c4ee263ae16e84e803000000000000160014e4e7895a2cdf6ce779f5c6202c99de3e3b3b36e8a861000000000000225120182af728bb638b6402708b0031f4aa2544e94acdd63d1381eb7e207d6ba8d9980140c703062d1944c9e25241a6bf93cf2acd1098ef2114673b764772c300c0b84dbaf9ecc83926957c66028b4864ba36fb70ac7b5cdeb97af1026524f36df57e4df90140eeca498286784f47326ff2c3f437834dc9e740e04ccfa8ed9a50cf85e1206f7740f00747f45e3c6c6e57384ea24b1dda8baa515f405390929c84f25c167773e093000000",
"txid": "085495a1f868a8422b5d6797209e3a6a1972438cd18bc7663e010f7b3b52d2df"
}