celestiaorg/celestia-app v10.1.0-mocha on GitHub

Upgrade Notice

This release is for Mocha (mocha-5). It mainly introduces Fibre as a breaking release.

Consensus node operators and validators must upgrade before the v10 activation height. Read the v10 upgrade notes before upgrading.

Upgrade from v9

Download the celestia-app archive for your platform from this release and verify it against checksums.txt. Use the multiplexer build, not celestia-app-standalone, while Mocha is on v9. Source builds require Go 1.26.6; use make install from this release tag.
Stop your node, replace celestia-appd, and restart with the same node home and database. Check that celestia-appd version reports v10.1.0-mocha and the node resumes syncing and, for validators, signing.
Leave the node running. The multiplexer switches to v10 and runs migrations automatically at activation. Do not use Cosmovisor for this upgrade.

Follow the Mocha upgrade announcement for timing. Check signalling progress and the pending activation height on your Mocha node:

celestia-appd query signal tally 10
celestia-appd query signal upgrade

Validators should signal only after completing their preparation:

celestia-appd tx signal signal 10 --from <validator-account-key> --chain-id mocha-5

Add your usual fee, node, and home flags.

Still on mocha-4? Use a fresh node home with the Mocha 5 genesis and peers. The old chain database cannot be reused.

Validators: prepare Fibre

Fibre is a separate data availability service. Validators are recommended to run it alongside celestia-appd. Follow the Fibre server guide for setup and memory requirements.

Before activation:

Install the fibre binary from this release. Use separate disks for Fibre and celestia-app data.
Enable application gRPC (default 127.0.0.1:9090). Set priv_validator_grpc_laddr = "127.0.0.1:26669" in config.toml and point Fibre at your validator's node. Check existing configs for an empty value or the old port 26659. Keep both connections local or on a trusted private network; they are not TLS-protected for now.
Make Fibre's client port (default 7980) publicly reachable. Client TLS is automatic.

After v10 activates, start Fibre, confirm it is reachable, then register its public address with your validator account:

celestia-appd tx valaddr set-host <public-host>:7980 --from <validator-account-key> --chain-id mocha-5
celestia-appd query valaddr providers

Add your usual transaction flags. Your validator must be bonded. Registration is unavailable before activation; confirm your host appears in the query results afterward.

Non validator nodes can disable the privval gRPC endpoint with priv_validator_grpc_laddr = "".

RPC and storage

Heavy RPC requests share a limit of 20 concurrent requests, configurable through [rpc] max_concurrent_heavy_requests in config.toml. Clients should retry busy responses with backoff: HTTP GET 503, JSON-RPC errors, or gRPC ResourceExhausted.
Blockstore compaction is optional and disabled by default. Set [storage] compact = true to reclaim space after pruning; compaction_interval defaults to 10000 blocks. Archival nodes must keep min-retain-blocks = 0 in app.toml.
The multiplexer now exits if an embedded app fails. Check that your service manager restarts the node and alerts on repeated failures.

Supported operating systems

Tested in CI: Ubuntu 24.04 LTS on x86_64.
Prebuilt binaries: Linux and macOS, amd64 and arm64. arm64 binaries are cross-compiled and are not run in CI.
Linux multiplexer: requires glibc 2.38 or newer. Ubuntu 22.04 and older are unsupported.
Changes since the previous Mocha release: none.

See the release README.

What's Changed

Reduces the evidence window to 404,400 blocks, applied automatically at activation.
Changes Hyperlane forwarding address derivation to include the custom IGP hook. Integrators must update address derivation before sending funds. Adds SP1 v6 Groth16 proof support.

Full Changelog: v9.0.8-mocha...v10.1.0-mocha