core-lightning/doc/lightning-checkmessage.7
Rusty Russell a00179d557 doc, wiregen: use SHA256 stamps instead of git versions.
This should be more robust in future: we SHA256 all of the deps.
For wiregen we prefix with EXPERIMENTAL_FEATURES, since it can effect them.

Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2020-08-31 21:33:26 -05:00

51 lines
1.6 KiB
Groff
Generated

.TH "LIGHTNING-CHECKMESSAGE" "7" "" "" "lightning-checkmessage"
.SH NAME
lightning-checkmessage - Command to check 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 correct usage, an object with attribute \fIverified\fR will be
returned\.
If \fIverified\fR is true, the signature was generated by the returned
\fIpubkey\fR for that given message\. \fIpubkey\fR is the one specified as
input, or if none was specified, the known node which must have
produced this signature\.
If \fIverified\fR is false, the signature is meaningless\. \fIpubkey\fR may
also be returned, which is they \fIpubkey\fR (if any) for which this
signature would be valid\. This is usually not useful\.
.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:09c0f92e4048a09e6f95b9c53689b065d4d3aea0f7040b2b2c6aea8d3183b62e