Skip to content

Commit baa6ad5

Browse files
committed
Add MIGRATING section for 1.2
Closes #1522
1 parent bd374ea commit baa6ad5

File tree

1 file changed

+41
-0
lines changed

1 file changed

+41
-0
lines changed

MIGRATING.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,47 @@ This guide explains what is needed to upgrade contracts when migrating over
44
major releases of `cosmwasm`. Note that you can also view the
55
[complete CHANGELOG](./CHANGELOG.md) to understand the differences.
66

7+
## 1.1.x -> 1.2.0
8+
9+
- Update `cosmwasm-*` dependencies in Cargo.toml (skip the ones you don't use):
10+
11+
```
12+
[dependencies]
13+
cosmwasm-std = "1.2.0"
14+
cosmwasm-storage = "1.2.0"
15+
# ...
16+
17+
[dev-dependencies]
18+
cosmwasm-schema = "1.2.0"
19+
cosmwasm-vm = "1.2.0"
20+
# ...
21+
```
22+
23+
- If you want to use a fewture that os only available on CosmWasm 1.2+ chains,
24+
use this feature:
25+
26+
```diff
27+
-cosmwasm-std = { version = "1.1.0", features = ["stargate"] }
28+
+cosmwasm-std = { version = "1.1.0", features = ["stargate", "cosmwasm_1_2"] }
29+
```
30+
31+
Please note that `cosmwasm_1_2` implies `cosmwasm_1_1`, so there is no need to
32+
set both.
33+
34+
- If you use mixed type multiplication between `Uint{64,128,256}` and
35+
`Decimal{,256}`, check out
36+
`mul_floor`/`checked_mul_floor`/`mul_ceil`/`checked_mul_ceil`. Mixed type
37+
arithmetic [will be removed](https://github.com/CosmWasm/cosmwasm/issues/1485)
38+
at some point.
39+
40+
```diff
41+
let a = Uint128::new(123);
42+
let b = Decimal::percent(150)
43+
44+
-let c = a * b;
45+
+let c = a.mul_floor(b);
46+
```
47+
748
## 1.0.0 -> 1.1.0
849

950
- Update `cosmwasm-*` dependencies in Cargo.toml (skip the ones you don't use):

0 commit comments

Comments
 (0)