add welcome message

Author: yungwine

modules/alert_bot.py

@@ -11,6 +11,7 @@
 @dataclasses.dataclass
 class Alert:
     severity: str
+    description: str
     text: str
     timeout: int
 
@@ -29,75 +30,89 @@ def init_alerts():
     ALERTS = {
         "low_wallet_balance": Alert(
             "low",
-            "Validator wallet {wallet} balance is low: {balance} TON.",
+            "Validator's wallet balance is low",
+            "Validator's wallet {wallet} balance is less than 10 TON: {balance} TON.",
             18 * HOUR
         ),
         "db_usage_80": Alert(
             "high",
+            "Node's db usage is more than 80%",
             """TON DB usage > 80%. Clean the TON database: 
             https://docs.ton.org/participate/nodes/node-maintenance-and-security#database-grooming 
             or (and) set node\'s archive ttl to lower value.""",
             24 * HOUR
         ),
         "db_usage_95": Alert(
             "critical",
+            "Node's db usage is more than 95%",
             """TON DB usage > 95%. Disk is almost full, clean the TON database immediately: 
             https://docs.ton.org/participate/nodes/node-maintenance-and-security#database-grooming 
             or (and) set node\'s archive ttl to lower value.""",
             6 * HOUR
         ),
         "low_efficiency": Alert(
             "high",
-            """Validator efficiency is low: {efficiency}%.""",
+            "Validator had low efficiency in the validation round",
+            """Validator efficiency is less than 90%: <b>{efficiency}%</b>.""",
             VALIDATION_PERIOD // 3
         ),
         "out_of_sync": Alert(
             "critical",
-            "Node is out of sync on {sync} sec.",
+            "Validator had low efficiency in the round",
+            "Node is out of sync on more than 20 sec: <b>{sync} sec</b>.",
             300
         ),
         "service_down": Alert(
             "critical",
+            "Node is not running (service is down)",
             "validator.service is down.",
             300
         ),
         "adnl_connection_failed": Alert(
             "high",
+            "Node is not answering to ADNL connection",
             "ADNL connection to node failed",
             3 * HOUR
         ),
         "zero_block_created": Alert(
             "critical",
+            "Validator has not created any blocks in the last few hours",
             "Validator has not created any blocks in the last {hours} hours.",
             VALIDATION_PERIOD // 3
         ),
         "validator_slashed": Alert(
             "high",
+            "Validator has been slashed in the previous validation round",
             "Validator has been slashed in previous round for {amount} TON",
             FREEZE_PERIOD
         ),
         "stake_not_accepted": Alert(
             "high",
             "Validator's stake has not been accepted",
+            "Validator's stake has not been accepted",
             ELECTIONS_START_BEFORE
         ),
         "stake_accepted": Alert(
             "info",
+            "Validator's stake has been accepted (info alert with no sound)",
             "Validator's stake {stake} TON has been accepted",
             ELECTIONS_START_BEFORE
         ),
         "stake_returned": Alert(
             "info",
+            "Validator's stake has been returned (info alert with no sound)",
             "Validator's stake {stake} TON has been returned on address {address}. The reward amount is {reward} TON.",
             60
         ),
         "stake_not_returned": Alert(
             "high",
+            "Validator's stake has not been returned",
             "Validator's stake has not been returned on address {address}.",
             60
         ),
         "voting": Alert(
             "high",
+            "There is an active network proposal that has many votes but is not voted by the validator",
             "Found proposals with hashes `{hashes}` that have significant amount of votes, but current validator didn't vote for them. Please check @tonstatus for more details.",
             VALIDATION_PERIOD
         ),
@@ -120,14 +135,14 @@ def __init__(self, ton, local, *args, **kwargs):
         self.chat_id = None
         self.last_db_check = 0
 
-    def send_message(self, text: str, silent: bool = False):
+    def send_message(self, text: str, silent: bool = False, disable_web_page_preview: bool = False):
         if self.token is None:
             raise Exception("send_message error: token is not initialized")
         if self.chat_id is None:
             raise Exception("send_message error: chat_id is not initialized")
         request_url = f"https://api.telegram.org/bot{self.token}/sendMessage"
-        data = {'chat_id': self.chat_id, 'text': text, 'parse_mode': 'HTML', 'disable_notification': silent}
-        response = requests.post(request_url, data=data, timeout=3)
+        data = {'chat_id': self.chat_id, 'text': text, 'parse_mode': 'HTML', 'disable_notification': silent, 'link_preview_options': {'is_disabled': disable_web_page_preview}}
+        response = requests.post(request_url, json=data, timeout=3)
         if response.status_code != 200:
             raise Exception(f"send_message error: {response.text}")
         response = response.json()
@@ -144,8 +159,7 @@ def send_alert(self, alert_name: str, *args, **kwargs):
             raise Exception(f"Alert {alert_name} not found")
         alert_name_readable = alert_name.replace('_', ' ').title()
         text = '🆘' if alert.severity != 'info' else ''
-        text += f'''
-️ <b>Node {self.hostname}: {alert_name_readable} </b> 
+        text += f''' <b>Node {self.hostname}: {alert_name_readable} </b> 
 
 {alert.text.format(*args, **kwargs)}
 
@@ -236,6 +250,39 @@ def test_alert(self, args):
             self.init()
         self.send_message('Test alert')
 
+    def send_welcome_message(self):
+        message = """
+👋 Hello, this is alert bot.
+
+I don't process any commands, I only send notifications. 
+
+Current notifications enabled:
+
+"""
+        for alert in ALERTS.values():
+            message += f"- {alert.description}\n"
+
+        message += """
+If you want, you can disable some notifications in mytonctrl by the <a href="https://docs.ton.org/v3/guidelines/nodes/maintenance-guidelines/mytonctrl-private-alerting#endisbling-alerts"> instruction </a>.
+
+Full bot documentation <a href="https://docs.ton.org/v3/guidelines/nodes/maintenance-guidelines/mytonctrl-private-alerting"> here</a>.
+"""
+        self.send_message(text=message, disable_web_page_preview=True)
+
+    def on_set_chat_id(self, chat_id):
+        self.token = self.ton.local.db.get("BotToken")
+        if self.token is None:
+            raise Exception("BotToken is not set")
+        self.chat_id = chat_id
+        init_alerts()
+        try:
+            self.send_welcome_message()
+            return True
+        except Exception as e:
+            self.local.add_log(f"Error while sending welcome message: {e}", "error")
+            self.local.add_log(f"If you want the bot to write to a multi-person chat group, make sure the bot is added to that chat group and has admin rights. If it is not - do it and run the command `set ChatId <ChatId>` again.", "info")
+            return False
+
     def check_db_usage(self):
         if time.time() - self.last_db_check < 600:
             return

mytonctrl/mytonctrl.py

@@ -879,7 +879,7 @@ def GetSettings(ton, args):
 	print(json.dumps(result, indent=2))
 #end define
 
-def SetSettings(ton, args):
+def SetSettings(local, ton, args):
 	try:
 		name = args[0]
 		value = args[1]
@@ -891,6 +891,10 @@ def SetSettings(ton, args):
 		color_print(f"{{red}} Error: set {name} ... is deprecated and does not work {{endc}}."
 					f"\nInstead, use {{bold}}enable_mode {mode_name}{{endc}}")
 		return
+	if name == 'ChatId':
+		from modules.alert_bot import AlertBotModule
+		if not AlertBotModule(ton, local).on_set_chat_id(value):
+			return
 	force = False
 	if len(args) > 2:
 		if args[2] == "--force":