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.actions.HandleAction;
   5 import org.asamk.signal.manager.actions.RefreshPreKeysAction;
   6 import org.asamk.signal.manager.actions.RenewSessionAction;
   7 import org.asamk.signal.manager.actions.ResendMessageAction;
   8 import org.asamk.signal.manager.actions.RetrieveProfileAction;
   9 import org.asamk.signal.manager.actions.RetrieveStorageDataAction;
  10 import org.asamk.signal.manager.actions.SendGroupInfoAction;
  11 import org.asamk.signal.manager.actions.SendGroupInfoRequestAction;
  12 import org.asamk.signal.manager.actions.SendProfileKeyAction;
  13 import org.asamk.signal.manager.actions.SendReceiptAction;
  14 import org.asamk.signal.manager.actions.SendRetryMessageRequestAction;
  15 import org.asamk.signal.manager.actions.SendSyncBlockedListAction;
  16 import org.asamk.signal.manager.actions.SendSyncConfigurationAction;
  17 import org.asamk.signal.manager.actions.SendSyncContactsAction;
  18 import org.asamk.signal.manager.actions.SendSyncGroupsAction;
  19 import org.asamk.signal.manager.actions.SendSyncKeysAction;
  20 import org.asamk.signal.manager.actions.UpdateAccountAttributesAction;
  21 import org.asamk.signal.manager.api.GroupId;
  22 import org.asamk.signal.manager.api.GroupNotFoundException;
  23 import org.asamk.signal.manager.api.MessageEnvelope;
  24 import org.asamk.signal.manager.api.Pair;
  25 import org.asamk.signal.manager.api.Profile;
  26 import org.asamk.signal.manager.api.ReceiveConfig;
  27 import org.asamk.signal.manager.api.StickerPackId;
  28 import org.asamk.signal.manager.api.TrustLevel;
  29 import org.asamk.signal.manager.api.UntrustedIdentityException;
  30 import org.asamk.signal.manager.groups.GroupUtils;
  31 import org.asamk.signal.manager.internal.SignalDependencies;
  32 import org.asamk.signal.manager.jobs.RetrieveStickerPackJob;
  33 import org.asamk.signal.manager.storage.SignalAccount;
  34 import org.asamk.signal.manager.storage.groups.GroupInfoV1;
  35 import org.asamk.signal.manager.storage.recipients.RecipientId;
  36 import org.asamk.signal.manager.storage.stickers.StickerPack;
  37 import org.signal.libsignal.metadata.ProtocolInvalidKeyException;
  38 import org.signal.libsignal.metadata.ProtocolInvalidKeyIdException;
  39 import org.signal.libsignal.metadata.ProtocolInvalidMessageException;
  40 import org.signal.libsignal.metadata.ProtocolNoSessionException;
  41 import org.signal.libsignal.metadata.ProtocolUntrustedIdentityException;
  42 import org.signal.libsignal.metadata.SelfSendException;
  43 import org.signal.libsignal.protocol.InvalidMessageException;
  44 import org.signal.libsignal.protocol.groups.GroupSessionBuilder;
  45 import org.signal.libsignal.protocol.message.DecryptionErrorMessage;
  46 import org.signal.libsignal.zkgroup.InvalidInputException;
  47 import org.signal.libsignal.zkgroup.profiles.ProfileKey;
  48 import org.slf4j.Logger;
  49 import org.slf4j.LoggerFactory;
  50 import org.whispersystems.signalservice.api.InvalidMessageStructureException;
  51 import org.whispersystems.signalservice.api.crypto.SignalGroupSessionBuilder;
  52 import org.whispersystems.signalservice.api.crypto.SignalServiceCipherResult;
  53 import org.whispersystems.signalservice.api.messages.EnvelopeContentValidator;
  54 import org.whispersystems.signalservice.api.messages.SignalServiceContent;
  55 import org.whispersystems.signalservice.api.messages.SignalServiceDataMessage;
  56 import org.whispersystems.signalservice.api.messages.SignalServiceEnvelope;
  57 import org.whispersystems.signalservice.api.messages.SignalServiceGroup;
  58 import org.whispersystems.signalservice.api.messages.SignalServiceGroupContext;
  59 import org.whispersystems.signalservice.api.messages.SignalServiceGroupV2;
  60 import org.whispersystems.signalservice.api.messages.SignalServicePniSignatureMessage;
  61 import org.whispersystems.signalservice.api.messages.SignalServiceReceiptMessage;
  62 import org.whispersystems.signalservice.api.messages.SignalServiceStoryMessage;
  63 import org.whispersystems.signalservice.api.messages.multidevice.SignalServiceSyncMessage;
  64 import org.whispersystems.signalservice.api.messages.multidevice.StickerPackOperationMessage;
  65 import org.whispersystems.signalservice.api.push.ServiceId;
  66 import org.whispersystems.signalservice.api.push.ServiceId.ACI;
  67 import org.whispersystems.signalservice.api.push.SignalServiceAddress;
  68 import org.whispersystems.signalservice.internal.push.Envelope;
  69 import org.whispersystems.signalservice.internal.push.UnsupportedDataMessageException;
  70
  71 import java.util.ArrayList;
  72 import java.util.List;
  73 import java.util.Optional;
  74 import java.util.stream.Collectors;
  75
  76 public final class IncomingMessageHandler {
  77
  78     private static final Logger logger = LoggerFactory.getLogger(IncomingMessageHandler.class);
  79
  80     private final SignalAccount account;
  81     private final SignalDependencies dependencies;
  82     private final Context context;
  83
  84     public IncomingMessageHandler(final Context context) {
  85         this.account = context.getAccount();
  86         this.dependencies = context.getDependencies();
  87         this.context = context;
  88     }
  89
  90     public Pair<List<HandleAction>, Exception> handleRetryEnvelope(
  91             final SignalServiceEnvelope envelope,
  92             final ReceiveConfig receiveConfig,
  93             final Manager.ReceiveMessageHandler handler
  94     ) {
  95         final List<HandleAction> actions = new ArrayList<>();
  96         if (envelope.isPreKeySignalMessage()) {
  97             actions.add(RefreshPreKeysAction.create());
  98         }
  99
 100         SignalServiceContent content = null;
 101         if (!envelope.isReceipt()) {
 102             account.getIdentityKeyStore().setRetryingDecryption(true);
 103             try {
 104                 final var cipherResult = dependencies.getCipher()
 105                         .decrypt(envelope.getProto(), envelope.getServerDeliveredTimestamp());
 106                 content = validate(envelope.getProto(), cipherResult, envelope.getServerDeliveredTimestamp());
 107                 if (content == null) {
 108                     return new Pair<>(List.of(), null);
 109                 }
 110             } catch (ProtocolUntrustedIdentityException e) {
 111                 final var recipientId = account.getRecipientResolver().resolveRecipient(e.getSender());
 112                 final var exception = new UntrustedIdentityException(account.getRecipientAddressResolver()
 113                         .resolveRecipientAddress(recipientId)
 114                         .toApiRecipientAddress(), e.getSenderDevice());
 115                 return new Pair<>(List.of(), exception);
 116             } catch (Exception e) {
 117                 return new Pair<>(List.of(), e);
 118             } finally {
 119                 account.getIdentityKeyStore().setRetryingDecryption(false);
 120             }
 121         }
 122         actions.addAll(checkAndHandleMessage(envelope, content, receiveConfig, handler, null));
 123         return new Pair<>(actions, null);
 124     }
 125
 126     public Pair<List<HandleAction>, Exception> handleEnvelope(
 127             final SignalServiceEnvelope envelope,
 128             final ReceiveConfig receiveConfig,
 129             final Manager.ReceiveMessageHandler handler
 130     ) {
 131         final var actions = new ArrayList<HandleAction>();
 132         SignalServiceContent content = null;
 133         Exception exception = null;
 134         envelope.getSourceServiceId().map(ServiceId::parseOrNull)
 135                 // Store uuid if we don't have it already
 136                 // uuid in envelope is sent by server
 137                 .ifPresent(serviceId -> account.getRecipientResolver().resolveRecipient(serviceId));
 138         if (!envelope.isReceipt()) {
 139             try {
 140                 final var cipherResult = dependencies.getCipher()
 141                         .decrypt(envelope.getProto(), envelope.getServerDeliveredTimestamp());
 142                 content = validate(envelope.getProto(), cipherResult, envelope.getServerDeliveredTimestamp());
 143                 if (content == null) {
 144                     return new Pair<>(List.of(), null);
 145                 }
 146             } catch (ProtocolUntrustedIdentityException e) {
 147                 final var recipientId = account.getRecipientResolver().resolveRecipient(e.getSender());
 148                 actions.add(new RetrieveProfileAction(recipientId));
 149                 exception = new UntrustedIdentityException(account.getRecipientAddressResolver()
 150                         .resolveRecipientAddress(recipientId)
 151                         .toApiRecipientAddress(), e.getSenderDevice());
 152             } catch (ProtocolInvalidKeyIdException | ProtocolInvalidKeyException | ProtocolNoSessionException |
 153                      ProtocolInvalidMessageException e) {
 154                 logger.debug("Failed to decrypt incoming message", e);
 155                 final var sender = account.getRecipientResolver().resolveRecipient(e.getSender());
 156                 if (context.getContactHelper().isContactBlocked(sender)) {
 157                     logger.debug("Received invalid message from blocked contact, ignoring.");
 158                 } else {
 159                     final var senderProfile = context.getProfileHelper().getRecipientProfile(sender);
 160                     final var selfProfile = context.getProfileHelper().getSelfProfile();
 161                     var serviceId = ServiceId.parseOrNull(e.getSender());
 162                     if (serviceId == null) {
 163                         // Workaround for libsignal-client issue #492
 164                         serviceId = account.getRecipientAddressResolver()
 165                                 .resolveRecipientAddress(sender)
 166                                 .serviceId()
 167                                 .orElse(null);
 168                     }
 169                     if (serviceId != null) {
 170                         final var isSelf = sender.equals(account.getSelfRecipientId())
 171                                 && e.getSenderDevice() == account.getDeviceId();
 172                         final var isSenderSenderKeyCapable = senderProfile != null && senderProfile.getCapabilities()
 173                                 .contains(Profile.Capability.senderKey);
 174                         final var isSelfSenderKeyCapable = selfProfile != null && selfProfile.getCapabilities()
 175                                 .contains(Profile.Capability.senderKey);
 176                         final var destination = getDestination(envelope).serviceId();
 177                         if (!isSelf && isSenderSenderKeyCapable && isSelfSenderKeyCapable) {
 178                             logger.debug("Received invalid message, requesting message resend.");
 179                             actions.add(new SendRetryMessageRequestAction(sender, serviceId, e, envelope, destination));
 180                         } else {
 181                             logger.debug("Received invalid message, queuing renew session action.");
 182                             actions.add(new RenewSessionAction(sender, serviceId, destination));
 183                         }
 184                     } else {
 185                         logger.debug("Received invalid message from invalid sender: {}", e.getSender());
 186                     }
 187                 }
 188                 exception = e;
 189             } catch (SelfSendException e) {
 190                 logger.debug("Dropping unidentified message from self.");
 191                 return new Pair<>(List.of(), null);
 192             } catch (Exception e) {
 193                 logger.debug("Failed to handle incoming message", e);
 194                 exception = e;
 195             }
 196         }
 197
 198         actions.addAll(checkAndHandleMessage(envelope, content, receiveConfig, handler, exception));
 199         return new Pair<>(actions, exception);
 200     }
 201
 202     private SignalServiceContent validate(
 203             Envelope envelope, SignalServiceCipherResult cipherResult, long serverDeliveredTimestamp
 204     ) throws ProtocolInvalidKeyException, ProtocolInvalidMessageException, UnsupportedDataMessageException, InvalidMessageStructureException {
 205         final var content = cipherResult.getContent();
 206         final var envelopeMetadata = cipherResult.getMetadata();
 207         final var validationResult = EnvelopeContentValidator.INSTANCE.validate(envelope, content);
 208
 209         if (validationResult instanceof EnvelopeContentValidator.Result.Invalid v) {
 210             logger.warn("Invalid content! {}", v.getReason(), v.getThrowable());
 211             return null;
 212         }
 213
 214         if (validationResult instanceof EnvelopeContentValidator.Result.UnsupportedDataMessage v) {
 215             logger.warn("Unsupported DataMessage! Our version: {}, their version: {}",
 216                     v.getOurVersion(),
 217                     v.getTheirVersion());
 218             return null;
 219         }
 220
 221         return SignalServiceContent.Companion.createFrom(account.getNumber(),
 222                 envelope,
 223                 envelopeMetadata,
 224                 content,
 225                 serverDeliveredTimestamp);
 226     }
 227
 228     private List<HandleAction> checkAndHandleMessage(
 229             final SignalServiceEnvelope envelope,
 230             final SignalServiceContent content,
 231             final ReceiveConfig receiveConfig,
 232             final Manager.ReceiveMessageHandler handler,
 233             final Exception exception
 234     ) {
 235         if (content != null) {
 236             // Store uuid if we don't have it already
 237             // address/uuid is validated by unidentified sender certificate
 238
 239             boolean handledPniSignature = false;
 240             if (content.getPniSignatureMessage().isPresent()) {
 241                 final var message = content.getPniSignatureMessage().get();
 242                 final var senderAddress = getSenderAddress(envelope, content);
 243                 if (senderAddress != null) {
 244                     handledPniSignature = handlePniSignatureMessage(message, senderAddress);
 245                 }
 246             }
 247             if (!handledPniSignature) {
 248                 account.getRecipientTrustedResolver().resolveRecipientTrusted(content.getSender());
 249             }
 250         }
 251         if (envelope.isReceipt()) {
 252             final var senderDeviceAddress = getSender(envelope, content);
 253             final var sender = senderDeviceAddress.serviceId();
 254             final var senderDeviceId = senderDeviceAddress.deviceId();
 255             account.getMessageSendLogStore().deleteEntryForRecipient(envelope.getTimestamp(), sender, senderDeviceId);
 256         }
 257
 258         var notAllowedToSendToGroup = isNotAllowedToSendToGroup(envelope, content);
 259         final var groupContext = getGroupContext(content);
 260         if (groupContext != null && groupContext.getGroupV2().isPresent()) {
 261             handleGroupV2Context(groupContext.getGroupV2().get());
 262         }
 263         // Check again in case the user just joined the group
 264         notAllowedToSendToGroup = notAllowedToSendToGroup && isNotAllowedToSendToGroup(envelope, content);
 265
 266         if (isMessageBlocked(envelope, content)) {
 267             logger.info("Ignoring a message from blocked user/group: {}", envelope.getTimestamp());
 268             return List.of();
 269         } else if (notAllowedToSendToGroup) {
 270             final var senderAddress = getSenderAddress(envelope, content);
 271             logger.info("Ignoring a group message from an unauthorized sender (no member or admin): {} {}",
 272                     senderAddress == null ? null : senderAddress.getIdentifier(),
 273                     envelope.getTimestamp());
 274             return List.of();
 275         } else {
 276             List<HandleAction> actions;
 277             if (content != null) {
 278                 actions = handleMessage(envelope, content, receiveConfig);
 279             } else {
 280                 actions = List.of();
 281             }
 282             handler.handleMessage(MessageEnvelope.from(envelope,
 283                     content,
 284                     account.getRecipientResolver(),
 285                     account.getRecipientAddressResolver(),
 286                     context.getAttachmentHelper()::getAttachmentFile,
 287                     exception), exception);
 288             return actions;
 289         }
 290     }
 291
 292     public List<HandleAction> handleMessage(
 293             SignalServiceEnvelope envelope, SignalServiceContent content, ReceiveConfig receiveConfig
 294     ) {
 295         var actions = new ArrayList<HandleAction>();
 296         final var senderDeviceAddress = getSender(envelope, content);
 297         final var sender = senderDeviceAddress.recipientId();
 298         final var senderServiceId = senderDeviceAddress.serviceId();
 299         final var senderDeviceId = senderDeviceAddress.deviceId();
 300         final var destination = getDestination(envelope);
 301
 302         if (content.getReceiptMessage().isPresent()) {
 303             final var message = content.getReceiptMessage().get();
 304             if (message.isDeliveryReceipt()) {
 305                 account.getMessageSendLogStore()
 306                         .deleteEntriesForRecipient(message.getTimestamps(), senderServiceId, senderDeviceId);
 307             }
 308         }
 309
 310         if (content.getSenderKeyDistributionMessage().isPresent()) {
 311             final var message = content.getSenderKeyDistributionMessage().get();
 312             final var protocolAddress = senderServiceId.toProtocolAddress(senderDeviceId);
 313             logger.debug("Received a sender key distribution message for distributionId {} from {}",
 314                     message.getDistributionId(),
 315                     protocolAddress);
 316             new SignalGroupSessionBuilder(dependencies.getSessionLock(),
 317                     new GroupSessionBuilder(account.getSenderKeyStore())).process(protocolAddress, message);
 318         }
 319
 320         if (content.getDecryptionErrorMessage().isPresent()) {
 321             var message = content.getDecryptionErrorMessage().get();
 322             logger.debug("Received a decryption error message from {}.{} (resend request for {})",
 323                     sender,
 324                     senderDeviceId,
 325                     message.getTimestamp());
 326             if (message.getDeviceId() == account.getDeviceId()) {
 327                 handleDecryptionErrorMessage(actions,
 328                         sender,
 329                         senderServiceId,
 330                         senderDeviceId,
 331                         message,
 332                         destination.serviceId());
 333             } else {
 334                 logger.debug("Request is for another one of our devices");
 335             }
 336         }
 337
 338         if (content.getDataMessage().isPresent() || content.getEditMessage().isPresent()) {
 339             var message = content.getDataMessage().isPresent()
 340                     ? content.getDataMessage().get()
 341                     : content.getEditMessage().get().getDataMessage();
 342
 343             if (content.isNeedsReceipt()) {
 344                 actions.add(new SendReceiptAction(sender,
 345                         SignalServiceReceiptMessage.Type.DELIVERY,
 346                         message.getTimestamp()));
 347             } else {
 348                 // Message wasn't sent as unidentified sender message
 349                 final var contact = context.getAccount().getContactStore().getContact(sender);
 350                 if (account.isPrimaryDevice()
 351                         && contact != null
 352                         && !contact.isBlocked()
 353                         && contact.isProfileSharingEnabled()) {
 354                     actions.add(UpdateAccountAttributesAction.create());
 355                     actions.add(new SendProfileKeyAction(sender));
 356                 }
 357             }
 358             if (receiveConfig.sendReadReceipts()) {
 359                 actions.add(new SendReceiptAction(sender,
 360                         SignalServiceReceiptMessage.Type.READ,
 361                         message.getTimestamp()));
 362             }
 363
 364             actions.addAll(handleSignalServiceDataMessage(message,
 365                     false,
 366                     senderDeviceAddress,
 367                     destination,
 368                     receiveConfig.ignoreAttachments()));
 369         }
 370
 371         if (content.getStoryMessage().isPresent()) {
 372             final var message = content.getStoryMessage().get();
 373             actions.addAll(handleSignalServiceStoryMessage(message, sender, receiveConfig.ignoreAttachments()));
 374         }
 375
 376         if (content.getSyncMessage().isPresent()) {
 377             var syncMessage = content.getSyncMessage().get();
 378             actions.addAll(handleSyncMessage(envelope,
 379                     syncMessage,
 380                     senderDeviceAddress,
 381                     receiveConfig.ignoreAttachments()));
 382         }
 383
 384         return actions;
 385     }
 386
 387     private boolean handlePniSignatureMessage(
 388             final SignalServicePniSignatureMessage message, final SignalServiceAddress senderAddress
 389     ) {
 390         final var aci = senderAddress.getServiceId();
 391         final var aciIdentity = account.getIdentityKeyStore().getIdentityInfo(aci);
 392         final var pni = message.getPni();
 393         final var pniIdentity = account.getIdentityKeyStore().getIdentityInfo(pni);
 394
 395         if (aciIdentity == null || pniIdentity == null || aci.equals(pni)) {
 396             return false;
 397         }
 398
 399         final var verified = pniIdentity.getIdentityKey()
 400                 .verifyAlternateIdentity(aciIdentity.getIdentityKey(), message.getSignature());
 401
 402         if (!verified) {
 403             logger.debug("Invalid PNI signature of ACI {} with PNI {}", aci, pni);
 404             return false;
 405         }
 406
 407         logger.debug("Verified association of ACI {} with PNI {}", aci, pni);
 408         account.getRecipientTrustedResolver()
 409                 .resolveRecipientTrusted(Optional.of(ACI.from(aci.getRawUuid())),
 410                         Optional.of(pni),
 411                         senderAddress.getNumber());
 412         return true;
 413     }
 414
 415     private void handleDecryptionErrorMessage(
 416             final List<HandleAction> actions,
 417             final RecipientId sender,
 418             final ServiceId senderServiceId,
 419             final int senderDeviceId,
 420             final DecryptionErrorMessage message,
 421             final ServiceId destination
 422     ) {
 423         final var logEntries = account.getMessageSendLogStore()
 424                 .findMessages(senderServiceId,
 425                         senderDeviceId,
 426                         message.getTimestamp(),
 427                         message.getRatchetKey().isEmpty());
 428
 429         for (final var logEntry : logEntries) {
 430             actions.add(new ResendMessageAction(sender, message.getTimestamp(), logEntry));
 431         }
 432
 433         if (message.getRatchetKey().isPresent()) {
 434             final var sessionStore = account.getAccountData(destination).getSessionStore();
 435             if (sessionStore.isCurrentRatchetKey(senderServiceId, senderDeviceId, message.getRatchetKey().get())) {
 436                 if (logEntries.isEmpty()) {
 437                     logger.debug("Renewing the session with sender");
 438                     actions.add(new RenewSessionAction(sender, senderServiceId, destination));
 439                 } else {
 440                     logger.trace("Archiving the session with sender, a resend message has already been queued");
 441                     sessionStore.archiveSessions(senderServiceId);
 442                 }
 443             }
 444             return;
 445         }
 446
 447         var found = false;
 448         for (final var logEntry : logEntries) {
 449             if (logEntry.groupId().isEmpty()) {
 450                 continue;
 451             }
 452             final var group = account.getGroupStore().getGroup(logEntry.groupId().get());
 453             if (group == null) {
 454                 continue;
 455             }
 456             found = true;
 457             logger.trace("Deleting shared sender key with {} ({}): {}",
 458                     sender,
 459                     senderDeviceId,
 460                     group.getDistributionId());
 461             account.getSenderKeyStore().deleteSharedWith(senderServiceId, senderDeviceId, group.getDistributionId());
 462         }
 463         if (!found) {
 464             logger.debug("Reset all shared sender keys with this recipient, no related message found in send log");
 465             account.getSenderKeyStore().deleteSharedWith(senderServiceId);
 466         }
 467     }
 468
 469     private List<HandleAction> handleSyncMessage(
 470             final SignalServiceEnvelope envelope,
 471             final SignalServiceSyncMessage syncMessage,
 472             final DeviceAddress sender,
 473             final boolean ignoreAttachments
 474     ) {
 475         var actions = new ArrayList<HandleAction>();
 476         account.setMultiDevice(true);
 477         if (syncMessage.getSent().isPresent()) {
 478             var message = syncMessage.getSent().get();
 479             final var destination = message.getDestination().orElse(null);
 480             if (message.getDataMessage().isPresent()) {
 481                 actions.addAll(handleSignalServiceDataMessage(message.getDataMessage().get(),
 482                         true,
 483                         sender,
 484                         destination == null
 485                                 ? null
 486                                 : new DeviceAddress(account.getRecipientResolver().resolveRecipient(destination),
 487                                         destination.getServiceId(),
 488                                         0),
 489                         ignoreAttachments));
 490             }
 491             if (message.getStoryMessage().isPresent()) {
 492                 actions.addAll(handleSignalServiceStoryMessage(message.getStoryMessage().get(),
 493                         sender.recipientId(),
 494                         ignoreAttachments));
 495             }
 496         }
 497         if (syncMessage.getRequest().isPresent() && account.isPrimaryDevice()) {
 498             var rm = syncMessage.getRequest().get();
 499             if (rm.isContactsRequest()) {
 500                 actions.add(SendSyncContactsAction.create());
 501             }
 502             if (rm.isGroupsRequest()) {
 503                 actions.add(SendSyncGroupsAction.create());
 504             }
 505             if (rm.isBlockedListRequest()) {
 506                 actions.add(SendSyncBlockedListAction.create());
 507             }
 508             if (rm.isKeysRequest()) {
 509                 actions.add(SendSyncKeysAction.create());
 510             }
 511             if (rm.isConfigurationRequest()) {
 512                 actions.add(SendSyncConfigurationAction.create());
 513             }
 514         }
 515         if (syncMessage.getGroups().isPresent()) {
 516             try {
 517                 final var groupsMessage = syncMessage.getGroups().get();
 518                 context.getAttachmentHelper()
 519                         .retrieveAttachment(groupsMessage, context.getSyncHelper()::handleSyncDeviceGroups);
 520             } catch (Exception e) {
 521                 logger.warn("Failed to handle received sync groups, ignoring: {}", e.getMessage());
 522             }
 523         }
 524         if (syncMessage.getBlockedList().isPresent()) {
 525             final var blockedListMessage = syncMessage.getBlockedList().get();
 526             for (var address : blockedListMessage.getAddresses()) {
 527                 context.getContactHelper()
 528                         .setContactBlocked(account.getRecipientResolver().resolveRecipient(address), true);
 529             }
 530             for (var groupId : blockedListMessage.getGroupIds()
 531                     .stream()
 532                     .map(GroupId::unknownVersion)
 533                     .collect(Collectors.toSet())) {
 534                 try {
 535                     context.getGroupHelper().setGroupBlocked(groupId, true);
 536                 } catch (GroupNotFoundException e) {
 537                     logger.warn("BlockedListMessage contained groupID that was not found in GroupStore: {}",
 538                             groupId.toBase64());
 539                 }
 540             }
 541         }
 542         if (syncMessage.getContacts().isPresent()) {
 543             try {
 544                 final var contactsMessage = syncMessage.getContacts().get();
 545                 context.getAttachmentHelper()
 546                         .retrieveAttachment(contactsMessage.getContactsStream(),
 547                                 context.getSyncHelper()::handleSyncDeviceContacts);
 548             } catch (Exception e) {
 549                 logger.warn("Failed to handle received sync contacts, ignoring: {}", e.getMessage());
 550             }
 551         }
 552         if (syncMessage.getVerified().isPresent()) {
 553             final var verifiedMessage = syncMessage.getVerified().get();
 554             account.getIdentityKeyStore()
 555                     .setIdentityTrustLevel(verifiedMessage.getDestination().getServiceId(),
 556                             verifiedMessage.getIdentityKey(),
 557                             TrustLevel.fromVerifiedState(verifiedMessage.getVerified()));
 558         }
 559         if (syncMessage.getStickerPackOperations().isPresent()) {
 560             final var stickerPackOperationMessages = syncMessage.getStickerPackOperations().get();
 561             for (var m : stickerPackOperationMessages) {
 562                 if (m.getPackId().isEmpty()) {
 563                     continue;
 564                 }
 565                 final var stickerPackId = StickerPackId.deserialize(m.getPackId().get());
 566                 final var stickerPackKey = m.getPackKey().orElse(null);
 567                 final var installed = m.getType().isEmpty()
 568                         || m.getType().get() == StickerPackOperationMessage.Type.INSTALL;
 569
 570                 final var sticker = context.getStickerHelper()
 571                         .addOrUpdateStickerPack(stickerPackId, stickerPackKey, installed);
 572
 573                 if (sticker != null && installed) {
 574                     context.getJobExecutor().enqueueJob(new RetrieveStickerPackJob(stickerPackId, sticker.packKey()));
 575                 }
 576             }
 577         }
 578         if (syncMessage.getFetchType().isPresent()) {
 579             switch (syncMessage.getFetchType().get()) {
 580                 case LOCAL_PROFILE -> actions.add(new RetrieveProfileAction(account.getSelfRecipientId()));
 581                 case STORAGE_MANIFEST -> actions.add(RetrieveStorageDataAction.create());
 582             }
 583         }
 584         if (syncMessage.getKeys().isPresent()) {
 585             final var keysMessage = syncMessage.getKeys().get();
 586             if (keysMessage.getStorageService().isPresent()) {
 587                 final var storageKey = keysMessage.getStorageService().get();
 588                 account.setStorageKey(storageKey);
 589                 actions.add(RetrieveStorageDataAction.create());
 590             }
 591         }
 592         if (syncMessage.getConfiguration().isPresent()) {
 593             final var configurationMessage = syncMessage.getConfiguration().get();
 594             final var configurationStore = account.getConfigurationStore();
 595             if (configurationMessage.getReadReceipts().isPresent()) {
 596                 configurationStore.setReadReceipts(configurationMessage.getReadReceipts().get());
 597             }
 598             if (configurationMessage.getLinkPreviews().isPresent()) {
 599                 configurationStore.setLinkPreviews(configurationMessage.getLinkPreviews().get());
 600             }
 601             if (configurationMessage.getTypingIndicators().isPresent()) {
 602                 configurationStore.setTypingIndicators(configurationMessage.getTypingIndicators().get());
 603             }
 604             if (configurationMessage.getUnidentifiedDeliveryIndicators().isPresent()) {
 605                 configurationStore.setUnidentifiedDeliveryIndicators(configurationMessage.getUnidentifiedDeliveryIndicators()
 606                         .get());
 607             }
 608         }
 609         if (syncMessage.getPniChangeNumber().isPresent()) {
 610             final var pniChangeNumber = syncMessage.getPniChangeNumber().get();
 611             logger.debug("Received PNI change number sync message, applying.");
 612             final var updatedPniString = envelope.getUpdatedPni();
 613             if (updatedPniString != null && !updatedPniString.isEmpty()) {
 614                 final var updatedPni = ServiceId.PNI.parseOrThrow(updatedPniString);
 615                 context.getAccountHelper().handlePniChangeNumberMessage(pniChangeNumber, updatedPni);
 616             }
 617         }
 618         return actions;
 619     }
 620
 621     private SignalServiceGroupContext getGroupContext(SignalServiceContent content) {
 622         if (content == null) {
 623             return null;
 624         }
 625
 626         if (content.getDataMessage().isPresent()) {
 627             var message = content.getDataMessage().get();
 628             if (message.getGroupContext().isPresent()) {
 629                 return message.getGroupContext().get();
 630             }
 631         }
 632
 633         if (content.getStoryMessage().isPresent()) {
 634             var message = content.getStoryMessage().get();
 635             if (message.getGroupContext().isPresent()) {
 636                 try {
 637                     return SignalServiceGroupContext.create(null, message.getGroupContext().get());
 638                 } catch (InvalidMessageException e) {
 639                     throw new AssertionError(e);
 640                 }
 641             }
 642         }
 643
 644         return null;
 645     }
 646
 647     private boolean isMessageBlocked(SignalServiceEnvelope envelope, SignalServiceContent content) {
 648         SignalServiceAddress source = getSenderAddress(envelope, content);
 649         if (source == null) {
 650             return false;
 651         }
 652         final var recipientId = account.getRecipientResolver().resolveRecipient(source);
 653         if (context.getContactHelper().isContactBlocked(recipientId)) {
 654             return true;
 655         }
 656
 657         final var groupContext = getGroupContext(content);
 658         if (groupContext != null) {
 659             var groupId = GroupUtils.getGroupId(groupContext);
 660             return context.getGroupHelper().isGroupBlocked(groupId);
 661         }
 662
 663         return false;
 664     }
 665
 666     private boolean isNotAllowedToSendToGroup(SignalServiceEnvelope envelope, SignalServiceContent content) {
 667         SignalServiceAddress source = getSenderAddress(envelope, content);
 668         if (source == null) {
 669             return false;
 670         }
 671
 672         final var groupContext = getGroupContext(content);
 673         if (groupContext == null) {
 674             return false;
 675         }
 676
 677         if (groupContext.getGroupV1().isPresent()) {
 678             var groupInfo = groupContext.getGroupV1().get();
 679             if (groupInfo.getType() == SignalServiceGroup.Type.QUIT) {
 680                 return false;
 681             }
 682         }
 683
 684         var groupId = GroupUtils.getGroupId(groupContext);
 685         var group = context.getGroupHelper().getGroup(groupId);
 686         if (group == null) {
 687             return false;
 688         }
 689
 690         final var message = content.getDataMessage().orElse(null);
 691
 692         final var recipientId = account.getRecipientResolver().resolveRecipient(source);
 693         if (!group.isMember(recipientId) && !(
 694                 group.isPendingMember(recipientId) && message != null && message.isGroupV2Update()
 695         )) {
 696             return true;
 697         }
 698
 699         if (group.isAnnouncementGroup() && !group.isAdmin(recipientId)) {
 700             return message == null
 701                     || message.getBody().isPresent()
 702                     || message.getAttachments().isPresent()
 703                     || message.getQuote().isPresent()
 704                     || message.getPreviews().isPresent()
 705                     || message.getMentions().isPresent()
 706                     || message.getSticker().isPresent();
 707         }
 708         return false;
 709     }
 710
 711     private List<HandleAction> handleSignalServiceDataMessage(
 712             SignalServiceDataMessage message,
 713             boolean isSync,
 714             DeviceAddress source,
 715             DeviceAddress destination,
 716             boolean ignoreAttachments
 717     ) {
 718         var actions = new ArrayList<HandleAction>();
 719         if (message.getGroupContext().isPresent()) {
 720             final var groupContext = message.getGroupContext().get();
 721             if (groupContext.getGroupV1().isPresent()) {
 722                 var groupInfo = groupContext.getGroupV1().get();
 723                 var groupId = GroupId.v1(groupInfo.getGroupId());
 724                 var group = context.getGroupHelper().getGroup(groupId);
 725                 if (group == null || group instanceof GroupInfoV1) {
 726                     var groupV1 = (GroupInfoV1) group;
 727                     switch (groupInfo.getType()) {
 728                         case UPDATE -> {
 729                             if (groupV1 == null) {
 730                                 groupV1 = new GroupInfoV1(groupId);
 731                             }
 732
 733                             if (groupInfo.getAvatar().isPresent()) {
 734                                 var avatar = groupInfo.getAvatar().get();
 735                                 context.getGroupHelper().downloadGroupAvatar(groupV1.getGroupId(), avatar);
 736                             }
 737
 738                             if (groupInfo.getName().isPresent()) {
 739                                 groupV1.name = groupInfo.getName().get();
 740                             }
 741
 742                             if (groupInfo.getMembers().isPresent()) {
 743                                 final var recipientResolver = account.getRecipientResolver();
 744                                 groupV1.addMembers(groupInfo.getMembers()
 745                                         .get()
 746                                         .stream()
 747                                         .map(recipientResolver::resolveRecipient)
 748                                         .collect(Collectors.toSet()));
 749                             }
 750
 751                             account.getGroupStore().updateGroup(groupV1);
 752                         }
 753                         case DELIVER -> {
 754                             if (groupV1 == null && !isSync) {
 755                                 actions.add(new SendGroupInfoRequestAction(source.recipientId(), groupId));
 756                             }
 757                         }
 758                         case QUIT -> {
 759                             if (groupV1 != null) {
 760                                 groupV1.removeMember(source.recipientId());
 761                                 account.getGroupStore().updateGroup(groupV1);
 762                             }
 763                         }
 764                         case REQUEST_INFO -> {
 765                             if (groupV1 != null && !isSync) {
 766                                 actions.add(new SendGroupInfoAction(source.recipientId(), groupV1.getGroupId()));
 767                             }
 768                         }
 769                     }
 770                 } else {
 771                     // Received a group v1 message for a v2 group
 772                 }
 773             }
 774             if (groupContext.getGroupV2().isPresent()) {
 775                 handleGroupV2Context(groupContext.getGroupV2().get());
 776             }
 777         }
 778
 779         final var selfAddress = isSync ? source : destination;
 780         final var conversationPartnerAddress = isSync ? destination : source;
 781         if (conversationPartnerAddress != null && message.isEndSession()) {
 782             account.getAccountData(selfAddress.serviceId())
 783                     .getSessionStore()
 784                     .deleteAllSessions(conversationPartnerAddress.serviceId());
 785         }
 786         if (message.isExpirationUpdate() || message.getBody().isPresent()) {
 787             if (message.getGroupContext().isPresent()) {
 788                 final var groupContext = message.getGroupContext().get();
 789                 if (groupContext.getGroupV1().isPresent()) {
 790                     var groupInfo = groupContext.getGroupV1().get();
 791                     var group = account.getGroupStore().getOrCreateGroupV1(GroupId.v1(groupInfo.getGroupId()));
 792                     if (group != null) {
 793                         if (group.messageExpirationTime != message.getExpiresInSeconds()) {
 794                             group.messageExpirationTime = message.getExpiresInSeconds();
 795                             account.getGroupStore().updateGroup(group);
 796                         }
 797                     }
 798                 } else if (groupContext.getGroupV2().isPresent()) {
 799                     // disappearing message timer already stored in the DecryptedGroup
 800                 }
 801             } else if (conversationPartnerAddress != null) {
 802                 context.getContactHelper()
 803                         .setExpirationTimer(conversationPartnerAddress.recipientId(), message.getExpiresInSeconds());
 804             }
 805         }
 806         if (!ignoreAttachments) {
 807             if (message.getAttachments().isPresent()) {
 808                 for (var attachment : message.getAttachments().get()) {
 809                     context.getAttachmentHelper().downloadAttachment(attachment);
 810                 }
 811             }
 812             if (message.getSharedContacts().isPresent()) {
 813                 for (var contact : message.getSharedContacts().get()) {
 814                     if (contact.getAvatar().isPresent()) {
 815                         context.getAttachmentHelper().downloadAttachment(contact.getAvatar().get().getAttachment());
 816                     }
 817                 }
 818             }
 819             if (message.getPreviews().isPresent()) {
 820                 final var previews = message.getPreviews().get();
 821                 for (var preview : previews) {
 822                     if (preview.getImage().isPresent()) {
 823                         context.getAttachmentHelper().downloadAttachment(preview.getImage().get());
 824                     }
 825                 }
 826             }
 827             if (message.getQuote().isPresent()) {
 828                 final var quote = message.getQuote().get();
 829
 830                 if (quote.getAttachments() != null) {
 831                     for (var quotedAttachment : quote.getAttachments()) {
 832                         final var thumbnail = quotedAttachment.getThumbnail();
 833                         if (thumbnail != null) {
 834                             context.getAttachmentHelper().downloadAttachment(thumbnail);
 835                         }
 836                     }
 837                 }
 838             }
 839         }
 840         if (message.getGiftBadge().isPresent()) {
 841             handleIncomingGiftBadge(message.getGiftBadge().get());
 842         }
 843         if (message.getProfileKey().isPresent()) {
 844             handleIncomingProfileKey(message.getProfileKey().get(), source.recipientId());
 845         }
 846         if (message.getSticker().isPresent()) {
 847             final var messageSticker = message.getSticker().get();
 848             final var stickerPackId = StickerPackId.deserialize(messageSticker.getPackId());
 849             var sticker = account.getStickerStore().getStickerPack(stickerPackId);
 850             if (sticker == null) {
 851                 sticker = new StickerPack(stickerPackId, messageSticker.getPackKey());
 852                 account.getStickerStore().addStickerPack(sticker);
 853             }
 854             context.getJobExecutor().enqueueJob(new RetrieveStickerPackJob(stickerPackId, messageSticker.getPackKey()));
 855         }
 856         return actions;
 857     }
 858
 859     private void handleIncomingGiftBadge(final SignalServiceDataMessage.GiftBadge giftBadge) {
 860         // TODO
 861     }
 862
 863     private List<HandleAction> handleSignalServiceStoryMessage(
 864             SignalServiceStoryMessage message, RecipientId source, boolean ignoreAttachments
 865     ) {
 866         var actions = new ArrayList<HandleAction>();
 867         if (message.getGroupContext().isPresent()) {
 868             handleGroupV2Context(message.getGroupContext().get());
 869         }
 870
 871         if (!ignoreAttachments) {
 872             if (message.getFileAttachment().isPresent()) {
 873                 context.getAttachmentHelper().downloadAttachment(message.getFileAttachment().get());
 874             }
 875             if (message.getTextAttachment().isPresent()) {
 876                 final var textAttachment = message.getTextAttachment().get();
 877                 if (textAttachment.getPreview().isPresent()) {
 878                     final var preview = textAttachment.getPreview().get();
 879                     if (preview.getImage().isPresent()) {
 880                         context.getAttachmentHelper().downloadAttachment(preview.getImage().get());
 881                     }
 882                 }
 883             }
 884         }
 885
 886         if (message.getProfileKey().isPresent()) {
 887             handleIncomingProfileKey(message.getProfileKey().get(), source);
 888         }
 889
 890         return actions;
 891     }
 892
 893     private void handleGroupV2Context(final SignalServiceGroupV2 groupContext) {
 894         final var groupMasterKey = groupContext.getMasterKey();
 895
 896         context.getGroupHelper()
 897                 .getOrMigrateGroup(groupMasterKey,
 898                         groupContext.getRevision(),
 899                         groupContext.hasSignedGroupChange() ? groupContext.getSignedGroupChange() : null);
 900     }
 901
 902     private void handleIncomingProfileKey(final byte[] profileKeyBytes, final RecipientId source) {
 903         if (profileKeyBytes.length != 32) {
 904             logger.debug("Received invalid profile key of length {}", profileKeyBytes.length);
 905             return;
 906         }
 907         final ProfileKey profileKey;
 908         try {
 909             profileKey = new ProfileKey(profileKeyBytes);
 910         } catch (InvalidInputException e) {
 911             throw new AssertionError(e);
 912         }
 913         if (account.getSelfRecipientId().equals(source)) {
 914             this.account.setProfileKey(profileKey);
 915         }
 916         this.account.getProfileStore().storeProfileKey(source, profileKey);
 917     }
 918
 919     private SignalServiceAddress getSenderAddress(SignalServiceEnvelope envelope, SignalServiceContent content) {
 920         final var serviceId = envelope.getSourceServiceId().map(ServiceId::parseOrNull).orElse(null);
 921         if (!envelope.isUnidentifiedSender() && serviceId != null) {
 922             return new SignalServiceAddress(serviceId);
 923         } else if (content != null) {
 924             return content.getSender();
 925         } else {
 926             return null;
 927         }
 928     }
 929
 930     private DeviceAddress getSender(SignalServiceEnvelope envelope, SignalServiceContent content) {
 931         final var serviceId = envelope.getSourceServiceId().map(ServiceId::parseOrNull).orElse(null);
 932         if (!envelope.isUnidentifiedSender() && serviceId != null) {
 933             return new DeviceAddress(account.getRecipientResolver().resolveRecipient(serviceId),
 934                     serviceId,
 935                     envelope.getSourceDevice());
 936         } else {
 937             return new DeviceAddress(account.getRecipientResolver().resolveRecipient(content.getSender()),
 938                     content.getSender().getServiceId(),
 939                     content.getSenderDevice());
 940         }
 941     }
 942
 943     private DeviceAddress getDestination(SignalServiceEnvelope envelope) {
 944         if (!envelope.hasDestinationUuid()) {
 945             return new DeviceAddress(account.getSelfRecipientId(), account.getAci(), account.getDeviceId());
 946         }
 947         final var addressOptional = SignalServiceAddress.fromRaw(envelope.getDestinationServiceId(), null);
 948         if (addressOptional.isEmpty()) {
 949             return new DeviceAddress(account.getSelfRecipientId(), account.getAci(), account.getDeviceId());
 950         }
 951         final var address = addressOptional.get();
 952         return new DeviceAddress(account.getRecipientResolver().resolveRecipient(address),
 953                 address.getServiceId(),
 954                 account.getDeviceId());
 955     }
 956
 957     private record DeviceAddress(RecipientId recipientId, ServiceId serviceId, int deviceId) {}
 958 }