v8.12.1

8.12.1 (2025-08-26)

Release Type: 🔄 OPTIONAL - Recommended for improved performance and bug fixes
Migration Required: ❌ No database migration needed
Compatibility: ✅ Backward compatible with v8.x.x

---

Release Summary

Version 8.12.1 is a patch release that addresses several bug fixes and performance improvements. This release maintains full backward compatibility with existing v8.x.x installations and does not require database migrations.

Quick Update Path: Standard deployment process - no special considerations needed.

---

What's Changed

Bug Fixes

• Fixed: Include nakamoto coinbase txs on coinbase txs filter

  • Impact: Anyone using the transactions endpoint and filtering by coinbase transactions
  • Resolution: (c9ef5e8)
  • Issue References: (#2323)

• Fixed: pox cycle signer stackers query pagination (#2054) , (#2022)

  • Impact: If multiple stackers were stacking the exact same STX, pagination could cause some of them to be missing or appear duplicate in endpoint results.
  • Resolution: (1353554)
  • Issue References: (#2054) , (#2022)

---

Breaking Changes

None - This is a backward-compatible release.

---

Upgrade Priority

User Type	Priority	Recommended Timeline
Production API Operators	Medium	Within 2-4 weeks
Development Teams	Low	At your convenience
High-Traffic Applications	High	Within 1 week (for performance benefits)

v8.12.0

8.12.0 (2025-08-06)

Features

• Add exclude_function_args parameter to reduce transaction response sizes (#2312) (852a60e)
• add replaced_by_tx_id to replaced mempool transactions (#2271) (a70c3d1)
• prometheus: add chain tip metrics (#2333) (bde1037)
• SNP integration (#2291) (9a159e1)

Bug Fixes

• drop redundant db indexes (#2329) (0ddd6a6)
• ensure some ops only run when SNP is not enabled (fd4717b)
• only ingest snp chain events to avoid db bloat (287f572)
• optimize queries to prune and restore mempool rbf txs (#2327) (0b196f0)
• optimize replace-by-fee mempool calculations (#2326) (01998bc)
• parallelize mempool rbf updates (#2328) (e7347e5)
• update snp image in tests (c7c0dbb)

v8.11.6

8.11.6 (2025-07-30)

Bug Fixes

• update stx year 2050 supply to reflect sip-031 increase (#2334) (6916796)

v8.11.5

8.11.5 (2025-07-18)

Bug Fixes

• discount re-orged microblock transactions from ft_balances table (#2322) (911c620)

v8.11.4

8.11.4 (2025-07-14)

Bug Fixes

• validate block cursor pagination parameter format (#2317) (20e334d)

v8.11.3

8.11.3 (2025-07-07)

Bug Fixes

• use burn_block_time in 2.x blocks and block_time after 3.x (#2314) (e1d4c61)

v8.11.2

8.11.2 (2025-06-20)

Bug Fixes

• do not duplicate miner rewards in v2 balance endpoint (#2302) (4c8d514)

v8.11.1

8.11.1 (2025-06-02)

This release addresses a critical issue where the Stacks core changed the field name for contract interface data in /new_block events from contract_abi to contract_interface.

Background:

• Stacks core updated the key name for contract interface data in block events
• This change caused contract ABIs to not be properly stored in the API database
• The fix ensures compatibility with the updated Stacks core event format

Changes Include:

• Updated event processing to read from the new contract_interface field
• Added a patch script (populate-missing-contract-abis.ts) to backfill missing contract ABIs

Bug Fixes

• adjust contract ABI writes to read from contract_interface key instead of contract_abi (#2276) (82f3fea)

v8.11.1-beta.1

8.11.1-beta.1 (2025-05-30)

Bug Fixes

• Contract ABI handling: Adjust contract ABI writes to read from contract_interface key instead of contract_abi (#2276) (82f3fea)

Details

This release addresses a critical issue where the Stacks core changed the field name for contract interface data in /new_block events from contract_abi to contract_interface.

Background:

• Stacks core updated the key name for contract interface data in block events
• This change caused contract ABIs to not be properly stored in the API database
• The fix ensures compatibility with the updated Stacks core event format

Changes Include:

• Updated event processing to read from the new contract_interface field
• Added a patch script (populate-missing-contract-abis.ts) to backfill missing contract ABIs

v8.11.0

8.11.0 (2025-05-26)

Important

This release includes an important fix to STX balances reported by the /extended/v2/addresses/:address/balances/stx endpoint. A new migration is included that will automatically fix balances for all accounts on launch, but since it's a large migration it could take between 20 minutes to 2 hours to complete depending on deployment resources. No manual intervention or special action is required.

Features

• add /extended/v2/block-tenures/:height/blocks endpoint (#2285) (f5c2e01)

  Returns a paginated list of Stacks blocks based on their tenure height.

• stacks core event and rpc proxy body limits configurable via env (#2278) (8a54e9d)

  Makes the Stacks event and RPC body limits configurable via environment variables.

• store and expose vm_error for failed transactions (#2286) (7ac7513)

  Allows API consumers to read ClarityVM errors returned by Stacks miners when confirming failed transactions.

Bug Fixes

• consider microblock transactions in balance calculations (#2277) (3418863)
• count stx mint data at block 0 towards account balances (#2289) (a0cd9f2)
• ignore unanchored param for BNS names endpoint (#2263) (3d33725)
• keep a table of latest stacks node event timestamps (#2266) (6f111ad)
• module imports in block tenure routes (#2287) (2cb442e)
• rosetta: get current block should only join by stacks chain tip information (#2265) (78ebad0)
• simplify transaction events query (#2279) (517ca68)