From e2f09722b317ffb75d35ce066f398b1aecb3ff6a Mon Sep 17 00:00:00 2001 From: AlexG Date: Wed, 21 Jun 2023 13:27:25 +0400 Subject: [PATCH] controllers_translate_added - Added controlleres.md en version. - Minor fixes for links in the controllers.md in the ru version. --- docs/en/controllers.md | 83 ++++++++++++++++++++++++++++++++++++++++++ docs/ru/controllers.md | 13 ++++--- 2 files changed, 90 insertions(+), 6 deletions(-) create mode 100644 docs/en/controllers.md diff --git a/docs/en/controllers.md b/docs/en/controllers.md new file mode 100644 index 00000000..52150228 --- /dev/null +++ b/docs/en/controllers.md @@ -0,0 +1,83 @@ +# 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. Set the liquid pool address, which will lend TON for validation: + ``` + set liquid_pool_addr + ``` + +7. 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. + +8. Create two controllers with a single command: + + ``` + new_controllers + ``` + +9. 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 + ``` + +10. 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. + +11. Get approval for the controllers. Each pool may have its own approval issuance policy, check with the operator. + +12. 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. + + +## 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**. \ No newline at end of file diff --git a/docs/ru/controllers.md b/docs/ru/controllers.md index c0320146..aff65fd5 100644 --- a/docs/ru/controllers.md +++ b/docs/ru/controllers.md @@ -12,7 +12,7 @@ 2. Установите и синхронизируйте **mytonctrl** в соответствии с описанием в [этой инструкции](https://github.com/ton-blockchain/mytonctrl/blob/master/docs/ru/manual-ubuntu.md) — следуйте **только** пунктам 1, 2 и 3. - Вы также можете обратиться к этой [Видеоинструкции](https://ton.org/docs/#/nodes/run-node) для дополнительной помощи. + Вы также можете обратиться к этой [Видеоинструкции](https://docs.ton.org/participate/run-nodes/full-node#installation) для дополнительной помощи. 3. Переведите 1 TON на адрес кошелька валидатора, который отображается в списке `wl`. @@ -20,21 +20,22 @@ 5. Переведите достаточно TON на адрес кошелька валидатора. -6. Задайте адрес ликвидного пула, котрый будет одалживать TON для валидации: +6. Задайте адрес ликвидного пула, который будет одалживать TON для валидации: ``` set liquid_pool_addr ``` -7. Задайте параметры кредитования, котрые вам подходят: +7. Задайте параметры кредитования, которые вам подходят: ``` set min_loan 41000 set max_loan 43000 set max_interest_percent 1.5 ``` - где `41000` - это минимальная сумма кредита который мы готовы получить у ликвидного пула, - `43000` - это максимальная сумма кредита который мы готовы получить у ликвидного пула, - `1.5` - это максимальная процентная ставка ликвидного пула за один цикл валидации на которую мы согласны. + где +* `41000` - это минимальная сумма кредита который мы готовы получить у ликвидного пула, +* `43000` - это максимальная сумма кредита который мы готовы получить у ликвидного пула, +* `1.5` - это максимальная процентная ставка ликвидного пула за один цикл валидации на которую мы согласны. 8. Создайте два контроллера одной командой: