celestia-app
celestia-app is a blockchain application built using parts of the Cosmos stack. celestia-app uses
- celestiaorg/cosmos-sdk a fork of cosmos/cosmos-sdk
- celestiaorg/celestia-core a fork of cometbft/cometbft
Diagram
^ +-------------------------------+ ^
| | | |
| | State-machine = Application | |
| | | | celestia-app (built with Cosmos SDK)
| | ^ + | |
| +----------- | ABCI | ----------+ v
Celestia | | + v | ^
validator or | | | |
full consensus | | Consensus | |
node | | | |
| +-------------------------------+ | celestia-core (fork of CometBFT)
| | | |
| | Networking | |
| | | |
v +-------------------------------+ v
Install
-
Install Go 1.21
-
Clone this repo
-
Install the celestia-app CLI
make install
Usage
# Print help
celestia-appd --help
Environment variables
Variable | Explanation | Default value | Required |
---|---|---|---|
CELESITA_HOME |
Home directory for the application | User home dir. Ref. | Optional |
Create your own single node devnet
# Start a single node devnet using the pre-installed celestia app
./scripts/single-node.sh
# Build and start a single node devnet
./scripts/build-run-single-node.sh
# Post data to the local devnet
celestia-appd tx blob PayForBlobs [hexNamespace] [hexBlob] [flags]
Note: please note that the ./scripts/
commands above, created a random tmp
directory and keeps all data/configs there.
See https://docs.celestia.org/category/celestia-app for more information
Contributing
This repo attempts to conform to conventional commits so PR titles should ideally start with fix:
, feat:
, build:
, chore:
, ci:
, docs:
, style:
, refactor:
, perf:
, or test:
because this helps with semantic versioning and changelog generation. It is especially important to include an !
(e.g. feat!:
) if the PR includes a breaking change.
Tools
- Install golangci-lint
- Install markdownlint
- Install hadolint
- Install yamllint
- Install markdown-link-check
Helpful Commands
# Build a new celestia-app binary and output to build/celestia-appd
make build
# Run tests
make test
# Format code with linters (this assumes golangci-lint and markdownlint are installed)
make fmt
# Regenerate Protobuf files (this assumes Docker is running)
make proto-gen
Docs
Package-specific READMEs aim to explain implementation details for developers that are contributing to these packages. The specs aim to explain the protocol as a whole for developers building on top of Celestia.
Careers
We are hiring Go engineers! Join us in building the future of blockchain scaling and interoperability. Apply here.