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

FreeBSD Manual Pages

  
 
  

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

NAME
       lightning-upgradewallet	--  Command  to	 spend all P2SH-wrapped	inputs
       into a Native Segwit output

SYNOPSIS
       upgradewallet [feerate] [reservedok]

DESCRIPTION
       upgradewallet is	a convenience RPC which	will  spend  all  p2sh-wrapped
       Segwit deposits in a wallet into	a single Native	Segwit P2WPKH address.

       •  feerate  (feerate,  optional):  Feerate for the upgrade transaction.
	  The default is opening. (added v23.02)
       •  reservedok (boolean, optional): Tells	 the  wallet  to  include  all
	  P2SH-wrapped inputs, including reserved ones.	(added v23.02)

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

       •  upgraded_outs	(u64): Count of	spent/upgraded UTXOs. (added v23.02)
       •  psbt	(string,  optional):  The  PSBT	 that  was finalized and sent.
	  (added v23.02)
       •  tx (hex, optional): The  raw	transaction  which  was	 sent.	(added
	  v23.02)
       •  txid (txid, optional): The txid of the tx. (added v23.02)

AUTHOR
       Lisa Neigut <<niftynei@gmail.com>> is mainly responsible.

SEE ALSO
       lightning-utxopsbt(7),	 lightning-reserveinputs(7),   lightning-unre-
       serveinputs(7)

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

USAGE
       The caller is trying to buy a liquidity ad but the command keeps	 fail-
       ing. They have funds in their wallet, but they're all P2SH-wrapped out-
       puts.

       The caller can call upgradewallet to convert their funds	to native seg-
       wit outputs, which are valid for	liquidity ad buys.

EXAMPLES
       Example 1:

       Request:

       $ lightning-cli upgradewallet

       {
	 "id": "example:upgradewallet#1",
	 "method": "upgradewallet",
	 "params": {}
       }

       Response:

       {
	 "upgraded_outs": 0
       }

       Example 2:

       Request:

       $ lightning-cli upgradewallet -k	"feerate"="urgent" "reservedok"=True

       {
	 "id": "example:upgradewallet#2",
	 "method": "upgradewallet",
	 "params": {
	   "feerate": "urgent",
	   "reservedok": true
	 }
       }

       Response:

       {
	 "tx": "02000000000101upgd20000200002000020000200002000020000200002000020000200002000020000200002000020000200002000020000200002000020000200002000020000200002000020000200002000020000200002000020000",
	 "txid": "txidupgrade200000200000200000200000200000200000200000200000200000",
	 "psbt": "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000110000",
	 "upgraded_outs": 1
       }

Core Lightning v25.02				    LIGHTNING-UPGRADEWALLET(7)

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

home | help