/polkadot-staking-dashboard

Polkadot Staking Dashboard

Primary LanguageTypeScriptApache License 2.0Apache-2.0

Polkadot Staking Dashboard

Staging (Latest Version):

https://paritytech.github.io/polkadot-staking-dashboard

Production:

https://staking.polkadot.network

Screenshot 2022-12-20 at 13 46 30

Validator Operator Setup Guide

Validator operators can add their contact information, icon, and which validators they operate, to the dashboard’s Community section. The Community feature is designed to give non-biased exposure to validator operators, and to host a fully-featured validator browser just for that operator's validators.

To add an operator, submit a PR with the following changes:

  • Thumbnail: Add your operator's thumbnail as an SVG Component in this folder.
  • Operator details: Add your operator details to the VALIDATORS_COMMUNITYJSON object in this file.

Operator Structure

The following table outlines the structure of a VALIDATOR_COMMUNITY entry:

Element Key Required Notes Example
Operator Name name Yes The chosen name of the operator. Validator Central
Thumbnail Name thumbnail Yes The name of your SVG component representing your thumbnail. See Below
Bio bio No A short description of your entity. Maximum 300 characters. Summing up my validator identity in a sentence or so.
Email Address email No A public email address representing the operator. validatorcentral@parity.io
Twitter Handle twitter No The Twitter handle representing the operator. @ParityTech
Website URL website No A live and vlid secure URL to your website. https://parity.io
Validator List validators Yes A list of validators grouped by network. At least 1 validator in 1 network must be defined. See Below

Example Operator

Upload your SVG icon as a React component. Look at the existing icons as examples, or use the SVGR Playground to convert your raw SVG file into a component.

Next, add your operator details to the VALIDATOR_COMMUNITY object. Only provide the validator(s) for the particular network(s) you are operating in. If you have no operating validators on Kusama, for example, the kusama key can be omitted.

The following example defines 2 validators on the Polkadot network, and 1 on Kusama:

export const VALIDATOR_COMMUNITY = [
  ...
  {
    name: 'Validator Central',
    thumbnail: 'ValidatorCentral',
    bio: 'Summing up my validator identity in a sentence or so. Maximum 300 characters.',
    email: 'validatorcentral@parity.io',
    twitter: '@ParityTech',
    website: 'https://parity.io',
    validators: {
      polkadot: [
      '1hYiMW8KSfUYChzCQSPGXvMSyKVqmyvMXqohjKr3oU5PCXF',
      '14QSBoJMHF2Zn2XEoLNSeWgqBRr8XoKPy4BxToD6yLSeFFYe'
      ],
      kusama: ['FykhnPA3pn269LAcQ8VQKDgUQ8ieAaSLwJDhAVhu3dcokVR'],
    },
  },
  ...
];

General Requirements

Requirement Notes
Accuracy Operator contact details must be working and valid.
Liveness All submitted validator addresses must be discoverable as a validator on the network in question - whether Polkadot or Kusama.
Ordering Please place your operator in alphabetical order within VALIDATOR_COMMUNITY. Operators are shuffled before being displayed in the dashboard, removing any bias associated with ordering methods.

Please submit an issue for any queries around adding your operator details.

URL Variables Support

Polkadot staking dashboard supports URL variables that can be used to direct users to specific configurations of the app, such as landing on a specific language or on a specific network.

Variables are added at the end of the hash portion of URL:

staking.polkadot.network/#/overview?n=polkadot&l=en

The currently supported URL variables are as follows:

  • n: Controls the network to default to upon visiting the dashboard. Supported values are polkadot, kusama and westend.
  • l: Controls the language to default to upon visiting the dashboard. Supported values are en and cn.

URL variables take precedence over saved values in local storage, and will overwrite current configurations. URL variables will update (if present) as a user switches configurations in-app, such as changing the network or language.

Example URL:

The following URL will load Kusama and use the Chinese localisation resource:

staking.polkadot.network/#/overview?n=kusama&l=cn

Presentations