Introduction to Nodes

The Datai Network is powered by two types of nodes, each serving a distinct function in the decentralized infrastructure. These nodes must first be run locally via Docker, and only then registered on-chain via the Datai Network Console.

Before You Start

📦 Download the Node Template

Before setting up your node, download the official node archive containing all necessary Docker files and configuration templates:

https://downloads.datai.network/node

Note

The archive includes a README file with setup instructions and template configuration.

Indexer Nodes

Indexer nodes are responsible for:

  • Indexing developer-submitted projections.

  • Aggregating and exposing real-time network data such as transactions, events, and performance metrics.

  • Enabling data availability for Gateway queries.

Running an Indexer Node supports the network’s core data layer and allows node operators to earn rewards based on the storage volume they dedicate to hosting projections.

Note

Indexer nodes require more resources but play a critical role in data integrity and access. This role is permissionless — anyone can deploy an Indexer Node.

Gateway Nodes

Gateway nodes serve as lightweight entry points for users and applications. Their main tasks are:

  • Accepting user queries through APIs.

  • Matching those requests to the relevant indexed data on Indexer Nodes.

  • Returning results to the client quickly and securely.

These nodes are cheaper to run and well-suited for application builders who want reliable data access without managing indexing infrastructure.

Caution

Gateway Nodes require prior authorization within the Datai Network. If you are not authorized, you will not be able to register a Gateway Node on-chain.

Rewards for Gateway operators are based on the volume of successful requests served.

Creating and Registering a Node

To deploy and register a node, follow these steps:

  1. Download the Node Template

    Download the official node archive containing all necessary Docker files and configuration templates:

    https://downloads.datai.network/node

    Note

    The archive includes a README file with additional setup instructions.

  2. Run your node locally via Docker After extracting the archive, configure your .env, config.toml, and other necessary files. Then launch the node using docker compose up.

  3. Get your Node ID Once your node is running, open this URL in your browser to retrieve its ID: http://localhost:9000/node/info

  4. Open the Datai Network Console Navigate to the Nodes section at:

    https://testnet.datai.network/nodes

  5. Register your Node

    • Registering an Indexer Node

    • Registering a Gateway Node

Node Roles Summary

Node Type
Responsibilities
Rewards Basis
Ideal For

Indexer Node

Index projections, store data, serve queries

Storage volume

Data providers, power users

Gateway Node

Handle requests, route to indexers, return data

Request volume

DApp developers, integrators

📌 For a detailed step-by-step deployment guide, continue to:

PreviousNode OperationsNextDeploying Gateway Node

Last updated