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

FreeBSD Manual Pages

  
 
  

home | help
LIGHTNING-BKPR-E...IPTIONBYOUTPOINT(7)	LIGHTNING-BKPR-E...IPTIONBYOUTPOINT(7)

NAME
       bkpr-editdescriptionbyoutpoint -- Command to change the description for
       events with {outpoint} after they're made

SYNOPSIS
       bkpr-editdescriptionbyoutpoint outpoint description

DESCRIPTION
       The  bkpr-editdescriptionbyoutpoint  RPC	 command updates all chain and
       channel events that match the {outpoint}	with  the  provided  {descrip-
       tion}

         outpoint (string): The outpoint to update the	description for.
         description (string):	The description	to update to

RETURN VALUE
       On success, an object containing	updated	is returned. It	is an array of
       objects,	where each object contains:

         account (string): The	account	name. If the account is	a channel, the
	  channel_id.
         type (string)	(one of	"chain", "channel"): Coin movement type.
         tag (string):	Description of movement.
         credit_msat (msat): Amount credited.
         debit_msat (msat): Amount debited.
         currency (string): Human-readable bech32 part	for this coin type.
         timestamp  (u32): Timestamp this event was recorded by the node. For
	  consolidated events such as onchain_fees, the	most recent timestamp.
         description (string):	The description	of this	event

       If type is "chain": -  outpoint	(string):  The	txid:outnum  for  this
       event.  - blockheight (u32): For	chain events, blockheight this occured
       at.   - description (string, optional): A description of	this outpoint.
       - origin	(string, optional): The	account	this movement originated from.
       - payment_id (hex, optional):  Lightning	 payment  identifier.  For  an
       htlc,  this will	be the preimage.  - txid (txid,	optional): The txid of
       the transaction that created this event.

       If type is "onchain_fee": - txid	(txid):	The txid  of  the  transaction
       that created this event.

       If  type	 is  "channel":	 -  fees_msat (msat, optional):	Amount paid in
       fees.  -	is_rebalance (boolean, optional): Is this payment  part	 of  a
       rebalance.  - payment_id	(hex, optional): Lightning payment identifier.
       For  an	htlc,  this  will be the preimage.  - part_id (u32, optional):
       Counter for multi-part payments.

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

SEE ALSO
       lightning-bkpr-editdescriptionbypaymentid(7),	lightning-bkpr-listac-
       countevents(7), lightning-bkpr-listincome(7)

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

EXAMPLES
       Example 1:

       Request:

       $ lightning-cli bkpr-editdescriptionbyoutpoint -k "outpoint"="txidbk0101010101010101010101010101010101010101010101010101010101:1" "description"="edited utxo description"

       {
	 "id": "example:bkpr-editdescriptionbyoutpoint#1",
	 "method": "bkpr-editdescriptionbyoutpoint",
	 "params": {
	   "outpoint": "txidbk0101010101010101010101010101010101010101010101010101010101:1",
	   "description": "edited utxo description"
	 }
       }

       Response:

       {
	 "updated": [
	   {
	     "account":	"wallet",
	     "type": "chain",
	     "tag": "deposit",
	     "credit_msat": 200000000000,
	     "debit_msat": 0,
	     "currency": "bcrt",
	     "outpoint": "txidbk0101010101010101010101010101010101010101010101010101010101:1",
	     "timestamp": 1738510000,
	     "blockheight": 110,
	     "description": "edited utxo description"
	   }
	 ]
       }

       Example 2:

       Request:

       $ lightning-cli bkpr-editdescriptionbyoutpoint -k "outpoint"="abcd020202020202020202020202020202020202020202020202020202020202:1" "description"="edited utxo description	for non	existing outpoint"

       {
	 "id": "example:bkpr-editdescriptionbyoutpoint#2",
	 "method": "bkpr-editdescriptionbyoutpoint",
	 "params": {
	   "outpoint": "abcd020202020202020202020202020202020202020202020202020202020202:1",
	   "description": "edited utxo description for non existing outpoint"
	 }
       }

       Response:

       {
	 "updated": []
       }

Core Lightning v25.09			LIGHTNING-BKPR-E...IPTIONBYOUTPOINT(7)

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

home | help