git.bitcoin.ninja Git - rust-lightning/blob - lightning/src/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::BlindedPath
  22 //! [`OnionMessenger`]: self::messenger::OnionMessenger
  23
  24 pub mod messenger;
  25 pub mod offers;
  26 pub mod packet;
  27 #[cfg(test)]
  28 mod functional_tests;