Home

Awesome

Celestia Node

Go Reference GitHub release (latest by date including pre-releases) Go CI Go Report Card codecov

Golang implementation of Celestia's data availability node types (light | full | bridge).

The celestia-node types described above comprise the celestia data availability (DA) network.

The DA network wraps the celestia-core consensus network by listening for blocks from the consensus network and making them digestible for data availability sampling (DAS).

Continue reading here if you want to learn more about DAS and how it enables secure and scalable access to Celestia chain data.

Table of Contents

Minimum requirements

RequirementNotes
Go version1.23 or higher

System Requirements

See the official docs page for system requirements per node type:

Installation

git clone https://github.com/celestiaorg/celestia-node.git
cd celestia-node
make build
sudo make install

For more information on setting up a node and the hardware requirements needed, go visit our docs at https://docs.celestia.org.

API docs

The celestia-node public API is documented here.

Node types

More information can be found here.

Run a node

<node_type> can be: bridge, full or light.

celestia <node_type> init
celestia <node_type> start

Please refer to this guide for more information on running a node.

Quick Start with Light Node on arabica

View available commands and their usage:

make node-help

Install celestia node and cel-key binaries:

make node-install

Start a light node with automated setup:

make light-arabica-up

This command:

Options:

make light-arabica-up COMMAND=again    # Reset node state to latest height
make light-arabica-up CORE_IP=<ip>     # Use custom core IP

Environment variables

VariableExplanationDefault valueRequired
CELESTIA_BOOTSTRAPPERStart the node in bootstrapper modefalseOptional

Package-specific documentation

Code of Conduct

See our Code of Conduct here.