Time to Claim Your Dots

This site includes a step-by-step guide to connect your dot allocation on Ethereum with a native Polkadot address. Below you will find tools to verify your claim and then check the balance of your Polkadot address. This site is only for holders of dot allocation indicator tokens.

Step 1
Check Your Ethereum Address
Step 2
Generate a Polkadot
Address
Step 3
Claim Your
Dots
Step 4
Verify Your
Claim

Completing the transaction that underlies the claim will cost a small amount of ether, around $1 worth.

Step 1

Check Your Ethereum
Address

Claim Status:
unknown
arrow_downward
Step 2

Generate a Polkadot Address

There are several ways to generate a Polkadot address

If you have any problems, please contact the Polkadot Address Generation Help channel on the Web3 Foundation’s Riot Server or email [email protected].

What Will Be Generated

A key concept to understand is that you are actually generating two keys (strings of characters), one public (the address) and one private (your seed). A useful analogy is a mailbox at the post office. Anybody with your address can send you mail or put mail in your mailbox, but you need your private key to open your mailbox and move your mail. Similarly, anybody with your Polkadot address can send you dots, but to do anything with the dots in your account, you will need to have your seed (or an application in which you have already entered it).

Your Polkadot address can be shared publicly, but you should never reveal your seed. If somebody has your address, they could send you dots or associate your real-world identity with on-chain actions. However, this information will not allow them to harm your account or do anything in your name.

If somebody has access to your seed, they have complete control over your account! This means that they can do anything that you could do, including transfer all of your dots to a different account. Neither Web3 Foundation nor anyone else will be able to recover your dots in such a situation.

We recommend that you do not store your seed anywhere on a digital device that can be connected to a network. It should be written down on paper and only entered when necessary. It should never be shared with anybody — again, if anyone has access to your seed, they will have complete control over your account.

Polkadot.js browser plugin

This method provides a reasonable balance of security and convenience. It involves installing the polkadot.js plugin and using it as a “virtual vault," separate from your browser, to store your private keys. It also allows signing of transactions and similar functionality.

It is still running on the same computer you use to connected to the internet with and thus is less secure than using Parity Signer or other air-gapped protocols.

Please note: We are currently updating the Parity Signer, and it will be available for generating a Polkadot address soon.

Install browser plugin

Chrome and Chromium-based browsers
Firefox

If you would like to know more or review the code of the plugin yourself, you can find the Github source repository here.

After installing the plugin, you should see the orange and white polkadot.js logo in the menu bar of your browser.

Accounts

Navigate to polkadot.js.org/apps and click on "Accounts". This is located in the sidebar on the left side of your screen.

Create account

Open the polkadot.js browser extension by clicking the logo on the top bar of your browser. You will see a separate browser window open. If you have used this extension before, you may see a list of previously generated accounts. In any case you will see two buttons: “I want to create an account with a new seed” and “I have a pre-existing seed, import the account."

Click “I want to create an account with a new seed”.

Create account

The polkadot.js plugin will then use system randomness to make a new seed for you and display it to you in the form of twelve words.

You should back up these keys. It is imperative to store the seed somewhere safe, secret, and secure. If you cannot access your account via polkadot.js for some reason, you can simply re-enter your seed, and have access to your account once again.

Store the key somewhere safe

The seed is your key to the account. Knowing the seed allows you, or anyone else who knows the seed, to re-generate and control this account.

It is imperative to store the seed somewhere safe, secret, and secure. If you lose access to your account, you can re-create it by entering the seed. This also means that somebody else can have control over your account if they have access to your seed.

For maximum security, the seed should be written down on paper or another non-digital device and stored in a safe place. You may also want to protect your seed from physical damage, as well (e.g. by storing in a sealed plastic bag to prevent water damage, storing it in a fireproof safe, etc.) It is recommended that you store multiple copies of the seed in geographically separate locations (e.g., one in your home safe and one in a safety deposit box at your bank).

You should definitely not store your seed on any kind of computer that has or may have access to the internet in the future.

Name account

You are not able to edit the seed words. However, you should add a descriptive name for this account in the lower textbox (e.g. “Bob”, “Jane”, or “Office Account”).

Enter password

After typing a name for the account, a new textbox will appear in which you can enter a password. When you start typing, a new textbox will appear underneath it. Enter the same password in the second textbox. If your passwords do not match, the plugin will not allow you to generate the account.

Note that this password will protect your data in the plugin, and any backup file you export from the plugin. It does NOT protect your seed phrase. If someone knows the twelve words in your mnemonic seed, they still have control over your account even if they do not know the password.

Review account

Once both of your passwords match, the program will display information about the account that will be generated for you.

Review account

Click on “Add the account with the generated seed”. You will be taken back to the main page of the plugin, which should now include your generated account.

Set Address for Polkadot Mainnet

Now we will ensure that the addresses are displayed as Polkadot mainnet addresses.

Click on "Options" at the top of the plugin window.

Set Address for Polkadot Mainnet

In the "display addresses formatted for" dropdown, select "Polkadot (live) and then click "Back".

Get address

Verify that your address has a “1” as the first character. This indicates that it is a Polkadot mainnet address.

Get address

You can copy the address by double-clicking on the string representation of the address itself, and then copying (e.g. with Control-C on Windows or Linux, Command-C on OS X). DO NOT click on the icon representing your account (the colorful hexagon of differently-colored dots) - this will copy a Kusama version of your address.

Be sure that you select the ENTIRE displayed address. Note that when you paste it, you will see even more characters than are displayed.

Copy address

You can now copy and paste the address from the address textbox, and you now have a plain-text copy of your Polkadot mainnet address.

Note that an address in a different format can always be converted to a Polkadot address, since the same public key can be used for generating addresses on different networks. However, for ease of use and understanding, it is best to ensure that you are always using Polkadot mainnet addresses.

arrow_downward

Subkey

Subkey is recommended for technically advanced users who are comfortable with command line and compiling Rust code. Subkey allows you to generate keys on any device that can compile the code. Subkey may also be useful for automated account generation, using an air-gapped device other than one running iOS or Android or other specific purposes. It is not recommended for general users.

If you wish to use subkey, detailed build and usage instructions are here.

Directly from polkadot.js

WARNING: This is the least secure method of generating an address. It should only be used if there are no other options available and you are aware of the risks involved, up to and including total loss of any dots or kusamas stored in the account.

It is possible to generate an address directly from the polkadot.js app, without any additional security measures.

Go to polkadot.js
> Accounts

Navigate to polkadot.js.org/apps and click on "Accounts". It is located in the sidebar on the left side of your screen.

Start generation of the account

Click on the “Add Account” button.

Start generation of the account

You should see a pop-up that looks like the one here. The required text fields to complete are highlighted in pink.

Start generation of the account

You can ignore the Advanced creation options; the defaults are fine. You will have to enter an Account Name and a password to protect your account. Be sure to select a secure and hard-to-guess password. Note that anything will be accepted as a password here. Please note: There are no checks to see if it is long enough or secure. You will need this password for any future interaction with or transaction from this account.

When you have entered valid information for both, the color of the text boxes will turn from pink to white.

Store the key somewhere safe

The seed is your key to the account. Knowing the seed allows you, or anyone else who knows the seed, to re-generate and control this account.

It is imperative to store the seed somewhere safe, secret, and secure. If you lose access to your account, you can re-create it by entering the seed. This also means that somebody else can have control over your account if they have access to your seed.

For maximum security, the seed should be written down on paper or another non-digital device and stored in a safe place. You may also want to protect your seed from physical damage, as well (e.g. by storing in a sealed plastic bag to prevent water damage, storing it in a fireproof safe, etc.) It is recommended that you store multiple copies of the seed in geographically separate locations (e.g., one in your home safe and one in a safety deposit box at your bank).

You should definitely not store your seed on any kind of computer that has or may have access to the internet in the future.

Create and backup account

Click “Save” and your account will be created. It will also generate a backup file that you should save to your computer. Ideally, you would also save it on an external hard drive or thumb drive, or print it out and be able to re-enter it later. You should not store it in cloud storage, email it to yourself, etc.

You can use this backup file to restore your account. This backup file is not readable unless it is decrypted with the password.

arrow_downward

Coinbase

  1. To open an account please contact Coinbase directly at [email protected]
  2. Once you’ve opened an account, Coinbase Custody will generate a dot address for you to use in the claims process and send it to you.
  3. You may then claim your tokens using your Coinbase Custody dot address and your tokens will appear in your Coinbase Custody account.

For questions about claiming with Coinbase, please contact: Nick de Bontin +1-630-884-8182 [email protected].

Step 3

Claim Your Dots

If you participated in a previous dot sale and received your dot allocation indicator tokens, you can now claim your dots, i.e. connect the address where your dot indicators have been stored on Ethereum with a native Polkadot address. The claims process will ensure that your dot allocation is denoted in Polkadot's genesis block.

Make sure to use the Ethereum key you used for your dot allocation indicator tokens during this process. You can check your Ethereum key in Step 1.

If you don’t have a Polkadot address, you will need to generate one. You can generate a Polkadot address in Step 2.

When you make a claim, you will be assigned an index as well. This index is a short code — 6 characters or less — that can be used as a short-hand version of your Polkadot address. Indices are assigned on a first-come, first-served basis.

Next Index:
...

Claim with MyCrypto

These instructions will help you send a transaction from MyCrypto to claim your dots. MyCrypto is a flexible and secure Ethereum wallet that allows you to send a transaction from your Ethereum account and supports many different key storage formats.

Install MyCrypto

It is strongly recommended to download and use the MyCrypto application locally. For some types of key storage formats this is the only option. Downloading the application locally allows you to perform the signing steps offline if preferred.

Ensure that you download the official program from MyCrypto official sources. You can always find the most up-to-date releases of the desktop app on their releases page. Choose the one that matches your operating system architecture.

Interacting with contracts

Once the MyCrypto application is installed, open it and navigate to the Contracts tab. If you're using the locally downloaded app, this will appear as a sidebar on your application screen. If you're using the browser, the tab is found by clicking "Interact with Contracts" in the Tools section dropdown menu.

In the selector, choose the Custom option for the contract options.

Claims contract ABI

ABI:

Copy ABI to your clipboard and paste into the ABI input in MyCrypto.

Claims contract address

Address:
0x

Copy the contract address to your clipboard and paste into the address input in MyCrypto.

After putting this information into the blank inputs, click the "Access" button in MyCrypto to continue. If you want to verify it yourself you can view it on Etherscan verified contracts.

Entering inputs

Select the claim function from the dropdown menu.
Notice that there is also a function called "claims" in the same dropdown menu — be sure that you have selected "claim".

Entering inputs

Enter the address of the Ethereum account that holds the balance of dot allocation you are going to claim into the field labeled "_eth address".

The Ethereum address for your claim is usually the same address that you are planning to send the transaction from. If you are using an amended Ethereum address, you must use the original address attached to your allocation to claim (even if you used the amended address to check your claim).

Entering inputs

On the next slide you will find instructions how to get your public key (pubKey).

Get your public key

Please enter your Polkadot mainnet address - this address should start with a "1". If your address does not start with a "1", it is specifying a different network. Follow the instructions here to convert your address.

WARNING: If you paste in a non-Polkadot address, the decoder will not work and you will continue to see "unknown".

Copy your decode public key to your clipboard and continue to the next slide.

Decoded Public Key:
unknown

Entering inputs

Enter your decoded public key of your Polkadot address into the field labeled "_pubKey".

WARNING: You must enter your PUBLIC KEY here. DO NOT enter your Polkadot address! If you enter your Polkadot address into the "_pubKey" field, your dots will not be accessible!

Sending the transaction

First unlock your account by selecting the option that matches the way that you've stored your Ethereum private key.

Sending the transaction

Uncheck the box that says Automatically Calculate Gas Limit and instead use 200000 as the gas limit. You can make changes to the gas price or simply keep it at the default. The network gas price is available at ETH Gas Station.

Sending the transaction

Click the "Write" button in MyCrypto. Then confirm the transaction by clicking "Sign Transaction," and send it to the network.

MyCrypto will display a link leading you to a popular block explorer in order to verify your transaction was mined on the network. Once you see it go through, you can safely close MyCrypto.

Verifying your claim

The dots are not available to you until Polkadot launches. However, if you would like to verify your claim you can do so below. Enter an Ethereum address, Polkadot address or Polkadot public key in the input to get the corresponding claim information. Inputting an address will show you the registered Polkadot address, public key, index and balance of your claim.

If all of this data looks right then your claim was a success! When Polkadot launches, the dots will be available automatically in your Polkadot address immediately from genesis.

arrow_downward
Step 4

Verify Your Claim

Allocation Address:
unknown
Polkadot Address:
none
Public Key:
none
Index:
none
Vesting:
none
Balance:
0 DOT

FAQ

  • The deadline will be when Polkadot’s main network launches. We cannot at this time promise an exact date, but we expect the claims process will remain live for several weeks.

    If you miss the deadline, there will be a separate claims process (similar to the current Kusama claims process) to claim your dots. You will gain access to your dots very shortly thereafter (most likely within a minute). This process will also work indefinitely after the launch of Polkadot’s main network and beyond the genesis block.

  • Why do I need to claim? keyboard_arrow_right

    If you have already purchased dots, you do not yet have access to or the ability to transfer them. You have the “right” to a certain number of dots. The claims process exists to transform that right — your allocation indicator tokens on Ethereum — into a dot allocation inscribed in the Polkadot genesis block. This process will ensure that your dot balance is live on Polkadot once the Polkadot main network is live.

    As part of this claims process you first need to create a Polkadot address, and then prove that you are both the owner of the Ethereum address and the owner of the Polkadot address. After proving that you have access to the dot allocation linked to the Ethereum address, the correct number of dots will be allocated to your address on the Polkadot blockchain.

  • Enter your Ethereum address here.

  • There are a variety of ways to generate Polkadot addresses, with different levels of security, convenience, and other tradeoffs. They are listed here.

  • If you participate in the claims process before the Polkadot main network is live, your dot allocation will be denoted in Polakdot's genesis block. This means that you will have access to your dots once the Polkadot blockchain launches and the on-chain governance mechanism votes to enable tokens transfers.

    If you claim the dots using the alternative claims process after launch, then you will receive access to your dot allocation shortly after submitting your claim. This process should take less than a minute.

  • After you verify your claim, the screen will indicate the success or failure of the claim. Once the Polkadot mainnet is running, you can use polkadot.js.org/apps/#/accounts to verify that your account has the correct number of dots.

  • Can I claim Kusama tokens? keyboard_arrow_right

    Please check the Kusama claims page to check your allocation of kusamas for detailed instructions.

  • Yes. Kusama is a completely separate network from Polkadot so any claims for kusamas do not apply to Polkadot or dots. If you already made a claim for kusamas, please make a new claim for dots.

  • We do not recommend using third-party applications or processes to claim your dots, other than those explicitly named here (e.g. Coinbase). Please don't hesitate to contact [email protected] with any questions.

    Making a claim using a third-party process can lead to the loss of your allocation, therefore we cannot recommend using any third-party applications to do so. Manually specifying your transaction data, as detailed in our claims process, is the only way to be certain you will receive your allocation.

  • Initially, functionality will be restricted to the Staking, Session, and Claims modules. After you have claimed your dots, you will be able to bond your dots, nominate validators, and signal your own intention to validate.

    After enough potential validators signal their intention to validate and Web3 Foundation deems the network stable, a runtime upgrade will transition Polkadot to its decentralized, nominated proof-of-stake protocol. Once the network is running stable with NPoS, a series of runtime upgrades will unlock the remaining functionality like governance, parachain auctions, and token transfers.

Any other questions?