-
Notifications
You must be signed in to change notification settings - Fork 1
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[Polkadot Wiki Migration] Chill Your Node #39
Open
CrackTheCode016
wants to merge
3
commits into
master
Choose a base branch
from
bd-infra-how-to-chill
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+69
−0
Open
Changes from all commits
Commits
Show all changes
3 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Binary file added
BIN
+25.9 KB
images/infrastructure/operational-tasks/staking-keys-stash-proxy.webp
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +1,4 @@ | ||
title: Operational Tasks | ||
nav: | ||
- index.md | ||
- chill-your-node.md |
68 changes: 68 additions & 0 deletions
68
infrastructure/validators/operational-tasks/chill-your-node.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
@@ -0,0 +1,68 @@ | ||||||
--- | ||||||
title: Chill Your Node | ||||||
description: Instructions on chilling as a network participant. | ||||||
--- | ||||||
|
||||||
Staking bonds can be in any of the three states: validating, nominating, or chilled (neither | ||||||
validating nor nominating). When you want to temporarily pause your active engagement in | ||||||
staking but don't want to unbond your funds, they can choose to "chill" your involvement and | ||||||
CrackTheCode016 marked this conversation as resolved.
Show resolved
Hide resolved
CrackTheCode016 marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
keep your funds bonded. | ||||||
|
||||||
An account can step back from participating in active staking by clicking "Stop" under the Network > | ||||||
Staking > Account actions page in [Polkadot.js Apps](https://polkadot.js.org/apps){target=\_blank} or by calling the [`chill`](https://paritytech.github.io/polkadot-sdk/master/pallet_staking/enum.Call.html#variant.chill){target=\_blank} extrinsic in the staking pallet. When an account chooses to chill, it becomes inactive in the next era. The call must be signed by | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
the _staking proxy_ account, not the _stash_. | ||||||
|
||||||
!!!note Primer on stash and staking proxy accounts | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Add link to the Accounts section |
||||||
If you need a refresher on the different responsibilities of the stash and staking proxy account | ||||||
when staking, take a look at the accounts section in the general staking guide. | ||||||
|
||||||
![staking](/images/infrastructure/operational-tasks/staking-keys-stash-proxy.webp) | ||||||
|
||||||
## Consideration for Staking Election | ||||||
|
||||||
A bond that is actively participating in staking but chilled would continue to participate in | ||||||
staking for the rest of the current era. If the bond was chilled in sessions 1 through 4 and | ||||||
continues to be chilled for the rest of the era, it would *not* be selected for election in the next | ||||||
era. If a bond was chilled for the entire session 5, it would not be considered in the next | ||||||
election. If the bond was chilled in session 6, its participation in the next era's election would | ||||||
depend on its state in session 5. | ||||||
|
||||||
## Chilling as a Nominator | ||||||
|
||||||
When you chill after being a nominator, your nominations will be reset. This means that when you | ||||||
decide to start nominating again you will need to select validators to nominate once again. These | ||||||
can be the same validators if you prefer, or, a completely new set. Just be aware - your nominations | ||||||
won't persist across chills. | ||||||
|
||||||
Your nominator will remain bonded when it is chilled. When you are ready to nominate again, you will | ||||||
not need to go through the whole process of bonding again, rather, you will issue a new nominate | ||||||
call that specifies the new validators to nominate. | ||||||
|
||||||
## Chilling as a Validator | ||||||
|
||||||
When you voluntarily chill after being a validator, your nominators will remain. As long as your | ||||||
nominators make no action, you will still have the nominations when you choose to become an active | ||||||
validator once again. You bond however would not be listed as a nominable validator thus any | ||||||
dawnkelly09 marked this conversation as resolved.
Show resolved
Hide resolved
dawnkelly09 marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
nominators issuing new or revisions to existing nominations would not be able to select your bond. | ||||||
|
||||||
When you become an active validator, you will also need to reset your validator preferences | ||||||
(commission, etc.). These can be configured as the same values set previously or something | ||||||
different. | ||||||
|
||||||
## Chill Other | ||||||
|
||||||
An unbounded and unlimited number of nominators and validators in [Polkadot's NPoS](https://wiki.polkadot.network/docs/learn-phragmen){target=_blank} isn't possible due to constraints in the runtime. As a result, multiple checks are incorporated to keep the size of staking system manageable, like mandating minimum active bond requirements for both nominators and validators. When these requirements are modified through on-chain governance, they can be enforced only on the accounts that newly call `nominate` or `validate` after the update. The changes to the bonding parameters would not automatically chill the active accounts on-chain which don't meet the requirements. | ||||||
|
||||||
!!!note "Chill Threshold" | ||||||
`ChillThreshold` defines how close to the max nominators or validators that must be reached before users can start chilling one another. | ||||||
|
||||||
For instance, consider a scenario where the minimum staking requirement for nominators is | ||||||
changed from 80 DOTs to 120 DOTs. An account that was actively nominating with 80 DOTs before this | ||||||
update would still keep receiving staking rewards. To handle this corner case, the `chillOther` | ||||||
extrinsic was incorporated which also helps to keep things backwards compatible and safe. The | ||||||
`chillOther` extrinsic is permissionless and any third party user can target it on an account where | ||||||
dawnkelly09 marked this conversation as resolved.
Show resolved
Hide resolved
dawnkelly09 marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
the minimum active bond isn't satisfied, and chill that account. The list of addresses of all the | ||||||
active validators and their nominators can be viewed by running [validator stats](https://github.com/w3f/validator-stats){target=_blank} script. | ||||||
|
||||||
!!!info "Chill Other on Polkadot Network" | ||||||
Through [Referendum 90](https://polkadot.polkassembly.io/referendum/90){target=_blank}, `maxNominatorCount` on Polkadot is set to `None` eliminating the upper bound on the number of nominators on the network. Due to this, the `chillOther` extrinsic on Polkadot network has no effect as the chill threshold will never be met. |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Description too short