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 decimal places ending in btc.

• initialpsbt (string, optional): Base 64 encoded PSBT to add the output 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 address 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 output.

• 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
}