Skip to content

Commit 551d8d5

Browse files
authored
Add v154 wasmvm library compatibility documentation (#3199)
1 parent 8cbbadf commit 551d8d5

5 files changed

Lines changed: 38 additions & 0 deletions

File tree

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Cosmovisor and `libwasmvm154` During the v6.4 Upgrade Window
2+
3+
## Summary
4+
5+
During the transition from **v6.3.x** to **v6.4.0**, nodes running under `cosmovisor` may still execute the **v6.3.x** binary until the upgrade height is reached. That binary depends on the legacy shared library:
6+
7+
- `libwasmvm154.x86_64.so`
8+
9+
To keep the currently active binary working while **v6.4.0** is staged, the required wasm shared libraries must remain available in the runtime library path during the upgrade window.
10+
11+
For **v6.4**, the fix is to **place the required shared libraries in the expected runtime location** so the active pre-upgrade binary can continue to start normally.
12+
13+
For **v6.5**, the legacy `v154` dependency is no longer needed and can be removed.
14+
15+
---
16+
17+
## Why this happens
18+
19+
`cosmovisor` is expected to keep the **old binary active** until the chain reaches the configured upgrade height.
20+
21+
That means the following is normal before the upgrade executes:
22+
23+
- `current` still points to the **v6.3.x** binary
24+
- the **v6.4.0** binary may already be staged on disk
25+
- both versions may need to coexist temporarily
26+
27+
The issue is that the active **v6.3.x** binary still links against:
28+
29+
- `libwasmvm.x86_64.so`
30+
- `libwasmvm152.x86_64.so`
31+
- `libwasmvm154.x86_64.so`
32+
- `libwasmvm155.x86_64.so`
33+
34+
If `libwasmvm154.x86_64.so` is no longer available when the node is still running the **v6.3.x** binary, startup fails with an error like:
35+
36+
```text
37+
error while loading shared libraries: libwasmvm154.x86_64.so: cannot open shared object file: No such file or directory
38+
```
11.1 MB
Binary file not shown.
5.32 MB
Binary file not shown.
10.9 MB
Binary file not shown.
42.4 MB
Binary file not shown.

0 commit comments

Comments
 (0)