This guide explains Bitcoin Core 30.2 release in plain English. It summarises the important changes, who they affect and what should be checked before an upgrade.
TL;DR
- What it is: Bitcoin Core 30.2 is a targeted maintenance release addressing unnamed legacy-wallet migration, wallettool dump creation and shutdown hangs during IPC wait calls. It also updates build requirements and deterministic-build tooling.
- Why it matters: Bitcoin Core 30.2 concentrates on recovery-sensitive wallet paths and reliable process interruption. Operators should reproduce both success and failure cases before relying on the fixes with unique custody material.
- Current position: Require a second reviewer and explicit rollback or expiry, and pause payments, signing or network-dependent services until post-change evidence is complete.
Bitcoin Core 30.2 release in simple English
Bitcoin Core 30.2 release: Verify release signatures and hashes, stop cleanly, back up wallets and configuration, deploy a canary, test unnamed migration and failure cleanup, interrupt waits and retain a rollback artefact.
Simple example
A node operator is checking Bitcoin Core 30.2 release. Inventory wallet names and formats before upgrade and rehearse the exact default-wallet case using verified copies.
Key terms in plain English
- Bitcoin Core:
- Widely used software that validates Bitcoin and can provide wallet, network and operator tools.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
Unnamed migration
A failure affecting migration of an unnamed legacy wallet is fixed. Inventory wallet names and formats before upgrade and rehearse the exact default-wallet case using verified copies.
Dump creation
wallettool createfromdump no longer incorrectly deletes the wallets directory when the unnamed operation fails. Use a staging directory, validate the dump and verify that unrelated wallets remain intact after negative tests.
Migration cleanup
extra tests cover backup-name mismatch and relative-wallet failure cleanup. Preserve the automatic legacy backup plus a separately verified operator backup until the migrated descriptor wallet is proven recoverable.
IPC shutdown
Ctrl-C shutdown hangs during wait calls are fixed. Exercise signals while mining waits are idle and active, then verify clean process exit, socket cleanup and restart.
Build boundary
The minimum Boost requirement changes and reproducible-build tooling receives fixes. Custom builders should pin dependencies, record hashes and compare outputs through the supported process.
Compatibility
The documented platform baseline remains Linux kernel 3.17+, macOS 13+ and Windows 10+. Old unsupported environments need an explicit migration plan.
Deployment
Verify release signatures and hashes, stop cleanly, back up wallets and configuration, deploy a canary, test unnamed migration and failure cleanup, interrupt waits and retain a rollback artefact. Build a revision-pinned evidence pack on an isolated node, wallet or protocol harness. Record source commit, binary hash, network, chain identity, configuration and dependencies.
Frequently asked questions
What is the main point of Bitcoin Core 30.2 release?
Bitcoin Core 30.2 release: Verify release signatures and hashes, stop cleanly, back up wallets and configuration, deploy a canary, test unnamed migration and failure cleanup, interrupt waits and retain a rollback artefact.
For Bitcoin Core 30.2 release, what should a beginner know about unnamed migration?
A failure affecting migration of an unnamed legacy wallet is fixed. Inventory wallet names and formats before upgrade and rehearse the exact default-wallet case using verified copies.
For Bitcoin Core 30.2 release, what should a beginner know about dump creation?
wallettool createfromdump no longer incorrectly deletes the wallets directory when the unnamed operation fails.
For Bitcoin Core 30.2 release, what should a beginner know about migration cleanup?
extra tests cover backup-name mismatch and relative-wallet failure cleanup. Preserve the automatic legacy backup plus a separately verified operator backup until the migrated descriptor wallet is proven recoverable.
Conclusion
Bitcoin Core 30.2 concentrates on recovery-sensitive wallet paths and reliable process interruption. Operators should reproduce both success and failure cases before relying on the fixes with unique custody material.
Primary sources
Check the current specification status and the documentation for the exact implementation you operate before moving production funds or changing a mining node.
Join the ASIC Mining Discussion
Members can read and join the discussion
Log in to read comments from other miners. Create a free account if you would like to ask a question or share your experience.
Membership helps us protect the discussion from spam and keep answers useful.