messenger_api.c

Go to the documentation of this file.

/*
   This file is part of GNUnet.
   Copyright (C) 2020--2024 GNUnet e.V.
 
   GNUnet is free software: you can redistribute it and/or modify it
   under the terms of the GNU Affero General Public License as published
   by the Free Software Foundation, either version 3 of the License,
   or (at your option) any later version.
 
   GNUnet is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Affero General Public License for more details.
 
   You should have received a copy of the GNU Affero General Public License
   along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
   SPDX-License-Identifier: AGPL3.0-or-later
 */
#include "gnunet_common.h"
#include "gnunet_messenger_service.h"
 
#include "gnunet-service-messenger.h"
 
#include "gnunet_reclaim_service.h"
#include "gnunet_time_lib.h"
#include "messenger_api_contact.h"
#include "messenger_api_contact_store.h"
#include "messenger_api_handle.h"
#include "messenger_api_message.h"
#include "messenger_api_message_control.h"
#include "messenger_api_message_kind.h"
#include "messenger_api_room.h"
#include "messenger_api_util.h"
 
const char*
GNUNET_MESSENGER_name_of_kind (enum GNUNET_MESSENGER_MessageKind kind)
{
  switch (kind)
  {
  case GNUNET_MESSENGER_KIND_INFO:
    return "INFO";
  case GNUNET_MESSENGER_KIND_JOIN:
    return "JOIN";
  case GNUNET_MESSENGER_KIND_LEAVE:
    return "LEAVE";
  case GNUNET_MESSENGER_KIND_NAME:
    return "NAME";
  case GNUNET_MESSENGER_KIND_KEY:
    return "KEY";
  case GNUNET_MESSENGER_KIND_PEER:
    return "PEER";
  case GNUNET_MESSENGER_KIND_ID:
    return "ID";
  case GNUNET_MESSENGER_KIND_MISS:
    return "MISS";
  case GNUNET_MESSENGER_KIND_MERGE:
    return "MERGE";
  case GNUNET_MESSENGER_KIND_REQUEST:
    return "REQUEST";
  case GNUNET_MESSENGER_KIND_INVITE:
    return "INVITE";
  case GNUNET_MESSENGER_KIND_TEXT:
    return "TEXT";
  case GNUNET_MESSENGER_KIND_FILE:
    return "FILE";
  case GNUNET_MESSENGER_KIND_PRIVATE:
    return "PRIVATE";
  case GNUNET_MESSENGER_KIND_DELETE:
    return "DELETE";
  case GNUNET_MESSENGER_KIND_CONNECTION:
    return "CONNECTION";
  case GNUNET_MESSENGER_KIND_TICKET:
    return "TICKET";
  case GNUNET_MESSENGER_KIND_TRANSCRIPT:
    return "TRANSCRIPT";
  case GNUNET_MESSENGER_KIND_TAG:
    return "TAG";
  case GNUNET_MESSENGER_KIND_SUBSCRIBE:
    return "SUBSCRIBE";
  case GNUNET_MESSENGER_KIND_TALK:
    return "TALK";
  default:
    return "UNKNOWN";
  }
}
 
 
static void
dequeue_messages_from_room (struct GNUNET_MESSENGER_Room *room);
 
static void
handle_room_open (void *cls,
                  const struct GNUNET_MESSENGER_RoomMessage *msg)
{
  struct GNUNET_MESSENGER_Handle *handle = cls;
 
  const struct GNUNET_HashCode *key = &(msg->key);
  const struct GNUNET_HashCode *prev = &(msg->previous);
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Opened room: %s\n", GNUNET_h2s (key));
 
  open_handle_room (handle, key);
 
  struct GNUNET_MESSENGER_Room *room = get_handle_room (handle, key);
 
  if (! room)
    return;
 
  update_room_last_message (room, prev);
 
  dequeue_messages_from_room (room);
}
 
 
static void
handle_room_entry (void *cls,
                   const struct GNUNET_MESSENGER_RoomMessage *msg)
{
  struct GNUNET_MESSENGER_Handle *handle = cls;
 
  const struct GNUNET_PeerIdentity *door = &(msg->door);
  const struct GNUNET_HashCode *key = &(msg->key);
  const struct GNUNET_HashCode *prev = &(msg->previous);
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Entered room: %s\n", GNUNET_h2s (key));
 
  entry_handle_room_at (handle, door, key);
 
  struct GNUNET_MESSENGER_Room *room = get_handle_room (handle, key);
 
  if (! room)
    return;
 
  update_room_last_message (room, prev);
 
  dequeue_messages_from_room (room);
}
 
 
static void
handle_room_close (void *cls,
                   const struct GNUNET_MESSENGER_RoomMessage *msg)
{
  struct GNUNET_MESSENGER_Handle *handle = cls;
 
  const struct GNUNET_HashCode *key = &(msg->key);
  const struct GNUNET_HashCode *prev = &(msg->previous);
 
  struct GNUNET_MESSENGER_Room *room = get_handle_room (handle, key);
 
  if (room)
    update_room_last_message (room, prev);
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Closed room: %s\n", GNUNET_h2s (key));
 
  close_handle_room (handle, key);
}
 
 
static void
handle_room_sync (void *cls,
                  const struct GNUNET_MESSENGER_RoomMessage *msg)
{
  struct GNUNET_MESSENGER_Handle *handle = cls;
 
  const struct GNUNET_HashCode *key = &(msg->key);
  const struct GNUNET_HashCode *prev = &(msg->previous);
 
  struct GNUNET_MESSENGER_Room *room = get_handle_room (handle, key);
 
  if (! room)
    return;
 
  update_room_last_message (room, prev);
 
  room->wait_for_sync = GNUNET_NO;
 
  dequeue_messages_from_room (room);
}
 
 
void
enqueue_message_to_room (struct GNUNET_MESSENGER_Room *room,
                         struct GNUNET_MESSENGER_Message *message,
                         struct GNUNET_MESSENGER_Message *transcript);
 
static void
handle_member_id (void *cls,
                  const struct GNUNET_MESSENGER_MemberMessage *msg)
{
  struct GNUNET_MESSENGER_Handle *handle = cls;
 
  const struct GNUNET_HashCode *key = &(msg->key);
  const struct GNUNET_ShortHashCode *id = &(msg->id);
  const uint32_t reset = msg->reset;
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Changed member id in room: %s\n",
              GNUNET_h2s (key));
 
  struct GNUNET_MESSENGER_Room *room = get_handle_room (handle, key);
 
  if (! room)
  {
    GNUNET_log (GNUNET_ERROR_TYPE_WARNING, "Room is unknown to handle: %s\n",
                GNUNET_h2s (key));
    return;
  }
 
  struct GNUNET_MESSENGER_Message *message;
  if ((! get_room_sender_id (room)) || (GNUNET_YES == reset))
  {
    set_room_sender_id (room, id);
    message = create_message_join (get_handle_key (handle));
  }
  else
    message = create_message_id (id);
 
  if (! message)
    return;
 
  enqueue_message_to_room (room, message, NULL);
}
 
 
static enum GNUNET_GenericReturnValue
check_recv_message (void *cls,
                    const struct GNUNET_MESSENGER_RecvMessage *msg)
{
  const uint16_t full_length = ntohs (msg->header.size);
 
  if (full_length < sizeof(*msg))
  {
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                "Receiving failed: Message invalid!\n");
    return GNUNET_NO;
  }
 
  const uint16_t length = full_length - sizeof(*msg);
  const char *buffer = ((const char*) msg) + sizeof(*msg);
 
  struct GNUNET_MESSENGER_Message message;
 
  if (length < get_message_kind_size (GNUNET_MESSENGER_KIND_UNKNOWN,
                                      GNUNET_YES))
  {
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                "Receiving failed: Message too short!\n");
    return GNUNET_NO;
  }
 
  if (GNUNET_YES != decode_message (&message, length, buffer, GNUNET_YES, NULL))
  {
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                "Receiving failed: Message decoding failed!\n");
    return GNUNET_NO;
  }
 
  cleanup_message (&message);
  return GNUNET_OK;
}
 
 
static void
handle_recv_message (void *cls,
                     const struct GNUNET_MESSENGER_RecvMessage *msg)
{
  struct GNUNET_MESSENGER_Handle *handle = cls;
 
  const struct GNUNET_HashCode *key = &(msg->key);
  const struct GNUNET_HashCode *sender = &(msg->sender);
  const struct GNUNET_HashCode *context = &(msg->context);
  const struct GNUNET_HashCode *hash = &(msg->hash);
 
  enum GNUNET_MESSENGER_MessageFlags flags = (
    (enum GNUNET_MESSENGER_MessageFlags) (msg->flags));
 
  const uint16_t length = ntohs (msg->header.size) - sizeof(*msg);
  const char *buffer = ((const char*) msg) + sizeof(*msg);
 
  struct GNUNET_MESSENGER_Message message;
  decode_message (&message, length, buffer, GNUNET_YES, NULL);
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Receiving message: %s\n",
              GNUNET_MESSENGER_name_of_kind (message.header.kind));
 
  struct GNUNET_MESSENGER_Room *room = get_handle_room (handle, key);
 
  if (! room)
  {
    GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Unknown room for this client: %s\n",
                GNUNET_h2s (key));
 
    goto skip_message;
  }
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
              "Raw contact from sender and context: (%s : %s)\n",
              GNUNET_h2s (sender), GNUNET_h2s_full (context));
 
  process_message_control (room->control,
                           sender,
                           context,
                           hash,
                           &message,
                           flags);
 
skip_message:
  cleanup_message (&message);
}
 
 
static void
handle_miss_message (void *cls,
                     const struct GNUNET_MESSENGER_GetMessage *msg)
{
  struct GNUNET_MESSENGER_Handle *handle = cls;
 
  const struct GNUNET_HashCode *key = &(msg->key);
  const struct GNUNET_HashCode *hash = &(msg->hash);
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Missing message in room: %s\n",
              GNUNET_h2s (hash));
 
  struct GNUNET_MESSENGER_Room *room = get_handle_room (handle, key);
 
  if (! room)
  {
    GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
                "Miss in unknown room for this client: %s\n", GNUNET_h2s (key));
    return;
  }
 
  if (! get_room_sender_id (room))
    return;
 
  struct GNUNET_MESSENGER_Message *message = create_message_request (hash);
  if (! message)
    return;
 
  enqueue_message_to_room (room, message, NULL);
}
 
 
static void
reconnect (struct GNUNET_MESSENGER_Handle *handle);
 
static void
send_open_room (struct GNUNET_MESSENGER_Handle *handle,
                struct GNUNET_MESSENGER_Room *room)
{
  GNUNET_assert ((handle) && (handle->mq) && (room));
 
  const struct GNUNET_CRYPTO_PublicKey *key = get_handle_pubkey (handle);
 
  struct GNUNET_MESSENGER_RoomMessage *msg;
  struct GNUNET_MQ_Envelope *env;
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
              "Open room (%s) by member using key: %s\n",
              GNUNET_h2s (&(room->key)),
              GNUNET_CRYPTO_public_key_to_string (key));
 
  const ssize_t len = GNUNET_CRYPTO_public_key_get_length (key);
 
  env = GNUNET_MQ_msg_extra (msg, len > 0 ? len : 0,
                             GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_OPEN);
  GNUNET_memcpy (&(msg->key), &(room->key), sizeof(msg->key));
  GNUNET_memcpy (&(msg->previous), &(room->last_message),
                 sizeof(msg->previous));
 
  char *msg_buffer = ((char*) msg) + sizeof(*msg);
 
  if (len > 0)
    GNUNET_CRYPTO_write_public_key_to_buffer (key, msg_buffer, len);
 
  GNUNET_MQ_send (handle->mq, env);
}
 
 
static void
send_enter_room (struct GNUNET_MESSENGER_Handle *handle,
                 struct GNUNET_MESSENGER_Room *room,
                 const struct GNUNET_PeerIdentity *door)
{
  GNUNET_assert ((handle) && (handle->mq) && (room) && (door));
 
  const struct GNUNET_CRYPTO_PublicKey *key = get_handle_pubkey (handle);
 
  struct GNUNET_MESSENGER_RoomMessage *msg;
  struct GNUNET_MQ_Envelope *env;
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Enter room (%s) via door: %s (%s)\n",
              GNUNET_h2s (&(room->key)),
              GNUNET_i2s (door),
              GNUNET_CRYPTO_public_key_to_string (key));
 
  const ssize_t len = GNUNET_CRYPTO_public_key_get_length (key);
 
  env = GNUNET_MQ_msg_extra (msg, len > 0 ? len : 0,
                             GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_ENTRY);
  GNUNET_memcpy (&(msg->door), door, sizeof(*door));
  GNUNET_memcpy (&(msg->key), &(room->key), sizeof(msg->key));
  GNUNET_memcpy (&(msg->previous), &(room->last_message),
                 sizeof(msg->previous));
 
  char *msg_buffer = ((char*) msg) + sizeof(*msg);
 
  if (len > 0)
    GNUNET_CRYPTO_write_public_key_to_buffer (key, msg_buffer, len);
 
  GNUNET_MQ_send (handle->mq, env);
}
 
 
static void
send_close_room (struct GNUNET_MESSENGER_Handle *handle,
                 struct GNUNET_MESSENGER_Room *room)
{
  GNUNET_assert ((handle) && (handle->mq) && (room));
 
  struct GNUNET_MESSENGER_RoomMessage *msg;
  struct GNUNET_MQ_Envelope *env;
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Close room (%s)!\n",
              GNUNET_h2s (&(room->key)));
 
  env = GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_CLOSE);
 
  GNUNET_memcpy (&(msg->key), &(room->key), sizeof(msg->key));
  GNUNET_memcpy (&(msg->previous), &(room->last_message),
                 sizeof(msg->previous));
 
  GNUNET_MQ_send (handle->mq, env);
}
 
 
static void
send_sync_room (struct GNUNET_MESSENGER_Handle *handle,
                struct GNUNET_MESSENGER_Room *room)
{
  GNUNET_assert ((handle) && (handle->mq) && (room));
 
  struct GNUNET_MESSENGER_RoomMessage *msg;
  struct GNUNET_MQ_Envelope *env;
 
  room->wait_for_sync = GNUNET_YES;
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Sync room (%s)!\n",
              GNUNET_h2s (&(room->key)));
 
  env = GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_SYNC);
 
  GNUNET_memcpy (&(msg->key), &(room->key), sizeof(msg->key));
  GNUNET_memcpy (&(msg->previous), &(room->last_message),
                 sizeof(msg->previous));
 
  GNUNET_MQ_send (handle->mq, env);
}
 
 
static enum GNUNET_GenericReturnValue
iterate_reset_room (void *cls,
                    const struct GNUNET_HashCode *key,
                    void *value)
{
  struct GNUNET_MESSENGER_Handle *handle = cls;
  struct GNUNET_MESSENGER_Room *room = value;
 
  if (GNUNET_YES == room->opened)
    send_open_room (handle, room);
 
  struct GNUNET_MESSENGER_ListTunnel *entry = room->entries.head;
 
  struct GNUNET_PeerIdentity door;
 
  while (entry)
  {
    GNUNET_PEER_resolve (entry->peer, &door);
 
    send_enter_room (handle, room, &door);
 
    entry = entry->next;
  }
 
  return GNUNET_YES;
}
 
 
static void
callback_reconnect (void *cls)
{
  struct GNUNET_MESSENGER_Handle *handle = cls;
 
  handle->reconnect_task = NULL;
  handle->reconnect_time = GNUNET_TIME_STD_BACKOFF (handle->reconnect_time);
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Reconnect messenger!\n");
 
  reconnect (handle);
 
  GNUNET_CONTAINER_multihashmap_iterate (handle->rooms, iterate_reset_room,
                                         handle);
}
 
 
static enum GNUNET_GenericReturnValue
iterate_close_room (void *cls,
                    const struct GNUNET_HashCode *key,
                    void *value)
{
  struct GNUNET_MESSENGER_Handle *handle = cls;
  struct GNUNET_MESSENGER_Room *room = value;
 
  send_close_room (handle, room);
 
  return GNUNET_YES;
}
 
 
static void
callback_mq_error (void *cls,
                   enum GNUNET_MQ_Error error)
{
  struct GNUNET_MESSENGER_Handle *handle = cls;
 
  GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "MQ_Error: %u\n", error);
 
  GNUNET_CONTAINER_multihashmap_iterate (handle->rooms, iterate_close_room,
                                         handle);
 
  if (handle->mq)
  {
    GNUNET_MQ_destroy (handle->mq);
    handle->mq = NULL;
  }
 
  handle->reconnect_task = GNUNET_SCHEDULER_add_delayed (handle->reconnect_time,
                                                         &callback_reconnect,
                                                         handle);
}
 
 
static void
reconnect (struct GNUNET_MESSENGER_Handle *handle)
{
  const struct GNUNET_MQ_MessageHandler handlers[] = {
    GNUNET_MQ_hd_fixed_size (
      member_id,
      GNUNET_MESSAGE_TYPE_MESSENGER_CONNECTION_MEMBER_ID,
      struct GNUNET_MESSENGER_MemberMessage, handle
      ),
    GNUNET_MQ_hd_fixed_size (
      room_open,
      GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_OPEN,
      struct GNUNET_MESSENGER_RoomMessage, handle
      ),
    GNUNET_MQ_hd_fixed_size (
      room_entry,
      GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_ENTRY,
      struct GNUNET_MESSENGER_RoomMessage, handle
      ),
    GNUNET_MQ_hd_fixed_size (
      room_close,
      GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_CLOSE,
      struct GNUNET_MESSENGER_RoomMessage, handle
      ),
    GNUNET_MQ_hd_var_size (
      recv_message,
      GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_RECV_MESSAGE,
      struct GNUNET_MESSENGER_RecvMessage, handle
      ),
    GNUNET_MQ_hd_fixed_size (
      miss_message,
      GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_GET_MESSAGE,
      struct GNUNET_MESSENGER_GetMessage, handle
      ),
    GNUNET_MQ_hd_fixed_size (
      room_sync,
      GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_SYNC,
      struct GNUNET_MESSENGER_RoomMessage, handle
      ),
    GNUNET_MQ_handler_end ()
  };
 
  handle->mq = GNUNET_CLIENT_connect (handle->cfg,
                                      GNUNET_MESSENGER_SERVICE_NAME, handlers,
                                      &callback_mq_error, handle);
}
 
 
struct GNUNET_MESSENGER_Handle*
GNUNET_MESSENGER_connect (const struct GNUNET_CONFIGURATION_Handle *cfg,
                          const char *name,
                          const struct GNUNET_CRYPTO_PrivateKey *key,
                          GNUNET_MESSENGER_MessageCallback msg_callback,
                          void *msg_cls)
{
  struct GNUNET_MESSENGER_Handle *handle = create_handle (cfg, msg_callback,
                                                          msg_cls);
 
  reconnect (handle);
 
  if (handle->mq)
  {
    set_handle_name (handle, name);
 
    if ((! key) || (0 < GNUNET_CRYPTO_private_key_get_length (key)))
      set_handle_key (handle, key);
 
    GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Connect handle!\n");
 
    struct GNUNET_MESSENGER_CreateMessage *msg;
    struct GNUNET_MQ_Envelope *env;
 
    env = GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_MESSENGER_CONNECTION_CREATE);
    GNUNET_MQ_send (handle->mq, env);
    return handle;
  }
  else
  {
    destroy_handle (handle);
    return NULL;
  }
}
 
 
void
GNUNET_MESSENGER_disconnect (struct GNUNET_MESSENGER_Handle *handle)
{
  if (! handle)
    return;
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Disconnect handle!\n");
 
  struct GNUNET_MESSENGER_DestroyMessage *msg;
  struct GNUNET_MQ_Envelope *env;
 
  env = GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_MESSENGER_CONNECTION_DESTROY);
  GNUNET_MQ_send (handle->mq, env);
 
  destroy_handle (handle);
}
 
 
static void
callback_leave_message_sent (void *cls)
{
  GNUNET_assert (cls);
 
  struct GNUNET_MESSENGER_Room *room = cls;
 
  room->opened = GNUNET_NO;
  clear_list_tunnels (&(room->entries));
 
  send_close_room (room->handle, room);
}
 
 
static void
keep_subscription_alive (void *cls)
{
  GNUNET_assert (cls);
 
  struct GNUNET_MESSENGER_RoomSubscription *subscription = cls;
  
  subscription->task = NULL;
  
  struct GNUNET_MESSENGER_Room *room = subscription->room;
  struct GNUNET_MESSENGER_Message *message = subscription->message;
 
  subscription->message = NULL;
 
  const struct GNUNET_ShortHashCode *discourse =
    &(message->body.subscribe.discourse);
 
  if (GNUNET_YES != GNUNET_CONTAINER_multishortmap_remove (room->subscriptions, 
                                                           discourse, 
                                                           subscription))
  {
    destroy_message (message);
    return;
  }
  
  GNUNET_free (subscription);
 
  enqueue_message_to_room (room, message, NULL);
}
 
 
static void
handle_discourse_subscription (struct GNUNET_MESSENGER_Room *room,
                               struct GNUNET_MESSENGER_Message *message)
{
  GNUNET_assert ((room) && (message));
 
  const uint32_t flags = message->body.subscribe.flags;
 
  const struct GNUNET_ShortHashCode *discourse =
    &(message->body.subscribe.discourse);
 
  struct GNUNET_MESSENGER_RoomSubscription *subscription =
    GNUNET_CONTAINER_multishortmap_get (room->subscriptions, discourse);
  
  if (0 == (flags & GNUNET_MESSENGER_FLAG_SUBSCRIPTION_UNSUBSCRIBE))
    goto active_subscription;
 
  if (! subscription)
    return;
 
  if (subscription->task)
    GNUNET_SCHEDULER_cancel (subscription->task);
 
  if (subscription->message)
    destroy_message (subscription->message);
 
  if (GNUNET_YES != GNUNET_CONTAINER_multishortmap_remove(room->subscriptions,
                                                          discourse,
                                                          subscription))
  {
    subscription->task = NULL;
    subscription->message = NULL;
    return;
  }
 
  GNUNET_free (subscription);
  return;
 
active_subscription:
  if (0 == (flags & GNUNET_MESSENGER_FLAG_SUBSCRIPTION_KEEP_ALIVE))
    return;
 
  struct GNUNET_TIME_Relative time = 
    GNUNET_TIME_relative_ntoh (message->body.subscribe.time);
  
  if (! subscription)
  {
    subscription = GNUNET_new (struct GNUNET_MESSENGER_RoomSubscription);
 
    if (GNUNET_OK != GNUNET_CONTAINER_multishortmap_put (
      room->subscriptions, discourse, subscription,
      GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST))
    {
      GNUNET_free (subscription);
      return;
    }
 
    subscription->room = room;
  }
  else
  {
    if (subscription->task)
      GNUNET_SCHEDULER_cancel (subscription->task);
 
    if (subscription->message)
      destroy_message (subscription->message);
  }
 
  subscription->message = create_message_subscribe (discourse, time, 
                                                    flags);
  
  if (! subscription->message)
  {
    subscription->task = NULL;
    return;
  }
 
  const struct GNUNET_TIME_Relative delay = GNUNET_TIME_relative_multiply_double (
    time, 0.9);
 
  subscription->task = GNUNET_SCHEDULER_add_delayed_with_priority (
    delay, GNUNET_SCHEDULER_PRIORITY_HIGH,
    keep_subscription_alive, subscription);
}
 
 
static void
send_message_to_room (struct GNUNET_MESSENGER_Room *room,
                      struct GNUNET_MESSENGER_Message *message,
                      const struct GNUNET_CRYPTO_PrivateKey *key,
                      struct GNUNET_HashCode *hash)
{
  GNUNET_assert ((room) && (message) && (key) && (hash));
 
  const struct GNUNET_ShortHashCode *sender_id = get_room_sender_id (room);
 
  message->header.timestamp = GNUNET_TIME_absolute_hton (
    GNUNET_TIME_absolute_get ());
 
  GNUNET_memcpy (&(message->header.sender_id), sender_id,
                 sizeof(message->header.sender_id));
  GNUNET_memcpy (&(message->header.previous), &(room->last_message),
                 sizeof(message->header.previous));
 
  message->header.signature.type = key->type;
 
  const uint16_t msg_length = get_message_size (message, GNUNET_YES);
 
  struct GNUNET_MESSENGER_SendMessage *msg;
  struct GNUNET_MQ_Envelope *env;
 
  env = GNUNET_MQ_msg_extra (
    msg, msg_length,
    GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_SEND_MESSAGE
    );
 
  GNUNET_memcpy (&(msg->key), &(room->key), sizeof(msg->key));
 
  char *msg_buffer = ((char*) msg) + sizeof(*msg);
  encode_message (message, msg_length, msg_buffer, GNUNET_YES);
 
  hash_message (message, msg_length, msg_buffer, hash);
  sign_message (message, msg_length, msg_buffer, hash, key);
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Send message (%s)!\n",
              GNUNET_h2s (hash));
 
  if (! get_message_discourse (message))
    update_room_last_message (room, hash);
 
  switch (message->header.kind)
  {
  case GNUNET_MESSENGER_KIND_LEAVE:
    GNUNET_MQ_notify_sent (env, callback_leave_message_sent, room);
    break;
  case GNUNET_MESSENGER_KIND_SUBSCRIBE:
    handle_discourse_subscription (room, message);
    break;
  default:
    break;
  }
 
  GNUNET_MQ_send (room->handle->mq, env);
}
 
 
void
enqueue_message_to_room (struct GNUNET_MESSENGER_Room *room,
                         struct GNUNET_MESSENGER_Message *message,
                         struct GNUNET_MESSENGER_Message *transcript)
{
  GNUNET_assert ((room) && (message));
 
  const struct GNUNET_CRYPTO_PrivateKey *key = get_handle_key (room->handle);
 
  enqueue_to_messages (&(room->queue), key, message, transcript);
 
  if (GNUNET_YES != is_room_available (room))
    return;
 
  if (GNUNET_YES == is_message_session_bound (message))
    send_sync_room (room->handle, room);
  else if (GNUNET_YES != room->wait_for_sync)
    dequeue_messages_from_room (room);
}
 
 
static void
dequeue_message_from_room (void *cls)
{
  struct GNUNET_MESSENGER_Room *room = cls;
 
  GNUNET_assert ((room) && (room->handle));
 
  room->queue_task = NULL;
 
  if ((GNUNET_YES != is_room_available (room)) || (!(room->handle->mq)))
    goto next_message;
 
  struct GNUNET_MESSENGER_Message *message = NULL;
  struct GNUNET_MESSENGER_Message *transcript = NULL;
 
  struct GNUNET_CRYPTO_PrivateKey key;
  memset (&key, 0, sizeof(key));
 
  message = dequeue_from_messages (&(room->queue), &key, &transcript);
 
  if (! message)
  {
    if (transcript)
      destroy_message (transcript);
    
    return;
  }
 
  struct GNUNET_HashCode hash;
  send_message_to_room (room, message, &key, &hash);
 
  if (! transcript)
  {
    GNUNET_CRYPTO_private_key_clear (&key);
    goto next_message;
  }
 
  GNUNET_memcpy (&(transcript->body.transcript.hash), &hash, sizeof(hash));
 
  struct GNUNET_CRYPTO_PublicKey pubkey;
  memset (&pubkey, 0, sizeof(pubkey));
  GNUNET_CRYPTO_key_get_public (&key, &pubkey);
 
  if (GNUNET_YES == encrypt_message (transcript, &pubkey))
  {
    struct GNUNET_HashCode other;
    send_message_to_room (room, transcript, &key, &other);
 
    GNUNET_CRYPTO_private_key_clear (&key);
 
    link_room_message (room, &hash, &other);
    link_room_message (room, &other, &hash);
  }
  else
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                "Sending transcript aborted: Encryption failed!\n");
 
  destroy_message (transcript);
 
next_message:
  if (! room->queue.head)
    return;
 
  room->queue_task = GNUNET_SCHEDULER_add_with_priority (
    GNUNET_SCHEDULER_PRIORITY_HIGH, dequeue_message_from_room, room);
}
 
static void
dequeue_messages_from_room (struct GNUNET_MESSENGER_Room *room)
{
  if ((GNUNET_YES != is_room_available (room)) || (!(room->handle)))
    return;
 
  if (room->handle->mq)
    dequeue_message_from_room (room);
  else if (!(room->queue_task))
    room->queue_task = GNUNET_SCHEDULER_add_with_priority (
      GNUNET_SCHEDULER_PRIORITY_HIGH, dequeue_message_from_room, room);
}
 
 
const char*
GNUNET_MESSENGER_get_name (const struct GNUNET_MESSENGER_Handle *handle)
{
  if (! handle)
    return NULL;
 
  return get_handle_name (handle);
}
 
 
static enum GNUNET_GenericReturnValue
iterate_send_name_to_room (void *cls,
                           struct GNUNET_MESSENGER_Room *room,
                           const struct GNUNET_MESSENGER_Contact *contact)
{
  const struct GNUNET_MESSENGER_Handle *handle = cls;
 
  if (GNUNET_YES != room->use_handle_name)
    return GNUNET_YES;
 
  const char *name = get_handle_name (handle);
 
  if (! name)
    return GNUNET_YES;
 
  struct GNUNET_MESSENGER_Message *message = create_message_name (name);
 
  if (! message)
    return GNUNET_NO;
 
  enqueue_message_to_room (room, message, NULL);
  return GNUNET_YES;
}
 
 
enum GNUNET_GenericReturnValue
GNUNET_MESSENGER_set_name (struct GNUNET_MESSENGER_Handle *handle,
                           const char *name)
{
  if (! handle)
    return GNUNET_SYSERR;
 
  set_handle_name (handle, strlen (name) > 0 ? name : NULL);
  GNUNET_MESSENGER_find_rooms (handle, NULL, iterate_send_name_to_room, handle);
  return GNUNET_YES;
}
 
 
static const struct GNUNET_CRYPTO_PublicKey*
get_non_anonymous_key (const struct GNUNET_CRYPTO_PublicKey *public_key)
{
  if (0 == GNUNET_memcmp (public_key, get_anonymous_public_key ()))
    return NULL;
 
  return public_key;
}
 
 
const struct GNUNET_CRYPTO_PublicKey*
GNUNET_MESSENGER_get_key (const struct GNUNET_MESSENGER_Handle *handle)
{
  if (! handle)
    return NULL;
 
  return get_non_anonymous_key (get_handle_pubkey (handle));
}
 
 
static enum GNUNET_GenericReturnValue
iterate_send_key_to_room (void *cls,
                          struct GNUNET_MESSENGER_Room *room,
                          const struct GNUNET_MESSENGER_Contact *contact)
{
  const struct GNUNET_CRYPTO_PrivateKey *key = cls;
 
  struct GNUNET_MESSENGER_Message *message = create_message_key (key);
 
  if (! message)
    return GNUNET_NO;
 
  enqueue_message_to_room (room, message, NULL);
  return GNUNET_YES;
}
 
 
enum GNUNET_GenericReturnValue
GNUNET_MESSENGER_set_key (struct GNUNET_MESSENGER_Handle *handle,
                          const struct GNUNET_CRYPTO_PrivateKey *key)
{
  if (! handle)
    return GNUNET_SYSERR;
 
  if (! key)
  {
    GNUNET_MESSENGER_find_rooms (handle, NULL, iterate_send_key_to_room, NULL);
    set_handle_key (handle, NULL);
    return GNUNET_YES;
  }
 
  if (0 >= GNUNET_CRYPTO_private_key_get_length (key))
    return GNUNET_SYSERR;
 
  struct GNUNET_CRYPTO_PrivateKey priv;
  GNUNET_memcpy (&priv, key, sizeof (priv));
 
  GNUNET_MESSENGER_find_rooms (handle, NULL, iterate_send_key_to_room, &priv);
  GNUNET_CRYPTO_private_key_clear (&priv);
 
  set_handle_key (handle, key);
  return GNUNET_YES;
}
 
 
struct GNUNET_MESSENGER_Room*
GNUNET_MESSENGER_open_room (struct GNUNET_MESSENGER_Handle *handle,
                            const struct GNUNET_HashCode *key)
{
  if ((! handle) || (! key))
    return NULL;
 
  struct GNUNET_MESSENGER_Room *room = GNUNET_CONTAINER_multihashmap_get (
    handle->rooms, key);
 
  if (! room)
  {
    room = create_room (handle, key);
 
    if (GNUNET_OK != GNUNET_CONTAINER_multihashmap_put (handle->rooms, key,
                                                        room,
                                                        GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST))
    {
      destroy_room (room);
      return NULL;
    }
  }
 
  send_open_room (handle, room);
  return room;
}
 
 
struct GNUNET_MESSENGER_Room*
GNUNET_MESSENGER_enter_room (struct GNUNET_MESSENGER_Handle *handle,
                             const struct GNUNET_PeerIdentity *door,
                             const struct GNUNET_HashCode *key)
{
  if ((! handle) || (! door) || (! key))
    return NULL;
 
  struct GNUNET_MESSENGER_Room *room = GNUNET_CONTAINER_multihashmap_get (
    handle->rooms, key);
 
  if (! room)
  {
    room = create_room (handle, key);
 
    if (GNUNET_OK != GNUNET_CONTAINER_multihashmap_put (handle->rooms, key,
                                                        room,
                                                        GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST))
    {
      destroy_room (room);
      return NULL;
    }
  }
 
  send_enter_room (handle, room, door);
  return room;
}
 
 
void
GNUNET_MESSENGER_close_room (struct GNUNET_MESSENGER_Room *room)
{
  if (! room)
    return;
 
  struct GNUNET_MESSENGER_Message *message = create_message_leave ();
 
  if (! message)
    return;
 
  enqueue_message_to_room (room, message, NULL);
}
 
 
struct GNUNET_MESSENGER_RoomFind
{
  const struct GNUNET_MESSENGER_Contact *contact;
  GNUNET_MESSENGER_MemberCallback callback;
  size_t counter;
  void *cls;
};
 
static enum GNUNET_GenericReturnValue
iterate_find_room (void *cls,
                   const struct GNUNET_HashCode *key,
                   void *value)
{
  struct GNUNET_MESSENGER_RoomFind *find = cls;
  struct GNUNET_MESSENGER_Room *room = value;
 
  if ((find->counter > 0) && ((! find->contact) || (GNUNET_YES ==
                                                    find_room_member (room,
                                                                      find->
                                                                      contact)))
      )
  {
    find->counter--;
 
    if (! find->callback)
      return GNUNET_YES;
 
    return find->callback (find->cls, room, find->contact);
  }
  else
    return GNUNET_NO;
}
 
 
int
GNUNET_MESSENGER_find_rooms (const struct GNUNET_MESSENGER_Handle *handle,
                             const struct GNUNET_MESSENGER_Contact *contact,
                             GNUNET_MESSENGER_MemberCallback callback,
                             void *cls)
{
  if (! handle)
    return GNUNET_SYSERR;
 
  struct GNUNET_MESSENGER_RoomFind find;
 
  find.contact = contact;
  find.callback = callback;
  find.counter = (contact? contact->rc : SIZE_MAX);
  find.cls = cls;
 
  return GNUNET_CONTAINER_multihashmap_iterate (handle->rooms,
                                                iterate_find_room, &find);
}
 
 
const struct GNUNET_HashCode*
GNUNET_MESSENGER_room_get_key (const struct GNUNET_MESSENGER_Room *room)
{
  if (! room)
    return NULL;
 
  return &(room->key);
}
 
 
const struct GNUNET_MESSENGER_Contact*
GNUNET_MESSENGER_get_sender (const struct GNUNET_MESSENGER_Room *room,
                             const struct GNUNET_HashCode *hash)
{
  if ((! room) || (! hash))
    return NULL;
 
  return get_room_sender (room, hash);
}
 
 
const struct GNUNET_MESSENGER_Contact*
GNUNET_MESSENGER_get_recipient (const struct GNUNET_MESSENGER_Room *room,
                                const struct GNUNET_HashCode *hash)
{
  if ((! room) || (! hash))
    return NULL;
 
  return get_room_recipient (room, hash);
}
 
 
const char*
GNUNET_MESSENGER_contact_get_name (const struct
                                   GNUNET_MESSENGER_Contact *contact)
{
  if (! contact)
    return NULL;
 
  return get_contact_name (contact);
}
 
 
const struct GNUNET_CRYPTO_PublicKey*
GNUNET_MESSENGER_contact_get_key (const struct
                                  GNUNET_MESSENGER_Contact *contact)
{
  if (! contact)
    return NULL;
 
  return get_non_anonymous_key (get_contact_key (contact));
}
 
 
size_t
GNUNET_MESSENGER_contact_get_id (const struct
                                 GNUNET_MESSENGER_Contact *contact)
{
  if (! contact)
    return 0;
 
  return get_contact_id (contact);
}
 
 
static void
send_message_to_room_with_key (struct GNUNET_MESSENGER_Room *room,
                               struct GNUNET_MESSENGER_Message *message,
                               const struct GNUNET_CRYPTO_PublicKey *public_key)
{
  struct GNUNET_MESSENGER_Message *transcript = NULL;
  const struct GNUNET_CRYPTO_PublicKey *pubkey;
 
  char *original_name;
 
  if (GNUNET_MESSENGER_KIND_NAME != message->header.kind)
    goto skip_naming;
 
  original_name = message->body.name.name;
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
              "Apply rule for using handle name in room: %s\n", GNUNET_h2s (
                &(room->key)));
 
  const char *handle_name = get_handle_name (room->handle);
 
  if ((handle_name) && (GNUNET_YES == room->use_handle_name) &&
      ((! original_name) || (0 == strlen (original_name))))
  {
    if (original_name)
      GNUNET_free (original_name);
 
    message->body.name.name = GNUNET_strdup (handle_name);
  }
 
skip_naming:
  if (! public_key)
    goto skip_encryption;
 
  pubkey = get_handle_pubkey (room->handle);
 
  if (0 != GNUNET_memcmp (pubkey, public_key))
    transcript = transcribe_message (message, public_key);
 
  if (GNUNET_YES != encrypt_message (message, public_key))
  {
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                "Sending message aborted: Encryption failed!\n");
 
    if (transcript)
      destroy_message (transcript);
 
    destroy_message (message);
    return;
  }
 
skip_encryption:
  enqueue_message_to_room (room, message, transcript);
}
 
 
void
GNUNET_MESSENGER_send_message (struct GNUNET_MESSENGER_Room *room,
                               const struct GNUNET_MESSENGER_Message *message,
                               const struct GNUNET_MESSENGER_Contact *contact)
{
  if ((! room) || (! message))
    return;
 
  switch (filter_message_sending (message))
  {
  case GNUNET_SYSERR:
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                "Sending message aborted: This kind of message is reserved for the service!\n");
    return;
  case GNUNET_NO:
    GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
                "Sending message aborted: This kind of message could cause issues!\n");
    return;
  default:
    break;
  }
 
  const struct GNUNET_CRYPTO_PublicKey *public_key;
 
  if (contact)
  {
    public_key = get_non_anonymous_key (
      get_contact_key (contact)
      );
 
    if (! public_key)
    {
      GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
                  "Sending message aborted: Invalid key!\n");
      return;
    }
  }
  else
    public_key = NULL;
 
  send_message_to_room_with_key (room, copy_message (message), public_key);
}
 
 
void
delete_message_in_room (struct GNUNET_MESSENGER_Room *room,
                        const struct GNUNET_HashCode *hash,
                        const struct GNUNET_TIME_Relative delay)
{
  struct GNUNET_MESSENGER_Message *message = create_message_delete (hash,
                                                                    delay);
 
  if (! message)
  {
    GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
                "Sending deletion aborted: Message creation failed!\n");
    return;
  }
 
  enqueue_message_to_room (room, message, NULL);
}
 
 
void
GNUNET_MESSENGER_delete_message (struct GNUNET_MESSENGER_Room *room,
                                 const struct GNUNET_HashCode *hash,
                                 const struct GNUNET_TIME_Relative delay)
{
  if ((! room) || (! hash))
    return;
 
  delete_message_in_room (room, hash, delay);
}
 
 
const struct GNUNET_MESSENGER_Message*
GNUNET_MESSENGER_get_message (const struct GNUNET_MESSENGER_Room *room,
                              const struct GNUNET_HashCode *hash)
{
  if ((! room) || (! hash))
    return NULL;
 
  const struct GNUNET_MESSENGER_Message *message = get_room_message (room,
                                                                     hash);
 
  if (! message)
  {
    GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Request message (%s)!\n",
                GNUNET_h2s (hash));
 
    struct GNUNET_MESSENGER_GetMessage *msg;
    struct GNUNET_MQ_Envelope *env;
 
    env = GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_GET_MESSAGE);
    GNUNET_memcpy (&(msg->key), &(room->key), sizeof(msg->key));
    GNUNET_memcpy (&(msg->hash), hash, sizeof(*hash));
    GNUNET_MQ_send (room->handle->mq, env);
  }
 
  return message;
}
 
 
int
GNUNET_MESSENGER_iterate_members (struct GNUNET_MESSENGER_Room *room,
                                  GNUNET_MESSENGER_MemberCallback callback,
                                  void *cls)
{
  if (! room)
    return GNUNET_SYSERR;
 
  return iterate_room_members (room, callback, cls);
}