9f3f8409cfc9484da166c1abb6ae0b45487621a7
[ldk-c-bindings] / lightning-c-bindings / src / ln / peer_handler.rs
1 // This file is Copyright its original authors, visible in version control
2 // history and in the source files from which this was generated.
3 //
4 // This file is licensed under the license available in the LICENSE or LICENSE.md
5 // file in the root of this repository or, if no such file exists, the same
6 // license as that which applies to the original source files from which this
7 // source was automatically generated.
8
9 //! Top level peer message handling and socket handling logic lives here.
10 //!
11 //! Instead of actually servicing sockets ourselves we require that you implement the
12 //! SocketDescriptor interface and use that to receive actions which you should perform on the
13 //! socket, and call into PeerManager with bytes read from the socket. The PeerManager will then
14 //! call into the provided message handlers (probably a ChannelManager and NetGraphmsgHandler) with messages
15 //! they should handle, and encoding/sending response messages.
16
17 use std::ffi::c_void;
18 use bitcoin::hashes::Hash;
19 use crate::c_types::*;
20
21
22 use lightning::ln::peer_handler::IgnoringMessageHandler as nativeIgnoringMessageHandlerImport;
23 type nativeIgnoringMessageHandler = nativeIgnoringMessageHandlerImport;
24
25 /// A dummy struct which implements `RoutingMessageHandler` without storing any routing information
26 /// or doing any processing. You can provide one of these as the route_handler in a MessageHandler.
27 #[must_use]
28 #[repr(C)]
29 pub struct IgnoringMessageHandler {
30         /// A pointer to the opaque Rust object.
31
32         /// Nearly everywhere, inner must be non-null, however in places where
33         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
34         pub inner: *mut nativeIgnoringMessageHandler,
35         /// Indicates that this is the only struct which contains the same pointer.
36
37         /// Rust functions which take ownership of an object provided via an argument require
38         /// this to be true and invalidate the object pointed to by inner.
39         pub is_owned: bool,
40 }
41
42 impl Drop for IgnoringMessageHandler {
43         fn drop(&mut self) {
44                 if self.is_owned && !<*mut nativeIgnoringMessageHandler>::is_null(self.inner) {
45                         let _ = unsafe { Box::from_raw(self.inner) };
46                 }
47         }
48 }
49 /// Frees any resources used by the IgnoringMessageHandler, if is_owned is set and inner is non-NULL.
50 #[no_mangle]
51 pub extern "C" fn IgnoringMessageHandler_free(this_obj: IgnoringMessageHandler) { }
52 #[allow(unused)]
53 /// Used only if an object of this type is returned as a trait impl by a method
54 extern "C" fn IgnoringMessageHandler_free_void(this_ptr: *mut c_void) {
55         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeIgnoringMessageHandler); }
56 }
57 #[allow(unused)]
58 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
59 impl IgnoringMessageHandler {
60         pub(crate) fn take_inner(mut self) -> *mut nativeIgnoringMessageHandler {
61                 assert!(self.is_owned);
62                 let ret = self.inner;
63                 self.inner = std::ptr::null_mut();
64                 ret
65         }
66 }
67 /// Constructs a new IgnoringMessageHandler given each field
68 #[must_use]
69 #[no_mangle]
70 pub extern "C" fn IgnoringMessageHandler_new() -> IgnoringMessageHandler {
71         IgnoringMessageHandler { inner: Box::into_raw(Box::new(nativeIgnoringMessageHandler {
72         })), is_owned: true }
73 }
74 impl From<nativeIgnoringMessageHandler> for crate::util::events::MessageSendEventsProvider {
75         fn from(obj: nativeIgnoringMessageHandler) -> Self {
76                 let mut rust_obj = IgnoringMessageHandler { inner: Box::into_raw(Box::new(obj)), is_owned: true };
77                 let mut ret = IgnoringMessageHandler_as_MessageSendEventsProvider(&rust_obj);
78                 // 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
79                 rust_obj.inner = std::ptr::null_mut();
80                 ret.free = Some(IgnoringMessageHandler_free_void);
81                 ret
82         }
83 }
84 /// Constructs a new MessageSendEventsProvider which calls the relevant methods on this_arg.
85 /// This copies the `inner` pointer in this_arg and thus the returned MessageSendEventsProvider must be freed before this_arg is
86 #[no_mangle]
87 pub extern "C" fn IgnoringMessageHandler_as_MessageSendEventsProvider(this_arg: &IgnoringMessageHandler) -> crate::util::events::MessageSendEventsProvider {
88         crate::util::events::MessageSendEventsProvider {
89                 this_arg: unsafe { (*this_arg).inner as *mut c_void },
90                 free: None,
91                 get_and_clear_pending_msg_events: IgnoringMessageHandler_MessageSendEventsProvider_get_and_clear_pending_msg_events,
92         }
93 }
94
95 #[must_use]
96 extern "C" fn IgnoringMessageHandler_MessageSendEventsProvider_get_and_clear_pending_msg_events(this_arg: *const c_void) -> crate::c_types::derived::CVec_MessageSendEventZ {
97         let mut ret = <nativeIgnoringMessageHandler as lightning::util::events::MessageSendEventsProvider<>>::get_and_clear_pending_msg_events(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, );
98         let mut local_ret = Vec::new(); for mut item in ret.drain(..) { local_ret.push( { crate::util::events::MessageSendEvent::native_into(item) }); };
99         local_ret.into()
100 }
101
102 impl From<nativeIgnoringMessageHandler> for crate::ln::msgs::RoutingMessageHandler {
103         fn from(obj: nativeIgnoringMessageHandler) -> Self {
104                 let mut rust_obj = IgnoringMessageHandler { inner: Box::into_raw(Box::new(obj)), is_owned: true };
105                 let mut ret = IgnoringMessageHandler_as_RoutingMessageHandler(&rust_obj);
106                 // 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
107                 rust_obj.inner = std::ptr::null_mut();
108                 ret.free = Some(IgnoringMessageHandler_free_void);
109                 ret
110         }
111 }
112 /// Constructs a new RoutingMessageHandler which calls the relevant methods on this_arg.
113 /// This copies the `inner` pointer in this_arg and thus the returned RoutingMessageHandler must be freed before this_arg is
114 #[no_mangle]
115 pub extern "C" fn IgnoringMessageHandler_as_RoutingMessageHandler(this_arg: &IgnoringMessageHandler) -> crate::ln::msgs::RoutingMessageHandler {
116         crate::ln::msgs::RoutingMessageHandler {
117                 this_arg: unsafe { (*this_arg).inner as *mut c_void },
118                 free: None,
119                 handle_node_announcement: IgnoringMessageHandler_RoutingMessageHandler_handle_node_announcement,
120                 handle_channel_announcement: IgnoringMessageHandler_RoutingMessageHandler_handle_channel_announcement,
121                 handle_channel_update: IgnoringMessageHandler_RoutingMessageHandler_handle_channel_update,
122                 handle_htlc_fail_channel_update: IgnoringMessageHandler_RoutingMessageHandler_handle_htlc_fail_channel_update,
123                 get_next_channel_announcements: IgnoringMessageHandler_RoutingMessageHandler_get_next_channel_announcements,
124                 get_next_node_announcements: IgnoringMessageHandler_RoutingMessageHandler_get_next_node_announcements,
125                 sync_routing_table: IgnoringMessageHandler_RoutingMessageHandler_sync_routing_table,
126                 handle_reply_channel_range: IgnoringMessageHandler_RoutingMessageHandler_handle_reply_channel_range,
127                 handle_reply_short_channel_ids_end: IgnoringMessageHandler_RoutingMessageHandler_handle_reply_short_channel_ids_end,
128                 handle_query_channel_range: IgnoringMessageHandler_RoutingMessageHandler_handle_query_channel_range,
129                 handle_query_short_channel_ids: IgnoringMessageHandler_RoutingMessageHandler_handle_query_short_channel_ids,
130                 MessageSendEventsProvider: crate::util::events::MessageSendEventsProvider {
131                         this_arg: unsafe { (*this_arg).inner as *mut c_void },
132                         free: None,
133                         get_and_clear_pending_msg_events: IgnoringMessageHandler_RoutingMessageHandler_get_and_clear_pending_msg_events,
134                 },
135         }
136 }
137
138 #[must_use]
139 extern "C" fn IgnoringMessageHandler_RoutingMessageHandler_handle_node_announcement(this_arg: *const c_void, _msg: &crate::ln::msgs::NodeAnnouncement) -> crate::c_types::derived::CResult_boolLightningErrorZ {
140         let mut ret = <nativeIgnoringMessageHandler as lightning::ln::msgs::RoutingMessageHandler<>>::handle_node_announcement(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, unsafe { &*_msg.inner });
141         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { o }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
142         local_ret
143 }
144 #[must_use]
145 extern "C" fn IgnoringMessageHandler_RoutingMessageHandler_handle_channel_announcement(this_arg: *const c_void, _msg: &crate::ln::msgs::ChannelAnnouncement) -> crate::c_types::derived::CResult_boolLightningErrorZ {
146         let mut ret = <nativeIgnoringMessageHandler as lightning::ln::msgs::RoutingMessageHandler<>>::handle_channel_announcement(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, unsafe { &*_msg.inner });
147         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { o }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
148         local_ret
149 }
150 #[must_use]
151 extern "C" fn IgnoringMessageHandler_RoutingMessageHandler_handle_channel_update(this_arg: *const c_void, _msg: &crate::ln::msgs::ChannelUpdate) -> crate::c_types::derived::CResult_boolLightningErrorZ {
152         let mut ret = <nativeIgnoringMessageHandler as lightning::ln::msgs::RoutingMessageHandler<>>::handle_channel_update(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, unsafe { &*_msg.inner });
153         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { o }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
154         local_ret
155 }
156 extern "C" fn IgnoringMessageHandler_RoutingMessageHandler_handle_htlc_fail_channel_update(this_arg: *const c_void, _update: &crate::ln::msgs::HTLCFailChannelUpdate) {
157         <nativeIgnoringMessageHandler as lightning::ln::msgs::RoutingMessageHandler<>>::handle_htlc_fail_channel_update(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, &_update.to_native())
158 }
159 #[must_use]
160 extern "C" fn IgnoringMessageHandler_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 {
161         let mut ret = <nativeIgnoringMessageHandler as lightning::ln::msgs::RoutingMessageHandler<>>::get_next_channel_announcements(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, _starting_point, _batch_amount);
162         let mut local_ret = Vec::new(); for mut 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 }); };
163         local_ret.into()
164 }
165 #[must_use]
166 extern "C" fn IgnoringMessageHandler_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 {
167         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();
168         let mut ret = <nativeIgnoringMessageHandler as lightning::ln::msgs::RoutingMessageHandler<>>::get_next_node_announcements(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, local__starting_point, _batch_amount);
169         let mut local_ret = Vec::new(); for mut item in ret.drain(..) { local_ret.push( { crate::ln::msgs::NodeAnnouncement { inner: Box::into_raw(Box::new(item)), is_owned: true } }); };
170         local_ret.into()
171 }
172 extern "C" fn IgnoringMessageHandler_RoutingMessageHandler_sync_routing_table(this_arg: *const c_void, mut _their_node_id: crate::c_types::PublicKey, _init: &crate::ln::msgs::Init) {
173         <nativeIgnoringMessageHandler as lightning::ln::msgs::RoutingMessageHandler<>>::sync_routing_table(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, &_their_node_id.into_rust(), unsafe { &*_init.inner })
174 }
175 #[must_use]
176 extern "C" fn IgnoringMessageHandler_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 {
177         let mut ret = <nativeIgnoringMessageHandler as lightning::ln::msgs::RoutingMessageHandler<>>::handle_reply_channel_range(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, &_their_node_id.into_rust(), *unsafe { Box::from_raw(_msg.take_inner()) });
178         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
179         local_ret
180 }
181 #[must_use]
182 extern "C" fn IgnoringMessageHandler_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 {
183         let mut ret = <nativeIgnoringMessageHandler as lightning::ln::msgs::RoutingMessageHandler<>>::handle_reply_short_channel_ids_end(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, &_their_node_id.into_rust(), *unsafe { Box::from_raw(_msg.take_inner()) });
184         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
185         local_ret
186 }
187 #[must_use]
188 extern "C" fn IgnoringMessageHandler_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 {
189         let mut ret = <nativeIgnoringMessageHandler as lightning::ln::msgs::RoutingMessageHandler<>>::handle_query_channel_range(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, &_their_node_id.into_rust(), *unsafe { Box::from_raw(_msg.take_inner()) });
190         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
191         local_ret
192 }
193 #[must_use]
194 extern "C" fn IgnoringMessageHandler_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 {
195         let mut ret = <nativeIgnoringMessageHandler as lightning::ln::msgs::RoutingMessageHandler<>>::handle_query_short_channel_ids(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, &_their_node_id.into_rust(), *unsafe { Box::from_raw(_msg.take_inner()) });
196         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::LightningError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
197         local_ret
198 }
199 #[must_use]
200 extern "C" fn IgnoringMessageHandler_RoutingMessageHandler_get_and_clear_pending_msg_events(this_arg: *const c_void) -> crate::c_types::derived::CVec_MessageSendEventZ {
201         let mut ret = <nativeIgnoringMessageHandler as lightning::util::events::MessageSendEventsProvider<>>::get_and_clear_pending_msg_events(unsafe { &mut *(this_arg as *mut nativeIgnoringMessageHandler) }, );
202         let mut local_ret = Vec::new(); for mut item in ret.drain(..) { local_ret.push( { crate::util::events::MessageSendEvent::native_into(item) }); };
203         local_ret.into()
204 }
205
206
207 use lightning::ln::peer_handler::ErroringMessageHandler as nativeErroringMessageHandlerImport;
208 type nativeErroringMessageHandler = nativeErroringMessageHandlerImport;
209
210 /// A dummy struct which implements `ChannelMessageHandler` without having any channels.
211 /// You can provide one of these as the route_handler in a MessageHandler.
212 #[must_use]
213 #[repr(C)]
214 pub struct ErroringMessageHandler {
215         /// A pointer to the opaque Rust object.
216
217         /// Nearly everywhere, inner must be non-null, however in places where
218         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
219         pub inner: *mut nativeErroringMessageHandler,
220         /// Indicates that this is the only struct which contains the same pointer.
221
222         /// Rust functions which take ownership of an object provided via an argument require
223         /// this to be true and invalidate the object pointed to by inner.
224         pub is_owned: bool,
225 }
226
227 impl Drop for ErroringMessageHandler {
228         fn drop(&mut self) {
229                 if self.is_owned && !<*mut nativeErroringMessageHandler>::is_null(self.inner) {
230                         let _ = unsafe { Box::from_raw(self.inner) };
231                 }
232         }
233 }
234 /// Frees any resources used by the ErroringMessageHandler, if is_owned is set and inner is non-NULL.
235 #[no_mangle]
236 pub extern "C" fn ErroringMessageHandler_free(this_obj: ErroringMessageHandler) { }
237 #[allow(unused)]
238 /// Used only if an object of this type is returned as a trait impl by a method
239 extern "C" fn ErroringMessageHandler_free_void(this_ptr: *mut c_void) {
240         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeErroringMessageHandler); }
241 }
242 #[allow(unused)]
243 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
244 impl ErroringMessageHandler {
245         pub(crate) fn take_inner(mut self) -> *mut nativeErroringMessageHandler {
246                 assert!(self.is_owned);
247                 let ret = self.inner;
248                 self.inner = std::ptr::null_mut();
249                 ret
250         }
251 }
252 /// Constructs a new ErroringMessageHandler
253 #[must_use]
254 #[no_mangle]
255 pub extern "C" fn ErroringMessageHandler_new() -> ErroringMessageHandler {
256         let mut ret = lightning::ln::peer_handler::ErroringMessageHandler::new();
257         ErroringMessageHandler { inner: Box::into_raw(Box::new(ret)), is_owned: true }
258 }
259
260 impl From<nativeErroringMessageHandler> for crate::util::events::MessageSendEventsProvider {
261         fn from(obj: nativeErroringMessageHandler) -> Self {
262                 let mut rust_obj = ErroringMessageHandler { inner: Box::into_raw(Box::new(obj)), is_owned: true };
263                 let mut ret = ErroringMessageHandler_as_MessageSendEventsProvider(&rust_obj);
264                 // 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
265                 rust_obj.inner = std::ptr::null_mut();
266                 ret.free = Some(ErroringMessageHandler_free_void);
267                 ret
268         }
269 }
270 /// Constructs a new MessageSendEventsProvider which calls the relevant methods on this_arg.
271 /// This copies the `inner` pointer in this_arg and thus the returned MessageSendEventsProvider must be freed before this_arg is
272 #[no_mangle]
273 pub extern "C" fn ErroringMessageHandler_as_MessageSendEventsProvider(this_arg: &ErroringMessageHandler) -> crate::util::events::MessageSendEventsProvider {
274         crate::util::events::MessageSendEventsProvider {
275                 this_arg: unsafe { (*this_arg).inner as *mut c_void },
276                 free: None,
277                 get_and_clear_pending_msg_events: ErroringMessageHandler_MessageSendEventsProvider_get_and_clear_pending_msg_events,
278         }
279 }
280
281 #[must_use]
282 extern "C" fn ErroringMessageHandler_MessageSendEventsProvider_get_and_clear_pending_msg_events(this_arg: *const c_void) -> crate::c_types::derived::CVec_MessageSendEventZ {
283         let mut ret = <nativeErroringMessageHandler as lightning::util::events::MessageSendEventsProvider<>>::get_and_clear_pending_msg_events(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, );
284         let mut local_ret = Vec::new(); for mut item in ret.drain(..) { local_ret.push( { crate::util::events::MessageSendEvent::native_into(item) }); };
285         local_ret.into()
286 }
287
288 impl From<nativeErroringMessageHandler> for crate::ln::msgs::ChannelMessageHandler {
289         fn from(obj: nativeErroringMessageHandler) -> Self {
290                 let mut rust_obj = ErroringMessageHandler { inner: Box::into_raw(Box::new(obj)), is_owned: true };
291                 let mut ret = ErroringMessageHandler_as_ChannelMessageHandler(&rust_obj);
292                 // 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
293                 rust_obj.inner = std::ptr::null_mut();
294                 ret.free = Some(ErroringMessageHandler_free_void);
295                 ret
296         }
297 }
298 /// Constructs a new ChannelMessageHandler which calls the relevant methods on this_arg.
299 /// This copies the `inner` pointer in this_arg and thus the returned ChannelMessageHandler must be freed before this_arg is
300 #[no_mangle]
301 pub extern "C" fn ErroringMessageHandler_as_ChannelMessageHandler(this_arg: &ErroringMessageHandler) -> crate::ln::msgs::ChannelMessageHandler {
302         crate::ln::msgs::ChannelMessageHandler {
303                 this_arg: unsafe { (*this_arg).inner as *mut c_void },
304                 free: None,
305                 handle_open_channel: ErroringMessageHandler_ChannelMessageHandler_handle_open_channel,
306                 handle_accept_channel: ErroringMessageHandler_ChannelMessageHandler_handle_accept_channel,
307                 handle_funding_created: ErroringMessageHandler_ChannelMessageHandler_handle_funding_created,
308                 handle_funding_signed: ErroringMessageHandler_ChannelMessageHandler_handle_funding_signed,
309                 handle_funding_locked: ErroringMessageHandler_ChannelMessageHandler_handle_funding_locked,
310                 handle_shutdown: ErroringMessageHandler_ChannelMessageHandler_handle_shutdown,
311                 handle_closing_signed: ErroringMessageHandler_ChannelMessageHandler_handle_closing_signed,
312                 handle_update_add_htlc: ErroringMessageHandler_ChannelMessageHandler_handle_update_add_htlc,
313                 handle_update_fulfill_htlc: ErroringMessageHandler_ChannelMessageHandler_handle_update_fulfill_htlc,
314                 handle_update_fail_htlc: ErroringMessageHandler_ChannelMessageHandler_handle_update_fail_htlc,
315                 handle_update_fail_malformed_htlc: ErroringMessageHandler_ChannelMessageHandler_handle_update_fail_malformed_htlc,
316                 handle_commitment_signed: ErroringMessageHandler_ChannelMessageHandler_handle_commitment_signed,
317                 handle_revoke_and_ack: ErroringMessageHandler_ChannelMessageHandler_handle_revoke_and_ack,
318                 handle_update_fee: ErroringMessageHandler_ChannelMessageHandler_handle_update_fee,
319                 handle_announcement_signatures: ErroringMessageHandler_ChannelMessageHandler_handle_announcement_signatures,
320                 peer_disconnected: ErroringMessageHandler_ChannelMessageHandler_peer_disconnected,
321                 peer_connected: ErroringMessageHandler_ChannelMessageHandler_peer_connected,
322                 handle_channel_reestablish: ErroringMessageHandler_ChannelMessageHandler_handle_channel_reestablish,
323                 handle_channel_update: ErroringMessageHandler_ChannelMessageHandler_handle_channel_update,
324                 handle_error: ErroringMessageHandler_ChannelMessageHandler_handle_error,
325                 MessageSendEventsProvider: crate::util::events::MessageSendEventsProvider {
326                         this_arg: unsafe { (*this_arg).inner as *mut c_void },
327                         free: None,
328                         get_and_clear_pending_msg_events: ErroringMessageHandler_ChannelMessageHandler_get_and_clear_pending_msg_events,
329                 },
330         }
331 }
332
333 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_open_channel(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, mut _their_features: crate::ln::features::InitFeatures, msg: &crate::ln::msgs::OpenChannel) {
334         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_open_channel(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), *unsafe { Box::from_raw(_their_features.take_inner()) }, unsafe { &*msg.inner })
335 }
336 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_accept_channel(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, mut _their_features: crate::ln::features::InitFeatures, msg: &crate::ln::msgs::AcceptChannel) {
337         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_accept_channel(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), *unsafe { Box::from_raw(_their_features.take_inner()) }, unsafe { &*msg.inner })
338 }
339 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_funding_created(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::FundingCreated) {
340         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_funding_created(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
341 }
342 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_funding_signed(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::FundingSigned) {
343         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_funding_signed(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
344 }
345 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_funding_locked(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::FundingLocked) {
346         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_funding_locked(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
347 }
348 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_shutdown(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, _their_features: &crate::ln::features::InitFeatures, msg: &crate::ln::msgs::Shutdown) {
349         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_shutdown(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*_their_features.inner }, unsafe { &*msg.inner })
350 }
351 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_closing_signed(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::ClosingSigned) {
352         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_closing_signed(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
353 }
354 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_update_add_htlc(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::UpdateAddHTLC) {
355         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_update_add_htlc(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
356 }
357 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_update_fulfill_htlc(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::UpdateFulfillHTLC) {
358         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_update_fulfill_htlc(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
359 }
360 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_update_fail_htlc(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::UpdateFailHTLC) {
361         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_update_fail_htlc(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
362 }
363 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_update_fail_malformed_htlc(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::UpdateFailMalformedHTLC) {
364         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_update_fail_malformed_htlc(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
365 }
366 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_commitment_signed(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::CommitmentSigned) {
367         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_commitment_signed(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
368 }
369 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_revoke_and_ack(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::RevokeAndACK) {
370         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_revoke_and_ack(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
371 }
372 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_update_fee(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::UpdateFee) {
373         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_update_fee(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
374 }
375 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_announcement_signatures(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::AnnouncementSignatures) {
376         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_announcement_signatures(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
377 }
378 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_channel_reestablish(this_arg: *const c_void, mut their_node_id: crate::c_types::PublicKey, msg: &crate::ln::msgs::ChannelReestablish) {
379         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_channel_reestablish(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &their_node_id.into_rust(), unsafe { &*msg.inner })
380 }
381 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_channel_update(this_arg: *const c_void, mut _their_node_id: crate::c_types::PublicKey, _msg: &crate::ln::msgs::ChannelUpdate) {
382         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_channel_update(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &_their_node_id.into_rust(), unsafe { &*_msg.inner })
383 }
384 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_peer_disconnected(this_arg: *const c_void, mut _their_node_id: crate::c_types::PublicKey, mut _no_connection_possible: bool) {
385         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::peer_disconnected(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &_their_node_id.into_rust(), _no_connection_possible)
386 }
387 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_peer_connected(this_arg: *const c_void, mut _their_node_id: crate::c_types::PublicKey, _msg: &crate::ln::msgs::Init) {
388         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::peer_connected(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &_their_node_id.into_rust(), unsafe { &*_msg.inner })
389 }
390 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_handle_error(this_arg: *const c_void, mut _their_node_id: crate::c_types::PublicKey, _msg: &crate::ln::msgs::ErrorMessage) {
391         <nativeErroringMessageHandler as lightning::ln::msgs::ChannelMessageHandler<>>::handle_error(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, &_their_node_id.into_rust(), unsafe { &*_msg.inner })
392 }
393 #[must_use]
394 extern "C" fn ErroringMessageHandler_ChannelMessageHandler_get_and_clear_pending_msg_events(this_arg: *const c_void) -> crate::c_types::derived::CVec_MessageSendEventZ {
395         let mut ret = <nativeErroringMessageHandler as lightning::util::events::MessageSendEventsProvider<>>::get_and_clear_pending_msg_events(unsafe { &mut *(this_arg as *mut nativeErroringMessageHandler) }, );
396         let mut local_ret = Vec::new(); for mut item in ret.drain(..) { local_ret.push( { crate::util::events::MessageSendEvent::native_into(item) }); };
397         local_ret.into()
398 }
399
400
401 use lightning::ln::peer_handler::MessageHandler as nativeMessageHandlerImport;
402 type nativeMessageHandler = nativeMessageHandlerImport<crate::ln::msgs::ChannelMessageHandler, crate::ln::msgs::RoutingMessageHandler>;
403
404 /// Provides references to trait impls which handle different types of messages.
405 #[must_use]
406 #[repr(C)]
407 pub struct MessageHandler {
408         /// A pointer to the opaque Rust object.
409
410         /// Nearly everywhere, inner must be non-null, however in places where
411         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
412         pub inner: *mut nativeMessageHandler,
413         /// Indicates that this is the only struct which contains the same pointer.
414
415         /// Rust functions which take ownership of an object provided via an argument require
416         /// this to be true and invalidate the object pointed to by inner.
417         pub is_owned: bool,
418 }
419
420 impl Drop for MessageHandler {
421         fn drop(&mut self) {
422                 if self.is_owned && !<*mut nativeMessageHandler>::is_null(self.inner) {
423                         let _ = unsafe { Box::from_raw(self.inner) };
424                 }
425         }
426 }
427 /// Frees any resources used by the MessageHandler, if is_owned is set and inner is non-NULL.
428 #[no_mangle]
429 pub extern "C" fn MessageHandler_free(this_obj: MessageHandler) { }
430 #[allow(unused)]
431 /// Used only if an object of this type is returned as a trait impl by a method
432 extern "C" fn MessageHandler_free_void(this_ptr: *mut c_void) {
433         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeMessageHandler); }
434 }
435 #[allow(unused)]
436 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
437 impl MessageHandler {
438         pub(crate) fn take_inner(mut self) -> *mut nativeMessageHandler {
439                 assert!(self.is_owned);
440                 let ret = self.inner;
441                 self.inner = std::ptr::null_mut();
442                 ret
443         }
444 }
445 /// A message handler which handles messages specific to channels. Usually this is just a
446 /// ChannelManager object or a ErroringMessageHandler.
447 #[no_mangle]
448 pub extern "C" fn MessageHandler_get_chan_handler(this_ptr: &MessageHandler) -> *const crate::ln::msgs::ChannelMessageHandler {
449         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.chan_handler;
450         &(*inner_val)
451 }
452 /// A message handler which handles messages specific to channels. Usually this is just a
453 /// ChannelManager object or a ErroringMessageHandler.
454 #[no_mangle]
455 pub extern "C" fn MessageHandler_set_chan_handler(this_ptr: &mut MessageHandler, mut val: crate::ln::msgs::ChannelMessageHandler) {
456         unsafe { &mut *this_ptr.inner }.chan_handler = val;
457 }
458 /// A message handler which handles messages updating our knowledge of the network channel
459 /// graph. Usually this is just a NetGraphMsgHandlerMonitor object or an IgnoringMessageHandler.
460 #[no_mangle]
461 pub extern "C" fn MessageHandler_get_route_handler(this_ptr: &MessageHandler) -> *const crate::ln::msgs::RoutingMessageHandler {
462         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.route_handler;
463         &(*inner_val)
464 }
465 /// A message handler which handles messages updating our knowledge of the network channel
466 /// graph. Usually this is just a NetGraphMsgHandlerMonitor object or an IgnoringMessageHandler.
467 #[no_mangle]
468 pub extern "C" fn MessageHandler_set_route_handler(this_ptr: &mut MessageHandler, mut val: crate::ln::msgs::RoutingMessageHandler) {
469         unsafe { &mut *this_ptr.inner }.route_handler = val;
470 }
471 /// Constructs a new MessageHandler given each field
472 #[must_use]
473 #[no_mangle]
474 pub extern "C" fn MessageHandler_new(mut chan_handler_arg: crate::ln::msgs::ChannelMessageHandler, mut route_handler_arg: crate::ln::msgs::RoutingMessageHandler) -> MessageHandler {
475         MessageHandler { inner: Box::into_raw(Box::new(nativeMessageHandler {
476                 chan_handler: chan_handler_arg,
477                 route_handler: route_handler_arg,
478         })), is_owned: true }
479 }
480 /// Provides an object which can be used to send data to and which uniquely identifies a connection
481 /// to a remote host. You will need to be able to generate multiple of these which meet Eq and
482 /// implement Hash to meet the PeerManager API.
483 ///
484 /// For efficiency, Clone should be relatively cheap for this type.
485 ///
486 /// You probably want to just extend an int and put a file descriptor in a struct and implement
487 /// send_data. Note that if you are using a higher-level net library that may call close() itself,
488 /// be careful to ensure you don't have races whereby you might register a new connection with an
489 /// fd which is the same as a previous one which has yet to be removed via
490 /// PeerManager::socket_disconnected().
491 #[repr(C)]
492 pub struct SocketDescriptor {
493         /// An opaque pointer which is passed to your function implementations as an argument.
494         /// This has no meaning in the LDK, and can be NULL or any other value.
495         pub this_arg: *mut c_void,
496         /// Attempts to send some data from the given slice to the peer.
497         ///
498         /// Returns the amount of data which was sent, possibly 0 if the socket has since disconnected.
499         /// Note that in the disconnected case, socket_disconnected must still fire and further write
500         /// attempts may occur until that time.
501         ///
502         /// If the returned size is smaller than data.len(), a write_available event must
503         /// trigger the next time more data can be written. Additionally, until the a send_data event
504         /// completes fully, no further read_events should trigger on the same peer!
505         ///
506         /// If a read_event on this descriptor had previously returned true (indicating that read
507         /// events should be paused to prevent DoS in the send buffer), resume_read may be set
508         /// indicating that read events on this descriptor should resume. A resume_read of false does
509         /// *not* imply that further read events should be paused.
510         #[must_use]
511         pub send_data: extern "C" fn (this_arg: *mut c_void, data: crate::c_types::u8slice, resume_read: bool) -> usize,
512         /// Disconnect the socket pointed to by this SocketDescriptor. Once this function returns, no
513         /// more calls to write_buffer_space_avail, read_event or socket_disconnected may be made with
514         /// this descriptor. No socket_disconnected call should be generated as a result of this call,
515         /// though races may occur whereby disconnect_socket is called after a call to
516         /// socket_disconnected but prior to socket_disconnected returning.
517         pub disconnect_socket: extern "C" fn (this_arg: *mut c_void),
518         /// Checks if two objects are equal given this object's this_arg pointer and another object.
519         pub eq: extern "C" fn (this_arg: *const c_void, other_arg: &SocketDescriptor) -> bool,
520         /// Calculate a succinct non-cryptographic hash for an object given its this_arg pointer.
521         /// This is used, for example, for inclusion of this object in a hash map.
522         pub hash: extern "C" fn (this_arg: *const c_void) -> u64,
523         /// Creates a copy of the object pointed to by this_arg, for a copy of this SocketDescriptor.
524         /// Note that the ultimate copy of the SocketDescriptor will have all function pointers the same as the original.
525         /// May be NULL if no action needs to be taken, the this_arg pointer will be copied into the new SocketDescriptor.
526         pub clone: Option<extern "C" fn (this_arg: *const c_void) -> *mut c_void>,
527         /// Frees any resources associated with this object given its this_arg pointer.
528         /// Does not need to free the outer struct containing function pointers and may be NULL is no resources need to be freed.
529         pub free: Option<extern "C" fn(this_arg: *mut c_void)>,
530 }
531 impl std::cmp::Eq for SocketDescriptor {}
532 impl std::cmp::PartialEq for SocketDescriptor {
533         fn eq(&self, o: &Self) -> bool { (self.eq)(self.this_arg, o) }
534 }
535 impl std::hash::Hash for SocketDescriptor {
536         fn hash<H: std::hash::Hasher>(&self, hasher: &mut H) { hasher.write_u64((self.hash)(self.this_arg)) }
537 }
538 #[no_mangle]
539 /// Creates a copy of a SocketDescriptor
540 pub extern "C" fn SocketDescriptor_clone(orig: &SocketDescriptor) -> SocketDescriptor {
541         SocketDescriptor {
542                 this_arg: if let Some(f) = orig.clone { (f)(orig.this_arg) } else { orig.this_arg },
543                 send_data: orig.send_data.clone(),
544                 disconnect_socket: orig.disconnect_socket.clone(),
545                 eq: orig.eq.clone(),
546                 hash: orig.hash.clone(),
547                 clone: orig.clone.clone(),
548                 free: orig.free.clone(),
549         }
550 }
551 impl Clone for SocketDescriptor {
552         fn clone(&self) -> Self {
553                 SocketDescriptor_clone(self)
554         }
555 }
556
557 use lightning::ln::peer_handler::SocketDescriptor as rustSocketDescriptor;
558 impl rustSocketDescriptor for SocketDescriptor {
559         fn send_data(&mut self, data: &[u8], resume_read: bool) -> usize {
560                 let mut local_data = crate::c_types::u8slice::from_slice(data);
561                 let mut ret = (self.send_data)(self.this_arg, local_data, resume_read);
562                 ret
563         }
564         fn disconnect_socket(&mut self) {
565                 (self.disconnect_socket)(self.this_arg)
566         }
567 }
568
569 // We're essentially a pointer already, or at least a set of pointers, so allow us to be used
570 // directly as a Deref trait in higher-level structs:
571 impl std::ops::Deref for SocketDescriptor {
572         type Target = Self;
573         fn deref(&self) -> &Self {
574                 self
575         }
576 }
577 /// Calls the free function if one is set
578 #[no_mangle]
579 pub extern "C" fn SocketDescriptor_free(this_ptr: SocketDescriptor) { }
580 impl Drop for SocketDescriptor {
581         fn drop(&mut self) {
582                 if let Some(f) = self.free {
583                         f(self.this_arg);
584                 }
585         }
586 }
587
588 use lightning::ln::peer_handler::PeerHandleError as nativePeerHandleErrorImport;
589 type nativePeerHandleError = nativePeerHandleErrorImport;
590
591 /// Error for PeerManager errors. If you get one of these, you must disconnect the socket and
592 /// generate no further read_event/write_buffer_space_avail/socket_disconnected calls for the
593 /// descriptor.
594 #[must_use]
595 #[repr(C)]
596 pub struct PeerHandleError {
597         /// A pointer to the opaque Rust object.
598
599         /// Nearly everywhere, inner must be non-null, however in places where
600         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
601         pub inner: *mut nativePeerHandleError,
602         /// Indicates that this is the only struct which contains the same pointer.
603
604         /// Rust functions which take ownership of an object provided via an argument require
605         /// this to be true and invalidate the object pointed to by inner.
606         pub is_owned: bool,
607 }
608
609 impl Drop for PeerHandleError {
610         fn drop(&mut self) {
611                 if self.is_owned && !<*mut nativePeerHandleError>::is_null(self.inner) {
612                         let _ = unsafe { Box::from_raw(self.inner) };
613                 }
614         }
615 }
616 /// Frees any resources used by the PeerHandleError, if is_owned is set and inner is non-NULL.
617 #[no_mangle]
618 pub extern "C" fn PeerHandleError_free(this_obj: PeerHandleError) { }
619 #[allow(unused)]
620 /// Used only if an object of this type is returned as a trait impl by a method
621 extern "C" fn PeerHandleError_free_void(this_ptr: *mut c_void) {
622         unsafe { let _ = Box::from_raw(this_ptr as *mut nativePeerHandleError); }
623 }
624 #[allow(unused)]
625 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
626 impl PeerHandleError {
627         pub(crate) fn take_inner(mut self) -> *mut nativePeerHandleError {
628                 assert!(self.is_owned);
629                 let ret = self.inner;
630                 self.inner = std::ptr::null_mut();
631                 ret
632         }
633 }
634 /// Used to indicate that we probably can't make any future connections to this peer, implying
635 /// we should go ahead and force-close any channels we have with it.
636 #[no_mangle]
637 pub extern "C" fn PeerHandleError_get_no_connection_possible(this_ptr: &PeerHandleError) -> bool {
638         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.no_connection_possible;
639         (*inner_val)
640 }
641 /// Used to indicate that we probably can't make any future connections to this peer, implying
642 /// we should go ahead and force-close any channels we have with it.
643 #[no_mangle]
644 pub extern "C" fn PeerHandleError_set_no_connection_possible(this_ptr: &mut PeerHandleError, mut val: bool) {
645         unsafe { &mut *this_ptr.inner }.no_connection_possible = val;
646 }
647 /// Constructs a new PeerHandleError given each field
648 #[must_use]
649 #[no_mangle]
650 pub extern "C" fn PeerHandleError_new(mut no_connection_possible_arg: bool) -> PeerHandleError {
651         PeerHandleError { inner: Box::into_raw(Box::new(nativePeerHandleError {
652                 no_connection_possible: no_connection_possible_arg,
653         })), is_owned: true }
654 }
655 impl Clone for PeerHandleError {
656         fn clone(&self) -> Self {
657                 Self {
658                         inner: if <*mut nativePeerHandleError>::is_null(self.inner) { std::ptr::null_mut() } else {
659                                 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
660                         is_owned: true,
661                 }
662         }
663 }
664 #[allow(unused)]
665 /// Used only if an object of this type is returned as a trait impl by a method
666 pub(crate) extern "C" fn PeerHandleError_clone_void(this_ptr: *const c_void) -> *mut c_void {
667         Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativePeerHandleError)).clone() })) as *mut c_void
668 }
669 #[no_mangle]
670 /// Creates a copy of the PeerHandleError
671 pub extern "C" fn PeerHandleError_clone(orig: &PeerHandleError) -> PeerHandleError {
672         orig.clone()
673 }
674
675 use lightning::ln::peer_handler::PeerManager as nativePeerManagerImport;
676 type nativePeerManager = nativePeerManagerImport<crate::ln::peer_handler::SocketDescriptor, crate::ln::msgs::ChannelMessageHandler, crate::ln::msgs::RoutingMessageHandler, crate::util::logger::Logger>;
677
678 /// A PeerManager manages a set of peers, described by their SocketDescriptor and marshalls socket
679 /// events into messages which it passes on to its MessageHandlers.
680 ///
681 /// Rather than using a plain PeerManager, it is preferable to use either a SimpleArcPeerManager
682 /// a SimpleRefPeerManager, for conciseness. See their documentation for more details, but
683 /// essentially you should default to using a SimpleRefPeerManager, and use a
684 /// SimpleArcPeerManager when you require a PeerManager with a static lifetime, such as when
685 /// you're using lightning-net-tokio.
686 #[must_use]
687 #[repr(C)]
688 pub struct PeerManager {
689         /// A pointer to the opaque Rust object.
690
691         /// Nearly everywhere, inner must be non-null, however in places where
692         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
693         pub inner: *mut nativePeerManager,
694         /// Indicates that this is the only struct which contains the same pointer.
695
696         /// Rust functions which take ownership of an object provided via an argument require
697         /// this to be true and invalidate the object pointed to by inner.
698         pub is_owned: bool,
699 }
700
701 impl Drop for PeerManager {
702         fn drop(&mut self) {
703                 if self.is_owned && !<*mut nativePeerManager>::is_null(self.inner) {
704                         let _ = unsafe { Box::from_raw(self.inner) };
705                 }
706         }
707 }
708 /// Frees any resources used by the PeerManager, if is_owned is set and inner is non-NULL.
709 #[no_mangle]
710 pub extern "C" fn PeerManager_free(this_obj: PeerManager) { }
711 #[allow(unused)]
712 /// Used only if an object of this type is returned as a trait impl by a method
713 extern "C" fn PeerManager_free_void(this_ptr: *mut c_void) {
714         unsafe { let _ = Box::from_raw(this_ptr as *mut nativePeerManager); }
715 }
716 #[allow(unused)]
717 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
718 impl PeerManager {
719         pub(crate) fn take_inner(mut self) -> *mut nativePeerManager {
720                 assert!(self.is_owned);
721                 let ret = self.inner;
722                 self.inner = std::ptr::null_mut();
723                 ret
724         }
725 }
726 /// Constructs a new PeerManager with the given message handlers and node_id secret key
727 /// ephemeral_random_data is used to derive per-connection ephemeral keys and must be
728 /// cryptographically secure random bytes.
729 #[must_use]
730 #[no_mangle]
731 pub extern "C" fn PeerManager_new(mut message_handler: crate::ln::peer_handler::MessageHandler, mut our_node_secret: crate::c_types::SecretKey, ephemeral_random_data: *const [u8; 32], mut logger: crate::util::logger::Logger) -> PeerManager {
732         let mut ret = lightning::ln::peer_handler::PeerManager::new(*unsafe { Box::from_raw(message_handler.take_inner()) }, our_node_secret.into_rust(), unsafe { &*ephemeral_random_data}, logger);
733         PeerManager { inner: Box::into_raw(Box::new(ret)), is_owned: true }
734 }
735
736 /// Get the list of node ids for peers which have completed the initial handshake.
737 ///
738 /// For outbound connections, this will be the same as the their_node_id parameter passed in to
739 /// new_outbound_connection, however entries will only appear once the initial handshake has
740 /// completed and we are sure the remote peer has the private key for the given node_id.
741 #[must_use]
742 #[no_mangle]
743 pub extern "C" fn PeerManager_get_peer_node_ids(this_arg: &PeerManager) -> crate::c_types::derived::CVec_PublicKeyZ {
744         let mut ret = unsafe { &*this_arg.inner }.get_peer_node_ids();
745         let mut local_ret = Vec::new(); for mut item in ret.drain(..) { local_ret.push( { crate::c_types::PublicKey::from_rust(&item) }); };
746         local_ret.into()
747 }
748
749 /// Indicates a new outbound connection has been established to a node with the given node_id.
750 /// Note that if an Err is returned here you MUST NOT call socket_disconnected for the new
751 /// descriptor but must disconnect the connection immediately.
752 ///
753 /// Returns a small number of bytes to send to the remote node (currently always 50).
754 ///
755 /// Panics if descriptor is duplicative with some other descriptor which has not yet had a
756 /// socket_disconnected().
757 #[must_use]
758 #[no_mangle]
759 pub extern "C" fn PeerManager_new_outbound_connection(this_arg: &PeerManager, mut their_node_id: crate::c_types::PublicKey, mut descriptor: crate::ln::peer_handler::SocketDescriptor) -> crate::c_types::derived::CResult_CVec_u8ZPeerHandleErrorZ {
760         let mut ret = unsafe { &*this_arg.inner }.new_outbound_connection(their_node_id.into_rust(), descriptor);
761         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { let mut local_ret_0 = Vec::new(); for mut item in o.drain(..) { local_ret_0.push( { item }); }; local_ret_0.into() }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::peer_handler::PeerHandleError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
762         local_ret
763 }
764
765 /// Indicates a new inbound connection has been established.
766 ///
767 /// May refuse the connection by returning an Err, but will never write bytes to the remote end
768 /// (outbound connector always speaks first). Note that if an Err is returned here you MUST NOT
769 /// call socket_disconnected for the new descriptor but must disconnect the connection
770 /// immediately.
771 ///
772 /// Panics if descriptor is duplicative with some other descriptor which has not yet had
773 /// socket_disconnected called.
774 #[must_use]
775 #[no_mangle]
776 pub extern "C" fn PeerManager_new_inbound_connection(this_arg: &PeerManager, mut descriptor: crate::ln::peer_handler::SocketDescriptor) -> crate::c_types::derived::CResult_NonePeerHandleErrorZ {
777         let mut ret = unsafe { &*this_arg.inner }.new_inbound_connection(descriptor);
778         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::peer_handler::PeerHandleError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
779         local_ret
780 }
781
782 /// Indicates that there is room to write data to the given socket descriptor.
783 ///
784 /// May return an Err to indicate that the connection should be closed.
785 ///
786 /// Will most likely call send_data on the descriptor passed in (or the descriptor handed into
787 /// new_*\\_connection) before returning. Thus, be very careful with reentrancy issues! The
788 /// invariants around calling write_buffer_space_avail in case a write did not fully complete
789 /// must still hold - be ready to call write_buffer_space_avail again if a write call generated
790 /// here isn't sufficient! Panics if the descriptor was not previously registered in a
791 /// new_\\*_connection event.
792 #[must_use]
793 #[no_mangle]
794 pub extern "C" fn PeerManager_write_buffer_space_avail(this_arg: &PeerManager, descriptor: &mut crate::ln::peer_handler::SocketDescriptor) -> crate::c_types::derived::CResult_NonePeerHandleErrorZ {
795         let mut ret = unsafe { &*this_arg.inner }.write_buffer_space_avail(descriptor);
796         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { 0u8 /*o*/ }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::peer_handler::PeerHandleError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
797         local_ret
798 }
799
800 /// Indicates that data was read from the given socket descriptor.
801 ///
802 /// May return an Err to indicate that the connection should be closed.
803 ///
804 /// Will *not* call back into send_data on any descriptors to avoid reentrancy complexity.
805 /// Thus, however, you almost certainly want to call process_events() after any read_event to
806 /// generate send_data calls to handle responses.
807 ///
808 /// If Ok(true) is returned, further read_events should not be triggered until a send_data call
809 /// on this file descriptor has resume_read set (preventing DoS issues in the send buffer).
810 ///
811 /// Panics if the descriptor was not previously registered in a new_*_connection event.
812 #[must_use]
813 #[no_mangle]
814 pub extern "C" fn PeerManager_read_event(this_arg: &PeerManager, peer_descriptor: &mut crate::ln::peer_handler::SocketDescriptor, mut data: crate::c_types::u8slice) -> crate::c_types::derived::CResult_boolPeerHandleErrorZ {
815         let mut ret = unsafe { &*this_arg.inner }.read_event(peer_descriptor, data.to_slice());
816         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { o }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::peer_handler::PeerHandleError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
817         local_ret
818 }
819
820 /// Checks for any events generated by our handlers and processes them. Includes sending most
821 /// response messages as well as messages generated by calls to handler functions directly (eg
822 /// functions like ChannelManager::process_pending_htlc_forward or send_payment).
823 #[no_mangle]
824 pub extern "C" fn PeerManager_process_events(this_arg: &PeerManager) {
825         unsafe { &*this_arg.inner }.process_events()
826 }
827
828 /// Indicates that the given socket descriptor's connection is now closed.
829 ///
830 /// This must only be called if the socket has been disconnected by the peer or your own
831 /// decision to disconnect it and must NOT be called in any case where other parts of this
832 /// library (eg PeerHandleError, explicit disconnect_socket calls) instruct you to disconnect
833 /// the peer.
834 ///
835 /// Panics if the descriptor was not previously registered in a successful new_*_connection event.
836 #[no_mangle]
837 pub extern "C" fn PeerManager_socket_disconnected(this_arg: &PeerManager, descriptor: &crate::ln::peer_handler::SocketDescriptor) {
838         unsafe { &*this_arg.inner }.socket_disconnected(descriptor)
839 }
840
841 /// Disconnect a peer given its node id.
842 ///
843 /// Set no_connection_possible to true to prevent any further connection with this peer,
844 /// force-closing any channels we have with it.
845 ///
846 /// If a peer is connected, this will call `disconnect_socket` on the descriptor for the peer,
847 /// so be careful about reentrancy issues.
848 #[no_mangle]
849 pub extern "C" fn PeerManager_disconnect_by_node_id(this_arg: &PeerManager, mut node_id: crate::c_types::PublicKey, mut no_connection_possible: bool) {
850         unsafe { &*this_arg.inner }.disconnect_by_node_id(node_id.into_rust(), no_connection_possible)
851 }
852
853 /// This function should be called roughly once every 30 seconds.
854 /// It will send pings to each peer and disconnect those which did not respond to the last round of pings.
855 /// Will most likely call send_data on all of the registered descriptors, thus, be very careful with reentrancy issues!
856 #[no_mangle]
857 pub extern "C" fn PeerManager_timer_tick_occurred(this_arg: &PeerManager) {
858         unsafe { &*this_arg.inner }.timer_tick_occurred()
859 }
860