Mosaic Validator Onboarding Guide
This document will guide you through the steps of the validator onboarding process. Please read this guide carefully before starting the onboarding process.
The aim of the onboarding process is to connect your validator NFT to your validator node machine. As the essence of the blockchain is that there is no central server and central system-administrator, the transactions made cannot be reverted! Therefore you are solely responsible for any loss if you do not strictly follow this document’s guidance to the onboarding process.
The process consists of two parts:
Minting the Validator NFT to a SubWallet account from the Weboffice
Connecting and binding the Validator NFT to the already installed validator node in the Mosaic Explorer
Onboarding with a smartphone and mobile wallet is slightly different than using a desktop browser, you can find the necessary information for the use of a smartphone at the end of this document.
I. Novalus Weboffice
As the exclusive sales partner for Mosaic Galaxy, users must start the NFT minting process in their Novalus Weboffice interface.
In this part of the Onboarding Process you will mint your Special validator NFT on to the Mosaic chain. This means that a validator NFT will be created on the chain with a remark that it belongs to your given account.
1. Making Declaration in the Weboffice
Login to your Novalus Weboffice.
In the main Menu, select OnBoarding / Validators.
Here you will see a warning, read it carefully! (If you accepted this warning before, it will not appear again.)
By clicking on the ‘Validator NFT guide’ button you will find this guide.
After you have read the guide, check the checkbox next to the statement, click on the appearing button.
A window will show up, warning that the minting of the NFT to the Mosaic Chain is irreversible, you are responsible for following the steps of this guide. After reading the text, click on ‘I accept it’.
You will still have access to the guide after accepting the statement.
2. Connecting SubWallet wallet to your weboffice
In order to transfer your NFT from the weboffice to the Mosaic chain, you need to connect a substrate based wallet account.
For security reasons, create a new account (more new accounts if needed) in SubWallet to use on the Mainnet!
Click on the ‘Connect Wallet’ button on the Onboarding / Validators page.
A modal will show up with the possible wallet providers.
2.1. Installing SubWallet Extension on your device
If you have already installed SubWallet on your device go to step 2.2.
Click on the SubWallet button on the modal, it will guide you to the subwallet page where you can download the browser extension.
At https://www.subwallet.app/download.html you can find different download links for different browsers. You have to install the extension to the device and browser that you are using for reaching the Weboffice and later the Mosaic Explorer.
You can find detailed installation guide here:
https://docs.subwallet.app/main/extension-user-guide/getting-started
If you do not have a Substrate account yet, create a new one in SubWallet.
You can find a detailed guide for creating new account here:
It is VERY IMPORTANT that you keep the seed phrase of your account in a safe place. Write down, save, keep in a safe place the 12 original English words of your account’s seed phrase!
If you ever forget it or lose it, you will not be able to recover your account if needed! If you forget the password to the SubWallet extension or your device breaks down, and you don’t have your account’s seed phrase, you will not be able to access your account anymore! All your assets on it will be lost to you including your NFT(s) and your MOS tokens!
Also do not share your account’s seed phrase with anyone. Anyone who knows your account’s seed phrase, can have full access to your account and steal all your assets including your NFT(s) and your MOS tokens!
This is the most important safety information: The biggest security risk is that you lose or disclose your account’s seed phrase.
After installing SubWallet, refresh your browser and continue with step 2.2.
2.2. SubWallet already installed
For security reasons, create a new account (more new accounts if needed) in SubWallet to use on the Mainnet!
If you have SubWallet Extension already installed on your device, click on SubWallet in the Connect wallet modal, this will initiate the SubWallet extension to ask your permission for connecting to this site. In the pop-up SubWallet window choose the account you would like to use (if you have only one, you have to select that), and click on Connect. If you would like to connect all your accounts later, you can select all accounts in the SubWallet app, then later you can choose between them in the weboffice.
Only connect an account if you know the 12 original English words of its seed phrase! Check it now! If you forgot or lost the seed phrase of your account, export it from SubWallet if you still have access to your wallet, or create a new account, and preserve its seed phrase in a safe place!
This is the most important safety information: The biggest security risk is that you lose or disclose your account’s seed phrase.
After clicking on Connect, your account will be connected to the weboffice, you can see the connected account address above the table, and you can see your validator NFT(s).
2.3. Connecting another wallet or account
After connecting your wallet, in the bottom right corner you will see a button with the Novalus logo and the SubWallet logo on it. By clicking on it, the wallet menu appears. Here you can choose to switch between accounts or connect another wallet or disconnect all wallets.
If you have more accounts in your wallet but at step 2.2. you only allowed one to be connected, you will need to set the connection status of the other accounts in the SubWallet extension.
3. Minting NFT to your account
After connecting your wallet you can see your Validator NFT(s) on the list. If you have more than one, be aware that you can mint only 1 Special Validator NFT on a wallet account. You will need more accounts for more NFTs.
Click on the MINT NFT button next to your Special Validator NFT.
In the pop-up window check the details thoroughly. After confirming this step there is no possibility of withdrawal or cancellation!
If you have made sure that the data is correct, click on I ACCEPT IT.
4. Sign with wallet
The SubWallet extension window will pop up asking your signature to send the transaction request. Check the details by clicking on “View details”, wallet provider’s are trustable, but make it a habit that you always check what you are about to sign!
If you checked what the wallet asks your signature for is really what you want, click on Approve. After approval, SubWallet returns you to the Weboffice screen.
Now you have to wait a bit until the transaction is finalized on the chain, until then a yellow clock icon can be seen next to the Validator NFT. You can occasionally click the refresh button at the top of the table, to display the result.
If the transaction succeeded, you will see a green checkmark at the Status. A “View” button appears next to it, and clicking on it, you will be redirected to the Mosaic Explorer where you can see the transaction’s details.
The red x in the Mainnet column does not indicate an error, it means that this NFT can no longer be minted on the mainnet (either because it has already been minted or because there is already a validator NFT on the connected account).
(If the transaction failed, there will be a red “Failed” sign, by clicking on it, you will see the reason for the failure.)
5. Viewing your NFT and assets on the Mosaic Chain
You can see your account’s details and assets on the Mosaic Explorer. Open the mainnet-explorer.mosaicchain.io page and paste your account address into the search field. Click on the search result and you can see the balance of your account and also its NFTs.
In the Polkadot ecosystem the same account can appear under different addresses on different chains, the SubWallet and Weboffice format starts with a five, on the Mosaic Explorer, account addresses are starting with a one.
For more information on the subject and on how to see your MOS balance in the SubWallet check the relevant guide.
II. Mosaic Explorer Admin Interface
To proceed with this step you need your validator node machine already installed and registered in the VPN network, with a completed chain synchronization process.
1. Sign in to your Admin Dashboard on Mosaic Explorer
Go to https://mainnet-explorer.mosaicchain.io/ in the same browser you have installed the SubWallet Extension.
To sign in as a Validator Node Admin, click on the ‘Validator Dashboard’ button in the top right corner of the screen.
In the login form, at the first field you can select your node if you are connected to a different one. From the dropdown, select your validator node, type in a few characters to filter for the name that you have provided during the Mosaic Validator OS installation and registration process.
When you have selected your node, the connection switches to that.
Type in your username and password that you have provided during the Mosaic Validator OS installation, it is the username and password to your validator machine.
After this you have to provide the code for your two-factor authentication (2FA). This is what you have set up during the Mosaic Validator OS installation by taking a photo of the QR code with the authenticator app.
Open your authenticator app and check the code for your validator node and type it in.
If you have provided the right credentials you will be signed in to your validator node’s admin dashboard.
If you mistyped anything, you will get an error telling you where your mistake was (username and password or the 2FA code), and you can try again.
If your validator node has not completed the blockchain synchronization yet, you will see a screen that shows the status of this process. The finalized block might stay at zero for a while while the relay chain is warp synchronizing, but it will eventually increase. You can not continue until synchronization is complete.
The synchronization of the blockchain and the indexer are two separate processes, a fully synchronized blockchain works without the indexer. The indexer helps in displaying historical data.
2. Connect wallet
At the first login to your Admin Dashboard, the Onboarding Process comes up as default if your Special Validator NFT is not yet bound to your validator node.
Click on ‘Connect wallet’ on the welcome screen.
Here you can choose your wallet provider, as SubWallet was suggested in the weboffice part, choose SubWallet.
This will initiate the SubWallet to ask your permission for connecting to this site. In the pop-up window choose the account you would like to use (if you have only one, you have to select that), and click on Connect. If you have more accounts, you can select ‘All accounts’, then you can switch between accounts later directly in the Explorer.
If you connect only one account from multiple accounts in this SubWallet window, you can change it later only directly in the settings of SubWallet, there is no possibility to approve other accounts in your wallet provider from the Explorer. Also if you click on the Reject button here (the red button with a shield), SubWallet will remember this setting and you can only change it later directly in the settings in SubWallet, the Explorer will not have access to the wallet. (https://docs.subwallet.app/main/extension-user-guide/connect-dapps-and-manage-website-access#manage-websites-access)
After approving the connection with SubWallet you are guided back to the Explorer where you can select your account. If there is only one, you need to click on it, too.
After selecting your account, it is connected to the Mosaic Explorer, you can see it in the top right corner as well.
The onboarding process continues with the next screen.
3. Authorizing proxy wallet
To explain simply the technical background, the binding of the Special Validator NFT to your validator node machine consists of two parts. First you give permission (proxy) from your account that holds your Special Validator NFT to the validator node (which has the so-called controller account) to perform certain actions in connection with the Special Validator NFT that are needed for the validation process. Second you bind the Special Validator NFT, so it cannot be transferred or used elsewhere or burned.
When your account is connected, an automatic check is made on the account for Special Validator NFTs. You see the small circle spinning while the check is running.
When the check is finished you will see a check mark if there is a single Special Validator NFT on the connected wallet account. If there is no NFT or there are multiple NFTs you will see a red x and the corresponding message at this point.
When the Special Validator NFT is found, the ‘Authorize proxy wallet’ button becomes active.
With the authorization 20 MOS will be transferred to the controller account for the small fees the controller account has to pay when it acts on behalf of the account that holds the Special Validator NFT (e.g. binding the NFT). (During the weboffice minting process, together with the validator NFT, some MOS was also credited to your account, there will be a cover for it.)
Click on the ‘Authorize proxy wallet’ button to send the proxy transaction to the chain.
The SubWallet request for signing the transaction pops up. Check the details as always and if you agree, click on ‘Approve’.
After you have signed (approved) the proxy transaction, you will see the transaction's progress on the blockchain in a blue message box in the bottom left corner of the screen. Finalization might take a minute, just wait patiently.
When the transaction is finalized on the blockchain, that is your account authorized your validator node’s controller account to be its proxy, it will be saved on your validator node, too.
If your last two-factor authentication was more than a few minutes ago, you have to enter your 2FA code again here for this step. Open your two-factor authenticator app and check the code for your validator node and type it in.
Now the account that holds your Special Validator NFT (stash account) has authorized the controller account on your machine as its proxy.
4. Rotate session keys
Next, as a technical step, the session keys necessary for secure communication on your node need to be set. Click the “Rotate session keys” button to do this.
5. Bind your Special Validator NFT
To bind your validator NFT, you need to click on the ‘Bind NFT’ button to start the blockchain transaction.
This transaction is initiated by your validator node now. If a few minutes have passed since your last two-factor authentication, you have to provide your 2FA code again to approve it.
When the process is finished, a congrats screen will show. After clicking on continue on this screen you will see your validator admin dashboard.
Congratulations, your onboarding process is completed! Your validator is fully set up, the Mosaic Journey begins!
Your node is now taking part in block generation and validation. If you need to turn it off, you have to chill it first to let the chain know it will not be available! You can give the chill command on the validator admin dashboard.
Onboarding on smartphone
The difference to the above onboarding process when doing it on a phone is the following.
1. Install SubWallet to your phone
Download the SubWallet app from the App Store or Google Play and install it.
Detailed instructions for installation:
https://docs.subwallet.app/main/mobile-app-user-guide/getting-started
If you do not have a Substrate account yet, create a new one in SubWallet.
You can find a detailed guide for creating new account here:
It is VERY IMPORTANT that you keep the seed phrase of your account in a safe place. Write down, save, keep in a safe place the 12 original English words of your account’s seed phrase!
If you ever forget it or lose it, you will not be able to recover your account if needed! If you forget the password to the SubWallet extension or your device breaks down, and you don’t have your account’s seed phrase, you will not be able to access your account anymore! All your assets on it will be lost to you including your NFT(s) and your MOS tokens!
Also do not share your account’s seed phrase with anyone. Anyone who knows your account’s seed phrase, can have full access to your account and steal all your assets including your NFT(s) and your MOS tokens!
This is the most important safety information: The biggest security risk is losing or disclosing your account’s seed phrase.
2. Open the website in the SubWallet browser
The onboarding flow is the same as described above in the guide, but you have to access both the Weboffice and the Mosaic Explorer through SubWallet’s browser.
On the SubWallet homepage, press the "dApps" tab at the bottom of the screen.
For the first phase of the process type in the search bar the address of the weboffice, novalusprime.com. Hit enter, and SubWallet connects to the site and you can complete the onboarding process according to what is written in the above guide for computer browsers.
For the second phase type in the search bar the address of the mosaic explorer, mainnet-explorer.mosaicchain.io. Hit enter, and SubWallet connects to the site and you can complete the onboarding process according to what is written in the above guide for computer browsers.
Last updated