mirror of
https://github.com/aljazceru/lightning.git
synced 2025-12-20 07:34:24 +01:00
1d671a2380
Returning an warning message when the pub key is not specified and there is no node in the graph. We try to help people that use core lightning as a signer and nothings else. Changelog-Deprecated: rpc: checkmessage return an error when the pubkey is not specified and it is unknown in the network graph.
58 lines
1.7 KiB
Markdown
58 lines
1.7 KiB
Markdown
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 technically: 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.
|
|
|
|
On failure, an error is returned and core lightning exit with the following error code:
|
|
- -32602: Parameter missed or malformed;
|
|
- 1301: *pubkey* not found in the graph.
|
|
|
|
RETURN VALUE
|
|
------------
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-START)
|
|
On success, an object is returned, containing:
|
|
- **verified** (boolean): Whether the signature was valid
|
|
|
|
If **verified** is *true*:
|
|
- **pubkey** (pubkey): the *pubkey* parameter, or the pubkey found by looking for known nodes
|
|
|
|
If **verified** is *false*:
|
|
- **pubkey** (pubkey): the *pubkey* (if any) which could have signed this; this is usually not useful!
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-END)
|
|
|
|
AUTHOR
|
|
------
|
|
|
|
Rusty Russell <<rusty@rustcorp.com.au>> is mainly responsible.
|
|
|
|
SEE ALSO
|
|
--------
|
|
|
|
lightning-signmessage(7)
|
|
|
|
RESOURCES
|
|
---------
|
|
|
|
Main web site: <https://github.com/ElementsProject/lightning>
|
|
|
|
[comment]: # ( SHA256STAMP:7dcca1fd1708d93b4a0c9b83955630fc4f551c4ffd452fb866c624c72aeaa44d)
|