X-Git-Url: http://git.bitcoin.ninja/index.cgi?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Forg%2Fldk%2Fstructs%2FBolt12Invoice.java;fp=src%2Fmain%2Fjava%2Forg%2Fldk%2Fstructs%2FBolt12Invoice.java;h=e9088940c002c84316aa3ffe57af35073dcfdc8f;hb=8fa2bcb208a51fa352d04981f1387d8bceced107;hp=0000000000000000000000000000000000000000;hpb=7da1092518e5ea1518255a4473c178f52549fd81;p=ldk-java diff --git a/src/main/java/org/ldk/structs/Bolt12Invoice.java b/src/main/java/org/ldk/structs/Bolt12Invoice.java new file mode 100644 index 00000000..e9088940 --- /dev/null +++ b/src/main/java/org/ldk/structs/Bolt12Invoice.java @@ -0,0 +1,157 @@ +package org.ldk.structs; + +import org.ldk.impl.bindings; +import org.ldk.enums.*; +import org.ldk.util.*; +import java.util.Arrays; +import java.lang.ref.Reference; +import javax.annotation.Nullable; + + +/** + * A `Bolt12Invoice` is a payment request, typically corresponding to an [`Offer`] or a [`Refund`]. + * + * An invoice may be sent in response to an [`InvoiceRequest`] in the case of an offer or sent + * directly after scanning a refund. It includes all the information needed to pay a recipient. + * + * [`Offer`]: crate::offers::offer::Offer + * [`Refund`]: crate::offers::refund::Refund + * [`InvoiceRequest`]: crate::offers::invoice_request::InvoiceRequest + */ +@SuppressWarnings("unchecked") // We correctly assign various generic arrays +public class Bolt12Invoice extends CommonBase { + Bolt12Invoice(Object _dummy, long ptr) { super(ptr); } + @Override @SuppressWarnings("deprecation") + protected void finalize() throws Throwable { + super.finalize(); + if (ptr != 0) { bindings.Bolt12Invoice_free(ptr); } + } + + long clone_ptr() { + long ret = bindings.Bolt12Invoice_clone_ptr(this.ptr); + Reference.reachabilityFence(this); + return ret; + } + + /** + * Creates a copy of the Bolt12Invoice + */ + public Bolt12Invoice clone() { + long ret = bindings.Bolt12Invoice_clone(this.ptr); + Reference.reachabilityFence(this); + if (ret >= 0 && ret <= 4096) { return null; } + org.ldk.structs.Bolt12Invoice ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.Bolt12Invoice(null, ret); } + if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(this); }; + return ret_hu_conv; + } + + /** + * A complete description of the purpose of the originating offer or refund. 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.Bolt12Invoice_description(this.ptr); + Reference.reachabilityFence(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.add(this); }; + return ret_hu_conv; + } + + /** + * Duration since the Unix epoch when the invoice was created. + */ + public long created_at() { + long ret = bindings.Bolt12Invoice_created_at(this.ptr); + Reference.reachabilityFence(this); + return ret; + } + + /** + * Duration since [`Bolt12Invoice::created_at`] when the invoice has expired and therefore + * should no longer be paid. + */ + public long relative_expiry() { + long ret = bindings.Bolt12Invoice_relative_expiry(this.ptr); + Reference.reachabilityFence(this); + return ret; + } + + /** + * Whether the invoice has expired. + */ + public boolean is_expired() { + boolean ret = bindings.Bolt12Invoice_is_expired(this.ptr); + Reference.reachabilityFence(this); + return ret; + } + + /** + * SHA256 hash of the payment preimage that will be given in return for paying the invoice. + */ + public byte[] payment_hash() { + byte[] ret = bindings.Bolt12Invoice_payment_hash(this.ptr); + Reference.reachabilityFence(this); + return ret; + } + + /** + * The minimum amount required for a successful payment of the invoice. + */ + public long amount_msats() { + long ret = bindings.Bolt12Invoice_amount_msats(this.ptr); + Reference.reachabilityFence(this); + return ret; + } + + /** + * Features pertaining to paying an invoice. + */ + public Bolt12InvoiceFeatures features() { + long ret = bindings.Bolt12Invoice_features(this.ptr); + Reference.reachabilityFence(this); + if (ret >= 0 && ret <= 4096) { return null; } + org.ldk.structs.Bolt12InvoiceFeatures ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.Bolt12InvoiceFeatures(null, ret); } + if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(this); }; + return ret_hu_conv; + } + + /** + * The public key corresponding to the key used to sign the invoice. + */ + public byte[] signing_pubkey() { + byte[] ret = bindings.Bolt12Invoice_signing_pubkey(this.ptr); + Reference.reachabilityFence(this); + return ret; + } + + /** + * Hash that was used for signing the invoice. + */ + public byte[] signable_hash() { + byte[] ret = bindings.Bolt12Invoice_signable_hash(this.ptr); + Reference.reachabilityFence(this); + return ret; + } + + /** + * Verifies that the invoice was for a request or refund created using the given key. + */ + public boolean verify(org.ldk.structs.ExpandedKey key) { + boolean ret = bindings.Bolt12Invoice_verify(this.ptr, key == null ? 0 : key.ptr); + Reference.reachabilityFence(this); + Reference.reachabilityFence(key); + if (this != null) { this.ptrs_to.add(key); }; + return ret; + } + + /** + * Serialize the Bolt12Invoice object into a byte array which can be read by Bolt12Invoice_read + */ + public byte[] write() { + byte[] ret = bindings.Bolt12Invoice_write(this.ptr); + Reference.reachabilityFence(this); + return ret; + } + +}