_ Git - ldk-c-bindings/blob - lightning-c-bindings/src/ln/chan_utils.rs

   1 // This file is Copyright its original authors, visible in version control
   2 // history and in the source files from which this was generated.
   3 //
   4 // This file is licensed under the license available in the LICENSE or LICENSE.md
   5 // file in the root of this repository or, if no such file exists, the same
   6 // license as that which applies to the original source files from which this
   7 // source was automatically generated.
   8
   9 //! 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.
  11
  12 use std::ffi::c_void;
  13 use bitcoin::hashes::Hash;
  14 use crate::c_types::*;
  15
  16 /// Build the commitment secret from the seed and the commitment number
  17 #[no_mangle]
  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 }
  21 }
  22
  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.
  25 ///
  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).
  28 #[no_mangle]
  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() };
  32         local_ret
  33 }
  34
  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.
  38 ///
  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).
  41 #[no_mangle]
  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() };
  45         local_ret
  46 }
  47
  48 /// Derives a per-commitment-transaction revocation key from its constituent parts.
  49 ///
  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.
  54 ///
  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).
  57 #[no_mangle]
  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() };
  61         local_ret
  62 }
  63
  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.
  67 ///
  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.
  72 ///
  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).
  75 #[no_mangle]
  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() };
  79         local_ret
  80 }
  81
  82
  83 use lightning::ln::chan_utils::TxCreationKeys as nativeTxCreationKeysImport;
  84 type nativeTxCreationKeys = nativeTxCreationKeysImport;
  85
  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.
  88 ///
  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
  91 /// transaction.
  92 ///
  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.
  97 #[must_use]
  98 #[repr(C)]
  99 pub struct TxCreationKeys {
 100         /// A pointer to the opaque Rust object.
 101
 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.
 106
 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.
 109         pub is_owned: bool,
 110 }
 111
 112 impl Drop for TxCreationKeys {
 113         fn drop(&mut self) {
 114                 if self.is_owned && !<*mut nativeTxCreationKeys>::is_null(self.inner) {
 115                         let _ = unsafe { Box::from_raw(self.inner) };
 116                 }
 117         }
 118 }
 119 /// Frees any resources used by the TxCreationKeys, if is_owned is set and inner is non-NULL.
 120 #[no_mangle]
 121 pub extern "C" fn TxCreationKeys_free(this_obj: TxCreationKeys) { }
 122 #[allow(unused)]
 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); }
 126 }
 127 #[allow(unused)]
 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();
 134                 ret
 135         }
 136 }
 137 /// The broadcaster's per-commitment public key which was used to derive the other keys.
 138 #[no_mangle]
 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))
 142 }
 143 /// The broadcaster's per-commitment public key which was used to derive the other keys.
 144 #[no_mangle]
 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();
 147 }
 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
 150 /// an old state.
 151 #[no_mangle]
 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))
 155 }
 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
 158 /// an old state.
 159 #[no_mangle]
 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();
 162 }
 163 /// Broadcaster's HTLC Key
 164 #[no_mangle]
 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))
 168 }
 169 /// Broadcaster's HTLC Key
 170 #[no_mangle]
 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();
 173 }
 174 /// Countersignatory's HTLC Key
 175 #[no_mangle]
 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))
 179 }
 180 /// Countersignatory's HTLC Key
 181 #[no_mangle]
 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();
 184 }
 185 /// Broadcaster's Payment Key (which isn't allowed to be spent from for some delay)
 186 #[no_mangle]
 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))
 190 }
 191 /// Broadcaster's Payment Key (which isn't allowed to be spent from for some delay)
 192 #[no_mangle]
 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();
 195 }
 196 /// Constructs a new TxCreationKeys given each field
 197 #[must_use]
 198 #[no_mangle]
 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 }
 207 }
 208 impl Clone for TxCreationKeys {
 209         fn clone(&self) -> Self {
 210                 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())) },
 213                         is_owned: true,
 214                 }
 215         }
 216 }
 217 #[allow(unused)]
 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
 221 }
 222 #[no_mangle]
 223 /// Creates a copy of the TxCreationKeys
 224 pub extern "C" fn TxCreationKeys_clone(orig: &TxCreationKeys) -> TxCreationKeys {
 225         orig.clone()
 226 }
 227 #[no_mangle]
 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 })
 231 }
 232 #[no_mangle]
 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) })
 235 }
 236 #[no_mangle]
 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() };
 241         local_res
 242 }
 243
 244 use lightning::ln::chan_utils::ChannelPublicKeys as nativeChannelPublicKeysImport;
 245 type nativeChannelPublicKeys = nativeChannelPublicKeysImport;
 246
 247 /// One counterparty's public keys which do not change over the life of a channel.
 248 #[must_use]
 249 #[repr(C)]
 250 pub struct ChannelPublicKeys {
 251         /// A pointer to the opaque Rust object.
 252
 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.
 257
 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.
 260         pub is_owned: bool,
 261 }
 262
 263 impl Drop for ChannelPublicKeys {
 264         fn drop(&mut self) {
 265                 if self.is_owned && !<*mut nativeChannelPublicKeys>::is_null(self.inner) {
 266                         let _ = unsafe { Box::from_raw(self.inner) };
 267                 }
 268         }
 269 }
 270 /// Frees any resources used by the ChannelPublicKeys, if is_owned is set and inner is non-NULL.
 271 #[no_mangle]
 272 pub extern "C" fn ChannelPublicKeys_free(this_obj: ChannelPublicKeys) { }
 273 #[allow(unused)]
 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); }
 277 }
 278 #[allow(unused)]
 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();
 285                 ret
 286         }
 287 }
 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.
 290 #[no_mangle]
 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))
 294 }
 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.
 297 #[no_mangle]
 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();
 300 }
 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
 304 /// states.
 305 #[no_mangle]
 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))
 309 }
 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
 313 /// states.
 314 #[no_mangle]
 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();
 317 }
 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.
 321 #[no_mangle]
 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))
 325 }
 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.
 329 #[no_mangle]
 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();
 332 }
 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).
 336 #[no_mangle]
 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))
 340 }
 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).
 344 #[no_mangle]
 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();
 347 }
 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.
 350 #[no_mangle]
 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))
 354 }
 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.
 357 #[no_mangle]
 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();
 360 }
 361 /// Constructs a new ChannelPublicKeys given each field
 362 #[must_use]
 363 #[no_mangle]
 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 }
 372 }
 373 impl Clone for ChannelPublicKeys {
 374         fn clone(&self) -> Self {
 375                 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())) },
 378                         is_owned: true,
 379                 }
 380         }
 381 }
 382 #[allow(unused)]
 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
 386 }
 387 #[no_mangle]
 388 /// Creates a copy of the ChannelPublicKeys
 389 pub extern "C" fn ChannelPublicKeys_clone(orig: &ChannelPublicKeys) -> ChannelPublicKeys {
 390         orig.clone()
 391 }
 392 #[no_mangle]
 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 })
 396 }
 397 #[no_mangle]
 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) })
 400 }
 401 #[no_mangle]
 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() };
 406         local_res
 407 }
 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.
 410 #[must_use]
 411 #[no_mangle]
 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() };
 415         local_ret
 416 }
 417
 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.
 420 #[must_use]
 421 #[no_mangle]
 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() };
 425         local_ret
 426 }
 427
 428 /// The maximum length of a script returned by get_revokeable_redeemscript.
 429
 430 #[no_mangle]
 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.
 435 #[no_mangle]
 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()
 439 }
 440
 441
 442 use lightning::ln::chan_utils::HTLCOutputInCommitment as nativeHTLCOutputInCommitmentImport;
 443 type nativeHTLCOutputInCommitment = nativeHTLCOutputInCommitmentImport;
 444
 445 /// Information about an HTLC as it appears in a commitment transaction
 446 #[must_use]
 447 #[repr(C)]
 448 pub struct HTLCOutputInCommitment {
 449         /// A pointer to the opaque Rust object.
 450
 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.
 455
 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.
 458         pub is_owned: bool,
 459 }
 460
 461 impl Drop for HTLCOutputInCommitment {
 462         fn drop(&mut self) {
 463                 if self.is_owned && !<*mut nativeHTLCOutputInCommitment>::is_null(self.inner) {
 464                         let _ = unsafe { Box::from_raw(self.inner) };
 465                 }
 466         }
 467 }
 468 /// Frees any resources used by the HTLCOutputInCommitment, if is_owned is set and inner is non-NULL.
 469 #[no_mangle]
 470 pub extern "C" fn HTLCOutputInCommitment_free(this_obj: HTLCOutputInCommitment) { }
 471 #[allow(unused)]
 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); }
 475 }
 476 #[allow(unused)]
 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();
 483                 ret
 484         }
 485 }
 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.
 490 #[no_mangle]
 491 pub extern "C" fn HTLCOutputInCommitment_get_offered(this_ptr: &HTLCOutputInCommitment) -> bool {
 492         let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.offered;
 493         (*inner_val)
 494 }
 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.
 499 #[no_mangle]
 500 pub extern "C" fn HTLCOutputInCommitment_set_offered(this_ptr: &mut HTLCOutputInCommitment, mut val: bool) {
 501         unsafe { &mut *this_ptr.inner }.offered = val;
 502 }
 503 /// The value, in msat, of the HTLC. The value as it appears in the commitment transaction is
 504 /// this divided by 1000.
 505 #[no_mangle]
 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;
 508         (*inner_val)
 509 }
 510 /// The value, in msat, of the HTLC. The value as it appears in the commitment transaction is
 511 /// this divided by 1000.
 512 #[no_mangle]
 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;
 515 }
 516 /// The CLTV lock-time at which this HTLC expires.
 517 #[no_mangle]
 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;
 520         (*inner_val)
 521 }
 522 /// The CLTV lock-time at which this HTLC expires.
 523 #[no_mangle]
 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;
 526 }
 527 /// The hash of the preimage which unlocks this HTLC.
 528 #[no_mangle]
 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;
 531         &(*inner_val).0
 532 }
 533 /// The hash of the preimage which unlocks this HTLC.
 534 #[no_mangle]
 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);
 537 }
 538 impl Clone for HTLCOutputInCommitment {
 539         fn clone(&self) -> Self {
 540                 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())) },
 543                         is_owned: true,
 544                 }
 545         }
 546 }
 547 #[allow(unused)]
 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
 551 }
 552 #[no_mangle]
 553 /// Creates a copy of the HTLCOutputInCommitment
 554 pub extern "C" fn HTLCOutputInCommitment_clone(orig: &HTLCOutputInCommitment) -> HTLCOutputInCommitment {
 555         orig.clone()
 556 }
 557 #[no_mangle]
 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 })
 561 }
 562 #[no_mangle]
 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) })
 565 }
 566 #[no_mangle]
 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() };
 571         local_res
 572 }
 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.
 575 #[no_mangle]
 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()
 579 }
 580
 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.
 583 #[no_mangle]
 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()
 587 }
 588
 589 /// panics if htlc.transaction_output_index.is_none()!
 590 #[no_mangle]
 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)
 595 }
 596
 597
 598 use lightning::ln::chan_utils::ChannelTransactionParameters as nativeChannelTransactionParametersImport;
 599 type nativeChannelTransactionParameters = nativeChannelTransactionParametersImport;
 600
 601 /// Per-channel data used to build transactions in conjunction with the per-commitment data (CommitmentTransaction).
 602 /// The fields are organized by holder/counterparty.
 603 ///
 604 /// Normally, this is converted to the broadcaster/countersignatory-organized DirectedChannelTransactionParameters
 605 /// before use, via the as_holder_broadcastable and as_counterparty_broadcastable functions.
 606 #[must_use]
 607 #[repr(C)]
 608 pub struct ChannelTransactionParameters {
 609         /// A pointer to the opaque Rust object.
 610
 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.
 615
 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.
 618         pub is_owned: bool,
 619 }
 620
 621 impl Drop for ChannelTransactionParameters {
 622         fn drop(&mut self) {
 623                 if self.is_owned && !<*mut nativeChannelTransactionParameters>::is_null(self.inner) {
 624                         let _ = unsafe { Box::from_raw(self.inner) };
 625                 }
 626         }
 627 }
 628 /// Frees any resources used by the ChannelTransactionParameters, if is_owned is set and inner is non-NULL.
 629 #[no_mangle]
 630 pub extern "C" fn ChannelTransactionParameters_free(this_obj: ChannelTransactionParameters) { }
 631 #[allow(unused)]
 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); }
 635 }
 636 #[allow(unused)]
 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();
 643                 ret
 644         }
 645 }
 646 /// Holder public keys
 647 #[no_mangle]
 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 }
 651 }
 652 /// Holder public keys
 653 #[no_mangle]
 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()) };
 656 }
 657 /// The contest delay selected by the holder, which applies to counterparty-broadcast transactions
 658 #[no_mangle]
 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;
 661         (*inner_val)
 662 }
 663 /// The contest delay selected by the holder, which applies to counterparty-broadcast transactions
 664 #[no_mangle]
 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;
 667 }
 668 /// Whether the holder is the initiator of this channel.
 669 /// This is an input to the commitment number obscure factor computation.
 670 #[no_mangle]
 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;
 673         (*inner_val)
 674 }
 675 /// Whether the holder is the initiator of this channel.
 676 /// This is an input to the commitment number obscure factor computation.
 677 #[no_mangle]
 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;
 680 }
 681 /// The late-bound counterparty channel transaction parameters.
 682 /// These parameters are populated at the point in the protocol where the counterparty provides them.
 683 #[no_mangle]
 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 };
 687         local_inner_val
 688 }
 689 /// The late-bound counterparty channel transaction parameters.
 690 /// These parameters are populated at the point in the protocol where the counterparty provides them.
 691 #[no_mangle]
 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;
 695 }
 696 /// The late-bound funding outpoint
 697 #[no_mangle]
 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 };
 701         local_inner_val
 702 }
 703 /// The late-bound funding outpoint
 704 #[no_mangle]
 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;
 708 }
 709 /// Constructs a new ChannelTransactionParameters given each field
 710 #[must_use]
 711 #[no_mangle]
 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 }
 722 }
 723 impl Clone for ChannelTransactionParameters {
 724         fn clone(&self) -> Self {
 725                 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())) },
 728                         is_owned: true,
 729                 }
 730         }
 731 }
 732 #[allow(unused)]
 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
 736 }
 737 #[no_mangle]
 738 /// Creates a copy of the ChannelTransactionParameters
 739 pub extern "C" fn ChannelTransactionParameters_clone(orig: &ChannelTransactionParameters) -> ChannelTransactionParameters {
 740         orig.clone()
 741 }
 742
 743 use lightning::ln::chan_utils::CounterpartyChannelTransactionParameters as nativeCounterpartyChannelTransactionParametersImport;
 744 type nativeCounterpartyChannelTransactionParameters = nativeCounterpartyChannelTransactionParametersImport;
 745
 746 /// Late-bound per-channel counterparty data used to build transactions.
 747 #[must_use]
 748 #[repr(C)]
 749 pub struct CounterpartyChannelTransactionParameters {
 750         /// A pointer to the opaque Rust object.
 751
 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.
 756
 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.
 759         pub is_owned: bool,
 760 }
 761
 762 impl Drop for CounterpartyChannelTransactionParameters {
 763         fn drop(&mut self) {
 764                 if self.is_owned && !<*mut nativeCounterpartyChannelTransactionParameters>::is_null(self.inner) {
 765                         let _ = unsafe { Box::from_raw(self.inner) };
 766                 }
 767         }
 768 }
 769 /// Frees any resources used by the CounterpartyChannelTransactionParameters, if is_owned is set and inner is non-NULL.
 770 #[no_mangle]
 771 pub extern "C" fn CounterpartyChannelTransactionParameters_free(this_obj: CounterpartyChannelTransactionParameters) { }
 772 #[allow(unused)]
 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); }
 776 }
 777 #[allow(unused)]
 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();
 784                 ret
 785         }
 786 }
 787 /// Counter-party public keys
 788 #[no_mangle]
 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 }
 792 }
 793 /// Counter-party public keys
 794 #[no_mangle]
 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()) };
 797 }
 798 /// The contest delay selected by the counterparty, which applies to holder-broadcast transactions
 799 #[no_mangle]
 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;
 802         (*inner_val)
 803 }
 804 /// The contest delay selected by the counterparty, which applies to holder-broadcast transactions
 805 #[no_mangle]
 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;
 808 }
 809 /// Constructs a new CounterpartyChannelTransactionParameters given each field
 810 #[must_use]
 811 #[no_mangle]
 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 }
 817 }
 818 impl Clone for CounterpartyChannelTransactionParameters {
 819         fn clone(&self) -> Self {
 820                 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())) },
 823                         is_owned: true,
 824                 }
 825         }
 826 }
 827 #[allow(unused)]
 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
 831 }
 832 #[no_mangle]
 833 /// Creates a copy of the CounterpartyChannelTransactionParameters
 834 pub extern "C" fn CounterpartyChannelTransactionParameters_clone(orig: &CounterpartyChannelTransactionParameters) -> CounterpartyChannelTransactionParameters {
 835         orig.clone()
 836 }
 837 /// Whether the late bound parameters are populated.
 838 #[must_use]
 839 #[no_mangle]
 840 pub extern "C" fn ChannelTransactionParameters_is_populated(this_arg: &ChannelTransactionParameters) -> bool {
 841         let mut ret = unsafe { &*this_arg.inner }.is_populated();
 842         ret
 843 }
 844
 845 /// Convert the holder/counterparty parameters to broadcaster/countersignatory-organized parameters,
 846 /// given that the holder is the broadcaster.
 847 ///
 848 /// self.is_populated() must be true before calling this function.
 849 #[must_use]
 850 #[no_mangle]
 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 }
 854 }
 855
 856 /// Convert the holder/counterparty parameters to broadcaster/countersignatory-organized parameters,
 857 /// given that the counterparty is the broadcaster.
 858 ///
 859 /// self.is_populated() must be true before calling this function.
 860 #[must_use]
 861 #[no_mangle]
 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 }
 865 }
 866
 867 #[no_mangle]
 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 })
 871 }
 872 #[no_mangle]
 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) })
 875 }
 876 #[no_mangle]
 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() };
 881         local_res
 882 }
 883 #[no_mangle]
 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 })
 887 }
 888 #[no_mangle]
 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) })
 891 }
 892 #[no_mangle]
 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() };
 897         local_res
 898 }
 899
 900 use lightning::ln::chan_utils::DirectedChannelTransactionParameters as nativeDirectedChannelTransactionParametersImport;
 901 type nativeDirectedChannelTransactionParameters = nativeDirectedChannelTransactionParametersImport<'static>;
 902
 903 /// Static channel fields used to build transactions given per-commitment fields, organized by
 904 /// broadcaster/countersignatory.
 905 ///
 906 /// This is derived from the holder/counterparty-organized ChannelTransactionParameters via the
 907 /// as_holder_broadcastable and as_counterparty_broadcastable functions.
 908 #[must_use]
 909 #[repr(C)]
 910 pub struct DirectedChannelTransactionParameters {
 911         /// A pointer to the opaque Rust object.
 912
 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.
 917
 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.
 920         pub is_owned: bool,
 921 }
 922
 923 impl Drop for DirectedChannelTransactionParameters {
 924         fn drop(&mut self) {
 925                 if self.is_owned && !<*mut nativeDirectedChannelTransactionParameters>::is_null(self.inner) {
 926                         let _ = unsafe { Box::from_raw(self.inner) };
 927                 }
 928         }
 929 }
 930 /// Frees any resources used by the DirectedChannelTransactionParameters, if is_owned is set and inner is non-NULL.
 931 #[no_mangle]
 932 pub extern "C" fn DirectedChannelTransactionParameters_free(this_obj: DirectedChannelTransactionParameters) { }
 933 #[allow(unused)]
 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); }
 937 }
 938 #[allow(unused)]
 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();
 945                 ret
 946         }
 947 }
 948 /// Get the channel pubkeys for the broadcaster
 949 #[must_use]
 950 #[no_mangle]
 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 }
 954 }
 955
 956 /// Get the channel pubkeys for the countersignatory
 957 #[must_use]
 958 #[no_mangle]
 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 }
 962 }
 963
 964 /// Get the contest delay applicable to the transactions.
 965 /// Note that the contest delay was selected by the countersignatory.
 966 #[must_use]
 967 #[no_mangle]
 968 pub extern "C" fn DirectedChannelTransactionParameters_contest_delay(this_arg: &DirectedChannelTransactionParameters) -> u16 {
 969         let mut ret = unsafe { &*this_arg.inner }.contest_delay();
 970         ret
 971 }
 972
 973 /// Whether the channel is outbound from the broadcaster.
 974 ///
 975 /// The boolean representing the side that initiated the channel is
 976 /// an input to the commitment number obscure factor computation.
 977 #[must_use]
 978 #[no_mangle]
 979 pub extern "C" fn DirectedChannelTransactionParameters_is_outbound(this_arg: &DirectedChannelTransactionParameters) -> bool {
 980         let mut ret = unsafe { &*this_arg.inner }.is_outbound();
 981         ret
 982 }
 983
 984 /// The funding outpoint
 985 #[must_use]
 986 #[no_mangle]
 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)
 990 }
 991
 992
 993 use lightning::ln::chan_utils::HolderCommitmentTransaction as nativeHolderCommitmentTransactionImport;
 994 type nativeHolderCommitmentTransaction = nativeHolderCommitmentTransactionImport;
 995
 996 /// Information needed to build and sign a holder's commitment transaction.
 997 ///
 998 /// The transaction is only signed once we are ready to broadcast.
 999 #[must_use]
1000 #[repr(C)]
1001 pub struct HolderCommitmentTransaction {
1002         /// A pointer to the opaque Rust object.
1003
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.
1008
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.
1011         pub is_owned: bool,
1012 }
1013
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) };
1018                 }
1019         }
1020 }
1021 /// Frees any resources used by the HolderCommitmentTransaction, if is_owned is set and inner is non-NULL.
1022 #[no_mangle]
1023 pub extern "C" fn HolderCommitmentTransaction_free(this_obj: HolderCommitmentTransaction) { }
1024 #[allow(unused)]
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); }
1028 }
1029 #[allow(unused)]
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();
1036                 ret
1037         }
1038 }
1039 /// Our counterparty's signature for the transaction
1040 #[no_mangle]
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))
1044 }
1045 /// Our counterparty's signature for the transaction
1046 #[no_mangle]
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();
1049 }
1050 /// All non-dust counterparty HTLC signatures, in the order they appear in the transaction
1051 #[no_mangle]
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;
1055 }
1056 impl Clone for HolderCommitmentTransaction {
1057         fn clone(&self) -> Self {
1058                 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())) },
1061                         is_owned: true,
1062                 }
1063         }
1064 }
1065 #[allow(unused)]
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
1069 }
1070 #[no_mangle]
1071 /// Creates a copy of the HolderCommitmentTransaction
1072 pub extern "C" fn HolderCommitmentTransaction_clone(orig: &HolderCommitmentTransaction) -> HolderCommitmentTransaction {
1073         orig.clone()
1074 }
1075 #[no_mangle]
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 })
1079 }
1080 #[no_mangle]
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) })
1083 }
1084 #[no_mangle]
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() };
1089         local_res
1090 }
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.
1093 #[must_use]
1094 #[no_mangle]
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 }
1099 }
1100
1101
1102 use lightning::ln::chan_utils::BuiltCommitmentTransaction as nativeBuiltCommitmentTransactionImport;
1103 type nativeBuiltCommitmentTransaction = nativeBuiltCommitmentTransactionImport;
1104
1105 /// A pre-built Bitcoin commitment transaction and its txid.
1106 #[must_use]
1107 #[repr(C)]
1108 pub struct BuiltCommitmentTransaction {
1109         /// A pointer to the opaque Rust object.
1110
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.
1115
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.
1118         pub is_owned: bool,
1119 }
1120
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) };
1125                 }
1126         }
1127 }
1128 /// Frees any resources used by the BuiltCommitmentTransaction, if is_owned is set and inner is non-NULL.
1129 #[no_mangle]
1130 pub extern "C" fn BuiltCommitmentTransaction_free(this_obj: BuiltCommitmentTransaction) { }
1131 #[allow(unused)]
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); }
1135 }
1136 #[allow(unused)]
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();
1143                 ret
1144         }
1145 }
1146 /// The commitment transaction
1147 #[no_mangle]
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)
1152 }
1153 /// The commitment transaction
1154 #[no_mangle]
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();
1157 }
1158 /// The txid for the commitment transaction.
1159 ///
1160 /// This is provided as a performance optimization, instead of calling transaction.txid()
1161 /// multiple times.
1162 #[no_mangle]
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()
1166 }
1167 /// The txid for the commitment transaction.
1168 ///
1169 /// This is provided as a performance optimization, instead of calling transaction.txid()
1170 /// multiple times.
1171 #[no_mangle]
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();
1174 }
1175 /// Constructs a new BuiltCommitmentTransaction given each field
1176 #[must_use]
1177 #[no_mangle]
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 }
1183 }
1184 impl Clone for BuiltCommitmentTransaction {
1185         fn clone(&self) -> Self {
1186                 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())) },
1189                         is_owned: true,
1190                 }
1191         }
1192 }
1193 #[allow(unused)]
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
1197 }
1198 #[no_mangle]
1199 /// Creates a copy of the BuiltCommitmentTransaction
1200 pub extern "C" fn BuiltCommitmentTransaction_clone(orig: &BuiltCommitmentTransaction) -> BuiltCommitmentTransaction {
1201         orig.clone()
1202 }
1203 #[no_mangle]
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 })
1207 }
1208 #[no_mangle]
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) })
1211 }
1212 #[no_mangle]
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() };
1217         local_res
1218 }
1219 /// Get the SIGHASH_ALL sighash value of the transaction.
1220 ///
1221 /// This can be used to verify a signature.
1222 #[must_use]
1223 #[no_mangle]
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() }
1227 }
1228
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.
1231 #[must_use]
1232 #[no_mangle]
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)
1236 }
1237
1238
1239 use lightning::ln::chan_utils::CommitmentTransaction as nativeCommitmentTransactionImport;
1240 type nativeCommitmentTransaction = nativeCommitmentTransactionImport;
1241
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.
1245 ///
1246 /// This class can be used inside a signer implementation to generate a signature given the relevant
1247 /// secret key.
1248 #[must_use]
1249 #[repr(C)]
1250 pub struct CommitmentTransaction {
1251         /// A pointer to the opaque Rust object.
1252
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.
1257
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.
1260         pub is_owned: bool,
1261 }
1262
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) };
1267                 }
1268         }
1269 }
1270 /// Frees any resources used by the CommitmentTransaction, if is_owned is set and inner is non-NULL.
1271 #[no_mangle]
1272 pub extern "C" fn CommitmentTransaction_free(this_obj: CommitmentTransaction) { }
1273 #[allow(unused)]
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); }
1277 }
1278 #[allow(unused)]
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();
1285                 ret
1286         }
1287 }
1288 impl Clone for CommitmentTransaction {
1289         fn clone(&self) -> Self {
1290                 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())) },
1293                         is_owned: true,
1294                 }
1295         }
1296 }
1297 #[allow(unused)]
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
1301 }
1302 #[no_mangle]
1303 /// Creates a copy of the CommitmentTransaction
1304 pub extern "C" fn CommitmentTransaction_clone(orig: &CommitmentTransaction) -> CommitmentTransaction {
1305         orig.clone()
1306 }
1307 #[no_mangle]
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 })
1311 }
1312 #[no_mangle]
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) })
1315 }
1316 #[no_mangle]
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() };
1321         local_res
1322 }
1323 /// The backwards-counting commitment number
1324 #[must_use]
1325 #[no_mangle]
1326 pub extern "C" fn CommitmentTransaction_commitment_number(this_arg: &CommitmentTransaction) -> u64 {
1327         let mut ret = unsafe { &*this_arg.inner }.commitment_number();
1328         ret
1329 }
1330
1331 /// The value to be sent to the broadcaster
1332 #[must_use]
1333 #[no_mangle]
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();
1336         ret
1337 }
1338
1339 /// The value to be sent to the counterparty
1340 #[must_use]
1341 #[no_mangle]
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();
1344         ret
1345 }
1346
1347 /// The feerate paid per 1000-weight-unit in this commitment transaction.
1348 #[must_use]
1349 #[no_mangle]
1350 pub extern "C" fn CommitmentTransaction_feerate_per_kw(this_arg: &CommitmentTransaction) -> u32 {
1351         let mut ret = unsafe { &*this_arg.inner }.feerate_per_kw();
1352         ret
1353 }
1354
1355 /// Trust our pre-built transaction and derived transaction creation public keys.
1356 ///
1357 /// Applies a wrapper which allows access to these fields.
1358 ///
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.
1361 #[must_use]
1362 #[no_mangle]
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 }
1366 }
1367
1368 /// Verify our pre-built transaction and derived transaction creation public keys.
1369 ///
1370 /// Applies a wrapper which allows access to these fields.
1371 ///
1372 /// An external validating signer must call this method before signing
1373 /// or using the built transaction.
1374 #[must_use]
1375 #[no_mangle]
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() };
1379         local_ret
1380 }
1381
1382
1383 use lightning::ln::chan_utils::TrustedCommitmentTransaction as nativeTrustedCommitmentTransactionImport;
1384 type nativeTrustedCommitmentTransaction = nativeTrustedCommitmentTransactionImport<'static>;
1385
1386 /// A wrapper on CommitmentTransaction indicating that the derived fields (the built bitcoin
1387 /// transaction and the transaction creation keys) are trusted.
1388 ///
1389 /// See trust() and verify() functions on CommitmentTransaction.
1390 ///
1391 /// This structure implements Deref.
1392 #[must_use]
1393 #[repr(C)]
1394 pub struct TrustedCommitmentTransaction {
1395         /// A pointer to the opaque Rust object.
1396
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.
1401
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.
1404         pub is_owned: bool,
1405 }
1406
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) };
1411                 }
1412         }
1413 }
1414 /// Frees any resources used by the TrustedCommitmentTransaction, if is_owned is set and inner is non-NULL.
1415 #[no_mangle]
1416 pub extern "C" fn TrustedCommitmentTransaction_free(this_obj: TrustedCommitmentTransaction) { }
1417 #[allow(unused)]
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); }
1421 }
1422 #[allow(unused)]
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();
1429                 ret
1430         }
1431 }
1432 /// The transaction ID of the built Bitcoin transaction
1433 #[must_use]
1434 #[no_mangle]
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() }
1438 }
1439
1440 /// The pre-built Bitcoin commitment transaction
1441 #[must_use]
1442 #[no_mangle]
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 }
1446 }
1447
1448 /// The pre-calculated transaction creation public keys.
1449 #[must_use]
1450 #[no_mangle]
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 }
1454 }
1455
1456 /// Get a signature for each HTLC which was included in the commitment transaction (ie for
1457 /// which HTLCOutputInCommitment::transaction_output_index.is_some()).
1458 ///
1459 /// The returned Vec has one entry for each HTLC, and in the same order.
1460 #[must_use]
1461 #[no_mangle]
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() };
1465         local_ret
1466 }
1467
1468 /// Get the transaction number obscure factor
1469 #[no_mangle]
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);
1472         ret
1473 }
1474