diff --git a/docs/learn/learn-guides-staking.md b/docs/learn/learn-guides-staking.md index c41c39733755..7a244d95ca20 100644 --- a/docs/learn/learn-guides-staking.md +++ b/docs/learn/learn-guides-staking.md @@ -13,26 +13,22 @@ See [this page](./learn-staking.md) to learn about staking. ## Nominate Using Polkadot-JS -:::info Using Polkadot-JS UI as a Nominator - -Here is the list of basic nominator actions that can be performed using the Polkadot-JS UI. +:::info Video Tutorials -- [How to Bond Tokens and Nominate](https://support.polkadot.network/support/solutions/articles/65000168057-polkadot-js-ui-how-do-i-stake-nominate-on-polkadot-) -- [How to Select Validators](https://support.polkadot.network/support/solutions/articles/65000150130-how-do-i-know-which-validators-to-choose-) -- [How to Stop Nominating & Unbond Tokens](https://support.polkadot.network/support/solutions/articles/65000167902-how-can-i-unstake-my-tokens-again-) -- [How to Rebond Tokens](https://support.polkadot.network/support/solutions/articles/65000170241-polkadot-js-ui-how-to-rebond-tokens-during-the-unbonding-period) +- [How to Nominate/Stake](https://youtu.be/FCXC0CDhyS4?t=219) +- [Staking with a Ledger device and Polkadot-JS](https://youtu.be/7VlTncHCGPc) +- [Staking with a Ledger device and Ledger Live](https://www.youtube.com/watch?v=jL-N_IWiYVA) ::: -:::info Video Tutorials +### Bond your tokens -- [How to Nominate/Stake](https://youtu.be/FCXC0CDhyS4?t=219) -- [Staking with a Ledger and Polkadot-JS](https://youtu.be/7VlTncHCGPc) -- [Staking with a Ledger and Ledger Live](https://www.youtube.com/watch?v=jL-N_IWiYVA) +:::info Support Article -::: +Read the support article about +[How to Bond Tokens and Nominate](https://support.polkadot.network/support/solutions/articles/65000168057-polkadot-js-ui-how-do-i-stake-nominate-on-polkadot-). -### Step 1: Bond your tokens +::: On the [Polkadot-JS UI](https://polkadot.js.org/apps) navigate to the "Staking" tab (within the "Network" menu). @@ -83,14 +79,14 @@ earn compound interest. ![Payout account selection dropdown with the custom account option highlighted](../assets/payout/01.png) -:::note Explainer video on using the Polkadot-JS UI +### Nominate a validator -These concepts have been further explained in Polkadot's -[UI Walkthrough Video](https://www.youtube.com/watch?v=mNStMPZjiHM&list=PLOyWqupZ-WGuAuS00rK-pebTMAOxW41W8) +:::info Support Article -::: +Read the support article about +[How to Select Validators](https://support.polkadot.network/support/solutions/articles/65000150130-how-do-i-know-which-validators-to-choose-). -### Step 2: Nominate a validator +::: You are now bonded. Being bonded means your tokens are locked and could be [slashed](./learn-staking.md#slashing) if the validators you nominate misbehave. All bonded funds @@ -116,7 +112,16 @@ initiate a claim. This is to help optimize the effectiveness and storage of payo the [Claiming Rewards](./learn-staking.md#claiming-rewards) section of the Staking wiki page for more details. -### Step 3: Stop nominating +### Stop nominating + +:::info Support Article + +Read the support article about +[How to Stop Nominating & Unbond Tokens](https://support.polkadot.network/support/solutions/articles/65000167902-how-can-i-unstake-my-tokens-again-). +See also the support article about +[How to Rebond Tokens](https://support.polkadot.network/support/solutions/articles/65000170241-polkadot-js-ui-how-to-rebond-tokens-during-the-unbonding-period). + +::: At some point, you might decide to stop nominating one or more validators. You can always change who you're nominating, but you cannot withdraw your tokens unless you unbond them. @@ -174,7 +179,7 @@ install the `@polkadot/api-cli` globally: npm install -g @polkadot/api-cli ``` -### Step 2. Bond Tokens +### Step 2: Bond Tokens :::info Controller accounts are deprecated @@ -229,7 +234,7 @@ You can check the transaction status by using the value of the `InBlock` in [Subscan](https://www.subscan.io/). Also, you can verify the bonding state under the [Staking](https://polkadot.js.org/apps/#/staking/actions) page on the Polkadot-JS UI. -### Step 3. Nominate a validator +### Step 3: Nominate a validator To nominate a validator, you can execute the following command: diff --git a/docs/learn/learn-guides-transfers.md b/docs/learn/learn-guides-transfers.md index 04cb11361490..b77abd0fe012 100644 --- a/docs/learn/learn-guides-transfers.md +++ b/docs/learn/learn-guides-transfers.md @@ -229,9 +229,8 @@ reaped. References may still exist from: ### Bonded Tokens If you have tokens that are bonded, you will need to unbond them before you can reap your account. -Follow the instructions at -[Unbonding and Rebonding](./learn-guides-staking.md#step-1-bond-your-tokens) to check if you have -bonded tokens, stop nominating (if necessary) and unbond your tokens. +Follow the instructions at [Unbonding and Rebonding](./learn-guides-staking.md#bond-your-tokens) to +check if you have bonded tokens, stop nominating (if necessary) and unbond your tokens. ### Checking for Locks diff --git a/docs/learn/learn-nominator.md b/docs/learn/learn-nominator.md index dc4c3fe0318f..9391c91594b1 100644 --- a/docs/learn/learn-nominator.md +++ b/docs/learn/learn-nominator.md @@ -96,8 +96,8 @@ you can share the staking rewards they generate. While your {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }} are staked for nominations, they are 'locked' (bonded). You can -[stop nominating at any time](./learn-guides-staking.md#step-3-stop-nominating), but remember that -the action is effective in the next era and does not automatically unbond your funds. Unbonding is a +[stop nominating at any time](./learn-guides-staking.md#stop-nominating), but remember that the +action is effective in the next era and does not automatically unbond your funds. Unbonding is a separate action, and it takes effect after the unbonding period, which is {{ polkadot: 28-day long on Polkadot :polkadot }}{{ kusama: 7-day long on Kusama :kusama }}. This is calculated by taking the **bonding duration** (in eras), multiplying it by the **length of a single @@ -516,7 +516,7 @@ higher, which can be viewed on ## Guides -- [Be a Nominator (Polkadot)](./learn-guides-staking.md#step-2-nominate-a-validator) - Guide on - nominating on the Kusama canary network. -- [Stop Being a Nominator (all networks)](./learn-guides-staking#step-3-stop-nominating) - Guide on +- [Be a Nominator (Polkadot)](./learn-guides-staking.md#nominate-a-validator) - Guide on nominating + on the Kusama canary network. +- [Stop Being a Nominator (all networks)](./learn-guides-staking#stop-nominating) - Guide on stopping nominations and withdrawing tokens. diff --git a/docs/maintain/maintain-guides-how-to-stop-validating.md b/docs/maintain/maintain-guides-how-to-stop-validating.md index 5ed533064abd..07e3280cffb5 100644 --- a/docs/maintain/maintain-guides-how-to-stop-validating.md +++ b/docs/maintain/maintain-guides-how-to-stop-validating.md @@ -48,8 +48,7 @@ that **cannot** be removed, and as a result that account cannot be reaped. to rebond, purge the session keys, unbond, and wait the unbonding period again before being able to transfer your tokens. -See [Unbonding and Rebonding](../learn/learn-guides-staking.md#step-1-bond-your-tokens) for more -details. +See [Unbonding and Rebonding](../learn/learn-guides-staking.md#bond-your-tokens) for more details. :::