MassBit Route How to Test Guide

Exclusively For 10 Testnet Participants In The Whitelist

About MassBit Route

MassBit Route (MBR) is the decentralized APIs (dAPIs) of blockchain networks, helping fulfill the dream of decentralization. MBR is empowered by MassBit Verification Protocol — a decentralized proof of stake system that ensures all workers execute their tasks correctly, while also checking on each other’s work to verify that everyone is acting properly. MBR offers a quick, stable and reliable service, all at a fraction of the cost of centralized networks, while also being open to everyone, with the ability to stake and receive rewards for completed work!

In this document we will guide you on how to get started in product testing, there are 4 roles that you can join, including:

• Node: A blockchain node to handle requests from dAPI users
• Gateway: Gateways will get MassBit token rewards for routing dAPI requests to the same type of blockchain nodes.
• Decentralized APIs: Teams wishing to launch their API in a decentralized manner. Products can be a connection between computers or between computer programs.
• Community Member: Any community member can join to test any of the 3 roles above.

*Open to the entire community — we do not discriminate! The beauty of MBR is that as long as someone can meet the requirements needed to run nodes or gateways, then that’s all that is needed.

*This guide is only for whitelisted members, after receiving a confirmation email from MassBit, please follow the guidelines below

In case you need more information about the Testnet please visit here!

1/ For Decentralized APIs

Description

DApp developers or web3 app users can create a new API key. With this API key, users can access blockchain data powered by MassBit. Currently, MassBit Route supports following blockchains: Ethereum and Polkadot

Guideline

• Step 1: After receiving the login information through the email, go to the homepage of MassBit Route portal and click Decentralized API

• Step 2: At the first time your API list is empty, click to button “Create new API Key” to create API

• Step 3: Enter your API key name, and select your desired blockchain, then, click “Create”

• Step 4: In the API setting page, scroll down to “Entry points” Sections to add an entry point for the API. Each API can have multiple entry points. You can open this setting page from the API list by clicking the “API Key Settings”.

• Step 5: Enter all fields for API entry point.

MassBit Route supports following entry point types:

• MASSBIT: blockchain data provider is masbit route nodes (backed by massbit community)
• INFURA: blockchain data provider is Infura, you must provide your project ID and secret
• GETBLOCK: blockchain data provider is Getblock, you must provide your API key
• QUICKNODE: blockchain data provider is Getblock, you must provide your API URI
• CUSTOM: blockchain data provider is your blockchain node

*Note: At priority, the higher number, the more priority

• Step 6: For now, you can use HTTPS and WSS entry points provided by MassBit Route to access blockchain data.

• Step 7: As the result, check the API with the Metamask Wallet.

Open Metamask.

• Step 8: Click to Settings and then scroll down to the Networks section.

• Step 9: Click “Add Network”, then, use HTTPS provided by MassBit to fill out the network form as below. Click “Save”.

You will see a message that a new network was successfully added at the right bottom corner.

• Step 10: Add your feedback at our Discord channel

*Note: We don’t limit the number of times you give feedback during the Testnet. We encourage the participants to add as much valuable feedback as possible and reward you well for your dedication.

2/ For Community Nodes

Description

In the MassBit Route network, nodes are the blockchain providers, each Community Node includes two parts:

• Chain node such as Ethereum node or Polkadot node
• MassBit node proxy for running MassBit node agent and forward requests from user dAPIs to chain nodes

Guideline

• Step 0: Run chain node follow official node’s documents:
  For example, running Ethereum with geth

https://www.quicknode.com/guides/infrastructure/how-to-install-and-run-a-geth-node

https://geth.ethereum.org/docs/getting-started

• Step 1: Run MassBit node proxy
  We recommend using a dedicated server for node proxy. This server requires access to the chain node setup in step 2.1 as a data source.

Prepare a server with ubuntu version 20.04 LTS which has a static IP

• Step 2: Open homepage of the Massbit Route portal and click to the button “Community Node”

• Step 3: In the nodes page, choose a zone of your blockchain node.

• Step 4: Fill the node creation form. Datasource is your blockchain node’s IP in Step 0.

• Step 5: After node creation, login to your node proxy server created in Step 1 and run the install script as root user. After installation, your node successfully joins the MassBit Route network and is ready to serve requests to get blockchain data.

• After the script runs successfully, refresh the node page and you can see node info as follows:

*Note: Before installing script, enable remote access to ports: 80, 443. Besides, we will check nodes health and approve nodes before adding them to the MassBit Route network.

• Step 6: Add your feedback at our Discord channel

*Note: We don’t limit the number of times you give feedback during the Testnet. We encourage the participants to add as much valuable feedback as possible and reward you well for your dedication.

3/ For Community Gateways

Description

For routing requests from user’s API to nodes, MassBit Route needs a supported layer called “Gateway”. Gateway not only routes requests to nodes, it works as a temporary cache to reduce response time from blockchain nodes.

Guideline

• Step 1: After receiving the login information through the email, go to the homepage of the MassBit Route portal and click “Community Gateway”

• Step 2: Prepare your server which will join the MassBit Route network as gateway and choose its zone to create the gateway.

• Step 3: Fill the gateway creation form

• Step 4: Then log in to your machine and install a script for gateway as root user.

• After successfully installing the script, you can see the message in the terminal like this:

• And gateway info on the browser after refreshing.

*Note: Before installing script, enable remote access to ports: 80, 443

• Step 5: Add your feedback at our Discord channel

*Note: We don’t limit the number of times you give feedback during the Testnet. We encourage the participants to add as much valuable feedback as possible and reward you well for your dedication.

4/ For The Community Member

Description

The community member can participate in the Testnet in any of the 3 roles: Node, Gateway and Decentralized API. We encourage users to experiment as much as possible and test all the features of the product.

Guideline

• Step 1: After receiving the login information through the email, choose one of 3 roles and click to button “Decentralized API / Community Gateway / Community Node” here

• Step 2: Follow the guide as described for each role as above.
• Final Step: Add your feedback at our Discord channel

*Note: We don’t limit the number of times you give feedback during the Testnet. We encourage the participants to add as much valuable feedback as possible and reward you well for your dedication.

Terms & Conditions:

• Participants understand that by joining the MassBit Testnet they will be known by the MassBit team.
• All of the following actions will be considered invalid if a participant is found to have engaged in such acts during the Testnet period, their rights will be terminated/locked indefinitely: Create FUD, publish the bugs/community testing information.
• The MBR product will be continuously upgraded. Participants must coordinate closely with the MassBit team to develop the product during the entire Testnet period.
• The members who have been active and supporting in the Massbit project will receive the plus.
• The reward will be distributed when MassBit is launched, and the MassBit team will use the closing price of the MassBit token on the day of distribution as the exchange rate.
• The list of winners will be announced on MassBit official channels within 5 days after the event has ended.
• All decisions made by the MassBit team are final and cannot be challenged or changed.

At MassBit, we aim to empower not only developer teams around the world but also end-users who are looking forward to a seamless transition to Web 3.0. Should you have any questions, feel free to reach out to us at our Discord.

About MassBit:

MassBit provides fully decentralized solutions for Defi and Web3 App project development. Currently with 3 products in the stage of development, MassBit enables DeFi and Web3 App development to be faster, stable, scalable, and more cost-effective.

The powerful ‘glue’ holding together and supporting all the products is the MassBit Verification Protocol, which is based on Proof of Stake. The protocol incentivizes those working within the system to verify each other’s work. The verification of other nodes, gateways, or indexers gives rewards or penalties for the mistakes to each individual or entity. From that, the protocol ensures the whole network’s health.

Join the MassBit Community:

Website | Twitter | Medium | Youtube | Facebook | Instagram | Discord |Telegram