Skip to content

Instantly share code, notes, and snippets.

@amc-ie
Last active November 13, 2025 13:42
Show Gist options
  • Select an option

  • Save amc-ie/18c89a9c6c62575646caafbf3aa876e0 to your computer and use it in GitHub Desktop.

Select an option

Save amc-ie/18c89a9c6c62575646caafbf3aa876e0 to your computer and use it in GitHub Desktop.
Archive Node Hotfix Release 3.2.1

🚨This hotfix release is only for users running the Archive Node service.🚨

For Mina Daemon and Rosetta 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 chance that this issue will be encountered at any stage in the future.

As always, 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:

https://github.com/MinaProtocol/mina/compare/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

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:    6aa493f5520aff83f27ffb2b28884478334392ce
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment