ton-blockchain · igroman787 · Mar 18, 2024 · May 29, 2023 · Jun 14, 2023 · Jun 20, 2023
diff --git a/docs/en/controllers.md b/docs/en/controllers.md
@@ -0,0 +1,93 @@
+# Controllers
+
+## Launching a Validator in Controller Mode
+
+1. Prepare the hardware for the validator - 32 virtual cores, 64GB of memory, 1TB SSD, fixed IP address, and 1Gb/s internet speed.
+
+   To maintain network stability, it is recommended to place validators in different locations around the world, rather than concentrating them in a single data center. You can use [this site](https://status.toncenter.com/) to determine the load on various locations. According to the map, there is a high load on data centers in Europe, especially in Finland, Germany, and Paris. Therefore, using providers such as Hetzner and OVH is not recommended.
+
+   > Ensure your hardware meets or exceeds the specified configuration. Running the validator on inappropriate hardware can harm the network and result in penalties.
+   > Since May 2021, Hetzner has prohibited mining on its servers. This rule currently applies to both PoW and PoS algorithms. Even installing a regular node will be considered a breach of contract.
+
+2. Install and synchronize **mytonctrl** according to the description in [this instruction](https://github.com/ton-blockchain/mytonctrl/blob/master/docs/en/manual-ubuntu.md) — follow **only** paragraphs 1, 2, and 3.
+
+   You can also refer to this [Video Tutorial](https://docs.ton.org/participate/run-nodes/full-node#installation) for additional help.
+
+3. Transfer 1 TON to the validator wallet address, which is displayed in the `wl` list.
+
+4. Use the `aw` command to activate the validator's wallet.
+
+5. Transfer enough TON to the validator wallet address.
+
+6. Enable the ton-http-api service:
+	```
+	mytonctrl -> installer -> enable THA
+	```
+	Exit installer mode with `Ctrl+D`
+
+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>
+   ```
+
+9. Set the lending parameters that acceptable to you:
+   ```
+   set min_loan 41000
+   set max_loan 43000
+   set max_interest_percent 1.5
+   ```
+
+   where 
+* `41000` is the minimum loan amount we are willing to receive from the liquid pool,
+* `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.
+
+10. Display the annual percentage of profit from the liquid pool:
+	```
+	calculate_annual_controller_percentage
+	```
+
+11. Create two controllers with a single command:
+
+   ```
+   new_controllers
+   ```
+
+12. Enter `controllers_list` to display the controller addresses:
+
+   ```
+   controllers_list
+   Address                                             Status  Balance
+   kf89KYOeRPRRDyjt_3bPsz92cKSghRqw64efNr8mT1eeHDaS    active  0.704345
+   kf_lT8QNykLh5PN5ictNX22maiyIf9iK787fXg6nJ_zB-jbN    active  0.720866
+   ```
+
+13. Make a validator deposit in each controller:
+
+
+```
+deposit_to_controller kf89KYOeRPRRDyjt_3bPsz92cKSghRqw64efNr8mT1eeHDaS 10000
+deposit_to_controller kf_lT8QNykLh5PN5ictNX22maiyIf9iK787fXg6nJ_zB-jbN 10000
+```
+
+
+where `10000` TON is the deposit amount.
+
+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
+
+1. Enter `set stake 0` to stop participating in elections.
+
+2. Wait until both of your deposits have been returned from the Elector.
+
+3. Follow the instructions under "Launching a Validator in Controller Mode", beginning with **Step 6**.
diff --git a/docs/en/nominator-pool.md b/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.

diff --git a/docs/ru/controllers.md b/docs/ru/controllers.md
@@ -0,0 +1,92 @@
+# Контроллеры
+
+## Запуск валидатора в режиме работы контроллеров
+
+1. Подготовьте аппаратное обеспечение для валидатора - 32 виртуальных ядер, 64GB памяти, 1TB SSD, фиксированный IP-адрес, скорость интернета 1Gb/s.
+
+   Для поддержания стабильности сети рекомендуется разместить валидаторы в различных местах по всему миру, а не концентрировать их в одном дата-центре. Вы можете использовать [этот сайт](https://status.toncenter.com/) для определения нагрузки на различные места. Согласно карте, высокая нагрузка на дата-центры в Европе, особенно в Финляндии, Германии и Париже. Поэтому использование провайдеров, таких как Hetzner и OVH, не рекомендуется.
+
+   > Ваше оборудование должно соответствовать указанной конфигурации или быть выше. Запуск валидатора на слабом оборудовании негативно влияет на сеть и может привести к штрафам.
+
+   > С мая 2021 года Hetzner запретил майнинг на своих серверах, в настоящее время под это правило попадают алгоритмы PoW и PoS. Установка даже обычного узла будет считаться нарушением условий договора.
+
+2. Установите и синхронизируйте **mytonctrl** в соответствии с описанием в [этой инструкции](https://github.com/ton-blockchain/mytonctrl/blob/master/docs/ru/manual-ubuntu.md) — следуйте **только** пунктам 1, 2 и 3.
+
+   Вы также можете обратиться к этой [Видеоинструкции](https://docs.ton.org/participate/run-nodes/full-node#installation) для дополнительной помощи.
+
+3. Переведите 1 TON на адрес кошелька валидатора, который отображается в списке `wl`.
+
+4. Используйте команду `aw` для активации кошелька валидатора.
+
+5. Переведите достаточно TON на адрес кошелька валидатора.
+
+6. Включите ton-http-api службу:
+	```
+	mytonctrl -> installer -> enable THA
+	```
+	Выйдите из режима установщика сочетанием клавиш `Ctrl+D`
+
+7. Активируйте режим работы контроллеров:
+
+    ```bash
+    enable_mode liquid-staking 
+    set stake null
+    ```
+
+> (!) Если до этого вы использовали номинатор-пулы, не забудьте отключить их использование командой `disable_mode nominator-pool`.
+
+8. Задайте адрес ликвидного пула, который будет одалживать TON для валидации:
+	```
+	set liquid_pool_addr <liquid-pool-address>
+	```
+
+9. Задайте параметры кредитования, которые вам подходят:
+	```
+	set min_loan 41000
+	set max_loan 43000
+	set max_interest_percent 1.5
+	```
+
+	где 
+* `41000` - это минимальная сумма кредита который мы готовы получить у ликвидного пула,
+*	`43000` - это максимальная сумма кредита который мы готовы получить у ликвидного пула,
+*	`1.5` - это максимальная процентная ставка ликвидного пула за один цикл валидации на которую мы согласны.
+
+10. Отобразите годовой процент прибыли от ликвидного пула:
+	```
+	calculate_annual_controller_percentage
+	```
+
+11. Создайте два контроллера одной командой:
+
+   ```
+   new_controllers
+   ```
+
+12. Введите `controllers_list` чтобы отобразить адреса контроллеров:
+
+   ```
+   controllers_list
+   Address                                             Status  Balance
+   kf89KYOeRPRRDyjt_3bPsz92cKSghRqw64efNr8mT1eeHDaS    active  0.704345
+   kf_lT8QNykLh5PN5ictNX22maiyIf9iK787fXg6nJ_zB-jbN    active  0.720866
+   ```
+
+13. Совершите депозит валидатора в каждый контроллер:
+   
+   ```
+   deposit_to_controller kf89KYOeRPRRDyjt_3bPsz92cKSghRqw64efNr8mT1eeHDaS 10000
+   deposit_to_controller kf_lT8QNykLh5PN5ictNX22maiyIf9iK787fXg6nJ_zB-jbN 10000
+   ```
+   
+   где `10000` TON - это сумма депозита.
+
+14. Получите аппрувал контроллеров. У каждого пула может быть своя политика выдачи аппруволов, уточняйте у оператора.
+
+## Переключение обычного валидатора в режим работы контроллеров
+
+1. Введите `set stake 0`, чтобы отключить участие в выборах.
+
+2. Дождитесь, когда оба ваших депозита вернутся от электора.
+
+3. Следуйте инструкциям "Запуск валидатора в режиме работы контроллеров", начиная с **6-го шага**.
diff --git a/docs/ru/nominator-pool.md b/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`, чтобы отключить участие в выборах.