{"id":13746786,"url":"https://github.com/celestiaorg/celestia-app","last_synced_at":"2026-06-02T05:00:49.842Z","repository":{"id":37219165,"uuid":"327696712","full_name":"celestiaorg/celestia-app","owner":"celestiaorg","description":"Celestia consensus node","archived":false,"fork":false,"pushed_at":"2026-06-01T09:56:08.000Z","size":109718,"stargazers_count":412,"open_issues_count":406,"forks_count":501,"subscribers_count":17,"default_branch":"main","last_synced_at":"2026-06-01T11:28:14.142Z","etag":null,"topics":["celestia","cosmos-sdk","lazyledger"],"latest_commit_sha":null,"homepage":"https://celestiaorg.github.io/celestia-app/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/celestiaorg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-01-07T18:42:35.000Z","updated_at":"2026-06-01T11:17:43.000Z","dependencies_parsed_at":"2023-10-10T15:30:15.041Z","dependency_job_id":"5ed1475a-9655-4292-aaba-d7e662554d0f","html_url":"https://github.com/celestiaorg/celestia-app","commit_stats":{"total_commits":1581,"total_committers":77,"mean_commits":"20.532467532467532","dds":0.6812144212523719,"last_synced_commit":"4a559d210dd23444a91f8fbfd4184e61b0a80959"},"previous_names":["lazyledger/lazyledger-app","celestiaorg/lazyledger-app"],"tags_count":372,"template":false,"template_full_name":null,"purl":"pkg:github/celestiaorg/celestia-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celestiaorg%2Fcelestia-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celestiaorg%2Fcelestia-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celestiaorg%2Fcelestia-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celestiaorg%2Fcelestia-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/celestiaorg","download_url":"https://codeload.github.com/celestiaorg/celestia-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celestiaorg%2Fcelestia-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33806987,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["celestia","cosmos-sdk","lazyledger"],"created_at":"2024-08-03T06:01:01.465Z","updated_at":"2026-06-02T05:00:49.833Z","avatar_url":"https://github.com/celestiaorg.png","language":"Go","funding_links":[],"categories":["Go","Others"],"sub_categories":[],"readme":"# celestia-app\n\n[![Go Reference](https://img.shields.io/badge/godoc-reference-blue.svg)](https://pkg.go.dev/github.com/celestiaorg/celestia-app)\n[![mdBook Specs](https://img.shields.io/badge/mdBook-specs-blue)](https://celestiaorg.github.io/celestia-app/)\n[![GitHub Release](https://img.shields.io/github/v/release/celestiaorg/celestia-app)](https://github.com/celestiaorg/celestia-app/releases/latest)\n[![Go Report Card](https://goreportcard.com/badge/github.com/celestiaorg/celestia-app)](https://goreportcard.com/report/github.com/celestiaorg/celestia-app)\n[![GitPOAP Badge](https://public-api.gitpoap.io/v1/repo/celestiaorg/celestia-app/badge)](https://www.gitpoap.io/gh/celestiaorg/celestia-app)\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/celestiaorg/celestia-app)\n\ncelestia-app is the software used by [validators](https://docs.celestia.org/operate/consensus-validators/validator-node/) and [consensus nodes](https://docs.celestia.org/operate/consensus-validators/consensus-node/) on the Celestia consensus network. celestia-app is a blockchain application built using parts of the Cosmos stack:\n\n- [celestiaorg/cosmos-sdk](https://github.com/celestiaorg/cosmos-sdk) a fork of [cosmos/cosmos-sdk](https://github.com/cosmos/cosmos-sdk)\n- [celestiaorg/celestia-core](https://github.com/celestiaorg/celestia-core) a fork of [cometbft/cometbft](https://github.com/cometbft/cometbft)\n\n## Diagram\n\n```ascii\n                ^  +-------------------------------+  ^\n                |  |                               |  |\n                |  |  State-machine = Application  |  |\n                |  |                               |  |   celestia-app (built with Cosmos SDK)\n                |  |            ^      +           |  |\n                |  +----------- | ABCI | ----------+  v\nCelestia        |  |            +      v           |  ^\nvalidator or    |  |                               |  |\nfull consensus  |  |           Consensus           |  |\nnode            |  |                               |  |\n                |  +-------------------------------+  |   celestia-core (fork of CometBFT)\n                |  |                               |  |\n                |  |           Networking          |  |\n                |  |                               |  |\n                v  +-------------------------------+  v\n```\n\n## Install\n\n### From source\n\n1. [Install Go](https://go.dev/doc/install) 1.26.1\n1. Clone this repo\n1. Install the celestia-appd binary. This installs a \"multiplexer\" binary that will also download embedded binaries for the latest celestia-app v3.x.x and v4.x.x release.\n\n    ```shell\n    make install\n    ```\n\n### Prebuilt binary\n\nIf you'd rather not install from source, you can download a prebuilt binary from the [releases](https://github.com/celestiaorg/celestia-app/releases) page.\n\n1. Navigate to the latest release on \u003chttps://github.com/celestiaorg/celestia-app/releases\u003e.\n1. Download the binary for your platform (e.g. `celestia-app_Linux_x86_64.tar.gz`) from the **Assets** section. Tip: if you're not sure what platform you're on, you can run `uname -a` and look for the operating system (e.g. `Linux`, `Darwin`) and architecture (e.g. `x86_64`, `arm64`).\n1. Extract the archive\n\n    ```shell\n    tar -xvf celestia-app_Linux_x86_64.tar.gz\n    ```\n\n1. Verify the extracted binary works\n\n    ```shell\n    ./celestia-appd --help\n    ```\n\n1. (Optional) verify the prebuilt binary checksum. Download `checksums.txt` and then verify the checksum:\n\n    ```shell\n    sha256sum --ignore-missing --check checksums.txt\n    ```\n\n    You should see output like this:\n\n    ```shell\n    celestia-app_Linux_x86_64.tar.gz: OK\n    ```\n\nSee \u003chttps://docs.celestia.org/operate/consensus-validators/install-celestia-app/\u003e for more information.\n\n## Supported operating systems\n\nThis is the canonical matrix of operating systems that celestia-app is built for and tested against. For the OS versions a *specific* release was tested on, see the per-release entries in [docs/release-notes/release-notes.md](docs/release-notes/release-notes.md).\n\n### Tested in CI\n\ncelestia-app's GitHub Actions workflows run all unit, integration, and lint jobs on:\n\n| OS                       | Version                         | Architecture |\n|--------------------------|---------------------------------|--------------|\n| Ubuntu (`ubuntu-latest`) | Ubuntu 24.04 LTS (Noble Numbat) | x86_64       |\n\nGitHub may advance `ubuntu-latest` to a newer LTS over time; see [actions/runner-images](https://github.com/actions/runner-images) for the current alias mapping.\n\nOther OS / version combinations may work but are not exercised by CI and are not officially supported.\n\nNote that arm64 binaries are cross-compiled via goreleaser but are not executed in CI; only the x86_64 build is exercised end-to-end.\n\n### Prebuilt binaries\n\nThe [GitHub Releases](https://github.com/celestiaorg/celestia-app/releases) page provides prebuilt binaries for:\n\n| OS    | Architectures    |\n|-------|------------------|\n| Linux | `amd64`, `arm64` |\n| macOS | `amd64`, `arm64` |\n\nLinux binaries built with the multiplexer require **glibc \u003e= 2.38** (Ubuntu 24.04 or equivalent). See [Prerequisites](#prerequisites) for details.\n\n### Known incompatibilities\n\n- **Windows**: the `celestia-appd` binary does not support signing with Ledger hardware wallets.\n- **OpenBSD**: the `celestia-appd` binary does not support signing with Ledger hardware wallets.\n- **Ubuntu 22.04 and older**: incompatible with multiplexer builds (glibc \u003c 2.38).\n\n## Usage\n\n### Prerequisites\n\n\u003e [!CAUTION]\n\u003e If you are using the multiplexer binary (default `make build`), the embedded binaries require glibc \u003e= 2.38. This means **Ubuntu 24.04 or later** (or an equivalent distribution) is required. Nodes running older OS versions (e.g., Ubuntu 22.04) will fail to start with a glibc version mismatch error.\n\nIf you are on Linux, enable the [BBR](https://www.ietf.org/archive/id/draft-cardwell-iccrg-bbr-congestion-control-01.html) (\"Bottleneck Bandwidth and Round-trip propagation time\") congestion control algorithm.\n\n```shell\n# Check if BBR is enabled (Linux only).\nmake bbr-check\n\n# If BBR is not enabled then enable it (Linux only).\nmake bbr-enable\n```\n\n### Environment variables\n\n| Variable            | Explanation                                  | Default value                                              | Required |\n|---------------------|----------------------------------------------|------------------------------------------------------------|----------|\n| `CELESTIA_APP_HOME` | Where the application files should be saved. | [`$HOME/.celestia-app`](https://pkg.go.dev/os#UserHomeDir) | Optional |\n\n### Using celestia-appd\n\n```sh\n# Print help.\ncelestia-appd --help\n\n# Create config files for a new chain named \"test\".\ncelestia-appd init test\n\n# Start the consensus node.\ncelestia-appd start\n```\n\n### Create a single node local testnet\n\n```sh\n# Start a single node local testnet.\n./scripts/single-node.sh\n\n# Publish blob data to the local testnet.\ncelestia-appd tx blob pay-for-blob 0x00010203040506070809 0x48656c6c6f2c20576f726c6421 \\\n\t--chain-id test \\\n\t--from validator \\\n\t--keyring-backend test \\\n\t--fees 21000utia \\\n\t--yes\n\n# Query the tx\ncelestia-appd query tx \u003ctxhash from previous command\u003e\n```\n\n### Join a public Celestia network\n\nFor instructions on running a node on Celestia's public networks, refer to the\n[consensus node](https://docs.celestia.org/operate/consensus-validators/consensus-node/)\nguide in the docs.\n\n\u003e [!NOTE]\nWhen connecting to a public network, you must download the correct\ngenesis file. Please use the `celestia-appd download-genesis` command.\n\n### Usage as a library\n\nIf you import celestia-app as a Go module, you may need to add some Go module `replace` directives to avoid type incompatibilities. Please see the `replace` directive in [go.mod](./go.mod) for inspiration.\n\n### Usage in tests\n\nIf you are running celestia-app in tests, you may want to override the `delayed_precommit_timeout` to produce blocks faster. By default, a celestia-app chain with app version \u003e= 3 will produce blocks every ~6 seconds. To produce blocks faster, you can override the `delayed_precommit_timeout` with the `--delayed-precommit-timeout` flag.\n\n```shell\n# Start celestia-appd with a one-second block time.\ncelestia-appd start --delayed-precommit-timeout 1s\n```\n\n## Server Architecture\n\ncelestia-app and celestia-core start multiple servers to handle different types of network communication and requests. Here's an overview of each server and their default addresses:\n\n### Celestia-Core (CometBFT) Servers\n\n| Server   | Default Address         | Configuration               | Purpose                                                                                               |\n|----------|-------------------------|-----------------------------|-------------------------------------------------------------------------------------------------------|\n| **RPC**  | `tcp://127.0.0.1:26657` | `config.toml` under `[rpc]` | HTTP/WebSocket API for blockchain queries, transaction submission, and real-time event subscriptions. |\n| **gRPC** | `tcp://127.0.0.1:9098`  | `config.toml` under `[rpc]` | gRPC API for broadcasting txs, querying blocks, and querying blobstream data                          |\n| **P2P**  | `tcp://0.0.0.0:26656`   | `config.toml` under `[p2p]` | Peer-to-peer networking layer for consensus, block synchronization, and mempool gossip.               |\n\n### Celestia-App (Cosmos SDK) Servers\n\n| Server       | Default Address                | Configuration                 | Purpose                                                                                                                                      |\n|--------------|--------------------------------|-------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| **gRPC**     | `localhost:9090`               | `app.toml` under `[grpc]`     | gRPC for application-specific queries. Provides access to Cosmos SDK modules (bank, governance, etc.) and Celestia-specific modules (blob).  |\n| **REST API** | `tcp://localhost:1317`         | `app.toml` under `[api]`      | RESTful HTTP API that proxies requests to the gRPC server via gRPC-gateway. Provides the same functionality as gRPC but over HTTP with JSON. |\n| **gRPC-Web** | *Uses REST API server address* | `app.toml` under `[grpc-web]` | Browser-compatible gRPC API that allows web applications to interact with the gRPC server.                                                   |\n\n## Contributing\n\nIf you are a new contributor, please read [contributing to Celestia](https://github.com/celestiaorg/.github/blob/main/CONTRIBUTING.md).\n\nThis repo attempts to conform to [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/) 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.\n\nThis repo contains multiple go modules. When using it, rename `go.work.example` to `go.work` and run `go work sync`.\n\n### Tools\n\n1. Install [markdownlint](https://github.com/DavidAnson/markdownlint) 0.39.0\n1. Install [hadolint](https://github.com/hadolint/hadolint)\n1. Install [yamllint](https://yamllint.readthedocs.io/en/stable/quickstart.html)\n1. Install [markdown-link-check](https://github.com/tcort/markdown-link-check)\n1. Install [goreleaser](https://goreleaser.com/install/)\n\n### Helpful Commands\n\n```sh\n# Get more info on make commands.\nmake help\n\n# Build the celestia-appd binary into the ./build directory.\nmake build\n\n# Build and install the celestia-appd binary into the $GOPATH/bin directory.\nmake install\n\n# Build celestia-appd with the fibre module enabled.\nmake build-fibre\n\n# Install celestia-appd with the fibre module enabled.\nmake install-fibre\n\n# Run tests.\nmake test\n\n# Run fibre-tagged tests.\nmake test-fibre-module\n\n# Format code with linters (this assumes golangci-lint and markdownlint are installed).\nmake lint-fix\n\n# Regenerate Protobuf files (this assumes Docker is running).\nmake proto-gen\n```\n\n### Docs\n\nPackage-specific READMEs aim to explain implementation details for developers that are contributing to these packages. The [specs](https://celestiaorg.github.io/celestia-app/) aim to explain the protocol as a whole for developers building on top of Celestia.\n\n### Dependency branches\n\nThe source of truth for dependencies is the `go.mod` file but the table below describes the compatible branches for celestiaorg repos.\n\n| celestia-app | celestia-core      | cosmos-sdk                 |\n|--------------|--------------------|----------------------------|\n| `main`       | `main`             | `release/v0.52.x-celestia` |\n| `v8.x`       | `v0.39.x-celestia` | `release/v0.52.x-celestia` |\n| `v7.x`       | `v0.39.x-celestia` | `release/v0.52.x-celestia` |\n| `v6.x`       | `v0.39.x-celestia` | `release/v0.51.x-celestia` |\n| `v5.x`       | `v0.38.x-celestia` | `release/v0.50.x-celestia` |\n| `v4.x`       | `v0.38.x-celestia` | `release/v0.50.x-celestia` |\n| `v3.x`       | `v0.34.x-celestia` | `release/v0.46.x-celestia` |\n\n## Audits\n\n| Date       | Auditor                                       | Version                                                                                                  | Report                                                                                |\n|------------|-----------------------------------------------|----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------|\n| 2023/9/15  | [Informal Systems](https://informal.systems/) | [v1.0.0-rc6](https://github.com/celestiaorg/celestia-app/releases/tag/v1.0.0-rc6)                        | [informal-systems.pdf](docs/audit/informal-systems.pdf)                               |\n| 2023/10/17 | [Binary Builders](https://binary.builders/)   | [v1.0.0-rc10](https://github.com/celestiaorg/celestia-app/releases/tag/v1.0.0-rc10)                      | [binary-builders.pdf](docs/audit/binary-builders.pdf)                                 |\n| 2024/7/1   | [Informal Systems](https://informal.systems/) | [v2.0.0-rc1](https://github.com/celestiaorg/celestia-app/releases/tag/v2.0.0-rc1)                        | [informal-systems-v2.pdf](docs/audit/informal-systems-v2.pdf)                         |\n| 2024/9/20  | [Informal Systems](https://informal.systems/) | [306c587](https://github.com/celestiaorg/celestia-app/commit/306c58745d135d31c3777a1af2f58d50adbd32c8)   | [informal-systems-authored-blobs.pdf](docs/audit/informal-systems-authored-blobs.pdf) |\n| 2025/6/24  | [Informal Systems](https://informal.systems/) | [139bad2](https://github.com/celestiaorg/celestia-core/commit/139bad235a379599670f30d5e28c637dde4bb17a)  | [informal-systems-recovery.pdf](docs/audit/informal-systems-recovery.pdf)             |\n| 2026/2/6   | [Sherlock](https://www.sherlock.xyz/)         | [d3e13fa](https://github.com/celestiaorg/celestia-app/commit/d3e13fa1844405c2e3b358fe9c5a9a25745b3b19)   | [sherlock-zk-ism.pdf](docs/audit/sherlock-zk-ism.pdf)                                 |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcelestiaorg%2Fcelestia-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcelestiaorg%2Fcelestia-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcelestiaorg%2Fcelestia-app/lists"}