Skip to content

V54 updates#255

Merged
evanorti merged 9 commits intoconceptsfrom
v54-updates
Mar 18, 2026
Merged

V54 updates#255
evanorti merged 9 commits intoconceptsfrom
v54-updates

Conversation

@evanorti
Copy link
Contributor

This PR updates the /next documentation to reflect all breaking changes, new features, and improvements in the upcoming Cosmos SDK v0.54 release, based on the unreleased CHANGELOG.

Changelog Change Files Updated What Was Done
(crypto) #24414 Remove sr25519 support cometbft/next/spec/core/genesis.mdx, cometbft/next/spec/abci/Requirements-for-the-Application.mdx, sdk/next/learn/beginner/accounts.mdx Replaced sr25519 with bls12381 in key type references
#25471 / #24872 Full BLS12-381 support Same as above BLS12-381 added as supported validator key type
#25090 Deprecated modules moved to contrib modules/nft/README.mdx, modules/circuit/README.mdx, modules/crisis/README.mdx, building-modules/invariants.mdx, migrations/upgrade-guide.mdx Added contrib warning banners; upgrade guide breaking change section
#25090 x/group moved to Cosmos Enterprise modules/group/README.mdx, migrations/upgrade-guide.mdx Added Enterprise license warning; upgrade guide breaking change section
#25615 / #25616 / #25617 x/gov decoupled from x/staking modules/gov/README.mdx, migrations/upgrade-guide.mdx BondedTokensValidatorPower, CalculateVoteResultsAndVotingPowerFn required, DistrKeeper optional, AfterProposalSubmission hook updated
#25599 x/mint MaxSupply param modules/mint/README.mdx Added MaxSupply parameter; updated CLI/gRPC example outputs
#25724 x/staking bond denom validation modules/staking/README.mdx Added note: zero-supply bond denom rejected in MsgUpdateParams
#25778 Log v2 contextual logger migrations/upgrade-guide.mdx Added upgrade section referencing log.mdx
#26061 Store tracing API removed learn/advanced/store.mdx, build/spec/store/store.mdx, building-apps/app-go.mdx, building-apps/runtime.mdx, building-apps/app-testnet.mdx, build/abci/checktx.mdx Removed SetTracer, SetTracingContext, TracingEnabled, CacheWrapWithTrace, SetMetrics, StoreMetrics, and all traceStore io.Writer params
#25948 depinject phased out building-modules/depinject.mdx, building-apps/app-go-di.mdx Added deprecation warnings
#25342 EmitEvent/EmitEvents undeprecated learn/advanced/events.mdx, building-modules/msg-services.mdx Removed deprecated markers
#25565 Historical gRPC query routing learn/advanced/grpc_rest.mdx Added historical-grpc-address-block-range config documentation
#24720 --verbose_log_level flag user/run-node/run-node.mdx Added verbose log level flag documentation
#25650 x/distribution new query endpoints modules/distribution/README.mdx Added CLI commands and gRPC endpoints for ValidatorHistoricalRewards, ValidatorCurrentRewards, DelegatorStartingInfo
#25607 x/consensus AuthorityParams modules/consensus/README.mdx Full page rewrite: all consensus param groups, MsgUpdateParams, AuthorityParams feature, CLI/gRPC/REST
#25850 GetBlockResults gRPC endpoints learn/advanced/grpc_rest.mdx Added note on GetBlockResults / GetLatestBlockResults
#25877 OverrideEvents on EventManagerI learn/advanced/events.mdx Added one-sentence description of OverrideEvents method

Remove tracing and metrics plumbing from the store and app build paths: drop traceStore parameters and SetCommitMultiStoreTracer calls (NewSimApp, newTestnetApp, AppBuilder.Build, runtime Build, etc.), remove store tracing APIs (SetTracer, TracingEnabled, TraceContext, related fields) and remove metrics arguments from store/IAVL loaders and constructors (NewStore, LoadStore, LoadStoreWithInitialVersion, LoadStoreWithOpts).

Update documentation to reflect several module and API changes: mark x/crisis moved to contrib, x/nft moved to contrib, x/group moved to Enterprise, expand x/consensus README, add distribution CLI/grpc query examples, add mint MaxSupply notes, add gov hooks and voting-power API changes, and tidy events/store docs to remove deprecated tracing references. These changes simplify the codebase by removing legacy tracing/metrics integrations and update docs for module relocations and API evolutions.
@evanorti evanorti requested a review from ericHgorski March 17, 2026 19:52
@greptile-apps
Copy link

greptile-apps bot commented Mar 17, 2026

Greptile Summary

This PR updates the /next (v0.54) documentation across 26 files to reflect breaking changes, new features, and deprecations from the upcoming Cosmos SDK v0.54 release. The changes are well-structured and cover a wide range of changelog items including BLS12-381 key support, module moves to contrib, x/gov decoupling from x/staking, store tracing removal, and new module features.

Key changes:

  • sr25519 replaced with bls12381 in all key type references (cometbft/next/spec/, sdk/next/learn/beginner/accounts.mdx)
  • Store tracing API removed (traceStore io.Writer, SetCommitMultiStoreTracer, TracingEnabled, SetTracer, SetTracingContext, CacheWrapWithTrace, SetMetrics) consistently across store.mdx, runtime.mdx, app-go.mdx, app-testnet.mdx, checktx.mdx, and build/spec/store/store.mdx
  • x/circuit, x/crisis, and x/nft marked as moved to ./contrib/ with warning banners; x/group moved to Cosmos Enterprise with a license warning
  • x/gov decoupled from x/staking: BondedTokensValidatorPower, TotalBondedTokensTotalValidatorPower, CalculateVoteResultsAndVotingPowerFn is now required, DistrKeeper is optional; GovHooks section added with updated AfterProposalSubmission signature
  • x/consensus README fully rewritten with parameter groups, MsgUpdateParams example, AuthorityParams centralized authority feature, and CLI/gRPC/REST docs
  • x/mint MaxSupply parameter documented in params table and example outputs
  • EmitEvent/EmitEvents un-deprecated; OverrideEvents method documented on EventManagerI
  • Historical gRPC query routing config and GetBlockResults/GetLatestBlockResults endpoints documented in grpc_rest.mdx
  • --verbose_log_level flag documented in run-node.mdx

Notable issues:

  • Several files listed in the PR description table as updated are absent from the diff: sdk/next/migrations/upgrade-guide.mdx (referenced for 4 changelog items: deprecated modules, x/group, x/gov decoupling, and log v2), sdk/next/build/building-modules/depinject.mdx, and sdk/next/build/building-apps/app-go-di.mdx. The PR description claims these were updated but they do not appear among the changed files.
  • run-node.mdx adds a link to /sdk/next/learn/advanced/log that does not appear to exist yet in the repository.
  • The validator-historical-rewards CLI command docs leave the [period] argument unexplained.

Confidence Score: 4/5

  • Safe to merge with minor fixes; content is generally accurate but a few files listed in the PR description are missing from the diff and one link may be broken.
  • The core documentation changes are accurate, consistent, and well-applied across all 26 changed files. The main concerns are: (1) several files claimed in the PR description table (migrations/upgrade-guide.mdx, depinject.mdx, app-go-di.mdx) are not included in the actual diff — this may mean those updates were intentionally deferred, but the PR description creates an expectation they are present; (2) a link to a non-existent page (/sdk/next/learn/advanced/log) was added. These are documentation completeness issues rather than correctness problems with the changes that were made.
  • sdk/next/user/run-node/run-node.mdx (broken link), sdk/next/build/modules/group/README.mdx (missing open-source guidance), and the absence of sdk/next/migrations/upgrade-guide.mdx from the diff despite being listed in the PR description.

Important Files Changed

Filename Overview
sdk/next/build/building-apps/runtime.mdx Removes traceStore io.Writer from AppBuilder.Build signatures and the SetCommitMultiStoreTracer call in three code block variants. Correct and consistent.
sdk/next/build/modules/consensus/README.mdx Full page rewrite adding consensus parameter groups, MsgUpdateParams code example, AuthorityParams feature, and CLI/gRPC/REST docs. Has a minor trailing whitespace issue in the AuthorityParams section.
sdk/next/build/modules/distribution/README.mdx Adds CLI documentation for three new query commands. The validator-historical-rewards command exposes a [period] positional argument without explanation of what it represents.
sdk/next/build/modules/gov/README.mdx Major update: decouples x/gov from x/staking, renames BondedTokens→ValidatorPower throughout, adds GovHooks section, updates NewKeeper constructor docs. Changes are accurate but some details in the Hooks section may benefit from further links.
sdk/next/build/modules/group/README.mdx Adds Enterprise license warning for x/group. The warning does not mention alternative paths for open-source users who relied on this module.
sdk/next/learn/advanced/store.mdx Removes tracing-related interface methods (TracingEnabled, SetTracer, SetTracingContext, CacheWrapWithTrace, SetMetrics) across multiple code blocks. Consistently applied across all repeated code block variants.
sdk/next/learn/beginner/accounts.mdx Replaces Sr25519Type/"sr25519" constant with Bls12381Type/"bls12381" in the key type enum. Accurate and consistent with the rest of the PR.
sdk/next/user/run-node/run-node.mdx Documents the new --verbose_log_level flag and links to a log overview page. The linked /sdk/next/learn/advanced/log page does not appear to exist in this repository, which may produce a broken link.

Comments Outside Diff (2)

  1. sdk/next/build/modules/distribution/README.mdx, line 466-480 (link)

    P2 [period] argument is undocumented

    The validator-historical-rewards command signature exposes a [period] positional argument, but the documentation doesn't explain what it represents. Readers won't know whether 5 in the example refers to a block height, a reward period index, or something else.

    Consider adding a brief description such as: "[period] is the historical reward period index — a monotonically-increasing integer incremented each time a validator's slash factor changes."

  2. sdk/next/build/modules/consensus/README.mdx, line 328 (link)

    P2 Trailing whitespace

    There is a trailing space at the end of this sentence: "It is used as a fallback when no authority is configured in consensus params. "

Last reviewed commit: 4095c49

```

See the [Log Overview](/sdk/next/learn/advanced/log) for more information on logging.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Potentially broken link to non-existent page

The link /sdk/next/learn/advanced/log does not appear to exist in this repository. None of the 26 changed files include a log.mdx, and a search of the repo does not surface it. The PR description notes that changelog item #25778 was supposed to add an upgrade guide entry referencing log.mdx, but migrations/upgrade-guide.mdx was not included in this PR's diff. If the log overview page hasn't been created yet, this link will be a 404 for users.

Consider either:

  • Replacing the link with a reference to the existing logging section in run-node.mdx itself until the dedicated page is created, or
  • Removing the "See…" sentence until log.mdx lands.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Comment on lines +7 to +10
<Warning>
The `x/group` module is now maintained under the Cosmos Enterprise offering. If your application uses `x/group`, you will need to migrate your code to the Enterprise-distributed package and obtain a Cosmos Enterprise license to continue using it. Please see [Cosmos Enterprise](/enterprise/overview) to learn more.
</Warning>

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 No guidance for open-source users

The warning tells users that x/group now requires a Cosmos Enterprise license, but doesn't mention what open-source users who can't obtain that license should do. Many projects relied on x/group for multisig governance. Consider adding a sentence such as: "If you are unable to obtain a Cosmos Enterprise license, the module source is still available in the SDK repo history and you may fork and self-maintain it."

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Copy link
Contributor

@ericHgorski ericHgorski left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@evanorti evanorti merged commit 8c053a8 into concepts Mar 18, 2026
2 checks passed
@evanorti evanorti deleted the v54-updates branch March 18, 2026 14:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants