2021-01-14 03:36:49 +00:00
|
|
|
lightning-sendonionmessage -- low-level command to send an onion message
|
|
|
|
|
================================================================
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
**(WARNING: experimental-onion-messages only)**
|
|
|
|
|
|
|
|
|
|
**sendonionmessage** *hops* \[*reply_path*\]
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
The **sendonionmessage** RPC command can be used to send a message via
|
|
|
|
|
the lightning network. These are currently used by *offers* to request
|
|
|
|
|
and receive invoices.
|
|
|
|
|
|
|
|
|
|
*hops* is an array of json objects: *id* as a public key of the node,
|
|
|
|
|
and either *rawtlv* containing a hexidecimal TLV to include, or any of
|
|
|
|
|
the fields *short_channel_id*, *blinding*, *enctlv*, *invoice*,
|
|
|
|
|
*invoice_request* and *invoice_error* to construct the onionmessage
|
|
|
|
|
TLV with.
|
|
|
|
|
|
|
|
|
|
*reply_path* is a json object, containing a pubkey *blinding*, and an
|
|
|
|
|
array *path* of objects containing *id* (a pubkey) and *enctlv* (a hex
|
|
|
|
|
value, optional for final element).
|
|
|
|
|
|
|
|
|
|
RETURN VALUE
|
|
|
|
|
------------
|
|
|
|
|
|
2021-06-16 02:10:17 +01:00
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-START)
|
|
|
|
|
On success, an empty object is returned.
|
2021-09-03 11:07:59 +01:00
|
|
|
|
2021-06-16 02:10:17 +01:00
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-END)
|
2021-01-14 03:36:49 +00:00
|
|
|
|
|
|
|
|
AUTHOR
|
|
|
|
|
------
|
|
|
|
|
|
|
|
|
|
Rusty Russell <<rusty@rustcorp.com.au>> is mainly responsible.
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
lightning-fetchinvoice(7), lightning-offer(7).
|
|
|
|
|
|
|
|
|
|
RESOURCES
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
Main web site: <https://github.com/ElementsProject/lightning>
|
|
|
|
|
|
|
|
|
|
[bolt04]: https://github.com/lightningnetwork/lightning-rfc/blob/master/04-onion-routing.md
|
|
|
|
|
|
2021-09-03 11:07:59 +01:00
|
|
|
[comment]: # ( SHA256STAMP:9125b71f093569c584c116210e488f11331029fca930dada6c040009daeb09f8)
|
