fix: improve error messages for time synchronization issues in SecurityCheckMismatch

HitaloM · HitaloM · commit 6b0d697401a1 · 2025-04-17T20:04:26.000-03:00
diff --git a/hydrogram/session/session.py b/hydrogram/session/session.py
@@ -248,13 +248,17 @@ async def handle_packet(self, packet):
                     if time_diff > 30:
                         raise SecurityCheckMismatch(
                             "The msg_id belongs to over 30 seconds in the future. "
-                            "Most likely the client time has to be synchronized."
+                            "This usually means your system clock is ahead of the actual time. "
+                            "Please synchronize your system time with an NTP server to avoid "
+                            "this error in Hydrogram."
                         )
 
                     if time_diff < -300:
                         raise SecurityCheckMismatch(
                             "The msg_id belongs to over 300 seconds in the past. "
-                            "Most likely the client time has to be synchronized."
+                            "This usually means your system clock is behind the actual time. "
+                            "Please synchronize your system time with an NTP server to avoid "
+                            "this error in Hydrogram."
                         )
             except SecurityCheckMismatch as e:
                 log.info("Discarding packet: %s", e)
