Mainnet Beta Release 3.2.0-beta1

[amc-ie]

The o1Labs team is proud to announce that 3.2.0-beta1 is ready to test on Mainnet! This release includes not only a lot of changes and refactors that will form a foundation for significant upcoming performance improvements, but also several immediate performance improvements in the daemon. We have also added support for two new operating systems (Ubuntu Noble and Debian Bookworm) based on your feedback!

If you run into any issues, please include Release: 3.2.0-beta1 in the name of any issues you create. Please report any issues you encounter here or join the discussion!

Some highlights of what has changed

New Features

#16853 – Introduce Converting Merkle Tree
Adds a flexible Merkle tree variant that supports conversion logic—useful for future ledger or tooling extensions.

#17508 – Rename and Improve generate_keypair App
Introduces the mina-generate-keypair CLI tool with improvements over the prior version.

#17540 – Support Docker Suffix Tags for Archive Nodes
Adds dynamic Docker tagging support for archive nodes, easing multi-version deployments.

Improvements

#16722 – WASM Memory Boosting with Lazy Cache
Reduces WASM memory usage via lazy-loading cache strategy, improving performance in browser or embedded environments.

#16809 – Faster Block Production via zkApp Proof Pre-Verification
Moves zkApp proof verification to before block creation, cutting out redundant work and speeding up block construction.

#16966 – Disk Cache Enabled in Daemon
Turns on persistent disk caching for the daemon, improving startup times and reducing recomputation.

#17120 – Faster zkApp Hashing
Caches account update action hashes, reducing workload during zkApp execution.

#17457 – Build Archive Nodes Per Network
Splits archive builds by network, simplifying configuration and deployment.

#17484 – Improve zkApp Transaction Regeneration
Improves reliability and determinism of zkApp regeneration, aiding test reproducibility.

#17514 – Optimize LMDB Cache Cleanup
Reuses IDs from garbage-collected entries, making LMDB cache maintenance faster and less CPU-intensive.

#17517 – Batch Deletion in LMDB Cache
Uses batch operations to remove multiple LMDB keys at once, reducing I/O overhead.

Bug Fixes

#17225 – Re-Delivered Transaction Pool Proxy
Restores correct behavior in the transaction pool proxy wiring, ensuring transactions are handled through the intended proxy path.

#17248 – Remove Legacy Ledger Catchup Logic
Eliminates outdated catchup logic that could cause inconsistencies, ensuring more reliable ledger sync.

#17461 – Post-Build Verification for Artifacts in CI
Adds automated validation of Docker and Debian artifacts after build, preventing corrupt or incomplete releases.

Complete Changelog since 3.1.0:

3.1.0...3.2.0-beta1

Supported environments include macOS, Linux (Debian 11, 12 and Ubuntu 20.04 LTS & Ubuntu 24.04 LTS), and any host machine with Docker.

🚨NOTE - as Ubuntu 20.04 has now reached EOL we will phase this out in future releases🚨

---

Upgrading & Connecting to Devnet

Debian Packages:

Debian Repository: First, set up and update the beta Debian Repository for your platform with the following commands:

sudo rm /etc/apt/sources.list.d/mina*.list
echo "deb [trusted=yes] http://packages.o1test.net $(lsb_release -cs) beta" | sudo tee /etc/apt/sources.list.d/mina-beta.list
sudo apt-get update

Then, install the package(s) that you need:

Mina Daemon: sudo apt-get install --allow-downgrades -y mina-mainnet=3.2.0-beta1-978866c
Mina Archive: sudo apt-get install --allow-downgrades -y mina-archive=3.2.0-beta1-978866c
Mina Archive Schema: create_schema.sql
Config File: var/lib/coda/config_978866cd.json

Docker Images:

Every docker image is built for each of the supported platforms, replace CODENAME in the images below with your choice of focal, noble, bullseye or bookworm to select the base docker image.

Mina Daemon: gcr.io/o1labs-192920/mina-daemon:3.2.0-beta1-978866c-CODENAME-mainnet
Mina Archive: gcr.io/o1labs-192920/mina-archive:3.2.0-beta1-978866c-CODENAME-mainnet
Mina Rosetta: gcr.io/o1labs-192920/mina-rosetta:3.2.0-beta1-978866c-CODENAME-mainnet

Step by Step Guide:

Docker only Make sure to run with:

--peer-list-url https://storage.googleapis.com/mina-seed-lists/mainnet_seeds.txt or add PEER_LIST_URL=https://storage.googleapis.com/mina-seed-lists/mainnet_seeds.txt to your .mina-env.

Run mina daemon with:

mina daemon --peer-list-url https://storage.googleapis.com/mina-seed-lists/mainnet_seeds.txt

Check out our documentation for complete instructions on using this version to connect to Mainnet.

If you are running the correct version on the correct network MAINNET, mina client status will show:

Chain id:     a7351abc7ddf2ea92d1b38cc8e636c271c1dfd2c081c637f62ebc2af34eb7cc1
Git SHA-1:    978866cd370e89f854d1d42afefef9aa5535b023

---

This discussion was created from the release Mainnet Beta Release 3.2.0-beta1.