using org.ldk.impl; using org.ldk.enums; using org.ldk.util; using System; namespace org { namespace ldk { namespace structs { /** * An `Offer` is a potentially long-lived proposal for payment of a good or service. * * An offer is a precursor to an [`InvoiceRequest`]. A merchant publishes an offer from which a * customer may request an [`Bolt12Invoice`] for a specific quantity and using an amount sufficient * to cover that quantity (i.e., at least `quantity * amount`). See [`Offer::amount`]. * * Offers may be denominated in currency other than bitcoin but are ultimately paid using the * latter. * * Through the use of [`BlindedPath`]s, offers provide recipient privacy. * * [`InvoiceRequest`]: crate::offers::invoice_request::InvoiceRequest * [`Bolt12Invoice`]: crate::offers::invoice::Bolt12Invoice */ public class Offer : CommonBase { internal Offer(object _dummy, long ptr) : base(ptr) { } ~Offer() { if (ptr != 0) { bindings.Offer_free(ptr); } } internal long clone_ptr() { long ret = bindings.Offer_clone_ptr(this.ptr); GC.KeepAlive(this); return ret; } /** * Creates a copy of the Offer */ public Offer clone() { long ret = bindings.Offer_clone(this.ptr); GC.KeepAlive(this); if (ret >= 0 && ret <= 4096) { return null; } org.ldk.structs.Offer ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.Offer(null, ret); } if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); }; return ret_hu_conv; } /** * The chains that may be used when paying a requested invoice (e.g., bitcoin mainnet). * Payments must be denominated in units of the minimal lightning-payable unit (e.g., msats) * for the selected chain. */ public byte[][] chains() { long ret = bindings.Offer_chains(this.ptr); GC.KeepAlive(this); if (ret >= 0 && ret <= 4096) { return null; } int ret_conv_8_len = InternalUtils.getArrayLength(ret); byte[][] ret_conv_8_arr = new byte[ret_conv_8_len][]; for (int i = 0; i < ret_conv_8_len; i++) { long ret_conv_8 = InternalUtils.getU64ArrayElem(ret, i); byte[] ret_conv_8_conv = InternalUtils.decodeUint8Array(ret_conv_8); ret_conv_8_arr[i] = ret_conv_8_conv; } bindings.free_buffer(ret); return ret_conv_8_arr; } /** * Opaque bytes set by the originator. Useful for authentication and validating fields since it * is reflected in `invoice_request` messages along with all the other fields from the `offer`. */ public Option_CVec_u8ZZ metadata() { long ret = bindings.Offer_metadata(this.ptr); GC.KeepAlive(this); if (ret >= 0 && ret <= 4096) { return null; } org.ldk.structs.Option_CVec_u8ZZ ret_hu_conv = org.ldk.structs.Option_CVec_u8ZZ.constr_from_ptr(ret); if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); }; return ret_hu_conv; } /** * The minimum amount required for a successful payment of a single item. * * Note that the return value (or a relevant inner pointer) may be NULL or all-0s to represent None */ public Amount amount() { long ret = bindings.Offer_amount(this.ptr); GC.KeepAlive(this); if (ret >= 0 && ret <= 4096) { return null; } org.ldk.structs.Amount ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.Amount(null, ret); } if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); }; return ret_hu_conv; } /** * A complete description of the purpose of the payment. Intended to be displayed to the user * but with the caveat that it has not been verified in any way. */ public PrintableString description() { long ret = bindings.Offer_description(this.ptr); GC.KeepAlive(this); if (ret >= 0 && ret <= 4096) { return null; } org.ldk.structs.PrintableString ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.PrintableString(null, ret); } if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); }; return ret_hu_conv; } /** * Features pertaining to the offer. */ public OfferFeatures offer_features() { long ret = bindings.Offer_offer_features(this.ptr); GC.KeepAlive(this); if (ret >= 0 && ret <= 4096) { return null; } org.ldk.structs.OfferFeatures ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.OfferFeatures(null, ret); } if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); }; return ret_hu_conv; } /** * Duration since the Unix epoch when an invoice should no longer be requested. * * If `None`, the offer does not expire. */ public Option_u64Z absolute_expiry() { long ret = bindings.Offer_absolute_expiry(this.ptr); GC.KeepAlive(this); if (ret >= 0 && ret <= 4096) { return null; } org.ldk.structs.Option_u64Z ret_hu_conv = org.ldk.structs.Option_u64Z.constr_from_ptr(ret); if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); }; return ret_hu_conv; } /** * The issuer of the offer, possibly beginning with `user@domain` or `domain`. Intended to be * displayed to the user but with the caveat that it has not been verified in any way. * * Note that the return value (or a relevant inner pointer) may be NULL or all-0s to represent None */ public PrintableString issuer() { long ret = bindings.Offer_issuer(this.ptr); GC.KeepAlive(this); if (ret >= 0 && ret <= 4096) { return null; } org.ldk.structs.PrintableString ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.PrintableString(null, ret); } if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); }; return ret_hu_conv; } /** * Paths to the recipient originating from publicly reachable nodes. Blinded paths provide * recipient privacy by obfuscating its node id. */ public BlindedPath[] paths() { long ret = bindings.Offer_paths(this.ptr); GC.KeepAlive(this); if (ret >= 0 && ret <= 4096) { return null; } int ret_conv_13_len = InternalUtils.getArrayLength(ret); BlindedPath[] ret_conv_13_arr = new BlindedPath[ret_conv_13_len]; for (int n = 0; n < ret_conv_13_len; n++) { long ret_conv_13 = InternalUtils.getU64ArrayElem(ret, n); org.ldk.structs.BlindedPath ret_conv_13_hu_conv = null; if (ret_conv_13 < 0 || ret_conv_13 > 4096) { ret_conv_13_hu_conv = new org.ldk.structs.BlindedPath(null, ret_conv_13); } if (ret_conv_13_hu_conv != null) { ret_conv_13_hu_conv.ptrs_to.AddLast(this); }; ret_conv_13_arr[n] = ret_conv_13_hu_conv; } bindings.free_buffer(ret); return ret_conv_13_arr; } /** * The quantity of items supported. */ public Quantity supported_quantity() { long ret = bindings.Offer_supported_quantity(this.ptr); GC.KeepAlive(this); if (ret >= 0 && ret <= 4096) { return null; } org.ldk.structs.Quantity ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.Quantity(null, ret); } if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); }; return ret_hu_conv; } /** * The public key used by the recipient to sign invoices. */ public byte[] signing_pubkey() { long ret = bindings.Offer_signing_pubkey(this.ptr); GC.KeepAlive(this); if (ret >= 0 && ret <= 4096) { return null; } byte[] ret_conv = InternalUtils.decodeUint8Array(ret); return ret_conv; } /** * Returns whether the given chain is supported by the offer. */ public bool supports_chain(byte[] chain) { bool ret = bindings.Offer_supports_chain(this.ptr, InternalUtils.encodeUint8Array(InternalUtils.check_arr_len(chain, 32))); GC.KeepAlive(this); GC.KeepAlive(chain); return ret; } /** * Whether the offer has expired. */ public bool is_expired() { bool ret = bindings.Offer_is_expired(this.ptr); GC.KeepAlive(this); return ret; } /** * Returns whether the given quantity is valid for the offer. */ public bool is_valid_quantity(long quantity) { bool ret = bindings.Offer_is_valid_quantity(this.ptr, quantity); GC.KeepAlive(this); GC.KeepAlive(quantity); return ret; } /** * Returns whether a quantity is expected in an [`InvoiceRequest`] for the offer. * * [`InvoiceRequest`]: crate::offers::invoice_request::InvoiceRequest */ public bool expects_quantity() { bool ret = bindings.Offer_expects_quantity(this.ptr); GC.KeepAlive(this); return ret; } /** * Serialize the Offer object into a byte array which can be read by Offer_read */ public byte[] write() { long ret = bindings.Offer_write(this.ptr); GC.KeepAlive(this); if (ret >= 0 && ret <= 4096) { return null; } byte[] ret_conv = InternalUtils.decodeUint8Array(ret); return ret_conv; } /** * Read a Offer object from a string */ public static Result_OfferBolt12ParseErrorZ from_str(string s) { long ret = bindings.Offer_from_str(InternalUtils.encodeString(s)); GC.KeepAlive(s); if (ret >= 0 && ret <= 4096) { return null; } Result_OfferBolt12ParseErrorZ ret_hu_conv = Result_OfferBolt12ParseErrorZ.constr_from_ptr(ret); return ret_hu_conv; } } } } }