Track a Cosmos software upgrade by plan name and height
A release announcement and an on-chain upgrade plan describe different things. The upgrade module lets an operator check the scheduled height and later confirm an applied plan.
Read the scheduled plan
Query a TLS gRPC endpoint with reflection. Inspect the current plan name and height, then replace example-v2 in the second call with the exact case-sensitive plan name you intend to verify.
grpcurl -d '{}' "$GRPC" cosmos.upgrade.v1beta1.Query/CurrentPlan
grpcurl -d '{"name":"example-v2"}' "$GRPC" cosmos.upgrade.v1beta1.Query/AppliedPlan
If the plan height is 8,000,000 and the node is at 7,999,950, there are fifty heights left. Estimate a maintenance window from observed block times and refresh it as the chain approaches the target.
Verify application and recovery
After the chain advances, query AppliedPlan for that name and check the reported applied height. A missing current plan alone does not establish success: a plan can also be canceled. Confirm your own node advances past the upgrade height. github.com Cosmos SDK Query API