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

NAME
     newaddr  --  Command for generating a new address to be used by Core Light-
     ning

SYNOPSIS
     newaddr [addresstype]

DESCRIPTION
     The newaddr RPC command generates a new address which can	subsequently  be
     used to fund channels managed by the Core Lightning node.

     The funding transaction needs to be confirmed before funds can be used.

     To  send an on-chain payment from the Core Lightning node wallet, use with-
     draw.

     *	addresstype (string, optional) (one  of  "bech32",  "p2tr",  "all"):  It
	specifies   the   type	 of   address  wanted;	currently  bech32  (e.g.
	tb1qu9j4lg5f9rgjyfhvfd905vw46eg39czmktxqgg   on   bitcoin   testnet   or
	bc1qwqdg6squsna38e46795at95yu9atm8azzmyvckulcc7kytlcckxswvvzej	on  bit-
	coin mainnet), or p2tr taproot addresses. The special value  all  gener-
	ates all known address types for the same underlying key. The default is
	p2tr address.

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

     *	p2tr (string, optional): The taproot address. (added v23.08)
     *	bech32 (string, optional): The bech32 (native segwit) address.

ERRORS
     If  an  unrecognized address type is requested an error message will be re-
     turned.

AUTHOR
     Felix fixone@gmail.com is mainly responsible.

SEE ALSO
     lightning-listfunds(7),  lightning-fundchannel(7),   lightning-withdraw(7),
     lightning-listtransactions(7)

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

EXAMPLES
     Example 1:

     Request:

     $ lightning-cli newaddr

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

     Response:

     {
       "bech32": "bcrt1qwx6am26cuw38y4863pd6swrce2g8mzhaxr9xp8"
     }

     Example 2:

     Request:

     $ lightning-cli newaddr -k "addresstype"="p2tr"

     {
       "id": "example:newaddr#2",
       "method": "newaddr",
       "params": {
	 "addresstype": "p2tr"
       }
     }

     Response:

     {
       "p2tr": "bcrt1p2gppccw6ywewmg74qqxxmqfdpjds3rpr0mf22y9tm9xcc0muggwsea9nkf"
     }

Core Lightning v26.06.1 				    LIGHTNING-NEWADDR(7)
home | help