lightning/onion_message/
mod.rs

1// This file is Copyright its original authors, visible in version control
2// history.
3//
4// This file is licensed under the Apache License, Version 2.0 <LICENSE-APACHE
5// or http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
6// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your option.
7// You may not use this file except in accordance with one or both of these
8// licenses.
9
10//! Onion Messages: sending, receiving, forwarding, and ancillary utilities live here
11//!
12//! Onion messages are multi-purpose messages sent between peers over the lightning network. In the
13//! near future, they will be used to communicate invoices for [offers], unlocking use cases such as
14//! static invoices, refunds and proof of payer. Further, you will be able to accept payments
15//! without revealing your node id through the use of [blinded paths].
16//!
17//! LDK sends and receives onion messages via the [`OnionMessenger`]. See its documentation for more
18//! information on its usage.
19//!
20//! [offers]: <https://github.com/lightning/bolts/pull/798>
21//! [blinded paths]: crate::blinded_path::message::BlindedMessagePath
22//! [`OnionMessenger`]: self::messenger::OnionMessenger
23
24pub mod async_payments;
25pub mod dns_resolution;
26pub mod messenger;
27pub mod offers;
28pub mod packet;
29#[cfg(test)]
30mod functional_tests;