Validators

Get your validator listed

Add a logo, a description and contact details to your validator, through a pull request.

Get your validator listed

By default a validator shows up as a name and an address. Adding a profile gives it a logo, a description and a way to be contacted, on the staking site and in the explorer.

It is free, it takes about fifteen minutes, and it is done through a pull request on GitHub.

Why bother

Delegators are choosing where to put money they can lose. Between two validators with the same commission, the one with a logo, a description of who runs it and a working contact link is the one that gets the delegation. The other one looks like a machine nobody is watching.

What you need

Your operator address. The wallet that registered the validator, not the consensus address. It is on your validator's page in the explorer, under Addresses.

A logo, as logo.png. At least 64 by 64 pixels and at most 512 by 512. Square, because that is how it is displayed.

A GitHub account.

The steps

  1. Fork l2p-validator-directory to your own account and clone it.

  2. Create a folder for your validator. The path is the chain id, then your operator address exactly as it appears on the explorer, capitals included:

12216/0xaE11fB1F89C83c3AD49636A283732A3692dE76f9/
  1. Put logo.png in it.

  2. Add profile.json next to it, with the ways you want to be reached:

{
  "contact": {
    "email": "[email protected]",
    "twitter": "https://x.com/exampleaccount",
    "telegram": "@validator123",
    "website": "https://www.example.com"
  }
}

Everything in it is optional, and everything in it is public. Use an address you are happy to publish.

  1. Optionally add a README.md describing who you are: the team, the infrastructure, what you contribute. There is a template in the template folder of the repository to start from.

  2. Commit, push, and open a pull request against the main repository with a short summary.

  3. We review it and merge. Your logo appears once it is merged.

Keeping it current

The profile is yours. Changing a contact address, replacing the logo or rewriting the description is another pull request against the same folder.

If you sell or hand over the validator, update the profile in the same breath. A stale contact link is worse than none, because somebody will use it.

What it is not

The profile has no effect on the chain. It does not change your commission, your voting power, your rewards or your standing in the set, and it is not a verification of anything. It is how you introduce yourself, and nothing more.