+
+
+/** An implementation of OnionMessageHandler */
+public interface OnionMessageHandlerInterface {
+ /**Handle an incoming `onion_message` message from the given peer.
+ */
+ void handle_onion_message(byte[] peer_node_id, OnionMessage msg);
+ /**Returns the next pending onion message for the peer with the given node id.
+ *
+ * Note that the return value (or a relevant inner pointer) may be NULL or all-0s to represent None
+ */
+ OnionMessage next_onion_message_for_peer(byte[] peer_node_id);
+ /**Called when a connection is established with a peer. Can be used to track which peers
+ * advertise onion message support and are online.
+ *
+ * May return an `Err(())` if the features the peer supports are not sufficient to communicate
+ * with us. Implementors should be somewhat conservative about doing so, however, as other
+ * message handlers may still wish to communicate with this peer.
+ */
+ Result_NoneNoneZ peer_connected(byte[] their_node_id, Init init, bool inbound);
+ /**Indicates a connection to the peer failed/an existing connection was lost. Allows handlers to
+ * drop and refuse to forward onion messages to this peer.
+ */
+ void peer_disconnected(byte[] their_node_id);
+ /**Gets the node feature flags which this handler itself supports. All available handlers are
+ * queried similarly and their feature flags are OR'd together to form the [`NodeFeatures`]
+ * which are broadcasted in our [`NodeAnnouncement`] message.
+ */
+ NodeFeatures provided_node_features();
+ /**Gets the init feature flags which should be sent to the given peer. All available handlers
+ * are queried similarly and their feature flags are OR'd together to form the [`InitFeatures`]
+ * which are sent in our [`Init`] message.
+ *
+ * Note that this method is called before [`Self::peer_connected`].
+ */
+ InitFeatures provided_init_features(byte[] their_node_id);
+}
+