Skip to main content

6. 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
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

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 worker, to fetch data from the network or to start participating in the network as a validator.

Set up a scraper: Worker Node

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

info

You need to have setup your node and staked your node first 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).

info

To get data from the Masa Protocol as a developer you need to stake your node (no free leech) - you need Sepolia ETH to stake.

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.