nmode's Git Repositories - signal-cli/blob - lib/src/main/java/org/asamk/signal/manager/helper/IncomingMessageHandler.java

   1 package org.asamk.signal.manager.helper;
   2
   3 import org.asamk.signal.manager.Manager;
   4 import org.asamk.signal.manager.SignalDependencies;
   5 import org.asamk.signal.manager.actions.HandleAction;
   6 import org.asamk.signal.manager.actions.RefreshPreKeysAction;
   7 import org.asamk.signal.manager.actions.RenewSessionAction;
   8 import org.asamk.signal.manager.actions.ResendMessageAction;
   9 import org.asamk.signal.manager.actions.RetrieveProfileAction;
  10 import org.asamk.signal.manager.actions.RetrieveStorageDataAction;
  11 import org.asamk.signal.manager.actions.SendGroupInfoAction;
  12 import org.asamk.signal.manager.actions.SendGroupInfoRequestAction;
  13 import org.asamk.signal.manager.actions.SendPniIdentityKeyAction;
  14 import org.asamk.signal.manager.actions.SendReceiptAction;
  15 import org.asamk.signal.manager.actions.SendRetryMessageRequestAction;
  16 import org.asamk.signal.manager.actions.SendSyncBlockedListAction;
  17 import org.asamk.signal.manager.actions.SendSyncConfigurationAction;
  18 import org.asamk.signal.manager.actions.SendSyncContactsAction;
  19 import org.asamk.signal.manager.actions.SendSyncGroupsAction;
  20 import org.asamk.signal.manager.actions.SendSyncKeysAction;
  21 import org.asamk.signal.manager.api.MessageEnvelope;
  22 import org.asamk.signal.manager.api.Pair;
  23 import org.asamk.signal.manager.api.StickerPackId;
  24 import org.asamk.signal.manager.api.TrustLevel;
  25 import org.asamk.signal.manager.api.UntrustedIdentityException;
  26 import org.asamk.signal.manager.groups.GroupId;
  27 import org.asamk.signal.manager.groups.GroupNotFoundException;
  28 import org.asamk.signal.manager.groups.GroupUtils;
  29 import org.asamk.signal.manager.jobs.RetrieveStickerPackJob;
  30 import org.asamk.signal.manager.storage.SignalAccount;
  31 import org.asamk.signal.manager.storage.groups.GroupInfoV1;
  32 import org.asamk.signal.manager.storage.recipients.Profile;
  33 import org.asamk.signal.manager.storage.recipients.RecipientId;
  34 import org.asamk.signal.manager.storage.stickers.Sticker;
  35 import org.asamk.signal.manager.util.KeyUtils;
  36 import org.signal.libsignal.metadata.ProtocolInvalidKeyException;
  37 import org.signal.libsignal.metadata.ProtocolInvalidKeyIdException;
  38 import org.signal.libsignal.metadata.ProtocolInvalidMessageException;
  39 import org.signal.libsignal.metadata.ProtocolNoSessionException;
  40 import org.signal.libsignal.metadata.ProtocolUntrustedIdentityException;
  41 import org.signal.libsignal.metadata.SelfSendException;
  42 import org.signal.zkgroup.InvalidInputException;
  43 import org.signal.zkgroup.profiles.ProfileKey;
  44 import org.slf4j.Logger;
  45 import org.slf4j.LoggerFactory;
  46 import org.whispersystems.libsignal.SignalProtocolAddress;
  47 import org.whispersystems.libsignal.protocol.DecryptionErrorMessage;
  48 import org.whispersystems.signalservice.api.messages.SignalServiceContent;
  49 import org.whispersystems.signalservice.api.messages.SignalServiceDataMessage;
  50 import org.whispersystems.signalservice.api.messages.SignalServiceEnvelope;
  51 import org.whispersystems.signalservice.api.messages.SignalServiceGroup;
  52 import org.whispersystems.signalservice.api.messages.multidevice.SignalServiceSyncMessage;
  53 import org.whispersystems.signalservice.api.messages.multidevice.StickerPackOperationMessage;
  54 import org.whispersystems.signalservice.api.push.SignalServiceAddress;
  55
  56 import java.util.ArrayList;
  57 import java.util.List;
  58 import java.util.stream.Collectors;
  59
  60 public final class IncomingMessageHandler {
  61
  62     private final static Logger logger = LoggerFactory.getLogger(IncomingMessageHandler.class);
  63
  64     private final SignalAccount account;
  65     private final SignalDependencies dependencies;
  66     private final Context context;
  67
  68     public IncomingMessageHandler(final Context context) {
  69         this.account = context.getAccount();
  70         this.dependencies = context.getDependencies();
  71         this.context = context;
  72     }
  73
  74     public Pair<List<HandleAction>, Exception> handleRetryEnvelope(
  75             final SignalServiceEnvelope envelope,
  76             final boolean ignoreAttachments,
  77             final Manager.ReceiveMessageHandler handler
  78     ) {
  79         final List<HandleAction> actions = new ArrayList<>();
  80         if (envelope.isPreKeySignalMessage()) {
  81             actions.add(RefreshPreKeysAction.create());
  82         }
  83
  84         SignalServiceContent content = null;
  85         if (!envelope.isReceipt()) {
  86             account.getIdentityKeyStore().setRetryingDecryption(true);
  87             try {
  88                 content = dependencies.getCipher().decrypt(envelope);
  89             } catch (ProtocolUntrustedIdentityException e) {
  90                 final var recipientId = account.getRecipientStore().resolveRecipient(e.getSender());
  91                 final var exception = new UntrustedIdentityException(account.getRecipientStore()
  92                         .resolveRecipientAddress(recipientId), e.getSenderDevice());
  93                 return new Pair<>(List.of(), exception);
  94             } catch (Exception e) {
  95                 return new Pair<>(List.of(), e);
  96             } finally {
  97                 account.getIdentityKeyStore().setRetryingDecryption(false);
  98             }
  99         }
 100         actions.addAll(checkAndHandleMessage(envelope, content, ignoreAttachments, handler, null));
 101         return new Pair<>(actions, null);
 102     }
 103
 104     public Pair<List<HandleAction>, Exception> handleEnvelope(
 105             final SignalServiceEnvelope envelope,
 106             final boolean ignoreAttachments,
 107             final Manager.ReceiveMessageHandler handler
 108     ) {
 109         final var actions = new ArrayList<HandleAction>();
 110         if (envelope.hasSourceUuid()) {
 111             // Store uuid if we don't have it already
 112             // address/uuid in envelope is sent by server
 113             account.getRecipientStore().resolveRecipientTrusted(envelope.getSourceAddress());
 114         }
 115         SignalServiceContent content = null;
 116         Exception exception = null;
 117         if (!envelope.isReceipt()) {
 118             try {
 119                 content = dependencies.getCipher().decrypt(envelope);
 120             } catch (ProtocolUntrustedIdentityException e) {
 121                 final var recipientId = account.getRecipientStore().resolveRecipient(e.getSender());
 122                 actions.add(new RetrieveProfileAction(recipientId));
 123                 exception = new UntrustedIdentityException(account.getRecipientStore()
 124                         .resolveRecipientAddress(recipientId), e.getSenderDevice());
 125             } catch (ProtocolInvalidKeyIdException | ProtocolInvalidKeyException | ProtocolNoSessionException | ProtocolInvalidMessageException e) {
 126                 logger.debug("Failed to decrypt incoming message", e);
 127                 final var sender = account.getRecipientStore().resolveRecipient(e.getSender());
 128                 if (context.getContactHelper().isContactBlocked(sender)) {
 129                     logger.debug("Received invalid message from blocked contact, ignoring.");
 130                 } else {
 131                     final var senderProfile = context.getProfileHelper().getRecipientProfile(sender);
 132                     final var selfProfile = context.getProfileHelper()
 133                             .getRecipientProfile(account.getSelfRecipientId());
 134                     if ((!sender.equals(account.getSelfRecipientId()) || e.getSenderDevice() != account.getDeviceId())
 135                             && senderProfile != null
 136                             && senderProfile.getCapabilities().contains(Profile.Capability.senderKey)
 137                             && selfProfile != null
 138                             && selfProfile.getCapabilities().contains(Profile.Capability.senderKey)) {
 139                         logger.debug("Received invalid message, requesting message resend.");
 140                         actions.add(new SendRetryMessageRequestAction(sender, e, envelope));
 141                     } else {
 142                         logger.debug("Received invalid message, queuing renew session action.");
 143                         actions.add(new RenewSessionAction(sender));
 144                     }
 145                 }
 146                 exception = e;
 147             } catch (SelfSendException e) {
 148                 logger.debug("Dropping unidentified message from self.");
 149                 return new Pair<>(List.of(), null);
 150             } catch (Exception e) {
 151                 logger.debug("Failed to handle incoming message", e);
 152                 exception = e;
 153             }
 154         }
 155
 156         actions.addAll(checkAndHandleMessage(envelope, content, ignoreAttachments, handler, exception));
 157         return new Pair<>(actions, exception);
 158     }
 159
 160     private List<HandleAction> checkAndHandleMessage(
 161             final SignalServiceEnvelope envelope,
 162             final SignalServiceContent content,
 163             final boolean ignoreAttachments,
 164             final Manager.ReceiveMessageHandler handler,
 165             final Exception exception
 166     ) {
 167         if (!envelope.hasSourceUuid() && content != null) {
 168             // Store uuid if we don't have it already
 169             // address/uuid is validated by unidentified sender certificate
 170             account.getRecipientStore().resolveRecipientTrusted(content.getSender());
 171         }
 172         if (envelope.isReceipt()) {
 173             final var senderPair = getSender(envelope, content);
 174             final var sender = senderPair.first();
 175             final var senderDeviceId = senderPair.second();
 176             account.getMessageSendLogStore().deleteEntryForRecipient(envelope.getTimestamp(), sender, senderDeviceId);
 177         }
 178
 179         if (isMessageBlocked(envelope, content)) {
 180             logger.info("Ignoring a message from blocked user/group: {}", envelope.getTimestamp());
 181             return List.of();
 182         } else if (isNotAllowedToSendToGroup(envelope, content)) {
 183             logger.info("Ignoring a group message from an unauthorized sender (no member or admin): {} {}",
 184                     (envelope.hasSourceUuid() ? envelope.getSourceAddress() : content.getSender()).getIdentifier(),
 185                     envelope.getTimestamp());
 186             return List.of();
 187         } else {
 188             List<HandleAction> actions;
 189             if (content != null) {
 190                 actions = handleMessage(envelope, content, ignoreAttachments);
 191             } else {
 192                 actions = List.of();
 193             }
 194             handler.handleMessage(MessageEnvelope.from(envelope,
 195                     content,
 196                     account.getRecipientStore(),
 197                     account.getRecipientStore()::resolveRecipientAddress,
 198                     context.getAttachmentHelper()::getAttachmentFile,
 199                     exception), exception);
 200             return actions;
 201         }
 202     }
 203
 204     public List<HandleAction> handleMessage(
 205             SignalServiceEnvelope envelope, SignalServiceContent content, boolean ignoreAttachments
 206     ) {
 207         var actions = new ArrayList<HandleAction>();
 208         final var senderPair = getSender(envelope, content);
 209         final var sender = senderPair.first();
 210         final var senderDeviceId = senderPair.second();
 211
 212         if (content.getReceiptMessage().isPresent()) {
 213             final var message = content.getReceiptMessage().get();
 214             if (message.isDeliveryReceipt()) {
 215                 account.getMessageSendLogStore()
 216                         .deleteEntriesForRecipient(message.getTimestamps(), sender, senderDeviceId);
 217             }
 218         }
 219
 220         if (content.getSenderKeyDistributionMessage().isPresent()) {
 221             final var message = content.getSenderKeyDistributionMessage().get();
 222             final var protocolAddress = new SignalProtocolAddress(context.getRecipientHelper()
 223                     .resolveSignalServiceAddress(sender)
 224                     .getIdentifier(), senderDeviceId);
 225             logger.debug("Received a sender key distribution message for distributionId {} from {}",
 226                     message.getDistributionId(),
 227                     protocolAddress);
 228             dependencies.getMessageSender().processSenderKeyDistributionMessage(protocolAddress, message);
 229         }
 230
 231         if (content.getDecryptionErrorMessage().isPresent()) {
 232             var message = content.getDecryptionErrorMessage().get();
 233             logger.debug("Received a decryption error message from {}.{} (resend request for {})",
 234                     sender,
 235                     senderDeviceId,
 236                     message.getTimestamp());
 237             if (message.getDeviceId() == account.getDeviceId()) {
 238                 handleDecryptionErrorMessage(actions, sender, senderDeviceId, message);
 239             } else {
 240                 logger.debug("Request is for another one of our devices");
 241             }
 242         }
 243
 244         if (content.getDataMessage().isPresent()) {
 245             var message = content.getDataMessage().get();
 246
 247             if (content.isNeedsReceipt()) {
 248                 actions.add(new SendReceiptAction(sender, message.getTimestamp()));
 249             }
 250
 251             actions.addAll(handleSignalServiceDataMessage(message,
 252                     false,
 253                     sender,
 254                     account.getSelfRecipientId(),
 255                     ignoreAttachments));
 256         }
 257
 258         if (content.getSyncMessage().isPresent()) {
 259             var syncMessage = content.getSyncMessage().get();
 260             actions.addAll(handleSyncMessage(syncMessage, sender, ignoreAttachments));
 261         }
 262
 263         return actions;
 264     }
 265
 266     private void handleDecryptionErrorMessage(
 267             final List<HandleAction> actions,
 268             final RecipientId sender,
 269             final int senderDeviceId,
 270             final DecryptionErrorMessage message
 271     ) {
 272         final var logEntries = account.getMessageSendLogStore()
 273                 .findMessages(sender, senderDeviceId, message.getTimestamp(), message.getRatchetKey().isEmpty());
 274
 275         for (final var logEntry : logEntries) {
 276             actions.add(new ResendMessageAction(sender, message.getTimestamp(), logEntry));
 277         }
 278
 279         if (message.getRatchetKey().isPresent()) {
 280             if (account.getSessionStore().isCurrentRatchetKey(sender, senderDeviceId, message.getRatchetKey().get())) {
 281                 if (logEntries.isEmpty()) {
 282                     logger.debug("Renewing the session with sender");
 283                     actions.add(new RenewSessionAction(sender));
 284                 } else {
 285                     logger.trace("Archiving the session with sender, a resend message has already been queued");
 286                     context.getAccount().getSessionStore().archiveSessions(sender);
 287                 }
 288             }
 289             return;
 290         }
 291
 292         var found = false;
 293         for (final var logEntry : logEntries) {
 294             if (logEntry.groupId().isEmpty()) {
 295                 continue;
 296             }
 297             final var group = account.getGroupStore().getGroup(logEntry.groupId().get());
 298             if (group == null) {
 299                 continue;
 300             }
 301             found = true;
 302             logger.trace("Deleting shared sender key with {} ({}): {}",
 303                     sender,
 304                     senderDeviceId,
 305                     group.getDistributionId());
 306             account.getSenderKeyStore().deleteSharedWith(sender, senderDeviceId, group.getDistributionId());
 307         }
 308         if (!found) {
 309             logger.debug("Reset all shared sender keys with this recipient, no related message found in send log");
 310             account.getSenderKeyStore().deleteSharedWith(sender);
 311         }
 312     }
 313
 314     private List<HandleAction> handleSyncMessage(
 315             final SignalServiceSyncMessage syncMessage, final RecipientId sender, final boolean ignoreAttachments
 316     ) {
 317         var actions = new ArrayList<HandleAction>();
 318         account.setMultiDevice(true);
 319         if (syncMessage.getSent().isPresent()) {
 320             var message = syncMessage.getSent().get();
 321             final var destination = message.getDestination().orElse(null);
 322             actions.addAll(handleSignalServiceDataMessage(message.getMessage(),
 323                     true,
 324                     sender,
 325                     destination == null ? null : context.getRecipientHelper().resolveRecipient(destination),
 326                     ignoreAttachments));
 327         }
 328         if (syncMessage.getRequest().isPresent() && account.isMasterDevice()) {
 329             var rm = syncMessage.getRequest().get();
 330             if (rm.isContactsRequest()) {
 331                 actions.add(SendSyncContactsAction.create());
 332             }
 333             if (rm.isGroupsRequest()) {
 334                 actions.add(SendSyncGroupsAction.create());
 335             }
 336             if (rm.isBlockedListRequest()) {
 337                 actions.add(SendSyncBlockedListAction.create());
 338             }
 339             if (rm.isKeysRequest()) {
 340                 actions.add(SendSyncKeysAction.create());
 341             }
 342             if (rm.isConfigurationRequest()) {
 343                 actions.add(SendSyncConfigurationAction.create());
 344             }
 345             if (rm.isPniIdentityRequest()) {
 346                 actions.add(SendPniIdentityKeyAction.create());
 347             }
 348         }
 349         if (syncMessage.getGroups().isPresent()) {
 350             logger.warn("Received a group v1 sync message, that can't be handled anymore, ignoring.");
 351         }
 352         if (syncMessage.getBlockedList().isPresent()) {
 353             final var blockedListMessage = syncMessage.getBlockedList().get();
 354             for (var address : blockedListMessage.getAddresses()) {
 355                 context.getContactHelper()
 356                         .setContactBlocked(context.getRecipientHelper().resolveRecipient(address), true);
 357             }
 358             for (var groupId : blockedListMessage.getGroupIds()
 359                     .stream()
 360                     .map(GroupId::unknownVersion)
 361                     .collect(Collectors.toSet())) {
 362                 try {
 363                     context.getGroupHelper().setGroupBlocked(groupId, true);
 364                 } catch (GroupNotFoundException e) {
 365                     logger.warn("BlockedListMessage contained groupID that was not found in GroupStore: {}",
 366                             groupId.toBase64());
 367                 }
 368             }
 369         }
 370         if (syncMessage.getContacts().isPresent()) {
 371             try {
 372                 final var contactsMessage = syncMessage.getContacts().get();
 373                 context.getAttachmentHelper()
 374                         .retrieveAttachment(contactsMessage.getContactsStream(),
 375                                 context.getSyncHelper()::handleSyncDeviceContacts);
 376             } catch (Exception e) {
 377                 logger.warn("Failed to handle received sync contacts, ignoring: {}", e.getMessage());
 378             }
 379         }
 380         if (syncMessage.getVerified().isPresent()) {
 381             final var verifiedMessage = syncMessage.getVerified().get();
 382             account.getIdentityKeyStore()
 383                     .setIdentityTrustLevel(account.getRecipientStore()
 384                                     .resolveRecipientTrusted(verifiedMessage.getDestination()),
 385                             verifiedMessage.getIdentityKey(),
 386                             TrustLevel.fromVerifiedState(verifiedMessage.getVerified()));
 387         }
 388         if (syncMessage.getStickerPackOperations().isPresent()) {
 389             final var stickerPackOperationMessages = syncMessage.getStickerPackOperations().get();
 390             for (var m : stickerPackOperationMessages) {
 391                 if (m.getPackId().isEmpty()) {
 392                     continue;
 393                 }
 394                 final var stickerPackId = StickerPackId.deserialize(m.getPackId().get());
 395                 final var installed = m.getType().isEmpty()
 396                         || m.getType().get() == StickerPackOperationMessage.Type.INSTALL;
 397
 398                 var sticker = account.getStickerStore().getStickerPack(stickerPackId);
 399                 if (m.getPackKey().isPresent()) {
 400                     if (sticker == null) {
 401                         sticker = new Sticker(stickerPackId, m.getPackKey().get());
 402                     }
 403                     if (installed) {
 404                         context.getJobExecutor()
 405                                 .enqueueJob(new RetrieveStickerPackJob(stickerPackId, m.getPackKey().get()));
 406                     }
 407                 }
 408
 409                 if (sticker != null) {
 410                     sticker.setInstalled(installed);
 411                     account.getStickerStore().updateSticker(sticker);
 412                 }
 413             }
 414         }
 415         if (syncMessage.getFetchType().isPresent()) {
 416             switch (syncMessage.getFetchType().get()) {
 417                 case LOCAL_PROFILE:
 418                     actions.add(new RetrieveProfileAction(account.getSelfRecipientId()));
 419                 case STORAGE_MANIFEST:
 420                     actions.add(RetrieveStorageDataAction.create());
 421             }
 422         }
 423         if (syncMessage.getKeys().isPresent()) {
 424             final var keysMessage = syncMessage.getKeys().get();
 425             if (keysMessage.getStorageService().isPresent()) {
 426                 final var storageKey = keysMessage.getStorageService().get();
 427                 account.setStorageKey(storageKey);
 428                 actions.add(RetrieveStorageDataAction.create());
 429             }
 430         }
 431         if (syncMessage.getConfiguration().isPresent()) {
 432             final var configurationMessage = syncMessage.getConfiguration().get();
 433             final var configurationStore = account.getConfigurationStore();
 434             if (configurationMessage.getReadReceipts().isPresent()) {
 435                 configurationStore.setReadReceipts(configurationMessage.getReadReceipts().get());
 436             }
 437             if (configurationMessage.getLinkPreviews().isPresent()) {
 438                 configurationStore.setLinkPreviews(configurationMessage.getLinkPreviews().get());
 439             }
 440             if (configurationMessage.getTypingIndicators().isPresent()) {
 441                 configurationStore.setTypingIndicators(configurationMessage.getTypingIndicators().get());
 442             }
 443             if (configurationMessage.getUnidentifiedDeliveryIndicators().isPresent()) {
 444                 configurationStore.setUnidentifiedDeliveryIndicators(configurationMessage.getUnidentifiedDeliveryIndicators()
 445                         .get());
 446             }
 447         }
 448         if (syncMessage.getPniIdentity().isPresent()) {
 449             final var pniIdentity = syncMessage.getPniIdentity().get();
 450             account.setPniIdentityKeyPair(KeyUtils.getIdentityKeyPair(pniIdentity.getPublicKey().toByteArray(),
 451                     pniIdentity.getPrivateKey().toByteArray()));
 452         }
 453         return actions;
 454     }
 455
 456     private boolean isMessageBlocked(SignalServiceEnvelope envelope, SignalServiceContent content) {
 457         SignalServiceAddress source;
 458         if (!envelope.isUnidentifiedSender() && envelope.hasSourceUuid()) {
 459             source = envelope.getSourceAddress();
 460         } else if (content != null) {
 461             source = content.getSender();
 462         } else {
 463             return false;
 464         }
 465         final var recipientId = context.getRecipientHelper().resolveRecipient(source);
 466         if (context.getContactHelper().isContactBlocked(recipientId)) {
 467             return true;
 468         }
 469
 470         if (content != null && content.getDataMessage().isPresent()) {
 471             var message = content.getDataMessage().get();
 472             if (message.getGroupContext().isPresent()) {
 473                 var groupId = GroupUtils.getGroupId(message.getGroupContext().get());
 474                 return context.getGroupHelper().isGroupBlocked(groupId);
 475             }
 476         }
 477
 478         return false;
 479     }
 480
 481     private boolean isNotAllowedToSendToGroup(SignalServiceEnvelope envelope, SignalServiceContent content) {
 482         SignalServiceAddress source;
 483         if (!envelope.isUnidentifiedSender() && envelope.hasSourceUuid()) {
 484             source = envelope.getSourceAddress();
 485         } else if (content != null) {
 486             source = content.getSender();
 487         } else {
 488             return false;
 489         }
 490
 491         if (content == null || content.getDataMessage().isEmpty()) {
 492             return false;
 493         }
 494
 495         var message = content.getDataMessage().get();
 496         if (message.getGroupContext().isEmpty()) {
 497             return false;
 498         }
 499
 500         if (message.getGroupContext().get().getGroupV1().isPresent()) {
 501             var groupInfo = message.getGroupContext().get().getGroupV1().get();
 502             if (groupInfo.getType() == SignalServiceGroup.Type.QUIT) {
 503                 return false;
 504             }
 505         }
 506
 507         var groupId = GroupUtils.getGroupId(message.getGroupContext().get());
 508         var group = context.getGroupHelper().getGroup(groupId);
 509         if (group == null) {
 510             return false;
 511         }
 512
 513         final var recipientId = context.getRecipientHelper().resolveRecipient(source);
 514         if (!group.isMember(recipientId) && !(group.isPendingMember(recipientId) && message.isGroupV2Update())) {
 515             return true;
 516         }
 517
 518         if (group.isAnnouncementGroup() && !group.isAdmin(recipientId)) {
 519             return message.getBody().isPresent()
 520                     || message.getAttachments().isPresent()
 521                     || message.getQuote()
 522                     .isPresent()
 523                     || message.getPreviews().isPresent()
 524                     || message.getMentions().isPresent()
 525                     || message.getSticker().isPresent();
 526         }
 527         return false;
 528     }
 529
 530     private List<HandleAction> handleSignalServiceDataMessage(
 531             SignalServiceDataMessage message,
 532             boolean isSync,
 533             RecipientId source,
 534             RecipientId destination,
 535             boolean ignoreAttachments
 536     ) {
 537         var actions = new ArrayList<HandleAction>();
 538         if (message.getGroupContext().isPresent()) {
 539             if (message.getGroupContext().get().getGroupV1().isPresent()) {
 540                 var groupInfo = message.getGroupContext().get().getGroupV1().get();
 541                 var groupId = GroupId.v1(groupInfo.getGroupId());
 542                 var group = context.getGroupHelper().getGroup(groupId);
 543                 if (group == null || group instanceof GroupInfoV1) {
 544                     var groupV1 = (GroupInfoV1) group;
 545                     switch (groupInfo.getType()) {
 546                         case UPDATE: {
 547                             if (groupV1 == null) {
 548                                 groupV1 = new GroupInfoV1(groupId);
 549                             }
 550
 551                             if (groupInfo.getAvatar().isPresent()) {
 552                                 var avatar = groupInfo.getAvatar().get();
 553                                 context.getGroupHelper().downloadGroupAvatar(groupV1.getGroupId(), avatar);
 554                             }
 555
 556                             if (groupInfo.getName().isPresent()) {
 557                                 groupV1.name = groupInfo.getName().get();
 558                             }
 559
 560                             if (groupInfo.getMembers().isPresent()) {
 561                                 groupV1.addMembers(groupInfo.getMembers()
 562                                         .get()
 563                                         .stream()
 564                                         .map(context.getRecipientHelper()::resolveRecipient)
 565                                         .collect(Collectors.toSet()));
 566                             }
 567
 568                             account.getGroupStore().updateGroup(groupV1);
 569                             break;
 570                         }
 571                         case DELIVER:
 572                             if (groupV1 == null && !isSync) {
 573                                 actions.add(new SendGroupInfoRequestAction(source, groupId));
 574                             }
 575                             break;
 576                         case QUIT: {
 577                             if (groupV1 != null) {
 578                                 groupV1.removeMember(source);
 579                                 account.getGroupStore().updateGroup(groupV1);
 580                             }
 581                             break;
 582                         }
 583                         case REQUEST_INFO:
 584                             if (groupV1 != null && !isSync) {
 585                                 actions.add(new SendGroupInfoAction(source, groupV1.getGroupId()));
 586                             }
 587                             break;
 588                     }
 589                 } else {
 590                     // Received a group v1 message for a v2 group
 591                 }
 592             }
 593             if (message.getGroupContext().get().getGroupV2().isPresent()) {
 594                 final var groupContext = message.getGroupContext().get().getGroupV2().get();
 595                 final var groupMasterKey = groupContext.getMasterKey();
 596
 597                 context.getGroupHelper()
 598                         .getOrMigrateGroup(groupMasterKey,
 599                                 groupContext.getRevision(),
 600                                 groupContext.hasSignedGroupChange() ? groupContext.getSignedGroupChange() : null);
 601             }
 602         }
 603
 604         final var conversationPartnerAddress = isSync ? destination : source;
 605         if (conversationPartnerAddress != null && message.isEndSession()) {
 606             account.getSessionStore().deleteAllSessions(conversationPartnerAddress);
 607         }
 608         if (message.isExpirationUpdate() || message.getBody().isPresent()) {
 609             if (message.getGroupContext().isPresent()) {
 610                 if (message.getGroupContext().get().getGroupV1().isPresent()) {
 611                     var groupInfo = message.getGroupContext().get().getGroupV1().get();
 612                     var group = account.getGroupStore().getOrCreateGroupV1(GroupId.v1(groupInfo.getGroupId()));
 613                     if (group != null) {
 614                         if (group.messageExpirationTime != message.getExpiresInSeconds()) {
 615                             group.messageExpirationTime = message.getExpiresInSeconds();
 616                             account.getGroupStore().updateGroup(group);
 617                         }
 618                     }
 619                 } else if (message.getGroupContext().get().getGroupV2().isPresent()) {
 620                     // disappearing message timer already stored in the DecryptedGroup
 621                 }
 622             } else if (conversationPartnerAddress != null) {
 623                 context.getContactHelper()
 624                         .setExpirationTimer(conversationPartnerAddress, message.getExpiresInSeconds());
 625             }
 626         }
 627         if (!ignoreAttachments) {
 628             if (message.getAttachments().isPresent()) {
 629                 for (var attachment : message.getAttachments().get()) {
 630                     context.getAttachmentHelper().downloadAttachment(attachment);
 631                 }
 632             }
 633             if (message.getSharedContacts().isPresent()) {
 634                 for (var contact : message.getSharedContacts().get()) {
 635                     if (contact.getAvatar().isPresent()) {
 636                         context.getAttachmentHelper().downloadAttachment(contact.getAvatar().get().getAttachment());
 637                     }
 638                 }
 639             }
 640             if (message.getPreviews().isPresent()) {
 641                 final var previews = message.getPreviews().get();
 642                 for (var preview : previews) {
 643                     if (preview.getImage().isPresent()) {
 644                         context.getAttachmentHelper().downloadAttachment(preview.getImage().get());
 645                     }
 646                 }
 647             }
 648             if (message.getQuote().isPresent()) {
 649                 final var quote = message.getQuote().get();
 650
 651                 for (var quotedAttachment : quote.getAttachments()) {
 652                     final var thumbnail = quotedAttachment.getThumbnail();
 653                     if (thumbnail != null) {
 654                         context.getAttachmentHelper().downloadAttachment(thumbnail);
 655                     }
 656                 }
 657             }
 658         }
 659         if (message.getProfileKey().isPresent() && message.getProfileKey().get().length == 32) {
 660             final ProfileKey profileKey;
 661             try {
 662                 profileKey = new ProfileKey(message.getProfileKey().get());
 663             } catch (InvalidInputException e) {
 664                 throw new AssertionError(e);
 665             }
 666             if (account.getSelfRecipientId().equals(source)) {
 667                 this.account.setProfileKey(profileKey);
 668             }
 669             this.account.getProfileStore().storeProfileKey(source, profileKey);
 670         }
 671         if (message.getSticker().isPresent()) {
 672             final var messageSticker = message.getSticker().get();
 673             final var stickerPackId = StickerPackId.deserialize(messageSticker.getPackId());
 674             var sticker = account.getStickerStore().getStickerPack(stickerPackId);
 675             if (sticker == null) {
 676                 sticker = new Sticker(stickerPackId, messageSticker.getPackKey());
 677                 account.getStickerStore().updateSticker(sticker);
 678             }
 679             context.getJobExecutor().enqueueJob(new RetrieveStickerPackJob(stickerPackId, messageSticker.getPackKey()));
 680         }
 681         return actions;
 682     }
 683
 684     private Pair<RecipientId, Integer> getSender(SignalServiceEnvelope envelope, SignalServiceContent content) {
 685         if (!envelope.isUnidentifiedSender() && envelope.hasSourceUuid()) {
 686             return new Pair<>(context.getRecipientHelper().resolveRecipient(envelope.getSourceAddress()),
 687                     envelope.getSourceDevice());
 688         } else {
 689             return new Pair<>(context.getRecipientHelper().resolveRecipient(content.getSender()),
 690                     content.getSenderDevice());
 691         }
 692     }
 693 }