How To's - Nick-1979/polkadot-Js-Plus-extension GitHub Wiki


Home

Installation


Accounts page

It shows the list of all accounts and their balances (total, available, reserved and USD equivalents), which you have created/imported on Polkadot/Kusama blockchain and parachains. Moreover the transfer, refresh, QRcode and staking icon buttons allow to a user to easily access these new features. The orange staking button indicates that the account has some coins staked.

accounts page screenshot

Transfer funds

Add a recipient, can be chosen from local accounts to transfer between your accounts or enter a recipient on the same chain manually:

add recipient page screenshot

While Choosing an amount to transfer, the extension shows appropriate alerts based on your input. Max and All buttons are available to withdraw Max/All amounts from your account.

transfer funds page screenshot

In transaction confirmation page, confirm the transaction to broadcast it on the blockchain by entering your sending account's password.

confirm transaction page screenshot

After a little while, depending on the network response time, transaction will be done, you see the following page and your balance(s) are updated.

transaction done page screenshot

Transactions' history

It can be accessed from the account page, which shows transactions history including transaction type, status, failure reason, time and date and a link to each transaction detail, as well as a Subscan link for more info.

transaction history page screenshot

transaction detail page screenshot

QR code

Entering the crypto address is error prone, so it is useful to use the QR code for scanning by a mobile wallet.

Address QR code page screenshot

Easy staking

Now, you can easily stake using the Polkadot JS Plus extension. There are two options for staking, solo and pool staking:

staking index screenshot

Solo Staking

Stake solo

For solo staking, you just need enter the amount you want to stake and choose auto mode, it will do the rest.

stake page screenshot

Nominations

View your nominated validators info, even edit the list of the validators or stop nominations. helpful notifications are also available such as oversubscriptions, no active nomination, etc.

nominated validators page screenshot

Validator selection

Nominate validators automatically or select them yourself.

select validators page screenshot

Confirm staking

Finally confirm staking/unstaking/redeem/nominations or TUNE UP similarly.

confirm staking page screenshot

Pool staking

Stake

In pool staking, at the first time you have two options, joining an existing pool or creating a new pool:

pool staking 1st time screenshot

Join a pool

To join a pool, enter the stake amount and select a pool to join, hit next, confirm your choice in the confirmation page.

join a Pool screenshot

Create a pool

To create a pool, enter a pool name and stake amount. Some roles can also be defined such as pool nominator, or state toggler, then click next and go to confirm page.

create a pool screenshot

Stake in pool

After the first selection between joining and creating a pool, you will be a member of the pool. Afterwards, when you want to increase your stake amount, you can go to the stake tab:

stake in pool screenshot

Unstake from pool

To unstake some of already staked amount, just enter an amount and go to the confirm page:

unstake from pool screenshot

Pool Tab

The pool tab shows the pool in which the account is a member, where an authorized pool member can change the status of the pool.

pool info tab screenshot

Pool nominations

The selected validators of a pool is depicted here, where the pool's root and nominator roles can change/set those nominations.

create a pool screenshot

Pool info

Some useful information about pool staking is summarized in the tab such as minimum to join a pool and minimum to create a pool.

create a pool screenshot

Reward decision

your claimable rewards, can be claimed or staked again. By clicking on the dots near the "rewards" label, which shows your already claimable amount, you can choose what you want to do with your claimable.

create a pool screenshot

Confirm page

Any actions which needs to be applied on-chain needs users' confirmation. Fore example in the following photo you see the confirmation page of pool state changing to destroying.

create a pool screenshot

How can leave a pool

To completely leave a pool, if you are just a member (not root) of a pool, you need to unstake all of your amounts first, then wait for unlocking period which is 7 days on Kusama and 28 days on Polkadot. After that your tokens will be redeemable. Redeem your tokens using the button next to the Redeemable label, and confirm it. Finally, you left the pool.

Notice, if you are the root of a pool, you need to change the state of the pool to destroying first, then after leaving all the members, the root can leave the pool too, by unstaking and then redeeming.

Crowdloans

Contribution in crowd loans now is possible via the extension, go to 'crowdloan' menu:

contribute to crowdloans page screenshot

Auction

Auction information and the bids if there is one will be shown.

view active auction and bids

Contribute to crowdloans

Choose an active crowdloan and hit next button.

view available crowd loans page screenshot

Enter the contribution amount, consider the minimum, and confirm it.

confirm contribution page screenshot

Governance

Kusama/Polkadot governance is accessible via account menu.

governance menu

governance index

Referendums

All active referendums listed with useful information are available via Democracy menu, where every token holder can vote.

referendums list

Vote a referendum

Enter a vote value and determine the lock period for that amount, then enter the password to confirm your vote.

vote referendums

Councils

viewing council members/runners-up/candidates information, and voting them.

council members

Enter a vote value, and select the members, note the order is important, also consider the voting bond.

council members

Motions

viewing council motions information and links for more information.

view motions

Treasury proposals

viewing proposed proposals information and able to submit a new treasury proposal.

 view treasury proposal

Determine a beneficiary account and enter the requested amount, consider the collateral to submit a treasury proposal.

submit treasury proposal

Tips

viewing treasury tips information and able to propose a new tip.

view tips

Proposing a new tip, by determining the beneficiary address and set a reason, while considering report deposit.

propose a tip

Social recovery

Managing your own private keys is a difficult task. The average person doesn’t want to spend multiple hours to ensure the security of their keys. This leads to people having difficulties to join the blockchain space or even worse leads to the loss of funds. Social recovery is the solution. It allows users to recover their accounts if their key or other authentication mechanism has been lost.

To be able to recover your lost account, the account should be a recoverable account.

To make your account recoverable, go to social recovery menu for your account:

social recovery

As you can see, you have two options, configure your account or Rescue another account, now select "Configure my account" to make your account recoverable. A recoverable account can be recovered whenever you lose it with the help of your social friends.

social recovery index

Configure My Account

Info tab

Here you can find some useful information about the social recovery, like "The maximum amount of friends allowed in a recovery configuration".

social recovery info tab

Configuration tab

Make Recoverable

In configuration tab, you can configure your account to be recoverable by:

  • adding some friends' accounts, which will help to recover the account when needed
  • set a threshold for friend's vouch, which is the number of vouches that is to be reached to recover the account
  • set a delay period, the days after a recovery attempt is initialized that needs to pass before the account can be recovered

social recovery configure

social recovery add friend

social recovery make recoverable

when you have completed the make recoverable form you can submit it by entering your password and hit the confirm button. Some tokens will be deposited to make your account recoverable, the amount of deposit depends on the number of friends you have selected.

social recovery confirm making recoverable

When an account is recoverable, we show a green shield icon next to that account on the Accounts page:

social recovery greenshield

Remove Recovery

For whatever reason, if you don't want your account to be recoverable, you can go to the configuration tab and remove recovery, which will unlock your deposit.

social recovery remove recovery

Rescue another account

If you lost your account, you need to create a new account, which we call rescuer, and choose "Rescue another account" option in social recovery. Here you see two options, as a rescuer you have to do some steps to recover a lost account, and as a friend you can vouch for a recovery.

social recovery rscue

As a Rescuer

A rescuer is who wants to recover a lost account. He needs to follows 3 steps as described below to rescue a lost account.

Step 1: Initiate Recovery Process

As a rescuer, at the first step, you need to initiate the recovery process for the lost account, and confirm it. The rescuer needs to deposit some tokens, and in a successful recovery process, these tokens will be transferred to the lost account and can be withdrawn by the rescuer..

social recovery rescue step 1

social recovery confirm initiate recovery

Step 2: Wait for Conditions

After confirming the initiation of the recovery process, you need to wait until the recovery condition(s) will be met. You need to wait for the delay period to be passed and also to receive enough vouches from the friends of the lost account.

social recovery rescue step 2

Step 3: Withdraw from lost account

After the waiting conditions are met, the rescuer account become the proxy of the lost account, hence can withdraw all the lost account's balances. If there are any malicious rescuers that started a recovery for the lost account, you will withdraw their deposits too.

social recovery rescue step 3

social recovery step 3 withdraw

As a Friend

When a rescuer begins the process of recovering a lost account, some vouches are required by the friends of the lost account before the rescuer can take over the lost account. As a friend of a lost account, you can vouch that the lost account's address actually belongs to the rescuer account holder. Therefore, a friend needs to go to social recovery menu, select "Rescue another account", and as a Friend clicks on the "Vouch" button to view the following page:

social recovery vouch

social recovery confirm vouch

Notice

When a (Malicious) rescuer initiates a recovery process for a (possibly lost) account we show a red beating shield alert besides that (lost) account in the accounts page. The owner of that account can easily close the recovery process by clicking on that red alert button, and WITHDRAW the malicious rescuers deposit and kind of punish them.

social recovery red alert

social recovery close recovery

social recovery confirm close recovery