Mainnet Stable Release 3.4.0

[amc-ie]

The o1Labs team is proud to announce that 3.4.0 is ready for use on Mainnet! 3.4.0 is planned to be the last standard Berkeley release before we approach the Mesa era! This release includes a large roll up of fixes and improvements to the Mina Protocol as well as our CI and infrastructure that will be more efficiently utilised as we subsequently run through the Mesa Upgrade process in the near future.

If you run into any issues, please include Release: 3.4.0 Stable 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

• Bump RocksDB to 10.5.1 for non-nix builds #17954: Bump RocksDB to 10.5.1
• Enhance multi-key-file-storage library with new features #18230: Enhance multi-key-file-storage library with new features
• Support mixed hf mode #18527: Support mixed hf mode

Improvements

• Update Rust version to 1.92.0 #18275: Update Rust version to 1.92.0
• Bump up proof-systems to release 0.2.0 #18170: Bump up proof-systems to release 0.2.0
• Fix empty Mesa account and auto mode Mesa genesis names #18270: Fix empty Mesa account and auto mode Mesa genesis names
• Some simple refactor on seed related logic #18255: Some simple refactor on seed related logic
• Refactor Archive Node Test and Fixtures #17853: Refactor Archive Node Test and Fixtures
• Reduce root history size from 2k to k+10 #18311: Reduce root history size from 2k to k+10
• Add base58 encoding regression tests for all version bytes #18419: Add base58 encoding regression tests for all version byte
• Simplify merkle list prover #18289: Simplify merkle list prover
• Track RAM usage by subprocesses #18082: Track RAM usage by subprocesses
• Rework, speed up root ledger population from genesis #17874: Rework, speed up root ledger population from genesis

Bug fixes

• [CI][Fix] Auto/Legacy hardfork debian name collision #18399: [CI][Fix] Auto/Legacy hardfork debian name collision
• Fix nit bug in cli test where daemon is not killed #18064: Fix nit bug in cli test where daemon is not killed
• Fix custom token archive bug, improve zkapp test executive test #18491: Fix custom token archive bug, improve zkapp test executive test
• Fix leak in libp2p stream table #18328: Fix leak in libp2p stream table
• Fix Rosetta CLI arg doc for --graphql-uri #17969: Fix Rosetta CLI arg doc for --graphql-uri

Complete Changelog since 3.3.1:

3.3.1...3.4.0

Supported environments include macOS, Linux (Debian 11, 12 and Ubuntu 20.04 LTS, Ubuntu 22.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 Mainnet

Debian Packages:

Debian Repository: First, set up and update the stable 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) stable" | sudo tee /etc/apt/sources.list.d/mina.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.4.0-bd0fe9e
Mina Archive: sudo apt-get install --allow-downgrades -y mina-archive=3.4.0-bd0fe9e
Mina Archive Schema: create_schema.sql
Config File: var/lib/coda/config_bd0fe9e9.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, jammy, noble, bullseye or bookworm to select the base docker image.

Mina Daemon: gcr.io/o1labs-192920/mina-daemon:3.4.0-bd0fe9e-CODENAME-mainnet
Mina Archive: gcr.io/o1labs-192920/mina-archive:3.4.0-bd0fe9e-CODENAME-mainnet
Mina Rosetta: gcr.io/o1labs-192920/mina-rosetta:3.4.0-bd0fe9e-CODENAME-mainnet

Step by Step Guide:

Docker only Make sure to run with:

--peer-list-url https://bootnodes.minaprotocol.com/networks/mainnet.txt or add PEER_LIST_URL=https://bootnodes.minaprotocol.com/networks/mainnet.txt to your .mina-env.

(note - the older https://storage.googleapis.com/mina-seed-lists/mainnet_seeds.txt is still functional but we advise users to migrate to the newer one when possible).

Run mina daemon with:

mina daemon --peer-list-url https://bootnodes.minaprotocol.com/networks/mainnet.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:    bd0fe9e959a7b41f07fae7ddadfebcd130d138b7

---

This discussion was created from the release Mainnet Stable Release 3.4.0.