Skip to main content

7. Run Protocol Node

This walkthrough assumes you have setup a Digital Ocean environment. If you have not, please refer to the Setup Guide.

Clone our repository​

Clone our repository

git clone https://github.com/masa-finance/masa-oracle.git

Navigate to the root directory

cd masa-oracle

Get the latest release

latest_tag=$(git describe --tags `git rev-list --tags --max-count=1`)

Checkout the latest release

git checkout $latest_tag

Install Project Dependencies​

install GO, NPM, and PM2

sudo apt install -y golang-1.22
sudo apt install npm
sudo npm install -g pm2

Install Contract Dependencies​

Install the contract dependencies

cd contracts
npm install

Return to the root directory

cd ..

Create .env file​

vim .env
# Default Configuration
RPC_URL=https://ethereum-sepolia.publicnode.com
ENV=test
FILE_PATH=.
VALIDATOR=false
PORT=8080
API_ENABLED=true

Save and exit

:wq

Build the node​

Build the protocol node

make build

Start the node​

Start the protocol node

make run

You will see the following output:

#######################################
#     __  __    _    ____    _        #
#    |  \/  |  / \  / ___|  / \       #
#    | |\/| | / _ \ \___ \ / _ \      #
#    | |  | |/ ___ \ ___) / ___ \     #
#    |_|  |_/_/   \_\____/_/   \_\    #
#                                     #
#######################################

Multiaddress:        /ip4/192.168.1.8/udp/4001/quic-v1/p2p/16Uiu2HAmDXWNV9RXVoRsbt9z7pFSsKS2KdpN7HHFVLdFZmS7iCvo
IP Address:          /ip4/127.0.0.1/udp/4001/quic-v1
Public Key:          0x5dA36a3eB07fd1624B054b99D6417DdF2904e826
Is Staked:           false
Is Validator:        false
Is TwitterScraper:   false
Is DiscordScraper:   false
Is TelegramScraper:  false

Interact with the node​

Visit the following URL to interact with the node:

http://<droplet-ip-address>:8080/swagger/#/
tip

You now have a running node in Local Bootnode configuration

Configure your node​

You can now configure your node to start scraping data as a miner, to fetch data from the network or to start participating in the network as a validator.

Set up a scraper: Miner Node​

If you want your node to earn rewards configure it to to scrape data on the Masa Protocol.

tip

You need to have setup your node and staked sepolia MASA to be able to scrape data!

Get data from the Network: Developer Node​

AI developers can get data from the Masa Protocol for free by running a Masa node locally or by using our API (coming soon).

caution

To get data from the Masa Protocol as a developer, you need to stake sepolia Masa with your node (no free leech) - you need 0.01Sepolia ETH for the sepolia Masa faucet to function.

Secure the Network: Validator Node​

Earn MASA rewards by securing the network:

  • Validator Configuration (coming soon!)

Advanced Configuration​

For more detailed setup options:

  • Environment Configuration Guide (coming soon!)
  • Network Configuration Guide (coming soon!)

Troubleshooting and Support​

If you encounter any issues:

Choose the path that best fits your needs and follow the respective guide for detailed instructions.