Releases · MinaProtocol/mina

13 Nov 19:33

amc-ie

3.2.1

6aa493f

Archive Node Hotfix Release 3.2.1 Latest

Latest

🚨This hotfix release is only for users running the Archive Node service (inc. Rosetta docker container)🚨

For Mina Daemon users, please refer to the 3.2.0 stable release.

This 3.2.1 hotfix releases for Mainnet fixes a very rare edge case on read operations that was caused by a race condition within Archive Node. No other Mina components are affected or changed by this fix. It is recommended to upgrade to this version to avoid the likelihood that this issue will be encountered at any stage in the future.

If you run into any issues please include Release: 3.2.1 in the name of any issues you create. Please report any issues you encounter here or join the discussion

Bug Fixes

#18091 – FIX(Archive.Processor): ensure add_block_aux is always adding block data in 1 single txn

Complete Changelog since 3.2.0:

3.2.0...3.2.1

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 out support for this 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 Archive: sudo apt-get install --allow-downgrades -y mina-archive=3.2.1-6aa493f
Mina Archive Schema: create_schema.sql
Config File: var/lib/coda/config_6aa493f5.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 Archive: minaprotocol/mina-archive:3.2.1-6aa493f-CODENAME-mainnet
Mina Rosetta: minaprotocol/mina-rosetta:3.2.1-6aa493f-CODENAME-mainnet

Git SHA-1:    6aa493f5520aff83f27ffb2b28884478334392ce

Assets 2

0 Join discussion

30 Oct 19:59

amc-ie

3.3.0-beta1

5b0a889

Mainnet Beta Release 3.3.0-beta1 Pre-release

Pre-release

The o1Labs team is proud to announce that 3.3.0-beta1 is ready to test on Mainnet! This release includes a significant number of additions and improvements that will form the basis of the upcoming Mesa Upgrade. We have made significant performance improvements to the archive node process which should lower resource consumption considerably. We have also extended our operating system support based on your feedback to include Ubuntu 22.04 LTS (Jammy Jellyfish) and experimental ARM64 support for Ubuntu 24.04LTS (Noble) and Debian 12 (Bookworm).

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

#17702: [CI] Support for jammy
#16704: Caqti upgrade with fix for rosetta
#17664: [ARM64] adding arm64 for noble and bookworm

Improvements

#17730: Use stricter error type in Work partitioner
#17758: Push sig kind out of snark profiler lib
#17686: Refactor Snark Worker related metrics generation
#17677: Implement staged ledger checkpointing
#17675: Folding accounts across all ledger masks
#17648: Various helper functions in Snark Work Lib
#17641: Improve Genesis Ledger Creation

Bug fixes

#17583: Handle submission into work partitioner single pool correctly

Complete Changelog since 3.2.0:

3.2.0...3.3.0-beta1

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 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.3.0-beta1-5b0a889
Mina Archive: sudo apt-get install --allow-downgrades -y mina-archive=3.3.0-beta1-5b0a889
Mina Archive Schema: create_schema.sql
Config File: var/lib/coda/config_5b0a8898.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.3.0-beta1-5b0a889-CODENAME-mainnet
Mina Archive: gcr.io/o1labs-192920/mina-archive:3.3.0-beta1-5b0a889-CODENAME-mainnet
Mina Rosetta: gcr.io/o1labs-192920/mina-rosetta:3.3.0-beta1-5b0a889-CODENAME-mainnet

For experimental ARM64 docker images replace CODENAME in the images below with your choice of noble or bookworm to select the desired image.

Mina Daemon: gcr.io/o1labs-192920/mina-daemon:3.3.0-beta1-5b0a889-CODENAME-mainnet-arm64
Mina Archive: gcr.io/o1labs-192920/mina-archive:3.3.0-beta1-5b0a889-CODENAME-mainnet-arm64
Mina Rosetta: gcr.io/o1labs-192920/mina-rosetta:3.3.0-beta1-5b0a889-CODENAME-mainnet-arm64

Note: for ARM64 builds the GIT SHA-1 will be 9c856a80763d55a2de765bac6c96f4c776f7887b, this is due to changes in our build pipeline during the beta1 release. This is for the beta1 release only.

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:    5b0a88983c71ed7c57f39bdea03dc00b1a5642d0

Assets 2

1 Join discussion

17 Sep 11:58

amc-ie

3.3.0-alpha1

6929a7e

Devnet Pre-Release 3.3.0-alpha1 Pre-release

Pre-release

The o1Labs team is proud to announce that 3.3.0-alpha1 is ready to test on Devnet! This release includes a significant number of additions and improvements that will form some of the basis of the upcoming Mesa Upgrade. We have made significant performance improvements to the archive node process which will lower resource consumption over time considerably. We have also extended our operating system support based on your feedback to include Ubuntu 22.04 LTS (Jammy Jellyfish) and provide ARM64 versions of Ubuntu 24.04 LTS (Noble) and Debian 12 (Bookworm).

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

#17702: [CI] Support for jammy
#17664: [ARM64] adding arm64 for noble and bookworm

Improvements

#17730: Use stricter error type in Work partitioner
#17758: Push sig kind out of snark profiler lib
#17686: Refactor Snark Worker related metrics generation
#17641: Refactor Genesis Ledger helpers

Bug fixes

#16704: Caqti upgrade with fix for rosetta, fixed performance regression
#17583: Handle submission into work partitioner single pool correctly

Complete Changelog since 3.2.0:

3.2.0...3.3.0-alpha1

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 Devnet

Debian Packages:

Debian Repository: First, set up and update the alpha 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) alpha" | sudo tee /etc/apt/sources.list.d/mina-alpha.list
sudo apt-get update

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

Mina Daemon: sudo apt-get install --allow-downgrades -y mina-devnet=3.3.0-alpha1-6929a7e
Mina Archive: sudo apt-get install --allow-downgrades -y mina-archive=3.3.0-alpha1-6929a7e
Mina Archive Schema: create_schema.sql
Config File: var/lib/coda/config_6929a7ec.json

Docker Images:

Mina Daemon: gcr.io/o1labs-192920/mina-daemon:3.3.0-alpha1-6929a7e-CODENAME-devnet
Mina Archive: gcr.io/o1labs-192920/mina-archive:3.3.0-alpha1-6929a7e-CODENAME-devnet
Mina Rosetta: gcr.io/o1labs-192920/mina-rosetta:3.3.0-alpha1-6929a7e-CODENAME-devnet

For ARM64 docker images replace CODENAME in the images below with your choice of noble or bookworm to select the desired image.

Mina Daemon: gcr.io/o1labs-192920/mina-daemon:3.3.0-alpha1-6929a7e-CODENAME-devnet-arm64
Mina Archive: gcr.io/o1labs-192920/mina-archive:3.3.0-alpha1-6929a7e-CODENAME-devnet-arm64
Mina Rosetta: gcr.io/o1labs-192920/mina-rosetta:3.3.0-alpha1-6929a7e-CODENAME-devnet-arm64

Step by Step Guide:

Docker only Make sure to run with:

-peer-list-url https://storage.googleapis.com/o1labs-gitops-infrastructure/devnet/seed-list-devnet.txt or add PEER_LIST_URL=https://storage.googleapis.com/o1labs-gitops-infrastructure/devnet/seed-list-devnet.txt to your .mina-env.

Run mina daemon with:

mina daemon --peer-list-url https://storage.googleapis.com/o1labs-gitops-infrastructure/devnet/seed-list-devnet.txt

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

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

Chain id:     29936104443aaf264a7f0192ac64b1c7173198c1ed404c1bcff5e562e05eb7f6
Git SHA-1:    6929a7ecd1b5cf977ceb674baa6e32764576c109

Assets 2

0 Join discussion

28 Aug 17:35

amc-ie

3.2.0

97ad487

Mainnet Stable Release 3.2.0

The o1Labs team is proud to announce that 3.2.0 is ready for use 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 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

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 out support for this 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.2.0-97ad487
Mina Archive: sudo apt-get install --allow-downgrades -y mina-archive=3.2.0-97ad487
Mina Archive Schema: create_schema.sql
Config File: var/lib/coda/config_97ad4878.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: minaprotocol/mina-daemon:3.2.0-97ad487-CODENAME-mainnet
Mina Archive: minaprotocol/mina-archive:3.2.0-97ad487-CODENAME-mainnet
Mina Rosetta: minaprotocol/mina-rosetta:3.2.0-97ad487-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:    97ad4878e6b43ab3ed145a5d42972ab062e5ffdd

Assets 2

2 Join discussion

01 Aug 08:57

amc-ie

3.2.0-beta2

939b08d

Mainnet Beta Release 3.2.0-beta2 Pre-release

Pre-release

The o1Labs team is proud to announce that 3.2.0-beta2 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!

This new version fixes a display issue within the mina client status output related to when next blocks would be produced.

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