X-Git-Url: http://git.bitcoin.ninja/index.cgi?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Forg%2Fldk%2Fstructs%2FTxCreationKeys.java;h=f976a6af8ace160b90e5008584792d6af85fc1d8;hb=f3e670e9341decac613d33fc52febf19cea32f20;hp=39849ae595abcc7920e848751c7998c5d7747501;hpb=2ed9081562d00a8645604b07629e963231d49e0f;p=ldk-java diff --git a/src/main/java/org/ldk/structs/TxCreationKeys.java b/src/main/java/org/ldk/structs/TxCreationKeys.java index 39849ae5..f976a6af 100644 --- a/src/main/java/org/ldk/structs/TxCreationKeys.java +++ b/src/main/java/org/ldk/structs/TxCreationKeys.java @@ -2,82 +2,179 @@ package org.ldk.structs; import org.ldk.impl.bindings; import org.ldk.enums.*; - +import org.ldk.util.*; +import java.util.Arrays; +import javax.annotation.Nullable; + + +/** + * The set of public keys which are used in the creation of one commitment transaction. + * These are derived from the channel base keys and per-commitment data. + * + * A broadcaster key is provided from potential broadcaster of the computed transaction. + * A countersignatory key is coming from a protocol participant unable to broadcast the + * transaction. + * + * These keys are assumed to be good, either because the code derived them from + * channel basepoints via the new function, or they were obtained via + * CommitmentTransaction.trust().keys() because we trusted the source of the + * pre-calculated keys. + */ +@SuppressWarnings("unchecked") // We correctly assign various generic arrays public class TxCreationKeys extends CommonBase { TxCreationKeys(Object _dummy, long ptr) { super(ptr); } @Override @SuppressWarnings("deprecation") protected void finalize() throws Throwable { - bindings.TxCreationKeys_free(ptr); super.finalize(); + super.finalize(); + if (ptr != 0) { bindings.TxCreationKeys_free(ptr); } + } + + /** + * The broadcaster's per-commitment public key which was used to derive the other keys. + */ + public byte[] get_per_commitment_point() { + byte[] ret = bindings.TxCreationKeys_get_per_commitment_point(this.ptr); + return ret; } - public TxCreationKeys(TxCreationKeys orig) { - super(bindings.TxCreationKeys_clone(orig == null ? 0 : orig.ptr & ~1)); - this.ptrs_to.add(orig); + /** + * The broadcaster's per-commitment public key which was used to derive the other keys. + */ + public void set_per_commitment_point(byte[] val) { + bindings.TxCreationKeys_set_per_commitment_point(this.ptr, InternalUtils.check_arr_len(val, 33)); } - public byte[] get_per_commitment_point(TxCreationKeys this_ptr) { - byte[] ret = bindings.TxCreationKeys_get_per_commitment_point(this_ptr == null ? 0 : this_ptr.ptr & ~1); - this.ptrs_to.add(this_ptr); + /** + * The revocation key which is used to allow the broadcaster of the commitment + * transaction to provide their counterparty the ability to punish them if they broadcast + * an old state. + */ + public byte[] get_revocation_key() { + byte[] ret = bindings.TxCreationKeys_get_revocation_key(this.ptr); return ret; } - public void set_per_commitment_point(TxCreationKeys this_ptr, byte[] val) { - bindings.TxCreationKeys_set_per_commitment_point(this_ptr == null ? 0 : this_ptr.ptr & ~1, val); - this.ptrs_to.add(this_ptr); + /** + * The revocation key which is used to allow the broadcaster of the commitment + * transaction to provide their counterparty the ability to punish them if they broadcast + * an old state. + */ + public void set_revocation_key(byte[] val) { + bindings.TxCreationKeys_set_revocation_key(this.ptr, InternalUtils.check_arr_len(val, 33)); } - public byte[] get_revocation_key(TxCreationKeys this_ptr) { - byte[] ret = bindings.TxCreationKeys_get_revocation_key(this_ptr == null ? 0 : this_ptr.ptr & ~1); - this.ptrs_to.add(this_ptr); + /** + * Broadcaster's HTLC Key + */ + public byte[] get_broadcaster_htlc_key() { + byte[] ret = bindings.TxCreationKeys_get_broadcaster_htlc_key(this.ptr); return ret; } - public void set_revocation_key(TxCreationKeys this_ptr, byte[] val) { - bindings.TxCreationKeys_set_revocation_key(this_ptr == null ? 0 : this_ptr.ptr & ~1, val); - this.ptrs_to.add(this_ptr); + /** + * Broadcaster's HTLC Key + */ + public void set_broadcaster_htlc_key(byte[] val) { + bindings.TxCreationKeys_set_broadcaster_htlc_key(this.ptr, InternalUtils.check_arr_len(val, 33)); } - public byte[] get_broadcaster_htlc_key(TxCreationKeys this_ptr) { - byte[] ret = bindings.TxCreationKeys_get_broadcaster_htlc_key(this_ptr == null ? 0 : this_ptr.ptr & ~1); - this.ptrs_to.add(this_ptr); + /** + * Countersignatory's HTLC Key + */ + public byte[] get_countersignatory_htlc_key() { + byte[] ret = bindings.TxCreationKeys_get_countersignatory_htlc_key(this.ptr); return ret; } - public void set_broadcaster_htlc_key(TxCreationKeys this_ptr, byte[] val) { - bindings.TxCreationKeys_set_broadcaster_htlc_key(this_ptr == null ? 0 : this_ptr.ptr & ~1, val); - this.ptrs_to.add(this_ptr); + /** + * Countersignatory's HTLC Key + */ + public void set_countersignatory_htlc_key(byte[] val) { + bindings.TxCreationKeys_set_countersignatory_htlc_key(this.ptr, InternalUtils.check_arr_len(val, 33)); + } + + /** + * Broadcaster's Payment Key (which isn't allowed to be spent from for some delay) + */ + public byte[] get_broadcaster_delayed_payment_key() { + byte[] ret = bindings.TxCreationKeys_get_broadcaster_delayed_payment_key(this.ptr); + return ret; + } + + /** + * Broadcaster's Payment Key (which isn't allowed to be spent from for some delay) + */ + public void set_broadcaster_delayed_payment_key(byte[] val) { + bindings.TxCreationKeys_set_broadcaster_delayed_payment_key(this.ptr, InternalUtils.check_arr_len(val, 33)); + } + + /** + * Constructs a new TxCreationKeys given each field + */ + public static TxCreationKeys of(byte[] per_commitment_point_arg, byte[] revocation_key_arg, byte[] broadcaster_htlc_key_arg, byte[] countersignatory_htlc_key_arg, byte[] broadcaster_delayed_payment_key_arg) { + long ret = bindings.TxCreationKeys_new(InternalUtils.check_arr_len(per_commitment_point_arg, 33), InternalUtils.check_arr_len(revocation_key_arg, 33), InternalUtils.check_arr_len(broadcaster_htlc_key_arg, 33), InternalUtils.check_arr_len(countersignatory_htlc_key_arg, 33), InternalUtils.check_arr_len(broadcaster_delayed_payment_key_arg, 33)); + if (ret >= 0 && ret <= 4096) { return null; } + TxCreationKeys ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new TxCreationKeys(null, ret); } + ret_hu_conv.ptrs_to.add(ret_hu_conv); + return ret_hu_conv; } - public byte[] get_countersignatory_htlc_key(TxCreationKeys this_ptr) { - byte[] ret = bindings.TxCreationKeys_get_countersignatory_htlc_key(this_ptr == null ? 0 : this_ptr.ptr & ~1); - this.ptrs_to.add(this_ptr); + long clone_ptr() { + long ret = bindings.TxCreationKeys_clone_ptr(this.ptr); return ret; } - public void set_countersignatory_htlc_key(TxCreationKeys this_ptr, byte[] val) { - bindings.TxCreationKeys_set_countersignatory_htlc_key(this_ptr == null ? 0 : this_ptr.ptr & ~1, val); - this.ptrs_to.add(this_ptr); + /** + * Creates a copy of the TxCreationKeys + */ + public TxCreationKeys clone() { + long ret = bindings.TxCreationKeys_clone(this.ptr); + if (ret >= 0 && ret <= 4096) { return null; } + TxCreationKeys ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new TxCreationKeys(null, ret); } + ret_hu_conv.ptrs_to.add(this); + return ret_hu_conv; } - public byte[] get_broadcaster_delayed_payment_key(TxCreationKeys this_ptr) { - byte[] ret = bindings.TxCreationKeys_get_broadcaster_delayed_payment_key(this_ptr == null ? 0 : this_ptr.ptr & ~1); - this.ptrs_to.add(this_ptr); + /** + * Serialize the TxCreationKeys object into a byte array which can be read by TxCreationKeys_read + */ + public byte[] write() { + byte[] ret = bindings.TxCreationKeys_write(this.ptr); return ret; } - public void set_broadcaster_delayed_payment_key(TxCreationKeys this_ptr, byte[] val) { - bindings.TxCreationKeys_set_broadcaster_delayed_payment_key(this_ptr == null ? 0 : this_ptr.ptr & ~1, val); - this.ptrs_to.add(this_ptr); + /** + * Read a TxCreationKeys from a byte array, created by TxCreationKeys_write + */ + public static Result_TxCreationKeysDecodeErrorZ read(byte[] ser) { + long ret = bindings.TxCreationKeys_read(ser); + if (ret >= 0 && ret <= 4096) { return null; } + Result_TxCreationKeysDecodeErrorZ ret_hu_conv = Result_TxCreationKeysDecodeErrorZ.constr_from_ptr(ret); + return ret_hu_conv; } - public TxCreationKeys(byte[] per_commitment_point_arg, byte[] revocation_key_arg, byte[] broadcaster_htlc_key_arg, byte[] countersignatory_htlc_key_arg, byte[] broadcaster_delayed_payment_key_arg) { - super(bindings.TxCreationKeys_new(per_commitment_point_arg, revocation_key_arg, broadcaster_htlc_key_arg, countersignatory_htlc_key_arg, broadcaster_delayed_payment_key_arg)); + /** + * Create per-state keys from channel base points and the per-commitment point. + * Key set is asymmetric and can't be used as part of counter-signatory set of transactions. + */ + public static Result_TxCreationKeysErrorZ derive_new(byte[] per_commitment_point, byte[] broadcaster_delayed_payment_base, byte[] broadcaster_htlc_base, byte[] countersignatory_revocation_base, byte[] countersignatory_htlc_base) { + long ret = bindings.TxCreationKeys_derive_new(InternalUtils.check_arr_len(per_commitment_point, 33), InternalUtils.check_arr_len(broadcaster_delayed_payment_base, 33), InternalUtils.check_arr_len(broadcaster_htlc_base, 33), InternalUtils.check_arr_len(countersignatory_revocation_base, 33), InternalUtils.check_arr_len(countersignatory_htlc_base, 33)); + if (ret >= 0 && ret <= 4096) { return null; } + Result_TxCreationKeysErrorZ ret_hu_conv = Result_TxCreationKeysErrorZ.constr_from_ptr(ret); + return ret_hu_conv; } - // Skipped TxCreationKeys_write - public TxCreationKeys(byte[] ser) { - super(bindings.TxCreationKeys_read(ser)); + /** + * Generate per-state keys from channel static keys. + * Key set is asymmetric and can't be used as part of counter-signatory set of transactions. + */ + public static Result_TxCreationKeysErrorZ from_channel_static_keys(byte[] per_commitment_point, ChannelPublicKeys broadcaster_keys, ChannelPublicKeys countersignatory_keys) { + long ret = bindings.TxCreationKeys_from_channel_static_keys(InternalUtils.check_arr_len(per_commitment_point, 33), broadcaster_keys == null ? 0 : broadcaster_keys.ptr & ~1, countersignatory_keys == null ? 0 : countersignatory_keys.ptr & ~1); + if (ret >= 0 && ret <= 4096) { return null; } + Result_TxCreationKeysErrorZ ret_hu_conv = Result_TxCreationKeysErrorZ.constr_from_ptr(ret); + ret_hu_conv.ptrs_to.add(broadcaster_keys); + ret_hu_conv.ptrs_to.add(countersignatory_keys); + return ret_hu_conv; } - // Skipped TxCreationKeys_derive_new }