Skip to content

Commit

Permalink
updates
Browse files Browse the repository at this point in the history
  • Loading branch information
julienrbrt authored Dec 20, 2024
1 parent cde85b5 commit 64cc446
Showing 1 changed file with 31 additions and 9 deletions.
40 changes: 31 additions & 9 deletions UPGRADING_v2.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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)
Expand All @@ -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.
Expand Down

0 comments on commit 64cc446

Please sign in to comment.