chore: update documentation from cosmos-sdk/docs (#287)

chore: Sync docs from cosmos-sdk/docs

Co-authored-by: tac0turtle <[email protected]>

Author: github-actions[bot]

docs/build/abci/01-prepare-proposal.md

@@ -29,7 +29,7 @@ selected DO NOT exceed the maximum block gas (if set) and the maximum bytes prov
 by `req.MaxBytes`.
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.53.0-rc.2/baseapp/abci_utils.go
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/baseapp/abci_utils.go
 ```
 
 This default implementation can be overridden by the application developer in
@@ -42,4 +42,4 @@ prepareOpt := func(app *baseapp.BaseApp) {
 }
 
 baseAppOptions = append(baseAppOptions, prepareOpt)
-```
+```

docs/build/abci/02-process-proposal.md

@@ -14,7 +14,7 @@ and `ProcessProposal` for the new proposal.
 Here is the implementation of the default implementation:
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.53.0-rc.2/baseapp/abci_utils.go#L219-L226
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/baseapp/abci_utils.go#L219-L226
 ```
 
 Like `PrepareProposal`, this implementation is the default and can be modified by

docs/build/abci/03-vote-extensions.md

@@ -8,7 +8,7 @@ defined in ABCI++.
 ## Extend Vote
 
 ABCI 2.0 (colloquially called ABCI++) allows an application to extend a pre-commit vote with arbitrary data. This process does NOT have to be deterministic, and the data returned can be unique to the
-validator process. The Cosmos SDK defines [`baseapp.ExtendVoteHandler`](https://github.com/cosmos/cosmos-sdk/blob/v0.53.0-rc.2/types/abci.go#L32):
+validator process. The Cosmos SDK defines [`baseapp.ExtendVoteHandler`](https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/types/abci.go#L32):
 
 ```go
 type ExtendVoteHandler func(Context, *abci.RequestExtendVote) (*abci.ResponseExtendVote, error)

docs/build/architecture/adr-057-app-wiring.md

@@ -306,13 +306,13 @@ change to a module should be handled as follows:
 - the semantic major version should be incremented, and
 - a new semantically versioned module config protobuf type should be created.
 
-For instance, if we have the SDK module for bank in the go module `cosmossdk.io/x/bank` with the module config type
+For instance, if we have the SDK module for bank in the go module `github.com/cosmos/cosmos-sdk/x/bank` with the module config type
 `cosmos.bank.module.v1.Module`, and we want to make a state machine breaking change to the module, we would:
-- create a new go module `cosmossdk.io/x/bank/v2`,
+- create a new go module `github.com/cosmos/cosmos-sdk/x/bank/v2`,
 - with the module config protobuf type `cosmos.bank.module.v2.Module`.
 
 This _does not_ mean that we need to increment the protobuf API version for bank. Both modules can support
-`cosmos.bank.v1`, but `cosmossdk.io/x/bank/v2` will be a separate go module with a separate module config type.
+`cosmos.bank.v1`, but `github.com/cosmos/cosmos-sdk/x/bank/v2` will be a separate go module with a separate module config type.
 
 This practice will eventually allow us to use appconfig to load new versions of a module via a configuration change.
 

docs/build/architecture/adr-070-unordered-account.md

@@ -5,6 +5,7 @@
 - Dec 4, 2023: Initial Draft (@yihuang, @tac0turtle, @alexanderbez)
 - Jan 30, 2024: Include section on deterministic transaction encoding
 - Mar 18, 2025: Revise implementation to use Cosmos SDK KV Store and require unique timeouts per-address (@technicallyty)
+- Apr 25, 2025: Add note about rejecting unordered txs with sequence values.
 
 ## Status
 
@@ -289,6 +290,8 @@ for _, tx := range txs {
 }
 ```
 
+We will reject transactions that have both sequence and unordered timeouts set. We do this to avoid assuming the intent of the user.
+
 ### State Management
 
 The storage of unordered sequences will be facilitated using the Cosmos SDK's KV Store service.

docs/build/building-apps/00-runtime.md

@@ -31,7 +31,7 @@ type App struct {
 Cosmos SDK applications should embed the `*runtime.App` struct to leverage the runtime module.
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.53.0-rc.2/simapp/app_di.go#L60-L61
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/simapp/app_di.go#L60-L61
 ```
 
 ### Configuration
@@ -58,7 +58,7 @@ However it provides a flexible store key configuration through:
 Example configuration:
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.53.0-rc.2/simapp/app_config.go#L133-L138
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/simapp/app_config.go#L133-L138
 ```
 
 ## Key Features
@@ -76,7 +76,7 @@ Runtime has built-in support for [`depinject`-enabled modules](../building-modul
 Such modules can be registered through the configuration file (often named `app_config.go`), with no additional code required.
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.53.0-rc.2/simapp/app_config.go#L210-L216
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/simapp/app_config.go#L210-L216
 ```
 
 Additionally, the runtime package facilitates manual module registration through the `RegisterModules` method. This is the primary integration point for modules not registered via configuration.
@@ -98,7 +98,7 @@ These services include `store`, `event manager`, `context`, and `logger`.
 Runtime ensures that services are scoped to their respective modules during the wiring process.
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.53.0-rc.2/runtime/module.go#L201-L235
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/runtime/module.go#L201-L235
 ```
 
 Additionally, runtime provides automatic registration of other essential (i.e., gRPC routes) services available to the App:
@@ -108,15 +108,15 @@ Additionally, runtime provides automatic registration of other essential (i.e.,
 * Custom module services
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.53.0-rc.2/runtime/builder.go#L52-L54
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/runtime/builder.go#L52-L54
 ```
 
 ### 4. Application Building
 
 The `AppBuilder` type provides a structured way to build applications:
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.53.0-rc.2/runtime/builder.go#L14-L19
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/runtime/builder.go#L14-L19
 ```
 
 Key building steps:
@@ -130,7 +130,7 @@ Key building steps:
 An application only needs to call `AppBuilder.Build` to create a fully configured application (`runtime.App`).
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.53.0-rc.2/runtime/builder.go#L26-L57
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/runtime/builder.go#L26-L57
 ```
 
 More information on building applications can be found in the [next section](./02-app-building.md).

docs/build/building-modules/01-module-manager.md

@@ -61,7 +61,7 @@ Use `module.CoreAppModuleBasicAdaptor` instead for creating an `AppModuleBasic`
 The `AppModuleBasic` interface defines the independent methods modules need to implement.
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/types/module/module.go#L56-L66
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/types/module/module.go#L56-L61
 ```
 
 * `RegisterLegacyAminoCodec(*codec.LegacyAmino)`: Registers the `amino` codec for the module, which is used to marshal and unmarshal structs to/from `[]byte` in order to persist them in the module's `KVStore`.
@@ -73,7 +73,7 @@ All the `AppModuleBasic` of an application are managed by the [`BasicManager`](#
 ### `HasName`
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/types/module/module.go#L71-L73
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/types/module/module.go#L66-L68
 ```
 
 * `HasName` is an interface that has a method `Name()`. This method returns the name of the module as a `string`.
@@ -87,7 +87,7 @@ For easily creating an `AppModule` that only has genesis functionalities, use `m
 #### `module.HasGenesisBasics`
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/types/module/module.go#L76-L79
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/types/module/module.go#L71-L74
 ```
 
 Let us go through the methods:
@@ -139,15 +139,15 @@ Previously the `module.AppModule` interface was containing all the methods that
 :::
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/types/module/module.go#L195-L199
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/types/module/module.go#L199-L206
 ```
 
 ### `HasInvariants`
 
 This interface defines one method. It allows to checks if a module can register invariants.
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/types/module/module.go#L202-L205
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/types/module/module.go#L211-L214
 ```
 
 * `RegisterInvariants(sdk.InvariantRegistry)`: Registers the [`invariants`](./07-invariants.md) of the module. If an invariant deviates from its predicted value, the [`InvariantRegistry`](./07-invariants.md#registry) triggers appropriate logic (most often the chain will be halted).
@@ -165,7 +165,7 @@ https://github.com/cosmos/cosmos-sdk/blob/6afece6/core/appmodule/module.go#L22-L
 #### `module.HasServices`
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/types/module/module.go#L208-L211
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/types/module/module.go#L217-L220
 ```
 
 * `RegisterServices(Configurator)`: Allows a module to register services.
@@ -175,7 +175,7 @@ https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/types/module/module.go
 This interface defines one method for checking a module consensus version.
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/types/module/module.go#L214-L220
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/types/module/module.go#L223-L229
 ```
 
 * `ConsensusVersion() uint64`: Returns the consensus version of the module.
@@ -189,7 +189,7 @@ The `HasPreBlocker` is an extension interface from `appmodule.AppModule`. All mo
 The `HasBeginBlocker` is an extension interface from `appmodule.AppModule`. All modules that have an `BeginBlock` method implement this interface.
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/core/appmodule/module.go#L56-L63
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/core/appmodule/module.go#L73-L80
 ```
 
 * `BeginBlock(context.Context) error`: This method gives module developers the option to implement logic that is automatically triggered at the beginning of each block.
@@ -199,7 +199,7 @@ https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/core/appmodule/module.
 The `HasEndBlocker` is an extension interface from `appmodule.AppModule`. All modules that have an `EndBlock` method implement this interface. If a module need to return validator set updates (staking), they can use `HasABCIEndBlock`
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/core/appmodule/module.go#L66-L72
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/core/appmodule/module.go#L83-L89
 ```
 
 * `EndBlock(context.Context) error`: This method gives module developers the option to implement logic that is automatically triggered at the end of each block.
@@ -209,7 +209,7 @@ https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/core/appmodule/module.
 The `HasABCIEndBlock` is an extension interface from `module.AppModule`. All modules that have an `EndBlock` which return validator set updates implement this interface.
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/types/module/module.go#L222-L225
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/types/module/module.go#L236-L239
 ```
 
 * `EndBlock(context.Context) ([]abci.ValidatorUpdate, error)`: This method gives module developers the option to inform the underlying consensus engine of validator set changes (e.g. the `staking` module).
@@ -219,7 +219,7 @@ https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/types/module/module.go
 `HasPrecommit` is an extension interface from `appmodule.AppModule`. All modules that have a `Precommit` method implement this interface.
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/core/appmodule/module.go#L49-L52
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/core/appmodule/module.go#L50-L53
 ```
 
 * `Precommit(context.Context)`: This method gives module developers the option to implement logic that is automatically triggered during [`Commit'](../../learn/advanced/00-baseapp.md#commit) of each block using the [`finalizeblockstate`](../../learn/advanced/00-baseapp.md#state-updates) of the block to be committed. Implement empty if no logic needs to be triggered during `Commit` of each block for this module.
@@ -229,7 +229,7 @@ https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/core/appmodule/module.
 `HasPrepareCheckState` is an extension interface from `appmodule.AppModule`. All modules that have a `PrepareCheckState` method implement this interface.
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/core/appmodule/module.go#L49-L52
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/core/appmodule/module.go#L44-L47
 ```
 
 * `PrepareCheckState(context.Context)`: This method gives module developers the option to implement logic that is automatically triggered during [`Commit'](../../learn/advanced/00-baseapp.md#commit) of each block using the [`checkState`](../../learn/advanced/00-baseapp.md#state-updates) of the next block. Implement empty if no logic needs to be triggered during `Commit` of each block for this module.
@@ -265,7 +265,7 @@ Module managers are used to manage collections of `AppModuleBasic` and `AppModul
 The `BasicManager` is a structure that lists all the `AppModuleBasic` of an application:
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/types/module/module.go#L82
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/types/module/module.go#L77
 ```
 
 It implements the following methods:
@@ -285,7 +285,7 @@ It implements the following methods:
 The `Manager` is a structure that holds all the `AppModule` of an application, and defines the order of execution between several key components of these modules:
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/types/module/module.go#L267-L276
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/types/module/module.go#L278-L288
 ```
 
 The module manager is used throughout the application whenever an action on a collection of modules is required. It implements the following methods:
@@ -314,15 +314,15 @@ The module manager is used throughout the application whenever an action on a co
 Here's an example of a concrete integration within an `simapp`:
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/simapp/app.go#L411-L434
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/simapp/app.go#L510-L533
 ```
 
 This is the same example from `runtime` (the package that powers app di):
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/runtime/module.go#L61
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/runtime/module.go#L63
 ```
 
 ```go reference
-https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/runtime/module.go#L82
+https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/runtime/module.go#L85
 ```