Skip to content

ChainSafe/nodewatch-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

115452d · Jan 24, 2024
Jan 24, 2024
Aug 24, 2022
Nov 1, 2022
Oct 14, 2022
Nov 1, 2022
Nov 1, 2022
Aug 24, 2022
Nov 1, 2022
Aug 24, 2022
Jul 28, 2021
Jul 23, 2021
Jan 15, 2024
Jan 24, 2024
Jan 15, 2024
Jul 21, 2021
Jan 15, 2024
Sep 30, 2022
Jul 21, 2021
Jul 28, 2021
Jan 15, 2024
Jan 15, 2024
Jul 21, 2021

Repository files navigation

Eth2 Crawler

Eth2 Crawler is Ethereum blockchain project that extracts eth2 node information from the network save it to the datastore. It also exposes a graphQL interface to access the information saved in the datastore.

Getting Started

There are three main components in the project:

  1. Crawler: crawls the network for eth2 nodes, extract additional information about the node and save it to the datastore
  2. MongoDB: datastore to save eth2 nodes information
  3. GraphQL Interface: provide access the stored information

Prerequisites

  • docker
  • docker-compose

Environment Setup

Before building, please make sure environment variables RESOLVER_API_KEY(which is used to fetch information about node using IP) is setup properly. You can get your key from IP data dashboard. To setup the variable, create an .env in the same folder as of docker-compose.yaml

Example .env File

RESOLVER_API_KEY=your_ip_data_key

Configs and Flags

Eth2 crawler support config through yaml files. Default yaml config is provided at cmd/config/config.dev.yaml. You can use your own config file by providing it's path using the -p flag

Usage

We use docker-compose for testing locally. Once you have defined the environment variable in the .env file, you can start the server using:

make run

Additional Commands

  • make run - run the crawler service
  • make lint - run linter
  • make test - runs the test cases
  • make license - add license to the missing files
  • make license-check - checks for missing license headers

LICENSE

See the LICENSE file for license rights and limitations (lgpl-3.0).