diff --git a/UPGRADING_v2.md b/UPGRADING_v2.md index a3647e3f5fc0..e10c5b879437 100644 --- a/UPGRADING_v2.md +++ b/UPGRADING_v2.md @@ -1,11 +1,12 @@ -# Upgrading Cosmos SDK v2.x.y +# Upgrading Cosmos SDK v2 [DRAFT] This guide provides instructions for upgrading to specific versions of Cosmos SDK. Note, always read the **SimApp** section for more information on application wiring updates. -## Upgrading from v0.52.x to v2.0.0 +## Upgrading from v0.52.x to v2. -First and foremost, v2 uses [depinject](./depinject/README.md) to wire the module and application dependencies. This guides assumes you have already made your modules depinject compatible, and that you made use of depinject in your application. +First and foremost, v2 uses [depinject](./depinject/README.md) to wire the module and application dependencies. +This guide assumes that you have already made your modules depinject compatible, and that you made use of depinject in your application. ### Modules @@ -16,9 +17,7 @@ First and foremost, v2 uses [depinject](./depinject/README.md) to wire the modul ### Server -TODOs: - -* Telemetry server is another port (1328) +* Telemetry server is another port (7180) * New REST server for querying modules (8080) -> Use post and type_url (docs at server/v2/api/rest/README.md) * gRPC: new service to query the modules gRPC messages, without going via module services * gRPC: external gRPC services no more registered in the application router (e.g. nodeservice, cmtservice, authtx service) @@ -29,11 +28,34 @@ With the migration to server/v2 and runtime/v2 some changes are required in the #### `app.go` -#### `root.go` +```diff -## Upgrading from v0.50.x to v2.0.0 +``` + +#### `root.go` -Upgrading directly from v0.50.x to v2.0.0 is supported. +Thanks to the more modular design of v2, the application developer is free to pick which server to use in their application: + +```go +// wire server commands +return serverv2.AddCommands[T]( + rootCmd, + logger, + simApp, + deps.GlobalConfig, + initServerConfig(), + deps.ConsensusServer, + grpcServer, + storeComponent, + telemetryServer, + restServer, + grpcgatewayServer, +) +``` + +## Upgrading from v0.50.x to v2 + +Upgrading directly from v0.50.x to v2 is supported. Modules should be updated to support all the latest changes in the SDK. Read the module section from the v0.52 [UPGRADING.md](UPGRADING.md) file for more information.