MASQ Node Testing - Ropsten

Anyone with some medium level of technical skills can compile and run the software from their machine, since all the code is open sourced on GitHub. For those interested in their own time, please read below, but it is encouraged that you contact our team on Telegram or Discord, as the team might be able to onboard you for early test phases

What do I need to run MASQ Node?

You will need the following, and some knowledge of editing your router settings:

  • Head to our Testing Guideโ€‹

  • Testnet Ethereum (ROP tokens)

  • SHRD tokens for Testnet

  • Access to your router to allow port forwarding for your descriptor (see below)

  • Neighbor Node descriptor

Why are there several manual settings?

Firstly, this software is still in testing! But also, you may not realize that even VPNs require entry configuration!

The reason for the Node descriptor is that the network is peer to peer โ€“ MASQ Network is not centralized.

Even blockchains work in similar ways.

As the Node software develops, the development team and the open source community will make things easier to operate.

Where can I get a Descriptor?

You can get descriptors from other community members. MASQ team will likely launch some public nodes when testing and Beta go live.

When testing is made public, the GUI team will also release a live Node list where you can find ones users have shared, and submit your own descriptors for others to connect to.

NOTE: do this at your own risk, as it does expose your External Public IP address online!

They are in this format: Public-Descriptor : [IP format xxx.xxx.xxx.xxx ] : Port #

Eg: 4iNxG5onktEsNJo1FsyqTh5XLBtSBZyqi1Xxis2SrUg:47.112.211.72:8520

Make sure there are no spaces in front or at the end.

Descriptors are not backwards compatible with previous minor versions.

How do I forward ports?

You will need to forward the one port assigned by Node when you first connect.

Its located in your descriptor that appears on the GUI Dashboard - it is the last 4-5 digits:

e.g. In this Node Descriptor:

4iNxG5onktEsNJo1FsyqTh5XLBtSBZyqi1Xxis2SrUg:47.112.211.72:8520 ==> The port is 8520

There are many resources out there, but this website has a very comprehensive list of most routers and the instructions to forward ports:

โ€‹https://portforward.com/router.htmโ€‹

So Seed Words = Mnemonic Phrase??

Yes!

Your Mnemonic phrase is the 12 or 24 seed words used to generate wallets. By specifying a derivation path, your seed words will be run through BIP39 algorithm to produce keypairs and wallet addresses.

This is why you should NEVER share your seed words with anyone, keep several hard copies safely hidden, and keep it offline. If you lose your seed words, you will not be able to recover your wallets if you lose access.

Please do not ask MASQ team to help you recover your seed words!

I'm Confused about the Mnemonic Passphrase!

Simply put, the Mnemonic Passphrase is an extra optional seed word that can be added when generating wallets.

It is not required, but if it is included with the other 12 or 24 seed words, will create a whole different set of wallets.

You can leave this field blank when generating or recovering wallets, but once you generate a set of wallets including a mnemonic passphrase, you will always have to specify it in future.

Please note that some Wallet Managers and Software like Metamask do not support mnemonic passphrases โ€“ Metamask only supports 12 seedword phrases in many of their software plugins and integrations

What's the Wallet/db-password?

Security is paramount with MASQ Node, and is an integral tenet of the project. Thus, the if the Node software stores any private information inside it (like the consuming-wallet-private key info required) it is only stored locally on the machine under encryption.

The db-password is a personal password a user sets to encrypt your database stored locally on your machine. It is also loosely referred to as the 'Wallet Password'

The database (named node-data.db) is where your consuming wallet private key is encrypted, so it cannot be viewed or accessed by anyone except yourself.

In the code, the parameter for this is --db-password. It has no character requirements, but once you set it, it can only be changed with the old password. Make you sure record your password in a safe place

Each time you run Node, you will be prompted for your db-password, which will then decrypt your wallet information so Node can access the MASQ Network.

My Port 80 or Port 53 is Occupied - "ERROR Could not listen on Port"

This error usually occurs when another process is occupying the network port on your machine. (such as Apache taking up port 80, another instance of MASQNode running)

Firstly, ensure the user you are using has permissions to bind or occupy network ports (from command line you can run from an elevated Command Terminal, or use sudo in a UNIX system)

This page also provides some information from the developers:

โ€‹https://github.com/MASQ-Project/Node/blob/master/node/docs/PORT_53.mdโ€‹

โ€‹