_ Git - ldk-c-bindings/blob - lightning-c-bindings/src/lightning/mod.rs

   1 // This file is Copyright its original authors, visible in version control
   2 // history and in the source files from which this was generated.
   3 //
   4 // This file is licensed under the license available in the LICENSE or LICENSE.md
   5 // file in the root of this repository or, if no such file exists, the same
   6 // license as that which applies to the original source files from which this
   7 // source was automatically generated.
   8
   9 //!lightning
  10 //! Rust-Lightning, not Rusty's Lightning!
  11 //!
  12 //! A full-featured but also flexible lightning implementation, in library form. This allows the
  13 //! user (you) to decide how they wish to use it instead of being a fully self-contained daemon.
  14 //! This means there is no built-in threading/execution environment and it's up to the user to
  15 //! figure out how best to make networking happen/timers fire/things get written to disk/keys get
  16 //! generated/etc. This makes it a good candidate for tight integration into an existing wallet
  17 //! instead of having a rather-separate lightning appendage to a wallet.
  18 //!
  19 //! `default` features are:
  20 //!
  21 //! * `std` - enables functionalities which require `std`, including `std::io` trait implementations and things which utilize time
  22 //! * `grind_signatures` - enables generation of [low-r bitcoin signatures](https://bitcoin.stackexchange.com/questions/111660/what-is-signature-grinding),
  23 //! which saves 1 byte per signature in 50% of the cases (see [bitcoin PR #13666](https://github.com/bitcoin/bitcoin/pull/13666))
  24 //!
  25 //! Available features are:
  26 //!
  27 //! * `std`
  28 //! * `grind_signatures`
  29 //! * `no-std ` - exposes write trait implementations from the `core2` crate (at least one of `no-std` or `std` are required)
  30 //! * Skip logging of messages at levels below the given log level:
  31 //!     * `max_level_off`
  32 //!     * `max_level_error`
  33 //!     * `max_level_warn`
  34 //!     * `max_level_info`
  35 //!     * `max_level_debug`
  36 //!     * `max_level_trace`
  37
  38 use alloc::str::FromStr;
  39 use alloc::string::String;
  40 use core::ffi::c_void;
  41 use core::convert::Infallible;
  42 use bitcoin::hashes::Hash;
  43 use crate::c_types::*;
  44 #[cfg(feature="no-std")]
  45 use alloc::{vec::Vec, boxed::Box};
  46
  47 pub mod util;
  48 pub mod chain;
  49 pub mod ln;
  50 pub mod offers;
  51 pub mod routing;
  52 pub mod sign;
  53 pub mod onion_message;
  54 pub mod blinded_path;
  55 pub mod events;
  56 mod crypto {
  57
  58 use alloc::str::FromStr;
  59 use alloc::string::String;
  60 use core::ffi::c_void;
  61 use core::convert::Infallible;
  62 use bitcoin::hashes::Hash;
  63 use crate::c_types::*;
  64 #[cfg(feature="no-std")]
  65 use alloc::{vec::Vec, boxed::Box};
  66
  67 mod chacha20 {
  68
  69 use alloc::str::FromStr;
  70 use alloc::string::String;
  71 use core::ffi::c_void;
  72 use core::convert::Infallible;
  73 use bitcoin::hashes::Hash;
  74 use crate::c_types::*;
  75 #[cfg(feature="no-std")]
  76 use alloc::{vec::Vec, boxed::Box};
  77
  78 mod real_chacha {
  79
  80 use alloc::str::FromStr;
  81 use alloc::string::String;
  82 use core::ffi::c_void;
  83 use core::convert::Infallible;
  84 use bitcoin::hashes::Hash;
  85 use crate::c_types::*;
  86 #[cfg(feature="no-std")]
  87 use alloc::{vec::Vec, boxed::Box};
  88
  89 }
  90 }
  91 mod poly1305 {
  92
  93 use alloc::str::FromStr;
  94 use alloc::string::String;
  95 use core::ffi::c_void;
  96 use core::convert::Infallible;
  97 use bitcoin::hashes::Hash;
  98 use crate::c_types::*;
  99 #[cfg(feature="no-std")]
 100 use alloc::{vec::Vec, boxed::Box};
 101
 102 }
 103 mod chacha20poly1305rfc {
 104
 105 use alloc::str::FromStr;
 106 use alloc::string::String;
 107 use core::ffi::c_void;
 108 use core::convert::Infallible;
 109 use bitcoin::hashes::Hash;
 110 use crate::c_types::*;
 111 #[cfg(feature="no-std")]
 112 use alloc::{vec::Vec, boxed::Box};
 113
 114 mod real_chachapoly {
 115
 116 use alloc::str::FromStr;
 117 use alloc::string::String;
 118 use core::ffi::c_void;
 119 use core::convert::Infallible;
 120 use bitcoin::hashes::Hash;
 121 use crate::c_types::*;
 122 #[cfg(feature="no-std")]
 123 use alloc::{vec::Vec, boxed::Box};
 124
 125 }
 126 }
 127 mod streams {
 128
 129 use alloc::str::FromStr;
 130 use alloc::string::String;
 131 use core::ffi::c_void;
 132 use core::convert::Infallible;
 133 use bitcoin::hashes::Hash;
 134 use crate::c_types::*;
 135 #[cfg(feature="no-std")]
 136 use alloc::{vec::Vec, boxed::Box};
 137
 138 }
 139 mod utils {
 140
 141 use alloc::str::FromStr;
 142 use alloc::string::String;
 143 use core::ffi::c_void;
 144 use core::convert::Infallible;
 145 use bitcoin::hashes::Hash;
 146 use crate::c_types::*;
 147 #[cfg(feature="no-std")]
 148 use alloc::{vec::Vec, boxed::Box};
 149
 150 }
 151 }
 152 mod io_extras {
 153
 154 use alloc::str::FromStr;
 155 use alloc::string::String;
 156 use core::ffi::c_void;
 157 use core::convert::Infallible;
 158 use bitcoin::hashes::Hash;
 159 use crate::c_types::*;
 160 #[cfg(feature="no-std")]
 161 use alloc::{vec::Vec, boxed::Box};
 162
 163 }
 164 mod prelude {
 165
 166 use alloc::str::FromStr;
 167 use alloc::string::String;
 168 use core::ffi::c_void;
 169 use core::convert::Infallible;
 170 use bitcoin::hashes::Hash;
 171 use crate::c_types::*;
 172 #[cfg(feature="no-std")]
 173 use alloc::{vec::Vec, boxed::Box};
 174
 175 }
 176 mod sync {
 177
 178 use alloc::str::FromStr;
 179 use alloc::string::String;
 180 use core::ffi::c_void;
 181 use core::convert::Infallible;
 182 use bitcoin::hashes::Hash;
 183 use crate::c_types::*;
 184 #[cfg(feature="no-std")]
 185 use alloc::{vec::Vec, boxed::Box};
 186
 187 mod fairrwlock {
 188
 189 use alloc::str::FromStr;
 190 use alloc::string::String;
 191 use core::ffi::c_void;
 192 use core::convert::Infallible;
 193 use bitcoin::hashes::Hash;
 194 use crate::c_types::*;
 195 #[cfg(feature="no-std")]
 196 use alloc::{vec::Vec, boxed::Box};
 197
 198 }
 199 mod ext_impl {
 200
 201 use alloc::str::FromStr;
 202 use alloc::string::String;
 203 use core::ffi::c_void;
 204 use core::convert::Infallible;
 205 use bitcoin::hashes::Hash;
 206 use crate::c_types::*;
 207 #[cfg(feature="no-std")]
 208 use alloc::{vec::Vec, boxed::Box};
 209
 210 }
 211 }