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

FreeBSD Manual Pages

  
 
  

home | help 
LIGHTNING-ADDPSBTOUTPUT(7)			    LIGHTNING-ADDPSBTOUTPUT(7)

NAME
       lightning-addpsbtoutput	--  Command  to	populate PSBT outputs from the
       wallet

SYNOPSIS
       addpsbtoutput satoshi [initialpsbt] [locktime] [destination]

DESCRIPTION
       Command added in	v23.11.

       addpsbtoutput is	a low-level RPC	command	which creates  or  modifies  a
       PSBT by adding a	single output of amount	satoshi.

       This  is	 used  to receive funds	into the on-chain wallet interactively
       using PSBTs.

       •  satoshi (sat): The satoshi value of the output. It can  be  a	 whole
	  number,  a whole number ending in sat, or a number with 1 to 8 deci-
	  mal places ending in btc.
       •  initialpsbt (string, optional): Base 64 encoded PSBT to add the out-
	  put to. If not specified, one	will be	generated automatically.
       •  locktime (u32, optional): If not set,	it is set to  a	 recent	 block
	  height (if no	initial	psbt is	specified).
       •  destination  (string,	 optional):  If	it is not set, an internal ad-
	  dress	is generated.

RETURN VALUE
       On success, an object is	returned, containing:

       •  psbt (string): Unsigned PSBT which fulfills the parameters given.
       •  estimated_added_weight (u32):	The estimated weight of	the added out-
	  put.
       •  outnum (u32):	The 0-based number where the output was	placed.

AUTHOR
       Dusty <<@dusty_daemon>> is mainly responsible.

SEE ALSO
       lightning-fundpsbt(7), lightning-utxopsbt(7)

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

EXAMPLES
       Example 1: Here is a command to make a PSBT with	a 1,000,000 sat	output
       that leads to the on-chain wallet:

       Request:

       $ lightning-cli addpsbtoutput -k	"satoshi"=1000000 "locktime"=111

       {
	 "id": "example:addpsbtoutput#1",
	 "method": "addpsbtoutput",
	 "params": {
	   "satoshi": 1000000,
	   "locktime": 111
	 }
       }

       Response:

       {
	 "psbt": "cHNidP8BAgpsbt1001010101010101010101010101010101010101010101010101010101010101010101010101010101010101010101010101010101",
	 "estimated_added_weight": 172,
	 "outnum": 1
       }

       Example 2:

       Request:

       $ lightning-cli addpsbtoutput "3333333" "cHNidP8BAgpsbt20020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202"

       {
	 "id": "example:addpsbtoutput#2",
	 "method": "addpsbtoutput",
	 "params": [
	   3333333,
	   "cHNidP8BAgpsbt20020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202"
	 ]
       }

       Response:

       {
	 "psbt": "cHNidP8BAgpsbt20020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202",
	 "estimated_added_weight": 172,
	 "outnum": 1
       }

       Example 3:

       Request:

       $ lightning-cli addpsbtoutput -k	"satoshi"=3333333 "initialpsbt"="cHNidP8BAgpsbt20020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202" "destination"="bcrt1p5201010101010101010101010101010101010101010101010101010101"

       {
	 "id": "example:addpsbtoutput#3",
	 "method": "addpsbtoutput",
	 "params": {
	   "satoshi": 3333333,
	   "initialpsbt": "cHNidP8BAgpsbt20020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202020202",
	   "destination": "bcrt1p5201010101010101010101010101010101010101010101010101010101"
	 }
       }

       Response:

       {
	 "psbt": "cHNidP8BAgpsbt300303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303",
	 "estimated_added_weight": 172,
	 "outnum": 1
       }

Core Lightning v25.02				    LIGHTNING-ADDPSBTOUTPUT(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lightning-addpsbtoutput&sektion=7&manpath=FreeBSD+Ports+14.3.quarterly>

home | help