_ 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: *const 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: *const 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: *const 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: *const 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) -> RoutingFees {
 651         if let Ok(res) = crate::c_types::deserialize_obj(ser) {
 652                 RoutingFees { inner: Box::into_raw(Box::new(res)), is_owned: true }
 653         } else {
 654                 RoutingFees { inner: std::ptr::null_mut(), is_owned: true }
 655         }
 656 }
 657 #[no_mangle]
 658 pub extern "C" fn RoutingFees_write(obj: *const RoutingFees) -> crate::c_types::derived::CVec_u8Z {
 659         crate::c_types::serialize_obj(unsafe { &(*(*obj).inner) })
 660 }
 661 #[no_mangle]
 662 pub(crate) extern "C" fn RoutingFees_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
 663         crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeRoutingFees) })
 664 }
 665
 666 use lightning::routing::network_graph::NodeAnnouncementInfo as nativeNodeAnnouncementInfoImport;
 667 type nativeNodeAnnouncementInfo = nativeNodeAnnouncementInfoImport;
 668
 669 /// Information received in the latest node_announcement from this node.
 670 #[must_use]
 671 #[repr(C)]
 672 pub struct NodeAnnouncementInfo {
 673         /// Nearly everywhere, inner must be non-null, however in places where
 674         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
 675         pub inner: *mut nativeNodeAnnouncementInfo,
 676         pub is_owned: bool,
 677 }
 678
 679 impl Drop for NodeAnnouncementInfo {
 680         fn drop(&mut self) {
 681                 if self.is_owned && !self.inner.is_null() {
 682                         let _ = unsafe { Box::from_raw(self.inner) };
 683                 }
 684         }
 685 }
 686 #[no_mangle]
 687 pub extern "C" fn NodeAnnouncementInfo_free(this_ptr: NodeAnnouncementInfo) { }
 688 #[allow(unused)]
 689 /// Used only if an object of this type is returned as a trait impl by a method
 690 extern "C" fn NodeAnnouncementInfo_free_void(this_ptr: *mut c_void) {
 691         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeNodeAnnouncementInfo); }
 692 }
 693 #[allow(unused)]
 694 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
 695 impl NodeAnnouncementInfo {
 696         pub(crate) fn take_inner(mut self) -> *mut nativeNodeAnnouncementInfo {
 697                 assert!(self.is_owned);
 698                 let ret = self.inner;
 699                 self.inner = std::ptr::null_mut();
 700                 ret
 701         }
 702 }
 703 /// Protocol features the node announced support for
 704 #[no_mangle]
 705 pub extern "C" fn NodeAnnouncementInfo_get_features(this_ptr: &NodeAnnouncementInfo) -> crate::ln::features::NodeFeatures {
 706         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.features;
 707         crate::ln::features::NodeFeatures { inner: unsafe { ( (&((*inner_val)) as *const _) as *mut _) }, is_owned: false }
 708 }
 709 /// Protocol features the node announced support for
 710 #[no_mangle]
 711 pub extern "C" fn NodeAnnouncementInfo_set_features(this_ptr: &mut NodeAnnouncementInfo, mut val: crate::ln::features::NodeFeatures) {
 712         unsafe { &mut *this_ptr.inner }.features = *unsafe { Box::from_raw(val.take_inner()) };
 713 }
 714 /// When the last known update to the node state was issued.
 715 /// Value is opaque, as set in the announcement.
 716 #[no_mangle]
 717 pub extern "C" fn NodeAnnouncementInfo_get_last_update(this_ptr: &NodeAnnouncementInfo) -> u32 {
 718         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.last_update;
 719         (*inner_val)
 720 }
 721 /// When the last known update to the node state was issued.
 722 /// Value is opaque, as set in the announcement.
 723 #[no_mangle]
 724 pub extern "C" fn NodeAnnouncementInfo_set_last_update(this_ptr: &mut NodeAnnouncementInfo, mut val: u32) {
 725         unsafe { &mut *this_ptr.inner }.last_update = val;
 726 }
 727 /// Color assigned to the node
 728 #[no_mangle]
 729 pub extern "C" fn NodeAnnouncementInfo_get_rgb(this_ptr: &NodeAnnouncementInfo) -> *const [u8; 3] {
 730         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.rgb;
 731         &(*inner_val)
 732 }
 733 /// Color assigned to the node
 734 #[no_mangle]
 735 pub extern "C" fn NodeAnnouncementInfo_set_rgb(this_ptr: &mut NodeAnnouncementInfo, mut val: crate::c_types::ThreeBytes) {
 736         unsafe { &mut *this_ptr.inner }.rgb = val.data;
 737 }
 738 /// Moniker assigned to the node.
 739 /// May be invalid or malicious (eg control chars),
 740 /// should not be exposed to the user.
 741 #[no_mangle]
 742 pub extern "C" fn NodeAnnouncementInfo_get_alias(this_ptr: &NodeAnnouncementInfo) -> *const [u8; 32] {
 743         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.alias;
 744         &(*inner_val)
 745 }
 746 /// Moniker assigned to the node.
 747 /// May be invalid or malicious (eg control chars),
 748 /// should not be exposed to the user.
 749 #[no_mangle]
 750 pub extern "C" fn NodeAnnouncementInfo_set_alias(this_ptr: &mut NodeAnnouncementInfo, mut val: crate::c_types::ThirtyTwoBytes) {
 751         unsafe { &mut *this_ptr.inner }.alias = val.data;
 752 }
 753 /// Internet-level addresses via which one can connect to the node
 754 #[no_mangle]
 755 pub extern "C" fn NodeAnnouncementInfo_set_addresses(this_ptr: &mut NodeAnnouncementInfo, mut val: crate::c_types::derived::CVec_NetAddressZ) {
 756         let mut local_val = Vec::new(); for mut item in val.into_rust().drain(..) { local_val.push( { item.into_native() }); };
 757         unsafe { &mut *this_ptr.inner }.addresses = local_val;
 758 }
 759 /// An initial announcement of the node
 760 /// Mostly redundant with the data we store in fields explicitly.
 761 /// Everything else is useful only for sending out for initial routing sync.
 762 /// Not stored if contains excess data to prevent DoS.
 763 #[no_mangle]
 764 pub extern "C" fn NodeAnnouncementInfo_get_announcement_message(this_ptr: &NodeAnnouncementInfo) -> crate::ln::msgs::NodeAnnouncement {
 765         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.announcement_message;
 766         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 };
 767         local_inner_val
 768 }
 769 /// An initial announcement of the node
 770 /// Mostly redundant with the data we store in fields explicitly.
 771 /// Everything else is useful only for sending out for initial routing sync.
 772 /// Not stored if contains excess data to prevent DoS.
 773 #[no_mangle]
 774 pub extern "C" fn NodeAnnouncementInfo_set_announcement_message(this_ptr: &mut NodeAnnouncementInfo, mut val: crate::ln::msgs::NodeAnnouncement) {
 775         let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
 776         unsafe { &mut *this_ptr.inner }.announcement_message = local_val;
 777 }
 778 #[must_use]
 779 #[no_mangle]
 780 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 {
 781         let mut local_addresses_arg = Vec::new(); for mut item in addresses_arg.into_rust().drain(..) { local_addresses_arg.push( { item.into_native() }); };
 782         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()) } }) };
 783         NodeAnnouncementInfo { inner: Box::into_raw(Box::new(nativeNodeAnnouncementInfo {
 784                 features: *unsafe { Box::from_raw(features_arg.take_inner()) },
 785                 last_update: last_update_arg,
 786                 rgb: rgb_arg.data,
 787                 alias: alias_arg.data,
 788                 addresses: local_addresses_arg,
 789                 announcement_message: local_announcement_message_arg,
 790         })), is_owned: true }
 791 }
 792 #[no_mangle]
 793 pub extern "C" fn NodeAnnouncementInfo_write(obj: *const NodeAnnouncementInfo) -> crate::c_types::derived::CVec_u8Z {
 794         crate::c_types::serialize_obj(unsafe { &(*(*obj).inner) })
 795 }
 796 #[no_mangle]
 797 pub(crate) extern "C" fn NodeAnnouncementInfo_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
 798         crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeNodeAnnouncementInfo) })
 799 }
 800 #[no_mangle]
 801 pub extern "C" fn NodeAnnouncementInfo_read(ser: crate::c_types::u8slice) -> NodeAnnouncementInfo {
 802         if let Ok(res) = crate::c_types::deserialize_obj(ser) {
 803                 NodeAnnouncementInfo { inner: Box::into_raw(Box::new(res)), is_owned: true }
 804         } else {
 805                 NodeAnnouncementInfo { inner: std::ptr::null_mut(), is_owned: true }
 806         }
 807 }
 808
 809 use lightning::routing::network_graph::NodeInfo as nativeNodeInfoImport;
 810 type nativeNodeInfo = nativeNodeInfoImport;
 811
 812 /// Details about a node in the network, known from the network announcement.
 813 #[must_use]
 814 #[repr(C)]
 815 pub struct NodeInfo {
 816         /// Nearly everywhere, inner must be non-null, however in places where
 817         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
 818         pub inner: *mut nativeNodeInfo,
 819         pub is_owned: bool,
 820 }
 821
 822 impl Drop for NodeInfo {
 823         fn drop(&mut self) {
 824                 if self.is_owned && !self.inner.is_null() {
 825                         let _ = unsafe { Box::from_raw(self.inner) };
 826                 }
 827         }
 828 }
 829 #[no_mangle]
 830 pub extern "C" fn NodeInfo_free(this_ptr: NodeInfo) { }
 831 #[allow(unused)]
 832 /// Used only if an object of this type is returned as a trait impl by a method
 833 extern "C" fn NodeInfo_free_void(this_ptr: *mut c_void) {
 834         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeNodeInfo); }
 835 }
 836 #[allow(unused)]
 837 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
 838 impl NodeInfo {
 839         pub(crate) fn take_inner(mut self) -> *mut nativeNodeInfo {
 840                 assert!(self.is_owned);
 841                 let ret = self.inner;
 842                 self.inner = std::ptr::null_mut();
 843                 ret
 844         }
 845 }
 846 /// All valid channels a node has announced
 847 #[no_mangle]
 848 pub extern "C" fn NodeInfo_set_channels(this_ptr: &mut NodeInfo, mut val: crate::c_types::derived::CVec_u64Z) {
 849         let mut local_val = Vec::new(); for mut item in val.into_rust().drain(..) { local_val.push( { item }); };
 850         unsafe { &mut *this_ptr.inner }.channels = local_val;
 851 }
 852 /// Lowest fees enabling routing via any of the enabled, known channels to a node.
 853 /// The two fields (flat and proportional fee) are independent,
 854 /// meaning they don't have to refer to the same channel.
 855 #[no_mangle]
 856 pub extern "C" fn NodeInfo_get_lowest_inbound_channel_fees(this_ptr: &NodeInfo) -> crate::routing::network_graph::RoutingFees {
 857         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.lowest_inbound_channel_fees;
 858         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 };
 859         local_inner_val
 860 }
 861 /// Lowest fees enabling routing via any of the enabled, known channels to a node.
 862 /// The two fields (flat and proportional fee) are independent,
 863 /// meaning they don't have to refer to the same channel.
 864 #[no_mangle]
 865 pub extern "C" fn NodeInfo_set_lowest_inbound_channel_fees(this_ptr: &mut NodeInfo, mut val: crate::routing::network_graph::RoutingFees) {
 866         let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
 867         unsafe { &mut *this_ptr.inner }.lowest_inbound_channel_fees = local_val;
 868 }
 869 /// More information about a node from node_announcement.
 870 /// Optional because we store a Node entry after learning about it from
 871 /// a channel announcement, but before receiving a node announcement.
 872 #[no_mangle]
 873 pub extern "C" fn NodeInfo_get_announcement_info(this_ptr: &NodeInfo) -> crate::routing::network_graph::NodeAnnouncementInfo {
 874         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.announcement_info;
 875         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 };
 876         local_inner_val
 877 }
 878 /// More information about a node from node_announcement.
 879 /// Optional because we store a Node entry after learning about it from
 880 /// a channel announcement, but before receiving a node announcement.
 881 #[no_mangle]
 882 pub extern "C" fn NodeInfo_set_announcement_info(this_ptr: &mut NodeInfo, mut val: crate::routing::network_graph::NodeAnnouncementInfo) {
 883         let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
 884         unsafe { &mut *this_ptr.inner }.announcement_info = local_val;
 885 }
 886 #[must_use]
 887 #[no_mangle]
 888 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 {
 889         let mut local_channels_arg = Vec::new(); for mut item in channels_arg.into_rust().drain(..) { local_channels_arg.push( { item }); };
 890         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()) } }) };
 891         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()) } }) };
 892         NodeInfo { inner: Box::into_raw(Box::new(nativeNodeInfo {
 893                 channels: local_channels_arg,
 894                 lowest_inbound_channel_fees: local_lowest_inbound_channel_fees_arg,
 895                 announcement_info: local_announcement_info_arg,
 896         })), is_owned: true }
 897 }
 898 #[no_mangle]
 899 pub extern "C" fn NodeInfo_write(obj: *const NodeInfo) -> crate::c_types::derived::CVec_u8Z {
 900         crate::c_types::serialize_obj(unsafe { &(*(*obj).inner) })
 901 }
 902 #[no_mangle]
 903 pub(crate) extern "C" fn NodeInfo_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
 904         crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeNodeInfo) })
 905 }
 906 #[no_mangle]
 907 pub extern "C" fn NodeInfo_read(ser: crate::c_types::u8slice) -> NodeInfo {
 908         if let Ok(res) = crate::c_types::deserialize_obj(ser) {
 909                 NodeInfo { inner: Box::into_raw(Box::new(res)), is_owned: true }
 910         } else {
 911                 NodeInfo { inner: std::ptr::null_mut(), is_owned: true }
 912         }
 913 }
 914 #[no_mangle]
 915 pub extern "C" fn NetworkGraph_write(obj: *const NetworkGraph) -> crate::c_types::derived::CVec_u8Z {
 916         crate::c_types::serialize_obj(unsafe { &(*(*obj).inner) })
 917 }
 918 #[no_mangle]
 919 pub(crate) extern "C" fn NetworkGraph_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
 920         crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeNetworkGraph) })
 921 }
 922 #[no_mangle]
 923 pub extern "C" fn NetworkGraph_read(ser: crate::c_types::u8slice) -> NetworkGraph {
 924         if let Ok(res) = crate::c_types::deserialize_obj(ser) {
 925                 NetworkGraph { inner: Box::into_raw(Box::new(res)), is_owned: true }
 926         } else {
 927                 NetworkGraph { inner: std::ptr::null_mut(), is_owned: true }
 928         }
 929 }
 930 /// Creates a new, empty, network graph.
 931 #[must_use]
 932 #[no_mangle]
 933 pub extern "C" fn NetworkGraph_new(mut genesis_hash: crate::c_types::ThirtyTwoBytes) -> crate::routing::network_graph::NetworkGraph {
 934         let mut ret = lightning::routing::network_graph::NetworkGraph::new(::bitcoin::hash_types::BlockHash::from_slice(&genesis_hash.data[..]).unwrap());
 935         crate::routing::network_graph::NetworkGraph { inner: Box::into_raw(Box::new(ret)), is_owned: true }
 936 }
 937
 938 /// For an already known node (from channel announcements), update its stored properties from a
 939 /// given node announcement.
 940 ///
 941 /// You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
 942 /// RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
 943 /// routing messages from a source using a protocol other than the lightning P2P protocol.
 944 #[must_use]
 945 #[no_mangle]
 946 pub extern "C" fn NetworkGraph_update_node_from_announcement(this_arg: &mut NetworkGraph, msg: &crate::ln::msgs::NodeAnnouncement) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
 947         let mut ret = unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.update_node_from_announcement(unsafe { &*msg.inner }, &bitcoin::secp256k1::Secp256k1::new());
 948         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 } }) };
 949         local_ret
 950 }
 951
 952 /// For an already known node (from channel announcements), update its stored properties from a
 953 /// given node announcement without verifying the associated signatures. Because we aren't
 954 /// given the associated signatures here we cannot relay the node announcement to any of our
 955 /// peers.
 956 #[must_use]
 957 #[no_mangle]
 958 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 {
 959         let mut ret = unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.update_node_from_unsigned_announcement(unsafe { &*msg.inner });
 960         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 } }) };
 961         local_ret
 962 }
 963
 964 /// Store or update channel info from a channel announcement.
 965 ///
 966 /// You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
 967 /// RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
 968 /// routing messages from a source using a protocol other than the lightning P2P protocol.
 969 ///
 970 /// If a `chain::Access` object is provided via `chain_access`, it will be called to verify
 971 /// the corresponding UTXO exists on chain and is correctly-formatted.
 972 #[must_use]
 973 #[no_mangle]
 974 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 {
 975         let mut local_chain_access = if chain_access == std::ptr::null_mut() { None } else { Some( { unsafe { *Box::from_raw(chain_access) } }) };
 976         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());
 977         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 } }) };
 978         local_ret
 979 }
 980
 981 /// Store or update channel info from a channel announcement without verifying the associated
 982 /// signatures. Because we aren't given the associated signatures here we cannot relay the
 983 /// channel announcement to any of our peers.
 984 ///
 985 /// If a `chain::Access` object is provided via `chain_access`, it will be called to verify
 986 /// the corresponding UTXO exists on chain and is correctly-formatted.
 987 #[must_use]
 988 #[no_mangle]
 989 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 {
 990         let mut local_chain_access = if chain_access == std::ptr::null_mut() { None } else { Some( { unsafe { *Box::from_raw(chain_access) } }) };
 991         let mut ret = unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.update_channel_from_unsigned_announcement(unsafe { &*msg.inner }, &local_chain_access);
 992         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 } }) };
 993         local_ret
 994 }
 995
 996 /// Close a channel if a corresponding HTLC fail was sent.
 997 /// If permanent, removes a channel from the local storage.
 998 /// May cause the removal of nodes too, if this was their last channel.
 999 /// If not permanent, makes channels unavailable for routing.
1000 #[no_mangle]
1001 pub extern "C" fn NetworkGraph_close_channel_from_update(this_arg: &mut NetworkGraph, mut short_channel_id: u64, mut is_permanent: bool) {
1002         unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.close_channel_from_update(short_channel_id, is_permanent)
1003 }
1004
1005 /// For an already known (from announcement) channel, update info about one of the directions
1006 /// of the channel.
1007 ///
1008 /// You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
1009 /// RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
1010 /// routing messages from a source using a protocol other than the lightning P2P protocol.
1011 #[must_use]
1012 #[no_mangle]
1013 pub extern "C" fn NetworkGraph_update_channel(this_arg: &mut NetworkGraph, msg: &crate::ln::msgs::ChannelUpdate) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
1014         let mut ret = unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.update_channel(unsafe { &*msg.inner }, &bitcoin::secp256k1::Secp256k1::new());
1015         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 } }) };
1016         local_ret
1017 }
1018
1019 /// For an already known (from announcement) channel, update info about one of the directions
1020 /// of the channel without verifying the associated signatures. Because we aren't given the
1021 /// associated signatures here we cannot relay the channel update to any of our peers.
1022 #[must_use]
1023 #[no_mangle]
1024 pub extern "C" fn NetworkGraph_update_channel_unsigned(this_arg: &mut NetworkGraph, msg: &crate::ln::msgs::UnsignedChannelUpdate) -> crate::c_types::derived::CResult_NoneLightningErrorZ {
1025         let mut ret = unsafe { &mut (*(this_arg.inner as *mut nativeNetworkGraph)) }.update_channel_unsigned(unsafe { &*msg.inner });
1026         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 } }) };
1027         local_ret
1028 }
1029