mirror of
https://github.com/ElementsProject/lightning.git
synced 2024-11-20 02:27:51 +01:00
408342dc23
This made me document what are options are now in plugins, too. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
60 lines
1.5 KiB
Groff
Generated
60 lines
1.5 KiB
Groff
Generated
.TH "LIGHTNING-CHECKMESSAGE" "7" "" "" "lightning-checkmessage"
|
|
.SH NAME
|
|
lightning-checkmessage - Command to check if a signature is from a node
|
|
.SH SYNOPSIS
|
|
|
|
\fBcheckmessage\fR \fImessage\fR \fIzbase\fR [\fIpubkey\fR]
|
|
|
|
.SH DESCRIPTION
|
|
|
|
The \fBcheckmessage\fR RPC command is the counterpart to
|
|
\fBsignmessage\fR: given a node id (\fIpubkey\fR), signature (\fIzbase\fR) and a
|
|
\fImessage\fR, it verifies that the signature was generated by that node
|
|
for that message (more technically: by someone who knows that node's
|
|
secret)\.
|
|
|
|
|
|
As a special case, if \fIpubkey\fR is not specified, we will try every
|
|
known node key (as per \fIlistnodes\fR), 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\.
|
|
|
|
.SH RETURN VALUE
|
|
|
|
On success, an object is returned, containing:
|
|
|
|
.RS
|
|
.IP \[bu]
|
|
\fBverified\fR (boolean): Whether the signature was valid
|
|
|
|
.RE
|
|
|
|
If \fBverified\fR is \fItrue\fR:
|
|
|
|
.RS
|
|
.IP \[bu]
|
|
\fBpubkey\fR (pubkey): the \fIpubkey\fR parameter, or the pubkey found by looking for known nodes
|
|
|
|
.RE
|
|
|
|
If \fBverified\fR is \fIfalse\fR:
|
|
|
|
.RS
|
|
.IP \[bu]
|
|
\fBpubkey\fR (pubkey): the \fIpubkey\fR (if any) which could have signed this; this is usually not useful!
|
|
|
|
.RE
|
|
.SH AUTHOR
|
|
|
|
Rusty Russell \fI<rusty@rustcorp.com.au\fR> is mainly responsible\.
|
|
|
|
.SH SEE ALSO
|
|
|
|
\fBlightning-signmessage\fR(7)
|
|
|
|
.SH RESOURCES
|
|
|
|
Main web site: \fIhttps://github.com/ElementsProject/lightning\fR
|
|
|
|
\" SHA256STAMP:db4d5955a5e6a9c11ba8ea7717598e867131243c2ccf249eb2b50c803fc5e085
|