Skip to content

Releases: hirosystems/stacks-blockchain-api

v8.15.3

22 Apr 17:20

Choose a tag to compare

8.15.3 (2026-04-22)

Release Type: ⚠️ STRONGLY RECOMMENDED
DB Migration Required: ✅ No
Compatibility: ✅ Backwards compatible with v8.x.x


Release Summary

Version 8.15.3 is a patch upgrade that fixes a CRITICAL security vulnerability in one of the dependency packages.


What's Changed

Bug Fixes


Breaking Changes

None - This is a backwards-compatible release.


Upgrade Priority

User Type Priority Recommended Timeline
Production API Operators Medium As soon as possible
Development Teams Medium As soon as possible
High-Traffic Applications Medium As soon as possible

v8.15.2

14 Apr 17:01

Choose a tag to compare

8.15.2 (2026-04-14)

Release Type: ⚠️ RECOMMENDED
DB Migration Required: ✅ No
Compatibility: ✅ Backwards compatible with v8.x.x


Release Summary

Version 8.15.2 is a patch upgrade that optimizes the calculation of cache Etags for endpoints related to individual account activity.


What's Changed

Bug Fixes

  • optimize etag generation for principal activity (#2525) (560d27f)

Breaking Changes

None - This is a backwards-compatible release.


Upgrade Priority

User Type Priority Recommended Timeline
Production API Operators Medium At your convenience
Development Teams Medium At your convenience
High-Traffic Applications Medium At your convenience

v8.15.1

25 Mar 17:33

Choose a tag to compare

8.15.1 (2026-03-25)

Release Type: ⚠️ RECOMMENDED
DB Migration Required: ✅ No
Compatibility: ✅ Backwards compatible with v8.x.x


Release Summary

Version 8.15.1 is a patch upgrade that fixes a regression in the Stacks core /v2 request proxy that was causing node responses to be returned as raw response objects instead of actual JSONs. It's a necessary upgrade only if you're heavy users of this proxy.


What's Changed

Bug Fixes

  • forward proxied stacks node response body correctly (#2501) (8d66403)

Breaking Changes

None - This is a backwards-compatible release.


Upgrade Priority

User Type Priority Recommended Timeline
Production API Operators Medium At your convenience
Development Teams Medium At your convenience
High-Traffic Applications Medium At your convenience

v8.15.0

24 Mar 18:48

Choose a tag to compare

8.15.0 (2026-03-24)

Release Type: 🚨 REQUIRED
DB Migration Required: ✅ No
Compatibility: ✅ Backwards compatible with v8.x.x


Release Summary

Version 8.15.0 is a required release to support the upcoming Stacks 3.4 hard fork. Upgrade is mandatory, as not having this upgrade will cause the API to crash whenever a Clarity 5 transaction is processed.

This release also upgrades some dependencies to resolve security issues.


What's Changed

Features

  • update to stacks codec, support stacks 3.4 (#2487) (61ab19f)

Breaking Changes

None - This is a backwards-compatible release.


Upgrade Priority

User Type Priority Recommended Timeline
Production API Operators High As soon as possible
Development Teams High As soon as possible
High-Traffic Applications High As soon as possible

v8.14.2

10 Mar 02:17

Choose a tag to compare

8.14.2 (2026-03-10)

Release Type: ⚠️ STRONGLY RECOMMENDED
DB Migration Required: ✅ No
Compatibility: ✅ Backwards compatible with v8.x.x


Release Summary

Version 8.14.2 is a security release that updates dependencies to fix several security vulnerabilities.


What's Changed

Bug Fixes

  • drop slow unused gin index on blocks (7c54120)
  • force upgrade form-data transitive dependency (#2479) (3ceea38)
  • upgrade snp client to 2.0.5 (#2473) (a927a9c)

Breaking Changes

None - This is a backwards-compatible release.


Upgrade Priority

User Type Priority Recommended Timeline
Production API Operators High As soon as possible
Development Teams High As soon as possible
High-Traffic Applications High As soon as possible

v8.14.1

25 Feb 17:35

Choose a tag to compare

8.14.1 (2026-02-25)

Release Type: ✅ RECOMMENDED
DB Migration Required: ✅ No
Compatibility: ✅ Backwards compatible with v8.x.x


Release Summary

Version 8.14.1 is a maintenance release that brings several block ingestion performance improvements and security patches, as well as a couple of optional features for modern Stacks event observers.


What's Changed

Features

Bug Fixes


Breaking Changes

None - This is a backwards-compatible release.


Upgrade Priority

User Type Priority Recommended Timeline
Production API Operators Low At your convenience
Development Teams Low At your convenience
High-Traffic Applications Low At your convenience

v8.13.6

22 Dec 20:02

Choose a tag to compare

8.13.6 (2025-12-22)

Release Type: ⚠️ REQUIRED
DB Migration Required: ✅ No
Compatibility: ✅ Backwards compatible with v8.x.x


Release Summary

Version 8.13.6 is a bug fix release that adds support for smart contracts that have empty source codes. Without this fix, attempting to look at these transactions via API endpoints resulted in an Unexpected nullish smart_contract_source_code error.


What's Changed

Bug Fixes

  • Fixed: allow nullish smart contract source code in tx metadata (#2412) (e13c3b9)
    • Impact: Adds empty smart contract source code support

Breaking Changes

None - This is a backwards-compatible release.


Upgrade Priority

User Type Priority Recommended Timeline
Production API Operators High As soon as possible
Development Teams High As soon as possible
High-Traffic Applications High As soon as possible

v8.13.5

02 Dec 19:41

Choose a tag to compare

8.13.5 (2025-12-02)

Release Type: ⚠️ REQUIRED
DB Migration Required: ✅ No
Compatibility: ✅ Backwards compatible with v8.x.x


Release Summary

Version 8.13.5 is a bug fix release that adds support for new SIP-034 tenure extend causes that will be available in the next Stacks core release. This is a required upgrade to avoid the API from stalling once these new extensions are live on mainnet and testnet.


What's Changed

Bug Fixes

  • Fixed: support new sip-034 tenure change causes (#2384) (399908f)
    • Impact: Supports SIP-034 tenure extend types
    • Resolution: 399908f

Breaking Changes

None - This is a backwards-compatible release.


Upgrade Priority

User Type Priority Recommended Timeline
Production API Operators High As soon as possible
Development Teams High As soon as possible
High-Traffic Applications High As soon as possible

v8.13.4

06 Nov 15:25

Choose a tag to compare

8.13.4 (2025-11-06)

Release Type: ⚠️ REQUIRED
Migration Required: ❌ No
Compatibility: ✅ Backward compatible with v8.x.x


Release Summary

Version 8.13.4 is a bug fix release that adds support for Clarity 4 transactions, which will be a part of the upcoming Stacks 3.3 hard fork activation. This upgrade is mandatory for all Stacks API installations in order to avoid outage when Stacks 3.3 activates.


What's Changed

Bug Fixes

  • Fixed: upgrade to latest stacks-encoding-native-js with arm64 support (#2376)
    • Impact: Supports decoding Stacks transactions that use Clarity version 4
    • Resolution: (5ab7328)

Infrastructure & Maintenance

  • GLIBC System Dependency Change - This release requires version 2.33 of GLIBC is installed on the machine where it's running. This only affects users running the Stacks Blockchain API binary in their own Docker image or directly on a machine. If using the Hiro Systems Docker image docker.io/hirosystems/stacks-blockchain-api:8.13.4, there should be no impact.

Breaking Changes

None - This is a backward-compatible release.


Upgrade Priority

User Type Priority Recommended Timeline
Production API Operators High As soon as possible
Development Teams High As soon as possible
High-Traffic Applications High As soon as possible

v8.13.2

21 Oct 17:33

Choose a tag to compare

8.13.2 (2025-10-21)

Release Type: ✅ RECOMMENDED
Migration Required: ✅ Automatic migration will be run
Compatibility: ✅ Backward compatible with v8.x.x


Release Summary

Version 8.13.2 is a bug fix release that adjusts the response data quality for two endpoints on the API related to Stacking pools and Bitcoin rewards. It also contains other unrelated stability fixes. A database migration will be run automatically by the API when upgrading but it is a quick data adjustment query that should take no more than 2 minutes to run.


What's Changed

Bug Fixes


Breaking Changes

None - This is a backward-compatible release.


Upgrade Priority

User Type Priority Recommended Timeline
Production API Operators Low At your convenience
Development Teams Low At your convenience
High-Traffic Applications Low At your convenience