1 // This file is Copyright its original authors, visible in version control
2 // history and in the source files from which this was generated.
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.
9 //! Various utilities for building scripts and deriving keys related to channels. These are
10 //! largely of interest for those implementing chain::keysinterface::Sign message signing by hand.
13 use bitcoin::hashes::Hash;
14 use crate::c_types::*;
16 /// Build the commitment secret from the seed and the commitment number
18 pub extern "C" fn build_commitment_secret(commitment_seed: *const [u8; 32], mut idx: u64) -> crate::c_types::ThirtyTwoBytes {
19 let mut ret = lightning::ln::chan_utils::build_commitment_secret(unsafe { &*commitment_seed}, idx);
20 crate::c_types::ThirtyTwoBytes { data: ret }
23 /// Derives a per-commitment-transaction private key (eg an htlc key or delayed_payment key)
24 /// from the base secret and the per_commitment_point.
26 /// Note that this is infallible iff we trust that at least one of the two input keys are randomly
27 /// generated (ie our own).
29 pub extern "C" fn derive_private_key(mut per_commitment_point: crate::c_types::PublicKey, base_secret: *const [u8; 32]) -> crate::c_types::derived::CResult_SecretKeyErrorZ {
30 let mut ret = lightning::ln::chan_utils::derive_private_key(secp256k1::SECP256K1, &per_commitment_point.into_rust(), &::bitcoin::secp256k1::key::SecretKey::from_slice(&unsafe { *base_secret}[..]).unwrap());
31 let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::c_types::SecretKey::from_rust(o) }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::c_types::Secp256k1Error::from_rust(e) }).into() };
35 /// Derives a per-commitment-transaction public key (eg an htlc key or a delayed_payment key)
36 /// from the base point and the per_commitment_key. This is the public equivalent of
37 /// derive_private_key - using only public keys to derive a public key instead of private keys.
39 /// Note that this is infallible iff we trust that at least one of the two input keys are randomly
40 /// generated (ie our own).
42 pub extern "C" fn derive_public_key(mut per_commitment_point: crate::c_types::PublicKey, mut base_point: crate::c_types::PublicKey) -> crate::c_types::derived::CResult_PublicKeyErrorZ {
43 let mut ret = lightning::ln::chan_utils::derive_public_key(secp256k1::SECP256K1, &per_commitment_point.into_rust(), &base_point.into_rust());
44 let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::c_types::PublicKey::from_rust(&o) }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::c_types::Secp256k1Error::from_rust(e) }).into() };
48 /// Derives a per-commitment-transaction revocation key from its constituent parts.
50 /// Only the cheating participant owns a valid witness to propagate a revoked
51 /// commitment transaction, thus per_commitment_secret always come from cheater
52 /// and revocation_base_secret always come from punisher, which is the broadcaster
53 /// of the transaction spending with this key knowledge.
55 /// Note that this is infallible iff we trust that at least one of the two input keys are randomly
56 /// generated (ie our own).
58 pub extern "C" fn derive_private_revocation_key(per_commitment_secret: *const [u8; 32], countersignatory_revocation_base_secret: *const [u8; 32]) -> crate::c_types::derived::CResult_SecretKeyErrorZ {
59 let mut ret = lightning::ln::chan_utils::derive_private_revocation_key(secp256k1::SECP256K1, &::bitcoin::secp256k1::key::SecretKey::from_slice(&unsafe { *per_commitment_secret}[..]).unwrap(), &::bitcoin::secp256k1::key::SecretKey::from_slice(&unsafe { *countersignatory_revocation_base_secret}[..]).unwrap());
60 let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::c_types::SecretKey::from_rust(o) }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::c_types::Secp256k1Error::from_rust(e) }).into() };
64 /// Derives a per-commitment-transaction revocation public key from its constituent parts. This is
65 /// the public equivalend of derive_private_revocation_key - using only public keys to derive a
66 /// public key instead of private keys.
68 /// Only the cheating participant owns a valid witness to propagate a revoked
69 /// commitment transaction, thus per_commitment_point always come from cheater
70 /// and revocation_base_point always come from punisher, which is the broadcaster
71 /// of the transaction spending with this key knowledge.
73 /// Note that this is infallible iff we trust that at least one of the two input keys are randomly
74 /// generated (ie our own).
76 pub extern "C" fn derive_public_revocation_key(mut per_commitment_point: crate::c_types::PublicKey, mut countersignatory_revocation_base_point: crate::c_types::PublicKey) -> crate::c_types::derived::CResult_PublicKeyErrorZ {
77 let mut ret = lightning::ln::chan_utils::derive_public_revocation_key(secp256k1::SECP256K1, &per_commitment_point.into_rust(), &countersignatory_revocation_base_point.into_rust());
78 let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::c_types::PublicKey::from_rust(&o) }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::c_types::Secp256k1Error::from_rust(e) }).into() };
83 use lightning::ln::chan_utils::TxCreationKeys as nativeTxCreationKeysImport;
84 type nativeTxCreationKeys = nativeTxCreationKeysImport;
86 /// The set of public keys which are used in the creation of one commitment transaction.
87 /// These are derived from the channel base keys and per-commitment data.
89 /// A broadcaster key is provided from potential broadcaster of the computed transaction.
90 /// A countersignatory key is coming from a protocol participant unable to broadcast the
93 /// These keys are assumed to be good, either because the code derived them from
94 /// channel basepoints via the new function, or they were obtained via
95 /// CommitmentTransaction.trust().keys() because we trusted the source of the
96 /// pre-calculated keys.
99 pub struct TxCreationKeys {
100 /// A pointer to the opaque Rust object.
102 /// Nearly everywhere, inner must be non-null, however in places where
103 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
104 pub inner: *mut nativeTxCreationKeys,
105 /// Indicates that this is the only struct which contains the same pointer.
107 /// Rust functions which take ownership of an object provided via an argument require
108 /// this to be true and invalidate the object pointed to by inner.
112 impl Drop for TxCreationKeys {
114 if self.is_owned && !<*mut nativeTxCreationKeys>::is_null(self.inner) {
115 let _ = unsafe { Box::from_raw(self.inner) };
119 /// Frees any resources used by the TxCreationKeys, if is_owned is set and inner is non-NULL.
121 pub extern "C" fn TxCreationKeys_free(this_obj: TxCreationKeys) { }
123 /// Used only if an object of this type is returned as a trait impl by a method
124 extern "C" fn TxCreationKeys_free_void(this_ptr: *mut c_void) {
125 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeTxCreationKeys); }
128 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
129 impl TxCreationKeys {
130 pub(crate) fn take_inner(mut self) -> *mut nativeTxCreationKeys {
131 assert!(self.is_owned);
132 let ret = self.inner;
133 self.inner = std::ptr::null_mut();
137 /// The broadcaster's per-commitment public key which was used to derive the other keys.
139 pub extern "C" fn TxCreationKeys_get_per_commitment_point(this_ptr: &TxCreationKeys) -> crate::c_types::PublicKey {
140 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.per_commitment_point;
141 crate::c_types::PublicKey::from_rust(&(*inner_val))
143 /// The broadcaster's per-commitment public key which was used to derive the other keys.
145 pub extern "C" fn TxCreationKeys_set_per_commitment_point(this_ptr: &mut TxCreationKeys, mut val: crate::c_types::PublicKey) {
146 unsafe { &mut *this_ptr.inner }.per_commitment_point = val.into_rust();
148 /// The revocation key which is used to allow the broadcaster of the commitment
149 /// transaction to provide their counterparty the ability to punish them if they broadcast
152 pub extern "C" fn TxCreationKeys_get_revocation_key(this_ptr: &TxCreationKeys) -> crate::c_types::PublicKey {
153 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.revocation_key;
154 crate::c_types::PublicKey::from_rust(&(*inner_val))
156 /// The revocation key which is used to allow the broadcaster of the commitment
157 /// transaction to provide their counterparty the ability to punish them if they broadcast
160 pub extern "C" fn TxCreationKeys_set_revocation_key(this_ptr: &mut TxCreationKeys, mut val: crate::c_types::PublicKey) {
161 unsafe { &mut *this_ptr.inner }.revocation_key = val.into_rust();
163 /// Broadcaster's HTLC Key
165 pub extern "C" fn TxCreationKeys_get_broadcaster_htlc_key(this_ptr: &TxCreationKeys) -> crate::c_types::PublicKey {
166 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.broadcaster_htlc_key;
167 crate::c_types::PublicKey::from_rust(&(*inner_val))
169 /// Broadcaster's HTLC Key
171 pub extern "C" fn TxCreationKeys_set_broadcaster_htlc_key(this_ptr: &mut TxCreationKeys, mut val: crate::c_types::PublicKey) {
172 unsafe { &mut *this_ptr.inner }.broadcaster_htlc_key = val.into_rust();
174 /// Countersignatory's HTLC Key
176 pub extern "C" fn TxCreationKeys_get_countersignatory_htlc_key(this_ptr: &TxCreationKeys) -> crate::c_types::PublicKey {
177 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.countersignatory_htlc_key;
178 crate::c_types::PublicKey::from_rust(&(*inner_val))
180 /// Countersignatory's HTLC Key
182 pub extern "C" fn TxCreationKeys_set_countersignatory_htlc_key(this_ptr: &mut TxCreationKeys, mut val: crate::c_types::PublicKey) {
183 unsafe { &mut *this_ptr.inner }.countersignatory_htlc_key = val.into_rust();
185 /// Broadcaster's Payment Key (which isn't allowed to be spent from for some delay)
187 pub extern "C" fn TxCreationKeys_get_broadcaster_delayed_payment_key(this_ptr: &TxCreationKeys) -> crate::c_types::PublicKey {
188 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.broadcaster_delayed_payment_key;
189 crate::c_types::PublicKey::from_rust(&(*inner_val))
191 /// Broadcaster's Payment Key (which isn't allowed to be spent from for some delay)
193 pub extern "C" fn TxCreationKeys_set_broadcaster_delayed_payment_key(this_ptr: &mut TxCreationKeys, mut val: crate::c_types::PublicKey) {
194 unsafe { &mut *this_ptr.inner }.broadcaster_delayed_payment_key = val.into_rust();
196 /// Constructs a new TxCreationKeys given each field
199 pub extern "C" fn TxCreationKeys_new(mut per_commitment_point_arg: crate::c_types::PublicKey, mut revocation_key_arg: crate::c_types::PublicKey, mut broadcaster_htlc_key_arg: crate::c_types::PublicKey, mut countersignatory_htlc_key_arg: crate::c_types::PublicKey, mut broadcaster_delayed_payment_key_arg: crate::c_types::PublicKey) -> TxCreationKeys {
200 TxCreationKeys { inner: Box::into_raw(Box::new(nativeTxCreationKeys {
201 per_commitment_point: per_commitment_point_arg.into_rust(),
202 revocation_key: revocation_key_arg.into_rust(),
203 broadcaster_htlc_key: broadcaster_htlc_key_arg.into_rust(),
204 countersignatory_htlc_key: countersignatory_htlc_key_arg.into_rust(),
205 broadcaster_delayed_payment_key: broadcaster_delayed_payment_key_arg.into_rust(),
206 })), is_owned: true }
208 impl Clone for TxCreationKeys {
209 fn clone(&self) -> Self {
211 inner: if <*mut nativeTxCreationKeys>::is_null(self.inner) { std::ptr::null_mut() } else {
212 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
218 /// Used only if an object of this type is returned as a trait impl by a method
219 pub(crate) extern "C" fn TxCreationKeys_clone_void(this_ptr: *const c_void) -> *mut c_void {
220 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeTxCreationKeys)).clone() })) as *mut c_void
223 /// Creates a copy of the TxCreationKeys
224 pub extern "C" fn TxCreationKeys_clone(orig: &TxCreationKeys) -> TxCreationKeys {
228 /// Serialize the TxCreationKeys object into a byte array which can be read by TxCreationKeys_read
229 pub extern "C" fn TxCreationKeys_write(obj: &TxCreationKeys) -> crate::c_types::derived::CVec_u8Z {
230 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
233 pub(crate) extern "C" fn TxCreationKeys_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
234 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeTxCreationKeys) })
237 /// Read a TxCreationKeys from a byte array, created by TxCreationKeys_write
238 pub extern "C" fn TxCreationKeys_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_TxCreationKeysDecodeErrorZ {
239 let res = crate::c_types::deserialize_obj(ser);
240 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::ln::chan_utils::TxCreationKeys { 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() };
244 use lightning::ln::chan_utils::ChannelPublicKeys as nativeChannelPublicKeysImport;
245 type nativeChannelPublicKeys = nativeChannelPublicKeysImport;
247 /// One counterparty's public keys which do not change over the life of a channel.
250 pub struct ChannelPublicKeys {
251 /// A pointer to the opaque Rust object.
253 /// Nearly everywhere, inner must be non-null, however in places where
254 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
255 pub inner: *mut nativeChannelPublicKeys,
256 /// Indicates that this is the only struct which contains the same pointer.
258 /// Rust functions which take ownership of an object provided via an argument require
259 /// this to be true and invalidate the object pointed to by inner.
263 impl Drop for ChannelPublicKeys {
265 if self.is_owned && !<*mut nativeChannelPublicKeys>::is_null(self.inner) {
266 let _ = unsafe { Box::from_raw(self.inner) };
270 /// Frees any resources used by the ChannelPublicKeys, if is_owned is set and inner is non-NULL.
272 pub extern "C" fn ChannelPublicKeys_free(this_obj: ChannelPublicKeys) { }
274 /// Used only if an object of this type is returned as a trait impl by a method
275 extern "C" fn ChannelPublicKeys_free_void(this_ptr: *mut c_void) {
276 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeChannelPublicKeys); }
279 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
280 impl ChannelPublicKeys {
281 pub(crate) fn take_inner(mut self) -> *mut nativeChannelPublicKeys {
282 assert!(self.is_owned);
283 let ret = self.inner;
284 self.inner = std::ptr::null_mut();
288 /// The public key which is used to sign all commitment transactions, as it appears in the
289 /// on-chain channel lock-in 2-of-2 multisig output.
291 pub extern "C" fn ChannelPublicKeys_get_funding_pubkey(this_ptr: &ChannelPublicKeys) -> crate::c_types::PublicKey {
292 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.funding_pubkey;
293 crate::c_types::PublicKey::from_rust(&(*inner_val))
295 /// The public key which is used to sign all commitment transactions, as it appears in the
296 /// on-chain channel lock-in 2-of-2 multisig output.
298 pub extern "C" fn ChannelPublicKeys_set_funding_pubkey(this_ptr: &mut ChannelPublicKeys, mut val: crate::c_types::PublicKey) {
299 unsafe { &mut *this_ptr.inner }.funding_pubkey = val.into_rust();
301 /// The base point which is used (with derive_public_revocation_key) to derive per-commitment
302 /// revocation keys. This is combined with the per-commitment-secret generated by the
303 /// counterparty to create a secret which the counterparty can reveal to revoke previous
306 pub extern "C" fn ChannelPublicKeys_get_revocation_basepoint(this_ptr: &ChannelPublicKeys) -> crate::c_types::PublicKey {
307 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.revocation_basepoint;
308 crate::c_types::PublicKey::from_rust(&(*inner_val))
310 /// The base point which is used (with derive_public_revocation_key) to derive per-commitment
311 /// revocation keys. This is combined with the per-commitment-secret generated by the
312 /// counterparty to create a secret which the counterparty can reveal to revoke previous
315 pub extern "C" fn ChannelPublicKeys_set_revocation_basepoint(this_ptr: &mut ChannelPublicKeys, mut val: crate::c_types::PublicKey) {
316 unsafe { &mut *this_ptr.inner }.revocation_basepoint = val.into_rust();
318 /// The public key on which the non-broadcaster (ie the countersignatory) receives an immediately
319 /// spendable primary channel balance on the broadcaster's commitment transaction. This key is
320 /// static across every commitment transaction.
322 pub extern "C" fn ChannelPublicKeys_get_payment_point(this_ptr: &ChannelPublicKeys) -> crate::c_types::PublicKey {
323 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.payment_point;
324 crate::c_types::PublicKey::from_rust(&(*inner_val))
326 /// The public key on which the non-broadcaster (ie the countersignatory) receives an immediately
327 /// spendable primary channel balance on the broadcaster's commitment transaction. This key is
328 /// static across every commitment transaction.
330 pub extern "C" fn ChannelPublicKeys_set_payment_point(this_ptr: &mut ChannelPublicKeys, mut val: crate::c_types::PublicKey) {
331 unsafe { &mut *this_ptr.inner }.payment_point = val.into_rust();
333 /// The base point which is used (with derive_public_key) to derive a per-commitment payment
334 /// public key which receives non-HTLC-encumbered funds which are only available for spending
335 /// after some delay (or can be claimed via the revocation path).
337 pub extern "C" fn ChannelPublicKeys_get_delayed_payment_basepoint(this_ptr: &ChannelPublicKeys) -> crate::c_types::PublicKey {
338 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.delayed_payment_basepoint;
339 crate::c_types::PublicKey::from_rust(&(*inner_val))
341 /// The base point which is used (with derive_public_key) to derive a per-commitment payment
342 /// public key which receives non-HTLC-encumbered funds which are only available for spending
343 /// after some delay (or can be claimed via the revocation path).
345 pub extern "C" fn ChannelPublicKeys_set_delayed_payment_basepoint(this_ptr: &mut ChannelPublicKeys, mut val: crate::c_types::PublicKey) {
346 unsafe { &mut *this_ptr.inner }.delayed_payment_basepoint = val.into_rust();
348 /// The base point which is used (with derive_public_key) to derive a per-commitment public key
349 /// which is used to encumber HTLC-in-flight outputs.
351 pub extern "C" fn ChannelPublicKeys_get_htlc_basepoint(this_ptr: &ChannelPublicKeys) -> crate::c_types::PublicKey {
352 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.htlc_basepoint;
353 crate::c_types::PublicKey::from_rust(&(*inner_val))
355 /// The base point which is used (with derive_public_key) to derive a per-commitment public key
356 /// which is used to encumber HTLC-in-flight outputs.
358 pub extern "C" fn ChannelPublicKeys_set_htlc_basepoint(this_ptr: &mut ChannelPublicKeys, mut val: crate::c_types::PublicKey) {
359 unsafe { &mut *this_ptr.inner }.htlc_basepoint = val.into_rust();
361 /// Constructs a new ChannelPublicKeys given each field
364 pub extern "C" fn ChannelPublicKeys_new(mut funding_pubkey_arg: crate::c_types::PublicKey, mut revocation_basepoint_arg: crate::c_types::PublicKey, mut payment_point_arg: crate::c_types::PublicKey, mut delayed_payment_basepoint_arg: crate::c_types::PublicKey, mut htlc_basepoint_arg: crate::c_types::PublicKey) -> ChannelPublicKeys {
365 ChannelPublicKeys { inner: Box::into_raw(Box::new(nativeChannelPublicKeys {
366 funding_pubkey: funding_pubkey_arg.into_rust(),
367 revocation_basepoint: revocation_basepoint_arg.into_rust(),
368 payment_point: payment_point_arg.into_rust(),
369 delayed_payment_basepoint: delayed_payment_basepoint_arg.into_rust(),
370 htlc_basepoint: htlc_basepoint_arg.into_rust(),
371 })), is_owned: true }
373 impl Clone for ChannelPublicKeys {
374 fn clone(&self) -> Self {
376 inner: if <*mut nativeChannelPublicKeys>::is_null(self.inner) { std::ptr::null_mut() } else {
377 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
383 /// Used only if an object of this type is returned as a trait impl by a method
384 pub(crate) extern "C" fn ChannelPublicKeys_clone_void(this_ptr: *const c_void) -> *mut c_void {
385 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeChannelPublicKeys)).clone() })) as *mut c_void
388 /// Creates a copy of the ChannelPublicKeys
389 pub extern "C" fn ChannelPublicKeys_clone(orig: &ChannelPublicKeys) -> ChannelPublicKeys {
393 /// Serialize the ChannelPublicKeys object into a byte array which can be read by ChannelPublicKeys_read
394 pub extern "C" fn ChannelPublicKeys_write(obj: &ChannelPublicKeys) -> crate::c_types::derived::CVec_u8Z {
395 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
398 pub(crate) extern "C" fn ChannelPublicKeys_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
399 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeChannelPublicKeys) })
402 /// Read a ChannelPublicKeys from a byte array, created by ChannelPublicKeys_write
403 pub extern "C" fn ChannelPublicKeys_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_ChannelPublicKeysDecodeErrorZ {
404 let res = crate::c_types::deserialize_obj(ser);
405 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::ln::chan_utils::ChannelPublicKeys { 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() };
408 /// Create per-state keys from channel base points and the per-commitment point.
409 /// Key set is asymmetric and can't be used as part of counter-signatory set of transactions.
412 pub extern "C" fn TxCreationKeys_derive_new(mut per_commitment_point: crate::c_types::PublicKey, mut broadcaster_delayed_payment_base: crate::c_types::PublicKey, mut broadcaster_htlc_base: crate::c_types::PublicKey, mut countersignatory_revocation_base: crate::c_types::PublicKey, mut countersignatory_htlc_base: crate::c_types::PublicKey) -> crate::c_types::derived::CResult_TxCreationKeysErrorZ {
413 let mut ret = lightning::ln::chan_utils::TxCreationKeys::derive_new(secp256k1::SECP256K1, &per_commitment_point.into_rust(), &broadcaster_delayed_payment_base.into_rust(), &broadcaster_htlc_base.into_rust(), &countersignatory_revocation_base.into_rust(), &countersignatory_htlc_base.into_rust());
414 let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::ln::chan_utils::TxCreationKeys { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::c_types::Secp256k1Error::from_rust(e) }).into() };
418 /// Generate per-state keys from channel static keys.
419 /// Key set is asymmetric and can't be used as part of counter-signatory set of transactions.
422 pub extern "C" fn TxCreationKeys_from_channel_static_keys(mut per_commitment_point: crate::c_types::PublicKey, broadcaster_keys: &crate::ln::chan_utils::ChannelPublicKeys, countersignatory_keys: &crate::ln::chan_utils::ChannelPublicKeys) -> crate::c_types::derived::CResult_TxCreationKeysErrorZ {
423 let mut ret = lightning::ln::chan_utils::TxCreationKeys::from_channel_static_keys(&per_commitment_point.into_rust(), unsafe { &*broadcaster_keys.inner }, unsafe { &*countersignatory_keys.inner }, secp256k1::SECP256K1);
424 let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::ln::chan_utils::TxCreationKeys { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::c_types::Secp256k1Error::from_rust(e) }).into() };
428 /// The maximum length of a script returned by get_revokeable_redeemscript.
431 pub static REVOKEABLE_REDEEMSCRIPT_MAX_LENGTH: usize = lightning::ln::chan_utils::REVOKEABLE_REDEEMSCRIPT_MAX_LENGTH;
432 /// A script either spendable by the revocation
433 /// key or the broadcaster_delayed_payment_key and satisfying the relative-locktime OP_CSV constrain.
434 /// Encumbering a `to_holder` output on a commitment transaction or 2nd-stage HTLC transactions.
436 pub extern "C" fn get_revokeable_redeemscript(mut revocation_key: crate::c_types::PublicKey, mut contest_delay: u16, mut broadcaster_delayed_payment_key: crate::c_types::PublicKey) -> crate::c_types::derived::CVec_u8Z {
437 let mut ret = lightning::ln::chan_utils::get_revokeable_redeemscript(&revocation_key.into_rust(), contest_delay, &broadcaster_delayed_payment_key.into_rust());
438 ret.into_bytes().into()
442 use lightning::ln::chan_utils::HTLCOutputInCommitment as nativeHTLCOutputInCommitmentImport;
443 type nativeHTLCOutputInCommitment = nativeHTLCOutputInCommitmentImport;
445 /// Information about an HTLC as it appears in a commitment transaction
448 pub struct HTLCOutputInCommitment {
449 /// A pointer to the opaque Rust object.
451 /// Nearly everywhere, inner must be non-null, however in places where
452 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
453 pub inner: *mut nativeHTLCOutputInCommitment,
454 /// Indicates that this is the only struct which contains the same pointer.
456 /// Rust functions which take ownership of an object provided via an argument require
457 /// this to be true and invalidate the object pointed to by inner.
461 impl Drop for HTLCOutputInCommitment {
463 if self.is_owned && !<*mut nativeHTLCOutputInCommitment>::is_null(self.inner) {
464 let _ = unsafe { Box::from_raw(self.inner) };
468 /// Frees any resources used by the HTLCOutputInCommitment, if is_owned is set and inner is non-NULL.
470 pub extern "C" fn HTLCOutputInCommitment_free(this_obj: HTLCOutputInCommitment) { }
472 /// Used only if an object of this type is returned as a trait impl by a method
473 extern "C" fn HTLCOutputInCommitment_free_void(this_ptr: *mut c_void) {
474 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeHTLCOutputInCommitment); }
477 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
478 impl HTLCOutputInCommitment {
479 pub(crate) fn take_inner(mut self) -> *mut nativeHTLCOutputInCommitment {
480 assert!(self.is_owned);
481 let ret = self.inner;
482 self.inner = std::ptr::null_mut();
486 /// Whether the HTLC was \"offered\" (ie outbound in relation to this commitment transaction).
487 /// Note that this is not the same as whether it is ountbound *from us*. To determine that you
488 /// need to compare this value to whether the commitment transaction in question is that of
489 /// the counterparty or our own.
491 pub extern "C" fn HTLCOutputInCommitment_get_offered(this_ptr: &HTLCOutputInCommitment) -> bool {
492 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.offered;
495 /// Whether the HTLC was \"offered\" (ie outbound in relation to this commitment transaction).
496 /// Note that this is not the same as whether it is ountbound *from us*. To determine that you
497 /// need to compare this value to whether the commitment transaction in question is that of
498 /// the counterparty or our own.
500 pub extern "C" fn HTLCOutputInCommitment_set_offered(this_ptr: &mut HTLCOutputInCommitment, mut val: bool) {
501 unsafe { &mut *this_ptr.inner }.offered = val;
503 /// The value, in msat, of the HTLC. The value as it appears in the commitment transaction is
504 /// this divided by 1000.
506 pub extern "C" fn HTLCOutputInCommitment_get_amount_msat(this_ptr: &HTLCOutputInCommitment) -> u64 {
507 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.amount_msat;
510 /// The value, in msat, of the HTLC. The value as it appears in the commitment transaction is
511 /// this divided by 1000.
513 pub extern "C" fn HTLCOutputInCommitment_set_amount_msat(this_ptr: &mut HTLCOutputInCommitment, mut val: u64) {
514 unsafe { &mut *this_ptr.inner }.amount_msat = val;
516 /// The CLTV lock-time at which this HTLC expires.
518 pub extern "C" fn HTLCOutputInCommitment_get_cltv_expiry(this_ptr: &HTLCOutputInCommitment) -> u32 {
519 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.cltv_expiry;
522 /// The CLTV lock-time at which this HTLC expires.
524 pub extern "C" fn HTLCOutputInCommitment_set_cltv_expiry(this_ptr: &mut HTLCOutputInCommitment, mut val: u32) {
525 unsafe { &mut *this_ptr.inner }.cltv_expiry = val;
527 /// The hash of the preimage which unlocks this HTLC.
529 pub extern "C" fn HTLCOutputInCommitment_get_payment_hash(this_ptr: &HTLCOutputInCommitment) -> *const [u8; 32] {
530 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.payment_hash;
533 /// The hash of the preimage which unlocks this HTLC.
535 pub extern "C" fn HTLCOutputInCommitment_set_payment_hash(this_ptr: &mut HTLCOutputInCommitment, mut val: crate::c_types::ThirtyTwoBytes) {
536 unsafe { &mut *this_ptr.inner }.payment_hash = ::lightning::ln::channelmanager::PaymentHash(val.data);
538 impl Clone for HTLCOutputInCommitment {
539 fn clone(&self) -> Self {
541 inner: if <*mut nativeHTLCOutputInCommitment>::is_null(self.inner) { std::ptr::null_mut() } else {
542 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
548 /// Used only if an object of this type is returned as a trait impl by a method
549 pub(crate) extern "C" fn HTLCOutputInCommitment_clone_void(this_ptr: *const c_void) -> *mut c_void {
550 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeHTLCOutputInCommitment)).clone() })) as *mut c_void
553 /// Creates a copy of the HTLCOutputInCommitment
554 pub extern "C" fn HTLCOutputInCommitment_clone(orig: &HTLCOutputInCommitment) -> HTLCOutputInCommitment {
558 /// Serialize the HTLCOutputInCommitment object into a byte array which can be read by HTLCOutputInCommitment_read
559 pub extern "C" fn HTLCOutputInCommitment_write(obj: &HTLCOutputInCommitment) -> crate::c_types::derived::CVec_u8Z {
560 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
563 pub(crate) extern "C" fn HTLCOutputInCommitment_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
564 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeHTLCOutputInCommitment) })
567 /// Read a HTLCOutputInCommitment from a byte array, created by HTLCOutputInCommitment_write
568 pub extern "C" fn HTLCOutputInCommitment_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_HTLCOutputInCommitmentDecodeErrorZ {
569 let res = crate::c_types::deserialize_obj(ser);
570 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::ln::chan_utils::HTLCOutputInCommitment { 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() };
573 /// Gets the witness redeemscript for an HTLC output in a commitment transaction. Note that htlc
574 /// does not need to have its previous_output_index filled.
576 pub extern "C" fn get_htlc_redeemscript(htlc: &crate::ln::chan_utils::HTLCOutputInCommitment, keys: &crate::ln::chan_utils::TxCreationKeys) -> crate::c_types::derived::CVec_u8Z {
577 let mut ret = lightning::ln::chan_utils::get_htlc_redeemscript(unsafe { &*htlc.inner }, unsafe { &*keys.inner });
578 ret.into_bytes().into()
581 /// Gets the redeemscript for a funding output from the two funding public keys.
582 /// Note that the order of funding public keys does not matter.
584 pub extern "C" fn make_funding_redeemscript(mut broadcaster: crate::c_types::PublicKey, mut countersignatory: crate::c_types::PublicKey) -> crate::c_types::derived::CVec_u8Z {
585 let mut ret = lightning::ln::chan_utils::make_funding_redeemscript(&broadcaster.into_rust(), &countersignatory.into_rust());
586 ret.into_bytes().into()
589 /// panics if htlc.transaction_output_index.is_none()!
591 pub extern "C" fn build_htlc_transaction(prev_hash: *const [u8; 32], mut feerate_per_kw: u32, mut contest_delay: u16, htlc: &crate::ln::chan_utils::HTLCOutputInCommitment, mut broadcaster_delayed_payment_key: crate::c_types::PublicKey, mut revocation_key: crate::c_types::PublicKey) -> crate::c_types::Transaction {
592 let mut ret = lightning::ln::chan_utils::build_htlc_transaction(&::bitcoin::hash_types::Txid::from_slice(&unsafe { &*prev_hash }[..]).unwrap(), feerate_per_kw, contest_delay, unsafe { &*htlc.inner }, &broadcaster_delayed_payment_key.into_rust(), &revocation_key.into_rust());
593 let mut local_ret = ::bitcoin::consensus::encode::serialize(&ret);
594 crate::c_types::Transaction::from_vec(local_ret)
598 use lightning::ln::chan_utils::ChannelTransactionParameters as nativeChannelTransactionParametersImport;
599 type nativeChannelTransactionParameters = nativeChannelTransactionParametersImport;
601 /// Per-channel data used to build transactions in conjunction with the per-commitment data (CommitmentTransaction).
602 /// The fields are organized by holder/counterparty.
604 /// Normally, this is converted to the broadcaster/countersignatory-organized DirectedChannelTransactionParameters
605 /// before use, via the as_holder_broadcastable and as_counterparty_broadcastable functions.
608 pub struct ChannelTransactionParameters {
609 /// A pointer to the opaque Rust object.
611 /// Nearly everywhere, inner must be non-null, however in places where
612 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
613 pub inner: *mut nativeChannelTransactionParameters,
614 /// Indicates that this is the only struct which contains the same pointer.
616 /// Rust functions which take ownership of an object provided via an argument require
617 /// this to be true and invalidate the object pointed to by inner.
621 impl Drop for ChannelTransactionParameters {
623 if self.is_owned && !<*mut nativeChannelTransactionParameters>::is_null(self.inner) {
624 let _ = unsafe { Box::from_raw(self.inner) };
628 /// Frees any resources used by the ChannelTransactionParameters, if is_owned is set and inner is non-NULL.
630 pub extern "C" fn ChannelTransactionParameters_free(this_obj: ChannelTransactionParameters) { }
632 /// Used only if an object of this type is returned as a trait impl by a method
633 extern "C" fn ChannelTransactionParameters_free_void(this_ptr: *mut c_void) {
634 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeChannelTransactionParameters); }
637 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
638 impl ChannelTransactionParameters {
639 pub(crate) fn take_inner(mut self) -> *mut nativeChannelTransactionParameters {
640 assert!(self.is_owned);
641 let ret = self.inner;
642 self.inner = std::ptr::null_mut();
646 /// Holder public keys
648 pub extern "C" fn ChannelTransactionParameters_get_holder_pubkeys(this_ptr: &ChannelTransactionParameters) -> crate::ln::chan_utils::ChannelPublicKeys {
649 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.holder_pubkeys;
650 crate::ln::chan_utils::ChannelPublicKeys { inner: unsafe { ( (&((*inner_val)) as *const _) as *mut _) }, is_owned: false }
652 /// Holder public keys
654 pub extern "C" fn ChannelTransactionParameters_set_holder_pubkeys(this_ptr: &mut ChannelTransactionParameters, mut val: crate::ln::chan_utils::ChannelPublicKeys) {
655 unsafe { &mut *this_ptr.inner }.holder_pubkeys = *unsafe { Box::from_raw(val.take_inner()) };
657 /// The contest delay selected by the holder, which applies to counterparty-broadcast transactions
659 pub extern "C" fn ChannelTransactionParameters_get_holder_selected_contest_delay(this_ptr: &ChannelTransactionParameters) -> u16 {
660 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.holder_selected_contest_delay;
663 /// The contest delay selected by the holder, which applies to counterparty-broadcast transactions
665 pub extern "C" fn ChannelTransactionParameters_set_holder_selected_contest_delay(this_ptr: &mut ChannelTransactionParameters, mut val: u16) {
666 unsafe { &mut *this_ptr.inner }.holder_selected_contest_delay = val;
668 /// Whether the holder is the initiator of this channel.
669 /// This is an input to the commitment number obscure factor computation.
671 pub extern "C" fn ChannelTransactionParameters_get_is_outbound_from_holder(this_ptr: &ChannelTransactionParameters) -> bool {
672 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.is_outbound_from_holder;
675 /// Whether the holder is the initiator of this channel.
676 /// This is an input to the commitment number obscure factor computation.
678 pub extern "C" fn ChannelTransactionParameters_set_is_outbound_from_holder(this_ptr: &mut ChannelTransactionParameters, mut val: bool) {
679 unsafe { &mut *this_ptr.inner }.is_outbound_from_holder = val;
681 /// The late-bound counterparty channel transaction parameters.
682 /// These parameters are populated at the point in the protocol where the counterparty provides them.
684 pub extern "C" fn ChannelTransactionParameters_get_counterparty_parameters(this_ptr: &ChannelTransactionParameters) -> crate::ln::chan_utils::CounterpartyChannelTransactionParameters {
685 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.counterparty_parameters;
686 let mut local_inner_val = crate::ln::chan_utils::CounterpartyChannelTransactionParameters { inner: unsafe { (if inner_val.is_none() { std::ptr::null() } else { { (inner_val.as_ref().unwrap()) } } as *const _) as *mut _ }, is_owned: false };
689 /// The late-bound counterparty channel transaction parameters.
690 /// These parameters are populated at the point in the protocol where the counterparty provides them.
692 pub extern "C" fn ChannelTransactionParameters_set_counterparty_parameters(this_ptr: &mut ChannelTransactionParameters, mut val: crate::ln::chan_utils::CounterpartyChannelTransactionParameters) {
693 let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
694 unsafe { &mut *this_ptr.inner }.counterparty_parameters = local_val;
696 /// The late-bound funding outpoint
698 pub extern "C" fn ChannelTransactionParameters_get_funding_outpoint(this_ptr: &ChannelTransactionParameters) -> crate::chain::transaction::OutPoint {
699 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.funding_outpoint;
700 let mut local_inner_val = crate::chain::transaction::OutPoint { inner: unsafe { (if inner_val.is_none() { std::ptr::null() } else { { (inner_val.as_ref().unwrap()) } } as *const _) as *mut _ }, is_owned: false };
703 /// The late-bound funding outpoint
705 pub extern "C" fn ChannelTransactionParameters_set_funding_outpoint(this_ptr: &mut ChannelTransactionParameters, mut val: crate::chain::transaction::OutPoint) {
706 let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
707 unsafe { &mut *this_ptr.inner }.funding_outpoint = local_val;
709 /// Constructs a new ChannelTransactionParameters given each field
712 pub extern "C" fn ChannelTransactionParameters_new(mut holder_pubkeys_arg: crate::ln::chan_utils::ChannelPublicKeys, mut holder_selected_contest_delay_arg: u16, mut is_outbound_from_holder_arg: bool, mut counterparty_parameters_arg: crate::ln::chan_utils::CounterpartyChannelTransactionParameters, mut funding_outpoint_arg: crate::chain::transaction::OutPoint) -> ChannelTransactionParameters {
713 let mut local_counterparty_parameters_arg = if counterparty_parameters_arg.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(counterparty_parameters_arg.take_inner()) } }) };
714 let mut local_funding_outpoint_arg = if funding_outpoint_arg.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(funding_outpoint_arg.take_inner()) } }) };
715 ChannelTransactionParameters { inner: Box::into_raw(Box::new(nativeChannelTransactionParameters {
716 holder_pubkeys: *unsafe { Box::from_raw(holder_pubkeys_arg.take_inner()) },
717 holder_selected_contest_delay: holder_selected_contest_delay_arg,
718 is_outbound_from_holder: is_outbound_from_holder_arg,
719 counterparty_parameters: local_counterparty_parameters_arg,
720 funding_outpoint: local_funding_outpoint_arg,
721 })), is_owned: true }
723 impl Clone for ChannelTransactionParameters {
724 fn clone(&self) -> Self {
726 inner: if <*mut nativeChannelTransactionParameters>::is_null(self.inner) { std::ptr::null_mut() } else {
727 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
733 /// Used only if an object of this type is returned as a trait impl by a method
734 pub(crate) extern "C" fn ChannelTransactionParameters_clone_void(this_ptr: *const c_void) -> *mut c_void {
735 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeChannelTransactionParameters)).clone() })) as *mut c_void
738 /// Creates a copy of the ChannelTransactionParameters
739 pub extern "C" fn ChannelTransactionParameters_clone(orig: &ChannelTransactionParameters) -> ChannelTransactionParameters {
743 use lightning::ln::chan_utils::CounterpartyChannelTransactionParameters as nativeCounterpartyChannelTransactionParametersImport;
744 type nativeCounterpartyChannelTransactionParameters = nativeCounterpartyChannelTransactionParametersImport;
746 /// Late-bound per-channel counterparty data used to build transactions.
749 pub struct CounterpartyChannelTransactionParameters {
750 /// A pointer to the opaque Rust object.
752 /// Nearly everywhere, inner must be non-null, however in places where
753 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
754 pub inner: *mut nativeCounterpartyChannelTransactionParameters,
755 /// Indicates that this is the only struct which contains the same pointer.
757 /// Rust functions which take ownership of an object provided via an argument require
758 /// this to be true and invalidate the object pointed to by inner.
762 impl Drop for CounterpartyChannelTransactionParameters {
764 if self.is_owned && !<*mut nativeCounterpartyChannelTransactionParameters>::is_null(self.inner) {
765 let _ = unsafe { Box::from_raw(self.inner) };
769 /// Frees any resources used by the CounterpartyChannelTransactionParameters, if is_owned is set and inner is non-NULL.
771 pub extern "C" fn CounterpartyChannelTransactionParameters_free(this_obj: CounterpartyChannelTransactionParameters) { }
773 /// Used only if an object of this type is returned as a trait impl by a method
774 extern "C" fn CounterpartyChannelTransactionParameters_free_void(this_ptr: *mut c_void) {
775 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeCounterpartyChannelTransactionParameters); }
778 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
779 impl CounterpartyChannelTransactionParameters {
780 pub(crate) fn take_inner(mut self) -> *mut nativeCounterpartyChannelTransactionParameters {
781 assert!(self.is_owned);
782 let ret = self.inner;
783 self.inner = std::ptr::null_mut();
787 /// Counter-party public keys
789 pub extern "C" fn CounterpartyChannelTransactionParameters_get_pubkeys(this_ptr: &CounterpartyChannelTransactionParameters) -> crate::ln::chan_utils::ChannelPublicKeys {
790 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.pubkeys;
791 crate::ln::chan_utils::ChannelPublicKeys { inner: unsafe { ( (&((*inner_val)) as *const _) as *mut _) }, is_owned: false }
793 /// Counter-party public keys
795 pub extern "C" fn CounterpartyChannelTransactionParameters_set_pubkeys(this_ptr: &mut CounterpartyChannelTransactionParameters, mut val: crate::ln::chan_utils::ChannelPublicKeys) {
796 unsafe { &mut *this_ptr.inner }.pubkeys = *unsafe { Box::from_raw(val.take_inner()) };
798 /// The contest delay selected by the counterparty, which applies to holder-broadcast transactions
800 pub extern "C" fn CounterpartyChannelTransactionParameters_get_selected_contest_delay(this_ptr: &CounterpartyChannelTransactionParameters) -> u16 {
801 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.selected_contest_delay;
804 /// The contest delay selected by the counterparty, which applies to holder-broadcast transactions
806 pub extern "C" fn CounterpartyChannelTransactionParameters_set_selected_contest_delay(this_ptr: &mut CounterpartyChannelTransactionParameters, mut val: u16) {
807 unsafe { &mut *this_ptr.inner }.selected_contest_delay = val;
809 /// Constructs a new CounterpartyChannelTransactionParameters given each field
812 pub extern "C" fn CounterpartyChannelTransactionParameters_new(mut pubkeys_arg: crate::ln::chan_utils::ChannelPublicKeys, mut selected_contest_delay_arg: u16) -> CounterpartyChannelTransactionParameters {
813 CounterpartyChannelTransactionParameters { inner: Box::into_raw(Box::new(nativeCounterpartyChannelTransactionParameters {
814 pubkeys: *unsafe { Box::from_raw(pubkeys_arg.take_inner()) },
815 selected_contest_delay: selected_contest_delay_arg,
816 })), is_owned: true }
818 impl Clone for CounterpartyChannelTransactionParameters {
819 fn clone(&self) -> Self {
821 inner: if <*mut nativeCounterpartyChannelTransactionParameters>::is_null(self.inner) { std::ptr::null_mut() } else {
822 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
828 /// Used only if an object of this type is returned as a trait impl by a method
829 pub(crate) extern "C" fn CounterpartyChannelTransactionParameters_clone_void(this_ptr: *const c_void) -> *mut c_void {
830 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeCounterpartyChannelTransactionParameters)).clone() })) as *mut c_void
833 /// Creates a copy of the CounterpartyChannelTransactionParameters
834 pub extern "C" fn CounterpartyChannelTransactionParameters_clone(orig: &CounterpartyChannelTransactionParameters) -> CounterpartyChannelTransactionParameters {
837 /// Whether the late bound parameters are populated.
840 pub extern "C" fn ChannelTransactionParameters_is_populated(this_arg: &ChannelTransactionParameters) -> bool {
841 let mut ret = unsafe { &*this_arg.inner }.is_populated();
845 /// Convert the holder/counterparty parameters to broadcaster/countersignatory-organized parameters,
846 /// given that the holder is the broadcaster.
848 /// self.is_populated() must be true before calling this function.
851 pub extern "C" fn ChannelTransactionParameters_as_holder_broadcastable(this_arg: &ChannelTransactionParameters) -> crate::ln::chan_utils::DirectedChannelTransactionParameters {
852 let mut ret = unsafe { &*this_arg.inner }.as_holder_broadcastable();
853 crate::ln::chan_utils::DirectedChannelTransactionParameters { inner: Box::into_raw(Box::new(ret)), is_owned: true }
856 /// Convert the holder/counterparty parameters to broadcaster/countersignatory-organized parameters,
857 /// given that the counterparty is the broadcaster.
859 /// self.is_populated() must be true before calling this function.
862 pub extern "C" fn ChannelTransactionParameters_as_counterparty_broadcastable(this_arg: &ChannelTransactionParameters) -> crate::ln::chan_utils::DirectedChannelTransactionParameters {
863 let mut ret = unsafe { &*this_arg.inner }.as_counterparty_broadcastable();
864 crate::ln::chan_utils::DirectedChannelTransactionParameters { inner: Box::into_raw(Box::new(ret)), is_owned: true }
868 /// Serialize the CounterpartyChannelTransactionParameters object into a byte array which can be read by CounterpartyChannelTransactionParameters_read
869 pub extern "C" fn CounterpartyChannelTransactionParameters_write(obj: &CounterpartyChannelTransactionParameters) -> crate::c_types::derived::CVec_u8Z {
870 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
873 pub(crate) extern "C" fn CounterpartyChannelTransactionParameters_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
874 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeCounterpartyChannelTransactionParameters) })
877 /// Read a CounterpartyChannelTransactionParameters from a byte array, created by CounterpartyChannelTransactionParameters_write
878 pub extern "C" fn CounterpartyChannelTransactionParameters_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_CounterpartyChannelTransactionParametersDecodeErrorZ {
879 let res = crate::c_types::deserialize_obj(ser);
880 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::ln::chan_utils::CounterpartyChannelTransactionParameters { 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() };
884 /// Serialize the ChannelTransactionParameters object into a byte array which can be read by ChannelTransactionParameters_read
885 pub extern "C" fn ChannelTransactionParameters_write(obj: &ChannelTransactionParameters) -> crate::c_types::derived::CVec_u8Z {
886 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
889 pub(crate) extern "C" fn ChannelTransactionParameters_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
890 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeChannelTransactionParameters) })
893 /// Read a ChannelTransactionParameters from a byte array, created by ChannelTransactionParameters_write
894 pub extern "C" fn ChannelTransactionParameters_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_ChannelTransactionParametersDecodeErrorZ {
895 let res = crate::c_types::deserialize_obj(ser);
896 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::ln::chan_utils::ChannelTransactionParameters { 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() };
900 use lightning::ln::chan_utils::DirectedChannelTransactionParameters as nativeDirectedChannelTransactionParametersImport;
901 type nativeDirectedChannelTransactionParameters = nativeDirectedChannelTransactionParametersImport<'static>;
903 /// Static channel fields used to build transactions given per-commitment fields, organized by
904 /// broadcaster/countersignatory.
906 /// This is derived from the holder/counterparty-organized ChannelTransactionParameters via the
907 /// as_holder_broadcastable and as_counterparty_broadcastable functions.
910 pub struct DirectedChannelTransactionParameters {
911 /// A pointer to the opaque Rust object.
913 /// Nearly everywhere, inner must be non-null, however in places where
914 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
915 pub inner: *mut nativeDirectedChannelTransactionParameters,
916 /// Indicates that this is the only struct which contains the same pointer.
918 /// Rust functions which take ownership of an object provided via an argument require
919 /// this to be true and invalidate the object pointed to by inner.
923 impl Drop for DirectedChannelTransactionParameters {
925 if self.is_owned && !<*mut nativeDirectedChannelTransactionParameters>::is_null(self.inner) {
926 let _ = unsafe { Box::from_raw(self.inner) };
930 /// Frees any resources used by the DirectedChannelTransactionParameters, if is_owned is set and inner is non-NULL.
932 pub extern "C" fn DirectedChannelTransactionParameters_free(this_obj: DirectedChannelTransactionParameters) { }
934 /// Used only if an object of this type is returned as a trait impl by a method
935 extern "C" fn DirectedChannelTransactionParameters_free_void(this_ptr: *mut c_void) {
936 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeDirectedChannelTransactionParameters); }
939 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
940 impl DirectedChannelTransactionParameters {
941 pub(crate) fn take_inner(mut self) -> *mut nativeDirectedChannelTransactionParameters {
942 assert!(self.is_owned);
943 let ret = self.inner;
944 self.inner = std::ptr::null_mut();
948 /// Get the channel pubkeys for the broadcaster
951 pub extern "C" fn DirectedChannelTransactionParameters_broadcaster_pubkeys(this_arg: &DirectedChannelTransactionParameters) -> crate::ln::chan_utils::ChannelPublicKeys {
952 let mut ret = unsafe { &*this_arg.inner }.broadcaster_pubkeys();
953 crate::ln::chan_utils::ChannelPublicKeys { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
956 /// Get the channel pubkeys for the countersignatory
959 pub extern "C" fn DirectedChannelTransactionParameters_countersignatory_pubkeys(this_arg: &DirectedChannelTransactionParameters) -> crate::ln::chan_utils::ChannelPublicKeys {
960 let mut ret = unsafe { &*this_arg.inner }.countersignatory_pubkeys();
961 crate::ln::chan_utils::ChannelPublicKeys { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
964 /// Get the contest delay applicable to the transactions.
965 /// Note that the contest delay was selected by the countersignatory.
968 pub extern "C" fn DirectedChannelTransactionParameters_contest_delay(this_arg: &DirectedChannelTransactionParameters) -> u16 {
969 let mut ret = unsafe { &*this_arg.inner }.contest_delay();
973 /// Whether the channel is outbound from the broadcaster.
975 /// The boolean representing the side that initiated the channel is
976 /// an input to the commitment number obscure factor computation.
979 pub extern "C" fn DirectedChannelTransactionParameters_is_outbound(this_arg: &DirectedChannelTransactionParameters) -> bool {
980 let mut ret = unsafe { &*this_arg.inner }.is_outbound();
984 /// The funding outpoint
987 pub extern "C" fn DirectedChannelTransactionParameters_funding_outpoint(this_arg: &DirectedChannelTransactionParameters) -> crate::chain::transaction::OutPoint {
988 let mut ret = unsafe { &*this_arg.inner }.funding_outpoint();
989 crate::c_types::bitcoin_to_C_outpoint(ret)
993 use lightning::ln::chan_utils::HolderCommitmentTransaction as nativeHolderCommitmentTransactionImport;
994 type nativeHolderCommitmentTransaction = nativeHolderCommitmentTransactionImport;
996 /// Information needed to build and sign a holder's commitment transaction.
998 /// The transaction is only signed once we are ready to broadcast.
1001 pub struct HolderCommitmentTransaction {
1002 /// A pointer to the opaque Rust object.
1004 /// Nearly everywhere, inner must be non-null, however in places where
1005 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
1006 pub inner: *mut nativeHolderCommitmentTransaction,
1007 /// Indicates that this is the only struct which contains the same pointer.
1009 /// Rust functions which take ownership of an object provided via an argument require
1010 /// this to be true and invalidate the object pointed to by inner.
1014 impl Drop for HolderCommitmentTransaction {
1015 fn drop(&mut self) {
1016 if self.is_owned && !<*mut nativeHolderCommitmentTransaction>::is_null(self.inner) {
1017 let _ = unsafe { Box::from_raw(self.inner) };
1021 /// Frees any resources used by the HolderCommitmentTransaction, if is_owned is set and inner is non-NULL.
1023 pub extern "C" fn HolderCommitmentTransaction_free(this_obj: HolderCommitmentTransaction) { }
1025 /// Used only if an object of this type is returned as a trait impl by a method
1026 extern "C" fn HolderCommitmentTransaction_free_void(this_ptr: *mut c_void) {
1027 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeHolderCommitmentTransaction); }
1030 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
1031 impl HolderCommitmentTransaction {
1032 pub(crate) fn take_inner(mut self) -> *mut nativeHolderCommitmentTransaction {
1033 assert!(self.is_owned);
1034 let ret = self.inner;
1035 self.inner = std::ptr::null_mut();
1039 /// Our counterparty's signature for the transaction
1041 pub extern "C" fn HolderCommitmentTransaction_get_counterparty_sig(this_ptr: &HolderCommitmentTransaction) -> crate::c_types::Signature {
1042 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.counterparty_sig;
1043 crate::c_types::Signature::from_rust(&(*inner_val))
1045 /// Our counterparty's signature for the transaction
1047 pub extern "C" fn HolderCommitmentTransaction_set_counterparty_sig(this_ptr: &mut HolderCommitmentTransaction, mut val: crate::c_types::Signature) {
1048 unsafe { &mut *this_ptr.inner }.counterparty_sig = val.into_rust();
1050 /// All non-dust counterparty HTLC signatures, in the order they appear in the transaction
1052 pub extern "C" fn HolderCommitmentTransaction_set_counterparty_htlc_sigs(this_ptr: &mut HolderCommitmentTransaction, mut val: crate::c_types::derived::CVec_SignatureZ) {
1053 let mut local_val = Vec::new(); for mut item in val.into_rust().drain(..) { local_val.push( { item.into_rust() }); };
1054 unsafe { &mut *this_ptr.inner }.counterparty_htlc_sigs = local_val;
1056 impl Clone for HolderCommitmentTransaction {
1057 fn clone(&self) -> Self {
1059 inner: if <*mut nativeHolderCommitmentTransaction>::is_null(self.inner) { std::ptr::null_mut() } else {
1060 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
1066 /// Used only if an object of this type is returned as a trait impl by a method
1067 pub(crate) extern "C" fn HolderCommitmentTransaction_clone_void(this_ptr: *const c_void) -> *mut c_void {
1068 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeHolderCommitmentTransaction)).clone() })) as *mut c_void
1071 /// Creates a copy of the HolderCommitmentTransaction
1072 pub extern "C" fn HolderCommitmentTransaction_clone(orig: &HolderCommitmentTransaction) -> HolderCommitmentTransaction {
1076 /// Serialize the HolderCommitmentTransaction object into a byte array which can be read by HolderCommitmentTransaction_read
1077 pub extern "C" fn HolderCommitmentTransaction_write(obj: &HolderCommitmentTransaction) -> crate::c_types::derived::CVec_u8Z {
1078 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
1081 pub(crate) extern "C" fn HolderCommitmentTransaction_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
1082 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeHolderCommitmentTransaction) })
1085 /// Read a HolderCommitmentTransaction from a byte array, created by HolderCommitmentTransaction_write
1086 pub extern "C" fn HolderCommitmentTransaction_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_HolderCommitmentTransactionDecodeErrorZ {
1087 let res = crate::c_types::deserialize_obj(ser);
1088 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::ln::chan_utils::HolderCommitmentTransaction { 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() };
1091 /// Create a new holder transaction with the given counterparty signatures.
1092 /// The funding keys are used to figure out which signature should go first when building the transaction for broadcast.
1095 pub extern "C" fn HolderCommitmentTransaction_new(mut commitment_tx: crate::ln::chan_utils::CommitmentTransaction, mut counterparty_sig: crate::c_types::Signature, mut counterparty_htlc_sigs: crate::c_types::derived::CVec_SignatureZ, mut holder_funding_key: crate::c_types::PublicKey, mut counterparty_funding_key: crate::c_types::PublicKey) -> HolderCommitmentTransaction {
1096 let mut local_counterparty_htlc_sigs = Vec::new(); for mut item in counterparty_htlc_sigs.into_rust().drain(..) { local_counterparty_htlc_sigs.push( { item.into_rust() }); };
1097 let mut ret = lightning::ln::chan_utils::HolderCommitmentTransaction::new(*unsafe { Box::from_raw(commitment_tx.take_inner()) }, counterparty_sig.into_rust(), local_counterparty_htlc_sigs, &holder_funding_key.into_rust(), &counterparty_funding_key.into_rust());
1098 HolderCommitmentTransaction { inner: Box::into_raw(Box::new(ret)), is_owned: true }
1102 use lightning::ln::chan_utils::BuiltCommitmentTransaction as nativeBuiltCommitmentTransactionImport;
1103 type nativeBuiltCommitmentTransaction = nativeBuiltCommitmentTransactionImport;
1105 /// A pre-built Bitcoin commitment transaction and its txid.
1108 pub struct BuiltCommitmentTransaction {
1109 /// A pointer to the opaque Rust object.
1111 /// Nearly everywhere, inner must be non-null, however in places where
1112 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
1113 pub inner: *mut nativeBuiltCommitmentTransaction,
1114 /// Indicates that this is the only struct which contains the same pointer.
1116 /// Rust functions which take ownership of an object provided via an argument require
1117 /// this to be true and invalidate the object pointed to by inner.
1121 impl Drop for BuiltCommitmentTransaction {
1122 fn drop(&mut self) {
1123 if self.is_owned && !<*mut nativeBuiltCommitmentTransaction>::is_null(self.inner) {
1124 let _ = unsafe { Box::from_raw(self.inner) };
1128 /// Frees any resources used by the BuiltCommitmentTransaction, if is_owned is set and inner is non-NULL.
1130 pub extern "C" fn BuiltCommitmentTransaction_free(this_obj: BuiltCommitmentTransaction) { }
1132 /// Used only if an object of this type is returned as a trait impl by a method
1133 extern "C" fn BuiltCommitmentTransaction_free_void(this_ptr: *mut c_void) {
1134 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeBuiltCommitmentTransaction); }
1137 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
1138 impl BuiltCommitmentTransaction {
1139 pub(crate) fn take_inner(mut self) -> *mut nativeBuiltCommitmentTransaction {
1140 assert!(self.is_owned);
1141 let ret = self.inner;
1142 self.inner = std::ptr::null_mut();
1146 /// The commitment transaction
1148 pub extern "C" fn BuiltCommitmentTransaction_get_transaction(this_ptr: &BuiltCommitmentTransaction) -> crate::c_types::Transaction {
1149 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.transaction;
1150 let mut local_inner_val = ::bitcoin::consensus::encode::serialize(inner_val);
1151 crate::c_types::Transaction::from_vec(local_inner_val)
1153 /// The commitment transaction
1155 pub extern "C" fn BuiltCommitmentTransaction_set_transaction(this_ptr: &mut BuiltCommitmentTransaction, mut val: crate::c_types::Transaction) {
1156 unsafe { &mut *this_ptr.inner }.transaction = val.into_bitcoin();
1158 /// The txid for the commitment transaction.
1160 /// This is provided as a performance optimization, instead of calling transaction.txid()
1163 pub extern "C" fn BuiltCommitmentTransaction_get_txid(this_ptr: &BuiltCommitmentTransaction) -> *const [u8; 32] {
1164 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.txid;
1165 (*inner_val).as_inner()
1167 /// The txid for the commitment transaction.
1169 /// This is provided as a performance optimization, instead of calling transaction.txid()
1172 pub extern "C" fn BuiltCommitmentTransaction_set_txid(this_ptr: &mut BuiltCommitmentTransaction, mut val: crate::c_types::ThirtyTwoBytes) {
1173 unsafe { &mut *this_ptr.inner }.txid = ::bitcoin::hash_types::Txid::from_slice(&val.data[..]).unwrap();
1175 /// Constructs a new BuiltCommitmentTransaction given each field
1178 pub extern "C" fn BuiltCommitmentTransaction_new(mut transaction_arg: crate::c_types::Transaction, mut txid_arg: crate::c_types::ThirtyTwoBytes) -> BuiltCommitmentTransaction {
1179 BuiltCommitmentTransaction { inner: Box::into_raw(Box::new(nativeBuiltCommitmentTransaction {
1180 transaction: transaction_arg.into_bitcoin(),
1181 txid: ::bitcoin::hash_types::Txid::from_slice(&txid_arg.data[..]).unwrap(),
1182 })), is_owned: true }
1184 impl Clone for BuiltCommitmentTransaction {
1185 fn clone(&self) -> Self {
1187 inner: if <*mut nativeBuiltCommitmentTransaction>::is_null(self.inner) { std::ptr::null_mut() } else {
1188 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
1194 /// Used only if an object of this type is returned as a trait impl by a method
1195 pub(crate) extern "C" fn BuiltCommitmentTransaction_clone_void(this_ptr: *const c_void) -> *mut c_void {
1196 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeBuiltCommitmentTransaction)).clone() })) as *mut c_void
1199 /// Creates a copy of the BuiltCommitmentTransaction
1200 pub extern "C" fn BuiltCommitmentTransaction_clone(orig: &BuiltCommitmentTransaction) -> BuiltCommitmentTransaction {
1204 /// Serialize the BuiltCommitmentTransaction object into a byte array which can be read by BuiltCommitmentTransaction_read
1205 pub extern "C" fn BuiltCommitmentTransaction_write(obj: &BuiltCommitmentTransaction) -> crate::c_types::derived::CVec_u8Z {
1206 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
1209 pub(crate) extern "C" fn BuiltCommitmentTransaction_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
1210 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeBuiltCommitmentTransaction) })
1213 /// Read a BuiltCommitmentTransaction from a byte array, created by BuiltCommitmentTransaction_write
1214 pub extern "C" fn BuiltCommitmentTransaction_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_BuiltCommitmentTransactionDecodeErrorZ {
1215 let res = crate::c_types::deserialize_obj(ser);
1216 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::ln::chan_utils::BuiltCommitmentTransaction { 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() };
1219 /// Get the SIGHASH_ALL sighash value of the transaction.
1221 /// This can be used to verify a signature.
1224 pub extern "C" fn BuiltCommitmentTransaction_get_sighash_all(this_arg: &BuiltCommitmentTransaction, mut funding_redeemscript: crate::c_types::u8slice, mut channel_value_satoshis: u64) -> crate::c_types::ThirtyTwoBytes {
1225 let mut ret = unsafe { &*this_arg.inner }.get_sighash_all(&::bitcoin::blockdata::script::Script::from(Vec::from(funding_redeemscript.to_slice())), channel_value_satoshis);
1226 crate::c_types::ThirtyTwoBytes { data: ret.as_ref().clone() }
1229 /// Sign a transaction, either because we are counter-signing the counterparty's transaction or
1230 /// because we are about to broadcast a holder transaction.
1233 pub extern "C" fn BuiltCommitmentTransaction_sign(this_arg: &BuiltCommitmentTransaction, funding_key: *const [u8; 32], mut funding_redeemscript: crate::c_types::u8slice, mut channel_value_satoshis: u64) -> crate::c_types::Signature {
1234 let mut ret = unsafe { &*this_arg.inner }.sign(&::bitcoin::secp256k1::key::SecretKey::from_slice(&unsafe { *funding_key}[..]).unwrap(), &::bitcoin::blockdata::script::Script::from(Vec::from(funding_redeemscript.to_slice())), channel_value_satoshis, secp256k1::SECP256K1);
1235 crate::c_types::Signature::from_rust(&ret)
1239 use lightning::ln::chan_utils::CommitmentTransaction as nativeCommitmentTransactionImport;
1240 type nativeCommitmentTransaction = nativeCommitmentTransactionImport;
1242 /// This class tracks the per-transaction information needed to build a commitment transaction and to
1243 /// actually build it and sign. It is used for holder transactions that we sign only when needed
1244 /// and for transactions we sign for the counterparty.
1246 /// This class can be used inside a signer implementation to generate a signature given the relevant
1250 pub struct CommitmentTransaction {
1251 /// A pointer to the opaque Rust object.
1253 /// Nearly everywhere, inner must be non-null, however in places where
1254 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
1255 pub inner: *mut nativeCommitmentTransaction,
1256 /// Indicates that this is the only struct which contains the same pointer.
1258 /// Rust functions which take ownership of an object provided via an argument require
1259 /// this to be true and invalidate the object pointed to by inner.
1263 impl Drop for CommitmentTransaction {
1264 fn drop(&mut self) {
1265 if self.is_owned && !<*mut nativeCommitmentTransaction>::is_null(self.inner) {
1266 let _ = unsafe { Box::from_raw(self.inner) };
1270 /// Frees any resources used by the CommitmentTransaction, if is_owned is set and inner is non-NULL.
1272 pub extern "C" fn CommitmentTransaction_free(this_obj: CommitmentTransaction) { }
1274 /// Used only if an object of this type is returned as a trait impl by a method
1275 extern "C" fn CommitmentTransaction_free_void(this_ptr: *mut c_void) {
1276 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeCommitmentTransaction); }
1279 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
1280 impl CommitmentTransaction {
1281 pub(crate) fn take_inner(mut self) -> *mut nativeCommitmentTransaction {
1282 assert!(self.is_owned);
1283 let ret = self.inner;
1284 self.inner = std::ptr::null_mut();
1288 impl Clone for CommitmentTransaction {
1289 fn clone(&self) -> Self {
1291 inner: if <*mut nativeCommitmentTransaction>::is_null(self.inner) { std::ptr::null_mut() } else {
1292 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
1298 /// Used only if an object of this type is returned as a trait impl by a method
1299 pub(crate) extern "C" fn CommitmentTransaction_clone_void(this_ptr: *const c_void) -> *mut c_void {
1300 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeCommitmentTransaction)).clone() })) as *mut c_void
1303 /// Creates a copy of the CommitmentTransaction
1304 pub extern "C" fn CommitmentTransaction_clone(orig: &CommitmentTransaction) -> CommitmentTransaction {
1308 /// Serialize the CommitmentTransaction object into a byte array which can be read by CommitmentTransaction_read
1309 pub extern "C" fn CommitmentTransaction_write(obj: &CommitmentTransaction) -> crate::c_types::derived::CVec_u8Z {
1310 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
1313 pub(crate) extern "C" fn CommitmentTransaction_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
1314 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeCommitmentTransaction) })
1317 /// Read a CommitmentTransaction from a byte array, created by CommitmentTransaction_write
1318 pub extern "C" fn CommitmentTransaction_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_CommitmentTransactionDecodeErrorZ {
1319 let res = crate::c_types::deserialize_obj(ser);
1320 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::ln::chan_utils::CommitmentTransaction { 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() };
1323 /// The backwards-counting commitment number
1326 pub extern "C" fn CommitmentTransaction_commitment_number(this_arg: &CommitmentTransaction) -> u64 {
1327 let mut ret = unsafe { &*this_arg.inner }.commitment_number();
1331 /// The value to be sent to the broadcaster
1334 pub extern "C" fn CommitmentTransaction_to_broadcaster_value_sat(this_arg: &CommitmentTransaction) -> u64 {
1335 let mut ret = unsafe { &*this_arg.inner }.to_broadcaster_value_sat();
1339 /// The value to be sent to the counterparty
1342 pub extern "C" fn CommitmentTransaction_to_countersignatory_value_sat(this_arg: &CommitmentTransaction) -> u64 {
1343 let mut ret = unsafe { &*this_arg.inner }.to_countersignatory_value_sat();
1347 /// The feerate paid per 1000-weight-unit in this commitment transaction.
1350 pub extern "C" fn CommitmentTransaction_feerate_per_kw(this_arg: &CommitmentTransaction) -> u32 {
1351 let mut ret = unsafe { &*this_arg.inner }.feerate_per_kw();
1355 /// Trust our pre-built transaction and derived transaction creation public keys.
1357 /// Applies a wrapper which allows access to these fields.
1359 /// This should only be used if you fully trust the builder of this object. It should not
1360 ///\tbe used by an external signer - instead use the verify function.
1363 pub extern "C" fn CommitmentTransaction_trust(this_arg: &CommitmentTransaction) -> crate::ln::chan_utils::TrustedCommitmentTransaction {
1364 let mut ret = unsafe { &*this_arg.inner }.trust();
1365 crate::ln::chan_utils::TrustedCommitmentTransaction { inner: Box::into_raw(Box::new(ret)), is_owned: true }
1368 /// Verify our pre-built transaction and derived transaction creation public keys.
1370 /// Applies a wrapper which allows access to these fields.
1372 /// An external validating signer must call this method before signing
1373 /// or using the built transaction.
1376 pub extern "C" fn CommitmentTransaction_verify(this_arg: &CommitmentTransaction, channel_parameters: &crate::ln::chan_utils::DirectedChannelTransactionParameters, broadcaster_keys: &crate::ln::chan_utils::ChannelPublicKeys, countersignatory_keys: &crate::ln::chan_utils::ChannelPublicKeys) -> crate::c_types::derived::CResult_TrustedCommitmentTransactionNoneZ {
1377 let mut ret = unsafe { &*this_arg.inner }.verify(unsafe { &*channel_parameters.inner }, unsafe { &*broadcaster_keys.inner }, unsafe { &*countersignatory_keys.inner }, secp256k1::SECP256K1);
1378 let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::ln::chan_utils::TrustedCommitmentTransaction { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { 0u8 /*e*/ }).into() };
1383 use lightning::ln::chan_utils::TrustedCommitmentTransaction as nativeTrustedCommitmentTransactionImport;
1384 type nativeTrustedCommitmentTransaction = nativeTrustedCommitmentTransactionImport<'static>;
1386 /// A wrapper on CommitmentTransaction indicating that the derived fields (the built bitcoin
1387 /// transaction and the transaction creation keys) are trusted.
1389 /// See trust() and verify() functions on CommitmentTransaction.
1391 /// This structure implements Deref.
1394 pub struct TrustedCommitmentTransaction {
1395 /// A pointer to the opaque Rust object.
1397 /// Nearly everywhere, inner must be non-null, however in places where
1398 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
1399 pub inner: *mut nativeTrustedCommitmentTransaction,
1400 /// Indicates that this is the only struct which contains the same pointer.
1402 /// Rust functions which take ownership of an object provided via an argument require
1403 /// this to be true and invalidate the object pointed to by inner.
1407 impl Drop for TrustedCommitmentTransaction {
1408 fn drop(&mut self) {
1409 if self.is_owned && !<*mut nativeTrustedCommitmentTransaction>::is_null(self.inner) {
1410 let _ = unsafe { Box::from_raw(self.inner) };
1414 /// Frees any resources used by the TrustedCommitmentTransaction, if is_owned is set and inner is non-NULL.
1416 pub extern "C" fn TrustedCommitmentTransaction_free(this_obj: TrustedCommitmentTransaction) { }
1418 /// Used only if an object of this type is returned as a trait impl by a method
1419 extern "C" fn TrustedCommitmentTransaction_free_void(this_ptr: *mut c_void) {
1420 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeTrustedCommitmentTransaction); }
1423 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
1424 impl TrustedCommitmentTransaction {
1425 pub(crate) fn take_inner(mut self) -> *mut nativeTrustedCommitmentTransaction {
1426 assert!(self.is_owned);
1427 let ret = self.inner;
1428 self.inner = std::ptr::null_mut();
1432 /// The transaction ID of the built Bitcoin transaction
1435 pub extern "C" fn TrustedCommitmentTransaction_txid(this_arg: &TrustedCommitmentTransaction) -> crate::c_types::ThirtyTwoBytes {
1436 let mut ret = unsafe { &*this_arg.inner }.txid();
1437 crate::c_types::ThirtyTwoBytes { data: ret.into_inner() }
1440 /// The pre-built Bitcoin commitment transaction
1443 pub extern "C" fn TrustedCommitmentTransaction_built_transaction(this_arg: &TrustedCommitmentTransaction) -> crate::ln::chan_utils::BuiltCommitmentTransaction {
1444 let mut ret = unsafe { &*this_arg.inner }.built_transaction();
1445 crate::ln::chan_utils::BuiltCommitmentTransaction { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
1448 /// The pre-calculated transaction creation public keys.
1451 pub extern "C" fn TrustedCommitmentTransaction_keys(this_arg: &TrustedCommitmentTransaction) -> crate::ln::chan_utils::TxCreationKeys {
1452 let mut ret = unsafe { &*this_arg.inner }.keys();
1453 crate::ln::chan_utils::TxCreationKeys { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
1456 /// Get a signature for each HTLC which was included in the commitment transaction (ie for
1457 /// which HTLCOutputInCommitment::transaction_output_index.is_some()).
1459 /// The returned Vec has one entry for each HTLC, and in the same order.
1462 pub extern "C" fn TrustedCommitmentTransaction_get_htlc_sigs(this_arg: &TrustedCommitmentTransaction, htlc_base_key: *const [u8; 32], channel_parameters: &crate::ln::chan_utils::DirectedChannelTransactionParameters) -> crate::c_types::derived::CResult_CVec_SignatureZNoneZ {
1463 let mut ret = unsafe { &*this_arg.inner }.get_htlc_sigs(&::bitcoin::secp256k1::key::SecretKey::from_slice(&unsafe { *htlc_base_key}[..]).unwrap(), unsafe { &*channel_parameters.inner }, secp256k1::SECP256K1);
1464 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( { crate::c_types::Signature::from_rust(&item) }); }; local_ret_0.into() }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { 0u8 /*e*/ }).into() };
1468 /// Get the transaction number obscure factor
1470 pub extern "C" fn get_commitment_transaction_number_obscure_factor(mut broadcaster_payment_basepoint: crate::c_types::PublicKey, mut countersignatory_payment_basepoint: crate::c_types::PublicKey, mut outbound_from_broadcaster: bool) -> u64 {
1471 let mut ret = lightning::ln::chan_utils::get_commitment_transaction_number_obscure_factor(&broadcaster_payment_basepoint.into_rust(), &countersignatory_payment_basepoint.into_rust(), outbound_from_broadcaster);