Skip to content

Latest commit

 

History

History
148 lines (90 loc) · 7.07 KB

pre-requisites.md

File metadata and controls

148 lines (90 loc) · 7.07 KB
Raw

Table of contents

Stake on the Network

In order to become an indexer on the Graph Protocol Testnet Network, you'll have to stake a minimum of 100,000 GRT.

This can easily be done via the Web UI, by going to the Testnet Graph Explorer.

  1. Go to our Discord Server. Get the Testnet role from the #roles channel, then go to the #testnet-faucet channel and get your Testnet GRT.

  2. Login with Metamask on the Wallet that holds your GRT

  3. Go to your Profile, then switch to the "Indexing" Tab and hit "Stake"

  4. Stake the amount of GRT that you desire, then you're all done!

Set your Operator

The Operator is a wallet address that is entirely separate from the address which you staked your GRT from. This Operator wallet will be filled with ETH, and will be used to send transactions (such as allocations) to the network, while keeping your Staked GRT safe in case of an attack on your infrastructure. It is highly recommended for you to use a new wallet, generated from a new mnemonic phrase.

For this, follow the instructions here first, then head back for the rest.

Okay, assuming that you followed the instructions and you have your new Operator wallet at hand, let's go and link it up with the wallet that you used to stake your GRT.

  1. Login with Metamask on the wallet that you used to stake your GRT
  2. Click the Profile dropdown button, and go to "Settings", and then to the "Operators" tab
  3. Click the Plus (+) button and add your operator public address there
  4. Submit the transaction, then you're done

Ethereum clients options

Self-hosted Trace API Stable EIP-1898 Deprecated
OpenEthereum yes ✔️ yes ✔️ yes ✔️ yes ⚠️
GETH no ⚠️ yes ✔️ yes ✔️ no ✔️
Erigon yes ✔️ yes ✔️ yes ✔️ no ✔️
Nethermind yes ✔️ yes ✔️ yes ✔️ no ✔️

Execution Clients

Network Client Size* Release
Ethereum Mainnet Erigon 1.8 TB Stable
Gnosis Mainnet Nethermind 2.0 TB Stable
Gnosis Mainnet Erigon 291 GB WIP
Polygon Mainnet Erigon 5.6 TB Stable

Consensus Clients

Network Client Size*
Ethereum Mainnet Lighthouse 169 GB
Gnosis Mainnet Lighthouse 141 GB
Polygon Mainnet Heimdall 251 GB

*Size data as of 10th of December 2022

Graph Protocol Infrastructure Specs

Minimum Specs Recommended Specs Maxed out Specs
CPU 16 vcore 64 vcore 128+ vcore
RAM 32 GB 128 GB 256/512+ GB
Storage 300 GB SATA SSD 2 TB NVME 8+ TB NVME RAID 10

The specs/requirements listed here come from our own experience during the mission control testnet from 2020. Your mileage may vary, so take this with a grain of salt and be ready to upgrade. :)

  • The minimum specs will definitely get you running, but not for long, assuming you want to serve data for more than a few heavy-weight subgraphs in the future.

  • The recommended specs are a good setup for those that want to dip more than their feet in the indexing waters. Can serve a decent number of subgraphs, but it's limited by the CPU if too many requests flow through.

  • The maxed out specs rule of thumb is basically more is better. More CPUs, more RAM, faster disks.

Closing note, regarding the specs mentioned above: ideally, they need to scale up proportional with your stake in the protocol.

Software Prerequisites

On a fresh Ubuntu server login via ssh and execute the following commands:

apt update -y && apt upgrade -y && apt autoremove -y

apt install docker.io docker-compose golang-go build-essential bc git curl httpie jq nano wget bsdmainutils base58 netcat net-tools libsecret-1-dev python2.7 clang cmake apache2-utils -y

go install github.com/a8m/envsubst/cmd/envsubst@latest

Optional Software

  • NPM (through Node Version Manager)
  • Uncomplicated Firewall (ufw)
  • pino-pretty
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm

# restart or open a new shell/terminal

nvm install node

# restart or open a new shell/terminal

npm install -g pino-pretty

apt install ufw

IMPORTANT: Make sure you open your ssh port in ufw before starting it. The default installation will try to open port 22 (default), but if you changed it, make sure you open the right port, otherwise you'll be locked out. In case that happens, reboot into rescue-mode and disable ufw.

Table of contents