_ Git - rust-lightning/blob - lightning-c-bindings/src/routing/network_graph.rs

   1 //! The top-level network map tracking logic lives here.
   2
   3 use std::ffi::c_void;
   4 use bitcoin::hashes::Hash;
   5 use crate::c_types::*;
   6
   7
   8 use lightning::routing::network_graph::NetworkGraph as nativeNetworkGraphImport;
   9 type nativeNetworkGraph = nativeNetworkGraphImport;
  10
  11 /// Represents the network as nodes and channels between them
  12 #[must_use]
  13 #[repr(C)]
  14 pub struct NetworkGraph {
  15         /// Nearly everywhere, inner must be non-null, however in places where
  16         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
  17         pub inner: *mut nativeNetworkGraph,
  18         pub is_owned: bool,
  19 }
  20
  21 impl Drop for NetworkGraph {
  22         fn drop(&mut self) {
  23                 if self.is_owned && !self.inner.is_null() {
  24                         let _ = unsafe { Box::from_raw(self.inner) };
  25                 }
  26         }
  27 }
  28 #[no_mangle]
  29 pub extern "C" fn NetworkGraph_free(this_ptr: NetworkGraph) { }
  30 #[allow(unused)]
  31 /// Used only if an object of this type is returned as a trait impl by a method
  32 extern "C" fn NetworkGraph_free_void(this_ptr: *mut c_void) {
  33         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeNetworkGraph); }
  34 }
  35 #[allow(unused)]
  36 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
  37 impl NetworkGraph {
  38         pub(crate) fn take_inner(mut self) -> *mut nativeNetworkGraph {
  39                 assert!(self.is_owned);
  40                 let ret = self.inner;
  41                 self.inner = std::ptr::null_mut();
  42                 ret
  43         }
  44 }
  45
  46 use lightning::routing::network_graph::LockedNetworkGraph as nativeLockedNetworkGraphImport;
  47 type nativeLockedNetworkGraph = nativeLockedNetworkGraphImport<'static>;
  48
  49 /// A simple newtype for RwLockReadGuard<'a, NetworkGraph>.
  50 /// This exists only to make accessing a RwLock<NetworkGraph> possible from
  51 /// the C bindings, as it can be done directly in Rust code.
  52 #[must_use]
  53 #[repr(C)]
  54 pub struct LockedNetworkGraph {
  55         /// Nearly everywhere, inner must be non-null, however in places where
  56         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
  57         pub inner: *mut nativeLockedNetworkGraph,
  58         pub is_owned: bool,
  59 }
  60
  61 impl Drop for LockedNetworkGraph {
  62         fn drop(&mut self) {
  63                 if self.is_owned && !self.inner.is_null() {
  64                         let _ = unsafe { Box::from_raw(self.inner) };
  65                 }
  66         }
  67 }
  68 #[no_mangle]
  69 pub extern "C" fn LockedNetworkGraph_free(this_ptr: LockedNetworkGraph) { }
  70 #[allow(unused)]
  71 /// Used only if an object of this type is returned as a trait impl by a method
  72 extern "C" fn LockedNetworkGraph_free_void(this_ptr: *mut c_void) {
  73         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeLockedNetworkGraph); }
  74 }
  75 #[allow(unused)]
  76 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
  77 impl LockedNetworkGraph {
  78         pub(crate) fn take_inner(mut self) -> *mut nativeLockedNetworkGraph {
  79                 assert!(self.is_owned);
  80                 let ret = self.inner;
  81                 self.inner = std::ptr::null_mut();
  82                 ret
  83         }
  84 }
  85
  86 use lightning::routing::network_graph::NetGraphMsgHandler as nativeNetGraphMsgHandlerImport;
  87 type nativeNetGraphMsgHandler = nativeNetGraphMsgHandlerImport<crate::chain::Access, crate::util::logger::Logger>;
  88
  89 /// Receives and validates network updates from peers,
  90 /// stores authentic and relevant data as a network graph.
  91 /// This network graph is then used for routing payments.
  92 /// Provides interface to help with initial routing sync by
  93 /// serving historical announcements.
  94 #[must_use]
  95 #[repr(C)]
  96 pub struct NetGraphMsgHandler {
  97         /// Nearly everywhere, inner must be non-null, however in places where
  98         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
  99         pub inner: *mut nativeNetGraphMsgHandler,
 100         pub is_owned: bool,
 101 }
 102
 103 impl Drop for NetGraphMsgHandler {
 104         fn drop(&mut self) {
 105                 if self.is_owned && !self.inner.is_null() {
 106                         let _ = unsafe { Box::from_raw(self.inner) };
 107                 }
 108         }
 109 }
 110 #[no_mangle]
 111 pub extern "C" fn NetGraphMsgHandler_free(this_ptr: NetGraphMsgHandler) { }
 112 #[allow(unused)]
 113 /// Used only if an object of this type is returned as a trait impl by a method
 114 extern "C" fn NetGraphMsgHandler_free_void(this_ptr: *mut c_void) {
 115         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeNetGraphMsgHandler); }
 116 }
 117 #[allow(unused)]
 118 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
 119 impl NetGraphMsgHandler {
 120         pub(crate) fn take_inner(mut self) -> *mut nativeNetGraphMsgHandler {
 121                 assert!(self.is_owned);
 122                 let ret = self.inner;
 123                 self.inner = std::ptr::null_mut();
 124                 ret
 125         }
 126 }
 127 /// Creates a new tracker of the actual state of the network of channels and nodes,
 128 /// assuming a fresh network graph.
 129 /// Chain monitor is used to make sure announced channels exist on-chain,
 130 /// channel data is correct, and that the announcement is signed with
 131 /// channel owners' keys.
 132 #[must_use]
 133 #[no_mangle]
 134 pub extern "C" fn NetGraphMsgHandler_new(mut genesis_hash: crate::c_types::ThirtyTwoBytes, chain_access: *mut crate::chain::Access, mut logger: crate::util::logger::Logger) -> NetGraphMsgHandler {
 135         let mut local_chain_access = if chain_access == std::ptr::null_mut() { None } else { Some( { unsafe { *Box::from_raw(chain_access) } }) };
 136         let mut ret = lightning::routing::network_graph::NetGraphMsgHandler::new(::bitcoin::hash_types::BlockHash::from_slice(&genesis_hash.data[..]).unwrap(), local_chain_access, logger);
 137         NetGraphMsgHandler { inner: Box::into_raw(Box::new(ret)), is_owned: true }
 138 }
 139
 140 /// Creates a new tracker of the actual state of the network of channels and nodes,
 141 /// assuming an existing Network Graph.
 142 #[must_use]
 143 #[no_mangle]
 144 pub extern "C" fn NetGraphMsgHandler_from_net_graph(chain_access: *mut crate::chain::Access, mut logger: crate::util::logger::Logger, mut network_graph: crate::routing::network_graph::NetworkGraph) -> NetGraphMsgHandler {
 145         let mut local_chain_access = if chain_access == std::ptr::null_mut() { None } else { Some( { unsafe { *Box::from_raw(chain_access) } }) };
 146         let mut ret = lightning::routing::network_graph::NetGraphMsgHandler::from_net_graph(local_chain_access, logger, *unsafe { Box::from_raw(network_graph.take_inner()) });
 147         NetGraphMsgHandler { inner: Box::into_raw(Box::new(ret)), is_owned: true }
 148 }
 149
 150 /// Take a read lock on the network_graph and return it in the C-bindings
 151 /// newtype helper. This is likely only useful when called via the C
 152 /// bindings as you can call `self.network_graph.read().unwrap()` in Rust
 153 /// yourself.
 154 #[must_use]
 155 #[no_mangle]
 156 pub extern "C" fn NetGraphMsgHandler_read_locked_graph(this_arg: &NetGraphMsgHandler) -> crate::routing::network_graph::LockedNetworkGraph {
 157         let mut ret = unsafe { &*this_arg.inner }.read_locked_graph();
 158         crate::routing::network_graph::LockedNetworkGraph { inner: Box::into_raw(Box::new(ret)), is_owned: true }
 159 }
 160
 161 /// Get a reference to the NetworkGraph which this read-lock contains.
 162 #[must_use]
 163 #[no_mangle]
 164 pub extern "C" fn LockedNetworkGraph_graph(this_arg: &LockedNetworkGraph) -> crate::routing::network_graph::NetworkGraph {
 165         let mut ret = unsafe { &*this_arg.inner }.graph();
 166         crate::routing::network_graph::NetworkGraph { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
 167 }
 168
 169 impl From<nativeNetGraphMsgHandler> for crate::ln::msgs::RoutingMessageHandler {
 170         fn from(obj: nativeNetGraphMsgHandler) -> Self {
 171                 let mut rust_obj = NetGraphMsgHandler { inner: Box::into_raw(Box::new(obj)), is_owned: true };
 172                 let mut ret = NetGraphMsgHandler_as_RoutingMessageHandler(&rust_obj);
 173                 // We want to free rust_obj when ret gets drop()'d, not rust_obj, so wipe rust_obj's pointer and set ret's free() fn
 174                 rust_obj.inner = std::ptr::null_mut();
 175                 ret.free = Some(NetGraphMsgHandler_free_void);
 176                 ret
 177         }
 178 }
 179 #[no_mangle]
 180 pub extern "C" fn NetGraphMsgHandler_as_RoutingMessageHandler(this_arg: &NetGraphMsgHandler) -> crate::ln::msgs::RoutingMessageHandler {
 181         crate::ln::msgs::RoutingMessageHandler {
 182                 this_arg: unsafe { (*this_arg).inner as *mut c_void },
 183                 free: None,
 184                 handle_node_announcement: NetGraphMsgHandler_RoutingMessageHandler_handle_node_announcement,
 185                 handle_channel_announcement: NetGraphMsgHandler_RoutingMessageHandler_handle_channel_announcement,
 186                 handle_channel_update: NetGraphMsgHandler_RoutingMessageHandler_handle_channel_update,
 187                 handle_htlc_fail_channel_update: NetGraphMsgHandler_RoutingMessageHandler_handle_htlc_fail_channel_update,
 188                 get_next_channel_announcements: NetGraphMsgHandler_RoutingMessageHandler_get_next_channel_announcements,
 189                 get_next_node_announcements: NetGraphMsgHandler_RoutingMessageHandler_get_next_node_announcements,
 190                 sync_routing_table: NetGraphMsgHandler_RoutingMessageHandler_sync_routing_table,
 191                 handle_reply_channel_range: NetGraphMsgHandler_RoutingMessageHandler_handle_reply_channel_range,
 192                 handle_reply_short_channel_ids_end: NetGraphMsgHandler_RoutingMessageHandler_handle_reply_short_channel_ids_end,
 193                 handle_query_channel_range: NetGraphMsgHandler_RoutingMessageHandler_handle_query_channel_range,
 194                 handle_query_short_channel_ids: NetGraphMsgHandler_RoutingMessageHandler_handle_query_short_channel_ids,
 195                 MessageSendEventsProvider: crate::util::events::MessageSendEventsProvider {
 196                         this_arg: unsafe { (*this_arg).inner as *mut c_void },
 197                         free: None,
 198                         get_and_clear_pending_msg_events: NetGraphMsgHandler_RoutingMessageHandler_get_and_clear_pending_msg_events,
 199                 },
 200         }
 201 }
 202 use lightning::ln::msgs::RoutingMessageHandler as RoutingMessageHandlerTraitImport;
 203 #[must_use]
 204 extern "C" fn NetGraphMsgHandler_RoutingMessageHandler_handle_node_announcement(this_arg: *const c_void, msg: &crate::ln::msgs::NodeAnnouncement) -> crate::c_types::derived::CResult_boolLightningErrorZ {
 205         let mut ret = unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.handle_node_announcement(unsafe { &*msg.inner });
 206         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { o }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 207         local_ret
 208 }
 209 #[must_use]
 210 extern "C" fn NetGraphMsgHandler_RoutingMessageHandler_handle_channel_announcement(this_arg: *const c_void, msg: &crate::ln::msgs::ChannelAnnouncement) -> crate::c_types::derived::CResult_boolLightningErrorZ {
 211         let mut ret = unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.handle_channel_announcement(unsafe { &*msg.inner });
 212         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { o }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 213         local_ret
 214 }
 215 extern "C" fn NetGraphMsgHandler_RoutingMessageHandler_handle_htlc_fail_channel_update(this_arg: *const c_void, update: &crate::ln::msgs::HTLCFailChannelUpdate) {
 216         unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.handle_htlc_fail_channel_update(&update.to_native())
 217 }
 218 #[must_use]
 219 extern "C" fn NetGraphMsgHandler_RoutingMessageHandler_handle_channel_update(this_arg: *const c_void, msg: &crate::ln::msgs::ChannelUpdate) -> crate::c_types::derived::CResult_boolLightningErrorZ {
 220         let mut ret = unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.handle_channel_update(unsafe { &*msg.inner });
 221         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { o }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 222         local_ret
 223 }
 224 #[must_use]
 225 extern "C" fn NetGraphMsgHandler_RoutingMessageHandler_get_next_channel_announcements(this_arg: *const c_void, mut starting_point: u64, mut batch_amount: u8) -> crate::c_types::derived::CVec_C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZZ {
 226         let mut ret = unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.get_next_channel_announcements(starting_point, batch_amount);
 227         let mut local_ret = Vec::new(); for item in ret.drain(..) { local_ret.push( { let (mut orig_ret_0_0, mut orig_ret_0_1, mut orig_ret_0_2) = item; let mut local_orig_ret_0_1 = crate::ln::msgs::ChannelUpdate { inner: if orig_ret_0_1.is_none() { std::ptr::null_mut() } else {  { Box::into_raw(Box::new((orig_ret_0_1.unwrap()))) } }, is_owned: true }; let mut local_orig_ret_0_2 = crate::ln::msgs::ChannelUpdate { inner: if orig_ret_0_2.is_none() { std::ptr::null_mut() } else {  { Box::into_raw(Box::new((orig_ret_0_2.unwrap()))) } }, is_owned: true }; let mut local_ret_0 = (crate::ln::msgs::ChannelAnnouncement { inner: Box::into_raw(Box::new(orig_ret_0_0)), is_owned: true }, local_orig_ret_0_1, local_orig_ret_0_2).into(); local_ret_0 }); };
 228         local_ret.into()
 229 }
 230 #[must_use]
 231 extern "C" fn NetGraphMsgHandler_RoutingMessageHandler_get_next_node_announcements(this_arg: *const c_void, mut starting_point: crate::c_types::PublicKey, mut batch_amount: u8) -> crate::c_types::derived::CVec_NodeAnnouncementZ {
 232         let mut local_starting_point_base = if starting_point.is_null() { None } else { Some( { starting_point.into_rust() }) }; let mut local_starting_point = local_starting_point_base.as_ref();
 233         let mut ret = unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.get_next_node_announcements(local_starting_point, batch_amount);
 234         let mut local_ret = Vec::new(); for item in ret.drain(..) { local_ret.push( { crate::ln::msgs::NodeAnnouncement { inner: Box::into_raw(Box::new(item)), is_owned: true } }); };
 235         local_ret.into()
 236 }
 237 extern "C" fn NetGraphMsgHandler_RoutingMessageHandler_sync_routing_table(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, init_msg: &crate::ln::msgs::Init) {
 238         unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.sync_routing_table(&their_node_id.into_rust(), unsafe { &*init_msg.inner })
 239 }
 240 #[must_use]
 241 extern "C" fn NetGraphMsgHandler_RoutingMessageHandler_handle_reply_channel_range(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, mut msg: crate::ln::msgs::ReplyChannelRange) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
 242         let mut ret = unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.handle_reply_channel_range(&their_node_id.into_rust(), *unsafe { Box::from_raw(msg.take_inner()) });
 243         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 244         local_ret
 245 }
 246 #[must_use]
 247 extern "C" fn NetGraphMsgHandler_RoutingMessageHandler_handle_reply_short_channel_ids_end(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, mut msg: crate::ln::msgs::ReplyShortChannelIdsEnd) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
 248         let mut ret = unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.handle_reply_short_channel_ids_end(&their_node_id.into_rust(), *unsafe { Box::from_raw(msg.take_inner()) });
 249         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 250         local_ret
 251 }
 252 #[must_use]
 253 extern "C" fn NetGraphMsgHandler_RoutingMessageHandler_handle_query_channel_range(this_arg: *const c_void, mut _their_node_id: crate::c_types::PublicKey, mut _msg: crate::ln::msgs::QueryChannelRange) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
 254         let mut ret = unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.handle_query_channel_range(&_their_node_id.into_rust(), *unsafe { Box::from_raw(_msg.take_inner()) });
 255         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 256         local_ret
 257 }
 258 #[must_use]
 259 extern "C" fn NetGraphMsgHandler_RoutingMessageHandler_handle_query_short_channel_ids(this_arg: *const c_void, mut _their_node_id: crate::c_types::PublicKey, mut _msg: crate::ln::msgs::QueryShortChannelIds) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
 260         let mut ret = unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.handle_query_short_channel_ids(&_their_node_id.into_rust(), *unsafe { Box::from_raw(_msg.take_inner()) });
 261         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 262         local_ret
 263 }
 264 use lightning::util::events::MessageSendEventsProvider as nativeMessageSendEventsProviderTrait;
 265 #[must_use]
 266 extern "C" fn NetGraphMsgHandler_RoutingMessageHandler_get_and_clear_pending_msg_events(this_arg: *const c_void) -> crate::c_types::derived::CVec_MessageSendEventZ {
 267         let mut ret = unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.get_and_clear_pending_msg_events();
 268         let mut local_ret = Vec::new(); for item in ret.drain(..) { local_ret.push( { crate::util::events::MessageSendEvent::native_into(item) }); };
 269         local_ret.into()
 270 }
 271
 272 impl From<nativeNetGraphMsgHandler> for crate::util::events::MessageSendEventsProvider {
 273         fn from(obj: nativeNetGraphMsgHandler) -> Self {
 274                 let mut rust_obj = NetGraphMsgHandler { inner: Box::into_raw(Box::new(obj)), is_owned: true };
 275                 let mut ret = NetGraphMsgHandler_as_MessageSendEventsProvider(&rust_obj);
 276                 // We want to free rust_obj when ret gets drop()'d, not rust_obj, so wipe rust_obj's pointer and set ret's free() fn
 277                 rust_obj.inner = std::ptr::null_mut();
 278                 ret.free = Some(NetGraphMsgHandler_free_void);
 279                 ret
 280         }
 281 }
 282 #[no_mangle]
 283 pub extern "C" fn NetGraphMsgHandler_as_MessageSendEventsProvider(this_arg: &NetGraphMsgHandler) -> crate::util::events::MessageSendEventsProvider {
 284         crate::util::events::MessageSendEventsProvider {
 285                 this_arg: unsafe { (*this_arg).inner as *mut c_void },
 286                 free: None,
 287                 get_and_clear_pending_msg_events: NetGraphMsgHandler_MessageSendEventsProvider_get_and_clear_pending_msg_events,
 288         }
 289 }
 290 use lightning::util::events::MessageSendEventsProvider as MessageSendEventsProviderTraitImport;
 291 #[must_use]
 292 extern "C" fn NetGraphMsgHandler_MessageSendEventsProvider_get_and_clear_pending_msg_events(this_arg: *const c_void) -> crate::c_types::derived::CVec_MessageSendEventZ {
 293         let mut ret = unsafe { &mut *(this_arg as *mut nativeNetGraphMsgHandler) }.get_and_clear_pending_msg_events();
 294         let mut local_ret = Vec::new(); for item in ret.drain(..) { local_ret.push( { crate::util::events::MessageSendEvent::native_into(item) }); };
 295         local_ret.into()
 296 }
 297
 298
 299 use lightning::routing::network_graph::DirectionalChannelInfo as nativeDirectionalChannelInfoImport;
 300 type nativeDirectionalChannelInfo = nativeDirectionalChannelInfoImport;
 301
 302 /// Details about one direction of a channel. Received
 303 /// within a channel update.
 304 #[must_use]
 305 #[repr(C)]
 306 pub struct DirectionalChannelInfo {
 307         /// Nearly everywhere, inner must be non-null, however in places where
 308         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
 309         pub inner: *mut nativeDirectionalChannelInfo,
 310         pub is_owned: bool,
 311 }
 312
 313 impl Drop for DirectionalChannelInfo {
 314         fn drop(&mut self) {
 315                 if self.is_owned && !self.inner.is_null() {
 316                         let _ = unsafe { Box::from_raw(self.inner) };
 317                 }
 318         }
 319 }
 320 #[no_mangle]
 321 pub extern "C" fn DirectionalChannelInfo_free(this_ptr: DirectionalChannelInfo) { }
 322 #[allow(unused)]
 323 /// Used only if an object of this type is returned as a trait impl by a method
 324 extern "C" fn DirectionalChannelInfo_free_void(this_ptr: *mut c_void) {
 325         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeDirectionalChannelInfo); }
 326 }
 327 #[allow(unused)]
 328 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
 329 impl DirectionalChannelInfo {
 330         pub(crate) fn take_inner(mut self) -> *mut nativeDirectionalChannelInfo {
 331                 assert!(self.is_owned);
 332                 let ret = self.inner;
 333                 self.inner = std::ptr::null_mut();
 334                 ret
 335         }
 336 }
 337 /// When the last update to the channel direction was issued.
 338 /// Value is opaque, as set in the announcement.
 339 #[no_mangle]
 340 pub extern "C" fn DirectionalChannelInfo_get_last_update(this_ptr: &DirectionalChannelInfo) -> u32 {
 341         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.last_update;
 342         (*inner_val)
 343 }
 344 /// When the last update to the channel direction was issued.
 345 /// Value is opaque, as set in the announcement.
 346 #[no_mangle]
 347 pub extern "C" fn DirectionalChannelInfo_set_last_update(this_ptr: &mut DirectionalChannelInfo, mut val: u32) {
 348         unsafe { &mut *this_ptr.inner }.last_update = val;
 349 }
 350 /// Whether the channel can be currently used for payments (in this one direction).
 351 #[no_mangle]
 352 pub extern "C" fn DirectionalChannelInfo_get_enabled(this_ptr: &DirectionalChannelInfo) -> bool {
 353         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.enabled;
 354         (*inner_val)
 355 }
 356 /// Whether the channel can be currently used for payments (in this one direction).
 357 #[no_mangle]
 358 pub extern "C" fn DirectionalChannelInfo_set_enabled(this_ptr: &mut DirectionalChannelInfo, mut val: bool) {
 359         unsafe { &mut *this_ptr.inner }.enabled = val;
 360 }
 361 /// The difference in CLTV values that you must have when routing through this channel.
 362 #[no_mangle]
 363 pub extern "C" fn DirectionalChannelInfo_get_cltv_expiry_delta(this_ptr: &DirectionalChannelInfo) -> u16 {
 364         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.cltv_expiry_delta;
 365         (*inner_val)
 366 }
 367 /// The difference in CLTV values that you must have when routing through this channel.
 368 #[no_mangle]
 369 pub extern "C" fn DirectionalChannelInfo_set_cltv_expiry_delta(this_ptr: &mut DirectionalChannelInfo, mut val: u16) {
 370         unsafe { &mut *this_ptr.inner }.cltv_expiry_delta = val;
 371 }
 372 /// The minimum value, which must be relayed to the next hop via the channel
 373 #[no_mangle]
 374 pub extern "C" fn DirectionalChannelInfo_get_htlc_minimum_msat(this_ptr: &DirectionalChannelInfo) -> u64 {
 375         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.htlc_minimum_msat;
 376         (*inner_val)
 377 }
 378 /// The minimum value, which must be relayed to the next hop via the channel
 379 #[no_mangle]
 380 pub extern "C" fn DirectionalChannelInfo_set_htlc_minimum_msat(this_ptr: &mut DirectionalChannelInfo, mut val: u64) {
 381         unsafe { &mut *this_ptr.inner }.htlc_minimum_msat = val;
 382 }
 383 /// Fees charged when the channel is used for routing
 384 #[no_mangle]
 385 pub extern "C" fn DirectionalChannelInfo_get_fees(this_ptr: &DirectionalChannelInfo) -> crate::routing::network_graph::RoutingFees {
 386         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.fees;
 387         crate::routing::network_graph::RoutingFees { inner: unsafe { ( (&((*inner_val)) as *const _) as *mut _) }, is_owned: false }
 388 }
 389 /// Fees charged when the channel is used for routing
 390 #[no_mangle]
 391 pub extern "C" fn DirectionalChannelInfo_set_fees(this_ptr: &mut DirectionalChannelInfo, mut val: crate::routing::network_graph::RoutingFees) {
 392         unsafe { &mut *this_ptr.inner }.fees = *unsafe { Box::from_raw(val.take_inner()) };
 393 }
 394 /// Most recent update for the channel received from the network
 395 /// Mostly redundant with the data we store in fields explicitly.
 396 /// Everything else is useful only for sending out for initial routing sync.
 397 /// Not stored if contains excess data to prevent DoS.
 398 #[no_mangle]
 399 pub extern "C" fn DirectionalChannelInfo_get_last_update_message(this_ptr: &DirectionalChannelInfo) -> crate::ln::msgs::ChannelUpdate {
 400         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.last_update_message;
 401         let mut local_inner_val = crate::ln::msgs::ChannelUpdate { inner: unsafe { (if inner_val.is_none() { std::ptr::null() } else {  { (inner_val.as_ref().unwrap()) } } as *const _) as *mut _ }, is_owned: false };
 402         local_inner_val
 403 }
 404 /// Most recent update for the channel received from the network
 405 /// Mostly redundant with the data we store in fields explicitly.
 406 /// Everything else is useful only for sending out for initial routing sync.
 407 /// Not stored if contains excess data to prevent DoS.
 408 #[no_mangle]
 409 pub extern "C" fn DirectionalChannelInfo_set_last_update_message(this_ptr: &mut DirectionalChannelInfo, mut val: crate::ln::msgs::ChannelUpdate) {
 410         let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
 411         unsafe { &mut *this_ptr.inner }.last_update_message = local_val;
 412 }
 413 #[no_mangle]
 414 pub extern "C" fn DirectionalChannelInfo_write(obj: &DirectionalChannelInfo) -> crate::c_types::derived::CVec_u8Z {
 415         crate::c_types::serialize_obj(unsafe { &(*(*obj).inner) })
 416 }
 417 #[no_mangle]
 418 pub(crate) extern "C" fn DirectionalChannelInfo_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
 419         crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeDirectionalChannelInfo) })
 420 }
 421 #[no_mangle]
 422 pub extern "C" fn DirectionalChannelInfo_read(ser: crate::c_types::u8slice) -> DirectionalChannelInfo {
 423         if let Ok(res) = crate::c_types::deserialize_obj(ser) {
 424                 DirectionalChannelInfo { inner: Box::into_raw(Box::new(res)), is_owned: true }
 425         } else {
 426                 DirectionalChannelInfo { inner: std::ptr::null_mut(), is_owned: true }
 427         }
 428 }
 429
 430 use lightning::routing::network_graph::ChannelInfo as nativeChannelInfoImport;
 431 type nativeChannelInfo = nativeChannelInfoImport;
 432
 433 /// Details about a channel (both directions).
 434 /// Received within a channel announcement.
 435 #[must_use]
 436 #[repr(C)]
 437 pub struct ChannelInfo {
 438         /// Nearly everywhere, inner must be non-null, however in places where
 439         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
 440         pub inner: *mut nativeChannelInfo,
 441         pub is_owned: bool,
 442 }
 443
 444 impl Drop for ChannelInfo {
 445         fn drop(&mut self) {
 446                 if self.is_owned && !self.inner.is_null() {
 447                         let _ = unsafe { Box::from_raw(self.inner) };
 448                 }
 449         }
 450 }
 451 #[no_mangle]
 452 pub extern "C" fn ChannelInfo_free(this_ptr: ChannelInfo) { }
 453 #[allow(unused)]
 454 /// Used only if an object of this type is returned as a trait impl by a method
 455 extern "C" fn ChannelInfo_free_void(this_ptr: *mut c_void) {
 456         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeChannelInfo); }
 457 }
 458 #[allow(unused)]
 459 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
 460 impl ChannelInfo {
 461         pub(crate) fn take_inner(mut self) -> *mut nativeChannelInfo {
 462                 assert!(self.is_owned);
 463                 let ret = self.inner;
 464                 self.inner = std::ptr::null_mut();
 465                 ret
 466         }
 467 }
 468 /// Protocol features of a channel communicated during its announcement
 469 #[no_mangle]
 470 pub extern "C" fn ChannelInfo_get_features(this_ptr: &ChannelInfo) -> crate::ln::features::ChannelFeatures {
 471         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.features;
 472         crate::ln::features::ChannelFeatures { inner: unsafe { ( (&((*inner_val)) as *const _) as *mut _) }, is_owned: false }
 473 }
 474 /// Protocol features of a channel communicated during its announcement
 475 #[no_mangle]
 476 pub extern "C" fn ChannelInfo_set_features(this_ptr: &mut ChannelInfo, mut val: crate::ln::features::ChannelFeatures) {
 477         unsafe { &mut *this_ptr.inner }.features = *unsafe { Box::from_raw(val.take_inner()) };
 478 }
 479 /// Source node of the first direction of a channel
 480 #[no_mangle]
 481 pub extern "C" fn ChannelInfo_get_node_one(this_ptr: &ChannelInfo) -> crate::c_types::PublicKey {
 482         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.node_one;
 483         crate::c_types::PublicKey::from_rust(&(*inner_val))
 484 }
 485 /// Source node of the first direction of a channel
 486 #[no_mangle]
 487 pub extern "C" fn ChannelInfo_set_node_one(this_ptr: &mut ChannelInfo, mut val: crate::c_types::PublicKey) {
 488         unsafe { &mut *this_ptr.inner }.node_one = val.into_rust();
 489 }
 490 /// Details about the first direction of a channel
 491 #[no_mangle]
 492 pub extern "C" fn ChannelInfo_get_one_to_two(this_ptr: &ChannelInfo) -> crate::routing::network_graph::DirectionalChannelInfo {
 493         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.one_to_two;
 494         let mut local_inner_val = crate::routing::network_graph::DirectionalChannelInfo { inner: unsafe { (if inner_val.is_none() { std::ptr::null() } else {  { (inner_val.as_ref().unwrap()) } } as *const _) as *mut _ }, is_owned: false };
 495         local_inner_val
 496 }
 497 /// Details about the first direction of a channel
 498 #[no_mangle]
 499 pub extern "C" fn ChannelInfo_set_one_to_two(this_ptr: &mut ChannelInfo, mut val: crate::routing::network_graph::DirectionalChannelInfo) {
 500         let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
 501         unsafe { &mut *this_ptr.inner }.one_to_two = local_val;
 502 }
 503 /// Source node of the second direction of a channel
 504 #[no_mangle]
 505 pub extern "C" fn ChannelInfo_get_node_two(this_ptr: &ChannelInfo) -> crate::c_types::PublicKey {
 506         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.node_two;
 507         crate::c_types::PublicKey::from_rust(&(*inner_val))
 508 }
 509 /// Source node of the second direction of a channel
 510 #[no_mangle]
 511 pub extern "C" fn ChannelInfo_set_node_two(this_ptr: &mut ChannelInfo, mut val: crate::c_types::PublicKey) {
 512         unsafe { &mut *this_ptr.inner }.node_two = val.into_rust();
 513 }
 514 /// Details about the second direction of a channel
 515 #[no_mangle]
 516 pub extern "C" fn ChannelInfo_get_two_to_one(this_ptr: &ChannelInfo) -> crate::routing::network_graph::DirectionalChannelInfo {
 517         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.two_to_one;
 518         let mut local_inner_val = crate::routing::network_graph::DirectionalChannelInfo { inner: unsafe { (if inner_val.is_none() { std::ptr::null() } else {  { (inner_val.as_ref().unwrap()) } } as *const _) as *mut _ }, is_owned: false };
 519         local_inner_val
 520 }
 521 /// Details about the second direction of a channel
 522 #[no_mangle]
 523 pub extern "C" fn ChannelInfo_set_two_to_one(this_ptr: &mut ChannelInfo, mut val: crate::routing::network_graph::DirectionalChannelInfo) {
 524         let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
 525         unsafe { &mut *this_ptr.inner }.two_to_one = local_val;
 526 }
 527 /// An initial announcement of the channel
 528 /// Mostly redundant with the data we store in fields explicitly.
 529 /// Everything else is useful only for sending out for initial routing sync.
 530 /// Not stored if contains excess data to prevent DoS.
 531 #[no_mangle]
 532 pub extern "C" fn ChannelInfo_get_announcement_message(this_ptr: &ChannelInfo) -> crate::ln::msgs::ChannelAnnouncement {
 533         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.announcement_message;
 534         let mut local_inner_val = crate::ln::msgs::ChannelAnnouncement { inner: unsafe { (if inner_val.is_none() { std::ptr::null() } else {  { (inner_val.as_ref().unwrap()) } } as *const _) as *mut _ }, is_owned: false };
 535         local_inner_val
 536 }
 537 /// An initial announcement of the channel
 538 /// Mostly redundant with the data we store in fields explicitly.
 539 /// Everything else is useful only for sending out for initial routing sync.
 540 /// Not stored if contains excess data to prevent DoS.
 541 #[no_mangle]
 542 pub extern "C" fn ChannelInfo_set_announcement_message(this_ptr: &mut ChannelInfo, mut val: crate::ln::msgs::ChannelAnnouncement) {
 543         let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
 544         unsafe { &mut *this_ptr.inner }.announcement_message = local_val;
 545 }
 546 #[no_mangle]
 547 pub extern "C" fn ChannelInfo_write(obj: &ChannelInfo) -> crate::c_types::derived::CVec_u8Z {
 548         crate::c_types::serialize_obj(unsafe { &(*(*obj).inner) })
 549 }
 550 #[no_mangle]
 551 pub(crate) extern "C" fn ChannelInfo_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
 552         crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeChannelInfo) })
 553 }
 554 #[no_mangle]
 555 pub extern "C" fn ChannelInfo_read(ser: crate::c_types::u8slice) -> ChannelInfo {
 556         if let Ok(res) = crate::c_types::deserialize_obj(ser) {
 557                 ChannelInfo { inner: Box::into_raw(Box::new(res)), is_owned: true }
 558         } else {
 559                 ChannelInfo { inner: std::ptr::null_mut(), is_owned: true }
 560         }
 561 }
 562
 563 use lightning::routing::network_graph::RoutingFees as nativeRoutingFeesImport;
 564 type nativeRoutingFees = nativeRoutingFeesImport;
 565
 566 /// Fees for routing via a given channel or a node
 567 #[must_use]
 568 #[repr(C)]
 569 pub struct RoutingFees {
 570         /// Nearly everywhere, inner must be non-null, however in places where
 571         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
 572         pub inner: *mut nativeRoutingFees,
 573         pub is_owned: bool,
 574 }
 575
 576 impl Drop for RoutingFees {
 577         fn drop(&mut self) {
 578                 if self.is_owned && !self.inner.is_null() {
 579                         let _ = unsafe { Box::from_raw(self.inner) };
 580                 }
 581         }
 582 }
 583 #[no_mangle]
 584 pub extern "C" fn RoutingFees_free(this_ptr: RoutingFees) { }
 585 #[allow(unused)]
 586 /// Used only if an object of this type is returned as a trait impl by a method
 587 extern "C" fn RoutingFees_free_void(this_ptr: *mut c_void) {
 588         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeRoutingFees); }
 589 }
 590 #[allow(unused)]
 591 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
 592 impl RoutingFees {
 593         pub(crate) fn take_inner(mut self) -> *mut nativeRoutingFees {
 594                 assert!(self.is_owned);
 595                 let ret = self.inner;
 596                 self.inner = std::ptr::null_mut();
 597                 ret
 598         }
 599 }
 600 impl Clone for RoutingFees {
 601         fn clone(&self) -> Self {
 602                 Self {
 603                         inner: Box::into_raw(Box::new(unsafe { &*self.inner }.clone())),
 604                         is_owned: true,
 605                 }
 606         }
 607 }
 608 #[allow(unused)]
 609 /// Used only if an object of this type is returned as a trait impl by a method
 610 pub(crate) extern "C" fn RoutingFees_clone_void(this_ptr: *const c_void) -> *mut c_void {
 611         Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeRoutingFees)).clone() })) as *mut c_void
 612 }
 613 #[no_mangle]
 614 pub extern "C" fn RoutingFees_clone(orig: &RoutingFees) -> RoutingFees {
 615         RoutingFees { inner: Box::into_raw(Box::new(unsafe { &*orig.inner }.clone())), is_owned: true }
 616 }
 617 /// Flat routing fee in satoshis
 618 #[no_mangle]
 619 pub extern "C" fn RoutingFees_get_base_msat(this_ptr: &RoutingFees) -> u32 {
 620         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.base_msat;
 621         (*inner_val)
 622 }
 623 /// Flat routing fee in satoshis
 624 #[no_mangle]
 625 pub extern "C" fn RoutingFees_set_base_msat(this_ptr: &mut RoutingFees, mut val: u32) {
 626         unsafe { &mut *this_ptr.inner }.base_msat = val;
 627 }
 628 /// Liquidity-based routing fee in millionths of a routed amount.
 629 /// In other words, 10000 is 1%.
 630 #[no_mangle]
 631 pub extern "C" fn RoutingFees_get_proportional_millionths(this_ptr: &RoutingFees) -> u32 {
 632         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.proportional_millionths;
 633         (*inner_val)
 634 }
 635 /// Liquidity-based routing fee in millionths of a routed amount.
 636 /// In other words, 10000 is 1%.
 637 #[no_mangle]
 638 pub extern "C" fn RoutingFees_set_proportional_millionths(this_ptr: &mut RoutingFees, mut val: u32) {
 639         unsafe { &mut *this_ptr.inner }.proportional_millionths = val;
 640 }
 641 #[must_use]
 642 #[no_mangle]
 643 pub extern "C" fn RoutingFees_new(mut base_msat_arg: u32, mut proportional_millionths_arg: u32) -> RoutingFees {
 644         RoutingFees { inner: Box::into_raw(Box::new(nativeRoutingFees {
 645                 base_msat: base_msat_arg,
 646                 proportional_millionths: proportional_millionths_arg,
 647         })), is_owned: true }
 648 }
 649 #[no_mangle]
 650 pub extern "C" fn RoutingFees_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_RoutingFeesDecodeErrorZ {
 651         let res = crate::c_types::deserialize_obj(ser);
 652         let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::routing::network_graph::RoutingFees { inner: Box::into_raw(Box::new(o)), is_owned: true } }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 653         local_res
 654 }
 655 #[no_mangle]
 656 pub extern "C" fn RoutingFees_write(obj: &RoutingFees) -> crate::c_types::derived::CVec_u8Z {
 657         crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
 658 }
 659 #[no_mangle]
 660 pub(crate) extern "C" fn RoutingFees_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
 661         crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeRoutingFees) })
 662 }
 663
 664 use lightning::routing::network_graph::NodeAnnouncementInfo as nativeNodeAnnouncementInfoImport;
 665 type nativeNodeAnnouncementInfo = nativeNodeAnnouncementInfoImport;
 666
 667 /// Information received in the latest node_announcement from this node.
 668 #[must_use]
 669 #[repr(C)]
 670 pub struct NodeAnnouncementInfo {
 671         /// Nearly everywhere, inner must be non-null, however in places where
 672         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
 673         pub inner: *mut nativeNodeAnnouncementInfo,
 674         pub is_owned: bool,
 675 }
 676
 677 impl Drop for NodeAnnouncementInfo {
 678         fn drop(&mut self) {
 679                 if self.is_owned && !self.inner.is_null() {
 680                         let _ = unsafe { Box::from_raw(self.inner) };
 681                 }
 682         }
 683 }
 684 #[no_mangle]
 685 pub extern "C" fn NodeAnnouncementInfo_free(this_ptr: NodeAnnouncementInfo) { }
 686 #[allow(unused)]
 687 /// Used only if an object of this type is returned as a trait impl by a method
 688 extern "C" fn NodeAnnouncementInfo_free_void(this_ptr: *mut c_void) {
 689         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeNodeAnnouncementInfo); }
 690 }
 691 #[allow(unused)]
 692 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
 693 impl NodeAnnouncementInfo {
 694         pub(crate) fn take_inner(mut self) -> *mut nativeNodeAnnouncementInfo {
 695                 assert!(self.is_owned);
 696                 let ret = self.inner;
 697                 self.inner = std::ptr::null_mut();
 698                 ret
 699         }
 700 }
 701 /// Protocol features the node announced support for
 702 #[no_mangle]
 703 pub extern "C" fn NodeAnnouncementInfo_get_features(this_ptr: &NodeAnnouncementInfo) -> crate::ln::features::NodeFeatures {
 704         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.features;
 705         crate::ln::features::NodeFeatures { inner: unsafe { ( (&((*inner_val)) as *const _) as *mut _) }, is_owned: false }
 706 }
 707 /// Protocol features the node announced support for
 708 #[no_mangle]
 709 pub extern "C" fn NodeAnnouncementInfo_set_features(this_ptr: &mut NodeAnnouncementInfo, mut val: crate::ln::features::NodeFeatures) {
 710         unsafe { &mut *this_ptr.inner }.features = *unsafe { Box::from_raw(val.take_inner()) };
 711 }
 712 /// When the last known update to the node state was issued.
 713 /// Value is opaque, as set in the announcement.
 714 #[no_mangle]
 715 pub extern "C" fn NodeAnnouncementInfo_get_last_update(this_ptr: &NodeAnnouncementInfo) -> u32 {
 716         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.last_update;
 717         (*inner_val)
 718 }
 719 /// When the last known update to the node state was issued.
 720 /// Value is opaque, as set in the announcement.
 721 #[no_mangle]
 722 pub extern "C" fn NodeAnnouncementInfo_set_last_update(this_ptr: &mut NodeAnnouncementInfo, mut val: u32) {
 723         unsafe { &mut *this_ptr.inner }.last_update = val;
 724 }
 725 /// Color assigned to the node
 726 #[no_mangle]
 727 pub extern "C" fn NodeAnnouncementInfo_get_rgb(this_ptr: &NodeAnnouncementInfo) -> *const [u8; 3] {
 728         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.rgb;
 729         &(*inner_val)
 730 }
 731 /// Color assigned to the node
 732 #[no_mangle]
 733 pub extern "C" fn NodeAnnouncementInfo_set_rgb(this_ptr: &mut NodeAnnouncementInfo, mut val: crate::c_types::ThreeBytes) {
 734         unsafe { &mut *this_ptr.inner }.rgb = val.data;
 735 }
 736 /// Moniker assigned to the node.
 737 /// May be invalid or malicious (eg control chars),
 738 /// should not be exposed to the user.
 739 #[no_mangle]
 740 pub extern "C" fn NodeAnnouncementInfo_get_alias(this_ptr: &NodeAnnouncementInfo) -> *const [u8; 32] {
 741         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.alias;
 742         &(*inner_val)
 743 }
 744 /// Moniker assigned to the node.
 745 /// May be invalid or malicious (eg control chars),
 746 /// should not be exposed to the user.
 747 #[no_mangle]
 748 pub extern "C" fn NodeAnnouncementInfo_set_alias(this_ptr: &mut NodeAnnouncementInfo, mut val: crate::c_types::ThirtyTwoBytes) {
 749         unsafe { &mut *this_ptr.inner }.alias = val.data;
 750 }
 751 /// Internet-level addresses via which one can connect to the node
 752 #[no_mangle]
 753 pub extern "C" fn NodeAnnouncementInfo_set_addresses(this_ptr: &mut NodeAnnouncementInfo, mut val: crate::c_types::derived::CVec_NetAddressZ) {
 754         let mut local_val = Vec::new(); for mut item in val.into_rust().drain(..) { local_val.push( { item.into_native() }); };
 755         unsafe { &mut *this_ptr.inner }.addresses = local_val;
 756 }
 757 /// An initial announcement of the node
 758 /// Mostly redundant with the data we store in fields explicitly.
 759 /// Everything else is useful only for sending out for initial routing sync.
 760 /// Not stored if contains excess data to prevent DoS.
 761 #[no_mangle]
 762 pub extern "C" fn NodeAnnouncementInfo_get_announcement_message(this_ptr: &NodeAnnouncementInfo) -> crate::ln::msgs::NodeAnnouncement {
 763         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.announcement_message;
 764         let mut local_inner_val = crate::ln::msgs::NodeAnnouncement { inner: unsafe { (if inner_val.is_none() { std::ptr::null() } else {  { (inner_val.as_ref().unwrap()) } } as *const _) as *mut _ }, is_owned: false };
 765         local_inner_val
 766 }
 767 /// An initial announcement of the node
 768 /// Mostly redundant with the data we store in fields explicitly.
 769 /// Everything else is useful only for sending out for initial routing sync.
 770 /// Not stored if contains excess data to prevent DoS.
 771 #[no_mangle]
 772 pub extern "C" fn NodeAnnouncementInfo_set_announcement_message(this_ptr: &mut NodeAnnouncementInfo, mut val: crate::ln::msgs::NodeAnnouncement) {
 773         let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
 774         unsafe { &mut *this_ptr.inner }.announcement_message = local_val;
 775 }
 776 #[must_use]
 777 #[no_mangle]
 778 pub extern "C" fn NodeAnnouncementInfo_new(mut features_arg: crate::ln::features::NodeFeatures, mut last_update_arg: u32, mut rgb_arg: crate::c_types::ThreeBytes, mut alias_arg: crate::c_types::ThirtyTwoBytes, mut addresses_arg: crate::c_types::derived::CVec_NetAddressZ, mut announcement_message_arg: crate::ln::msgs::NodeAnnouncement) -> NodeAnnouncementInfo {
 779         let mut local_addresses_arg = Vec::new(); for mut item in addresses_arg.into_rust().drain(..) { local_addresses_arg.push( { item.into_native() }); };
 780         let mut local_announcement_message_arg = if announcement_message_arg.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(announcement_message_arg.take_inner()) } }) };
 781         NodeAnnouncementInfo { inner: Box::into_raw(Box::new(nativeNodeAnnouncementInfo {
 782                 features: *unsafe { Box::from_raw(features_arg.take_inner()) },
 783                 last_update: last_update_arg,
 784                 rgb: rgb_arg.data,
 785                 alias: alias_arg.data,
 786                 addresses: local_addresses_arg,
 787                 announcement_message: local_announcement_message_arg,
 788         })), is_owned: true }
 789 }
 790 #[no_mangle]
 791 pub extern "C" fn NodeAnnouncementInfo_write(obj: &NodeAnnouncementInfo) -> crate::c_types::derived::CVec_u8Z {
 792         crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
 793 }
 794 #[no_mangle]
 795 pub(crate) extern "C" fn NodeAnnouncementInfo_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
 796         crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeNodeAnnouncementInfo) })
 797 }
 798 #[no_mangle]
 799 pub extern "C" fn NodeAnnouncementInfo_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_NodeAnnouncementInfoDecodeErrorZ {
 800         let res = crate::c_types::deserialize_obj(ser);
 801         let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::routing::network_graph::NodeAnnouncementInfo { inner: Box::into_raw(Box::new(o)), is_owned: true } }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 802         local_res
 803 }
 804
 805 use lightning::routing::network_graph::NodeInfo as nativeNodeInfoImport;
 806 type nativeNodeInfo = nativeNodeInfoImport;
 807
 808 /// Details about a node in the network, known from the network announcement.
 809 #[must_use]
 810 #[repr(C)]
 811 pub struct NodeInfo {
 812         /// Nearly everywhere, inner must be non-null, however in places where
 813         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
 814         pub inner: *mut nativeNodeInfo,
 815         pub is_owned: bool,
 816 }
 817
 818 impl Drop for NodeInfo {
 819         fn drop(&mut self) {
 820                 if self.is_owned && !self.inner.is_null() {
 821                         let _ = unsafe { Box::from_raw(self.inner) };
 822                 }
 823         }
 824 }
 825 #[no_mangle]
 826 pub extern "C" fn NodeInfo_free(this_ptr: NodeInfo) { }
 827 #[allow(unused)]
 828 /// Used only if an object of this type is returned as a trait impl by a method
 829 extern "C" fn NodeInfo_free_void(this_ptr: *mut c_void) {
 830         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeNodeInfo); }
 831 }
 832 #[allow(unused)]
 833 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
 834 impl NodeInfo {
 835         pub(crate) fn take_inner(mut self) -> *mut nativeNodeInfo {
 836                 assert!(self.is_owned);
 837                 let ret = self.inner;
 838                 self.inner = std::ptr::null_mut();
 839                 ret
 840         }
 841 }
 842 /// All valid channels a node has announced
 843 #[no_mangle]
 844 pub extern "C" fn NodeInfo_set_channels(this_ptr: &mut NodeInfo, mut val: crate::c_types::derived::CVec_u64Z) {
 845         let mut local_val = Vec::new(); for mut item in val.into_rust().drain(..) { local_val.push( { item }); };
 846         unsafe { &mut *this_ptr.inner }.channels = local_val;
 847 }
 848 /// Lowest fees enabling routing via any of the enabled, known channels to a node.
 849 /// The two fields (flat and proportional fee) are independent,
 850 /// meaning they don't have to refer to the same channel.
 851 #[no_mangle]
 852 pub extern "C" fn NodeInfo_get_lowest_inbound_channel_fees(this_ptr: &NodeInfo) -> crate::routing::network_graph::RoutingFees {
 853         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.lowest_inbound_channel_fees;
 854         let mut local_inner_val = crate::routing::network_graph::RoutingFees { inner: unsafe { (if inner_val.is_none() { std::ptr::null() } else {  { (inner_val.as_ref().unwrap()) } } as *const _) as *mut _ }, is_owned: false };
 855         local_inner_val
 856 }
 857 /// Lowest fees enabling routing via any of the enabled, known channels to a node.
 858 /// The two fields (flat and proportional fee) are independent,
 859 /// meaning they don't have to refer to the same channel.
 860 #[no_mangle]
 861 pub extern "C" fn NodeInfo_set_lowest_inbound_channel_fees(this_ptr: &mut NodeInfo, mut val: crate::routing::network_graph::RoutingFees) {
 862         let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
 863         unsafe { &mut *this_ptr.inner }.lowest_inbound_channel_fees = local_val;
 864 }
 865 /// More information about a node from node_announcement.
 866 /// Optional because we store a Node entry after learning about it from
 867 /// a channel announcement, but before receiving a node announcement.
 868 #[no_mangle]
 869 pub extern "C" fn NodeInfo_get_announcement_info(this_ptr: &NodeInfo) -> crate::routing::network_graph::NodeAnnouncementInfo {
 870         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.announcement_info;
 871         let mut local_inner_val = crate::routing::network_graph::NodeAnnouncementInfo { inner: unsafe { (if inner_val.is_none() { std::ptr::null() } else {  { (inner_val.as_ref().unwrap()) } } as *const _) as *mut _ }, is_owned: false };
 872         local_inner_val
 873 }
 874 /// More information about a node from node_announcement.
 875 /// Optional because we store a Node entry after learning about it from
 876 /// a channel announcement, but before receiving a node announcement.
 877 #[no_mangle]
 878 pub extern "C" fn NodeInfo_set_announcement_info(this_ptr: &mut NodeInfo, mut val: crate::routing::network_graph::NodeAnnouncementInfo) {
 879         let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
 880         unsafe { &mut *this_ptr.inner }.announcement_info = local_val;
 881 }
 882 #[must_use]
 883 #[no_mangle]
 884 pub extern "C" fn NodeInfo_new(mut channels_arg: crate::c_types::derived::CVec_u64Z, mut lowest_inbound_channel_fees_arg: crate::routing::network_graph::RoutingFees, mut announcement_info_arg: crate::routing::network_graph::NodeAnnouncementInfo) -> NodeInfo {
 885         let mut local_channels_arg = Vec::new(); for mut item in channels_arg.into_rust().drain(..) { local_channels_arg.push( { item }); };
 886         let mut local_lowest_inbound_channel_fees_arg = if lowest_inbound_channel_fees_arg.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(lowest_inbound_channel_fees_arg.take_inner()) } }) };
 887         let mut local_announcement_info_arg = if announcement_info_arg.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(announcement_info_arg.take_inner()) } }) };
 888         NodeInfo { inner: Box::into_raw(Box::new(nativeNodeInfo {
 889                 channels: local_channels_arg,
 890                 lowest_inbound_channel_fees: local_lowest_inbound_channel_fees_arg,
 891                 announcement_info: local_announcement_info_arg,
 892         })), is_owned: true }
 893 }
 894 #[no_mangle]
 895 pub extern "C" fn NodeInfo_write(obj: &NodeInfo) -> crate::c_types::derived::CVec_u8Z {
 896         crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
 897 }
 898 #[no_mangle]
 899 pub(crate) extern "C" fn NodeInfo_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
 900         crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeNodeInfo) })
 901 }
 902 #[no_mangle]
 903 pub extern "C" fn NodeInfo_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_NodeInfoDecodeErrorZ {
 904         let res = crate::c_types::deserialize_obj(ser);
 905         let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::routing::network_graph::NodeInfo { inner: Box::into_raw(Box::new(o)), is_owned: true } }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 906         local_res
 907 }
 908 #[no_mangle]
 909 pub extern "C" fn NetworkGraph_write(obj: &NetworkGraph) -> crate::c_types::derived::CVec_u8Z {
 910         crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
 911 }
 912 #[no_mangle]
 913 pub(crate) extern "C" fn NetworkGraph_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
 914         crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeNetworkGraph) })
 915 }
 916 #[no_mangle]
 917 pub extern "C" fn NetworkGraph_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_NetworkGraphDecodeErrorZ {
 918         let res = crate::c_types::deserialize_obj(ser);
 919         let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::routing::network_graph::NetworkGraph { inner: Box::into_raw(Box::new(o)), is_owned: true } }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 920         local_res
 921 }
 922 /// Creates a new, empty, network graph.
 923 #[must_use]
 924 #[no_mangle]
 925 pub extern "C" fn NetworkGraph_new(mut genesis_hash: crate::c_types::ThirtyTwoBytes) -> crate::routing::network_graph::NetworkGraph {
 926         let mut ret = lightning::routing::network_graph::NetworkGraph::new(::bitcoin::hash_types::BlockHash::from_slice(&genesis_hash.data[..]).unwrap());
 927         crate::routing::network_graph::NetworkGraph { inner: Box::into_raw(Box::new(ret)), is_owned: true }
 928 }
 929
 930 /// For an already known node (from channel announcements), update its stored properties from a
 931 /// given node announcement.
 932 ///
 933 /// You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
 934 /// RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
 935 /// routing messages from a source using a protocol other than the lightning P2P protocol.
 936 #[must_use]
 937 #[no_mangle]
 938 pub extern "C" fn NetworkGraph_update_node_from_announcement(this_arg: &mut NetworkGraph, msg: &crate::ln::msgs::NodeAnnouncement) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
 939         let mut ret = unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.update_node_from_announcement(unsafe { &*msg.inner }, &bitcoin::secp256k1::Secp256k1::new());
 940         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 941         local_ret
 942 }
 943
 944 /// For an already known node (from channel announcements), update its stored properties from a
 945 /// given node announcement without verifying the associated signatures. Because we aren't
 946 /// given the associated signatures here we cannot relay the node announcement to any of our
 947 /// peers.
 948 #[must_use]
 949 #[no_mangle]
 950 pub extern "C" fn NetworkGraph_update_node_from_unsigned_announcement(this_arg: &mut NetworkGraph, msg: &crate::ln::msgs::UnsignedNodeAnnouncement) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
 951         let mut ret = unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.update_node_from_unsigned_announcement(unsafe { &*msg.inner });
 952         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 953         local_ret
 954 }
 955
 956 /// Store or update channel info from a channel announcement.
 957 ///
 958 /// You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
 959 /// RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
 960 /// routing messages from a source using a protocol other than the lightning P2P protocol.
 961 ///
 962 /// If a `chain::Access` object is provided via `chain_access`, it will be called to verify
 963 /// the corresponding UTXO exists on chain and is correctly-formatted.
 964 #[must_use]
 965 #[no_mangle]
 966 pub extern "C" fn NetworkGraph_update_channel_from_announcement(this_arg: &mut NetworkGraph, msg: &crate::ln::msgs::ChannelAnnouncement, chain_access: *mut crate::chain::Access) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
 967         let mut local_chain_access = if chain_access == std::ptr::null_mut() { None } else { Some( { unsafe { *Box::from_raw(chain_access) } }) };
 968         let mut ret = unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.update_channel_from_announcement(unsafe { &*msg.inner }, &local_chain_access, &bitcoin::secp256k1::Secp256k1::new());
 969         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 970         local_ret
 971 }
 972
 973 /// Store or update channel info from a channel announcement without verifying the associated
 974 /// signatures. Because we aren't given the associated signatures here we cannot relay the
 975 /// channel announcement to any of our peers.
 976 ///
 977 /// If a `chain::Access` object is provided via `chain_access`, it will be called to verify
 978 /// the corresponding UTXO exists on chain and is correctly-formatted.
 979 #[must_use]
 980 #[no_mangle]
 981 pub extern "C" fn NetworkGraph_update_channel_from_unsigned_announcement(this_arg: &mut NetworkGraph, msg: &crate::ln::msgs::UnsignedChannelAnnouncement, chain_access: *mut crate::chain::Access) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
 982         let mut local_chain_access = if chain_access == std::ptr::null_mut() { None } else { Some( { unsafe { *Box::from_raw(chain_access) } }) };
 983         let mut ret = unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.update_channel_from_unsigned_announcement(unsafe { &*msg.inner }, &local_chain_access);
 984         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
 985         local_ret
 986 }
 987
 988 /// Close a channel if a corresponding HTLC fail was sent.
 989 /// If permanent, removes a channel from the local storage.
 990 /// May cause the removal of nodes too, if this was their last channel.
 991 /// If not permanent, makes channels unavailable for routing.
 992 #[no_mangle]
 993 pub extern "C" fn NetworkGraph_close_channel_from_update(this_arg: &mut NetworkGraph, mut short_channel_id: u64, mut is_permanent: bool) {
 994         unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.close_channel_from_update(short_channel_id, is_permanent)
 995 }
 996
 997 /// For an already known (from announcement) channel, update info about one of the directions
 998 /// of the channel.
 999 ///
1000 /// You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
1001 /// RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
1002 /// routing messages from a source using a protocol other than the lightning P2P protocol.
1003 #[must_use]
1004 #[no_mangle]
1005 pub extern "C" fn NetworkGraph_update_channel(this_arg: &mut NetworkGraph, msg: &crate::ln::msgs::ChannelUpdate) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
1006         let mut ret = unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.update_channel(unsafe { &*msg.inner }, &bitcoin::secp256k1::Secp256k1::new());
1007         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
1008         local_ret
1009 }
1010
1011 /// For an already known (from announcement) channel, update info about one of the directions
1012 /// of the channel without verifying the associated signatures. Because we aren't given the
1013 /// associated signatures here we cannot relay the channel update to any of our peers.
1014 #[must_use]
1015 #[no_mangle]
1016 pub extern "C" fn NetworkGraph_update_channel_unsigned(this_arg: &mut NetworkGraph, msg: &crate::ln::msgs::UnsignedChannelUpdate) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
1017         let mut ret = unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.update_channel_unsigned(unsafe { &*msg.inner });
1018         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }) };
1019         local_ret
1020 }
1021