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

FreeBSD Manual Pages

  
 
  

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

NAME
       lightning-check -- Command for verifying	parameters

SYNOPSIS
       check command_to_check

DESCRIPTION
       The  check RPC command verifies another command without actually	making
       any changes.

       This is guaranteed to be	safe, and will do all checks up	to  the	 point
       where  something	in the system would need to be altered (such as	check-
       ing that	channels are in	the right state, peers connected, etc).

       It does not guarantee successful	execution of the command in all	cases.
       For example, a call to lightning-getroute(7) may	still fail to  find  a
       route even if checking the parameters succeeds.

         command_to_check (string): Name of the relevant command.

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

         command_to_check (string): The command_to_check argument.

AUTHOR
       Mark  Beckwith  <<wythe@intrig.com>>  and  Rusty	 Russell <<rusty@rust-
       corp.com.au>> are mainly	responsible.

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

EXAMPLES
       Example 1:

       Request:

       $ lightning-cli check -k	"command_to_check"="sendpay" "route"='[{"amount_msat": 1011, "id": "nodeid030303030303030303030303030303030303030303030303030303030303", "delay": 20, "channel": "123x1x1"}, {"amount_msat": 1000, "id": "nodeid040404040404040404040404040404040404040404040404040404040404", "delay":	10, "channel": "130x1x1"}]' "payment_hash"="0000000000000000000000000000000000000000000000000000000000000000"

       {
	 "id": "example:check#1",
	 "method": "check",
	 "params": {
	   "command_to_check": "sendpay",
	   "route": [
	     {
	       "amount_msat": 1011,
	       "id": "nodeid030303030303030303030303030303030303030303030303030303030303",
	       "delay":	20,
	       "channel": "123x1x1"
	     },
	     {
	       "amount_msat": 1000,
	       "id": "nodeid040404040404040404040404040404040404040404040404040404040404",
	       "delay":	10,
	       "channel": "130x1x1"
	     }
	   ],
	   "payment_hash": "0000000000000000000000000000000000000000000000000000000000000000"
	 }
       }

       Response:

       {
	 "command_to_check": "sendpay"
       }

       Example 2:

       Request:

       $ lightning-cli check -k	"command_to_check"="dev" "subcommand"="slowcmd"	"msec"=1000

       {
	 "id": "example:check#2",
	 "method": "check",
	 "params": {
	   "command_to_check": "dev",
	   "subcommand": "slowcmd",
	   "msec": 1000
	 }
       }

       Response:

       {
	 "command_to_check": "dev"
       }

       Example 3:

       Request:

       $ lightning-cli check -k	"command_to_check"="recover" "hsmsecret"="6c696768746e696e672d31000000000000000000000000000000000000000000"

       {
	 "id": "example:check#3",
	 "method": "check",
	 "params": {
	   "command_to_check": "recover",
	   "hsmsecret":	"6c696768746e696e672d31000000000000000000000000000000000000000000"
	 }
       }

       Response:

       {
	 "command_to_check": "recover"
       }

Core Lightning v25.02					    LIGHTNING-CHECK(7)

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

home | help