From 611f9eee913e4d254fe6ab5ff3ef295f35121015 Mon Sep 17 00:00:00 2001 From: James Bayly Date: Wed, 24 Jul 2024 10:54:17 +0300 Subject: [PATCH] Auto reduce allocation (#545) --- .../img/network/indexer_auto_allocation.png | Bin 0 -> 72274 bytes .../setup/becoming-a-node-operator.md | 21 +++++++++++----- docs/subquery_network/node_operators/stake.md | 23 ++++++++++++++++-- 3 files changed, 36 insertions(+), 8 deletions(-) create mode 100644 docs/.vuepress/public/assets/img/network/indexer_auto_allocation.png diff --git a/docs/.vuepress/public/assets/img/network/indexer_auto_allocation.png b/docs/.vuepress/public/assets/img/network/indexer_auto_allocation.png new file mode 100644 index 0000000000000000000000000000000000000000..91322fbbd24586eefbd6d30482584126c80bac3e GIT binary patch literal 72274 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 literal 0 HcmV?d00001 diff --git a/docs/subquery_network/node_operators/setup/becoming-a-node-operator.md b/docs/subquery_network/node_operators/setup/becoming-a-node-operator.md index 681f21ae49a..ce00a8741f4 100644 --- a/docs/subquery_network/node_operators/setup/becoming-a-node-operator.md +++ b/docs/subquery_network/node_operators/setup/becoming-a-node-operator.md @@ -16,9 +16,10 @@ Let's take an overview of the basic steps involved in the process: | [Step 4](#4-index-or-sync-a-project) | Index a project or sync an RPC endpoint | | [Step 5](#5-create-a-plan-from-a-plan-template) | Create a Plan from a Plan Template | | [Step 6](#6-configure-a-node-operator-commission-rate-nocr) | Set a Node Operator Commission Rate | -| [Step 7](#7-troubleshooting-and-faqs) | Troubleshooting and FAQs | -| [Step 8](#8-setting-up-a-grafana-dashboard-optional) | Optional: Setting up a Grafana Dashboard | -| [Step 9](#9-upgrade-node-operator-services-ongoing) | Ongoing: Update Node Operator Services | +| [Step 7](#7-allocate-your-sqt-stake-to-start-receiving-rewards) | Allocate your SQT to start receiving rewards | +| [Step 8](#8-troubleshooting-and-faqs) | Troubleshooting and FAQs | +| [Step 9](#9-setting-up-a-grafana-dashboard-optional) | Optional: Setting up a Grafana Dashboard | +| [Step 10](#10-upgrade-node-operator-services-ongoing) | Ongoing: Update Node Operator Services | ## 1. Deploy Node Operator Services @@ -119,11 +120,19 @@ Enter a new value (in a percent) and submit via your wallet. Changes will come into effect at the start of the next [Era](../../introduction/era.md). -## 7. Troubleshooting and FAQs +## 7. Allocate your SQT stake to start receiving rewards + +You must [actively allocate or assign your staked and delegated SQT to certain projects](../stake.md#allocating-stake) you run in order to receive rewards. Unallocated SQT is essentially wasted. + +We suggest you check this page at the start of each Era, and make sure you are keeping on top to maximise allocated SQT, and also allocate SQT to more profitable projects (e.g. ones with a higer APY). [Find out how here](../stake.md#allocating-stake). + +We also highly recommend that you enable [Auto Reduce Over Allocation](../stake.md#automatically-reduce-over-allocation) to prevent being over allocated. + +## 8. Troubleshooting and FAQs Visit [Troubleshooting](./troubleshooting.md) or [FAQs](./faq.md) if you run into technical issues. -## 8. Setting up a Grafana Dashboard (Optional) +## 9. Setting up a Grafana Dashboard (Optional) This guide will walk you through setting up a preconfigured Grafana Dashboard to view metrics from the `indexer-coordinator` and `indexer-proxy`. @@ -174,7 +183,7 @@ Once you have successfully logged in, look for 'dashboards' on the left-hand sid ![grafana_query_count](/assets/img/network/grafana_query_count.png) ![grafana_query_stats](/assets/img/network/grafana_query_stats.png) -## 9. Upgrade Node Operator services (Ongoing) +## 10. Upgrade Node Operator services (Ongoing) To upgrade a Node Operator service, you will need to update the version of the image used in the docker-compose file. This can be done by updating the image field in the service definition to the new version you want to use. diff --git a/docs/subquery_network/node_operators/stake.md b/docs/subquery_network/node_operators/stake.md index f0a7cf2c802..312d650ce3b 100644 --- a/docs/subquery_network/node_operators/stake.md +++ b/docs/subquery_network/node_operators/stake.md @@ -1,8 +1,8 @@ # Staking and Allocating SQT -:::tip New for Mainnet - Please read +:::info -One key difference between Kepler and the mainnet is that now Node Operators must actively manage their staking allocation to each project deployment. +Node Operators must actively manage their staking allocation to each project deployment to maximise their rewards. We also highly recommend that you enable [Auto Reduce Over Allocation](#automatically-reduce-over-allocation) to prevent being [over allocated](#over-allocated-stake). ::: @@ -59,6 +59,25 @@ When the Current Total Stake bar turns red, you are over allocated. You must imm You can use the estimate of the Own Stake and Total Delegated for the next Era on this page to avoid situations where departing delegators might result in you over allocating. +## Automatically Reduce Over Allocation + +:::info + +We highly recommend that you enable this feature + +::: + +In your Node Operator Admin App and in the Config section there is a setting called "Auto Reduce Over Allocation", we highly recommend that you enable it. + +If enabled, in the event of when you are overallocated, then your allocaton will automaticaly evenly reduce across all of your projects until you are no longer over allocated +- Allocation reduction will be by an even percent. For example, each project will decrease by 10% of it's initial allocation. +- Allocation will not be reduced below 1 SQT on any single project +- If you have 0 projects then it will un-allocate all SQT + +It runs immediately at the start of the next era when delegation changes take effect. + +![Enabling Node Operator Auto Reduce Allocation](/assets/img/network/indexer_auto_allocation.png) + ## How much SQT should you Stake There are multiple reasons why Node Operators should consider staking more SQT or attracting more Delegation.