daa76b78ace8c752ecb57fe92c2e97455dae6be0
[ldk-c-bindings] / lightning-c-bindings / src / chain / keysinterface.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 //! keysinterface provides keys into rust-lightning and defines some useful enums which describe
10 //! spendable on-chain outputs which the user owns and is responsible for using just as any other
11 //! on-chain output which is theirs.
12
13 use std::ffi::c_void;
14 use bitcoin::hashes::Hash;
15 use crate::c_types::*;
16
17
18 use lightning::chain::keysinterface::DelayedPaymentOutputDescriptor as nativeDelayedPaymentOutputDescriptorImport;
19 type nativeDelayedPaymentOutputDescriptor = nativeDelayedPaymentOutputDescriptorImport;
20
21 /// Information about a spendable output to a P2WSH script. See
22 /// SpendableOutputDescriptor::DelayedPaymentOutput for more details on how to spend this.
23 #[must_use]
24 #[repr(C)]
25 pub struct DelayedPaymentOutputDescriptor {
26         /// A pointer to the opaque Rust object.
27
28         /// Nearly everywhere, inner must be non-null, however in places where
29         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
30         pub inner: *mut nativeDelayedPaymentOutputDescriptor,
31         /// Indicates that this is the only struct which contains the same pointer.
32
33         /// Rust functions which take ownership of an object provided via an argument require
34         /// this to be true and invalidate the object pointed to by inner.
35         pub is_owned: bool,
36 }
37
38 impl Drop for DelayedPaymentOutputDescriptor {
39         fn drop(&mut self) {
40                 if self.is_owned && !<*mut nativeDelayedPaymentOutputDescriptor>::is_null(self.inner) {
41                         let _ = unsafe { Box::from_raw(self.inner) };
42                 }
43         }
44 }
45 /// Frees any resources used by the DelayedPaymentOutputDescriptor, if is_owned is set and inner is non-NULL.
46 #[no_mangle]
47 pub extern "C" fn DelayedPaymentOutputDescriptor_free(this_obj: DelayedPaymentOutputDescriptor) { }
48 #[allow(unused)]
49 /// Used only if an object of this type is returned as a trait impl by a method
50 extern "C" fn DelayedPaymentOutputDescriptor_free_void(this_ptr: *mut c_void) {
51         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeDelayedPaymentOutputDescriptor); }
52 }
53 #[allow(unused)]
54 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
55 impl DelayedPaymentOutputDescriptor {
56         pub(crate) fn take_inner(mut self) -> *mut nativeDelayedPaymentOutputDescriptor {
57                 assert!(self.is_owned);
58                 let ret = self.inner;
59                 self.inner = std::ptr::null_mut();
60                 ret
61         }
62 }
63 /// The outpoint which is spendable
64 #[no_mangle]
65 pub extern "C" fn DelayedPaymentOutputDescriptor_get_outpoint(this_ptr: &DelayedPaymentOutputDescriptor) -> crate::chain::transaction::OutPoint {
66         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.outpoint;
67         crate::chain::transaction::OutPoint { inner: unsafe { ( (&((*inner_val)) as *const _) as *mut _) }, is_owned: false }
68 }
69 /// The outpoint which is spendable
70 #[no_mangle]
71 pub extern "C" fn DelayedPaymentOutputDescriptor_set_outpoint(this_ptr: &mut DelayedPaymentOutputDescriptor, mut val: crate::chain::transaction::OutPoint) {
72         unsafe { &mut *this_ptr.inner }.outpoint = *unsafe { Box::from_raw(val.take_inner()) };
73 }
74 /// Per commitment point to derive delayed_payment_key by key holder
75 #[no_mangle]
76 pub extern "C" fn DelayedPaymentOutputDescriptor_get_per_commitment_point(this_ptr: &DelayedPaymentOutputDescriptor) -> crate::c_types::PublicKey {
77         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.per_commitment_point;
78         crate::c_types::PublicKey::from_rust(&(*inner_val))
79 }
80 /// Per commitment point to derive delayed_payment_key by key holder
81 #[no_mangle]
82 pub extern "C" fn DelayedPaymentOutputDescriptor_set_per_commitment_point(this_ptr: &mut DelayedPaymentOutputDescriptor, mut val: crate::c_types::PublicKey) {
83         unsafe { &mut *this_ptr.inner }.per_commitment_point = val.into_rust();
84 }
85 /// The nSequence value which must be set in the spending input to satisfy the OP_CSV in
86 /// the witness_script.
87 #[no_mangle]
88 pub extern "C" fn DelayedPaymentOutputDescriptor_get_to_self_delay(this_ptr: &DelayedPaymentOutputDescriptor) -> u16 {
89         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.to_self_delay;
90         (*inner_val)
91 }
92 /// The nSequence value which must be set in the spending input to satisfy the OP_CSV in
93 /// the witness_script.
94 #[no_mangle]
95 pub extern "C" fn DelayedPaymentOutputDescriptor_set_to_self_delay(this_ptr: &mut DelayedPaymentOutputDescriptor, mut val: u16) {
96         unsafe { &mut *this_ptr.inner }.to_self_delay = val;
97 }
98 /// The output which is referenced by the given outpoint
99 #[no_mangle]
100 pub extern "C" fn DelayedPaymentOutputDescriptor_set_output(this_ptr: &mut DelayedPaymentOutputDescriptor, mut val: crate::c_types::TxOut) {
101         unsafe { &mut *this_ptr.inner }.output = val.into_rust();
102 }
103 /// The revocation point specific to the commitment transaction which was broadcast. Used to
104 /// derive the witnessScript for this output.
105 #[no_mangle]
106 pub extern "C" fn DelayedPaymentOutputDescriptor_get_revocation_pubkey(this_ptr: &DelayedPaymentOutputDescriptor) -> crate::c_types::PublicKey {
107         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.revocation_pubkey;
108         crate::c_types::PublicKey::from_rust(&(*inner_val))
109 }
110 /// The revocation point specific to the commitment transaction which was broadcast. Used to
111 /// derive the witnessScript for this output.
112 #[no_mangle]
113 pub extern "C" fn DelayedPaymentOutputDescriptor_set_revocation_pubkey(this_ptr: &mut DelayedPaymentOutputDescriptor, mut val: crate::c_types::PublicKey) {
114         unsafe { &mut *this_ptr.inner }.revocation_pubkey = val.into_rust();
115 }
116 /// Arbitrary identification information returned by a call to
117 /// `Sign::channel_keys_id()`. This may be useful in re-deriving keys used in
118 /// the channel to spend the output.
119 #[no_mangle]
120 pub extern "C" fn DelayedPaymentOutputDescriptor_get_channel_keys_id(this_ptr: &DelayedPaymentOutputDescriptor) -> *const [u8; 32] {
121         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.channel_keys_id;
122         &(*inner_val)
123 }
124 /// Arbitrary identification information returned by a call to
125 /// `Sign::channel_keys_id()`. This may be useful in re-deriving keys used in
126 /// the channel to spend the output.
127 #[no_mangle]
128 pub extern "C" fn DelayedPaymentOutputDescriptor_set_channel_keys_id(this_ptr: &mut DelayedPaymentOutputDescriptor, mut val: crate::c_types::ThirtyTwoBytes) {
129         unsafe { &mut *this_ptr.inner }.channel_keys_id = val.data;
130 }
131 /// The value of the channel which this output originated from, possibly indirectly.
132 #[no_mangle]
133 pub extern "C" fn DelayedPaymentOutputDescriptor_get_channel_value_satoshis(this_ptr: &DelayedPaymentOutputDescriptor) -> u64 {
134         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.channel_value_satoshis;
135         (*inner_val)
136 }
137 /// The value of the channel which this output originated from, possibly indirectly.
138 #[no_mangle]
139 pub extern "C" fn DelayedPaymentOutputDescriptor_set_channel_value_satoshis(this_ptr: &mut DelayedPaymentOutputDescriptor, mut val: u64) {
140         unsafe { &mut *this_ptr.inner }.channel_value_satoshis = val;
141 }
142 /// Constructs a new DelayedPaymentOutputDescriptor given each field
143 #[must_use]
144 #[no_mangle]
145 pub extern "C" fn DelayedPaymentOutputDescriptor_new(mut outpoint_arg: crate::chain::transaction::OutPoint, mut per_commitment_point_arg: crate::c_types::PublicKey, mut to_self_delay_arg: u16, mut output_arg: crate::c_types::TxOut, mut revocation_pubkey_arg: crate::c_types::PublicKey, mut channel_keys_id_arg: crate::c_types::ThirtyTwoBytes, mut channel_value_satoshis_arg: u64) -> DelayedPaymentOutputDescriptor {
146         DelayedPaymentOutputDescriptor { inner: Box::into_raw(Box::new(nativeDelayedPaymentOutputDescriptor {
147                 outpoint: *unsafe { Box::from_raw(outpoint_arg.take_inner()) },
148                 per_commitment_point: per_commitment_point_arg.into_rust(),
149                 to_self_delay: to_self_delay_arg,
150                 output: output_arg.into_rust(),
151                 revocation_pubkey: revocation_pubkey_arg.into_rust(),
152                 channel_keys_id: channel_keys_id_arg.data,
153                 channel_value_satoshis: channel_value_satoshis_arg,
154         })), is_owned: true }
155 }
156 impl Clone for DelayedPaymentOutputDescriptor {
157         fn clone(&self) -> Self {
158                 Self {
159                         inner: if <*mut nativeDelayedPaymentOutputDescriptor>::is_null(self.inner) { std::ptr::null_mut() } else {
160                                 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
161                         is_owned: true,
162                 }
163         }
164 }
165 #[allow(unused)]
166 /// Used only if an object of this type is returned as a trait impl by a method
167 pub(crate) extern "C" fn DelayedPaymentOutputDescriptor_clone_void(this_ptr: *const c_void) -> *mut c_void {
168         Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeDelayedPaymentOutputDescriptor)).clone() })) as *mut c_void
169 }
170 #[no_mangle]
171 /// Creates a copy of the DelayedPaymentOutputDescriptor
172 pub extern "C" fn DelayedPaymentOutputDescriptor_clone(orig: &DelayedPaymentOutputDescriptor) -> DelayedPaymentOutputDescriptor {
173         orig.clone()
174 }
175
176 use lightning::chain::keysinterface::StaticPaymentOutputDescriptor as nativeStaticPaymentOutputDescriptorImport;
177 type nativeStaticPaymentOutputDescriptor = nativeStaticPaymentOutputDescriptorImport;
178
179 /// Information about a spendable output to our \"payment key\". See
180 /// SpendableOutputDescriptor::StaticPaymentOutput for more details on how to spend this.
181 #[must_use]
182 #[repr(C)]
183 pub struct StaticPaymentOutputDescriptor {
184         /// A pointer to the opaque Rust object.
185
186         /// Nearly everywhere, inner must be non-null, however in places where
187         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
188         pub inner: *mut nativeStaticPaymentOutputDescriptor,
189         /// Indicates that this is the only struct which contains the same pointer.
190
191         /// Rust functions which take ownership of an object provided via an argument require
192         /// this to be true and invalidate the object pointed to by inner.
193         pub is_owned: bool,
194 }
195
196 impl Drop for StaticPaymentOutputDescriptor {
197         fn drop(&mut self) {
198                 if self.is_owned && !<*mut nativeStaticPaymentOutputDescriptor>::is_null(self.inner) {
199                         let _ = unsafe { Box::from_raw(self.inner) };
200                 }
201         }
202 }
203 /// Frees any resources used by the StaticPaymentOutputDescriptor, if is_owned is set and inner is non-NULL.
204 #[no_mangle]
205 pub extern "C" fn StaticPaymentOutputDescriptor_free(this_obj: StaticPaymentOutputDescriptor) { }
206 #[allow(unused)]
207 /// Used only if an object of this type is returned as a trait impl by a method
208 extern "C" fn StaticPaymentOutputDescriptor_free_void(this_ptr: *mut c_void) {
209         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeStaticPaymentOutputDescriptor); }
210 }
211 #[allow(unused)]
212 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
213 impl StaticPaymentOutputDescriptor {
214         pub(crate) fn take_inner(mut self) -> *mut nativeStaticPaymentOutputDescriptor {
215                 assert!(self.is_owned);
216                 let ret = self.inner;
217                 self.inner = std::ptr::null_mut();
218                 ret
219         }
220 }
221 /// The outpoint which is spendable
222 #[no_mangle]
223 pub extern "C" fn StaticPaymentOutputDescriptor_get_outpoint(this_ptr: &StaticPaymentOutputDescriptor) -> crate::chain::transaction::OutPoint {
224         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.outpoint;
225         crate::chain::transaction::OutPoint { inner: unsafe { ( (&((*inner_val)) as *const _) as *mut _) }, is_owned: false }
226 }
227 /// The outpoint which is spendable
228 #[no_mangle]
229 pub extern "C" fn StaticPaymentOutputDescriptor_set_outpoint(this_ptr: &mut StaticPaymentOutputDescriptor, mut val: crate::chain::transaction::OutPoint) {
230         unsafe { &mut *this_ptr.inner }.outpoint = *unsafe { Box::from_raw(val.take_inner()) };
231 }
232 /// The output which is referenced by the given outpoint
233 #[no_mangle]
234 pub extern "C" fn StaticPaymentOutputDescriptor_set_output(this_ptr: &mut StaticPaymentOutputDescriptor, mut val: crate::c_types::TxOut) {
235         unsafe { &mut *this_ptr.inner }.output = val.into_rust();
236 }
237 /// Arbitrary identification information returned by a call to
238 /// `Sign::channel_keys_id()`. This may be useful in re-deriving keys used in
239 /// the channel to spend the output.
240 #[no_mangle]
241 pub extern "C" fn StaticPaymentOutputDescriptor_get_channel_keys_id(this_ptr: &StaticPaymentOutputDescriptor) -> *const [u8; 32] {
242         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.channel_keys_id;
243         &(*inner_val)
244 }
245 /// Arbitrary identification information returned by a call to
246 /// `Sign::channel_keys_id()`. This may be useful in re-deriving keys used in
247 /// the channel to spend the output.
248 #[no_mangle]
249 pub extern "C" fn StaticPaymentOutputDescriptor_set_channel_keys_id(this_ptr: &mut StaticPaymentOutputDescriptor, mut val: crate::c_types::ThirtyTwoBytes) {
250         unsafe { &mut *this_ptr.inner }.channel_keys_id = val.data;
251 }
252 /// The value of the channel which this transactions spends.
253 #[no_mangle]
254 pub extern "C" fn StaticPaymentOutputDescriptor_get_channel_value_satoshis(this_ptr: &StaticPaymentOutputDescriptor) -> u64 {
255         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.channel_value_satoshis;
256         (*inner_val)
257 }
258 /// The value of the channel which this transactions spends.
259 #[no_mangle]
260 pub extern "C" fn StaticPaymentOutputDescriptor_set_channel_value_satoshis(this_ptr: &mut StaticPaymentOutputDescriptor, mut val: u64) {
261         unsafe { &mut *this_ptr.inner }.channel_value_satoshis = val;
262 }
263 /// Constructs a new StaticPaymentOutputDescriptor given each field
264 #[must_use]
265 #[no_mangle]
266 pub extern "C" fn StaticPaymentOutputDescriptor_new(mut outpoint_arg: crate::chain::transaction::OutPoint, mut output_arg: crate::c_types::TxOut, mut channel_keys_id_arg: crate::c_types::ThirtyTwoBytes, mut channel_value_satoshis_arg: u64) -> StaticPaymentOutputDescriptor {
267         StaticPaymentOutputDescriptor { inner: Box::into_raw(Box::new(nativeStaticPaymentOutputDescriptor {
268                 outpoint: *unsafe { Box::from_raw(outpoint_arg.take_inner()) },
269                 output: output_arg.into_rust(),
270                 channel_keys_id: channel_keys_id_arg.data,
271                 channel_value_satoshis: channel_value_satoshis_arg,
272         })), is_owned: true }
273 }
274 impl Clone for StaticPaymentOutputDescriptor {
275         fn clone(&self) -> Self {
276                 Self {
277                         inner: if <*mut nativeStaticPaymentOutputDescriptor>::is_null(self.inner) { std::ptr::null_mut() } else {
278                                 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
279                         is_owned: true,
280                 }
281         }
282 }
283 #[allow(unused)]
284 /// Used only if an object of this type is returned as a trait impl by a method
285 pub(crate) extern "C" fn StaticPaymentOutputDescriptor_clone_void(this_ptr: *const c_void) -> *mut c_void {
286         Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeStaticPaymentOutputDescriptor)).clone() })) as *mut c_void
287 }
288 #[no_mangle]
289 /// Creates a copy of the StaticPaymentOutputDescriptor
290 pub extern "C" fn StaticPaymentOutputDescriptor_clone(orig: &StaticPaymentOutputDescriptor) -> StaticPaymentOutputDescriptor {
291         orig.clone()
292 }
293 /// When on-chain outputs are created by rust-lightning (which our counterparty is not able to
294 /// claim at any point in the future) an event is generated which you must track and be able to
295 /// spend on-chain. The information needed to do this is provided in this enum, including the
296 /// outpoint describing which txid and output index is available, the full output which exists at
297 /// that txid/index, and any keys or other information required to sign.
298 #[must_use]
299 #[derive(Clone)]
300 #[repr(C)]
301 pub enum SpendableOutputDescriptor {
302         /// An output to a script which was provided via KeysInterface directly, either from
303         /// `get_destination_script()` or `get_shutdown_pubkey()`, thus you should already know how to
304         /// spend it. No secret keys are provided as rust-lightning was never given any key.
305         /// These may include outputs from a transaction punishing our counterparty or claiming an HTLC
306         /// on-chain using the payment preimage or after it has timed out.
307         StaticOutput {
308                 /// The outpoint which is spendable
309                 outpoint: crate::chain::transaction::OutPoint,
310                 /// The output which is referenced by the given outpoint.
311                 output: crate::c_types::TxOut,
312         },
313         /// An output to a P2WSH script which can be spent with a single signature after a CSV delay.
314         ///
315         /// The witness in the spending input should be:
316         /// <BIP 143 signature> <empty vector> (MINIMALIF standard rule) <provided witnessScript>
317         ///
318         /// Note that the nSequence field in the spending input must be set to to_self_delay
319         /// (which means the transaction is not broadcastable until at least to_self_delay
320         /// blocks after the outpoint confirms).
321         ///
322         /// These are generally the result of a \"revocable\" output to us, spendable only by us unless
323         /// it is an output from an old state which we broadcast (which should never happen).
324         ///
325         /// To derive the delayed_payment key which is used to sign for this input, you must pass the
326         /// holder delayed_payment_base_key (ie the private key which corresponds to the pubkey in
327         /// Sign::pubkeys().delayed_payment_basepoint) and the provided per_commitment_point to
328         /// chan_utils::derive_private_key. The public key can be generated without the secret key
329         /// using chan_utils::derive_public_key and only the delayed_payment_basepoint which appears in
330         /// Sign::pubkeys().
331         ///
332         /// To derive the revocation_pubkey provided here (which is used in the witness
333         /// script generation), you must pass the counterparty revocation_basepoint (which appears in the
334         /// call to Sign::ready_channel) and the provided per_commitment point
335         /// to chan_utils::derive_public_revocation_key.
336         ///
337         /// The witness script which is hashed and included in the output script_pubkey may be
338         /// regenerated by passing the revocation_pubkey (derived as above), our delayed_payment pubkey
339         /// (derived as above), and the to_self_delay contained here to
340         /// chan_utils::get_revokeable_redeemscript.
341         DelayedPaymentOutput(crate::chain::keysinterface::DelayedPaymentOutputDescriptor),
342         /// An output to a P2WPKH, spendable exclusively by our payment key (ie the private key which
343         /// corresponds to the public key in Sign::pubkeys().payment_point).
344         /// The witness in the spending input, is, thus, simply:
345         /// <BIP 143 signature> <payment key>
346         ///
347         /// These are generally the result of our counterparty having broadcast the current state,
348         /// allowing us to claim the non-HTLC-encumbered outputs immediately.
349         StaticPaymentOutput(crate::chain::keysinterface::StaticPaymentOutputDescriptor),
350 }
351 use lightning::chain::keysinterface::SpendableOutputDescriptor as nativeSpendableOutputDescriptor;
352 impl SpendableOutputDescriptor {
353         #[allow(unused)]
354         pub(crate) fn to_native(&self) -> nativeSpendableOutputDescriptor {
355                 match self {
356                         SpendableOutputDescriptor::StaticOutput {ref outpoint, ref output, } => {
357                                 let mut outpoint_nonref = (*outpoint).clone();
358                                 let mut output_nonref = (*output).clone();
359                                 nativeSpendableOutputDescriptor::StaticOutput {
360                                         outpoint: *unsafe { Box::from_raw(outpoint_nonref.take_inner()) },
361                                         output: output_nonref.into_rust(),
362                                 }
363                         },
364                         SpendableOutputDescriptor::DelayedPaymentOutput (ref a, ) => {
365                                 let mut a_nonref = (*a).clone();
366                                 nativeSpendableOutputDescriptor::DelayedPaymentOutput (
367                                         *unsafe { Box::from_raw(a_nonref.take_inner()) },
368                                 )
369                         },
370                         SpendableOutputDescriptor::StaticPaymentOutput (ref a, ) => {
371                                 let mut a_nonref = (*a).clone();
372                                 nativeSpendableOutputDescriptor::StaticPaymentOutput (
373                                         *unsafe { Box::from_raw(a_nonref.take_inner()) },
374                                 )
375                         },
376                 }
377         }
378         #[allow(unused)]
379         pub(crate) fn into_native(self) -> nativeSpendableOutputDescriptor {
380                 match self {
381                         SpendableOutputDescriptor::StaticOutput {mut outpoint, mut output, } => {
382                                 nativeSpendableOutputDescriptor::StaticOutput {
383                                         outpoint: *unsafe { Box::from_raw(outpoint.take_inner()) },
384                                         output: output.into_rust(),
385                                 }
386                         },
387                         SpendableOutputDescriptor::DelayedPaymentOutput (mut a, ) => {
388                                 nativeSpendableOutputDescriptor::DelayedPaymentOutput (
389                                         *unsafe { Box::from_raw(a.take_inner()) },
390                                 )
391                         },
392                         SpendableOutputDescriptor::StaticPaymentOutput (mut a, ) => {
393                                 nativeSpendableOutputDescriptor::StaticPaymentOutput (
394                                         *unsafe { Box::from_raw(a.take_inner()) },
395                                 )
396                         },
397                 }
398         }
399         #[allow(unused)]
400         pub(crate) fn from_native(native: &nativeSpendableOutputDescriptor) -> Self {
401                 match native {
402                         nativeSpendableOutputDescriptor::StaticOutput {ref outpoint, ref output, } => {
403                                 let mut outpoint_nonref = (*outpoint).clone();
404                                 let mut output_nonref = (*output).clone();
405                                 SpendableOutputDescriptor::StaticOutput {
406                                         outpoint: crate::chain::transaction::OutPoint { inner: Box::into_raw(Box::new(outpoint_nonref)), is_owned: true },
407                                         output: crate::c_types::TxOut::from_rust(output_nonref),
408                                 }
409                         },
410                         nativeSpendableOutputDescriptor::DelayedPaymentOutput (ref a, ) => {
411                                 let mut a_nonref = (*a).clone();
412                                 SpendableOutputDescriptor::DelayedPaymentOutput (
413                                         crate::chain::keysinterface::DelayedPaymentOutputDescriptor { inner: Box::into_raw(Box::new(a_nonref)), is_owned: true },
414                                 )
415                         },
416                         nativeSpendableOutputDescriptor::StaticPaymentOutput (ref a, ) => {
417                                 let mut a_nonref = (*a).clone();
418                                 SpendableOutputDescriptor::StaticPaymentOutput (
419                                         crate::chain::keysinterface::StaticPaymentOutputDescriptor { inner: Box::into_raw(Box::new(a_nonref)), is_owned: true },
420                                 )
421                         },
422                 }
423         }
424         #[allow(unused)]
425         pub(crate) fn native_into(native: nativeSpendableOutputDescriptor) -> Self {
426                 match native {
427                         nativeSpendableOutputDescriptor::StaticOutput {mut outpoint, mut output, } => {
428                                 SpendableOutputDescriptor::StaticOutput {
429                                         outpoint: crate::chain::transaction::OutPoint { inner: Box::into_raw(Box::new(outpoint)), is_owned: true },
430                                         output: crate::c_types::TxOut::from_rust(output),
431                                 }
432                         },
433                         nativeSpendableOutputDescriptor::DelayedPaymentOutput (mut a, ) => {
434                                 SpendableOutputDescriptor::DelayedPaymentOutput (
435                                         crate::chain::keysinterface::DelayedPaymentOutputDescriptor { inner: Box::into_raw(Box::new(a)), is_owned: true },
436                                 )
437                         },
438                         nativeSpendableOutputDescriptor::StaticPaymentOutput (mut a, ) => {
439                                 SpendableOutputDescriptor::StaticPaymentOutput (
440                                         crate::chain::keysinterface::StaticPaymentOutputDescriptor { inner: Box::into_raw(Box::new(a)), is_owned: true },
441                                 )
442                         },
443                 }
444         }
445 }
446 /// Frees any resources used by the SpendableOutputDescriptor
447 #[no_mangle]
448 pub extern "C" fn SpendableOutputDescriptor_free(this_ptr: SpendableOutputDescriptor) { }
449 /// Creates a copy of the SpendableOutputDescriptor
450 #[no_mangle]
451 pub extern "C" fn SpendableOutputDescriptor_clone(orig: &SpendableOutputDescriptor) -> SpendableOutputDescriptor {
452         orig.clone()
453 }
454 #[no_mangle]
455 /// Serialize the SpendableOutputDescriptor object into a byte array which can be read by SpendableOutputDescriptor_read
456 pub extern "C" fn SpendableOutputDescriptor_write(obj: &SpendableOutputDescriptor) -> crate::c_types::derived::CVec_u8Z {
457         crate::c_types::serialize_obj(&unsafe { &*obj }.to_native())
458 }
459 #[no_mangle]
460 /// Read a SpendableOutputDescriptor from a byte array, created by SpendableOutputDescriptor_write
461 pub extern "C" fn SpendableOutputDescriptor_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_SpendableOutputDescriptorDecodeErrorZ {
462         let res = crate::c_types::deserialize_obj(ser);
463         let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::chain::keysinterface::SpendableOutputDescriptor::native_into(o) }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
464         local_res
465 }
466 /// A trait to sign lightning channel transactions as described in BOLT 3.
467 ///
468 /// Signing services could be implemented on a hardware wallet. In this case,
469 /// the current Sign would be a front-end on top of a communication
470 /// channel connected to your secure device and lightning key material wouldn't
471 /// reside on a hot server. Nevertheless, a this deployment would still need
472 /// to trust the ChannelManager to avoid loss of funds as this latest component
473 /// could ask to sign commitment transaction with HTLCs paying to attacker pubkeys.
474 ///
475 /// A more secure iteration would be to use hashlock (or payment points) to pair
476 /// invoice/incoming HTLCs with outgoing HTLCs to implement a no-trust-ChannelManager
477 /// at the price of more state and computation on the hardware wallet side. In the future,
478 /// we are looking forward to design such interface.
479 ///
480 /// In any case, ChannelMonitor or fallback watchtowers are always going to be trusted
481 /// to act, as liveness and breach reply correctness are always going to be hard requirements
482 /// of LN security model, orthogonal of key management issues.
483 #[repr(C)]
484 pub struct Sign {
485         /// An opaque pointer which is passed to your function implementations as an argument.
486         /// This has no meaning in the LDK, and can be NULL or any other value.
487         pub this_arg: *mut c_void,
488         /// Gets the per-commitment point for a specific commitment number
489         ///
490         /// Note that the commitment number starts at (1 << 48) - 1 and counts backwards.
491         #[must_use]
492         pub get_per_commitment_point: extern "C" fn (this_arg: *const c_void, idx: u64) -> crate::c_types::PublicKey,
493         /// Gets the commitment secret for a specific commitment number as part of the revocation process
494         ///
495         /// An external signer implementation should error here if the commitment was already signed
496         /// and should refuse to sign it in the future.
497         ///
498         /// May be called more than once for the same index.
499         ///
500         /// Note that the commitment number starts at (1 << 48) - 1 and counts backwards.
501         #[must_use]
502         pub release_commitment_secret: extern "C" fn (this_arg: *const c_void, idx: u64) -> crate::c_types::ThirtyTwoBytes,
503         /// Gets the holder's channel public keys and basepoints
504         pub pubkeys: crate::ln::chan_utils::ChannelPublicKeys,
505         /// Fill in the pubkeys field as a reference to it will be given to Rust after this returns
506         /// Note that this takes a pointer to this object, not the this_ptr like other methods do
507         /// This function pointer may be NULL if pubkeys is filled in when this object is created and never needs updating.
508         pub set_pubkeys: Option<extern "C" fn(&Sign)>,
509         /// Gets an arbitrary identifier describing the set of keys which are provided back to you in
510         /// some SpendableOutputDescriptor types. This should be sufficient to identify this
511         /// Sign object uniquely and lookup or re-derive its keys.
512         #[must_use]
513         pub channel_keys_id: extern "C" fn (this_arg: *const c_void) -> crate::c_types::ThirtyTwoBytes,
514         /// Create a signature for a counterparty's commitment transaction and associated HTLC transactions.
515         ///
516         /// Note that if signing fails or is rejected, the channel will be force-closed.
517         #[must_use]
518         pub sign_counterparty_commitment: extern "C" fn (this_arg: *const c_void, commitment_tx: &crate::ln::chan_utils::CommitmentTransaction) -> crate::c_types::derived::CResult_C2Tuple_SignatureCVec_SignatureZZNoneZ,
519         /// Create a signatures for a holder's commitment transaction and its claiming HTLC transactions.
520         /// This will only ever be called with a non-revoked commitment_tx.  This will be called with the
521         /// latest commitment_tx when we initiate a force-close.
522         /// This will be called with the previous latest, just to get claiming HTLC signatures, if we are
523         /// reacting to a ChannelMonitor replica that decided to broadcast before it had been updated to
524         /// the latest.
525         /// This may be called multiple times for the same transaction.
526         ///
527         /// An external signer implementation should check that the commitment has not been revoked.
528         ///
529         /// May return Err if key derivation fails.  Callers, such as ChannelMonitor, will panic in such a case.
530         #[must_use]
531         pub sign_holder_commitment_and_htlcs: extern "C" fn (this_arg: *const c_void, commitment_tx: &crate::ln::chan_utils::HolderCommitmentTransaction) -> crate::c_types::derived::CResult_C2Tuple_SignatureCVec_SignatureZZNoneZ,
532         /// Create a signature for the given input in a transaction spending an HTLC or commitment
533         /// transaction output when our counterparty broadcasts an old state.
534         ///
535         /// A justice transaction may claim multiples outputs at the same time if timelocks are
536         /// similar, but only a signature for the input at index `input` should be signed for here.
537         /// It may be called multiples time for same output(s) if a fee-bump is needed with regards
538         /// to an upcoming timelock expiration.
539         ///
540         /// Amount is value of the output spent by this input, committed to in the BIP 143 signature.
541         ///
542         /// per_commitment_key is revocation secret which was provided by our counterparty when they
543         /// revoked the state which they eventually broadcast. It's not a _holder_ secret key and does
544         /// not allow the spending of any funds by itself (you need our holder revocation_secret to do
545         /// so).
546         ///
547         /// htlc holds HTLC elements (hash, timelock) if the output being spent is a HTLC output, thus
548         /// changing the format of the witness script (which is committed to in the BIP 143
549         /// signatures).
550         #[must_use]
551         pub sign_justice_transaction: extern "C" fn (this_arg: *const c_void, justice_tx: crate::c_types::Transaction, input: usize, amount: u64, per_commitment_key: *const [u8; 32], htlc: &crate::ln::chan_utils::HTLCOutputInCommitment) -> crate::c_types::derived::CResult_SignatureNoneZ,
552         /// Create a signature for a claiming transaction for a HTLC output on a counterparty's commitment
553         /// transaction, either offered or received.
554         ///
555         /// Such a transaction may claim multiples offered outputs at same time if we know the
556         /// preimage for each when we create it, but only the input at index `input` should be
557         /// signed for here. It may be called multiple times for same output(s) if a fee-bump is
558         /// needed with regards to an upcoming timelock expiration.
559         ///
560         /// Witness_script is either a offered or received script as defined in BOLT3 for HTLC
561         /// outputs.
562         ///
563         /// Amount is value of the output spent by this input, committed to in the BIP 143 signature.
564         ///
565         /// Per_commitment_point is the dynamic point corresponding to the channel state
566         /// detected onchain. It has been generated by our counterparty and is used to derive
567         /// channel state keys, which are then included in the witness script and committed to in the
568         /// BIP 143 signature.
569         #[must_use]
570         pub sign_counterparty_htlc_transaction: extern "C" fn (this_arg: *const c_void, htlc_tx: crate::c_types::Transaction, input: usize, amount: u64, per_commitment_point: crate::c_types::PublicKey, htlc: &crate::ln::chan_utils::HTLCOutputInCommitment) -> crate::c_types::derived::CResult_SignatureNoneZ,
571         /// Create a signature for a (proposed) closing transaction.
572         ///
573         /// Note that, due to rounding, there may be one \"missing\" satoshi, and either party may have
574         /// chosen to forgo their output as dust.
575         #[must_use]
576         pub sign_closing_transaction: extern "C" fn (this_arg: *const c_void, closing_tx: crate::c_types::Transaction) -> crate::c_types::derived::CResult_SignatureNoneZ,
577         /// Signs a channel announcement message with our funding key, proving it comes from one
578         /// of the channel participants.
579         ///
580         /// Note that if this fails or is rejected, the channel will not be publicly announced and
581         /// our counterparty may (though likely will not) close the channel on us for violating the
582         /// protocol.
583         #[must_use]
584         pub sign_channel_announcement: extern "C" fn (this_arg: *const c_void, msg: &crate::ln::msgs::UnsignedChannelAnnouncement) -> crate::c_types::derived::CResult_SignatureNoneZ,
585         /// Set the counterparty static channel data, including basepoints,
586         /// counterparty_selected/holder_selected_contest_delay and funding outpoint.
587         /// This is done as soon as the funding outpoint is known.  Since these are static channel data,
588         /// they MUST NOT be allowed to change to different values once set.
589         ///
590         /// channel_parameters.is_populated() MUST be true.
591         ///
592         /// We bind holder_selected_contest_delay late here for API convenience.
593         ///
594         /// Will be called before any signatures are applied.
595         pub ready_channel: extern "C" fn (this_arg: *mut c_void, channel_parameters: &crate::ln::chan_utils::ChannelTransactionParameters),
596         /// Creates a copy of the object pointed to by this_arg, for a copy of this Sign.
597         /// Note that the ultimate copy of the Sign will have all function pointers the same as the original.
598         /// May be NULL if no action needs to be taken, the this_arg pointer will be copied into the new Sign.
599         pub clone: Option<extern "C" fn (this_arg: *const c_void) -> *mut c_void>,
600         /// Serialize the object into a byte array
601         pub write: extern "C" fn (this_arg: *const c_void) -> crate::c_types::derived::CVec_u8Z,
602         /// Frees any resources associated with this object given its this_arg pointer.
603         /// Does not need to free the outer struct containing function pointers and may be NULL is no resources need to be freed.
604         pub free: Option<extern "C" fn(this_arg: *mut c_void)>,
605 }
606 unsafe impl Send for Sign {}
607 #[no_mangle]
608 /// Creates a copy of a Sign
609 pub extern "C" fn Sign_clone(orig: &Sign) -> Sign {
610         Sign {
611                 this_arg: if let Some(f) = orig.clone { (f)(orig.this_arg) } else { orig.this_arg },
612                 get_per_commitment_point: orig.get_per_commitment_point.clone(),
613                 release_commitment_secret: orig.release_commitment_secret.clone(),
614                 pubkeys: orig.pubkeys.clone(),
615                 set_pubkeys: orig.set_pubkeys.clone(),
616                 channel_keys_id: orig.channel_keys_id.clone(),
617                 sign_counterparty_commitment: orig.sign_counterparty_commitment.clone(),
618                 sign_holder_commitment_and_htlcs: orig.sign_holder_commitment_and_htlcs.clone(),
619                 sign_justice_transaction: orig.sign_justice_transaction.clone(),
620                 sign_counterparty_htlc_transaction: orig.sign_counterparty_htlc_transaction.clone(),
621                 sign_closing_transaction: orig.sign_closing_transaction.clone(),
622                 sign_channel_announcement: orig.sign_channel_announcement.clone(),
623                 ready_channel: orig.ready_channel.clone(),
624                 clone: orig.clone.clone(),
625                 write: orig.write.clone(),
626                 free: orig.free.clone(),
627         }
628 }
629 impl Clone for Sign {
630         fn clone(&self) -> Self {
631                 Sign_clone(self)
632         }
633 }
634 impl lightning::util::ser::Writeable for Sign {
635         fn write<W: lightning::util::ser::Writer>(&self, w: &mut W) -> Result<(), ::std::io::Error> {
636                 let vec = (self.write)(self.this_arg);
637                 w.write_all(vec.as_slice())
638         }
639 }
640
641 use lightning::chain::keysinterface::Sign as rustSign;
642 impl rustSign for Sign {
643         fn get_per_commitment_point<T:bitcoin::secp256k1::Signing + bitcoin::secp256k1::Verification>(&self, idx: u64, _secp_ctx: &bitcoin::secp256k1::Secp256k1<T>) -> bitcoin::secp256k1::key::PublicKey {
644                 let mut ret = (self.get_per_commitment_point)(self.this_arg, idx);
645                 ret.into_rust()
646         }
647         fn release_commitment_secret(&self, idx: u64) -> [u8; 32] {
648                 let mut ret = (self.release_commitment_secret)(self.this_arg, idx);
649                 ret.data
650         }
651         fn pubkeys(&self) -> &lightning::ln::chan_utils::ChannelPublicKeys {
652                 if let Some(f) = self.set_pubkeys {
653                         (f)(self);
654                 }
655                 unsafe { &*self.pubkeys.inner }
656         }
657         fn channel_keys_id(&self) -> [u8; 32] {
658                 let mut ret = (self.channel_keys_id)(self.this_arg);
659                 ret.data
660         }
661         fn sign_counterparty_commitment<T:bitcoin::secp256k1::Signing + bitcoin::secp256k1::Verification>(&self, commitment_tx: &lightning::ln::chan_utils::CommitmentTransaction, _secp_ctx: &bitcoin::secp256k1::Secp256k1<T>) -> Result<(bitcoin::secp256k1::Signature, Vec<bitcoin::secp256k1::Signature>), ()> {
662                 let mut ret = (self.sign_counterparty_commitment)(self.this_arg, &crate::ln::chan_utils::CommitmentTransaction { inner: unsafe { (commitment_tx as *const _) as *mut _ }, is_owned: false });
663                 let mut local_ret = match ret.result_ok { true => Ok( { let (mut orig_ret_0_0, mut orig_ret_0_1) = (*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.result)) }).to_rust(); let mut local_orig_ret_0_1 = Vec::new(); for mut item in orig_ret_0_1.into_rust().drain(..) { local_orig_ret_0_1.push( { item.into_rust() }); }; let mut local_ret_0 = (orig_ret_0_0.into_rust(), local_orig_ret_0_1); local_ret_0 }), false => Err( { () /*(*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.err)) })*/ })};
664                 local_ret
665         }
666         fn sign_holder_commitment_and_htlcs<T:bitcoin::secp256k1::Signing + bitcoin::secp256k1::Verification>(&self, commitment_tx: &lightning::ln::chan_utils::HolderCommitmentTransaction, _secp_ctx: &bitcoin::secp256k1::Secp256k1<T>) -> Result<(bitcoin::secp256k1::Signature, Vec<bitcoin::secp256k1::Signature>), ()> {
667                 let mut ret = (self.sign_holder_commitment_and_htlcs)(self.this_arg, &crate::ln::chan_utils::HolderCommitmentTransaction { inner: unsafe { (commitment_tx as *const _) as *mut _ }, is_owned: false });
668                 let mut local_ret = match ret.result_ok { true => Ok( { let (mut orig_ret_0_0, mut orig_ret_0_1) = (*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.result)) }).to_rust(); let mut local_orig_ret_0_1 = Vec::new(); for mut item in orig_ret_0_1.into_rust().drain(..) { local_orig_ret_0_1.push( { item.into_rust() }); }; let mut local_ret_0 = (orig_ret_0_0.into_rust(), local_orig_ret_0_1); local_ret_0 }), false => Err( { () /*(*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.err)) })*/ })};
669                 local_ret
670         }
671         fn sign_justice_transaction<T:bitcoin::secp256k1::Signing + bitcoin::secp256k1::Verification>(&self, justice_tx: &bitcoin::blockdata::transaction::Transaction, input: usize, amount: u64, per_commitment_key: &bitcoin::secp256k1::key::SecretKey, htlc: &Option<lightning::ln::chan_utils::HTLCOutputInCommitment>, _secp_ctx: &bitcoin::secp256k1::Secp256k1<T>) -> Result<bitcoin::secp256k1::Signature, ()> {
672                 let mut local_justice_tx = ::bitcoin::consensus::encode::serialize(justice_tx);
673                 let mut local_htlc = &crate::ln::chan_utils::HTLCOutputInCommitment { inner: unsafe { (if htlc.is_none() { std::ptr::null() } else {  { (htlc.as_ref().unwrap()) } } as *const _) as *mut _ }, is_owned: false };
674                 let mut ret = (self.sign_justice_transaction)(self.this_arg, crate::c_types::Transaction::from_vec(local_justice_tx), input, amount, per_commitment_key.as_ref(), local_htlc);
675                 let mut local_ret = match ret.result_ok { true => Ok( { (*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.result)) }).into_rust() }), false => Err( { () /*(*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.err)) })*/ })};
676                 local_ret
677         }
678         fn sign_counterparty_htlc_transaction<T:bitcoin::secp256k1::Signing + bitcoin::secp256k1::Verification>(&self, htlc_tx: &bitcoin::blockdata::transaction::Transaction, input: usize, amount: u64, per_commitment_point: &bitcoin::secp256k1::key::PublicKey, htlc: &lightning::ln::chan_utils::HTLCOutputInCommitment, _secp_ctx: &bitcoin::secp256k1::Secp256k1<T>) -> Result<bitcoin::secp256k1::Signature, ()> {
679                 let mut local_htlc_tx = ::bitcoin::consensus::encode::serialize(htlc_tx);
680                 let mut ret = (self.sign_counterparty_htlc_transaction)(self.this_arg, crate::c_types::Transaction::from_vec(local_htlc_tx), input, amount, crate::c_types::PublicKey::from_rust(&per_commitment_point), &crate::ln::chan_utils::HTLCOutputInCommitment { inner: unsafe { (htlc as *const _) as *mut _ }, is_owned: false });
681                 let mut local_ret = match ret.result_ok { true => Ok( { (*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.result)) }).into_rust() }), false => Err( { () /*(*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.err)) })*/ })};
682                 local_ret
683         }
684         fn sign_closing_transaction<T:bitcoin::secp256k1::Signing>(&self, closing_tx: &bitcoin::blockdata::transaction::Transaction, _secp_ctx: &bitcoin::secp256k1::Secp256k1<T>) -> Result<bitcoin::secp256k1::Signature, ()> {
685                 let mut local_closing_tx = ::bitcoin::consensus::encode::serialize(closing_tx);
686                 let mut ret = (self.sign_closing_transaction)(self.this_arg, crate::c_types::Transaction::from_vec(local_closing_tx));
687                 let mut local_ret = match ret.result_ok { true => Ok( { (*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.result)) }).into_rust() }), false => Err( { () /*(*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.err)) })*/ })};
688                 local_ret
689         }
690         fn sign_channel_announcement<T:bitcoin::secp256k1::Signing>(&self, msg: &lightning::ln::msgs::UnsignedChannelAnnouncement, _secp_ctx: &bitcoin::secp256k1::Secp256k1<T>) -> Result<bitcoin::secp256k1::Signature, ()> {
691                 let mut ret = (self.sign_channel_announcement)(self.this_arg, &crate::ln::msgs::UnsignedChannelAnnouncement { inner: unsafe { (msg as *const _) as *mut _ }, is_owned: false });
692                 let mut local_ret = match ret.result_ok { true => Ok( { (*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.result)) }).into_rust() }), false => Err( { () /*(*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.err)) })*/ })};
693                 local_ret
694         }
695         fn ready_channel(&mut self, channel_parameters: &lightning::ln::chan_utils::ChannelTransactionParameters) {
696                 (self.ready_channel)(self.this_arg, &crate::ln::chan_utils::ChannelTransactionParameters { inner: unsafe { (channel_parameters as *const _) as *mut _ }, is_owned: false })
697         }
698 }
699
700 // We're essentially a pointer already, or at least a set of pointers, so allow us to be used
701 // directly as a Deref trait in higher-level structs:
702 impl std::ops::Deref for Sign {
703         type Target = Self;
704         fn deref(&self) -> &Self {
705                 self
706         }
707 }
708 /// Calls the free function if one is set
709 #[no_mangle]
710 pub extern "C" fn Sign_free(this_ptr: Sign) { }
711 impl Drop for Sign {
712         fn drop(&mut self) {
713                 if let Some(f) = self.free {
714                         f(self.this_arg);
715                 }
716         }
717 }
718 /// A trait to describe an object which can get user secrets and key material.
719 #[repr(C)]
720 pub struct KeysInterface {
721         /// An opaque pointer which is passed to your function implementations as an argument.
722         /// This has no meaning in the LDK, and can be NULL or any other value.
723         pub this_arg: *mut c_void,
724         /// Get node secret key (aka node_id or network_key).
725         ///
726         /// This method must return the same value each time it is called.
727         #[must_use]
728         pub get_node_secret: extern "C" fn (this_arg: *const c_void) -> crate::c_types::SecretKey,
729         /// Get a script pubkey which we send funds to when claiming on-chain contestable outputs.
730         ///
731         /// This method should return a different value each time it is called, to avoid linking
732         /// on-chain funds across channels as controlled to the same user.
733         #[must_use]
734         pub get_destination_script: extern "C" fn (this_arg: *const c_void) -> crate::c_types::derived::CVec_u8Z,
735         /// Get a public key which we will send funds to (in the form of a P2WPKH output) when closing
736         /// a channel.
737         ///
738         /// This method should return a different value each time it is called, to avoid linking
739         /// on-chain funds across channels as controlled to the same user.
740         #[must_use]
741         pub get_shutdown_pubkey: extern "C" fn (this_arg: *const c_void) -> crate::c_types::PublicKey,
742         /// Get a new set of Sign for per-channel secrets. These MUST be unique even if you
743         /// restarted with some stale data!
744         ///
745         /// This method must return a different value each time it is called.
746         #[must_use]
747         pub get_channel_signer: extern "C" fn (this_arg: *const c_void, inbound: bool, channel_value_satoshis: u64) -> crate::chain::keysinterface::Sign,
748         /// Gets a unique, cryptographically-secure, random 32 byte value. This is used for encrypting
749         /// onion packets and for temporary channel IDs. There is no requirement that these be
750         /// persisted anywhere, though they must be unique across restarts.
751         ///
752         /// This method must return a different value each time it is called.
753         #[must_use]
754         pub get_secure_random_bytes: extern "C" fn (this_arg: *const c_void) -> crate::c_types::ThirtyTwoBytes,
755         /// Reads a `Signer` for this `KeysInterface` from the given input stream.
756         /// This is only called during deserialization of other objects which contain
757         /// `Sign`-implementing objects (ie `ChannelMonitor`s and `ChannelManager`s).
758         /// The bytes are exactly those which `<Self::Signer as Writeable>::write()` writes, and
759         /// contain no versioning scheme. You may wish to include your own version prefix and ensure
760         /// you've read all of the provided bytes to ensure no corruption occurred.
761         #[must_use]
762         pub read_chan_signer: extern "C" fn (this_arg: *const c_void, reader: crate::c_types::u8slice) -> crate::c_types::derived::CResult_SignDecodeErrorZ,
763         /// Frees any resources associated with this object given its this_arg pointer.
764         /// Does not need to free the outer struct containing function pointers and may be NULL is no resources need to be freed.
765         pub free: Option<extern "C" fn(this_arg: *mut c_void)>,
766 }
767 unsafe impl Send for KeysInterface {}
768 unsafe impl Sync for KeysInterface {}
769
770 use lightning::chain::keysinterface::KeysInterface as rustKeysInterface;
771 impl rustKeysInterface for KeysInterface {
772         type Signer = crate::chain::keysinterface::Sign;
773         fn get_node_secret(&self) -> bitcoin::secp256k1::key::SecretKey {
774                 let mut ret = (self.get_node_secret)(self.this_arg);
775                 ret.into_rust()
776         }
777         fn get_destination_script(&self) -> bitcoin::blockdata::script::Script {
778                 let mut ret = (self.get_destination_script)(self.this_arg);
779                 ::bitcoin::blockdata::script::Script::from(ret.into_rust())
780         }
781         fn get_shutdown_pubkey(&self) -> bitcoin::secp256k1::key::PublicKey {
782                 let mut ret = (self.get_shutdown_pubkey)(self.this_arg);
783                 ret.into_rust()
784         }
785         fn get_channel_signer(&self, inbound: bool, channel_value_satoshis: u64) -> crate::chain::keysinterface::Sign {
786                 let mut ret = (self.get_channel_signer)(self.this_arg, inbound, channel_value_satoshis);
787                 ret
788         }
789         fn get_secure_random_bytes(&self) -> [u8; 32] {
790                 let mut ret = (self.get_secure_random_bytes)(self.this_arg);
791                 ret.data
792         }
793         fn read_chan_signer(&self, reader: &[u8]) -> Result<crate::chain::keysinterface::Sign, lightning::ln::msgs::DecodeError> {
794                 let mut local_reader = crate::c_types::u8slice::from_slice(reader);
795                 let mut ret = (self.read_chan_signer)(self.this_arg, local_reader);
796                 let mut local_ret = match ret.result_ok { true => Ok( { (*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.result)) }) }), false => Err( { *unsafe { Box::from_raw((*unsafe { Box::from_raw(<*mut _>::take_ptr(&mut ret.contents.err)) }).take_inner()) } })};
797                 local_ret
798         }
799 }
800
801 // We're essentially a pointer already, or at least a set of pointers, so allow us to be used
802 // directly as a Deref trait in higher-level structs:
803 impl std::ops::Deref for KeysInterface {
804         type Target = Self;
805         fn deref(&self) -> &Self {
806                 self
807         }
808 }
809 /// Calls the free function if one is set
810 #[no_mangle]
811 pub extern "C" fn KeysInterface_free(this_ptr: KeysInterface) { }
812 impl Drop for KeysInterface {
813         fn drop(&mut self) {
814                 if let Some(f) = self.free {
815                         f(self.this_arg);
816                 }
817         }
818 }
819
820 use lightning::chain::keysinterface::InMemorySigner as nativeInMemorySignerImport;
821 type nativeInMemorySigner = nativeInMemorySignerImport;
822
823 /// A simple implementation of Sign that just keeps the private keys in memory.
824 ///
825 /// This implementation performs no policy checks and is insufficient by itself as
826 /// a secure external signer.
827 #[must_use]
828 #[repr(C)]
829 pub struct InMemorySigner {
830         /// A pointer to the opaque Rust object.
831
832         /// Nearly everywhere, inner must be non-null, however in places where
833         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
834         pub inner: *mut nativeInMemorySigner,
835         /// Indicates that this is the only struct which contains the same pointer.
836
837         /// Rust functions which take ownership of an object provided via an argument require
838         /// this to be true and invalidate the object pointed to by inner.
839         pub is_owned: bool,
840 }
841
842 impl Drop for InMemorySigner {
843         fn drop(&mut self) {
844                 if self.is_owned && !<*mut nativeInMemorySigner>::is_null(self.inner) {
845                         let _ = unsafe { Box::from_raw(self.inner) };
846                 }
847         }
848 }
849 /// Frees any resources used by the InMemorySigner, if is_owned is set and inner is non-NULL.
850 #[no_mangle]
851 pub extern "C" fn InMemorySigner_free(this_obj: InMemorySigner) { }
852 #[allow(unused)]
853 /// Used only if an object of this type is returned as a trait impl by a method
854 extern "C" fn InMemorySigner_free_void(this_ptr: *mut c_void) {
855         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeInMemorySigner); }
856 }
857 #[allow(unused)]
858 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
859 impl InMemorySigner {
860         pub(crate) fn take_inner(mut self) -> *mut nativeInMemorySigner {
861                 assert!(self.is_owned);
862                 let ret = self.inner;
863                 self.inner = std::ptr::null_mut();
864                 ret
865         }
866 }
867 /// Private key of anchor tx
868 #[no_mangle]
869 pub extern "C" fn InMemorySigner_get_funding_key(this_ptr: &InMemorySigner) -> *const [u8; 32] {
870         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.funding_key;
871         (*inner_val).as_ref()
872 }
873 /// Private key of anchor tx
874 #[no_mangle]
875 pub extern "C" fn InMemorySigner_set_funding_key(this_ptr: &mut InMemorySigner, mut val: crate::c_types::SecretKey) {
876         unsafe { &mut *this_ptr.inner }.funding_key = val.into_rust();
877 }
878 /// Holder secret key for blinded revocation pubkey
879 #[no_mangle]
880 pub extern "C" fn InMemorySigner_get_revocation_base_key(this_ptr: &InMemorySigner) -> *const [u8; 32] {
881         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.revocation_base_key;
882         (*inner_val).as_ref()
883 }
884 /// Holder secret key for blinded revocation pubkey
885 #[no_mangle]
886 pub extern "C" fn InMemorySigner_set_revocation_base_key(this_ptr: &mut InMemorySigner, mut val: crate::c_types::SecretKey) {
887         unsafe { &mut *this_ptr.inner }.revocation_base_key = val.into_rust();
888 }
889 /// Holder secret key used for our balance in counterparty-broadcasted commitment transactions
890 #[no_mangle]
891 pub extern "C" fn InMemorySigner_get_payment_key(this_ptr: &InMemorySigner) -> *const [u8; 32] {
892         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.payment_key;
893         (*inner_val).as_ref()
894 }
895 /// Holder secret key used for our balance in counterparty-broadcasted commitment transactions
896 #[no_mangle]
897 pub extern "C" fn InMemorySigner_set_payment_key(this_ptr: &mut InMemorySigner, mut val: crate::c_types::SecretKey) {
898         unsafe { &mut *this_ptr.inner }.payment_key = val.into_rust();
899 }
900 /// Holder secret key used in HTLC tx
901 #[no_mangle]
902 pub extern "C" fn InMemorySigner_get_delayed_payment_base_key(this_ptr: &InMemorySigner) -> *const [u8; 32] {
903         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.delayed_payment_base_key;
904         (*inner_val).as_ref()
905 }
906 /// Holder secret key used in HTLC tx
907 #[no_mangle]
908 pub extern "C" fn InMemorySigner_set_delayed_payment_base_key(this_ptr: &mut InMemorySigner, mut val: crate::c_types::SecretKey) {
909         unsafe { &mut *this_ptr.inner }.delayed_payment_base_key = val.into_rust();
910 }
911 /// Holder htlc secret key used in commitment tx htlc outputs
912 #[no_mangle]
913 pub extern "C" fn InMemorySigner_get_htlc_base_key(this_ptr: &InMemorySigner) -> *const [u8; 32] {
914         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.htlc_base_key;
915         (*inner_val).as_ref()
916 }
917 /// Holder htlc secret key used in commitment tx htlc outputs
918 #[no_mangle]
919 pub extern "C" fn InMemorySigner_set_htlc_base_key(this_ptr: &mut InMemorySigner, mut val: crate::c_types::SecretKey) {
920         unsafe { &mut *this_ptr.inner }.htlc_base_key = val.into_rust();
921 }
922 /// Commitment seed
923 #[no_mangle]
924 pub extern "C" fn InMemorySigner_get_commitment_seed(this_ptr: &InMemorySigner) -> *const [u8; 32] {
925         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.commitment_seed;
926         &(*inner_val)
927 }
928 /// Commitment seed
929 #[no_mangle]
930 pub extern "C" fn InMemorySigner_set_commitment_seed(this_ptr: &mut InMemorySigner, mut val: crate::c_types::ThirtyTwoBytes) {
931         unsafe { &mut *this_ptr.inner }.commitment_seed = val.data;
932 }
933 impl Clone for InMemorySigner {
934         fn clone(&self) -> Self {
935                 Self {
936                         inner: if <*mut nativeInMemorySigner>::is_null(self.inner) { std::ptr::null_mut() } else {
937                                 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
938                         is_owned: true,
939                 }
940         }
941 }
942 #[allow(unused)]
943 /// Used only if an object of this type is returned as a trait impl by a method
944 pub(crate) extern "C" fn InMemorySigner_clone_void(this_ptr: *const c_void) -> *mut c_void {
945         Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeInMemorySigner)).clone() })) as *mut c_void
946 }
947 #[no_mangle]
948 /// Creates a copy of the InMemorySigner
949 pub extern "C" fn InMemorySigner_clone(orig: &InMemorySigner) -> InMemorySigner {
950         orig.clone()
951 }
952 /// Create a new InMemorySigner
953 #[must_use]
954 #[no_mangle]
955 pub extern "C" fn InMemorySigner_new(mut funding_key: crate::c_types::SecretKey, mut revocation_base_key: crate::c_types::SecretKey, mut payment_key: crate::c_types::SecretKey, mut delayed_payment_base_key: crate::c_types::SecretKey, mut htlc_base_key: crate::c_types::SecretKey, mut commitment_seed: crate::c_types::ThirtyTwoBytes, mut channel_value_satoshis: u64, mut channel_keys_id: crate::c_types::ThirtyTwoBytes) -> crate::chain::keysinterface::InMemorySigner {
956         let mut ret = lightning::chain::keysinterface::InMemorySigner::new(secp256k1::SECP256K1, funding_key.into_rust(), revocation_base_key.into_rust(), payment_key.into_rust(), delayed_payment_base_key.into_rust(), htlc_base_key.into_rust(), commitment_seed.data, channel_value_satoshis, channel_keys_id.data);
957         crate::chain::keysinterface::InMemorySigner { inner: Box::into_raw(Box::new(ret)), is_owned: true }
958 }
959
960 /// Counterparty pubkeys.
961 /// Will panic if ready_channel wasn't called.
962 #[must_use]
963 #[no_mangle]
964 pub extern "C" fn InMemorySigner_counterparty_pubkeys(this_arg: &InMemorySigner) -> crate::ln::chan_utils::ChannelPublicKeys {
965         let mut ret = unsafe { &*this_arg.inner }.counterparty_pubkeys();
966         crate::ln::chan_utils::ChannelPublicKeys { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
967 }
968
969 /// The contest_delay value specified by our counterparty and applied on holder-broadcastable
970 /// transactions, ie the amount of time that we have to wait to recover our funds if we
971 /// broadcast a transaction.
972 /// Will panic if ready_channel wasn't called.
973 #[must_use]
974 #[no_mangle]
975 pub extern "C" fn InMemorySigner_counterparty_selected_contest_delay(this_arg: &InMemorySigner) -> u16 {
976         let mut ret = unsafe { &*this_arg.inner }.counterparty_selected_contest_delay();
977         ret
978 }
979
980 /// The contest_delay value specified by us and applied on transactions broadcastable
981 /// by our counterparty, ie the amount of time that they have to wait to recover their funds
982 /// if they broadcast a transaction.
983 /// Will panic if ready_channel wasn't called.
984 #[must_use]
985 #[no_mangle]
986 pub extern "C" fn InMemorySigner_holder_selected_contest_delay(this_arg: &InMemorySigner) -> u16 {
987         let mut ret = unsafe { &*this_arg.inner }.holder_selected_contest_delay();
988         ret
989 }
990
991 /// Whether the holder is the initiator
992 /// Will panic if ready_channel wasn't called.
993 #[must_use]
994 #[no_mangle]
995 pub extern "C" fn InMemorySigner_is_outbound(this_arg: &InMemorySigner) -> bool {
996         let mut ret = unsafe { &*this_arg.inner }.is_outbound();
997         ret
998 }
999
1000 /// Funding outpoint
1001 /// Will panic if ready_channel wasn't called.
1002 #[must_use]
1003 #[no_mangle]
1004 pub extern "C" fn InMemorySigner_funding_outpoint(this_arg: &InMemorySigner) -> crate::chain::transaction::OutPoint {
1005         let mut ret = unsafe { &*this_arg.inner }.funding_outpoint();
1006         crate::chain::transaction::OutPoint { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
1007 }
1008
1009 /// Obtain a ChannelTransactionParameters for this channel, to be used when verifying or
1010 /// building transactions.
1011 ///
1012 /// Will panic if ready_channel wasn't called.
1013 #[must_use]
1014 #[no_mangle]
1015 pub extern "C" fn InMemorySigner_get_channel_parameters(this_arg: &InMemorySigner) -> crate::ln::chan_utils::ChannelTransactionParameters {
1016         let mut ret = unsafe { &*this_arg.inner }.get_channel_parameters();
1017         crate::ln::chan_utils::ChannelTransactionParameters { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
1018 }
1019
1020 /// Sign the single input of spend_tx at index `input_idx` which spends the output
1021 /// described by descriptor, returning the witness stack for the input.
1022 ///
1023 /// Returns an Err if the input at input_idx does not exist, has a non-empty script_sig,
1024 /// or is not spending the outpoint described by `descriptor.outpoint`.
1025 #[must_use]
1026 #[no_mangle]
1027 pub extern "C" fn InMemorySigner_sign_counterparty_payment_input(this_arg: &InMemorySigner, mut spend_tx: crate::c_types::Transaction, mut input_idx: usize, descriptor: &crate::chain::keysinterface::StaticPaymentOutputDescriptor) -> crate::c_types::derived::CResult_CVec_CVec_u8ZZNoneZ {
1028         let mut ret = unsafe { &*this_arg.inner }.sign_counterparty_payment_input(&spend_tx.into_bitcoin(), input_idx, unsafe { &*descriptor.inner }, secp256k1::SECP256K1);
1029         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( { let mut local_ret_0_0 = Vec::new(); for mut item in item.drain(..) { local_ret_0_0.push( { item }); }; local_ret_0_0.into() }); }; local_ret_0.into() }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { 0u8 /*e*/ }).into() };
1030         local_ret
1031 }
1032
1033 /// Sign the single input of spend_tx at index `input_idx` which spends the output
1034 /// described by descriptor, returning the witness stack for the input.
1035 ///
1036 /// Returns an Err if the input at input_idx does not exist, has a non-empty script_sig,
1037 /// is not spending the outpoint described by `descriptor.outpoint`, or does not have a
1038 /// sequence set to `descriptor.to_self_delay`.
1039 #[must_use]
1040 #[no_mangle]
1041 pub extern "C" fn InMemorySigner_sign_dynamic_p2wsh_input(this_arg: &InMemorySigner, mut spend_tx: crate::c_types::Transaction, mut input_idx: usize, descriptor: &crate::chain::keysinterface::DelayedPaymentOutputDescriptor) -> crate::c_types::derived::CResult_CVec_CVec_u8ZZNoneZ {
1042         let mut ret = unsafe { &*this_arg.inner }.sign_dynamic_p2wsh_input(&spend_tx.into_bitcoin(), input_idx, unsafe { &*descriptor.inner }, secp256k1::SECP256K1);
1043         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( { let mut local_ret_0_0 = Vec::new(); for mut item in item.drain(..) { local_ret_0_0.push( { item }); }; local_ret_0_0.into() }); }; local_ret_0.into() }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { 0u8 /*e*/ }).into() };
1044         local_ret
1045 }
1046
1047 impl From<nativeInMemorySigner> for crate::chain::keysinterface::Sign {
1048         fn from(obj: nativeInMemorySigner) -> Self {
1049                 let mut rust_obj = InMemorySigner { inner: Box::into_raw(Box::new(obj)), is_owned: true };
1050                 let mut ret = InMemorySigner_as_Sign(&rust_obj);
1051                 // 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
1052                 rust_obj.inner = std::ptr::null_mut();
1053                 ret.free = Some(InMemorySigner_free_void);
1054                 ret
1055         }
1056 }
1057 /// Constructs a new Sign which calls the relevant methods on this_arg.
1058 /// This copies the `inner` pointer in this_arg and thus the returned Sign must be freed before this_arg is
1059 #[no_mangle]
1060 pub extern "C" fn InMemorySigner_as_Sign(this_arg: &InMemorySigner) -> crate::chain::keysinterface::Sign {
1061         crate::chain::keysinterface::Sign {
1062                 this_arg: unsafe { (*this_arg).inner as *mut c_void },
1063                 free: None,
1064                 get_per_commitment_point: InMemorySigner_Sign_get_per_commitment_point,
1065                 release_commitment_secret: InMemorySigner_Sign_release_commitment_secret,
1066
1067                 pubkeys: crate::ln::chan_utils::ChannelPublicKeys { inner: std::ptr::null_mut(), is_owned: true },
1068                 set_pubkeys: Some(InMemorySigner_Sign_set_pubkeys),
1069                 channel_keys_id: InMemorySigner_Sign_channel_keys_id,
1070                 sign_counterparty_commitment: InMemorySigner_Sign_sign_counterparty_commitment,
1071                 sign_holder_commitment_and_htlcs: InMemorySigner_Sign_sign_holder_commitment_and_htlcs,
1072                 sign_justice_transaction: InMemorySigner_Sign_sign_justice_transaction,
1073                 sign_counterparty_htlc_transaction: InMemorySigner_Sign_sign_counterparty_htlc_transaction,
1074                 sign_closing_transaction: InMemorySigner_Sign_sign_closing_transaction,
1075                 sign_channel_announcement: InMemorySigner_Sign_sign_channel_announcement,
1076                 ready_channel: InMemorySigner_Sign_ready_channel,
1077                 clone: Some(InMemorySigner_clone_void),
1078                 write: InMemorySigner_write_void,
1079         }
1080 }
1081
1082 #[must_use]
1083 extern "C" fn InMemorySigner_Sign_get_per_commitment_point(this_arg: *const c_void, mut idx: u64) -> crate::c_types::PublicKey {
1084         let mut ret = <nativeInMemorySigner as lightning::chain::keysinterface::Sign<>>::get_per_commitment_point(unsafe { &mut *(this_arg as *mut nativeInMemorySigner) }, idx, secp256k1::SECP256K1);
1085         crate::c_types::PublicKey::from_rust(&ret)
1086 }
1087 #[must_use]
1088 extern "C" fn InMemorySigner_Sign_release_commitment_secret(this_arg: *const c_void, mut idx: u64) -> crate::c_types::ThirtyTwoBytes {
1089         let mut ret = <nativeInMemorySigner as lightning::chain::keysinterface::Sign<>>::release_commitment_secret(unsafe { &mut *(this_arg as *mut nativeInMemorySigner) }, idx);
1090         crate::c_types::ThirtyTwoBytes { data: ret }
1091 }
1092 #[must_use]
1093 extern "C" fn InMemorySigner_Sign_pubkeys(this_arg: *const c_void) -> crate::ln::chan_utils::ChannelPublicKeys {
1094         let mut ret = <nativeInMemorySigner as lightning::chain::keysinterface::Sign<>>::pubkeys(unsafe { &mut *(this_arg as *mut nativeInMemorySigner) }, );
1095         crate::ln::chan_utils::ChannelPublicKeys { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
1096 }
1097 extern "C" fn InMemorySigner_Sign_set_pubkeys(trait_self_arg: &Sign) {
1098         // This is a bit race-y in the general case, but for our specific use-cases today, we're safe
1099         // Specifically, we must ensure that the first time we're called it can never be in parallel
1100         if trait_self_arg.pubkeys.inner.is_null() {
1101                 unsafe { &mut *(trait_self_arg as *const Sign  as *mut Sign) }.pubkeys = InMemorySigner_Sign_pubkeys(trait_self_arg.this_arg);
1102         }
1103 }
1104 #[must_use]
1105 extern "C" fn InMemorySigner_Sign_channel_keys_id(this_arg: *const c_void) -> crate::c_types::ThirtyTwoBytes {
1106         let mut ret = <nativeInMemorySigner as lightning::chain::keysinterface::Sign<>>::channel_keys_id(unsafe { &mut *(this_arg as *mut nativeInMemorySigner) }, );
1107         crate::c_types::ThirtyTwoBytes { data: ret }
1108 }
1109 #[must_use]
1110 extern "C" fn InMemorySigner_Sign_sign_counterparty_commitment(this_arg: *const c_void, commitment_tx: &crate::ln::chan_utils::CommitmentTransaction) -> crate::c_types::derived::CResult_C2Tuple_SignatureCVec_SignatureZZNoneZ {
1111         let mut ret = <nativeInMemorySigner as lightning::chain::keysinterface::Sign<>>::sign_counterparty_commitment(unsafe { &mut *(this_arg as *mut nativeInMemorySigner) }, unsafe { &*commitment_tx.inner }, secp256k1::SECP256K1);
1112         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { let (mut orig_ret_0_0, mut orig_ret_0_1) = o; let mut local_orig_ret_0_1 = Vec::new(); for mut item in orig_ret_0_1.drain(..) { local_orig_ret_0_1.push( { crate::c_types::Signature::from_rust(&item) }); }; let mut local_ret_0 = (crate::c_types::Signature::from_rust(&orig_ret_0_0), local_orig_ret_0_1.into()).into(); local_ret_0 }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { 0u8 /*e*/ }).into() };
1113         local_ret
1114 }
1115 #[must_use]
1116 extern "C" fn InMemorySigner_Sign_sign_holder_commitment_and_htlcs(this_arg: *const c_void, commitment_tx: &crate::ln::chan_utils::HolderCommitmentTransaction) -> crate::c_types::derived::CResult_C2Tuple_SignatureCVec_SignatureZZNoneZ {
1117         let mut ret = <nativeInMemorySigner as lightning::chain::keysinterface::Sign<>>::sign_holder_commitment_and_htlcs(unsafe { &mut *(this_arg as *mut nativeInMemorySigner) }, unsafe { &*commitment_tx.inner }, secp256k1::SECP256K1);
1118         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { let (mut orig_ret_0_0, mut orig_ret_0_1) = o; let mut local_orig_ret_0_1 = Vec::new(); for mut item in orig_ret_0_1.drain(..) { local_orig_ret_0_1.push( { crate::c_types::Signature::from_rust(&item) }); }; let mut local_ret_0 = (crate::c_types::Signature::from_rust(&orig_ret_0_0), local_orig_ret_0_1.into()).into(); local_ret_0 }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { 0u8 /*e*/ }).into() };
1119         local_ret
1120 }
1121 #[must_use]
1122 extern "C" fn InMemorySigner_Sign_sign_justice_transaction(this_arg: *const c_void, mut justice_tx: crate::c_types::Transaction, mut input: usize, mut amount: u64, per_commitment_key: *const [u8; 32], htlc: &crate::ln::chan_utils::HTLCOutputInCommitment) -> crate::c_types::derived::CResult_SignatureNoneZ {
1123         let mut local_htlc = if htlc.inner.is_null() { None } else { Some((* { unsafe { &*htlc.inner } }).clone()) };
1124         let mut ret = <nativeInMemorySigner as lightning::chain::keysinterface::Sign<>>::sign_justice_transaction(unsafe { &mut *(this_arg as *mut nativeInMemorySigner) }, &justice_tx.into_bitcoin(), input, amount, &::bitcoin::secp256k1::key::SecretKey::from_slice(&unsafe { *per_commitment_key}[..]).unwrap(), &local_htlc, secp256k1::SECP256K1);
1125         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::c_types::Signature::from_rust(&o) }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { 0u8 /*e*/ }).into() };
1126         local_ret
1127 }
1128 #[must_use]
1129 extern "C" fn InMemorySigner_Sign_sign_counterparty_htlc_transaction(this_arg: *const c_void, mut htlc_tx: crate::c_types::Transaction, mut input: usize, mut amount: u64, mut per_commitment_point: crate::c_types::PublicKey, htlc: &crate::ln::chan_utils::HTLCOutputInCommitment) -> crate::c_types::derived::CResult_SignatureNoneZ {
1130         let mut ret = <nativeInMemorySigner as lightning::chain::keysinterface::Sign<>>::sign_counterparty_htlc_transaction(unsafe { &mut *(this_arg as *mut nativeInMemorySigner) }, &htlc_tx.into_bitcoin(), input, amount, &per_commitment_point.into_rust(), unsafe { &*htlc.inner }, secp256k1::SECP256K1);
1131         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::c_types::Signature::from_rust(&o) }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { 0u8 /*e*/ }).into() };
1132         local_ret
1133 }
1134 #[must_use]
1135 extern "C" fn InMemorySigner_Sign_sign_closing_transaction(this_arg: *const c_void, mut closing_tx: crate::c_types::Transaction) -> crate::c_types::derived::CResult_SignatureNoneZ {
1136         let mut ret = <nativeInMemorySigner as lightning::chain::keysinterface::Sign<>>::sign_closing_transaction(unsafe { &mut *(this_arg as *mut nativeInMemorySigner) }, &closing_tx.into_bitcoin(), secp256k1::SECP256K1);
1137         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::c_types::Signature::from_rust(&o) }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { 0u8 /*e*/ }).into() };
1138         local_ret
1139 }
1140 #[must_use]
1141 extern "C" fn InMemorySigner_Sign_sign_channel_announcement(this_arg: *const c_void, msg: &crate::ln::msgs::UnsignedChannelAnnouncement) -> crate::c_types::derived::CResult_SignatureNoneZ {
1142         let mut ret = <nativeInMemorySigner as lightning::chain::keysinterface::Sign<>>::sign_channel_announcement(unsafe { &mut *(this_arg as *mut nativeInMemorySigner) }, unsafe { &*msg.inner }, secp256k1::SECP256K1);
1143         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::c_types::Signature::from_rust(&o) }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { 0u8 /*e*/ }).into() };
1144         local_ret
1145 }
1146 extern "C" fn InMemorySigner_Sign_ready_channel(this_arg: *mut c_void, channel_parameters: &crate::ln::chan_utils::ChannelTransactionParameters) {
1147         <nativeInMemorySigner as lightning::chain::keysinterface::Sign<>>::ready_channel(unsafe { &mut *(this_arg as *mut nativeInMemorySigner) }, unsafe { &*channel_parameters.inner })
1148 }
1149
1150 #[no_mangle]
1151 /// Serialize the InMemorySigner object into a byte array which can be read by InMemorySigner_read
1152 pub extern "C" fn InMemorySigner_write(obj: &InMemorySigner) -> crate::c_types::derived::CVec_u8Z {
1153         crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
1154 }
1155 #[no_mangle]
1156 pub(crate) extern "C" fn InMemorySigner_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
1157         crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeInMemorySigner) })
1158 }
1159 #[no_mangle]
1160 /// Read a InMemorySigner from a byte array, created by InMemorySigner_write
1161 pub extern "C" fn InMemorySigner_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_InMemorySignerDecodeErrorZ {
1162         let res = crate::c_types::deserialize_obj(ser);
1163         let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::chain::keysinterface::InMemorySigner { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
1164         local_res
1165 }
1166
1167 use lightning::chain::keysinterface::KeysManager as nativeKeysManagerImport;
1168 type nativeKeysManager = nativeKeysManagerImport;
1169
1170 /// Simple KeysInterface implementor that takes a 32-byte seed for use as a BIP 32 extended key
1171 /// and derives keys from that.
1172 ///
1173 /// Your node_id is seed/0'
1174 /// ChannelMonitor closes may use seed/1'
1175 /// Cooperative closes may use seed/2'
1176 /// The two close keys may be needed to claim on-chain funds!
1177 #[must_use]
1178 #[repr(C)]
1179 pub struct KeysManager {
1180         /// A pointer to the opaque Rust object.
1181
1182         /// Nearly everywhere, inner must be non-null, however in places where
1183         /// the Rust equivalent takes an Option, it may be set to null to indicate None.
1184         pub inner: *mut nativeKeysManager,
1185         /// Indicates that this is the only struct which contains the same pointer.
1186
1187         /// Rust functions which take ownership of an object provided via an argument require
1188         /// this to be true and invalidate the object pointed to by inner.
1189         pub is_owned: bool,
1190 }
1191
1192 impl Drop for KeysManager {
1193         fn drop(&mut self) {
1194                 if self.is_owned && !<*mut nativeKeysManager>::is_null(self.inner) {
1195                         let _ = unsafe { Box::from_raw(self.inner) };
1196                 }
1197         }
1198 }
1199 /// Frees any resources used by the KeysManager, if is_owned is set and inner is non-NULL.
1200 #[no_mangle]
1201 pub extern "C" fn KeysManager_free(this_obj: KeysManager) { }
1202 #[allow(unused)]
1203 /// Used only if an object of this type is returned as a trait impl by a method
1204 extern "C" fn KeysManager_free_void(this_ptr: *mut c_void) {
1205         unsafe { let _ = Box::from_raw(this_ptr as *mut nativeKeysManager); }
1206 }
1207 #[allow(unused)]
1208 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
1209 impl KeysManager {
1210         pub(crate) fn take_inner(mut self) -> *mut nativeKeysManager {
1211                 assert!(self.is_owned);
1212                 let ret = self.inner;
1213                 self.inner = std::ptr::null_mut();
1214                 ret
1215         }
1216 }
1217 /// Constructs a KeysManager from a 32-byte seed. If the seed is in some way biased (eg your
1218 /// CSRNG is busted) this may panic (but more importantly, you will possibly lose funds).
1219 /// starting_time isn't strictly required to actually be a time, but it must absolutely,
1220 /// without a doubt, be unique to this instance. ie if you start multiple times with the same
1221 /// seed, starting_time must be unique to each run. Thus, the easiest way to achieve this is to
1222 /// simply use the current time (with very high precision).
1223 ///
1224 /// The seed MUST be backed up safely prior to use so that the keys can be re-created, however,
1225 /// obviously, starting_time should be unique every time you reload the library - it is only
1226 /// used to generate new ephemeral key data (which will be stored by the individual channel if
1227 /// necessary).
1228 ///
1229 /// Note that the seed is required to recover certain on-chain funds independent of
1230 /// ChannelMonitor data, though a current copy of ChannelMonitor data is also required for any
1231 /// channel, and some on-chain during-closing funds.
1232 ///
1233 /// Note that until the 0.1 release there is no guarantee of backward compatibility between
1234 /// versions. Once the library is more fully supported, the docs will be updated to include a
1235 /// detailed description of the guarantee.
1236 #[must_use]
1237 #[no_mangle]
1238 pub extern "C" fn KeysManager_new(seed: *const [u8; 32], mut starting_time_secs: u64, mut starting_time_nanos: u32) -> KeysManager {
1239         let mut ret = lightning::chain::keysinterface::KeysManager::new(unsafe { &*seed}, starting_time_secs, starting_time_nanos);
1240         KeysManager { inner: Box::into_raw(Box::new(ret)), is_owned: true }
1241 }
1242
1243 /// Derive an old Sign containing per-channel secrets based on a key derivation parameters.
1244 ///
1245 /// Key derivation parameters are accessible through a per-channel secrets
1246 /// Sign::channel_keys_id and is provided inside DynamicOuputP2WSH in case of
1247 /// onchain output detection for which a corresponding delayed_payment_key must be derived.
1248 #[must_use]
1249 #[no_mangle]
1250 pub extern "C" fn KeysManager_derive_channel_keys(this_arg: &KeysManager, mut channel_value_satoshis: u64, params: *const [u8; 32]) -> crate::chain::keysinterface::InMemorySigner {
1251         let mut ret = unsafe { &*this_arg.inner }.derive_channel_keys(channel_value_satoshis, unsafe { &*params});
1252         crate::chain::keysinterface::InMemorySigner { inner: Box::into_raw(Box::new(ret)), is_owned: true }
1253 }
1254
1255 /// Creates a Transaction which spends the given descriptors to the given outputs, plus an
1256 /// output to the given change destination (if sufficient change value remains). The
1257 /// transaction will have a feerate, at least, of the given value.
1258 ///
1259 /// Returns `Err(())` if the output value is greater than the input value minus required fee or
1260 /// if a descriptor was duplicated.
1261 ///
1262 /// We do not enforce that outputs meet the dust limit or that any output scripts are standard.
1263 ///
1264 /// May panic if the `SpendableOutputDescriptor`s were not generated by Channels which used
1265 /// this KeysManager or one of the `InMemorySigner` created by this KeysManager.
1266 #[must_use]
1267 #[no_mangle]
1268 pub extern "C" fn KeysManager_spend_spendable_outputs(this_arg: &KeysManager, mut descriptors: crate::c_types::derived::CVec_SpendableOutputDescriptorZ, mut outputs: crate::c_types::derived::CVec_TxOutZ, mut change_destination_script: crate::c_types::derived::CVec_u8Z, mut feerate_sat_per_1000_weight: u32) -> crate::c_types::derived::CResult_TransactionNoneZ {
1269         let mut local_descriptors = Vec::new(); for mut item in descriptors.into_rust().drain(..) { local_descriptors.push( { item.into_native() }); };
1270         let mut local_outputs = Vec::new(); for mut item in outputs.into_rust().drain(..) { local_outputs.push( { item.into_rust() }); };
1271         let mut ret = unsafe { &*this_arg.inner }.spend_spendable_outputs(&local_descriptors.iter().collect::<Vec<_>>()[..], local_outputs, ::bitcoin::blockdata::script::Script::from(change_destination_script.into_rust()), feerate_sat_per_1000_weight, secp256k1::SECP256K1);
1272         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { let mut local_ret_0 = ::bitcoin::consensus::encode::serialize(&o); crate::c_types::Transaction::from_vec(local_ret_0) }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { 0u8 /*e*/ }).into() };
1273         local_ret
1274 }
1275
1276 impl From<nativeKeysManager> for crate::chain::keysinterface::KeysInterface {
1277         fn from(obj: nativeKeysManager) -> Self {
1278                 let mut rust_obj = KeysManager { inner: Box::into_raw(Box::new(obj)), is_owned: true };
1279                 let mut ret = KeysManager_as_KeysInterface(&rust_obj);
1280                 // 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
1281                 rust_obj.inner = std::ptr::null_mut();
1282                 ret.free = Some(KeysManager_free_void);
1283                 ret
1284         }
1285 }
1286 /// Constructs a new KeysInterface which calls the relevant methods on this_arg.
1287 /// This copies the `inner` pointer in this_arg and thus the returned KeysInterface must be freed before this_arg is
1288 #[no_mangle]
1289 pub extern "C" fn KeysManager_as_KeysInterface(this_arg: &KeysManager) -> crate::chain::keysinterface::KeysInterface {
1290         crate::chain::keysinterface::KeysInterface {
1291                 this_arg: unsafe { (*this_arg).inner as *mut c_void },
1292                 free: None,
1293                 get_node_secret: KeysManager_KeysInterface_get_node_secret,
1294                 get_destination_script: KeysManager_KeysInterface_get_destination_script,
1295                 get_shutdown_pubkey: KeysManager_KeysInterface_get_shutdown_pubkey,
1296                 get_channel_signer: KeysManager_KeysInterface_get_channel_signer,
1297                 get_secure_random_bytes: KeysManager_KeysInterface_get_secure_random_bytes,
1298                 read_chan_signer: KeysManager_KeysInterface_read_chan_signer,
1299         }
1300 }
1301
1302 #[must_use]
1303 extern "C" fn KeysManager_KeysInterface_get_node_secret(this_arg: *const c_void) -> crate::c_types::SecretKey {
1304         let mut ret = <nativeKeysManager as lightning::chain::keysinterface::KeysInterface<>>::get_node_secret(unsafe { &mut *(this_arg as *mut nativeKeysManager) }, );
1305         crate::c_types::SecretKey::from_rust(ret)
1306 }
1307 #[must_use]
1308 extern "C" fn KeysManager_KeysInterface_get_destination_script(this_arg: *const c_void) -> crate::c_types::derived::CVec_u8Z {
1309         let mut ret = <nativeKeysManager as lightning::chain::keysinterface::KeysInterface<>>::get_destination_script(unsafe { &mut *(this_arg as *mut nativeKeysManager) }, );
1310         ret.into_bytes().into()
1311 }
1312 #[must_use]
1313 extern "C" fn KeysManager_KeysInterface_get_shutdown_pubkey(this_arg: *const c_void) -> crate::c_types::PublicKey {
1314         let mut ret = <nativeKeysManager as lightning::chain::keysinterface::KeysInterface<>>::get_shutdown_pubkey(unsafe { &mut *(this_arg as *mut nativeKeysManager) }, );
1315         crate::c_types::PublicKey::from_rust(&ret)
1316 }
1317 #[must_use]
1318 extern "C" fn KeysManager_KeysInterface_get_channel_signer(this_arg: *const c_void, mut _inbound: bool, mut channel_value_satoshis: u64) -> crate::chain::keysinterface::Sign {
1319         let mut ret = <nativeKeysManager as lightning::chain::keysinterface::KeysInterface<>>::get_channel_signer(unsafe { &mut *(this_arg as *mut nativeKeysManager) }, _inbound, channel_value_satoshis);
1320         ret.into()
1321 }
1322 #[must_use]
1323 extern "C" fn KeysManager_KeysInterface_get_secure_random_bytes(this_arg: *const c_void) -> crate::c_types::ThirtyTwoBytes {
1324         let mut ret = <nativeKeysManager as lightning::chain::keysinterface::KeysInterface<>>::get_secure_random_bytes(unsafe { &mut *(this_arg as *mut nativeKeysManager) }, );
1325         crate::c_types::ThirtyTwoBytes { data: ret }
1326 }
1327 #[must_use]
1328 extern "C" fn KeysManager_KeysInterface_read_chan_signer(this_arg: *const c_void, mut reader: crate::c_types::u8slice) -> crate::c_types::derived::CResult_SignDecodeErrorZ {
1329         let mut ret = <nativeKeysManager as lightning::chain::keysinterface::KeysInterface<>>::read_chan_signer(unsafe { &mut *(this_arg as *mut nativeKeysManager) }, reader.to_slice());
1330         let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { o.into() }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
1331         local_ret
1332 }
1333