Commit latest auto-generated C bindings based on 0.0.100
[ldk-c-bindings] / lightning-c-bindings / src / lightning / ln / script.rs
diff --git a/lightning-c-bindings/src/lightning/ln/script.rs b/lightning-c-bindings/src/lightning/ln/script.rs
new file mode 100644 (file)
index 0000000..7dc4b1d
--- /dev/null
@@ -0,0 +1,239 @@
+// This file is Copyright its original authors, visible in version control
+// history and in the source files from which this was generated.
+//
+// This file is licensed under the license available in the LICENSE or LICENSE.md
+// file in the root of this repository or, if no such file exists, the same
+// license as that which applies to the original source files from which this
+// source was automatically generated.
+
+//! Abstractions for scripts used in the Lightning Network.
+
+use std::str::FromStr;
+use std::ffi::c_void;
+use bitcoin::hashes::Hash;
+use crate::c_types::*;
+
+
+use lightning::ln::script::ShutdownScript as nativeShutdownScriptImport;
+type nativeShutdownScript = nativeShutdownScriptImport;
+
+/// A script pubkey for shutting down a channel as defined by [BOLT #2].
+///
+/// [BOLT #2]: https://github.com/lightningnetwork/lightning-rfc/blob/master/02-peer-protocol.md
+#[must_use]
+#[repr(C)]
+pub struct ShutdownScript {
+       /// A pointer to the opaque Rust object.
+
+       /// Nearly everywhere, inner must be non-null, however in places where
+       /// the Rust equivalent takes an Option, it may be set to null to indicate None.
+       pub inner: *mut nativeShutdownScript,
+       /// Indicates that this is the only struct which contains the same pointer.
+
+       /// Rust functions which take ownership of an object provided via an argument require
+       /// this to be true and invalidate the object pointed to by inner.
+       pub is_owned: bool,
+}
+
+impl Drop for ShutdownScript {
+       fn drop(&mut self) {
+               if self.is_owned && !<*mut nativeShutdownScript>::is_null(self.inner) {
+                       let _ = unsafe { Box::from_raw(self.inner) };
+               }
+       }
+}
+/// Frees any resources used by the ShutdownScript, if is_owned is set and inner is non-NULL.
+#[no_mangle]
+pub extern "C" fn ShutdownScript_free(this_obj: ShutdownScript) { }
+#[allow(unused)]
+/// Used only if an object of this type is returned as a trait impl by a method
+extern "C" fn ShutdownScript_free_void(this_ptr: *mut c_void) {
+       unsafe { let _ = Box::from_raw(this_ptr as *mut nativeShutdownScript); }
+}
+#[allow(unused)]
+/// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
+impl ShutdownScript {
+       pub(crate) fn take_inner(mut self) -> *mut nativeShutdownScript {
+               assert!(self.is_owned);
+               let ret = self.inner;
+               self.inner = std::ptr::null_mut();
+               ret
+       }
+}
+impl Clone for ShutdownScript {
+       fn clone(&self) -> Self {
+               Self {
+                       inner: if <*mut nativeShutdownScript>::is_null(self.inner) { std::ptr::null_mut() } else {
+                               Box::into_raw(Box::new(unsafe { &*self.inner }.clone())) },
+                       is_owned: true,
+               }
+       }
+}
+#[allow(unused)]
+/// Used only if an object of this type is returned as a trait impl by a method
+pub(crate) extern "C" fn ShutdownScript_clone_void(this_ptr: *const c_void) -> *mut c_void {
+       Box::into_raw(Box::new(unsafe { (*(this_ptr as *mut nativeShutdownScript)).clone() })) as *mut c_void
+}
+#[no_mangle]
+/// Creates a copy of the ShutdownScript
+pub extern "C" fn ShutdownScript_clone(orig: &ShutdownScript) -> ShutdownScript {
+       orig.clone()
+}
+
+use lightning::ln::script::InvalidShutdownScript as nativeInvalidShutdownScriptImport;
+type nativeInvalidShutdownScript = nativeInvalidShutdownScriptImport;
+
+/// An error occurring when converting from [`Script`] to [`ShutdownScript`].
+#[must_use]
+#[repr(C)]
+pub struct InvalidShutdownScript {
+       /// A pointer to the opaque Rust object.
+
+       /// Nearly everywhere, inner must be non-null, however in places where
+       /// the Rust equivalent takes an Option, it may be set to null to indicate None.
+       pub inner: *mut nativeInvalidShutdownScript,
+       /// Indicates that this is the only struct which contains the same pointer.
+
+       /// Rust functions which take ownership of an object provided via an argument require
+       /// this to be true and invalidate the object pointed to by inner.
+       pub is_owned: bool,
+}
+
+impl Drop for InvalidShutdownScript {
+       fn drop(&mut self) {
+               if self.is_owned && !<*mut nativeInvalidShutdownScript>::is_null(self.inner) {
+                       let _ = unsafe { Box::from_raw(self.inner) };
+               }
+       }
+}
+/// Frees any resources used by the InvalidShutdownScript, if is_owned is set and inner is non-NULL.
+#[no_mangle]
+pub extern "C" fn InvalidShutdownScript_free(this_obj: InvalidShutdownScript) { }
+#[allow(unused)]
+/// Used only if an object of this type is returned as a trait impl by a method
+extern "C" fn InvalidShutdownScript_free_void(this_ptr: *mut c_void) {
+       unsafe { let _ = Box::from_raw(this_ptr as *mut nativeInvalidShutdownScript); }
+}
+#[allow(unused)]
+/// When moving out of the pointer, we have to ensure we aren't a reference, this makes that easy
+impl InvalidShutdownScript {
+       pub(crate) fn take_inner(mut self) -> *mut nativeInvalidShutdownScript {
+               assert!(self.is_owned);
+               let ret = self.inner;
+               self.inner = std::ptr::null_mut();
+               ret
+       }
+}
+/// The script that did not meet the requirements from [BOLT #2].
+///
+/// [BOLT #2]: https://github.com/lightningnetwork/lightning-rfc/blob/master/02-peer-protocol.md
+#[no_mangle]
+pub extern "C" fn InvalidShutdownScript_get_script(this_ptr: &InvalidShutdownScript) -> crate::c_types::u8slice {
+       let mut inner_val = &mut unsafe { &mut *this_ptr.inner }.script;
+       crate::c_types::u8slice::from_slice(&inner_val[..])
+}
+/// The script that did not meet the requirements from [BOLT #2].
+///
+/// [BOLT #2]: https://github.com/lightningnetwork/lightning-rfc/blob/master/02-peer-protocol.md
+#[no_mangle]
+pub extern "C" fn InvalidShutdownScript_set_script(this_ptr: &mut InvalidShutdownScript, mut val: crate::c_types::derived::CVec_u8Z) {
+       unsafe { &mut *this_ptr.inner }.script = ::bitcoin::blockdata::script::Script::from(val.into_rust());
+}
+/// Constructs a new InvalidShutdownScript given each field
+#[must_use]
+#[no_mangle]
+pub extern "C" fn InvalidShutdownScript_new(mut script_arg: crate::c_types::derived::CVec_u8Z) -> InvalidShutdownScript {
+       InvalidShutdownScript { inner: Box::into_raw(Box::new(nativeInvalidShutdownScript {
+               script: ::bitcoin::blockdata::script::Script::from(script_arg.into_rust()),
+       })), is_owned: true }
+}
+#[no_mangle]
+/// Serialize the ShutdownScript object into a byte array which can be read by ShutdownScript_read
+pub extern "C" fn ShutdownScript_write(obj: &ShutdownScript) -> crate::c_types::derived::CVec_u8Z {
+       crate::c_types::serialize_obj(unsafe { &*unsafe { &*obj }.inner })
+}
+#[no_mangle]
+pub(crate) extern "C" fn ShutdownScript_write_void(obj: *const c_void) -> crate::c_types::derived::CVec_u8Z {
+       crate::c_types::serialize_obj(unsafe { &*(obj as *const nativeShutdownScript) })
+}
+#[no_mangle]
+/// Read a ShutdownScript from a byte array, created by ShutdownScript_write
+pub extern "C" fn ShutdownScript_read(ser: crate::c_types::u8slice) -> crate::c_types::derived::CResult_ShutdownScriptDecodeErrorZ {
+       let res = crate::c_types::deserialize_obj(ser);
+       let mut local_res = match res { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::ln::script::ShutdownScript { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::lightning::ln::msgs::DecodeError { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
+       local_res
+}
+/// Generates a P2PKH script pubkey from the given [`PubkeyHash`].
+#[must_use]
+#[no_mangle]
+pub extern "C" fn ShutdownScript_new_p2pkh(pubkey_hash: *const [u8; 20]) -> ShutdownScript {
+       let mut ret = lightning::ln::script::ShutdownScript::new_p2pkh(&bitcoin::hash_types::PubkeyHash::from_hash(bitcoin::hashes::Hash::from_inner(unsafe { *pubkey_hash }.clone())));
+       ShutdownScript { inner: Box::into_raw(Box::new(ret)), is_owned: true }
+}
+
+/// Generates a P2SH script pubkey from the given [`ScriptHash`].
+#[must_use]
+#[no_mangle]
+pub extern "C" fn ShutdownScript_new_p2sh(script_hash: *const [u8; 20]) -> ShutdownScript {
+       let mut ret = lightning::ln::script::ShutdownScript::new_p2sh(&bitcoin::hash_types::ScriptHash::from_hash(bitcoin::hashes::Hash::from_inner(unsafe { *script_hash }.clone())));
+       ShutdownScript { inner: Box::into_raw(Box::new(ret)), is_owned: true }
+}
+
+/// Generates a P2WPKH script pubkey from the given [`WPubkeyHash`].
+#[must_use]
+#[no_mangle]
+pub extern "C" fn ShutdownScript_new_p2wpkh(pubkey_hash: *const [u8; 20]) -> ShutdownScript {
+       let mut ret = lightning::ln::script::ShutdownScript::new_p2wpkh(&bitcoin::hash_types::WPubkeyHash::from_hash(bitcoin::hashes::Hash::from_inner(unsafe { *pubkey_hash }.clone())));
+       ShutdownScript { inner: Box::into_raw(Box::new(ret)), is_owned: true }
+}
+
+/// Generates a P2WSH script pubkey from the given [`WScriptHash`].
+#[must_use]
+#[no_mangle]
+pub extern "C" fn ShutdownScript_new_p2wsh(script_hash: *const [u8; 32]) -> ShutdownScript {
+       let mut ret = lightning::ln::script::ShutdownScript::new_p2wsh(&bitcoin::hash_types::WScriptHash::from_hash(bitcoin::hashes::Hash::from_inner(unsafe { *script_hash }.clone())));
+       ShutdownScript { inner: Box::into_raw(Box::new(ret)), is_owned: true }
+}
+
+/// Generates a P2WSH script pubkey from the given segwit version and program.
+///
+/// # Errors
+///
+/// This function may return an error if `program` is invalid for the segwit `version`.
+#[must_use]
+#[no_mangle]
+pub extern "C" fn ShutdownScript_new_witness_program(mut version: u8, mut program: crate::c_types::u8slice) -> crate::c_types::derived::CResult_ShutdownScriptInvalidShutdownScriptZ {
+       let mut ret = lightning::ln::script::ShutdownScript::new_witness_program(core::num::NonZeroU8::new(version).expect("Value must be non-zero"), program.to_slice());
+       let mut local_ret = match ret { Ok(mut o) => crate::c_types::CResultTempl::ok( { crate::lightning::ln::script::ShutdownScript { inner: Box::into_raw(Box::new(o)), is_owned: true } }).into(), Err(mut e) => crate::c_types::CResultTempl::err( { crate::lightning::ln::script::InvalidShutdownScript { inner: Box::into_raw(Box::new(e)), is_owned: true } }).into() };
+       local_ret
+}
+
+/// Converts the shutdown script into the underlying [`Script`].
+#[must_use]
+#[no_mangle]
+pub extern "C" fn ShutdownScript_into_inner(mut this_arg: ShutdownScript) -> crate::c_types::derived::CVec_u8Z {
+       let mut ret = (*unsafe { Box::from_raw(this_arg.take_inner()) }).into_inner();
+       ret.into_bytes().into()
+}
+
+/// Returns the [`PublicKey`] used for a P2WPKH shutdown script if constructed directly from it.
+///
+/// Note that the return value (or a relevant inner pointer) may be NULL or all-0s to represent None
+#[must_use]
+#[no_mangle]
+pub extern "C" fn ShutdownScript_as_legacy_pubkey(this_arg: &ShutdownScript) -> crate::c_types::PublicKey {
+       let mut ret = unsafe { &*this_arg.inner }.as_legacy_pubkey();
+       let mut local_ret = if ret.is_none() { crate::c_types::PublicKey::null() } else {  { crate::c_types::PublicKey::from_rust(&(ret.unwrap())) } };
+       local_ret
+}
+
+/// Returns whether the shutdown script is compatible with the features as defined by BOLT #2.
+///
+/// Specifically, checks for compliance with feature `option_shutdown_anysegwit`.
+#[must_use]
+#[no_mangle]
+pub extern "C" fn ShutdownScript_is_compatible(this_arg: &ShutdownScript, features: &crate::lightning::ln::features::InitFeatures) -> bool {
+       let mut ret = unsafe { &*this_arg.inner }.is_compatible(unsafe { &*features.inner });
+       ret
+}
+