From 47d5a5f22a89bdc17a557b548ff74f1f894b0d29 Mon Sep 17 00:00:00 2001 From: Callum Waters Date: Thu, 24 Oct 2024 11:59:05 +0200 Subject: [PATCH] docs: add notes about upgrading for validators in the release notes --- docs/release-notes/release-notes.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/docs/release-notes/release-notes.md b/docs/release-notes/release-notes.md index 1ca2be4f41..2736e35b2d 100644 --- a/docs/release-notes/release-notes.md +++ b/docs/release-notes/release-notes.md @@ -13,6 +13,31 @@ This guide provides notes for major version releases. These notes may be helpful sed -i 's/ttl-num-blocks = 5/ttl-num-blocks = 12/' ~/.celestia-app/config/config.toml ``` +- Upgrades now use the `x/signal` module to coordinate the network to an upgrade height. + +The following command can be used, if you are a validator in the active set, to signal to upgrade to v3 + +```bash +celestia-appd tx signal signal 3 +``` + +You can track the tally of signalling by validators using the following query + +```bash +celestia-appd query signal tally 3 +``` + +Once 5/6+ of the voting power have signalled, the upgrade will be ready. There is a hard coded delay between confirmation of the upgrade and execution to the new state machine. + +To view the upcoming upgrade height use the following query: + +```bash +celestia-appd query signal upgrade +> An upgrade is pending to app version 3 at height 2348907. +``` + +For more information refer to the module [docs](../../x/signal/README.md) + ### Library Consumers (v3.0.0) - Namespace and share constants in the `appconsts` package were moved to [celestiaorg/go-square](https://github.com/celestiaorg/go-square). See [#3765](https://github.com/celestiaorg/celestia-app/pull/3765).