jaymansfield / polkadex-staking-dashboard

Polkadex Staking Dashboard

Polkadot Staking Dashboard

Staging (Latest Version):

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

Production:

https://staking.polkadot.network

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.	[email protected]
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: '[email protected]',
    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

• 30/06/2022: [Video] Polkadot Decoded 2022: Polkadot Staking Dashboard Demo