Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/celestiaorg/celestia-node
Celestia Data Availability Nodes
https://github.com/celestiaorg/celestia-node
celestia data-availability data-availability-sampling
Last synced: 7 days ago
JSON representation
Celestia Data Availability Nodes
- Host: GitHub
- URL: https://github.com/celestiaorg/celestia-node
- Owner: celestiaorg
- License: apache-2.0
- Created: 2021-08-16T12:15:31.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-01-10T21:48:48.000Z (15 days ago)
- Last Synced: 2025-01-12T06:00:09.241Z (14 days ago)
- Topics: celestia, data-availability, data-availability-sampling
- Language: Go
- Homepage:
- Size: 87.8 MB
- Stars: 948
- Watchers: 33
- Forks: 956
- Open Issues: 373
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-ccamel - celestiaorg/celestia-node - Celestia Data Availability Nodes (Go)
- best-of-crypto - GitHub - 22% open · ⏱️ 04.06.2024): (Others)
README
# Celestia Node
[](https://pkg.go.dev/github.com/celestiaorg/celestia-node)
[](https://github.com/celestiaorg/celestia-node/releases/latest)
[](https://github.com/celestiaorg/celestia-node/actions/workflows/go-ci.yml)
[](https://goreportcard.com/report/github.com/celestiaorg/celestia-node)
[](https://codecov.io/gh/celestiaorg/celestia-node)
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](https://blog.celestia.org/celestia-mvp-release-data-availability-sampling-light-clients) 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](#celestia-node)
- [Table of Contents](#table-of-contents)
- [Minimum requirements](#minimum-requirements)
- [System Requirements](#system-requirements)
- [Installation](#installation)
- [API docs](#api-docs)
- [Node types](#node-types)
- [Run a node](#run-a-node)
- [Quick Start with Light Node on arabica](#quick-start-with-light-node-on-arabica)
- [Environment variables](#environment-variables)
- [Package-specific documentation](#package-specific-documentation)
- [Code of Conduct](#code-of-conduct)
## Minimum requirements
| Requirement | Notes |
| ----------- | -------------- |
| Go version | 1.23 or higher |
## System Requirements
See the official docs page for system requirements per node type:
- [Bridge](https://docs.celestia.org/nodes/bridge-node#hardware-requirements)
- [Light](https://docs.celestia.org/nodes/light-node#hardware-requirements)
- [Full](https://docs.celestia.org/nodes/full-storage-node#hardware-requirements)
## Installation
```sh
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 .
## API docs
The celestia-node public API is documented [here](https://node-rpc-docs.celestia.org/).
## Node types
- **Bridge** nodes - relay blocks from the celestia consensus network to the celestia data availability (DA) network
- **Full** nodes - fully reconstruct and store blocks by sampling the DA network for shares
- **Light** nodes - verify the availability of block data by sampling the DA network for shares
More information can be found [here](https://github.com/celestiaorg/celestia-node/blob/main/docs/adr/adr-003-march2022-testnet.md#legend).
## Run a node
`` can be: `bridge`, `full` or `light`.
```sh
celestia init
```
```sh
celestia start
```
Please refer to [this guide](https://docs.celestia.org/nodes/celestia-node/) for more information on running a node.
### Quick Start with Light Node on arabica
View available commands and their usage:
```sh
make node-help
```
Install celestia node and cel-key binaries:
```sh
make node-install
```
Start a light node with automated setup:
```sh
make light-arabica-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:
```sh
make light-arabica-up COMMAND=again # Reset node state to latest height
make light-arabica-up CORE_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](./header/doc.go)
- [Share](./share/doc.go)
- [DAS](./das/doc.go)
## Code of Conduct
See our Code of Conduct [here](https://docs.celestia.org/community/coc).