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.
12 use std::str::FromStr;
14 use bitcoin::hashes::Hash;
15 use crate::c_types::*;
17 /// Build the commitment secret from the seed and the commitment number
19 pub extern "C" fn build_commitment_secret(commitment_seed: *const [u8; 32], mut idx: u64) -> crate::c_types::ThirtyTwoBytes {
20 let mut ret = lightning::ln::chan_utils::build_commitment_secret(unsafe { &*commitment_seed}, idx);
21 crate::c_types::ThirtyTwoBytes { data: ret }
24 /// Derives a per-commitment-transaction private key (eg an htlc key or delayed_payment key)
25 /// from the base secret and the per_commitment_point.
27 /// Note that this is infallible iff we trust that at least one of the two input keys are randomly
28 /// generated (ie our own).
30 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 {
31 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());
32 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() };
36 /// Derives a per-commitment-transaction public key (eg an htlc key or a delayed_payment key)
37 /// from the base point and the per_commitment_key. This is the public equivalent of
38 /// derive_private_key - using only public keys to derive a public key instead of private keys.
40 /// Note that this is infallible iff we trust that at least one of the two input keys are randomly
41 /// generated (ie our own).
43 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 {
44 let mut ret = lightning::ln::chan_utils::derive_public_key(secp256k1::SECP256K1, &per_commitment_point.into_rust(), &base_point.into_rust());
45 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() };
49 /// Derives a per-commitment-transaction revocation key from its constituent parts.
51 /// Only the cheating participant owns a valid witness to propagate a revoked
52 /// commitment transaction, thus per_commitment_secret always come from cheater
53 /// and revocation_base_secret always come from punisher, which is the broadcaster
54 /// of the transaction spending with this key knowledge.
56 /// Note that this is infallible iff we trust that at least one of the two input keys are randomly
57 /// generated (ie our own).
59 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 {
60 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());
61 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() };
65 /// Derives a per-commitment-transaction revocation public key from its constituent parts. This is
66 /// the public equivalend of derive_private_revocation_key - using only public keys to derive a
67 /// public key instead of private keys.
69 /// Only the cheating participant owns a valid witness to propagate a revoked
70 /// commitment transaction, thus per_commitment_point always come from cheater
71 /// and revocation_base_point always come from punisher, which is the broadcaster
72 /// of the transaction spending with this key knowledge.
74 /// Note that this is infallible iff we trust that at least one of the two input keys are randomly
75 /// generated (ie our own).
77 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 {
78 let mut ret = lightning::ln::chan_utils::derive_public_revocation_key(secp256k1::SECP256K1, &per_commitment_point.into_rust(), &countersignatory_revocation_base_point.into_rust());
79 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() };
84 use lightning::ln::chan_utils::TxCreationKeys as nativeTxCreationKeysImport;
85 type nativeTxCreationKeys = nativeTxCreationKeysImport;
87 /// The set of public keys which are used in the creation of one commitment transaction.
88 /// These are derived from the channel base keys and per-commitment data.
90 /// A broadcaster key is provided from potential broadcaster of the computed transaction.
91 /// A countersignatory key is coming from a protocol participant unable to broadcast the
94 /// These keys are assumed to be good, either because the code derived them from
95 /// channel basepoints via the new function, or they were obtained via
96 /// CommitmentTransaction.trust().keys() because we trusted the source of the
97 /// pre-calculated keys.
100 pub struct TxCreationKeys {
101 /// A pointer to the opaque Rust object.
103 /// Nearly everywhere, inner must be non-null, however in places where
104 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
105 pub inner: *mut nativeTxCreationKeys,
106 /// Indicates that this is the only struct which contains the same pointer.
108 /// Rust functions which take ownership of an object provided via an argument require
109 /// this to be true and invalidate the object pointed to by inner.
113 impl Drop for TxCreationKeys {
115 if self.is_owned && !<*mut nativeTxCreationKeys>::is_null(self.inner) {
116 let _ = unsafe { Box::from_raw(self.inner) };
120 /// Frees any resources used by the TxCreationKeys, if is_owned is set and inner is non-NULL.
122 pub extern "C" fn TxCreationKeys_free(this_obj: TxCreationKeys) { }
124 /// Used only if an object of this type is returned as a trait impl by a method
125 extern "C" fn TxCreationKeys_free_void(this_ptr: *mut c_void) {
126 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeTxCreationKeys); }
129 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
130 impl TxCreationKeys {
131 pub(crate) fn take_inner(mut self) -> *mut nativeTxCreationKeys {
132 assert!(self.is_owned);
133 let ret = self.inner;
134 self.inner = std::ptr::null_mut();
138 /// The broadcaster's per-commitment public key which was used to derive the other keys.
140 pub extern "C" fn TxCreationKeys_get_per_commitment_point(this_ptr: &TxCreationKeys) -> crate::c_types::PublicKey {
141 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.per_commitment_point;
142 crate::c_types::PublicKey::from_rust(&inner_val)
144 /// The broadcaster's per-commitment public key which was used to derive the other keys.
146 pub extern "C" fn TxCreationKeys_set_per_commitment_point(this_ptr: &mut TxCreationKeys, mut val: crate::c_types::PublicKey) {
147 unsafe { &mut *this_ptr.inner }.per_commitment_point = val.into_rust();
149 /// The revocation key which is used to allow the broadcaster of the commitment
150 /// transaction to provide their counterparty the ability to punish them if they broadcast
153 pub extern "C" fn TxCreationKeys_get_revocation_key(this_ptr: &TxCreationKeys) -> crate::c_types::PublicKey {
154 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.revocation_key;
155 crate::c_types::PublicKey::from_rust(&inner_val)
157 /// The revocation key which is used to allow the broadcaster of the commitment
158 /// transaction to provide their counterparty the ability to punish them if they broadcast
161 pub extern "C" fn TxCreationKeys_set_revocation_key(this_ptr: &mut TxCreationKeys, mut val: crate::c_types::PublicKey) {
162 unsafe { &mut *this_ptr.inner }.revocation_key = val.into_rust();
164 /// Broadcaster's HTLC Key
166 pub extern "C" fn TxCreationKeys_get_broadcaster_htlc_key(this_ptr: &TxCreationKeys) -> crate::c_types::PublicKey {
167 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.broadcaster_htlc_key;
168 crate::c_types::PublicKey::from_rust(&inner_val)
170 /// Broadcaster's HTLC Key
172 pub extern "C" fn TxCreationKeys_set_broadcaster_htlc_key(this_ptr: &mut TxCreationKeys, mut val: crate::c_types::PublicKey) {
173 unsafe { &mut *this_ptr.inner }.broadcaster_htlc_key = val.into_rust();
175 /// Countersignatory's HTLC Key
177 pub extern "C" fn TxCreationKeys_get_countersignatory_htlc_key(this_ptr: &TxCreationKeys) -> crate::c_types::PublicKey {
178 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.countersignatory_htlc_key;
179 crate::c_types::PublicKey::from_rust(&inner_val)
181 /// Countersignatory's HTLC Key
183 pub extern "C" fn TxCreationKeys_set_countersignatory_htlc_key(this_ptr: &mut TxCreationKeys, mut val: crate::c_types::PublicKey) {
184 unsafe { &mut *this_ptr.inner }.countersignatory_htlc_key = val.into_rust();
186 /// Broadcaster's Payment Key (which isn't allowed to be spent from for some delay)
188 pub extern "C" fn TxCreationKeys_get_broadcaster_delayed_payment_key(this_ptr: &TxCreationKeys) -> crate::c_types::PublicKey {
189 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.broadcaster_delayed_payment_key;
190 crate::c_types::PublicKey::from_rust(&inner_val)
192 /// Broadcaster's Payment Key (which isn't allowed to be spent from for some delay)
194 pub extern "C" fn TxCreationKeys_set_broadcaster_delayed_payment_key(this_ptr: &mut TxCreationKeys, mut val: crate::c_types::PublicKey) {
195 unsafe { &mut *this_ptr.inner }.broadcaster_delayed_payment_key = val.into_rust();
197 /// Constructs a new TxCreationKeys given each field
200 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 {
201 TxCreationKeys { inner: Box::into_raw(Box::new(nativeTxCreationKeys {
202 per_commitment_point: per_commitment_point_arg.into_rust(),
203 revocation_key: revocation_key_arg.into_rust(),
204 broadcaster_htlc_key: broadcaster_htlc_key_arg.into_rust(),
205 countersignatory_htlc_key: countersignatory_htlc_key_arg.into_rust(),
206 broadcaster_delayed_payment_key: broadcaster_delayed_payment_key_arg.into_rust(),
207 })), is_owned: true }
209 impl Clone for TxCreationKeys {
210 fn clone(&self) -> Self {
212 inner: if <*mut nativeTxCreationKeys>::is_null(self.inner) { std::ptr::null_mut() } else {
213 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
219 /// Used only if an object of this type is returned as a trait impl by a method
220 pub(crate) extern "C" fn TxCreationKeys_clone_void(this_ptr: *const c_void) -> *mut c_void {
221 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeTxCreationKeys)).clone() })) as *mut c_void
224 /// Creates a copy of the TxCreationKeys
225 pub extern "C" fn TxCreationKeys_clone(orig: &TxCreationKeys) -> TxCreationKeys {
229 /// Serialize the TxCreationKeys object into a byte array which can be read by TxCreationKeys_read
230 pub extern "C" fn TxCreationKeys_write(obj: &TxCreationKeys) -> crate::c_types::derived::CVec_u8Z {
231 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
234 pub(crate) extern "C" fn TxCreationKeys_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
235 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeTxCreationKeys) })
238 /// Read a TxCreationKeys from a byte array, created by TxCreationKeys_write
239 pub extern "C" fn TxCreationKeys_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_TxCreationKeysDecodeErrorZ {
240 let res = crate::c_types::deserialize_obj(ser);
241 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::ln::chan_utils::TxCreationKeys { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::lightning::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
245 use lightning::ln::chan_utils::ChannelPublicKeys as nativeChannelPublicKeysImport;
246 type nativeChannelPublicKeys = nativeChannelPublicKeysImport;
248 /// One counterparty's public keys which do not change over the life of a channel.
251 pub struct ChannelPublicKeys {
252 /// A pointer to the opaque Rust object.
254 /// Nearly everywhere, inner must be non-null, however in places where
255 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
256 pub inner: *mut nativeChannelPublicKeys,
257 /// Indicates that this is the only struct which contains the same pointer.
259 /// Rust functions which take ownership of an object provided via an argument require
260 /// this to be true and invalidate the object pointed to by inner.
264 impl Drop for ChannelPublicKeys {
266 if self.is_owned && !<*mut nativeChannelPublicKeys>::is_null(self.inner) {
267 let _ = unsafe { Box::from_raw(self.inner) };
271 /// Frees any resources used by the ChannelPublicKeys, if is_owned is set and inner is non-NULL.
273 pub extern "C" fn ChannelPublicKeys_free(this_obj: ChannelPublicKeys) { }
275 /// Used only if an object of this type is returned as a trait impl by a method
276 extern "C" fn ChannelPublicKeys_free_void(this_ptr: *mut c_void) {
277 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeChannelPublicKeys); }
280 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
281 impl ChannelPublicKeys {
282 pub(crate) fn take_inner(mut self) -> *mut nativeChannelPublicKeys {
283 assert!(self.is_owned);
284 let ret = self.inner;
285 self.inner = std::ptr::null_mut();
289 /// The public key which is used to sign all commitment transactions, as it appears in the
290 /// on-chain channel lock-in 2-of-2 multisig output.
292 pub extern "C" fn ChannelPublicKeys_get_funding_pubkey(this_ptr: &ChannelPublicKeys) -> crate::c_types::PublicKey {
293 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.funding_pubkey;
294 crate::c_types::PublicKey::from_rust(&inner_val)
296 /// The public key which is used to sign all commitment transactions, as it appears in the
297 /// on-chain channel lock-in 2-of-2 multisig output.
299 pub extern "C" fn ChannelPublicKeys_set_funding_pubkey(this_ptr: &mut ChannelPublicKeys, mut val: crate::c_types::PublicKey) {
300 unsafe { &mut *this_ptr.inner }.funding_pubkey = val.into_rust();
302 /// The base point which is used (with derive_public_revocation_key) to derive per-commitment
303 /// revocation keys. This is combined with the per-commitment-secret generated by the
304 /// counterparty to create a secret which the counterparty can reveal to revoke previous
307 pub extern "C" fn ChannelPublicKeys_get_revocation_basepoint(this_ptr: &ChannelPublicKeys) -> crate::c_types::PublicKey {
308 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.revocation_basepoint;
309 crate::c_types::PublicKey::from_rust(&inner_val)
311 /// The base point which is used (with derive_public_revocation_key) to derive per-commitment
312 /// revocation keys. This is combined with the per-commitment-secret generated by the
313 /// counterparty to create a secret which the counterparty can reveal to revoke previous
316 pub extern "C" fn ChannelPublicKeys_set_revocation_basepoint(this_ptr: &mut ChannelPublicKeys, mut val: crate::c_types::PublicKey) {
317 unsafe { &mut *this_ptr.inner }.revocation_basepoint = val.into_rust();
319 /// The public key on which the non-broadcaster (ie the countersignatory) receives an immediately
320 /// spendable primary channel balance on the broadcaster's commitment transaction. This key is
321 /// static across every commitment transaction.
323 pub extern "C" fn ChannelPublicKeys_get_payment_point(this_ptr: &ChannelPublicKeys) -> crate::c_types::PublicKey {
324 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.payment_point;
325 crate::c_types::PublicKey::from_rust(&inner_val)
327 /// The public key on which the non-broadcaster (ie the countersignatory) receives an immediately
328 /// spendable primary channel balance on the broadcaster's commitment transaction. This key is
329 /// static across every commitment transaction.
331 pub extern "C" fn ChannelPublicKeys_set_payment_point(this_ptr: &mut ChannelPublicKeys, mut val: crate::c_types::PublicKey) {
332 unsafe { &mut *this_ptr.inner }.payment_point = val.into_rust();
334 /// The base point which is used (with derive_public_key) to derive a per-commitment payment
335 /// public key which receives non-HTLC-encumbered funds which are only available for spending
336 /// after some delay (or can be claimed via the revocation path).
338 pub extern "C" fn ChannelPublicKeys_get_delayed_payment_basepoint(this_ptr: &ChannelPublicKeys) -> crate::c_types::PublicKey {
339 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.delayed_payment_basepoint;
340 crate::c_types::PublicKey::from_rust(&inner_val)
342 /// The base point which is used (with derive_public_key) to derive a per-commitment payment
343 /// public key which receives non-HTLC-encumbered funds which are only available for spending
344 /// after some delay (or can be claimed via the revocation path).
346 pub extern "C" fn ChannelPublicKeys_set_delayed_payment_basepoint(this_ptr: &mut ChannelPublicKeys, mut val: crate::c_types::PublicKey) {
347 unsafe { &mut *this_ptr.inner }.delayed_payment_basepoint = val.into_rust();
349 /// The base point which is used (with derive_public_key) to derive a per-commitment public key
350 /// which is used to encumber HTLC-in-flight outputs.
352 pub extern "C" fn ChannelPublicKeys_get_htlc_basepoint(this_ptr: &ChannelPublicKeys) -> crate::c_types::PublicKey {
353 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.htlc_basepoint;
354 crate::c_types::PublicKey::from_rust(&inner_val)
356 /// The base point which is used (with derive_public_key) to derive a per-commitment public key
357 /// which is used to encumber HTLC-in-flight outputs.
359 pub extern "C" fn ChannelPublicKeys_set_htlc_basepoint(this_ptr: &mut ChannelPublicKeys, mut val: crate::c_types::PublicKey) {
360 unsafe { &mut *this_ptr.inner }.htlc_basepoint = val.into_rust();
362 /// Constructs a new ChannelPublicKeys given each field
365 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 {
366 ChannelPublicKeys { inner: Box::into_raw(Box::new(nativeChannelPublicKeys {
367 funding_pubkey: funding_pubkey_arg.into_rust(),
368 revocation_basepoint: revocation_basepoint_arg.into_rust(),
369 payment_point: payment_point_arg.into_rust(),
370 delayed_payment_basepoint: delayed_payment_basepoint_arg.into_rust(),
371 htlc_basepoint: htlc_basepoint_arg.into_rust(),
372 })), is_owned: true }
374 impl Clone for ChannelPublicKeys {
375 fn clone(&self) -> Self {
377 inner: if <*mut nativeChannelPublicKeys>::is_null(self.inner) { std::ptr::null_mut() } else {
378 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
384 /// Used only if an object of this type is returned as a trait impl by a method
385 pub(crate) extern "C" fn ChannelPublicKeys_clone_void(this_ptr: *const c_void) -> *mut c_void {
386 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeChannelPublicKeys)).clone() })) as *mut c_void
389 /// Creates a copy of the ChannelPublicKeys
390 pub extern "C" fn ChannelPublicKeys_clone(orig: &ChannelPublicKeys) -> ChannelPublicKeys {
394 /// Serialize the ChannelPublicKeys object into a byte array which can be read by ChannelPublicKeys_read
395 pub extern "C" fn ChannelPublicKeys_write(obj: &ChannelPublicKeys) -> crate::c_types::derived::CVec_u8Z {
396 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
399 pub(crate) extern "C" fn ChannelPublicKeys_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
400 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeChannelPublicKeys) })
403 /// Read a ChannelPublicKeys from a byte array, created by ChannelPublicKeys_write
404 pub extern "C" fn ChannelPublicKeys_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_ChannelPublicKeysDecodeErrorZ {
405 let res = crate::c_types::deserialize_obj(ser);
406 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::ln::chan_utils::ChannelPublicKeys { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::lightning::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
409 /// Create per-state keys from channel base points and the per-commitment point.
410 /// Key set is asymmetric and can't be used as part of counter-signatory set of transactions.
413 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 {
414 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());
415 let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::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() };
419 /// Generate per-state keys from channel static keys.
420 /// Key set is asymmetric and can't be used as part of counter-signatory set of transactions.
423 pub extern "C" fn TxCreationKeys_from_channel_static_keys(mut per_commitment_point: crate::c_types::PublicKey, broadcaster_keys: &crate::lightning::ln::chan_utils::ChannelPublicKeys, countersignatory_keys: &crate::lightning::ln::chan_utils::ChannelPublicKeys) -> crate::c_types::derived::CResult_TxCreationKeysErrorZ {
424 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);
425 let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::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() };
429 /// The maximum length of a script returned by get_revokeable_redeemscript.
432 pub static REVOKEABLE_REDEEMSCRIPT_MAX_LENGTH: usize = lightning::ln::chan_utils::REVOKEABLE_REDEEMSCRIPT_MAX_LENGTH;
433 /// A script either spendable by the revocation
434 /// key or the broadcaster_delayed_payment_key and satisfying the relative-locktime OP_CSV constrain.
435 /// Encumbering a `to_holder` output on a commitment transaction or 2nd-stage HTLC transactions.
437 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 {
438 let mut ret = lightning::ln::chan_utils::get_revokeable_redeemscript(&revocation_key.into_rust(), contest_delay, &broadcaster_delayed_payment_key.into_rust());
439 ret.into_bytes().into()
443 use lightning::ln::chan_utils::HTLCOutputInCommitment as nativeHTLCOutputInCommitmentImport;
444 type nativeHTLCOutputInCommitment = nativeHTLCOutputInCommitmentImport;
446 /// Information about an HTLC as it appears in a commitment transaction
449 pub struct HTLCOutputInCommitment {
450 /// A pointer to the opaque Rust object.
452 /// Nearly everywhere, inner must be non-null, however in places where
453 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
454 pub inner: *mut nativeHTLCOutputInCommitment,
455 /// Indicates that this is the only struct which contains the same pointer.
457 /// Rust functions which take ownership of an object provided via an argument require
458 /// this to be true and invalidate the object pointed to by inner.
462 impl Drop for HTLCOutputInCommitment {
464 if self.is_owned && !<*mut nativeHTLCOutputInCommitment>::is_null(self.inner) {
465 let _ = unsafe { Box::from_raw(self.inner) };
469 /// Frees any resources used by the HTLCOutputInCommitment, if is_owned is set and inner is non-NULL.
471 pub extern "C" fn HTLCOutputInCommitment_free(this_obj: HTLCOutputInCommitment) { }
473 /// Used only if an object of this type is returned as a trait impl by a method
474 extern "C" fn HTLCOutputInCommitment_free_void(this_ptr: *mut c_void) {
475 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeHTLCOutputInCommitment); }
478 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
479 impl HTLCOutputInCommitment {
480 pub(crate) fn take_inner(mut self) -> *mut nativeHTLCOutputInCommitment {
481 assert!(self.is_owned);
482 let ret = self.inner;
483 self.inner = std::ptr::null_mut();
487 /// Whether the HTLC was \"offered\" (ie outbound in relation to this commitment transaction).
488 /// Note that this is not the same as whether it is ountbound *from us*. To determine that you
489 /// need to compare this value to whether the commitment transaction in question is that of
490 /// the counterparty or our own.
492 pub extern "C" fn HTLCOutputInCommitment_get_offered(this_ptr: &HTLCOutputInCommitment) -> bool {
493 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.offered;
496 /// Whether the HTLC was \"offered\" (ie outbound in relation to this commitment transaction).
497 /// Note that this is not the same as whether it is ountbound *from us*. To determine that you
498 /// need to compare this value to whether the commitment transaction in question is that of
499 /// the counterparty or our own.
501 pub extern "C" fn HTLCOutputInCommitment_set_offered(this_ptr: &mut HTLCOutputInCommitment, mut val: bool) {
502 unsafe { &mut *this_ptr.inner }.offered = val;
504 /// The value, in msat, of the HTLC. The value as it appears in the commitment transaction is
505 /// this divided by 1000.
507 pub extern "C" fn HTLCOutputInCommitment_get_amount_msat(this_ptr: &HTLCOutputInCommitment) -> u64 {
508 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.amount_msat;
511 /// The value, in msat, of the HTLC. The value as it appears in the commitment transaction is
512 /// this divided by 1000.
514 pub extern "C" fn HTLCOutputInCommitment_set_amount_msat(this_ptr: &mut HTLCOutputInCommitment, mut val: u64) {
515 unsafe { &mut *this_ptr.inner }.amount_msat = val;
517 /// The CLTV lock-time at which this HTLC expires.
519 pub extern "C" fn HTLCOutputInCommitment_get_cltv_expiry(this_ptr: &HTLCOutputInCommitment) -> u32 {
520 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.cltv_expiry;
523 /// The CLTV lock-time at which this HTLC expires.
525 pub extern "C" fn HTLCOutputInCommitment_set_cltv_expiry(this_ptr: &mut HTLCOutputInCommitment, mut val: u32) {
526 unsafe { &mut *this_ptr.inner }.cltv_expiry = val;
528 /// The hash of the preimage which unlocks this HTLC.
530 pub extern "C" fn HTLCOutputInCommitment_get_payment_hash(this_ptr: &HTLCOutputInCommitment) -> *const [u8; 32] {
531 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.payment_hash;
534 /// The hash of the preimage which unlocks this HTLC.
536 pub extern "C" fn HTLCOutputInCommitment_set_payment_hash(this_ptr: &mut HTLCOutputInCommitment, mut val: crate::c_types::ThirtyTwoBytes) {
537 unsafe { &mut *this_ptr.inner }.payment_hash = ::lightning::ln::channelmanager::PaymentHash(val.data);
539 /// The position within the commitment transactions' outputs. This may be None if the value is
540 /// below the dust limit (in which case no output appears in the commitment transaction and the
541 /// value is spent to additional transaction fees).
543 pub extern "C" fn HTLCOutputInCommitment_get_transaction_output_index(this_ptr: &HTLCOutputInCommitment) -> crate::c_types::derived::COption_u32Z {
544 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.transaction_output_index;
545 let mut local_inner_val = if inner_val.is_none() { crate::c_types::derived::COption_u32Z::None } else { { crate::c_types::derived::COption_u32Z::Some(inner_val.unwrap()) } };
548 /// The position within the commitment transactions' outputs. This may be None if the value is
549 /// below the dust limit (in which case no output appears in the commitment transaction and the
550 /// value is spent to additional transaction fees).
552 pub extern "C" fn HTLCOutputInCommitment_set_transaction_output_index(this_ptr: &mut HTLCOutputInCommitment, mut val: crate::c_types::derived::COption_u32Z) {
553 let mut local_val = if val.is_some() { Some( { val.take() }) } else { None };
554 unsafe { &mut *this_ptr.inner }.transaction_output_index = local_val;
556 /// Constructs a new HTLCOutputInCommitment given each field
559 pub extern "C" fn HTLCOutputInCommitment_new(mut offered_arg: bool, mut amount_msat_arg: u64, mut cltv_expiry_arg: u32, mut payment_hash_arg: crate::c_types::ThirtyTwoBytes, mut transaction_output_index_arg: crate::c_types::derived::COption_u32Z) -> HTLCOutputInCommitment {
560 let mut local_transaction_output_index_arg = if transaction_output_index_arg.is_some() { Some( { transaction_output_index_arg.take() }) } else { None };
561 HTLCOutputInCommitment { inner: Box::into_raw(Box::new(nativeHTLCOutputInCommitment {
562 offered: offered_arg,
563 amount_msat: amount_msat_arg,
564 cltv_expiry: cltv_expiry_arg,
565 payment_hash: ::lightning::ln::channelmanager::PaymentHash(payment_hash_arg.data),
566 transaction_output_index: local_transaction_output_index_arg,
567 })), is_owned: true }
569 impl Clone for HTLCOutputInCommitment {
570 fn clone(&self) -> Self {
572 inner: if <*mut nativeHTLCOutputInCommitment>::is_null(self.inner) { std::ptr::null_mut() } else {
573 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
579 /// Used only if an object of this type is returned as a trait impl by a method
580 pub(crate) extern "C" fn HTLCOutputInCommitment_clone_void(this_ptr: *const c_void) -> *mut c_void {
581 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeHTLCOutputInCommitment)).clone() })) as *mut c_void
584 /// Creates a copy of the HTLCOutputInCommitment
585 pub extern "C" fn HTLCOutputInCommitment_clone(orig: &HTLCOutputInCommitment) -> HTLCOutputInCommitment {
589 /// Serialize the HTLCOutputInCommitment object into a byte array which can be read by HTLCOutputInCommitment_read
590 pub extern "C" fn HTLCOutputInCommitment_write(obj: &HTLCOutputInCommitment) -> crate::c_types::derived::CVec_u8Z {
591 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
594 pub(crate) extern "C" fn HTLCOutputInCommitment_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
595 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeHTLCOutputInCommitment) })
598 /// Read a HTLCOutputInCommitment from a byte array, created by HTLCOutputInCommitment_write
599 pub extern "C" fn HTLCOutputInCommitment_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_HTLCOutputInCommitmentDecodeErrorZ {
600 let res = crate::c_types::deserialize_obj(ser);
601 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::ln::chan_utils::HTLCOutputInCommitment { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::lightning::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
604 /// Gets the witness redeemscript for an HTLC output in a commitment transaction. Note that htlc
605 /// does not need to have its previous_output_index filled.
607 pub extern "C" fn get_htlc_redeemscript(htlc: &crate::lightning::ln::chan_utils::HTLCOutputInCommitment, keys: &crate::lightning::ln::chan_utils::TxCreationKeys) -> crate::c_types::derived::CVec_u8Z {
608 let mut ret = lightning::ln::chan_utils::get_htlc_redeemscript(unsafe { &*htlc.inner }, unsafe { &*keys.inner });
609 ret.into_bytes().into()
612 /// Gets the redeemscript for a funding output from the two funding public keys.
613 /// Note that the order of funding public keys does not matter.
615 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 {
616 let mut ret = lightning::ln::chan_utils::make_funding_redeemscript(&broadcaster.into_rust(), &countersignatory.into_rust());
617 ret.into_bytes().into()
620 /// panics if htlc.transaction_output_index.is_none()!
622 pub extern "C" fn build_htlc_transaction(prev_hash: *const [u8; 32], mut feerate_per_kw: u32, mut contest_delay: u16, htlc: &crate::lightning::ln::chan_utils::HTLCOutputInCommitment, mut broadcaster_delayed_payment_key: crate::c_types::PublicKey, mut revocation_key: crate::c_types::PublicKey) -> crate::c_types::Transaction {
623 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());
624 crate::c_types::Transaction::from_bitcoin(&ret)
628 use lightning::ln::chan_utils::ChannelTransactionParameters as nativeChannelTransactionParametersImport;
629 type nativeChannelTransactionParameters = nativeChannelTransactionParametersImport;
631 /// Per-channel data used to build transactions in conjunction with the per-commitment data (CommitmentTransaction).
632 /// The fields are organized by holder/counterparty.
634 /// Normally, this is converted to the broadcaster/countersignatory-organized DirectedChannelTransactionParameters
635 /// before use, via the as_holder_broadcastable and as_counterparty_broadcastable functions.
638 pub struct ChannelTransactionParameters {
639 /// A pointer to the opaque Rust object.
641 /// Nearly everywhere, inner must be non-null, however in places where
642 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
643 pub inner: *mut nativeChannelTransactionParameters,
644 /// Indicates that this is the only struct which contains the same pointer.
646 /// Rust functions which take ownership of an object provided via an argument require
647 /// this to be true and invalidate the object pointed to by inner.
651 impl Drop for ChannelTransactionParameters {
653 if self.is_owned && !<*mut nativeChannelTransactionParameters>::is_null(self.inner) {
654 let _ = unsafe { Box::from_raw(self.inner) };
658 /// Frees any resources used by the ChannelTransactionParameters, if is_owned is set and inner is non-NULL.
660 pub extern "C" fn ChannelTransactionParameters_free(this_obj: ChannelTransactionParameters) { }
662 /// Used only if an object of this type is returned as a trait impl by a method
663 extern "C" fn ChannelTransactionParameters_free_void(this_ptr: *mut c_void) {
664 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeChannelTransactionParameters); }
667 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
668 impl ChannelTransactionParameters {
669 pub(crate) fn take_inner(mut self) -> *mut nativeChannelTransactionParameters {
670 assert!(self.is_owned);
671 let ret = self.inner;
672 self.inner = std::ptr::null_mut();
676 /// Holder public keys
678 pub extern "C" fn ChannelTransactionParameters_get_holder_pubkeys(this_ptr: &ChannelTransactionParameters) -> crate::lightning::ln::chan_utils::ChannelPublicKeys {
679 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.holder_pubkeys;
680 crate::lightning::ln::chan_utils::ChannelPublicKeys { inner: unsafe { ( (&(*inner_val) as *const _) as *mut _) }, is_owned: false }
682 /// Holder public keys
684 pub extern "C" fn ChannelTransactionParameters_set_holder_pubkeys(this_ptr: &mut ChannelTransactionParameters, mut val: crate::lightning::ln::chan_utils::ChannelPublicKeys) {
685 unsafe { &mut *this_ptr.inner }.holder_pubkeys = *unsafe { Box::from_raw(val.take_inner()) };
687 /// The contest delay selected by the holder, which applies to counterparty-broadcast transactions
689 pub extern "C" fn ChannelTransactionParameters_get_holder_selected_contest_delay(this_ptr: &ChannelTransactionParameters) -> u16 {
690 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.holder_selected_contest_delay;
693 /// The contest delay selected by the holder, which applies to counterparty-broadcast transactions
695 pub extern "C" fn ChannelTransactionParameters_set_holder_selected_contest_delay(this_ptr: &mut ChannelTransactionParameters, mut val: u16) {
696 unsafe { &mut *this_ptr.inner }.holder_selected_contest_delay = val;
698 /// Whether the holder is the initiator of this channel.
699 /// This is an input to the commitment number obscure factor computation.
701 pub extern "C" fn ChannelTransactionParameters_get_is_outbound_from_holder(this_ptr: &ChannelTransactionParameters) -> bool {
702 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.is_outbound_from_holder;
705 /// Whether the holder is the initiator of this channel.
706 /// This is an input to the commitment number obscure factor computation.
708 pub extern "C" fn ChannelTransactionParameters_set_is_outbound_from_holder(this_ptr: &mut ChannelTransactionParameters, mut val: bool) {
709 unsafe { &mut *this_ptr.inner }.is_outbound_from_holder = val;
711 /// The late-bound counterparty channel transaction parameters.
712 /// These parameters are populated at the point in the protocol where the counterparty provides them.
714 pub extern "C" fn ChannelTransactionParameters_get_counterparty_parameters(this_ptr: &ChannelTransactionParameters) -> crate::lightning::ln::chan_utils::CounterpartyChannelTransactionParameters {
715 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.counterparty_parameters;
716 let mut local_inner_val = crate::lightning::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 };
719 /// The late-bound counterparty channel transaction parameters.
720 /// These parameters are populated at the point in the protocol where the counterparty provides them.
722 pub extern "C" fn ChannelTransactionParameters_set_counterparty_parameters(this_ptr: &mut ChannelTransactionParameters, mut val: crate::lightning::ln::chan_utils::CounterpartyChannelTransactionParameters) {
723 let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
724 unsafe { &mut *this_ptr.inner }.counterparty_parameters = local_val;
726 /// The late-bound funding outpoint
728 pub extern "C" fn ChannelTransactionParameters_get_funding_outpoint(this_ptr: &ChannelTransactionParameters) -> crate::lightning::chain::transaction::OutPoint {
729 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.funding_outpoint;
730 let mut local_inner_val = crate::lightning::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 };
733 /// The late-bound funding outpoint
735 pub extern "C" fn ChannelTransactionParameters_set_funding_outpoint(this_ptr: &mut ChannelTransactionParameters, mut val: crate::lightning::chain::transaction::OutPoint) {
736 let mut local_val = if val.inner.is_null() { None } else { Some( { *unsafe { Box::from_raw(val.take_inner()) } }) };
737 unsafe { &mut *this_ptr.inner }.funding_outpoint = local_val;
739 /// Constructs a new ChannelTransactionParameters given each field
742 pub extern "C" fn ChannelTransactionParameters_new(mut holder_pubkeys_arg: crate::lightning::ln::chan_utils::ChannelPublicKeys, mut holder_selected_contest_delay_arg: u16, mut is_outbound_from_holder_arg: bool, mut counterparty_parameters_arg: crate::lightning::ln::chan_utils::CounterpartyChannelTransactionParameters, mut funding_outpoint_arg: crate::lightning::chain::transaction::OutPoint) -> ChannelTransactionParameters {
743 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()) } }) };
744 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()) } }) };
745 ChannelTransactionParameters { inner: Box::into_raw(Box::new(nativeChannelTransactionParameters {
746 holder_pubkeys: *unsafe { Box::from_raw(holder_pubkeys_arg.take_inner()) },
747 holder_selected_contest_delay: holder_selected_contest_delay_arg,
748 is_outbound_from_holder: is_outbound_from_holder_arg,
749 counterparty_parameters: local_counterparty_parameters_arg,
750 funding_outpoint: local_funding_outpoint_arg,
751 })), is_owned: true }
753 impl Clone for ChannelTransactionParameters {
754 fn clone(&self) -> Self {
756 inner: if <*mut nativeChannelTransactionParameters>::is_null(self.inner) { std::ptr::null_mut() } else {
757 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
763 /// Used only if an object of this type is returned as a trait impl by a method
764 pub(crate) extern "C" fn ChannelTransactionParameters_clone_void(this_ptr: *const c_void) -> *mut c_void {
765 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeChannelTransactionParameters)).clone() })) as *mut c_void
768 /// Creates a copy of the ChannelTransactionParameters
769 pub extern "C" fn ChannelTransactionParameters_clone(orig: &ChannelTransactionParameters) -> ChannelTransactionParameters {
773 use lightning::ln::chan_utils::CounterpartyChannelTransactionParameters as nativeCounterpartyChannelTransactionParametersImport;
774 type nativeCounterpartyChannelTransactionParameters = nativeCounterpartyChannelTransactionParametersImport;
776 /// Late-bound per-channel counterparty data used to build transactions.
779 pub struct CounterpartyChannelTransactionParameters {
780 /// A pointer to the opaque Rust object.
782 /// Nearly everywhere, inner must be non-null, however in places where
783 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
784 pub inner: *mut nativeCounterpartyChannelTransactionParameters,
785 /// Indicates that this is the only struct which contains the same pointer.
787 /// Rust functions which take ownership of an object provided via an argument require
788 /// this to be true and invalidate the object pointed to by inner.
792 impl Drop for CounterpartyChannelTransactionParameters {
794 if self.is_owned && !<*mut nativeCounterpartyChannelTransactionParameters>::is_null(self.inner) {
795 let _ = unsafe { Box::from_raw(self.inner) };
799 /// Frees any resources used by the CounterpartyChannelTransactionParameters, if is_owned is set and inner is non-NULL.
801 pub extern "C" fn CounterpartyChannelTransactionParameters_free(this_obj: CounterpartyChannelTransactionParameters) { }
803 /// Used only if an object of this type is returned as a trait impl by a method
804 extern "C" fn CounterpartyChannelTransactionParameters_free_void(this_ptr: *mut c_void) {
805 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeCounterpartyChannelTransactionParameters); }
808 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
809 impl CounterpartyChannelTransactionParameters {
810 pub(crate) fn take_inner(mut self) -> *mut nativeCounterpartyChannelTransactionParameters {
811 assert!(self.is_owned);
812 let ret = self.inner;
813 self.inner = std::ptr::null_mut();
817 /// Counter-party public keys
819 pub extern "C" fn CounterpartyChannelTransactionParameters_get_pubkeys(this_ptr: &CounterpartyChannelTransactionParameters) -> crate::lightning::ln::chan_utils::ChannelPublicKeys {
820 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.pubkeys;
821 crate::lightning::ln::chan_utils::ChannelPublicKeys { inner: unsafe { ( (&(*inner_val) as *const _) as *mut _) }, is_owned: false }
823 /// Counter-party public keys
825 pub extern "C" fn CounterpartyChannelTransactionParameters_set_pubkeys(this_ptr: &mut CounterpartyChannelTransactionParameters, mut val: crate::lightning::ln::chan_utils::ChannelPublicKeys) {
826 unsafe { &mut *this_ptr.inner }.pubkeys = *unsafe { Box::from_raw(val.take_inner()) };
828 /// The contest delay selected by the counterparty, which applies to holder-broadcast transactions
830 pub extern "C" fn CounterpartyChannelTransactionParameters_get_selected_contest_delay(this_ptr: &CounterpartyChannelTransactionParameters) -> u16 {
831 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.selected_contest_delay;
834 /// The contest delay selected by the counterparty, which applies to holder-broadcast transactions
836 pub extern "C" fn CounterpartyChannelTransactionParameters_set_selected_contest_delay(this_ptr: &mut CounterpartyChannelTransactionParameters, mut val: u16) {
837 unsafe { &mut *this_ptr.inner }.selected_contest_delay = val;
839 /// Constructs a new CounterpartyChannelTransactionParameters given each field
842 pub extern "C" fn CounterpartyChannelTransactionParameters_new(mut pubkeys_arg: crate::lightning::ln::chan_utils::ChannelPublicKeys, mut selected_contest_delay_arg: u16) -> CounterpartyChannelTransactionParameters {
843 CounterpartyChannelTransactionParameters { inner: Box::into_raw(Box::new(nativeCounterpartyChannelTransactionParameters {
844 pubkeys: *unsafe { Box::from_raw(pubkeys_arg.take_inner()) },
845 selected_contest_delay: selected_contest_delay_arg,
846 })), is_owned: true }
848 impl Clone for CounterpartyChannelTransactionParameters {
849 fn clone(&self) -> Self {
851 inner: if <*mut nativeCounterpartyChannelTransactionParameters>::is_null(self.inner) { std::ptr::null_mut() } else {
852 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
858 /// Used only if an object of this type is returned as a trait impl by a method
859 pub(crate) extern "C" fn CounterpartyChannelTransactionParameters_clone_void(this_ptr: *const c_void) -> *mut c_void {
860 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeCounterpartyChannelTransactionParameters)).clone() })) as *mut c_void
863 /// Creates a copy of the CounterpartyChannelTransactionParameters
864 pub extern "C" fn CounterpartyChannelTransactionParameters_clone(orig: &CounterpartyChannelTransactionParameters) -> CounterpartyChannelTransactionParameters {
867 /// Whether the late bound parameters are populated.
870 pub extern "C" fn ChannelTransactionParameters_is_populated(this_arg: &ChannelTransactionParameters) -> bool {
871 let mut ret = unsafe { &*this_arg.inner }.is_populated();
875 /// Convert the holder/counterparty parameters to broadcaster/countersignatory-organized parameters,
876 /// given that the holder is the broadcaster.
878 /// self.is_populated() must be true before calling this function.
881 pub extern "C" fn ChannelTransactionParameters_as_holder_broadcastable(this_arg: &ChannelTransactionParameters) -> crate::lightning::ln::chan_utils::DirectedChannelTransactionParameters {
882 let mut ret = unsafe { &*this_arg.inner }.as_holder_broadcastable();
883 crate::lightning::ln::chan_utils::DirectedChannelTransactionParameters { inner: Box::into_raw(Box::new(ret)), is_owned: true }
886 /// Convert the holder/counterparty parameters to broadcaster/countersignatory-organized parameters,
887 /// given that the counterparty is the broadcaster.
889 /// self.is_populated() must be true before calling this function.
892 pub extern "C" fn ChannelTransactionParameters_as_counterparty_broadcastable(this_arg: &ChannelTransactionParameters) -> crate::lightning::ln::chan_utils::DirectedChannelTransactionParameters {
893 let mut ret = unsafe { &*this_arg.inner }.as_counterparty_broadcastable();
894 crate::lightning::ln::chan_utils::DirectedChannelTransactionParameters { inner: Box::into_raw(Box::new(ret)), is_owned: true }
898 /// Serialize the CounterpartyChannelTransactionParameters object into a byte array which can be read by CounterpartyChannelTransactionParameters_read
899 pub extern "C" fn CounterpartyChannelTransactionParameters_write(obj: &CounterpartyChannelTransactionParameters) -> crate::c_types::derived::CVec_u8Z {
900 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
903 pub(crate) extern "C" fn CounterpartyChannelTransactionParameters_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
904 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeCounterpartyChannelTransactionParameters) })
907 /// Read a CounterpartyChannelTransactionParameters from a byte array, created by CounterpartyChannelTransactionParameters_write
908 pub extern "C" fn CounterpartyChannelTransactionParameters_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_CounterpartyChannelTransactionParametersDecodeErrorZ {
909 let res = crate::c_types::deserialize_obj(ser);
910 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::ln::chan_utils::CounterpartyChannelTransactionParameters { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::lightning::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
914 /// Serialize the ChannelTransactionParameters object into a byte array which can be read by ChannelTransactionParameters_read
915 pub extern "C" fn ChannelTransactionParameters_write(obj: &ChannelTransactionParameters) -> crate::c_types::derived::CVec_u8Z {
916 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
919 pub(crate) extern "C" fn ChannelTransactionParameters_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
920 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeChannelTransactionParameters) })
923 /// Read a ChannelTransactionParameters from a byte array, created by ChannelTransactionParameters_write
924 pub extern "C" fn ChannelTransactionParameters_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_ChannelTransactionParametersDecodeErrorZ {
925 let res = crate::c_types::deserialize_obj(ser);
926 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::ln::chan_utils::ChannelTransactionParameters { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::lightning::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
930 use lightning::ln::chan_utils::DirectedChannelTransactionParameters as nativeDirectedChannelTransactionParametersImport;
931 type nativeDirectedChannelTransactionParameters = nativeDirectedChannelTransactionParametersImport<'static>;
933 /// Static channel fields used to build transactions given per-commitment fields, organized by
934 /// broadcaster/countersignatory.
936 /// This is derived from the holder/counterparty-organized ChannelTransactionParameters via the
937 /// as_holder_broadcastable and as_counterparty_broadcastable functions.
940 pub struct DirectedChannelTransactionParameters {
941 /// A pointer to the opaque Rust object.
943 /// Nearly everywhere, inner must be non-null, however in places where
944 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
945 pub inner: *mut nativeDirectedChannelTransactionParameters,
946 /// Indicates that this is the only struct which contains the same pointer.
948 /// Rust functions which take ownership of an object provided via an argument require
949 /// this to be true and invalidate the object pointed to by inner.
953 impl Drop for DirectedChannelTransactionParameters {
955 if self.is_owned && !<*mut nativeDirectedChannelTransactionParameters>::is_null(self.inner) {
956 let _ = unsafe { Box::from_raw(self.inner) };
960 /// Frees any resources used by the DirectedChannelTransactionParameters, if is_owned is set and inner is non-NULL.
962 pub extern "C" fn DirectedChannelTransactionParameters_free(this_obj: DirectedChannelTransactionParameters) { }
964 /// Used only if an object of this type is returned as a trait impl by a method
965 extern "C" fn DirectedChannelTransactionParameters_free_void(this_ptr: *mut c_void) {
966 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeDirectedChannelTransactionParameters); }
969 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
970 impl DirectedChannelTransactionParameters {
971 pub(crate) fn take_inner(mut self) -> *mut nativeDirectedChannelTransactionParameters {
972 assert!(self.is_owned);
973 let ret = self.inner;
974 self.inner = std::ptr::null_mut();
978 /// Get the channel pubkeys for the broadcaster
981 pub extern "C" fn DirectedChannelTransactionParameters_broadcaster_pubkeys(this_arg: &DirectedChannelTransactionParameters) -> crate::lightning::ln::chan_utils::ChannelPublicKeys {
982 let mut ret = unsafe { &*this_arg.inner }.broadcaster_pubkeys();
983 crate::lightning::ln::chan_utils::ChannelPublicKeys { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
986 /// Get the channel pubkeys for the countersignatory
989 pub extern "C" fn DirectedChannelTransactionParameters_countersignatory_pubkeys(this_arg: &DirectedChannelTransactionParameters) -> crate::lightning::ln::chan_utils::ChannelPublicKeys {
990 let mut ret = unsafe { &*this_arg.inner }.countersignatory_pubkeys();
991 crate::lightning::ln::chan_utils::ChannelPublicKeys { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
994 /// Get the contest delay applicable to the transactions.
995 /// Note that the contest delay was selected by the countersignatory.
998 pub extern "C" fn DirectedChannelTransactionParameters_contest_delay(this_arg: &DirectedChannelTransactionParameters) -> u16 {
999 let mut ret = unsafe { &*this_arg.inner }.contest_delay();
1003 /// Whether the channel is outbound from the broadcaster.
1005 /// The boolean representing the side that initiated the channel is
1006 /// an input to the commitment number obscure factor computation.
1009 pub extern "C" fn DirectedChannelTransactionParameters_is_outbound(this_arg: &DirectedChannelTransactionParameters) -> bool {
1010 let mut ret = unsafe { &*this_arg.inner }.is_outbound();
1014 /// The funding outpoint
1017 pub extern "C" fn DirectedChannelTransactionParameters_funding_outpoint(this_arg: &DirectedChannelTransactionParameters) -> crate::lightning::chain::transaction::OutPoint {
1018 let mut ret = unsafe { &*this_arg.inner }.funding_outpoint();
1019 crate::c_types::bitcoin_to_C_outpoint(ret)
1023 use lightning::ln::chan_utils::HolderCommitmentTransaction as nativeHolderCommitmentTransactionImport;
1024 type nativeHolderCommitmentTransaction = nativeHolderCommitmentTransactionImport;
1026 /// Information needed to build and sign a holder's commitment transaction.
1028 /// The transaction is only signed once we are ready to broadcast.
1031 pub struct HolderCommitmentTransaction {
1032 /// A pointer to the opaque Rust object.
1034 /// Nearly everywhere, inner must be non-null, however in places where
1035 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
1036 pub inner: *mut nativeHolderCommitmentTransaction,
1037 /// Indicates that this is the only struct which contains the same pointer.
1039 /// Rust functions which take ownership of an object provided via an argument require
1040 /// this to be true and invalidate the object pointed to by inner.
1044 impl Drop for HolderCommitmentTransaction {
1045 fn drop(&mut self) {
1046 if self.is_owned && !<*mut nativeHolderCommitmentTransaction>::is_null(self.inner) {
1047 let _ = unsafe { Box::from_raw(self.inner) };
1051 /// Frees any resources used by the HolderCommitmentTransaction, if is_owned is set and inner is non-NULL.
1053 pub extern "C" fn HolderCommitmentTransaction_free(this_obj: HolderCommitmentTransaction) { }
1055 /// Used only if an object of this type is returned as a trait impl by a method
1056 extern "C" fn HolderCommitmentTransaction_free_void(this_ptr: *mut c_void) {
1057 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeHolderCommitmentTransaction); }
1060 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
1061 impl HolderCommitmentTransaction {
1062 pub(crate) fn take_inner(mut self) -> *mut nativeHolderCommitmentTransaction {
1063 assert!(self.is_owned);
1064 let ret = self.inner;
1065 self.inner = std::ptr::null_mut();
1069 /// Our counterparty's signature for the transaction
1071 pub extern "C" fn HolderCommitmentTransaction_get_counterparty_sig(this_ptr: &HolderCommitmentTransaction) -> crate::c_types::Signature {
1072 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.counterparty_sig;
1073 crate::c_types::Signature::from_rust(&inner_val)
1075 /// Our counterparty's signature for the transaction
1077 pub extern "C" fn HolderCommitmentTransaction_set_counterparty_sig(this_ptr: &mut HolderCommitmentTransaction, mut val: crate::c_types::Signature) {
1078 unsafe { &mut *this_ptr.inner }.counterparty_sig = val.into_rust();
1080 /// All non-dust counterparty HTLC signatures, in the order they appear in the transaction
1082 pub extern "C" fn HolderCommitmentTransaction_set_counterparty_htlc_sigs(this_ptr: &mut HolderCommitmentTransaction, mut val: crate::c_types::derived::CVec_SignatureZ) {
1083 let mut local_val = Vec::new(); for mut item in val.into_rust().drain(..) { local_val.push( { item.into_rust() }); };
1084 unsafe { &mut *this_ptr.inner }.counterparty_htlc_sigs = local_val;
1086 impl Clone for HolderCommitmentTransaction {
1087 fn clone(&self) -> Self {
1089 inner: if <*mut nativeHolderCommitmentTransaction>::is_null(self.inner) { std::ptr::null_mut() } else {
1090 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
1096 /// Used only if an object of this type is returned as a trait impl by a method
1097 pub(crate) extern "C" fn HolderCommitmentTransaction_clone_void(this_ptr: *const c_void) -> *mut c_void {
1098 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeHolderCommitmentTransaction)).clone() })) as *mut c_void
1101 /// Creates a copy of the HolderCommitmentTransaction
1102 pub extern "C" fn HolderCommitmentTransaction_clone(orig: &HolderCommitmentTransaction) -> HolderCommitmentTransaction {
1106 /// Serialize the HolderCommitmentTransaction object into a byte array which can be read by HolderCommitmentTransaction_read
1107 pub extern "C" fn HolderCommitmentTransaction_write(obj: &HolderCommitmentTransaction) -> crate::c_types::derived::CVec_u8Z {
1108 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
1111 pub(crate) extern "C" fn HolderCommitmentTransaction_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
1112 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeHolderCommitmentTransaction) })
1115 /// Read a HolderCommitmentTransaction from a byte array, created by HolderCommitmentTransaction_write
1116 pub extern "C" fn HolderCommitmentTransaction_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_HolderCommitmentTransactionDecodeErrorZ {
1117 let res = crate::c_types::deserialize_obj(ser);
1118 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::ln::chan_utils::HolderCommitmentTransaction { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::lightning::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
1121 /// Create a new holder transaction with the given counterparty signatures.
1122 /// The funding keys are used to figure out which signature should go first when building the transaction for broadcast.
1125 pub extern "C" fn HolderCommitmentTransaction_new(mut commitment_tx: crate::lightning::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 {
1126 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() }); };
1127 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());
1128 HolderCommitmentTransaction { inner: Box::into_raw(Box::new(ret)), is_owned: true }
1132 use lightning::ln::chan_utils::BuiltCommitmentTransaction as nativeBuiltCommitmentTransactionImport;
1133 type nativeBuiltCommitmentTransaction = nativeBuiltCommitmentTransactionImport;
1135 /// A pre-built Bitcoin commitment transaction and its txid.
1138 pub struct BuiltCommitmentTransaction {
1139 /// A pointer to the opaque Rust object.
1141 /// Nearly everywhere, inner must be non-null, however in places where
1142 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
1143 pub inner: *mut nativeBuiltCommitmentTransaction,
1144 /// Indicates that this is the only struct which contains the same pointer.
1146 /// Rust functions which take ownership of an object provided via an argument require
1147 /// this to be true and invalidate the object pointed to by inner.
1151 impl Drop for BuiltCommitmentTransaction {
1152 fn drop(&mut self) {
1153 if self.is_owned && !<*mut nativeBuiltCommitmentTransaction>::is_null(self.inner) {
1154 let _ = unsafe { Box::from_raw(self.inner) };
1158 /// Frees any resources used by the BuiltCommitmentTransaction, if is_owned is set and inner is non-NULL.
1160 pub extern "C" fn BuiltCommitmentTransaction_free(this_obj: BuiltCommitmentTransaction) { }
1162 /// Used only if an object of this type is returned as a trait impl by a method
1163 extern "C" fn BuiltCommitmentTransaction_free_void(this_ptr: *mut c_void) {
1164 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeBuiltCommitmentTransaction); }
1167 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
1168 impl BuiltCommitmentTransaction {
1169 pub(crate) fn take_inner(mut self) -> *mut nativeBuiltCommitmentTransaction {
1170 assert!(self.is_owned);
1171 let ret = self.inner;
1172 self.inner = std::ptr::null_mut();
1176 /// The commitment transaction
1178 pub extern "C" fn BuiltCommitmentTransaction_get_transaction(this_ptr: &BuiltCommitmentTransaction) -> crate::c_types::Transaction {
1179 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.transaction;
1180 crate::c_types::Transaction::from_bitcoin(inner_val)
1182 /// The commitment transaction
1184 pub extern "C" fn BuiltCommitmentTransaction_set_transaction(this_ptr: &mut BuiltCommitmentTransaction, mut val: crate::c_types::Transaction) {
1185 unsafe { &mut *this_ptr.inner }.transaction = val.into_bitcoin();
1187 /// The txid for the commitment transaction.
1189 /// This is provided as a performance optimization, instead of calling transaction.txid()
1192 pub extern "C" fn BuiltCommitmentTransaction_get_txid(this_ptr: &BuiltCommitmentTransaction) -> *const [u8; 32] {
1193 let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.txid;
1194 inner_val.as_inner()
1196 /// The txid for the commitment transaction.
1198 /// This is provided as a performance optimization, instead of calling transaction.txid()
1201 pub extern "C" fn BuiltCommitmentTransaction_set_txid(this_ptr: &mut BuiltCommitmentTransaction, mut val: crate::c_types::ThirtyTwoBytes) {
1202 unsafe { &mut *this_ptr.inner }.txid = ::bitcoin::hash_types::Txid::from_slice(&val.data[..]).unwrap();
1204 /// Constructs a new BuiltCommitmentTransaction given each field
1207 pub extern "C" fn BuiltCommitmentTransaction_new(mut transaction_arg: crate::c_types::Transaction, mut txid_arg: crate::c_types::ThirtyTwoBytes) -> BuiltCommitmentTransaction {
1208 BuiltCommitmentTransaction { inner: Box::into_raw(Box::new(nativeBuiltCommitmentTransaction {
1209 transaction: transaction_arg.into_bitcoin(),
1210 txid: ::bitcoin::hash_types::Txid::from_slice(&txid_arg.data[..]).unwrap(),
1211 })), is_owned: true }
1213 impl Clone for BuiltCommitmentTransaction {
1214 fn clone(&self) -> Self {
1216 inner: if <*mut nativeBuiltCommitmentTransaction>::is_null(self.inner) { std::ptr::null_mut() } else {
1217 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
1223 /// Used only if an object of this type is returned as a trait impl by a method
1224 pub(crate) extern "C" fn BuiltCommitmentTransaction_clone_void(this_ptr: *const c_void) -> *mut c_void {
1225 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeBuiltCommitmentTransaction)).clone() })) as *mut c_void
1228 /// Creates a copy of the BuiltCommitmentTransaction
1229 pub extern "C" fn BuiltCommitmentTransaction_clone(orig: &BuiltCommitmentTransaction) -> BuiltCommitmentTransaction {
1233 /// Serialize the BuiltCommitmentTransaction object into a byte array which can be read by BuiltCommitmentTransaction_read
1234 pub extern "C" fn BuiltCommitmentTransaction_write(obj: &BuiltCommitmentTransaction) -> crate::c_types::derived::CVec_u8Z {
1235 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
1238 pub(crate) extern "C" fn BuiltCommitmentTransaction_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
1239 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeBuiltCommitmentTransaction) })
1242 /// Read a BuiltCommitmentTransaction from a byte array, created by BuiltCommitmentTransaction_write
1243 pub extern "C" fn BuiltCommitmentTransaction_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_BuiltCommitmentTransactionDecodeErrorZ {
1244 let res = crate::c_types::deserialize_obj(ser);
1245 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::ln::chan_utils::BuiltCommitmentTransaction { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::lightning::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
1248 /// Get the SIGHASH_ALL sighash value of the transaction.
1250 /// This can be used to verify a signature.
1253 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 {
1254 let mut ret = unsafe { &*this_arg.inner }.get_sighash_all(&::bitcoin::blockdata::script::Script::from(Vec::from(funding_redeemscript.to_slice())), channel_value_satoshis);
1255 crate::c_types::ThirtyTwoBytes { data: ret.as_ref().clone() }
1258 /// Sign a transaction, either because we are counter-signing the counterparty's transaction or
1259 /// because we are about to broadcast a holder transaction.
1262 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 {
1263 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);
1264 crate::c_types::Signature::from_rust(&ret)
1268 use lightning::ln::chan_utils::CommitmentTransaction as nativeCommitmentTransactionImport;
1269 type nativeCommitmentTransaction = nativeCommitmentTransactionImport;
1271 /// This class tracks the per-transaction information needed to build a commitment transaction and to
1272 /// actually build it and sign. It is used for holder transactions that we sign only when needed
1273 /// and for transactions we sign for the counterparty.
1275 /// This class can be used inside a signer implementation to generate a signature given the relevant
1279 pub struct CommitmentTransaction {
1280 /// A pointer to the opaque Rust object.
1282 /// Nearly everywhere, inner must be non-null, however in places where
1283 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
1284 pub inner: *mut nativeCommitmentTransaction,
1285 /// Indicates that this is the only struct which contains the same pointer.
1287 /// Rust functions which take ownership of an object provided via an argument require
1288 /// this to be true and invalidate the object pointed to by inner.
1292 impl Drop for CommitmentTransaction {
1293 fn drop(&mut self) {
1294 if self.is_owned && !<*mut nativeCommitmentTransaction>::is_null(self.inner) {
1295 let _ = unsafe { Box::from_raw(self.inner) };
1299 /// Frees any resources used by the CommitmentTransaction, if is_owned is set and inner is non-NULL.
1301 pub extern "C" fn CommitmentTransaction_free(this_obj: CommitmentTransaction) { }
1303 /// Used only if an object of this type is returned as a trait impl by a method
1304 extern "C" fn CommitmentTransaction_free_void(this_ptr: *mut c_void) {
1305 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeCommitmentTransaction); }
1308 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
1309 impl CommitmentTransaction {
1310 pub(crate) fn take_inner(mut self) -> *mut nativeCommitmentTransaction {
1311 assert!(self.is_owned);
1312 let ret = self.inner;
1313 self.inner = std::ptr::null_mut();
1317 impl Clone for CommitmentTransaction {
1318 fn clone(&self) -> Self {
1320 inner: if <*mut nativeCommitmentTransaction>::is_null(self.inner) { std::ptr::null_mut() } else {
1321 Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
1327 /// Used only if an object of this type is returned as a trait impl by a method
1328 pub(crate) extern "C" fn CommitmentTransaction_clone_void(this_ptr: *const c_void) -> *mut c_void {
1329 Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeCommitmentTransaction)).clone() })) as *mut c_void
1332 /// Creates a copy of the CommitmentTransaction
1333 pub extern "C" fn CommitmentTransaction_clone(orig: &CommitmentTransaction) -> CommitmentTransaction {
1337 /// Serialize the CommitmentTransaction object into a byte array which can be read by CommitmentTransaction_read
1338 pub extern "C" fn CommitmentTransaction_write(obj: &CommitmentTransaction) -> crate::c_types::derived::CVec_u8Z {
1339 crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
1342 pub(crate) extern "C" fn CommitmentTransaction_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
1343 crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeCommitmentTransaction) })
1346 /// Read a CommitmentTransaction from a byte array, created by CommitmentTransaction_write
1347 pub extern "C" fn CommitmentTransaction_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_CommitmentTransactionDecodeErrorZ {
1348 let res = crate::c_types::deserialize_obj(ser);
1349 let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::ln::chan_utils::CommitmentTransaction { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::lightning::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
1352 /// The backwards-counting commitment number
1355 pub extern "C" fn CommitmentTransaction_commitment_number(this_arg: &CommitmentTransaction) -> u64 {
1356 let mut ret = unsafe { &*this_arg.inner }.commitment_number();
1360 /// The value to be sent to the broadcaster
1363 pub extern "C" fn CommitmentTransaction_to_broadcaster_value_sat(this_arg: &CommitmentTransaction) -> u64 {
1364 let mut ret = unsafe { &*this_arg.inner }.to_broadcaster_value_sat();
1368 /// The value to be sent to the counterparty
1371 pub extern "C" fn CommitmentTransaction_to_countersignatory_value_sat(this_arg: &CommitmentTransaction) -> u64 {
1372 let mut ret = unsafe { &*this_arg.inner }.to_countersignatory_value_sat();
1376 /// The feerate paid per 1000-weight-unit in this commitment transaction.
1379 pub extern "C" fn CommitmentTransaction_feerate_per_kw(this_arg: &CommitmentTransaction) -> u32 {
1380 let mut ret = unsafe { &*this_arg.inner }.feerate_per_kw();
1384 /// Trust our pre-built transaction and derived transaction creation public keys.
1386 /// Applies a wrapper which allows access to these fields.
1388 /// This should only be used if you fully trust the builder of this object. It should not
1389 ///\tbe used by an external signer - instead use the verify function.
1392 pub extern "C" fn CommitmentTransaction_trust(this_arg: &CommitmentTransaction) -> crate::lightning::ln::chan_utils::TrustedCommitmentTransaction {
1393 let mut ret = unsafe { &*this_arg.inner }.trust();
1394 crate::lightning::ln::chan_utils::TrustedCommitmentTransaction { inner: Box::into_raw(Box::new(ret)), is_owned: true }
1397 /// Verify our pre-built transaction and derived transaction creation public keys.
1399 /// Applies a wrapper which allows access to these fields.
1401 /// An external validating signer must call this method before signing
1402 /// or using the built transaction.
1405 pub extern "C" fn CommitmentTransaction_verify(this_arg: &CommitmentTransaction, channel_parameters: &crate::lightning::ln::chan_utils::DirectedChannelTransactionParameters, broadcaster_keys: &crate::lightning::ln::chan_utils::ChannelPublicKeys, countersignatory_keys: &crate::lightning::ln::chan_utils::ChannelPublicKeys) -> crate::c_types::derived::CResult_TrustedCommitmentTransactionNoneZ {
1406 let mut ret = unsafe { &*this_arg.inner }.verify(unsafe { &*channel_parameters.inner }, unsafe { &*broadcaster_keys.inner }, unsafe { &*countersignatory_keys.inner }, secp256k1::SECP256K1);
1407 let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::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() };
1412 use lightning::ln::chan_utils::TrustedCommitmentTransaction as nativeTrustedCommitmentTransactionImport;
1413 type nativeTrustedCommitmentTransaction = nativeTrustedCommitmentTransactionImport<'static>;
1415 /// A wrapper on CommitmentTransaction indicating that the derived fields (the built bitcoin
1416 /// transaction and the transaction creation keys) are trusted.
1418 /// See trust() and verify() functions on CommitmentTransaction.
1420 /// This structure implements Deref.
1423 pub struct TrustedCommitmentTransaction {
1424 /// A pointer to the opaque Rust object.
1426 /// Nearly everywhere, inner must be non-null, however in places where
1427 /// the Rust equivalent takes an Option, it may be set to null to indicate None.
1428 pub inner: *mut nativeTrustedCommitmentTransaction,
1429 /// Indicates that this is the only struct which contains the same pointer.
1431 /// Rust functions which take ownership of an object provided via an argument require
1432 /// this to be true and invalidate the object pointed to by inner.
1436 impl Drop for TrustedCommitmentTransaction {
1437 fn drop(&mut self) {
1438 if self.is_owned && !<*mut nativeTrustedCommitmentTransaction>::is_null(self.inner) {
1439 let _ = unsafe { Box::from_raw(self.inner) };
1443 /// Frees any resources used by the TrustedCommitmentTransaction, if is_owned is set and inner is non-NULL.
1445 pub extern "C" fn TrustedCommitmentTransaction_free(this_obj: TrustedCommitmentTransaction) { }
1447 /// Used only if an object of this type is returned as a trait impl by a method
1448 extern "C" fn TrustedCommitmentTransaction_free_void(this_ptr: *mut c_void) {
1449 unsafe { let _ = Box::from_raw(this_ptr as *mut nativeTrustedCommitmentTransaction); }
1452 /// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
1453 impl TrustedCommitmentTransaction {
1454 pub(crate) fn take_inner(mut self) -> *mut nativeTrustedCommitmentTransaction {
1455 assert!(self.is_owned);
1456 let ret = self.inner;
1457 self.inner = std::ptr::null_mut();
1461 /// The transaction ID of the built Bitcoin transaction
1464 pub extern "C" fn TrustedCommitmentTransaction_txid(this_arg: &TrustedCommitmentTransaction) -> crate::c_types::ThirtyTwoBytes {
1465 let mut ret = unsafe { &*this_arg.inner }.txid();
1466 crate::c_types::ThirtyTwoBytes { data: ret.into_inner() }
1469 /// The pre-built Bitcoin commitment transaction
1472 pub extern "C" fn TrustedCommitmentTransaction_built_transaction(this_arg: &TrustedCommitmentTransaction) -> crate::lightning::ln::chan_utils::BuiltCommitmentTransaction {
1473 let mut ret = unsafe { &*this_arg.inner }.built_transaction();
1474 crate::lightning::ln::chan_utils::BuiltCommitmentTransaction { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
1477 /// The pre-calculated transaction creation public keys.
1480 pub extern "C" fn TrustedCommitmentTransaction_keys(this_arg: &TrustedCommitmentTransaction) -> crate::lightning::ln::chan_utils::TxCreationKeys {
1481 let mut ret = unsafe { &*this_arg.inner }.keys();
1482 crate::lightning::ln::chan_utils::TxCreationKeys { inner: unsafe { ( (&(*ret) as *const _) as *mut _) }, is_owned: false }
1485 /// Get a signature for each HTLC which was included in the commitment transaction (ie for
1486 /// which HTLCOutputInCommitment::transaction_output_index.is_some()).
1488 /// The returned Vec has one entry for each HTLC, and in the same order.
1491 pub extern "C" fn TrustedCommitmentTransaction_get_htlc_sigs(this_arg: &TrustedCommitmentTransaction, htlc_base_key: *const [u8; 32], channel_parameters: &crate::lightning::ln::chan_utils::DirectedChannelTransactionParameters) -> crate::c_types::derived::CResult_CVec_SignatureZNoneZ {
1492 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);
1493 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() };
1497 /// Get the transaction number obscure factor
1499 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 {
1500 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);