6 namespace org { namespace ldk { namespace structs {
10 * A `Refund` is a request to send an [`Bolt12Invoice`] without a preceding [`Offer`].
12 * Typically, after an invoice is paid, the recipient may publish a refund allowing the sender to
13 * recoup their funds. A refund may be used more generally as an \"offer for money\", such as with a
16 * [`Bolt12Invoice`]: crate::offers::invoice::Bolt12Invoice
17 * [`Offer`]: crate::offers::offer::Offer
19 public class Refund : CommonBase {
20 internal Refund(object _dummy, long ptr) : base(ptr) { }
22 if (ptr != 0) { bindings.Refund_free(ptr); }
25 internal long clone_ptr() {
26 long ret = bindings.Refund_clone_ptr(this.ptr);
32 * Creates a copy of the Refund
34 public Refund clone() {
35 long ret = bindings.Refund_clone(this.ptr);
37 if (ret >= 0 && ret <= 4096) { return null; }
38 org.ldk.structs.Refund ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.Refund(null, ret); }
39 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); };
44 * A complete description of the purpose of the refund. Intended to be displayed to the user
45 * but with the caveat that it has not been verified in any way.
47 public PrintableString description() {
48 long ret = bindings.Refund_description(this.ptr);
50 if (ret >= 0 && ret <= 4096) { return null; }
51 org.ldk.structs.PrintableString ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.PrintableString(null, ret); }
52 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); };
57 * Duration since the Unix epoch when an invoice should no longer be sent.
59 * If `None`, the refund does not expire.
61 public Option_DurationZ absolute_expiry() {
62 long ret = bindings.Refund_absolute_expiry(this.ptr);
64 if (ret >= 0 && ret <= 4096) { return null; }
65 org.ldk.structs.Option_DurationZ ret_hu_conv = org.ldk.structs.Option_DurationZ.constr_from_ptr(ret);
66 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); };
71 * Whether the refund has expired.
73 public bool is_expired() {
74 bool ret = bindings.Refund_is_expired(this.ptr);
80 * The issuer of the refund, possibly beginning with `user@domain` or `domain`. Intended to be
81 * displayed to the user but with the caveat that it has not been verified in any way.
83 * Note that the return value (or a relevant inner pointer) may be NULL or all-0s to represent None
85 public PrintableString issuer() {
86 long ret = bindings.Refund_issuer(this.ptr);
88 if (ret >= 0 && ret <= 4096) { return null; }
89 org.ldk.structs.PrintableString ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.PrintableString(null, ret); }
90 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); };
95 * Paths to the sender originating from publicly reachable nodes. Blinded paths provide sender
96 * privacy by obfuscating its node id.
98 public BlindedPath[] paths() {
99 long[] ret = bindings.Refund_paths(this.ptr);
101 int ret_conv_13_len = ret.Length;
102 BlindedPath[] ret_conv_13_arr = new BlindedPath[ret_conv_13_len];
103 for (int n = 0; n < ret_conv_13_len; n++) {
104 long ret_conv_13 = ret[n];
105 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); }
106 if (ret_conv_13_hu_conv != null) { ret_conv_13_hu_conv.ptrs_to.AddLast(this); };
107 ret_conv_13_arr[n] = ret_conv_13_hu_conv;
109 return ret_conv_13_arr;
113 * An unpredictable series of bytes, typically containing information about the derivation of
116 * [`payer_id`]: Self::payer_id
118 public byte[] metadata() {
119 byte[] ret = bindings.Refund_metadata(this.ptr);
125 * A chain that the refund is valid for.
127 public byte[] chain() {
128 byte[] ret = bindings.Refund_chain(this.ptr);
134 * The amount to refund in msats (i.e., the minimum lightning-payable unit for [`chain`]).
136 * [`chain`]: Self::chain
138 public long amount_msats() {
139 long ret = bindings.Refund_amount_msats(this.ptr);
145 * Features pertaining to requesting an invoice.
147 public InvoiceRequestFeatures features() {
148 long ret = bindings.Refund_features(this.ptr);
150 if (ret >= 0 && ret <= 4096) { return null; }
151 org.ldk.structs.InvoiceRequestFeatures ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.InvoiceRequestFeatures(null, ret); }
152 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); };
157 * The quantity of an item that refund is for.
159 public Option_u64Z quantity() {
160 long ret = bindings.Refund_quantity(this.ptr);
162 if (ret >= 0 && ret <= 4096) { return null; }
163 org.ldk.structs.Option_u64Z ret_hu_conv = org.ldk.structs.Option_u64Z.constr_from_ptr(ret);
164 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); };
169 * A public node id to send to in the case where there are no [`paths`]. Otherwise, a possibly
172 * [`paths`]: Self::paths
174 public byte[] payer_id() {
175 byte[] ret = bindings.Refund_payer_id(this.ptr);
181 * Payer provided note to include in the invoice.
183 * Note that the return value (or a relevant inner pointer) may be NULL or all-0s to represent None
185 public PrintableString payer_note() {
186 long ret = bindings.Refund_payer_note(this.ptr);
188 if (ret >= 0 && ret <= 4096) { return null; }
189 org.ldk.structs.PrintableString ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.PrintableString(null, ret); }
190 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); };
195 * Serialize the Refund object into a byte array which can be read by Refund_read
197 public byte[] write() {
198 byte[] ret = bindings.Refund_write(this.ptr);
204 * Read a Refund object from a string
206 public static Result_RefundBolt12ParseErrorZ from_str(string s) {
207 long ret = bindings.Refund_from_str(s);
209 if (ret >= 0 && ret <= 4096) { return null; }
210 Result_RefundBolt12ParseErrorZ ret_hu_conv = Result_RefundBolt12ParseErrorZ.constr_from_ptr(ret);