doc: add release notes

This commit is contained in:
ismaelsadeeq 2025-01-09 11:53:16 -05:00
parent b21c0e92a3
commit 7ab1344eb1
No known key found for this signature in database
GPG key ID: 0E3908F364989888

View file

@ -0,0 +1,22 @@
- Node and Mining
---
- **PR #31384** fixed an issue where the coinbase transaction weight was being reserved in two separate places.
Previously, the default `-blockmaxweight` was set to `4,000,000`. The block template generation algorithm should
to reserve `4,000` weight units (WU) for the coinbase transaction, resulting in a block template of size `3,996,000`.
However, due to duplicate reservation, an additional `4,000` WU padding was also added, leading to a template size of `3,992,000`.
- The fix consolidates the reservation into a single place and introduces a new startup option,
`-coinbasereservedweight` (default: `8,000` weight units). This option specifies the weight units
reserved for the coinbase transaction. The default value of `-coinbasereservedweight` was chosen
to preserve the previous behavior.
- **Upgrade Note:** The default `-coinbasereservedweight` ensures backward compatibility for users who did not override
`-blockmaxweight` and relied on the previous behavior.
- For users who do not rely on the previous behavior, setting `-coinbasereservedweight=4000`
allows block templates of size `3,996,000` WU to be generated.
- Bitcoin Core will now **fail to start** if the `-blockmaxweight` or `-maxcoinbaseweight` init parameter exceeds
the consensus limit of `4,000,000` weight units.