46 lines
1.3 KiB
Groff
46 lines
1.3 KiB
Groff
.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
|