newaddr

newaddr -- Command for generating a new address to be used by Core Lightning

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 withdraw.

  • 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 bitcoin mainnet), or p2tr taproot addresses. The special value all generates all known address types for the same underlying key. The default is bech32 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 returned.

AUTHOR

Felix <[email protected]> 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 is Blockstream's open-source implementation of the Lightning Network optimised for performance. It is highly customizable through modular expandability.

© 2023 Core Lightning
All rights reserved.

X Twitter Logo Streamline Icon: https://streamlinehq.com

X

The official Core Lightning X(Twitter) handle to follow project updates and announcements.

Github Logo 2 Streamline Icon: https://streamlinehq.com

Github

Github repository for source code, issues, and contributions. Visit our project here to explore or contibute.

Telegram

Community-driven telegram group where most of the node operators hang out. Go to https://t.me/lightningd to join.

Discord

Community-driven discord server where the devs flock together. Go to https://discord.gg/V6ay9yNhBQ to join.