Skip to content

Commit

Permalink
Wiki Reorg: Staking Guides (#5692)
Browse files Browse the repository at this point in the history
* rm old video tutorial

* moved single support articles to relevant sections

- rm list at the top

* fixed broken links

* fix broken links
  • Loading branch information
filippoweb3 authored Mar 18, 2024
1 parent d9cf26f commit a9ad0f5
Show file tree
Hide file tree
Showing 4 changed files with 34 additions and 31 deletions.
47 changes: 26 additions & 21 deletions docs/learn/learn-guides-staking.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
Expand Down Expand Up @@ -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
Expand All @@ -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.
Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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:

Expand Down
5 changes: 2 additions & 3 deletions docs/learn/learn-guides-transfers.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
10 changes: 5 additions & 5 deletions docs/learn/learn-nominator.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.
3 changes: 1 addition & 2 deletions docs/maintain/maintain-guides-how-to-stop-validating.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

:::

Expand Down

0 comments on commit a9ad0f5

Please sign in to comment.