X-Git-Url: http://git.bitcoin.ninja/index.cgi?a=blobdiff_plain;f=lightning%2Fsrc%2Fonion_message%2Fmod.rs;h=d106a542fd368156f0a4f7959c37919d8e1821ec;hb=04b16e74d553a64d41669f1c82f33431b1080a28;hp=fabe8d58edabcc1b222708d5bf954c2e25df8d59;hpb=4e5381a50fa524cb183a3d92dee05cb4f2950255;p=rust-lightning diff --git a/lightning/src/onion_message/mod.rs b/lightning/src/onion_message/mod.rs index fabe8d58..d106a542 100644 --- a/lightning/src/onion_message/mod.rs +++ b/lightning/src/onion_message/mod.rs @@ -8,9 +8,30 @@ // licenses. //! 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. +//! +//! [offers]: +//! [blinded paths]: crate::blinded_path::BlindedPath -mod blinded_route; -mod utils; +mod messenger; +mod offers; +mod packet; +#[cfg(test)] +mod functional_tests; // Re-export structs so they can be imported with just the `onion_message::` module prefix. -pub use self::blinded_route::{BlindedRoute, BlindedHop}; +pub use self::messenger::{CustomOnionMessageHandler, DefaultMessageRouter, Destination, MessageRouter, OnionMessageContents, OnionMessagePath, OnionMessenger, PeeledOnion, PendingOnionMessage, SendError}; +pub use self::messenger::{create_onion_message, peel_onion_message}; +#[cfg(not(c_bindings))] +pub use self::messenger::{SimpleArcOnionMessenger, SimpleRefOnionMessenger}; +pub use self::offers::{OffersMessage, OffersMessageHandler}; +pub use self::packet::{Packet, ParsedOnionMessageContents}; +pub(crate) use self::packet::ControlTlvs; +pub(crate) use self::messenger::new_pending_onion_message;