Module breez_sdk_liquid::lightning::onion_message
Expand description
Onion Messages: sending, receiving, forwarding, and ancillary utilities live here
Onion messages are multi-purpose messages sent between peers over the lightning network. In the near future, they will be used to communicate invoices for offers, unlocking use cases such as static invoices, refunds and proof of payer. Further, you will be able to accept payments without revealing your node id through the use of blinded paths.
LDK sends and receives onion messages via the OnionMessenger
. See its documentation for more
information on its usage.
Structs§
- A
MessageRouter
that always fails. - A path for sending an
msgs::OnionMessage
. - A sender, receiver and forwarder of onion messages. In upcoming releases, this object will be used to retrieve invoices and fulfill invoice requests from offers. Currently, only sending and receiving custom onion messages is supported.
Enums§
- The destination of an onion message.
- Possible BOLT 12 Offers messages sent and received via an
OnionMessage
. - The contents of an onion message. In the context of offers, this would be the invoice, invoice request, or invoice error.
- Errors that may occur when sending an onion message.
Traits§
- The contents of a custom onion message.
- Handler for custom onion messages. If you are using
SimpleArcOnionMessenger
,SimpleRefOnionMessenger
, or prefer to ignore inbound custom onion messages,IgnoringMessageHandler
must be provided toOnionMessenger::new
. Otherwise, a custom implementation of this trait must be provided, withCustomMessage
specifying the supported message types. - A trait defining behavior for routing an
OnionMessage
. - A handler for an
OnionMessage
containing a BOLT 12 Offers message as its payload.
Type Aliases§
- Useful for simplifying the parameters of
SimpleArcChannelManager
andSimpleArcPeerManager
. See their docs for more details. - Useful for simplifying the parameters of
SimpleRefChannelManager
andSimpleRefPeerManager
. See their docs for more details.