core-lightning/doc/lightning-sendonionmessage.7
Rusty Russell c4fe2e7f5a doc: Manual page for sendonionmessage.
Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2021-01-14 13:56:13 +01:00

46 lines
1.3 KiB
Groff
Generated

.TH "LIGHTNING-SENDONIONMESSAGE" "7" "" "" "lightning-sendonionmessage"
.SH NAME
lightning-sendonionmessage - low-level command to send an onion message
.SH SYNOPSIS
\fB(WARNING: experimental-onion-messages only)\fR
\fBsendonionmessage\fR \fIhops\fR [\fIreply_path\fR]
.SH DESCRIPTION
The \fBsendonionmessage\fR RPC command can be used to send a message via
the lightning network\. These are currently used by \fIoffers\fR to request
and receive invoices\.
\fIhops\fR is an array of json objects: \fIid\fR as a public key of the node,
and either \fIrawtlv\fR containing a hexidecimal TLV to include, or any of
the fields \fIshort_channel_id\fR, \fIblinding\fR, \fIenctlv\fR, \fIinvoice\fR,
\fIinvoice_request\fR and \fIinvoice_error\fR to construct the onionmessage
TLV with\.
\fIreply_path\fR is a json object, containing a pubkey \fIblinding\fR, and an
array \fIpath\fR of objects containing \fIid\fR (a pubkey) and \fIenctlv\fR (a hex
value, optional for final element)\.
.SH RETURN VALUE
On success, an empty JSON object is returned\.
.SH AUTHOR
Rusty Russell \fI<rusty@rustcorp.com.au\fR> is mainly responsible\.
.SH SEE ALSO
\fBlightning-fetchinvoice\fR(7), \fBlightning-offer\fR(7)\.
.SH RESOURCES
Main web site: \fIhttps://github.com/ElementsProject/lightning\fR
\" SHA256STAMP:680e0897d06c217e868bbc5b3985dec975d1af37dfd9fd0b91f5e1d9c651b687