add migration to modes

Author: yungwine

docs/en/controllers.md

@@ -25,12 +25,21 @@
 	```
 	Exit installer mode with `Ctrl+D`
 
-7. Set the liquid pool address, which will lend TON for validation:
+7. Set liquid-staking mode:
+
+ ```bash
+ enable_mode liquid-staking 
+ set stake null
+ ```
+
+> (!) If you were previously using nominator pools, do not forget to disable them using the `disable_mode nominator-pool` command.
+
+8Set the liquid pool address, which will lend TON for validation:
    ```
    set liquid_pool_addr <liquid-pool-address>
    ```
 
-8. Set the lending parameters that acceptable to you:
+9. Set the lending parameters that acceptable to you:
    ```
    set min_loan 41000
    set max_loan 43000
@@ -42,18 +51,18 @@
 * `43000` is the maximum loan amount we are willing to receive from the liquid pool,
 *   `1.5` 1.5 is the maximum interest rate value for the liquid pool per validation cycle, which we have agreed upon.
 
-9. Display the annual percentage of profit from the liquid pool:
+10. Display the annual percentage of profit from the liquid pool:
 	```
 	calculate_annual_controller_percentage
 	```
 
-10. Create two controllers with a single command:
+11. Create two controllers with a single command:
 
    ```
    new_controllers
    ```
 
-11. Enter `controllers_list` to display the controller addresses:
+12. Enter `controllers_list` to display the controller addresses:
 
    ```
    controllers_list
@@ -62,7 +71,7 @@
    kf_lT8QNykLh5PN5ictNX22maiyIf9iK787fXg6nJ_zB-jbN    active  0.720866
    ```
 
-12. Make a validator deposit in each controller:
+13. Make a validator deposit in each controller:
 
 
 ```
@@ -73,17 +82,7 @@ deposit_to_controller kf_lT8QNykLh5PN5ictNX22maiyIf9iK787fXg6nJ_zB-jbN 10000
 
 where `10000` TON is the deposit amount.
 
-13. Get approval for the controllers. Each pool may have its own approval issuance policy, check with the operator.
-
-14. Set controller mode:
-
- ```bash
- set useController true
- set stake null
- ```
-
-> (!) If you were previously using nominator pools, do not forget to disable them using the `set usePool false` command.
-
+14. Get approval for the controllers. Each pool may have its own approval issuance policy, check with the operator.
 
 ## Switching a Regular Validator to Controller Operating Mode
 

docs/en/nominator-pool.md

@@ -20,7 +20,14 @@
 
 4. Use the `aw` command to activate your validator wallet.
 
-5. Create two pools (for even and odd validation rounds):
+5. Activate pool mode:
+
+    ```bash
+    enable_mode nominator-pool 
+    set stake null
+    ```
+
+6. Create two pools (for even and odd validation rounds):
 
    ```bash
    new_pool p1 0 1 1000 300000
@@ -38,7 +45,7 @@
 
    > (!) Use https://tonmon.xyz/ to determine the current minimum validator stake.
 
-6. Type `pools_list` to display pool addresses:
+7. Type `pools_list` to display pool addresses:
 
    ```bash
    pools_list
@@ -47,7 +54,7 @@
    p2    empty   0        0f9qtmnzs2-PumMisKDmv6KNjNfOMDQG70mQdp-BcAhnV5jL
    ```
 
-7. Send 1 TON to each pool and activate the pools:
+8. Send 1 TON to each pool and activate the pools:
 
    ```bash
    mg validator_wallet_001 0f98YhXA9wnr0d5XRXT-I2yH54nyQzn0tuAYC4FunT780qIT 1
@@ -56,7 +63,7 @@
    activate_pool p2
    ```
 
-8. Type `pools_list` to display pools:
+9. Type `pools_list` to display pools:
 
    ```bash
    pools_list
@@ -65,9 +72,9 @@
    p2    active  0.731199806  kf9qtmnzs2-PumMisKDmv6KNjNfOMDQG70mQdp-BcAhnV8UO
    ```
 
-9. Open each pool via the link "https://tonscan.org/nominator/<address_of_pool>" and verify pool configurations.
+10. Open each pool via the link "https://tonscan.org/nominator/<address_of_pool>" and verify pool configurations.
 
-10. Proceed with the validator deposit to each pool:
+11. Proceed with the validator deposit to each pool:
 
     ```bash
     deposit_to_pool validator_wallet_001 <address_of_pool_1> 1005
@@ -76,7 +83,7 @@
 
    In these commands, `1005` TON is the deposit amount. Be aware that 1 TON will be deducted by the pool for processing the deposit.
 
-11. Proceed with the nominator deposit to each pool:
+12. Proceed with the nominator deposit to each pool:
 
     Visit the pool link (from **Step 9**) and click **ADD STAKE**. 
     You can also make a deposit using **mytonctrl**, using the following commands:
@@ -92,13 +99,6 @@
 
    > To withdraw a nominator deposit, send a transaction with the comment `w` to the pool address (attach 1 TON to process the transaction). You can also perform this action using **mytonctrl**.
 
-12. Activate pool mode:
-
-    ```bash
-    set usePool true
-    set stake null
-    ```
-    
 13. Invite nominators to deposit into your pools. The participation in validation will commence automatically.
 
     > (!) Ensure that you have at least 200 TON/month in your validator wallet for operation fees.

docs/ru/controllers.md

@@ -26,12 +26,21 @@
 	```
 	Выйдите из режима установщика сочетанием клавиш `Ctrl+D`
 
-7. Задайте адрес ликвидного пула, который будет одалживать TON для валидации:
+7. Активируйте режим работы контроллеров:
+
+    ```bash
+    enable_mode liquid-staking 
+    set stake null
+    ```
+	
+> (!) Если до этого вы использовали номинатор-пулы, не забудьте отключить их использование командой `disable_mode nominator-pool`.
+   
+8. Задайте адрес ликвидного пула, который будет одалживать TON для валидации:
 	```
 	set liquid_pool_addr <liquid-pool-address>
 	```
 
-8. Задайте параметры кредитования, которые вам подходят:
+9. Задайте параметры кредитования, которые вам подходят:
 	```
 	set min_loan 41000
 	set max_loan 43000
@@ -43,18 +52,18 @@
 *	`43000` - это максимальная сумма кредита который мы готовы получить у ликвидного пула,
 *	`1.5` - это максимальная процентная ставка ликвидного пула за один цикл валидации на которую мы согласны.
 
-9. Отобразите годовой процент прибыли от ликвидного пула:
+10. Отобразите годовой процент прибыли от ликвидного пула:
 	```
 	calculate_annual_controller_percentage
 	```
 
-10. Создайте два контроллера одной командой:
+11. Создайте два контроллера одной командой:
 
    ```
    new_controllers
    ```
 
-11. Введите `controllers_list` чтобы отобразить адреса контроллеров:
+12. Введите `controllers_list` чтобы отобразить адреса контроллеров:
 
    ```
    controllers_list
@@ -63,7 +72,7 @@
    kf_lT8QNykLh5PN5ictNX22maiyIf9iK787fXg6nJ_zB-jbN    active  0.720866
    ```
 
-12. Совершите депозит валидатора в каждый контроллер:
+13. Совершите депозит валидатора в каждый контроллер:
    
    ```
    deposit_to_controller kf89KYOeRPRRDyjt_3bPsz92cKSghRqw64efNr8mT1eeHDaS 10000
@@ -72,17 +81,7 @@
    
    где `10000` TON - это сумма депозита.
 
-13. Получите аппрувал контроллеров. У каждого пула может быть своя политика выдачи аппруволов, уточняйте у оператора.
-
-14. Активируйте режим работы контроллеров:
-
-    ```bash
-    set useController true
-    set stake null
-    ```
-	
-	> (!) Если до этого вы использовали номинатор-пулы, не забудьте отключить их использование командой `set usePool false`.
-
+14. Получите аппрувал контроллеров. У каждого пула может быть своя политика выдачи аппруволов, уточняйте у оператора.
 
 ## Переключение обычного валидатора в режим работы контроллеров
 

docs/ru/nominator-pool.md

@@ -20,7 +20,14 @@
 
 4. Используйте команду `aw` для активации кошелька валидатора.
 
-5. Создайте два пула (для четного и нечетного раунда проверки):
+5. Активируйте режим пула:
+
+    ```bash
+    enable_mode nominator-pool 
+    set stake null
+    ```
+
+6. Создайте два пула (для четного и нечетного раунда проверки):
 
    ```
    new_pool p1 0 1 1000 300000
@@ -38,7 +45,7 @@
 
    > (!) Используйте https://tonmon.xyz/, чтобы определить текущую минимальную ставку валидатора.
 
-6. Введите `pools_list` чтобы отобразить адреса пулов:
+7. Введите `pools_list` чтобы отобразить адреса пулов:
 
    ```
    pools_list
@@ -47,7 +54,7 @@
    p2    empty   0        0f9qtmnzs2-PumMisKDmv6KNjNfOMDQG70mQdp-BcAhnV5jL
    ```
 
-7. Отправьте по 1 TON в каждый пул и активируйте пулы:
+8. Отправьте по 1 TON в каждый пул и активируйте пулы:
    
    ```
    mg validator_wallet_001 0f98YhXA9wnr0d5XRXT-I2yH54nyQzn0tuAYC4FunT780qIT 1
@@ -56,7 +63,7 @@
    activate_pool p2
    ```
 
-8. Введите `pools_list` чтобы отобразить адреса пулов:
+9. Введите `pools_list` чтобы отобразить адреса пулов:
    
    ```
    pools_list
@@ -65,9 +72,9 @@
    p2    active  0.731199806  kf9qtmnzs2-PumMisKDmv6KNjNfOMDQG70mQdp-BcAhnV8UO
    ```
 
-9. Откройте каждый пул по ссылке "https://tonscan.org/nominator/<address_of_pool>" и проверьте конфигурацию пулов.
+10. Откройте каждый пул по ссылке "https://tonscan.org/nominator/<address_of_pool>" и проверьте конфигурацию пулов.
 
-10. Совершите депозит валидатора в каждый пул:
+11. Совершите депозит валидатора в каждый пул:
 
     ```bash
     deposit_to_pool validator_wallet_001 <address_of_pool_1> 1005
@@ -76,7 +83,7 @@
 
     где `1005` TON - это сумма депозита. Обратите внимание, что пул вычтет 1 TON за обработку депозита.
 
-11. Совершите депозит номинатора в каждый пул:
+12. Совершите депозит номинатора в каждый пул:
 
     Перейдите по ссылке пула (из **шага 9**) и нажмите **ADD STAKE**. 
     Вы также можете сделать депозит, используя **mytonctrl**, с помощью следующих команд:
@@ -92,13 +99,6 @@
 
     > Чтобы снять депозит номинатора, отправьте транзакцию с комментарием `w` на адрес пула (должен быть прикреплен 1 TON для обработки транзакции). Вы также можете сделать это с помощью **mytonctrl**.
 
-12. Активируйте режим пула:
-
-    ```bash
-    set usePool true
-    set stake null
-    ```
-
 13. Пригласите номинаторов сделать депозиты в ваши пулы. Участие в валидации начнется автоматически.
 
     > (!) Убедитесь, что у вас на кошельке валидатора есть как минимум 200 TON в месяц на операционные расходы.
@@ -109,7 +109,7 @@
 
 Если вы создаете пул для многих номинантов, то используйте что-то вроде этого: `new_pool p1 40 40 10000 10000` (максимум 40 номинантов, 40% доли валидатора, минимальная ставка участника 10K TON).
 
-## Переключение обычного валидатора в режим номинантского пула
+## Переключение обычного валидатора в режим номинаторского пула
 
 1. Введите `set stake 0`, чтобы отключить участие в выборах.
 

mytoncore/mytoncore.py

@@ -3155,10 +3155,28 @@ def SetSettings(self, name, data):
 		self.local.save()
 	#end define
 
+	def migrate_to_modes(self):
+		usePool = self.local.db.get('usePool')
+		if usePool is not None:
+			self.enable_mode('nominator-pool')
+			self.local.db.pop('usePool')
+
+		useController = self.local.db.get('useController')
+		if useController is not None:
+			self.enable_mode('liquid-staking')
+			self.local.db.pop('useController')
+		self.local.save()
+
+	def rollback_modes(self):
+		self.local.db['usePool'] = self.get_mode_value('nominator-pool')
+		self.local.db['useController'] = self.get_mode_value('liquid-staking')
+		self.local.save()
+
 	def get_modes(self):
 		current_modes = self.local.db.get('modes', {})
 		if 'modes' not in self.local.db:
 			self.local.db['modes'] = current_modes
+		self.migrate_to_modes()
 		for mode in MODES:
 			if mode not in current_modes:
 				current_modes[mode] = MODES[mode]  # assign default mode value
@@ -3185,15 +3203,13 @@ def get_mode_value(self, name):
 		return current_modes[name]
 
 	def using_nominator_pool(self):
-		return (self.local.db.get("usePool") or  # for backward compatibility
-				self.get_mode_value('nominator-pool'))
+		return self.get_mode_value('nominator-pool')
 
 	def using_single_nominator(self):
 		return self.get_mode_value('single-nominator')
 
 	def using_liquid_staking(self):
-		return (self.local.db.get("useController") or  # for backward compatibility
-				self.get_mode_value('liquid-staking'))
+		return self.get_mode_value('liquid-staking')
 
 	def using_pool(self) -> bool:
 		return self.using_nominator_pool() or self.using_single_nominator()

mytonctrl/mytonctrl.py

@@ -121,7 +121,7 @@ def inject_globals(func):
 	#console.AddItem("ssoc", inject_globals(SignShardOverlayCert), local.translate("ssoc_cmd"))
 	#console.AddItem("isoc", inject_globals(ImportShardOverlayCert), local.translate("isoc_cmd"))
 
-	if ton.get_mode_value('validator'):
+	if ton.using_validator():
 		from mytonctrl.modules.validator import ValidatorModule
 		module = ValidatorModule(ton, local)
 		module.add_console_commands(console)
@@ -1215,6 +1215,10 @@ def SetSettings(ton, args):
 	except:
 		color_print("{red}Bad args. Usage:{endc} set <settings-name> <settings-value>")
 		return
+	if name == 'usePool' or name == 'useController':
+		mode_name = 'nominator-pool' if name == 'usePool' else 'liquid-staking'
+		color_print("{red}" + f"Error: set {name} ... is deprecated and does not work" + "{endc}" + f"\nInstead, use <bold>enable_mode {mode_name}<endc>")
+		return
 	ton.SetSettings(name, value)
 	color_print("SetSettings - {green}OK{endc}")
 #end define