{"id":37096483,"url":"https://github.com/rootulp/celestia-app","last_synced_at":"2026-01-14T11:52:36.141Z","repository":{"id":49583844,"uuid":"512845878","full_name":"rootulp/celestia-app","owner":"rootulp","description":"PoS chain powered by celestia-core (fork of tendermint) and the the cosmos-sdk","archived":false,"fork":true,"pushed_at":"2026-01-13T01:31:41.000Z","size":63761,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-13T03:17:36.813Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://celestia.org","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"celestiaorg/celestia-app","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rootulp.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}},"created_at":"2022-07-11T17:15:48.000Z","updated_at":"2026-01-13T01:07:56.000Z","dependencies_parsed_at":"2023-09-22T02:45:50.005Z","dependency_job_id":"b44e7dfb-6bdc-495d-b7da-ec518eebca69","html_url":"https://github.com/rootulp/celestia-app","commit_stats":null,"previous_names":[],"tags_count":151,"template":false,"template_full_name":null,"purl":"pkg:github/rootulp/celestia-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootulp%2Fcelestia-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootulp%2Fcelestia-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootulp%2Fcelestia-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootulp%2Fcelestia-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rootulp","download_url":"https://codeload.github.com/rootulp/celestia-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootulp%2Fcelestia-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28419272,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T10:47:48.104Z","status":"ssl_error","status_checked_at":"2026-01-14T10:46:19.031Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-01-14T11:52:35.233Z","updated_at":"2026-01-14T11:52:36.133Z","avatar_url":"https://github.com/rootulp.png","language":"Go","funding_links":[],"categories":[],"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.24.6\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## Usage\n\n\u003e [!WARNING]\n\u003e The celestia-appd binary doesn't support signing with Ledger hardware wallets on Windows and OpenBSD.\n\n### Prerequisites\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 [golangci-lint](https://golangci-lint.run/docs/welcome/install/) 2.1.2\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# Run tests.\nmake test\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.51.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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frootulp%2Fcelestia-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frootulp%2Fcelestia-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frootulp%2Fcelestia-app/lists"}