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

FreeBSD Manual Pages

  
 
  

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

NAME
       lightning-checkmessage  --  Command  to	check if a signature is	from a
       node

SYNOPSIS
       checkmessage message zbase [pubkey]

DESCRIPTION
       The checkmessage	RPC command is the counterpart to signmessage: given a
       node id (pubkey), signature (zbase) and a message, it verifies that the
       signature was generated by that node for	 that  message	(more  techni-
       cally: by someone who knows that	node's secret).

       As  a special case, if pubkey is	not specified, we will try every known
       node key	(as per	listnodes), and	verification succeeds  if  it  matches
       for  any	 one  of  them.	Note: this is implemented far more efficiently
       than trying each	one, so	performance is not a concern.

         message (string): Message to be checked against the signature.
         zbase	(string): The Zbase32 encoded signature	to verify.
         pubkey (pubkey, optional): The Zbase32 encoded signature to verify.

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

         verified (boolean) (always true): Whether the	signature was valid.
         pubkey (pubkey): The pubkey parameter, or the	pubkey found by	 look-
	  ing for known	nodes.

ERRORS
       On  failure, an error is	returned and core lightning exit with the fol-
       lowing error code:

         -32602: Parameter missed or malformed;
         1301:	pubkey not found in the	graph.

AUTHOR
       Rusty Russell <<rusty@rustcorp.com.au>> is mainly responsible.

SEE ALSO
       lightning-signmessage(7)

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

EXAMPLES
       Example 1:

       Request:

       $ lightning-cli checkmessage -k "message"="testcase to check new	rpc error" "zbase"="d66bqz3qsku5fxtqsi37j11pci47ydxa95iusphutggz9ezaxt56neh77kxe5hyr41kwgkncgiu94p9ecxiexgpgsz8daoq4tw8kj8yx" "pubkey"="03be3b0e9992153b1d5a6e1623670b6c3663f72ce6cf2e0dd39c0a373a7de5a3b7"

       {
	 "id": "example:checkmessage#1",
	 "method": "checkmessage",
	 "params": {
	   "message": "testcase	to check new rpc error",
	   "zbase": "d66bqz3qsku5fxtqsi37j11pci47ydxa95iusphutggz9ezaxt56neh77kxe5hyr41kwgkncgiu94p9ecxiexgpgsz8daoq4tw8kj8yx",
	   "pubkey": "03be3b0e9992153b1d5a6e1623670b6c3663f72ce6cf2e0dd39c0a373a7de5a3b7"
	 }
       }

       Response:

       {
	 "pubkey": "03be3b0e9992153b1d5a6e1623670b6c3663f72ce6cf2e0dd39c0a373a7de5a3b7",
	 "verified": true
       }

       Example 2:

       Request:

       $ lightning-cli checkmessage -k "message"="this is a test!" "zbase"="d6tqaeuonjhi98mmont9m4wag7gg4krg1f4txonug3h31e9h6p6k6nbwjondnj46dkyausobstnk7fhyy998bhgc1yr98dfmhb4k54d7"

       {
	 "id": "example:checkmessage#2",
	 "method": "checkmessage",
	 "params": {
	   "message": "this is a test!",
	   "zbase": "d6tqaeuonjhi98mmont9m4wag7gg4krg1f4txonug3h31e9h6p6k6nbwjondnj46dkyausobstnk7fhyy998bhgc1yr98dfmhb4k54d7"
	 }
       }

       Response:

       {
	 "pubkey": "nodeid010101010101010101010101010101010101010101010101010101010101",
	 "verified": true
       }

Core Lightning v25.02				     LIGHTNING-CHECKMESSAGE(7)

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

home | help