Celestia Node

Golang implementation of Celestia's data availability node types (light | 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

• Celestia Node
  • Table of Contents
  • Minimum requirements
  • System requirements
  • Supported architectures
  • Installation
  • API docs
  • Node types
  • Run a node
    • Quick Start with Light Node on mocha
  • Environment variables
  • Package-specific documentation
  • Contributing
  • Code of Conduct

Minimum requirements

Requirement	Notes
Go version	1.26.10 or higher

System requirements

See the official docs page for system requirements for each node type.

Supported architectures

Celestia-node officially supports the following architectures:

• linux/amd64
• linux/arm64
• darwin/amd64 (macOS Intel)
• darwin/arm64 (macOS Apple Silicon)

Only these four architectures are officially tested and supported.

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.

Revoke an RPC token

Use an admin token to revoke a previously issued token on a running node:

celestia node revoke-token "$TOKEN_TO_REVOKE" --url http://localhost:26658 --token "$ADMIN_TOKEN"

Node types

• Bridge nodes - relay blocks from the celestia consensus network to the celestia data availability (DA) network
• Light nodes - verify the availability of block data by sampling the DA network for shares

More information can be found here.

Run a node

<node_type> can be: bridge 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 mocha

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-mocha-up

This command:

• Automatically checks wallet balance
• Requests funds from faucet if needed
• Sets node height to latest-1 for quick startup
• Initializes the node if running for the first time

Options:

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

Environment variables

Variable	Explanation	Default value	Required
CELESTIA_BOOTSTRAPPER	Start the node in bootstrapper mode	false	Optional

Package-specific documentation

• Header
• Share
• DAS

Contributing

See CONTRIBUTING.md. PR titles must follow conventional commits and start the subject with a review level tag, [high], [medium], or [low] (e.g. fix(das): [high] ...); see PR Naming for definitions. Choose the higher level when unsure.

Code of Conduct

See our Code of Conduct here.