We have begun our migration over to IAVL v1 from v0. In the current version we are in (v23), node operators can choose to run either v0 or v1. In the next upgrade (v24), v1 will be the only IAVL version supported. There are two ways to move over:
- Download a pure v1 database here under the IAVL v1 section (scroll down): https://snapshots.osmosis.zone/index.html, then run v23.0.3-iavl-v1
- Switch over from the v23.x.x binary to the v23.0.3-iavl-v1 binary and the migration process will happen live.
Option 1 is much more preferred / more performant. Option 2 will take some hours to show signs of speedup, and will never be as fast as a node that does option 1. There is an option 3 which is to create the pure v1 database yourself, but it's very involved and takes many hours of work.
Please understand that when you switch over to the new iavl-v1 binary (with option 1 or option 2), you can only switch back to v0 by downloading an old v0 snapshot, then switching back to the v23.x.x binary that does not have "iavl-v1" in the binary name.
After making the switch (option 1, not option 2), and you will notice you will process epoch / blocks much quicker than nodes not on v1.
This release also contains state compatible version bumps and small sync/epoch speedups (the same as the v23.0.3 release, just includes IAVL v1).
Changelog
See the full changelog here
⚡️ Binaries
Binaries for Linux (amd64 and arm64) are available below.
🔨 Build from source
If you prefer to build from source, you can use the following commands:
git clone https://github.com/osmosis-labs/osmosis
cd osmosis && git checkout v23.0.3-iavl-v1
make install
🐳 Run with Docker
As an alternative to installing and running osmosisd on your system, you may run osmosisd in a Docker container.
The following Docker images are available in our registry:
Image Name | Base | Description |
---|---|---|
osmolabs/osmosis:23.0.3-iavl-v1
| distroless/static-debian11
| Default image based on Distroless |
osmolabs/osmosis:23.0.3-iavl-v1-distroless
| distroless/static-debian11
| Distroless image (same as above) |
osmolabs/osmosis:23.0.3-iavl-v1-nonroot
| distroless/static-debian11:nonroot
| Distroless non-root image |
osmolabs/osmosis:23.0.3-iavl-v1-alpine
| alpine
| Alpine image |
Example run:
docker run osmolabs/osmosis:23.0.3-iavl-v1 version
# v23.0.3-iavl-v1
All the images support arm64
and amd64
architectures.