X-Git-Url: http://git.bitcoin.ninja/index.cgi?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Forg%2Fldk%2Fstructs%2FRoutingMessageHandler.java;h=2ca68de19b287532138f53a2c56d932768532953;hb=17113550a5fefab21f39f27fbfe02646b8db53ae;hp=d1723d322e399a7b1e513db60d9740fa4d6c474d;hpb=6617245e37cf38bb294e664bade80a5dd195972c;p=ldk-java diff --git a/src/main/java/org/ldk/structs/RoutingMessageHandler.java b/src/main/java/org/ldk/structs/RoutingMessageHandler.java index d1723d32..2ca68de1 100644 --- a/src/main/java/org/ldk/structs/RoutingMessageHandler.java +++ b/src/main/java/org/ldk/structs/RoutingMessageHandler.java @@ -1,29 +1,314 @@ package org.ldk.structs; import org.ldk.impl.bindings; - import org.ldk.enums.*; +import org.ldk.util.*; +import java.util.Arrays; +/** + * A trait to describe an object which can receive routing messages. + * + * # Implementor DoS Warnings + * + * For `gossip_queries` messages there are potential DoS vectors when handling + * inbound queries. Implementors using an on-disk network graph should be aware of + * repeated disk I/O for queries accessing different parts of the network graph. + */ +@SuppressWarnings("unchecked") // We correctly assign various generic arrays public class RoutingMessageHandler extends CommonBase { - RoutingMessageHandler(Object _dummy, long ptr) { super(ptr); } - public RoutingMessageHandler(bindings.LDKRoutingMessageHandler arg) { - super(bindings.LDKRoutingMessageHandler_new(arg)); + final bindings.LDKRoutingMessageHandler bindings_instance; + RoutingMessageHandler(Object _dummy, long ptr) { super(ptr); bindings_instance = null; } + private RoutingMessageHandler(bindings.LDKRoutingMessageHandler arg, bindings.LDKMessageSendEventsProvider MessageSendEventsProvider) { + super(bindings.LDKRoutingMessageHandler_new(arg, MessageSendEventsProvider)); this.ptrs_to.add(arg); + this.ptrs_to.add(MessageSendEventsProvider); + this.bindings_instance = arg; } @Override @SuppressWarnings("deprecation") protected void finalize() throws Throwable { - bindings.RoutingMessageHandler_free(ptr); super.finalize(); - } - - // Skipped RoutingMessageHandler_handle_node_announcement - // Skipped RoutingMessageHandler_handle_channel_announcement - // Skipped RoutingMessageHandler_handle_channel_update - // Skipped RoutingMessageHandler_handle_htlc_fail_channel_update - // Skipped RoutingMessageHandler_get_next_channel_announcements - // Skipped RoutingMessageHandler_get_next_node_announcements - public boolean should_request_full_sync(byte[] node_id) { - boolean ret = bindings.RoutingMessageHandler_should_request_full_sync(this.ptr, node_id); - return ret; + if (ptr != 0) { bindings.RoutingMessageHandler_free(ptr); } super.finalize(); + } + + public static interface RoutingMessageHandlerInterface { + /** + * Handle an incoming node_announcement message, returning true if it should be forwarded on, + * false or returning an Err otherwise. + */ + Result_boolLightningErrorZ handle_node_announcement(NodeAnnouncement msg); + /** + * Handle a channel_announcement message, returning true if it should be forwarded on, false + * or returning an Err otherwise. + */ + Result_boolLightningErrorZ handle_channel_announcement(ChannelAnnouncement msg); + /** + * Handle an incoming channel_update message, returning true if it should be forwarded on, + * false or returning an Err otherwise. + */ + Result_boolLightningErrorZ handle_channel_update(ChannelUpdate msg); + /** + * Handle some updates to the route graph that we learned due to an outbound failed payment. + */ + void handle_htlc_fail_channel_update(HTLCFailChannelUpdate update); + /** + * Gets a subset of the channel announcements and updates required to dump our routing table + * to a remote node, starting at the short_channel_id indicated by starting_point and + * including the batch_amount entries immediately higher in numerical value than starting_point. + */ + ThreeTuple[] get_next_channel_announcements(long starting_point, byte batch_amount); + /** + * Gets a subset of the node announcements required to dump our routing table to a remote node, + * starting at the node *after* the provided publickey and including batch_amount entries + * immediately higher (as defined by ::cmp) than starting_point. + * If None is provided for starting_point, we start at the first node. + */ + NodeAnnouncement[] get_next_node_announcements(byte[] starting_point, byte batch_amount); + /** + * Called when a connection is established with a peer. This can be used to + * perform routing table synchronization using a strategy defined by the + * implementor. + */ + void sync_routing_table(byte[] their_node_id, Init init); + /** + * Handles the reply of a query we initiated to learn about channels + * for a given range of blocks. We can expect to receive one or more + * replies to a single query. + */ + Result_NoneLightningErrorZ handle_reply_channel_range(byte[] their_node_id, ReplyChannelRange msg); + /** + * Handles the reply of a query we initiated asking for routing gossip + * messages for a list of channels. We should receive this message when + * a node has completed its best effort to send us the pertaining routing + * gossip messages. + */ + Result_NoneLightningErrorZ handle_reply_short_channel_ids_end(byte[] their_node_id, ReplyShortChannelIdsEnd msg); + /** + * Handles when a peer asks us to send a list of short_channel_ids + * for the requested range of blocks. + */ + Result_NoneLightningErrorZ handle_query_channel_range(byte[] their_node_id, QueryChannelRange msg); + /** + * Handles when a peer asks us to send routing gossip messages for a + * list of short_channel_ids. + */ + Result_NoneLightningErrorZ handle_query_short_channel_ids(byte[] their_node_id, QueryShortChannelIds msg); + } + private static class LDKRoutingMessageHandlerHolder { RoutingMessageHandler held; } + public static RoutingMessageHandler new_impl(RoutingMessageHandlerInterface arg, MessageSendEventsProvider.MessageSendEventsProviderInterface MessageSendEventsProvider_impl) { + final LDKRoutingMessageHandlerHolder impl_holder = new LDKRoutingMessageHandlerHolder(); + impl_holder.held = new RoutingMessageHandler(new bindings.LDKRoutingMessageHandler() { + @Override public long handle_node_announcement(long msg) { + NodeAnnouncement msg_hu_conv = new NodeAnnouncement(null, msg); + Result_boolLightningErrorZ ret = arg.handle_node_announcement(msg_hu_conv); + long result = ret != null ? ret.ptr : 0; + return result; + } + @Override public long handle_channel_announcement(long msg) { + ChannelAnnouncement msg_hu_conv = new ChannelAnnouncement(null, msg); + Result_boolLightningErrorZ ret = arg.handle_channel_announcement(msg_hu_conv); + long result = ret != null ? ret.ptr : 0; + return result; + } + @Override public long handle_channel_update(long msg) { + ChannelUpdate msg_hu_conv = new ChannelUpdate(null, msg); + Result_boolLightningErrorZ ret = arg.handle_channel_update(msg_hu_conv); + long result = ret != null ? ret.ptr : 0; + return result; + } + @Override public void handle_htlc_fail_channel_update(long update) { + HTLCFailChannelUpdate update_hu_conv = HTLCFailChannelUpdate.constr_from_ptr(update); + arg.handle_htlc_fail_channel_update(update_hu_conv); + } + @Override public long[] get_next_channel_announcements(long starting_point, byte batch_amount) { + ThreeTuple[] ret = arg.get_next_channel_announcements(starting_point, batch_amount); + long[] result = Arrays.stream(ret).mapToLong(ret_conv_63 -> bindings.C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ_new(ret_conv_63.a == null ? 0 : ret_conv_63.a.ptr & ~1, ret_conv_63.b == null ? 0 : ret_conv_63.b.ptr & ~1, ret_conv_63.c == null ? 0 : ret_conv_63.c.ptr & ~1)).toArray(); + /* TODO 2 ThreeTuple */; + return result; + } + @Override public long[] get_next_node_announcements(byte[] starting_point, byte batch_amount) { + NodeAnnouncement[] ret = arg.get_next_node_announcements(starting_point, batch_amount); + long[] result = Arrays.stream(ret).mapToLong(ret_conv_18 -> ret_conv_18 == null ? 0 : ret_conv_18.ptr & ~1).toArray(); + /* TODO 2 NodeAnnouncement */; + return result; + } + @Override public void sync_routing_table(byte[] their_node_id, long init) { + Init init_hu_conv = new Init(null, init); + arg.sync_routing_table(their_node_id, init_hu_conv); + } + @Override public long handle_reply_channel_range(byte[] their_node_id, long msg) { + ReplyChannelRange msg_hu_conv = new ReplyChannelRange(null, msg); + msg_hu_conv.ptrs_to.add(this); + Result_NoneLightningErrorZ ret = arg.handle_reply_channel_range(their_node_id, msg_hu_conv); + long result = ret != null ? ret.ptr : 0; + return result; + } + @Override public long handle_reply_short_channel_ids_end(byte[] their_node_id, long msg) { + ReplyShortChannelIdsEnd msg_hu_conv = new ReplyShortChannelIdsEnd(null, msg); + msg_hu_conv.ptrs_to.add(this); + Result_NoneLightningErrorZ ret = arg.handle_reply_short_channel_ids_end(their_node_id, msg_hu_conv); + long result = ret != null ? ret.ptr : 0; + return result; + } + @Override public long handle_query_channel_range(byte[] their_node_id, long msg) { + QueryChannelRange msg_hu_conv = new QueryChannelRange(null, msg); + msg_hu_conv.ptrs_to.add(this); + Result_NoneLightningErrorZ ret = arg.handle_query_channel_range(their_node_id, msg_hu_conv); + long result = ret != null ? ret.ptr : 0; + return result; + } + @Override public long handle_query_short_channel_ids(byte[] their_node_id, long msg) { + QueryShortChannelIds msg_hu_conv = new QueryShortChannelIds(null, msg); + msg_hu_conv.ptrs_to.add(this); + Result_NoneLightningErrorZ ret = arg.handle_query_short_channel_ids(their_node_id, msg_hu_conv); + long result = ret != null ? ret.ptr : 0; + return result; + } + }, MessageSendEventsProvider.new_impl(MessageSendEventsProvider_impl).bindings_instance); + return impl_holder.held; + } + /** + * Handle an incoming node_announcement message, returning true if it should be forwarded on, + * false or returning an Err otherwise. + */ + public Result_boolLightningErrorZ handle_node_announcement(NodeAnnouncement msg) { + long ret = bindings.RoutingMessageHandler_handle_node_announcement(this.ptr, msg == null ? 0 : msg.ptr & ~1); + Result_boolLightningErrorZ ret_hu_conv = Result_boolLightningErrorZ.constr_from_ptr(ret); + this.ptrs_to.add(msg); + return ret_hu_conv; + } + + /** + * Handle a channel_announcement message, returning true if it should be forwarded on, false + * or returning an Err otherwise. + */ + public Result_boolLightningErrorZ handle_channel_announcement(ChannelAnnouncement msg) { + long ret = bindings.RoutingMessageHandler_handle_channel_announcement(this.ptr, msg == null ? 0 : msg.ptr & ~1); + Result_boolLightningErrorZ ret_hu_conv = Result_boolLightningErrorZ.constr_from_ptr(ret); + this.ptrs_to.add(msg); + return ret_hu_conv; + } + + /** + * Handle an incoming channel_update message, returning true if it should be forwarded on, + * false or returning an Err otherwise. + */ + public Result_boolLightningErrorZ handle_channel_update(ChannelUpdate msg) { + long ret = bindings.RoutingMessageHandler_handle_channel_update(this.ptr, msg == null ? 0 : msg.ptr & ~1); + Result_boolLightningErrorZ ret_hu_conv = Result_boolLightningErrorZ.constr_from_ptr(ret); + this.ptrs_to.add(msg); + return ret_hu_conv; + } + + /** + * Handle some updates to the route graph that we learned due to an outbound failed payment. + */ + public void handle_htlc_fail_channel_update(HTLCFailChannelUpdate update) { + bindings.RoutingMessageHandler_handle_htlc_fail_channel_update(this.ptr, update == null ? 0 : update.ptr & ~1); + this.ptrs_to.add(update); + } + + /** + * Gets a subset of the channel announcements and updates required to dump our routing table + * to a remote node, starting at the short_channel_id indicated by starting_point and + * including the batch_amount entries immediately higher in numerical value than starting_point. + */ + public ThreeTuple[] get_next_channel_announcements(long starting_point, byte batch_amount) { + long[] ret = bindings.RoutingMessageHandler_get_next_channel_announcements(this.ptr, starting_point, batch_amount); + ThreeTuple[] ret_conv_63_arr = new ThreeTuple[ret.length]; + for (int l = 0; l < ret.length; l++) { + long ret_conv_63 = ret[l]; + long ret_conv_63_a = bindings.LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ_get_a(ret_conv_63); + ChannelAnnouncement ret_conv_63_a_hu_conv = new ChannelAnnouncement(null, ret_conv_63_a); + ret_conv_63_a_hu_conv.ptrs_to.add(this);; + long ret_conv_63_b = bindings.LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ_get_b(ret_conv_63); + ChannelUpdate ret_conv_63_b_hu_conv = new ChannelUpdate(null, ret_conv_63_b); + ret_conv_63_b_hu_conv.ptrs_to.add(this);; + long ret_conv_63_c = bindings.LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ_get_c(ret_conv_63); + ChannelUpdate ret_conv_63_c_hu_conv = new ChannelUpdate(null, ret_conv_63_c); + ret_conv_63_c_hu_conv.ptrs_to.add(this);; + ThreeTuple ret_conv_63_conv = new ThreeTuple(ret_conv_63_a_hu_conv, ret_conv_63_b_hu_conv, ret_conv_63_c_hu_conv, () -> { + bindings.C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ_free(ret_conv_63); + }); + ret_conv_63_a_hu_conv.ptrs_to.add(ret_conv_63_conv); + ret_conv_63_b_hu_conv.ptrs_to.add(ret_conv_63_conv); + ret_conv_63_c_hu_conv.ptrs_to.add(ret_conv_63_conv); + ret_conv_63_arr[l] = ret_conv_63_conv; + } + return ret_conv_63_arr; + } + + /** + * Gets a subset of the node announcements required to dump our routing table to a remote node, + * starting at the node *after* the provided publickey and including batch_amount entries + * immediately higher (as defined by ::cmp) than starting_point. + * If None is provided for starting_point, we start at the first node. + */ + public NodeAnnouncement[] get_next_node_announcements(byte[] starting_point, byte batch_amount) { + long[] ret = bindings.RoutingMessageHandler_get_next_node_announcements(this.ptr, starting_point, batch_amount); + NodeAnnouncement[] ret_conv_18_arr = new NodeAnnouncement[ret.length]; + for (int s = 0; s < ret.length; s++) { + long ret_conv_18 = ret[s]; + NodeAnnouncement ret_conv_18_hu_conv = new NodeAnnouncement(null, ret_conv_18); + ret_conv_18_hu_conv.ptrs_to.add(this); + ret_conv_18_arr[s] = ret_conv_18_hu_conv; + } + return ret_conv_18_arr; + } + + /** + * Called when a connection is established with a peer. This can be used to + * perform routing table synchronization using a strategy defined by the + * implementor. + */ + public void sync_routing_table(byte[] their_node_id, Init init) { + bindings.RoutingMessageHandler_sync_routing_table(this.ptr, their_node_id, init == null ? 0 : init.ptr & ~1); + this.ptrs_to.add(init); + } + + /** + * Handles the reply of a query we initiated to learn about channels + * for a given range of blocks. We can expect to receive one or more + * replies to a single query. + */ + public Result_NoneLightningErrorZ handle_reply_channel_range(byte[] their_node_id, ReplyChannelRange msg) { + long ret = bindings.RoutingMessageHandler_handle_reply_channel_range(this.ptr, their_node_id, msg == null ? 0 : msg.ptr & ~1); + Result_NoneLightningErrorZ ret_hu_conv = Result_NoneLightningErrorZ.constr_from_ptr(ret); + this.ptrs_to.add(msg); + return ret_hu_conv; + } + + /** + * Handles the reply of a query we initiated asking for routing gossip + * messages for a list of channels. We should receive this message when + * a node has completed its best effort to send us the pertaining routing + * gossip messages. + */ + public Result_NoneLightningErrorZ handle_reply_short_channel_ids_end(byte[] their_node_id, ReplyShortChannelIdsEnd msg) { + long ret = bindings.RoutingMessageHandler_handle_reply_short_channel_ids_end(this.ptr, their_node_id, msg == null ? 0 : msg.ptr & ~1); + Result_NoneLightningErrorZ ret_hu_conv = Result_NoneLightningErrorZ.constr_from_ptr(ret); + this.ptrs_to.add(msg); + return ret_hu_conv; + } + + /** + * Handles when a peer asks us to send a list of short_channel_ids + * for the requested range of blocks. + */ + public Result_NoneLightningErrorZ handle_query_channel_range(byte[] their_node_id, QueryChannelRange msg) { + long ret = bindings.RoutingMessageHandler_handle_query_channel_range(this.ptr, their_node_id, msg == null ? 0 : msg.ptr & ~1); + Result_NoneLightningErrorZ ret_hu_conv = Result_NoneLightningErrorZ.constr_from_ptr(ret); + this.ptrs_to.add(msg); + return ret_hu_conv; + } + + /** + * Handles when a peer asks us to send routing gossip messages for a + * list of short_channel_ids. + */ + public Result_NoneLightningErrorZ handle_query_short_channel_ids(byte[] their_node_id, QueryShortChannelIds msg) { + long ret = bindings.RoutingMessageHandler_handle_query_short_channel_ids(this.ptr, their_node_id, msg == null ? 0 : msg.ptr & ~1); + Result_NoneLightningErrorZ ret_hu_conv = Result_NoneLightningErrorZ.constr_from_ptr(ret); + this.ptrs_to.add(msg); + return ret_hu_conv; } }