Crystal Bitoreum Core Wallet - "Greeley"

Maintenance Update

This is a recommended update for users running Crystal Bitoreum Core QT wallets.

Version v4.1.0.1 is a maintenance release focused on build modernization, C++17 compatibility work, packaged application polish, and graphical/icon improvements. This release does not intentionally introduce consensus, protocol, smartnode, quorum, collateral, or blockchain compatibility changes.

NOTE:
v4.1.0.1 - Greeley is not required for Exchanges, Pools, Smartnodes or other headless uses. It wont hurt anything but this is mostly an update for the people who wanted the new graphics and better QT performance on Windows and macOS

Highlights

• C++17 build modernization
• Updated packaged application icons and graphical assets
• Improved desktop launcher / packaged application presentation
• macOS CI and packaging workflow cleanup
• Cross-platform build reliability improvements
• Dependency and compiler compatibility cleanup
• No intended consensus or protocol changes

Details

This release brings the public test work from the v4.1.1.99-test development cycle into a stable patch release line based on v4.1.0.0.

The main focus is modernization and release polish rather than network rule changes. Existing synced wallets, nodes, smartnodes, pools, and exchange wallets should be able to upgrade by replacing the binaries.

Notable areas of work include:

• C++17 compatibility improvements
• Removal or replacement of deprecated C++ patterns exposed by newer compilers
• Build configuration cleanup for modern GCC and Clang toolchains
• Improved compatibility with current GitHub Actions runners
• macOS packaging and icon handling improvements
• Desktop/package icon fixes across supported platforms
• General release packaging cleanup

⚠️ Critical Notes

Before Proceeding

Make a backup copy of your current wallet.dat file with your wallet core safely shut down.

This release is intended to be a binary drop-in update for users already running v4.1.0.0.

If you are upgrading from versions older than v4.0.1.1, a full resync or reindex may still be required depending on your current local chain state.

Upgrade Notes

For users already running v4.1.0.0:

1. Shut down the wallet, node, smartnode, pool wallet, or exchange wallet cleanly.
2. Back up wallet.dat.
3. Replace the old binaries with the v4.1.0.1 binaries.
4. Restart the wallet or daemon.
5. Confirm the reported version is v4.1.0.1.

Example:

./bitoreumd --version
./bitoreum-cli --version

For GUI users, confirm the version from the wallet About dialog.

Reindex / Resync Notes

A full resync should not be required when upgrading directly from v4.1.0.0.

If you are upgrading from an older or unhealthy local chain state, only keep the following in your .bitoreumcore folder:

Files:

• wallet.dat
• powcache.dat
• bitoreum.conf

Then launch with:

./bitoreumd -reindex

Or add this to your bitoreum.conf temporarily:

reindex=1

Using powcache.dat can significantly speed up sync because the wallet does not need to calculate powhash for every block during sync.

If this is your first time at fight club...

Please use powcache.dat or the bootstrap when available, because syncing headers from zero may take a long time.

macOS Notes

The macOS builds remain x86-focused at this time. On Apple Silicon Macs, the x86 build should be run through Rosetta where applicable.

Native Apple Silicon builds are still planned for future investigation, but are not the main focus of this patch release.

macOS 13 is backwards compatible with macOS 12 and forward Compatible with macOS 14
macOS 15 is backwards compatible with macOS 14 and forward Compatible with macOS 16 (Tahoe)

Oracle Ampere / ARM Notes

Oracle Ampere and other ARM server builds are intended primarily for headless daemon use. If a Qt wallet is desired on ARM server environments, compiling locally is recommended.

Raspberry Pi Notes

Raspberry Pi 4+ 64-bit devices remain the recommended baseline for Raspberry Pi use.

Qt wallet use on low-RAM Raspberry Pi devices is not recommended. CLI/daemon usage is preferred for lower-power ARM devices.

Compatibility

This release does not intentionally introduce:

• Consensus changes
• Protocol changes
• Smartnode changes
• Quorum parameter changes
• Collateral changes
• Blockchain compatibility changes

The focus of this release is build modernization, graphical polish, packaging cleanup, and long-term maintainability.

Footnotes

The “Crystal” in Crystal Bitoreum is an in-house distinction used to differentiate the current Core Wallet and developers from the original Bitoreum Core Wallet and developers.

The coin name Bitoreum and coin ticker $BTRM remain unchanged.

Generic builds are intended to be broadly compatible. Users who are comfortable compiling from source are encouraged to do so. For those of you who are a bit more adventurous but need a helping hand can use bake to compile from source quickly

Bootstrap

The bootstrap has exceeded GitHub's 2GB file limit. For now, the bootstrap is hosted externally:

bootstrap.zip

Full Changelog: v4.1.0.0...v4.1.0.1