Skip to content
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] Stop Validating #40

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions infrastructure/validators/offboarding/.pages
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
title: Offboarding
nav:
- index.md
- stop-validating.md
48 changes: 48 additions & 0 deletions infrastructure/validators/offboarding/stop-validating.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
title: Stop Validating
description: Instructions on how to stop validating, unbonding your tokens, purging validator keys, and chilling your Polkadot validator.
---

If you wish to remain a validator or nominator (for example, you're only stopping for planned downtime or server maintenance), submitting the `chill` extrinsic in the `staking` pallet should suffice. It is
only if you wish to unbond funds or reap an account that you should continue with the following.
dawnkelly09 marked this conversation as resolved.
Show resolved Hide resolved
dawnkelly09 marked this conversation as resolved.
Show resolved Hide resolved

To ensure a smooth stop to validation, make sure you should do the following actions:

- Chill your validator
- Purge validator session keys
- Unbond your tokens
dawnkelly09 marked this conversation as resolved.
Show resolved Hide resolved
dawnkelly09 marked this conversation as resolved.
Show resolved Hide resolved

These can all be done with [Polkadot.js](https://polkadot.js.org/apps){target=_blank} interface or with extrinsics.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of saying with extrinsics we could mention something like this:

Suggested change
These can all be done with [Polkadot.js](https://polkadot.js.org/apps){target=_blank} interface or with extrinsics.
These can all be done with [Polkadot.js Apps](https://polkadot.js.org/apps){target=\_blank} UI or by using various [libraries](https://wiki.polkadot.network/docs/build-tools-index#libraries){target=\_blank} such as [Polkadot.js API](https://polkadot.js.org/docs/){target=\_blank}.


<!-- TODO: add links later -->

## Chill Validator

To chill your validator or nominator, call the `staking.chill()` extrinsic. See the [How to Chill](todo:link) page for more information. You can also claim your rewards at this time.

## Purge Validator Session Keys

Purging validator session keys removes the key reference. This can be done through the
`session.purgeKeys()` extrinsic. The key reference exists on the account that originally called the
`session.set_keys()` extrinsic, which could be the stash or the staking proxy (at the time the keys
were set).

!!!warning "Purge keys using the same account that set the keys"
Make sure to call the session.purge_keys() extrinsic from the same account that set the keys in the
first place in order for the correct reference to be removed. Calling the `session.purge_keys()`
from the wrong account, although it may succeed, will result in a reference on the other account
that _cannot_ be removed, and as a result that account cannot be reaped.

!!!warning
**If you skip this step, you won't be able to reap your stash account**, and you will also need
to rebond, purge the session keys, unbond, and wait the unbonding period again before being able to
dawnkelly09 marked this conversation as resolved.
Show resolved Hide resolved
dawnkelly09 marked this conversation as resolved.
Show resolved Hide resolved
dawnkelly09 marked this conversation as resolved.
Show resolved Hide resolved
dawnkelly09 marked this conversation as resolved.
Show resolved Hide resolved
dawnkelly09 marked this conversation as resolved.
Show resolved Hide resolved
dawnkelly09 marked this conversation as resolved.
Show resolved Hide resolved
transfer your tokens.

See [Unbonding and Rebonding on the Polkadot Wiki](https://wiki.polkadot.network/docs/learn-guides-nominator#bond-your-tokens{target=_blank}) for more details.


## Unbond your Tokens

Unbonding your tokens can be done through the `Network > Staking > Account actions` page in
dawnkelly09 marked this conversation as resolved.
Show resolved Hide resolved
dawnkelly09 marked this conversation as resolved.
Show resolved Hide resolved
PolkadotJS Apps by clicking the corresponding stash account dropdown and selecting **Unbond Funds**.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
PolkadotJS Apps by clicking the corresponding stash account dropdown and selecting **Unbond Funds**.
Polkadot.js Apps by clicking the corresponding stash account dropdown and selecting **Unbond Funds**.

This can also be done through the `staking.unbond()` extrinsic with the staking proxy account.