v0.15.1 — stability & performance

[oskarszoon]

v0.15.1 — stability & performance

Released: 2026-05-22
GitHub: https://github.com/bsv-blockchain/teranode/releases/tag/v0.15.1
Container: ghcr.io/bsv-blockchain/teranode:v0.15.1

Upgrade priority

Recommended — bundles operational stability fixes (block-assembly stall recovery, kafka producer-key handling, subtree-validation backpressure) and performance improvements across block-assembly, propagation, aerospike, and the legacy path, alongside consensus-correctness hardening.

Highlights

Stability

• Block-assembly stall after silent subscription drift fixed (fix(blockchain): root-cause fix for block-assembly stall after silent subscription drift (refs #872) #878)
• Block-assembly state-transition dequeue bounded + goroutine leaks closed (fix(blockassembly): bound state-transition dequeue + close goroutine leaks #914)
• Block-assembly catch-up vs reorg path split (fix(blockassembly): split catch-up from reorg in processNewBlockAnnouncement #903)
• Kafka per-partition fan-out + sticky-partitioner producer keys (fix(kafka): per-partition fan-out + sticky-partitioner producer keys #895)
• Subtree-validation: bounded shard worker pool replaces unbounded goroutine-per-message (fix(subtreevalidation): replace unbounded goroutine per Kafka message with bounded shard worker pool #858)
• P2P broadcast goroutines capped with bounded semaphore (fix(p2p): cap broadcast goroutines with bounded semaphore #775)

Consensus correctness

• Reject duplicate spend claims inside UTXO store batches (Reject duplicate spend claims inside UTXO store batches #825)
• UTXO Unspend now verifies spend ownership (fix(utxo): verify spend ownership in Unspend #766)
• setMinedMulti coverage invariant enforced across store, model, cache, and block validation (fix(setMinedMulti): enforce coverage invariant across store, model, cache, and block validation #850)
• OP_NUM2BIN size-error constant corrected (fix(txscript): correct OP_NUM2BIN size-error constant #759)
• Legacy: non-pow2 final subtree allowed to avoid degenerate partitions (fix(legacy): allow non-pow2 final subtree to avoid degenerate partitions (#901) #909)
• Subtree-validation: NewIncompleteTreeByLeafCount allocation capped at policy max (fix(subtreevalidation): cap NewIncompleteTreeByLeafCount allocation at policy max #773)

Performance

• Block-assembly: recycled tx maps + bucket-sharded inserts cut moveForwardBlock latency (perf(blockassembly): recycle tx maps + bucket-sharded inserts to cut moveForwardBlock latency #877)
• Block-assembly: packed TxInpoints + zero-alloc columnar path (perf(blockassembly): adopt packed TxInpoints + zero-alloc columnar path #889)
• Aerospike: BatchPreviousOutputsDecorate fanned out per-tx (perf(aerospike): fan out BatchPreviousOutputsDecorate per-tx #893)
• Txmeta v2 wire format + partition-aware receiver + pooled buffers (perf(txmeta): v2 wire format + partition-aware receiver + pooled buffers #912)
• Legacy: streaming decode of incoming blocks + go-wire v1.2.5 (perf(legacy): stream-decode incoming block messages off the socket #885, perf(legacy/peer): use go-wire v1.2.5 streaming decode for post-handshake reads #888)
• Block-validation: map pre-sizing + pooling rework — significant peak-RAM reduction at very large block sizes (scaling-net regime) (perf(blockvalidation): cut peak RAM during block validation by ~150 GB #886)

Features

• Rewind blockchain CLI (Added rewind blockchain CLI #728)
• File-store health endpoint disk-space check (feat(health): add disk space check to file store health endpoint #700)
• Asset: on-demand subtree-data admission control + 503/Retry-After (feat(asset): on-demand subtree-data admission control + 503/Retry-After #896)
• Asset: streaming subtree responses (Stream asset subtree responses to reduce memory use #827)
• Pruner: skip parent updates for already-pruned parents (feat(pruner): skip parent updates for already-pruned parents #628)
• Dashboard light theme (Light Theme #790)
• bdk upgraded to 1.2.4 (MvP-4597 Upgrade bdk 1.2.4 #839)

Known issues

None.

Full changelog