Skywire Whitelisting System - SkycoinProject/skywire GitHub Wiki

skywire logo

Skywire Whitelisting System User Guide

Table of Contents

Introduction

The Skywire whitelisting system is designed to be used for managing whitelist applications and submitted user data.

Usage of the Skywire Whitelisting System is required to be eligible for testnet rewards.

Using the system requires a verified user account created in the Skywire authentication system, please check out the Skywire authentication system user guide in case you need help with creating a user account.

Disclaimer: Previous data records, submitted via skycoin.com/whitelist were imported into the new system. You were informed to verify your imported data, please do so immediately if you haven't done that already.

Important note for people that had a DIY miner and an official miner in the old mikecrm system: you will only get to keep one Skycoin wallet reward address in the whitelisting system. Please refer to the usage section of this guide in case you need help with changing your Skycoin wallet reward address.

Please check out the Functional Overview section for a brief overview of the currently available functions of the Skywire whitelisting system.

One last reminder for everyone to join the Skywire PSA channel on telegram if you're not already a member.

If you're unable to login please contact support at store.skycoin.com/pages/support.
Bug reports have to be submitted to support directly or in the Skywire Telegram channel.

Functional Overview

The following is a brief summary of the current functionality of the Skywire whitelisting system.

Whitelist Application Submission

The Skywire whitelisting system enables you to manage your whitelist applications with ease:

  • submit new whitelist applications by using the Skywire whitelist application form.
  • review the status of your application at any time.
  • receive status update notifications via email.

Review and Management

The Skywire whitelisting system provides you the option to review your currently registered data records:

  • the registered Skycoin wallet reward address.
  • the registered public keys associated with your miners.
  • the uptime of your registered public keys.

In case any of these data records are outdated, you are able to change them:

  • change your registered Skycoin wallet reward address.
  • remove or change your registered public keys.

Adding more boards is now easier than ever:

  • upgrade whitelisted miners by adding more boards

Also, you are able to transfer your whitelisted miners to other user accounts if necessary.

Email Notifications

The Skywire Whitelisting System contacts its user via several notification emails that are intended to make sure that people meet the requirements for being rewarded.

Missed Uptime Requirement

Whenever the nodes of a user miss the uptime requirement, the Skywire Whitelisting System will send him a notification on the first of the subsequent month to make sure he's aware of the situation and can take appropriate measures.

Missing Skycoin Address

User accounts that do not have a valid Skycoin wallet reward address registered will receive notification emails five (5) days prior to the end of the month. These notification emails include information about how to add a Skycoin wallet reward address to a Skywire Whitelisting System user account.

More features will be added from time to time!


Account Creation

Please refer to the Skywire authentication system user guide in case you need help with creating a user account in the Skywire authentication system.

Using the Skywire whitelisting system requires a verified Skywire authentication system user account.

In case you were a participant of the testnet prior to the launch of the Skywire whitelisting system, i.e. you submitted a Skywire testnet application using the form previously hosted at skycoin.com/whitelist, you already have an account waiting for you.


We imported all existing data records into the Skywire whitelisting system. You just have to assign your personal password and verify your account.
Detailed instructions were sent to your email address after the launch but they can be requested from support in case you lost them:

Usage

The following sections will explain the usage of the Skywire whitelisting system in detail.

First Login

This step requires a verified user account. Detailed instructions can be found in the Usage section.
Please note that you have to enter your authentication code for logging into the whitelisting system if you enabled 2FA authentication in your account using the authentication system.

The following steps should be executed upon the first login:

  • adding a Skycoin wallet reward address

  • submit a whitelist application

  • Please visit the Skywire whitelisting system at whitelist.skycoin.com

wlist_login_page

  • Enter your credentials and log in.

wlist_login_page_filled

  • You will be looking at the (currently empty) Miners page:

wlist_empty_miners

  • Please continue with adding a Skycoin wallet reward address.

Add Skycoin Wallet Reward Address

  • Click on Account Info in the menu bar on the left:

wlist_account_info

  • You will see that your account is currently associated with no Skycoin wallet reward address. It is mandatory to submit a Skycoin wallet reward address if you want to be eligible for receiving rewards.

wlist_account_info_no_address

  • Click on the pencil icon to add a Skycoin wallet reward address and confirm with the blue SAVE button

wlist_address_form

  • Now you can view your Skycoin wallet reward address, previous addresses will be listed in the dedicated section below:

wlist_account_info_address_added

You may change your Skycoin wallet reward address whenever you want. Please note that changes will only be recognized for the reward distribution if they were submitted within the calendar month of the respective month's reward distribution. Refer to the Change Data section in case you need help with changing your data.

Whitelist Application Management

Official Skyminer cannot be created via the application form. Please contact support if you need guidance with registering your official Skyminer.

The following section will guide you on how to submit a DIY application. Submitted whitelist application data must comply with the Skywire testnet rules and meet the requirements.

Please note that manually opening a new application always results in the creation of a new miner. In case you simply want to add public keys/more boards to an already approved miner, please refer to the Auto-Application Creation section and the Modify Public Keys section for detailed instructions how to add more public keys/boards to your miner.

wlist_application_empty

  • Enter the details of your whitelist application:
    • public keys (click on the plus to add more public keys)
    • three pictures, each taken from a different angle
    • location
    • description

whitelisting_application_text_filled

  • Click on UPLOAD FILES to upload your pictures:

whitelisting_application_example

  • Double check your data and click on SUBMIT to submit your application:
The popup indicating that the application was correctly submitted.

This popup will show up if your application was correctly submitted.

  • Your application status will be Application pending.

whitelisting_actual_application

  • Your application will be reviewed by an admin. The waiting period is approximately a couple days, up to a week. You will receive status update emails as soon as the status of your application changes.

Please follow up with the sections Application DECLINED and Application DISABLED in case your application gets NOT approved on the first time.

Application APPROVED

In case your application was APPROVED you will find an approved DIY miner one the Miners page:

wlist_miners

Please refer to the Review Data or Change Data section in case you want to review or change your data.

Application DECLINED

In case your application was DECLINED it means you have missed some of the requirements listed in the Skywire testnet rules article.

Any interaction with your application triggers email notifications being sent that update you on the status update and include a comment made by the admin that reviewed your application. Make sure to check your emails regularly!

In case your application was DECLINED, your application form will look like the following:

whitelisting_application_declined

  • As long as your application wasDECLINED and not DISABLED you are able to resubmit the form to fix any flaws. Please refer to the Application DISABLED section in case your application was disabled.

whitelisting_application_declined_fixed


Application DISABLED

In case your application was DISABLED you won't see an empty whitelist application form in the system. You have to check your emails to see the information about your DISABLED application. Once an application was DISABLED it's the best practice to contact support at store.skycoin.com/pages/support if you want to resolve your issue.

User accounts that had one of their applications DISABLED are still able to open new applications. Only serious rule violations and misdeeds will lead to having your account disabled and losing any eligibility to receive rewards.

Auto-Application Creation

Adding public keys to your miner must be done by using the edit miner function outlined in the Modify Public Keys section. An automated application is being created in case you surpass the approved public key quantity of your miner thus requiring further approvement by an admin:

Empty cell for new and additional public key.

The previous state of the miner remains active and ready to receive rewards without the additional public keys. Simply exchanging your currently registered public keys does not trigger the creation of an automated application.

Any open application will be put in the background and on hold until the automated application was approved by an admin. Once that's done your previously open application will be restored into it's previous state.

If you did increase your public key quantity and the automated application was created for you, you have to submit new pictures that display the new boards you would like to add.

Please visit the Whitelist Form page where you can review the automated application that was created for you:

wlist_application_auto_whitelist_form

Please add the new pictures by using the blue UPLOAD FILES (MINIMUM THREE PICTURES) button:

wlist_application_auto_whitelist_form_filled

Confirm your changes by using the blue SUBMIT button:

wlist_application_auto_pending

Your application will be reviewed and you will receive an email notification as soon as the status of your application changes.

Once your application was approved you will be able to review the added public keys in the miner overview page:

Please refer to the Review Public Keys section for detailed instructions how to review your currently registered public keys.

wlist_application_auto_confirmed

Manage Registered Data

The following section will outline the steps to review your currently registered data and change it if necessary. Any steps that interact with miner data (public keys) require a whitelisted miner, created by an approved application. Reviewing and modifying the Skycoin wallet reward address is possible regardless if your account is associated with a whitelisted miner.

Review Data

The Skywire whitelisting system enables you to review your currently registered Skycoin wallet reward address and the registered public keys associated with your miner(s).

Review Skycoin Wallet Reward Address

Please visit the Account Info page by using the menu bar on the left.

wlist_address_change

Review Public Keys

Please visit the Miners tab by using the menu bar on the left. Simply click on the pencil of the respective miner's data you want to review and a new tab will be opened. wlist_miners

The new tab will display the Miner Overview page, including all the details of your miner:

  • registered public keys and their uptime
    • N/A in case your nodes were and are not connected to the discovery server
    • duration and uptime percentage if your nodes were/are connected to the discovery server
  • registered pictures

wlist_miner_overview

Change Data

The Skywire whitelisting system enables you to change your currently registered Skycoin wallet reward address and the registered public keys associated with your miner(s).

Change Skycoin Wallet Reward Address

Please visit the Account Info page by using the menu bar on the left. Simply click on the pencil icon to adjust your Skycoin wallet reward address. Refresh the page to make sure that your changes were saved.

wlist_address_change

Modify Public Keys

Please visit the Miners page by using the menu bar on the left. Simply click on the pencil of the respective miner's data you want to change and a new tab will be opened. wlist_miner_list

The new tab will display the Miner Overview page, including all the details of your miner and providing you the option to change your registered public keys associated with this miner:

  • edit and exchange public keys.
  • use the x to remove public keys.
  • use the +to add public keys:
    • if you surpass the approved public key quantity of your miner and automated application will be created.
  • confirm changes via the blue SUBMIT button.

wlist_miner_overview

Add more public keys to your miner by using the x: wlist_miner_overview_change

Empty cell for new and additional public key.

Enter the public keys:

Empty cell for new and additional public key.

Confirm your changes via the blue SUBMIT button.

A popup will inform you about the creation of an automated application in case you surpassed the previously approved public key quantity.

Empty cell for new and additional public key.

Please refer to the Auto-Application Creation section for detailed instructions in case you surpassed your approved public key quantity.

Transfer Miner

Please visit the Miners page by using the menu bar on the left.

Simply click on the pencil of the respective miner you would like to transfer. wlist_miner_overview_transfer

The user account to which the miner shall be transferred must satisfy the following constraints:

  • created & verified before transferring the miner using the authentication system at auth.skycoin.com.
  • the user account must have been logged in to the whitelisting system at least once.

Enter the email address of the user account to which the miner shall be transferred: wlist_miner_overview_transfer_filled

Confirm the transfer by clicking on the red TRANSFER button. A popup will show up informing you about the consequences of transferring a miner:

  • miner transfers cannot be reverted (only if the user account to which the miner was transferred transfers the miner back)
  • miner transfers are permanent
  • you will lose eligibility for any prospective rewards

wlist_miner_overview_transfer_popup

Confirm the transfer by clicking on the red CONFIRM button.

Troubleshooting

Can't reset user's password user action token expired

Please request a new password reset token by clicking on 'Forgot your password?' on the login page of the auth.skycoin.com.

Check your inbox and assign a new password by following the link in the email you'll receive.

Log in to the Skywire Whitelisting System and proceed with the steps starting here.

"I cannot see any data in the system"

If you're logged into the system but cannot see your data except the option to change your password you're logged into the wrong system.

Make sure you are connected to https://whitelist.skycoin.com and not https://auth.skycoin.com!

⚠️ **GitHub.com Fallback** ⚠️