Release 2.5.0.0.3: Stacks 2.5 Hard fork

28 views
Skip to first unread message

Jesse Wiley

unread,
Apr 21, 2024, 3:41:48 PMApr 21
to announce
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Hello,

We have released Stacks version 2.5.0.0.3, available here: https://github.com/stacks-network/stacks-blockchain/releases/tag/2.5.0.0.3.

This release implements the 2.5 Stacks consensus rules which activates at Bitcoin block `840,360`: primarily the instantiation of the pox-4 contract. For more details see SIP-021.
This is the first consensus-critical release for Nakamoto. Nodes which do not update before the 2.5 activation height will be forked away from the rest of the network.
This release is compatible with 2.4.x.x.x chainstate directories and does not require re-syncing from genesis.
The first time a node boots with this version it will perform some database migrations which could lengthen the normal node startup time.


Changelog:
## [2.5.0.0.3]

This release fixes a regression in `2.5.0.0.0` from `2.4.0.1.0` caused by git merge

## [2.5.0.0.2]

This release fixes two bugs in `2.5.0.0.0`, correctly setting the activation height for 2.5, and the network peer version.

## [2.5.0.0.0]

This release implements the 2.5 Stacks consensus rules which activates at Bitcoin block `840,360`: primarily the instantiation
of the pox-4 contract. For more details see SIP-021.

This is the first consensus-critical release for Nakamoto. Nodes which do not update before the 2.5 activation height will be forked away from the rest of the network. This release is compatible with 2.4.x chain state directories and does not require resyncing from genesis. The first time a node boots with this version it will perform some database migrations which could lengthen the normal node startup time.

**This is a required release before Nakamoto rules are enabled in 3.0.**


### Timing of Release from 2.5 to 3.0

Activating Nakamoto will include two epochs:

- - **Epoch 2.5:** Pox-4 contract is booted up but no Nakamoto consensus rules take effect.
- - **Epoch 3:** Nakamoto consensus rules take effect.

### Added

- - New RPC endpoint `/v2/stacker_set/{cycle_number}` to fetch stacker sets in PoX-4
- - New `/new_pox_anchor` endpoint for broadcasting PoX anchor block processing.
- - Stacker bitvec in NakamotoBlock
- - New [`pox-4` contract](./stackslib/src/chainstate/stacks/boot/pox-4.clar) that reflects changes in how Stackers are signers in Nakamoto:
  - `stack-stx`, `stack-extend`, `stack-increase` and `stack-aggregation-commit` now include a `signer-key` parameter, which represents the public key used by the Signer. This key is used for determining the signer set in Nakamoto.
  - Functions that include a `signer-key` parameter also include a `signer-sig` parameter to demonstrate that the owner of `signer-key` is approving that particular Stacking operation. For more details, refer to the `verify-signer-key-sig` method in the `pox-4` contract.
  - Signer key authorizations can be added via `set-signer-key-authorization` to omit the need for `signer-key` signatures
  - A `max-amount` field is a field in signer key authorizations and defines the maximum amount of STX that can be locked in a single transaction.
- - Added configuration parameters to customize the burn block at which to start processing Stacks blocks, when running on testnet or regtest.
  ```
  [burnchain]
  first_burn_block_height = 2582526
  first_burn_block_timestamp = 1710780828
  first_burn_block_hash = "000000000000001a17c68d43cb577d62074b63a09805e4a07e829ee717507f66"
  ```

### Modified

- - `pox-4.aggregation-commit` contains a signing-key parameter (like
  `stack-stx` and `stack-extend`), the signing-key parameter is removed from
  `delegate-*` functions.

Git commit hash: 52d425dd6ed7c15b1944b7aa4a5c645c4e322227

SHA512SUMS:
a3584fc3ef130868bc3e7a8fb505da54299108f1bebaf3e25981903c6cfbc898d62019b478be683480bc310d01d7e54ec3995d205c2b55ca44a4bb8481cfe3b2  linux-glibc-arm64.zip
f2cf57334c471e400a3611aebd22f2f39b544a1cd8bd00e128ef45372afcb6ca1234fa9e9ed77aa3ccdd520cf680563b5fe03bb6dd9265748845d483ce75906d  linux-glibc-armv7.zip
9acd2a1ac43ab3a59c9a998594fadcf02ffc00ee9a4a7cfc58562d40528321ff9d42ab66a9896fb6521e77e848d26ab42dcbaa480a00b36a940fa65c96290447  linux-glibc-x64.zip
ebff0fea97a3d37c636f6576a043983e3f6995aa7462ea81ad86f0060ab74b8e53418543b87a7f9302c6d2a9846025e0741d01edbcd05a7343dec2c6e9829dd7  linux-musl-arm64.zip
9fd7c1a0ec67b397063086109e94cbc8ab0d53ecd8aa719194ed216fa75833151f17cc7a16953cd5a80d5e6951125abf63ba50bce3292784f11449e17cfc079d  linux-musl-armv7.zip
97db70c7f148f9aa7c7e7b1e1c34bc162f5d14bd020d0d2a982f318bf9fa5920354bb93d5f37a51976d9eacc77a11d5ee411d19670b2b1b3e955df0f1f07d010  linux-musl-x64.zip
5773faffecffb9ef4dace5a95bc964c55a9d9b5c6664866e93c07d5a8529b1fa05a0140ef8616ae943e1b1fb2cf76f01216c1568515cfc9d64631f9d67b2c589  macos-arm64.zip
ce5ecd740c01fcb98c7d4cb8b2e773743d602112af4e9733636d6cf8f316a2b62d56ff33e9c5d4f950e182f5dcb22de0afe2bd38a27457495761872af66cd5a5  macos-x64.zip
0f69042e56643a066b181d199d93412b7cf1cee3c42e97d0213d6b029038c2b1671c35619b9e03e263fb190a2aff130ac253892c2c5a2cfca0a9ee5764dcb971  windows-x64.zip
a999e8a07fab8b41433607c621231d51865279a74fbbbf808297cb73f630d17ac1cb99cbb8e04a23a6903441fc1305b7ba295ccb6ce5b347382ea5398c0461a6  stacks-core-2.5.0.0.3.tar.gz
30550c3d4dbe1bc7374f0469c8d6f48dcca6e0443737024bdc83a79197d01d8058490e875d8367ab2f427c04e58d13e26068b63c0b666e846daf9f7230121702  stacks-core-2.5.0.0.3.zip

Best,
Jesse Wiley
Engineering Partner, Stacks Foundation
-----BEGIN PGP SIGNATURE-----

iQJFBAEBCgAvFiEEuA5a9CyThwv6776aKDYgwf4oCDwFAmYlZS4RHGplc3NlQHN0
YWNrcy5vcmcACgkQKDYgwf4oCDzHuQ/+IBaAydJGekE+RWepRs8SU1oXjbNpqG7D
2E+pQ8sZBiE9itdcwhXDtP3IjHSLB0KMNENKooZRC8AqryHuniUzyuJKa9Lhh+sr
2riTDUXbGa6TQpQ0aBYrw12HWqMPONuyqG7k2rjIyzUEv0h3CtrLQlcnW8Yaof5c
biDJBp1MPRa223zRTDInm+fFpZIcYUFeoTIz/4qCODpxoxhZVcm0XLIEK9IGZGFJ
L+pxXG9aDf4tg5U1wxp3xn52jnFVftFeASZTU8TgYVZ+18cvIWwMWs4RC6ix2sZI
5TYvANBTrc2sxClDQQq1/lEEu/A2Bl47V6k/XXt8p8LNK3ThS0tdomzaiZBQNsy5
Jl5z2AqonnwDOHABPERkUIviq5cxc9OqaRqgCtUfDO8C84PznCwZqO8jZc8VxFGm
yHT8shFNfmTZLVI15OU3UENUTusxn88hXSF5esQ5AQbr+4anurr2NGklMYXPWScM
CTac7otfyLeylmjH2pwLz143UC9Rbxs9tbHTFDdlyyPs5AdAJpAGBypB82i3X6WA
g0q+KCRbzYwZb1O63UiV2M+PvPbXLM90sZly675YpAQ4Z+ck1zPwNMNyTE0YsXmr
qtiVBWXfvhoHBs1IR5mHiu7omED3EwyxH8Kouz3UXKiK0cXc/Gt4DuarfJzaqOsd
ewybys0MItw=
=cWgW
-----END PGP SIGNATURE-----
Reply all
Reply to author
Forward
This conversation is locked
You cannot reply and perform actions on locked conversations.
0 new messages