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

   1 /*
   2   Copyright (C) 2015-2022 AsamK and contributors
   3
   4   This program is free software: you can redistribute it and/or modify
   5   it under the terms of the GNU General Public License as published by
   6   the Free Software Foundation, either version 3 of the License, or
   7   (at your option) any later version.
   8
   9   This program is distributed in the hope that it will be useful,
  10   but WITHOUT ANY WARRANTY; without even the implied warranty of
  11   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12   GNU General Public License for more details.
  13
  14   You should have received a copy of the GNU General Public License
  15   along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16  */
  17 package org.asamk.signal.manager.internal;
  18
  19 import org.asamk.signal.manager.Manager;
  20 import org.asamk.signal.manager.api.AlreadyReceivingException;
  21 import org.asamk.signal.manager.api.AttachmentInvalidException;
  22 import org.asamk.signal.manager.api.Configuration;
  23 import org.asamk.signal.manager.api.Device;
  24 import org.asamk.signal.manager.api.DeviceLinkUrl;
  25 import org.asamk.signal.manager.api.Group;
  26 import org.asamk.signal.manager.api.GroupId;
  27 import org.asamk.signal.manager.api.GroupInviteLinkUrl;
  28 import org.asamk.signal.manager.api.GroupNotFoundException;
  29 import org.asamk.signal.manager.api.GroupSendingNotAllowedException;
  30 import org.asamk.signal.manager.api.Identity;
  31 import org.asamk.signal.manager.api.IdentityVerificationCode;
  32 import org.asamk.signal.manager.api.InactiveGroupLinkException;
  33 import org.asamk.signal.manager.api.InvalidDeviceLinkException;
  34 import org.asamk.signal.manager.api.InvalidStickerException;
  35 import org.asamk.signal.manager.api.InvalidUsernameException;
  36 import org.asamk.signal.manager.api.LastGroupAdminException;
  37 import org.asamk.signal.manager.api.Message;
  38 import org.asamk.signal.manager.api.MessageEnvelope;
  39 import org.asamk.signal.manager.api.NotAGroupMemberException;
  40 import org.asamk.signal.manager.api.NotPrimaryDeviceException;
  41 import org.asamk.signal.manager.api.Pair;
  42 import org.asamk.signal.manager.api.PendingAdminApprovalException;
  43 import org.asamk.signal.manager.api.Profile;
  44 import org.asamk.signal.manager.api.ReceiveConfig;
  45 import org.asamk.signal.manager.api.Recipient;
  46 import org.asamk.signal.manager.api.RecipientIdentifier;
  47 import org.asamk.signal.manager.api.SendGroupMessageResults;
  48 import org.asamk.signal.manager.api.SendMessageResult;
  49 import org.asamk.signal.manager.api.SendMessageResults;
  50 import org.asamk.signal.manager.api.StickerPackId;
  51 import org.asamk.signal.manager.api.StickerPackInvalidException;
  52 import org.asamk.signal.manager.api.StickerPackUrl;
  53 import org.asamk.signal.manager.api.TextStyle;
  54 import org.asamk.signal.manager.api.TypingAction;
  55 import org.asamk.signal.manager.api.UnregisteredRecipientException;
  56 import org.asamk.signal.manager.api.UpdateGroup;
  57 import org.asamk.signal.manager.api.UpdateProfile;
  58 import org.asamk.signal.manager.api.UserStatus;
  59 import org.asamk.signal.manager.config.ServiceEnvironmentConfig;
  60 import org.asamk.signal.manager.helper.AccountFileUpdater;
  61 import org.asamk.signal.manager.helper.Context;
  62 import org.asamk.signal.manager.storage.AttachmentStore;
  63 import org.asamk.signal.manager.storage.AvatarStore;
  64 import org.asamk.signal.manager.storage.SignalAccount;
  65 import org.asamk.signal.manager.storage.groups.GroupInfo;
  66 import org.asamk.signal.manager.storage.identities.IdentityInfo;
  67 import org.asamk.signal.manager.storage.recipients.RecipientId;
  68 import org.asamk.signal.manager.storage.stickerPacks.JsonStickerPack;
  69 import org.asamk.signal.manager.storage.stickerPacks.StickerPackStore;
  70 import org.asamk.signal.manager.storage.stickers.StickerPack;
  71 import org.asamk.signal.manager.util.AttachmentUtils;
  72 import org.asamk.signal.manager.util.KeyUtils;
  73 import org.asamk.signal.manager.util.MimeUtils;
  74 import org.asamk.signal.manager.util.StickerUtils;
  75 import org.signal.libsignal.protocol.InvalidMessageException;
  76 import org.signal.libsignal.usernames.BaseUsernameException;
  77 import org.slf4j.Logger;
  78 import org.slf4j.LoggerFactory;
  79 import org.whispersystems.signalservice.api.SignalSessionLock;
  80 import org.whispersystems.signalservice.api.messages.SignalServiceDataMessage;
  81 import org.whispersystems.signalservice.api.messages.SignalServicePreview;
  82 import org.whispersystems.signalservice.api.messages.SignalServiceReceiptMessage;
  83 import org.whispersystems.signalservice.api.messages.SignalServiceTypingMessage;
  84 import org.whispersystems.signalservice.api.push.ServiceId;
  85 import org.whispersystems.signalservice.api.push.ServiceId.ACI;
  86 import org.whispersystems.signalservice.api.push.ServiceIdType;
  87 import org.whispersystems.signalservice.api.util.DeviceNameUtil;
  88 import org.whispersystems.signalservice.api.util.InvalidNumberException;
  89 import org.whispersystems.signalservice.api.util.PhoneNumberFormatter;
  90 import org.whispersystems.signalservice.api.util.StreamDetails;
  91 import org.whispersystems.signalservice.internal.util.Hex;
  92 import org.whispersystems.signalservice.internal.util.Util;
  93
  94 import java.io.ByteArrayInputStream;
  95 import java.io.File;
  96 import java.io.IOException;
  97 import java.io.InputStream;
  98 import java.nio.charset.StandardCharsets;
  99 import java.time.Duration;
 100 import java.util.ArrayList;
 101 import java.util.Collection;
 102 import java.util.HashMap;
 103 import java.util.HashSet;
 104 import java.util.List;
 105 import java.util.Map;
 106 import java.util.Objects;
 107 import java.util.Optional;
 108 import java.util.Set;
 109 import java.util.concurrent.ExecutorService;
 110 import java.util.concurrent.Executors;
 111 import java.util.concurrent.atomic.AtomicInteger;
 112 import java.util.concurrent.locks.ReentrantLock;
 113 import java.util.function.Function;
 114 import java.util.stream.Collectors;
 115 import java.util.stream.Stream;
 116
 117 import io.reactivex.rxjava3.disposables.CompositeDisposable;
 118
 119 public class ManagerImpl implements Manager {
 120
 121     private final static Logger logger = LoggerFactory.getLogger(ManagerImpl.class);
 122
 123     private SignalAccount account;
 124     private final SignalDependencies dependencies;
 125     private final Context context;
 126
 127     private final ExecutorService executor = Executors.newCachedThreadPool();
 128
 129     private Thread receiveThread;
 130     private boolean isReceivingSynchronous;
 131     private final Set<ReceiveMessageHandler> weakHandlers = new HashSet<>();
 132     private final Set<ReceiveMessageHandler> messageHandlers = new HashSet<>();
 133     private final List<Runnable> closedListeners = new ArrayList<>();
 134     private final List<Runnable> addressChangedListeners = new ArrayList<>();
 135     private final CompositeDisposable disposable = new CompositeDisposable();
 136
 137     public ManagerImpl(
 138             SignalAccount account,
 139             PathConfig pathConfig,
 140             AccountFileUpdater accountFileUpdater,
 141             ServiceEnvironmentConfig serviceEnvironmentConfig,
 142             String userAgent
 143     ) {
 144         this.account = account;
 145
 146         final var sessionLock = new SignalSessionLock() {
 147             private final ReentrantLock LEGACY_LOCK = new ReentrantLock();
 148
 149             @Override
 150             public Lock acquire() {
 151                 LEGACY_LOCK.lock();
 152                 return LEGACY_LOCK::unlock;
 153             }
 154         };
 155         this.dependencies = new SignalDependencies(serviceEnvironmentConfig,
 156                 userAgent,
 157                 account.getCredentialsProvider(),
 158                 account.getSignalServiceDataStore(),
 159                 executor,
 160                 sessionLock);
 161         final var avatarStore = new AvatarStore(pathConfig.avatarsPath());
 162         final var attachmentStore = new AttachmentStore(pathConfig.attachmentsPath());
 163         final var stickerPackStore = new StickerPackStore(pathConfig.stickerPacksPath());
 164
 165         this.context = new Context(account, new AccountFileUpdater() {
 166             @Override
 167             public void updateAccountIdentifiers(final String number, final ACI aci) {
 168                 accountFileUpdater.updateAccountIdentifiers(number, aci);
 169                 synchronized (addressChangedListeners) {
 170                     addressChangedListeners.forEach(Runnable::run);
 171                 }
 172             }
 173
 174             @Override
 175             public void removeAccount() {
 176                 accountFileUpdater.removeAccount();
 177             }
 178         }, dependencies, avatarStore, attachmentStore, stickerPackStore);
 179         this.context.getAccountHelper().setUnregisteredListener(this::close);
 180         this.context.getReceiveHelper().setAuthenticationFailureListener(this::close);
 181         this.context.getReceiveHelper().setCaughtUpWithOldMessagesListener(() -> {
 182             synchronized (this) {
 183                 this.notifyAll();
 184             }
 185         });
 186         disposable.add(account.getIdentityKeyStore().getIdentityChanges().subscribe(serviceId -> {
 187             logger.trace("Archiving old sessions for {}", serviceId);
 188             account.getAccountData(ServiceIdType.ACI).getSessionStore().archiveSessions(serviceId);
 189             account.getAccountData(ServiceIdType.PNI).getSessionStore().archiveSessions(serviceId);
 190             account.getSenderKeyStore().deleteSharedWith(serviceId);
 191             final var recipientId = account.getRecipientResolver().resolveRecipient(serviceId);
 192             final var profile = account.getProfileStore().getProfile(recipientId);
 193             if (profile != null) {
 194                 account.getProfileStore()
 195                         .storeProfile(recipientId,
 196                                 Profile.newBuilder(profile)
 197                                         .withUnidentifiedAccessMode(Profile.UnidentifiedAccessMode.UNKNOWN)
 198                                         .withLastUpdateTimestamp(0)
 199                                         .build());
 200             }
 201         }));
 202     }
 203
 204     @Override
 205     public String getSelfNumber() {
 206         return account.getNumber();
 207     }
 208
 209     public void checkAccountState() throws IOException {
 210         context.getAccountHelper().checkAccountState();
 211     }
 212
 213     @Override
 214     public Map<String, UserStatus> getUserStatus(Set<String> numbers) throws IOException {
 215         final var canonicalizedNumbers = numbers.stream().collect(Collectors.toMap(n -> n, n -> {
 216             try {
 217                 final var canonicalizedNumber = PhoneNumberFormatter.formatNumber(n, account.getNumber());
 218                 if (!canonicalizedNumber.equals(n)) {
 219                     logger.debug("Normalized number {} to {}.", n, canonicalizedNumber);
 220                 }
 221                 return canonicalizedNumber;
 222             } catch (InvalidNumberException e) {
 223                 return "";
 224             }
 225         }));
 226
 227         // Note "registeredUsers" has no optionals. It only gives us info on users who are registered
 228         final var canonicalizedNumbersSet = canonicalizedNumbers.values()
 229                 .stream()
 230                 .filter(s -> !s.isEmpty())
 231                 .collect(Collectors.toSet());
 232         final var registeredUsers = context.getRecipientHelper().getRegisteredUsers(canonicalizedNumbersSet);
 233
 234         return numbers.stream().collect(Collectors.toMap(n -> n, n -> {
 235             final var number = canonicalizedNumbers.get(n);
 236             final var user = registeredUsers.get(number);
 237             final var serviceId = user == null ? null : user.getServiceId();
 238             final var profile = serviceId == null
 239                     ? null
 240                     : context.getProfileHelper()
 241                             .getRecipientProfile(account.getRecipientResolver().resolveRecipient(serviceId));
 242             return new UserStatus(number.isEmpty() ? null : number,
 243                     serviceId == null ? null : serviceId.getRawUuid(),
 244                     profile != null
 245                             && profile.getUnidentifiedAccessMode() == Profile.UnidentifiedAccessMode.UNRESTRICTED);
 246         }));
 247     }
 248
 249     @Override
 250     public void updateAccountAttributes(String deviceName) throws IOException {
 251         if (deviceName != null) {
 252             context.getAccountHelper().setDeviceName(deviceName);
 253         }
 254         context.getAccountHelper().updateAccountAttributes();
 255         context.getAccountHelper().checkWhoAmiI();
 256     }
 257
 258     @Override
 259     public Configuration getConfiguration() {
 260         final var configurationStore = account.getConfigurationStore();
 261         return Configuration.from(configurationStore);
 262     }
 263
 264     @Override
 265     public void updateConfiguration(
 266             Configuration configuration
 267     ) throws NotPrimaryDeviceException {
 268         if (!account.isPrimaryDevice()) {
 269             throw new NotPrimaryDeviceException();
 270         }
 271
 272         final var configurationStore = account.getConfigurationStore();
 273         if (configuration.readReceipts().isPresent()) {
 274             configurationStore.setReadReceipts(configuration.readReceipts().get());
 275         }
 276         if (configuration.unidentifiedDeliveryIndicators().isPresent()) {
 277             configurationStore.setUnidentifiedDeliveryIndicators(configuration.unidentifiedDeliveryIndicators().get());
 278         }
 279         if (configuration.typingIndicators().isPresent()) {
 280             configurationStore.setTypingIndicators(configuration.typingIndicators().get());
 281         }
 282         if (configuration.linkPreviews().isPresent()) {
 283             configurationStore.setLinkPreviews(configuration.linkPreviews().get());
 284         }
 285         context.getSyncHelper().sendConfigurationMessage();
 286     }
 287
 288     @Override
 289     public void updateProfile(UpdateProfile updateProfile) throws IOException {
 290         context.getProfileHelper()
 291                 .setProfile(updateProfile.getGivenName(),
 292                         updateProfile.getFamilyName(),
 293                         updateProfile.getAbout(),
 294                         updateProfile.getAboutEmoji(),
 295                         updateProfile.isDeleteAvatar()
 296                                 ? Optional.empty()
 297                                 : updateProfile.getAvatar() == null ? null : Optional.of(updateProfile.getAvatar()),
 298                         updateProfile.getMobileCoinAddress());
 299         context.getSyncHelper().sendSyncFetchProfileMessage();
 300     }
 301
 302     void refreshCurrentUsername() throws IOException, BaseUsernameException {
 303         context.getAccountHelper().refreshCurrentUsername();
 304     }
 305
 306     @Override
 307     public String setUsername(final String username) throws IOException, InvalidUsernameException {
 308         try {
 309             return context.getAccountHelper().reserveUsername(username);
 310         } catch (BaseUsernameException e) {
 311             throw new InvalidUsernameException(e.getMessage() + " (" + e.getClass().getSimpleName() + ")", e);
 312         }
 313     }
 314
 315     @Override
 316     public void deleteUsername() throws IOException {
 317         context.getAccountHelper().deleteUsername();
 318     }
 319
 320     @Override
 321     public void unregister() throws IOException {
 322         context.getAccountHelper().unregister();
 323     }
 324
 325     @Override
 326     public void deleteAccount() throws IOException {
 327         context.getAccountHelper().deleteAccount();
 328     }
 329
 330     @Override
 331     public void submitRateLimitRecaptchaChallenge(String challenge, String captcha) throws IOException {
 332         captcha = captcha == null ? null : captcha.replace("signalcaptcha://", "");
 333
 334         dependencies.getAccountManager().submitRateLimitRecaptchaChallenge(challenge, captcha);
 335     }
 336
 337     @Override
 338     public List<Device> getLinkedDevices() throws IOException {
 339         var devices = dependencies.getAccountManager().getDevices();
 340         account.setMultiDevice(devices.size() > 1);
 341         var identityKey = account.getAciIdentityKeyPair().getPrivateKey();
 342         return devices.stream().map(d -> {
 343             String deviceName = d.getName();
 344             if (deviceName != null) {
 345                 try {
 346                     deviceName = DeviceNameUtil.decryptDeviceName(deviceName, identityKey);
 347                 } catch (IOException e) {
 348                     logger.debug("Failed to decrypt device name, maybe plain text?", e);
 349                 }
 350             }
 351             return new Device(d.getId(),
 352                     deviceName,
 353                     d.getCreated(),
 354                     d.getLastSeen(),
 355                     d.getId() == account.getDeviceId());
 356         }).toList();
 357     }
 358
 359     @Override
 360     public void removeLinkedDevices(int deviceId) throws IOException {
 361         context.getAccountHelper().removeLinkedDevices(deviceId);
 362     }
 363
 364     @Override
 365     public void addDeviceLink(DeviceLinkUrl linkUrl) throws IOException, InvalidDeviceLinkException, NotPrimaryDeviceException {
 366         if (!account.isPrimaryDevice()) {
 367             throw new NotPrimaryDeviceException();
 368         }
 369         context.getAccountHelper().addDevice(linkUrl);
 370     }
 371
 372     @Override
 373     public void setRegistrationLockPin(Optional<String> pin) throws IOException, NotPrimaryDeviceException {
 374         if (!account.isPrimaryDevice()) {
 375             throw new NotPrimaryDeviceException();
 376         }
 377         if (pin.isPresent()) {
 378             context.getAccountHelper().setRegistrationPin(pin.get());
 379         } else {
 380             context.getAccountHelper().removeRegistrationPin();
 381         }
 382     }
 383
 384     void refreshPreKeys() throws IOException {
 385         context.getPreKeyHelper().refreshPreKeysIfNecessary();
 386     }
 387
 388     @Override
 389     public List<Group> getGroups() {
 390         return account.getGroupStore().getGroups().stream().map(this::toGroup).toList();
 391     }
 392
 393     private Group toGroup(final GroupInfo groupInfo) {
 394         if (groupInfo == null) {
 395             return null;
 396         }
 397
 398         return Group.from(groupInfo, account.getRecipientAddressResolver(), account.getSelfRecipientId());
 399     }
 400
 401     @Override
 402     public SendGroupMessageResults quitGroup(
 403             GroupId groupId, Set<RecipientIdentifier.Single> groupAdmins
 404     ) throws GroupNotFoundException, IOException, NotAGroupMemberException, LastGroupAdminException, UnregisteredRecipientException {
 405         final var newAdmins = context.getRecipientHelper().resolveRecipients(groupAdmins);
 406         return context.getGroupHelper().quitGroup(groupId, newAdmins);
 407     }
 408
 409     @Override
 410     public void deleteGroup(GroupId groupId) throws IOException {
 411         final var group = context.getGroupHelper().getGroup(groupId);
 412         if (group.isMember(account.getSelfRecipientId())) {
 413             throw new IOException(
 414                     "The local group information cannot be removed, as the user is still a member of the group");
 415         }
 416         context.getGroupHelper().deleteGroup(groupId);
 417     }
 418
 419     @Override
 420     public Pair<GroupId, SendGroupMessageResults> createGroup(
 421             String name, Set<RecipientIdentifier.Single> members, String avatarFile
 422     ) throws IOException, AttachmentInvalidException, UnregisteredRecipientException {
 423         return context.getGroupHelper()
 424                 .createGroup(name,
 425                         members == null ? null : context.getRecipientHelper().resolveRecipients(members),
 426                         avatarFile);
 427     }
 428
 429     @Override
 430     public SendGroupMessageResults updateGroup(
 431             final GroupId groupId, final UpdateGroup updateGroup
 432     ) throws IOException, GroupNotFoundException, AttachmentInvalidException, NotAGroupMemberException, GroupSendingNotAllowedException, UnregisteredRecipientException {
 433         return context.getGroupHelper()
 434                 .updateGroup(groupId,
 435                         updateGroup.getName(),
 436                         updateGroup.getDescription(),
 437                         updateGroup.getMembers() == null
 438                                 ? null
 439                                 : context.getRecipientHelper().resolveRecipients(updateGroup.getMembers()),
 440                         updateGroup.getRemoveMembers() == null
 441                                 ? null
 442                                 : context.getRecipientHelper().resolveRecipients(updateGroup.getRemoveMembers()),
 443                         updateGroup.getAdmins() == null
 444                                 ? null
 445                                 : context.getRecipientHelper().resolveRecipients(updateGroup.getAdmins()),
 446                         updateGroup.getRemoveAdmins() == null
 447                                 ? null
 448                                 : context.getRecipientHelper().resolveRecipients(updateGroup.getRemoveAdmins()),
 449                         updateGroup.getBanMembers() == null
 450                                 ? null
 451                                 : context.getRecipientHelper().resolveRecipients(updateGroup.getBanMembers()),
 452                         updateGroup.getUnbanMembers() == null
 453                                 ? null
 454                                 : context.getRecipientHelper().resolveRecipients(updateGroup.getUnbanMembers()),
 455                         updateGroup.isResetGroupLink(),
 456                         updateGroup.getGroupLinkState(),
 457                         updateGroup.getAddMemberPermission(),
 458                         updateGroup.getEditDetailsPermission(),
 459                         updateGroup.getAvatarFile(),
 460                         updateGroup.getExpirationTimer(),
 461                         updateGroup.getIsAnnouncementGroup());
 462     }
 463
 464     @Override
 465     public Pair<GroupId, SendGroupMessageResults> joinGroup(
 466             GroupInviteLinkUrl inviteLinkUrl
 467     ) throws IOException, InactiveGroupLinkException, PendingAdminApprovalException {
 468         return context.getGroupHelper().joinGroup(inviteLinkUrl);
 469     }
 470
 471     private SendMessageResults sendMessage(
 472             SignalServiceDataMessage.Builder messageBuilder, Set<RecipientIdentifier> recipients
 473     ) throws IOException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException {
 474         return sendMessage(messageBuilder, recipients, Optional.empty());
 475     }
 476
 477     private SendMessageResults sendMessage(
 478             SignalServiceDataMessage.Builder messageBuilder,
 479             Set<RecipientIdentifier> recipients,
 480             Optional<Long> editTargetTimestamp
 481     ) throws IOException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException {
 482         var results = new HashMap<RecipientIdentifier, List<SendMessageResult>>();
 483         long timestamp = System.currentTimeMillis();
 484         messageBuilder.withTimestamp(timestamp);
 485         for (final var recipient : recipients) {
 486             if (recipient instanceof RecipientIdentifier.Single single) {
 487                 try {
 488                     final var recipientId = context.getRecipientHelper().resolveRecipient(single);
 489                     final var result = context.getSendHelper()
 490                             .sendMessage(messageBuilder, recipientId, editTargetTimestamp);
 491                     results.put(recipient, List.of(toSendMessageResult(result)));
 492                 } catch (UnregisteredRecipientException e) {
 493                     results.put(recipient,
 494                             List.of(SendMessageResult.unregisteredFailure(single.toPartialRecipientAddress())));
 495                 }
 496             } else if (recipient instanceof RecipientIdentifier.NoteToSelf) {
 497                 final var result = context.getSendHelper().sendSelfMessage(messageBuilder, editTargetTimestamp);
 498                 results.put(recipient, List.of(toSendMessageResult(result)));
 499             } else if (recipient instanceof RecipientIdentifier.Group group) {
 500                 final var result = context.getSendHelper()
 501                         .sendAsGroupMessage(messageBuilder, group.groupId(), editTargetTimestamp);
 502                 results.put(recipient, result.stream().map(this::toSendMessageResult).toList());
 503             }
 504         }
 505         return new SendMessageResults(timestamp, results);
 506     }
 507
 508     private SendMessageResult toSendMessageResult(final org.whispersystems.signalservice.api.messages.SendMessageResult result) {
 509         return SendMessageResult.from(result, account.getRecipientResolver(), account.getRecipientAddressResolver());
 510     }
 511
 512     private SendMessageResults sendTypingMessage(
 513             SignalServiceTypingMessage.Action action, Set<RecipientIdentifier> recipients
 514     ) throws IOException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException {
 515         var results = new HashMap<RecipientIdentifier, List<SendMessageResult>>();
 516         final var timestamp = System.currentTimeMillis();
 517         for (var recipient : recipients) {
 518             if (recipient instanceof RecipientIdentifier.Single single) {
 519                 final var message = new SignalServiceTypingMessage(action, timestamp, Optional.empty());
 520                 try {
 521                     final var recipientId = context.getRecipientHelper().resolveRecipient(single);
 522                     final var result = context.getSendHelper().sendTypingMessage(message, recipientId);
 523                     results.put(recipient, List.of(toSendMessageResult(result)));
 524                 } catch (UnregisteredRecipientException e) {
 525                     results.put(recipient,
 526                             List.of(SendMessageResult.unregisteredFailure(single.toPartialRecipientAddress())));
 527                 }
 528             } else if (recipient instanceof RecipientIdentifier.Group) {
 529                 final var groupId = ((RecipientIdentifier.Group) recipient).groupId();
 530                 final var message = new SignalServiceTypingMessage(action, timestamp, Optional.of(groupId.serialize()));
 531                 final var result = context.getSendHelper().sendGroupTypingMessage(message, groupId);
 532                 results.put(recipient, result.stream().map(this::toSendMessageResult).toList());
 533             }
 534         }
 535         return new SendMessageResults(timestamp, results);
 536     }
 537
 538     @Override
 539     public SendMessageResults sendTypingMessage(
 540             TypingAction action, Set<RecipientIdentifier> recipients
 541     ) throws IOException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException {
 542         return sendTypingMessage(action.toSignalService(), recipients);
 543     }
 544
 545     @Override
 546     public SendMessageResults sendReadReceipt(
 547             RecipientIdentifier.Single sender, List<Long> messageIds
 548     ) {
 549         final var timestamp = System.currentTimeMillis();
 550         var receiptMessage = new SignalServiceReceiptMessage(SignalServiceReceiptMessage.Type.READ,
 551                 messageIds,
 552                 timestamp);
 553
 554         return sendReceiptMessage(sender, timestamp, receiptMessage);
 555     }
 556
 557     @Override
 558     public SendMessageResults sendViewedReceipt(
 559             RecipientIdentifier.Single sender, List<Long> messageIds
 560     ) {
 561         final var timestamp = System.currentTimeMillis();
 562         var receiptMessage = new SignalServiceReceiptMessage(SignalServiceReceiptMessage.Type.VIEWED,
 563                 messageIds,
 564                 timestamp);
 565
 566         return sendReceiptMessage(sender, timestamp, receiptMessage);
 567     }
 568
 569     private SendMessageResults sendReceiptMessage(
 570             final RecipientIdentifier.Single sender,
 571             final long timestamp,
 572             final SignalServiceReceiptMessage receiptMessage
 573     ) {
 574         try {
 575             final var result = context.getSendHelper()
 576                     .sendReceiptMessage(receiptMessage, context.getRecipientHelper().resolveRecipient(sender));
 577             return new SendMessageResults(timestamp, Map.of(sender, List.of(toSendMessageResult(result))));
 578         } catch (UnregisteredRecipientException e) {
 579             return new SendMessageResults(timestamp,
 580                     Map.of(sender, List.of(SendMessageResult.unregisteredFailure(sender.toPartialRecipientAddress()))));
 581         }
 582     }
 583
 584     @Override
 585     public SendMessageResults sendMessage(
 586             Message message, Set<RecipientIdentifier> recipients
 587     ) throws IOException, AttachmentInvalidException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException, UnregisteredRecipientException, InvalidStickerException {
 588         final var selfProfile = context.getProfileHelper().getSelfProfile();
 589         if (selfProfile == null || selfProfile.getDisplayName().isEmpty()) {
 590             logger.warn(
 591                     "No profile name set. When sending a message it's recommended to set a profile name with the updateProfile command. This may become mandatory in the future.");
 592         }
 593         final var messageBuilder = SignalServiceDataMessage.newBuilder();
 594         applyMessage(messageBuilder, message);
 595         return sendMessage(messageBuilder, recipients);
 596     }
 597
 598     @Override
 599     public SendMessageResults sendEditMessage(
 600             Message message, Set<RecipientIdentifier> recipients, long editTargetTimestamp
 601     ) throws IOException, AttachmentInvalidException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException, UnregisteredRecipientException, InvalidStickerException {
 602         final var messageBuilder = SignalServiceDataMessage.newBuilder();
 603         applyMessage(messageBuilder, message);
 604         return sendMessage(messageBuilder, recipients, Optional.of(editTargetTimestamp));
 605     }
 606
 607     private void applyMessage(
 608             final SignalServiceDataMessage.Builder messageBuilder, final Message message
 609     ) throws AttachmentInvalidException, IOException, UnregisteredRecipientException, InvalidStickerException {
 610         if (message.messageText().length() > 2000) {
 611             final var messageBytes = message.messageText().getBytes(StandardCharsets.UTF_8);
 612             final var textAttachment = AttachmentUtils.createAttachmentStream(new StreamDetails(new ByteArrayInputStream(
 613                     messageBytes), MimeUtils.LONG_TEXT, messageBytes.length), Optional.empty());
 614             messageBuilder.withBody(message.messageText().substring(0, 2000));
 615             messageBuilder.withAttachment(context.getAttachmentHelper().uploadAttachment(textAttachment));
 616         } else {
 617             messageBuilder.withBody(message.messageText());
 618         }
 619         if (message.attachments().size() > 0) {
 620             messageBuilder.withAttachments(context.getAttachmentHelper().uploadAttachments(message.attachments()));
 621         }
 622         if (message.mentions().size() > 0) {
 623             messageBuilder.withMentions(resolveMentions(message.mentions()));
 624         }
 625         if (message.textStyles().size() > 0) {
 626             messageBuilder.withBodyRanges(message.textStyles().stream().map(TextStyle::toBodyRange).toList());
 627         }
 628         if (message.quote().isPresent()) {
 629             final var quote = message.quote().get();
 630             final var quotedAttachments = new ArrayList<SignalServiceDataMessage.Quote.QuotedAttachment>();
 631             for (final var a : quote.attachments()) {
 632                 final var quotedAttachment = new SignalServiceDataMessage.Quote.QuotedAttachment(a.contentType(),
 633                         a.filename(),
 634                         a.preview() == null ? null : context.getAttachmentHelper().uploadAttachment(a.preview()));
 635                 quotedAttachments.add(quotedAttachment);
 636             }
 637             messageBuilder.withQuote(new SignalServiceDataMessage.Quote(quote.timestamp(),
 638                     context.getRecipientHelper()
 639                             .resolveSignalServiceAddress(context.getRecipientHelper().resolveRecipient(quote.author()))
 640                             .getServiceId(),
 641                     quote.message(),
 642                     quotedAttachments,
 643                     resolveMentions(quote.mentions()),
 644                     SignalServiceDataMessage.Quote.Type.NORMAL,
 645                     quote.textStyles().stream().map(TextStyle::toBodyRange).toList()));
 646         }
 647         if (message.sticker().isPresent()) {
 648             final var sticker = message.sticker().get();
 649             final var packId = StickerPackId.deserialize(sticker.packId());
 650             final var stickerId = sticker.stickerId();
 651
 652             final var stickerPack = context.getAccount().getStickerStore().getStickerPack(packId);
 653             if (stickerPack == null) {
 654                 throw new InvalidStickerException("Sticker pack not found");
 655             }
 656             final var manifest = context.getStickerHelper().getOrRetrieveStickerPack(packId, stickerPack.packKey());
 657             if (manifest.stickers().size() <= stickerId) {
 658                 throw new InvalidStickerException("Sticker id not part of this pack");
 659             }
 660             final var manifestSticker = manifest.stickers().get(stickerId);
 661             final var streamDetails = context.getStickerPackStore().retrieveSticker(packId, stickerId);
 662             if (streamDetails == null) {
 663                 throw new InvalidStickerException("Missing local sticker file");
 664             }
 665             messageBuilder.withSticker(new SignalServiceDataMessage.Sticker(packId.serialize(),
 666                     stickerPack.packKey(),
 667                     stickerId,
 668                     manifestSticker.emoji(),
 669                     AttachmentUtils.createAttachmentStream(streamDetails, Optional.empty())));
 670         }
 671         if (message.previews().size() > 0) {
 672             final var previews = new ArrayList<SignalServicePreview>(message.previews().size());
 673             for (final var p : message.previews()) {
 674                 final var image = p.image().isPresent() ? context.getAttachmentHelper()
 675                         .uploadAttachment(p.image().get()) : null;
 676                 previews.add(new SignalServicePreview(p.url(),
 677                         p.title(),
 678                         p.description(),
 679                         0,
 680                         Optional.ofNullable(image)));
 681             }
 682             messageBuilder.withPreviews(previews);
 683         }
 684         if (message.storyReply().isPresent()) {
 685             final var storyReply = message.storyReply().get();
 686             final var authorServiceId = context.getRecipientHelper()
 687                     .resolveSignalServiceAddress(context.getRecipientHelper().resolveRecipient(storyReply.author()))
 688                     .getServiceId();
 689             messageBuilder.withStoryContext(new SignalServiceDataMessage.StoryContext(authorServiceId,
 690                     storyReply.timestamp()));
 691         }
 692     }
 693
 694     private ArrayList<SignalServiceDataMessage.Mention> resolveMentions(final List<Message.Mention> mentionList) throws UnregisteredRecipientException {
 695         final var mentions = new ArrayList<SignalServiceDataMessage.Mention>();
 696         for (final var m : mentionList) {
 697             final var recipientId = context.getRecipientHelper().resolveRecipient(m.recipient());
 698             mentions.add(new SignalServiceDataMessage.Mention(context.getRecipientHelper()
 699                     .resolveSignalServiceAddress(recipientId)
 700                     .getServiceId(), m.start(), m.length()));
 701         }
 702         return mentions;
 703     }
 704
 705     @Override
 706     public SendMessageResults sendRemoteDeleteMessage(
 707             long targetSentTimestamp, Set<RecipientIdentifier> recipients
 708     ) throws IOException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException {
 709         var delete = new SignalServiceDataMessage.RemoteDelete(targetSentTimestamp);
 710         final var messageBuilder = SignalServiceDataMessage.newBuilder().withRemoteDelete(delete);
 711         for (final var recipient : recipients) {
 712             if (recipient instanceof RecipientIdentifier.Uuid u) {
 713                 account.getMessageSendLogStore()
 714                         .deleteEntryForRecipientNonGroup(targetSentTimestamp, ACI.from(u.uuid()));
 715             } else if (recipient instanceof RecipientIdentifier.Single r) {
 716                 try {
 717                     final var recipientId = context.getRecipientHelper().resolveRecipient(r);
 718                     final var address = account.getRecipientAddressResolver().resolveRecipientAddress(recipientId);
 719                     if (address.serviceId().isPresent()) {
 720                         account.getMessageSendLogStore()
 721                                 .deleteEntryForRecipientNonGroup(targetSentTimestamp, address.serviceId().get());
 722                     }
 723                 } catch (UnregisteredRecipientException ignored) {
 724                 }
 725             } else if (recipient instanceof RecipientIdentifier.Group r) {
 726                 account.getMessageSendLogStore().deleteEntryForGroup(targetSentTimestamp, r.groupId());
 727             }
 728         }
 729         return sendMessage(messageBuilder, recipients);
 730     }
 731
 732     @Override
 733     public SendMessageResults sendMessageReaction(
 734             String emoji,
 735             boolean remove,
 736             RecipientIdentifier.Single targetAuthor,
 737             long targetSentTimestamp,
 738             Set<RecipientIdentifier> recipients,
 739             final boolean isStory
 740     ) throws IOException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException, UnregisteredRecipientException {
 741         var targetAuthorRecipientId = context.getRecipientHelper().resolveRecipient(targetAuthor);
 742         final var authorServiceId = context.getRecipientHelper()
 743                 .resolveSignalServiceAddress(targetAuthorRecipientId)
 744                 .getServiceId();
 745         var reaction = new SignalServiceDataMessage.Reaction(emoji, remove, authorServiceId, targetSentTimestamp);
 746         final var messageBuilder = SignalServiceDataMessage.newBuilder().withReaction(reaction);
 747         if (isStory) {
 748             messageBuilder.withStoryContext(new SignalServiceDataMessage.StoryContext(authorServiceId,
 749                     targetSentTimestamp));
 750         }
 751         return sendMessage(messageBuilder, recipients);
 752     }
 753
 754     @Override
 755     public SendMessageResults sendPaymentNotificationMessage(
 756             byte[] receipt, String note, RecipientIdentifier.Single recipient
 757     ) throws IOException {
 758         final var paymentNotification = new SignalServiceDataMessage.PaymentNotification(receipt, note);
 759         final var payment = new SignalServiceDataMessage.Payment(paymentNotification, null);
 760         final var messageBuilder = SignalServiceDataMessage.newBuilder().withPayment(payment);
 761         try {
 762             return sendMessage(messageBuilder, Set.of(recipient));
 763         } catch (NotAGroupMemberException | GroupNotFoundException | GroupSendingNotAllowedException e) {
 764             throw new AssertionError(e);
 765         }
 766     }
 767
 768     @Override
 769     public SendMessageResults sendEndSessionMessage(Set<RecipientIdentifier.Single> recipients) throws IOException {
 770         var messageBuilder = SignalServiceDataMessage.newBuilder().asEndSessionMessage();
 771
 772         try {
 773             return sendMessage(messageBuilder,
 774                     recipients.stream().map(RecipientIdentifier.class::cast).collect(Collectors.toSet()));
 775         } catch (GroupNotFoundException | NotAGroupMemberException | GroupSendingNotAllowedException e) {
 776             throw new AssertionError(e);
 777         } finally {
 778             for (var recipient : recipients) {
 779                 final RecipientId recipientId;
 780                 try {
 781                     recipientId = context.getRecipientHelper().resolveRecipient(recipient);
 782                 } catch (UnregisteredRecipientException e) {
 783                     continue;
 784                 }
 785                 final var serviceId = context.getAccount()
 786                         .getRecipientAddressResolver()
 787                         .resolveRecipientAddress(recipientId)
 788                         .serviceId();
 789                 if (serviceId.isPresent()) {
 790                     account.getAccountData(ServiceIdType.ACI).getSessionStore().deleteAllSessions(serviceId.get());
 791                 }
 792             }
 793         }
 794     }
 795
 796     @Override
 797     public void deleteRecipient(final RecipientIdentifier.Single recipient) {
 798         final var recipientIdOptional = context.getRecipientHelper().resolveRecipientOptional(recipient);
 799         if (recipientIdOptional.isPresent()) {
 800             account.removeRecipient(recipientIdOptional.get());
 801         }
 802     }
 803
 804     @Override
 805     public void deleteContact(final RecipientIdentifier.Single recipient) {
 806         final var recipientIdOptional = context.getRecipientHelper().resolveRecipientOptional(recipient);
 807         if (recipientIdOptional.isPresent()) {
 808             account.getContactStore().deleteContact(recipientIdOptional.get());
 809         }
 810     }
 811
 812     @Override
 813     public void setContactName(
 814             RecipientIdentifier.Single recipient, String givenName, final String familyName
 815     ) throws NotPrimaryDeviceException, UnregisteredRecipientException {
 816         if (!account.isPrimaryDevice()) {
 817             throw new NotPrimaryDeviceException();
 818         }
 819         context.getContactHelper()
 820                 .setContactName(context.getRecipientHelper().resolveRecipient(recipient), givenName, familyName);
 821     }
 822
 823     @Override
 824     public void setContactsBlocked(
 825             Collection<RecipientIdentifier.Single> recipients, boolean blocked
 826     ) throws NotPrimaryDeviceException, IOException, UnregisteredRecipientException {
 827         if (!account.isPrimaryDevice()) {
 828             throw new NotPrimaryDeviceException();
 829         }
 830         if (recipients.size() == 0) {
 831             return;
 832         }
 833         final var recipientIds = context.getRecipientHelper().resolveRecipients(recipients);
 834         final var selfRecipientId = account.getSelfRecipientId();
 835         boolean shouldRotateProfileKey = false;
 836         for (final var recipientId : recipientIds) {
 837             if (context.getContactHelper().isContactBlocked(recipientId) == blocked) {
 838                 continue;
 839             }
 840             context.getContactHelper().setContactBlocked(recipientId, blocked);
 841             // if we don't have a common group with the blocked contact we need to rotate the profile key
 842             shouldRotateProfileKey = blocked && (
 843                     shouldRotateProfileKey || account.getGroupStore()
 844                             .getGroups()
 845                             .stream()
 846                             .noneMatch(g -> g.isMember(selfRecipientId) && g.isMember(recipientId))
 847             );
 848         }
 849         if (shouldRotateProfileKey) {
 850             context.getProfileHelper().rotateProfileKey();
 851         }
 852         context.getSyncHelper().sendBlockedList();
 853     }
 854
 855     @Override
 856     public void setGroupsBlocked(
 857             final Collection<GroupId> groupIds, final boolean blocked
 858     ) throws GroupNotFoundException, NotPrimaryDeviceException, IOException {
 859         if (!account.isPrimaryDevice()) {
 860             throw new NotPrimaryDeviceException();
 861         }
 862         if (groupIds.size() == 0) {
 863             return;
 864         }
 865         boolean shouldRotateProfileKey = false;
 866         for (final var groupId : groupIds) {
 867             if (context.getGroupHelper().isGroupBlocked(groupId) == blocked) {
 868                 continue;
 869             }
 870             context.getGroupHelper().setGroupBlocked(groupId, blocked);
 871             shouldRotateProfileKey = blocked;
 872         }
 873         if (shouldRotateProfileKey) {
 874             context.getProfileHelper().rotateProfileKey();
 875         }
 876         context.getSyncHelper().sendBlockedList();
 877     }
 878
 879     @Override
 880     public void setExpirationTimer(
 881             RecipientIdentifier.Single recipient, int messageExpirationTimer
 882     ) throws IOException, UnregisteredRecipientException {
 883         var recipientId = context.getRecipientHelper().resolveRecipient(recipient);
 884         context.getContactHelper().setExpirationTimer(recipientId, messageExpirationTimer);
 885         final var messageBuilder = SignalServiceDataMessage.newBuilder().asExpirationUpdate();
 886         try {
 887             sendMessage(messageBuilder, Set.of(recipient));
 888         } catch (NotAGroupMemberException | GroupNotFoundException | GroupSendingNotAllowedException e) {
 889             throw new AssertionError(e);
 890         }
 891     }
 892
 893     @Override
 894     public StickerPackUrl uploadStickerPack(File path) throws IOException, StickerPackInvalidException {
 895         var manifest = StickerUtils.getSignalServiceStickerManifestUpload(path);
 896
 897         var messageSender = dependencies.getMessageSender();
 898
 899         var packKey = KeyUtils.createStickerUploadKey();
 900         var packIdString = messageSender.uploadStickerManifest(manifest, packKey);
 901         var packId = StickerPackId.deserialize(Hex.fromStringCondensed(packIdString));
 902
 903         var sticker = new StickerPack(packId, packKey);
 904         account.getStickerStore().addStickerPack(sticker);
 905         context.getSyncHelper().sendStickerOperationsMessage(List.of(sticker), List.of());
 906
 907         return new StickerPackUrl(packId, packKey);
 908     }
 909
 910     @Override
 911     public void installStickerPack(StickerPackUrl url) throws IOException {
 912         final var packId = url.packId();
 913         final var packKey = url.packKey();
 914         try {
 915             context.getStickerHelper().retrieveStickerPack(packId, packKey);
 916         } catch (InvalidMessageException e) {
 917             throw new IOException(e);
 918         }
 919
 920         final var sticker = context.getStickerHelper().addOrUpdateStickerPack(packId, packKey, true);
 921         context.getSyncHelper().sendStickerOperationsMessage(List.of(sticker), List.of());
 922     }
 923
 924     @Override
 925     public List<org.asamk.signal.manager.api.StickerPack> getStickerPacks() {
 926         final var stickerPackStore = context.getStickerPackStore();
 927         return account.getStickerStore().getStickerPacks().stream().map(pack -> {
 928             if (stickerPackStore.existsStickerPack(pack.packId())) {
 929                 try {
 930                     final var manifest = stickerPackStore.retrieveManifest(pack.packId());
 931                     return new org.asamk.signal.manager.api.StickerPack(pack.packId(),
 932                             new StickerPackUrl(pack.packId(), pack.packKey()),
 933                             pack.isInstalled(),
 934                             manifest.title(),
 935                             manifest.author(),
 936                             Optional.ofNullable(manifest.cover() == null ? null : manifest.cover().toApi()),
 937                             manifest.stickers().stream().map(JsonStickerPack.JsonSticker::toApi).toList());
 938                 } catch (Exception e) {
 939                     logger.warn("Failed to read local sticker pack manifest: {}", e.getMessage(), e);
 940                 }
 941             }
 942
 943             return new org.asamk.signal.manager.api.StickerPack(pack.packId(), pack.packKey(), pack.isInstalled());
 944         }).toList();
 945     }
 946
 947     @Override
 948     public void requestAllSyncData() throws IOException {
 949         context.getSyncHelper().requestAllSyncData();
 950         retrieveRemoteStorage();
 951     }
 952
 953     void retrieveRemoteStorage() throws IOException {
 954         context.getStorageHelper().readDataFromStorage();
 955     }
 956
 957     @Override
 958     public void addReceiveHandler(final ReceiveMessageHandler handler, final boolean isWeakListener) {
 959         synchronized (messageHandlers) {
 960             if (isWeakListener) {
 961                 weakHandlers.add(handler);
 962             } else {
 963                 messageHandlers.add(handler);
 964                 startReceiveThreadIfRequired();
 965             }
 966         }
 967     }
 968
 969     private static final AtomicInteger threadNumber = new AtomicInteger(0);
 970
 971     private void startReceiveThreadIfRequired() {
 972         if (receiveThread != null || isReceivingSynchronous) {
 973             return;
 974         }
 975         receiveThread = new Thread(() -> {
 976             logger.debug("Starting receiving messages");
 977             context.getReceiveHelper().receiveMessagesContinuously(this::passReceivedMessageToHandlers);
 978             logger.debug("Finished receiving messages");
 979             synchronized (messageHandlers) {
 980                 receiveThread = null;
 981
 982                 // Check if in the meantime another handler has been registered
 983                 if (!messageHandlers.isEmpty()) {
 984                     logger.debug("Another handler has been registered, starting receive thread again");
 985                     startReceiveThreadIfRequired();
 986                 }
 987             }
 988         });
 989         receiveThread.setName("receive-" + threadNumber.getAndIncrement());
 990
 991         receiveThread.start();
 992     }
 993
 994     private void passReceivedMessageToHandlers(MessageEnvelope envelope, Throwable e) {
 995         synchronized (messageHandlers) {
 996             Stream.concat(messageHandlers.stream(), weakHandlers.stream()).forEach(h -> {
 997                 try {
 998                     h.handleMessage(envelope, e);
 999                 } catch (Throwable ex) {
1000                     logger.warn("Message handler failed, ignoring", ex);
1001                 }
1002             });
1003         }
1004     }
1005
1006     @Override
1007     public void removeReceiveHandler(final ReceiveMessageHandler handler) {
1008         final Thread thread;
1009         synchronized (messageHandlers) {
1010             weakHandlers.remove(handler);
1011             messageHandlers.remove(handler);
1012             if (!messageHandlers.isEmpty() || receiveThread == null || isReceivingSynchronous) {
1013                 return;
1014             }
1015             thread = receiveThread;
1016             receiveThread = null;
1017         }
1018
1019         stopReceiveThread(thread);
1020     }
1021
1022     private void stopReceiveThread(final Thread thread) {
1023         if (context.getReceiveHelper().requestStopReceiveMessages()) {
1024             logger.debug("Receive stop requested, interrupting read from server.");
1025             thread.interrupt();
1026         }
1027         try {
1028             thread.join();
1029         } catch (InterruptedException ignored) {
1030         }
1031     }
1032
1033     @Override
1034     public boolean isReceiving() {
1035         if (isReceivingSynchronous) {
1036             return true;
1037         }
1038         synchronized (messageHandlers) {
1039             return messageHandlers.size() > 0;
1040         }
1041     }
1042
1043     @Override
1044     public void receiveMessages(
1045             Optional<Duration> timeout, Optional<Integer> maxMessages, ReceiveMessageHandler handler
1046     ) throws IOException, AlreadyReceivingException {
1047         receiveMessages(timeout.orElse(Duration.ofMinutes(1)), timeout.isPresent(), maxMessages.orElse(null), handler);
1048     }
1049
1050     private void receiveMessages(
1051             Duration timeout, boolean returnOnTimeout, Integer maxMessages, ReceiveMessageHandler handler
1052     ) throws IOException, AlreadyReceivingException {
1053         synchronized (messageHandlers) {
1054             if (isReceiving()) {
1055                 throw new AlreadyReceivingException("Already receiving message.");
1056             }
1057             isReceivingSynchronous = true;
1058             receiveThread = Thread.currentThread();
1059         }
1060         try {
1061             context.getReceiveHelper().receiveMessages(timeout, returnOnTimeout, maxMessages, (envelope, e) -> {
1062                 passReceivedMessageToHandlers(envelope, e);
1063                 handler.handleMessage(envelope, e);
1064             });
1065         } finally {
1066             synchronized (messageHandlers) {
1067                 receiveThread = null;
1068                 isReceivingSynchronous = false;
1069                 if (messageHandlers.size() > 0) {
1070                     startReceiveThreadIfRequired();
1071                 }
1072             }
1073         }
1074     }
1075
1076     @Override
1077     public void setReceiveConfig(final ReceiveConfig receiveConfig) {
1078         context.getReceiveHelper().setReceiveConfig(receiveConfig);
1079     }
1080
1081     @Override
1082     public boolean isContactBlocked(final RecipientIdentifier.Single recipient) {
1083         final RecipientId recipientId;
1084         try {
1085             recipientId = context.getRecipientHelper().resolveRecipient(recipient);
1086         } catch (UnregisteredRecipientException e) {
1087             return false;
1088         }
1089         return context.getContactHelper().isContactBlocked(recipientId);
1090     }
1091
1092     @Override
1093     public void sendContacts() throws IOException {
1094         context.getSyncHelper().sendContacts();
1095     }
1096
1097     @Override
1098     public List<Recipient> getRecipients(
1099             boolean onlyContacts,
1100             Optional<Boolean> blocked,
1101             Collection<RecipientIdentifier.Single> recipients,
1102             Optional<String> name
1103     ) {
1104         final var recipientIds = recipients.stream().map(a -> {
1105             try {
1106                 return context.getRecipientHelper().resolveRecipient(a);
1107             } catch (UnregisteredRecipientException e) {
1108                 return null;
1109             }
1110         }).filter(Objects::nonNull).collect(Collectors.toSet());
1111         if (!recipients.isEmpty() && recipientIds.isEmpty()) {
1112             return List.of();
1113         }
1114         // refresh profiles of explicitly given recipients
1115         context.getProfileHelper().refreshRecipientProfiles(recipientIds);
1116         return account.getRecipientStore()
1117                 .getRecipients(onlyContacts, blocked, recipientIds, name)
1118                 .stream()
1119                 .map(s -> new Recipient(s.getRecipientId(),
1120                         s.getAddress().toApiRecipientAddress(),
1121                         s.getContact(),
1122                         s.getProfileKey(),
1123                         s.getExpiringProfileKeyCredential(),
1124                         s.getProfile()))
1125                 .toList();
1126     }
1127
1128     @Override
1129     public String getContactOrProfileName(RecipientIdentifier.Single recipient) {
1130         final RecipientId recipientId;
1131         try {
1132             recipientId = context.getRecipientHelper().resolveRecipient(recipient);
1133         } catch (UnregisteredRecipientException e) {
1134             return null;
1135         }
1136
1137         final var contact = account.getContactStore().getContact(recipientId);
1138         if (contact != null && !Util.isEmpty(contact.getName())) {
1139             return contact.getName();
1140         }
1141
1142         final var profile = context.getProfileHelper().getRecipientProfile(recipientId);
1143         if (profile != null) {
1144             return profile.getDisplayName();
1145         }
1146
1147         return null;
1148     }
1149
1150     @Override
1151     public Group getGroup(GroupId groupId) {
1152         return toGroup(context.getGroupHelper().getGroup(groupId));
1153     }
1154
1155     @Override
1156     public List<Identity> getIdentities() {
1157         return account.getIdentityKeyStore()
1158                 .getIdentities()
1159                 .stream()
1160                 .map(this::toIdentity)
1161                 .filter(Objects::nonNull)
1162                 .toList();
1163     }
1164
1165     private Identity toIdentity(final IdentityInfo identityInfo) {
1166         if (identityInfo == null) {
1167             return null;
1168         }
1169
1170         final var address = account.getRecipientAddressResolver()
1171                 .resolveRecipientAddress(account.getRecipientResolver().resolveRecipient(identityInfo.getServiceId()));
1172         if (address.serviceId().isPresent() && !Objects.equals(address.serviceId().get(),
1173                 identityInfo.getServiceId())) {
1174             return null;
1175         }
1176         final var scannableFingerprint = context.getIdentityHelper()
1177                 .computeSafetyNumberForScanning(identityInfo.getServiceId(), identityInfo.getIdentityKey());
1178         return new Identity(address.toApiRecipientAddress(),
1179                 identityInfo.getIdentityKey(),
1180                 context.getIdentityHelper()
1181                         .computeSafetyNumber(identityInfo.getServiceId(), identityInfo.getIdentityKey()),
1182                 scannableFingerprint == null ? null : scannableFingerprint.getSerialized(),
1183                 identityInfo.getTrustLevel(),
1184                 identityInfo.getDateAddedTimestamp());
1185     }
1186
1187     @Override
1188     public List<Identity> getIdentities(RecipientIdentifier.Single recipient) {
1189         ServiceId serviceId;
1190         try {
1191             final var address = account.getRecipientAddressResolver()
1192                     .resolveRecipientAddress(context.getRecipientHelper().resolveRecipient(recipient));
1193             if (address.serviceId().isEmpty()) {
1194                 return List.of();
1195             }
1196             serviceId = address.serviceId().get();
1197         } catch (UnregisteredRecipientException e) {
1198             return List.of();
1199         }
1200         final var identity = account.getIdentityKeyStore().getIdentityInfo(serviceId);
1201         return identity == null ? List.of() : List.of(toIdentity(identity));
1202     }
1203
1204     @Override
1205     public boolean trustIdentityVerified(
1206             RecipientIdentifier.Single recipient, IdentityVerificationCode verificationCode
1207     ) throws UnregisteredRecipientException {
1208         if (verificationCode instanceof IdentityVerificationCode.Fingerprint fingerprint) {
1209             return trustIdentity(recipient,
1210                     r -> context.getIdentityHelper().trustIdentityVerified(r, fingerprint.fingerprint()));
1211         } else if (verificationCode instanceof IdentityVerificationCode.SafetyNumber safetyNumber) {
1212             return trustIdentity(recipient,
1213                     r -> context.getIdentityHelper().trustIdentityVerifiedSafetyNumber(r, safetyNumber.safetyNumber()));
1214         } else if (verificationCode instanceof IdentityVerificationCode.ScannableSafetyNumber safetyNumber) {
1215             return trustIdentity(recipient,
1216                     r -> context.getIdentityHelper().trustIdentityVerifiedSafetyNumber(r, safetyNumber.safetyNumber()));
1217         } else {
1218             throw new AssertionError("Invalid verification code type");
1219         }
1220     }
1221
1222     @Override
1223     public boolean trustIdentityAllKeys(RecipientIdentifier.Single recipient) throws UnregisteredRecipientException {
1224         return trustIdentity(recipient, r -> context.getIdentityHelper().trustIdentityAllKeys(r));
1225     }
1226
1227     private boolean trustIdentity(
1228             RecipientIdentifier.Single recipient, Function<RecipientId, Boolean> trustMethod
1229     ) throws UnregisteredRecipientException {
1230         final var recipientId = context.getRecipientHelper().resolveRecipient(recipient);
1231         final var updated = trustMethod.apply(recipientId);
1232         if (updated && this.isReceiving()) {
1233             context.getReceiveHelper().setNeedsToRetryFailedMessages(true);
1234         }
1235         return updated;
1236     }
1237
1238     @Override
1239     public void addAddressChangedListener(final Runnable listener) {
1240         synchronized (addressChangedListeners) {
1241             addressChangedListeners.add(listener);
1242         }
1243     }
1244
1245     @Override
1246     public void addClosedListener(final Runnable listener) {
1247         synchronized (closedListeners) {
1248             closedListeners.add(listener);
1249         }
1250     }
1251
1252     @Override
1253     public InputStream retrieveAttachment(final String id) throws IOException {
1254         return context.getAttachmentHelper().retrieveAttachment(id).getStream();
1255     }
1256
1257     @Override
1258     public void close() {
1259         Thread thread;
1260         synchronized (messageHandlers) {
1261             weakHandlers.clear();
1262             messageHandlers.clear();
1263             thread = receiveThread;
1264             receiveThread = null;
1265         }
1266         if (thread != null) {
1267             stopReceiveThread(thread);
1268         }
1269         executor.shutdown();
1270
1271         dependencies.getSignalWebSocket().disconnect();
1272         disposable.dispose();
1273
1274         if (account != null) {
1275             account.close();
1276         }
1277
1278         synchronized (closedListeners) {
1279             closedListeners.forEach(Runnable::run);
1280             closedListeners.clear();
1281         }
1282
1283         account = null;
1284     }
1285 }