@blinklabs/dingo 0.29.0 → 0.30.0

package/README.md

@@ -22,7 +22,7 @@ A high-performance Cardano blockchain node implementation in Go by Blink Labs. D
 - Peer governance with dynamic peer selection, ledger peers, and topology support
 - Chain rollback support for handling forks with automatic state restoration
 - Fast bootstrapping via built-in Mithril client
-- Multiple API servers: UTxO RPC, Blockfrost-compatible REST, Mesh (Coinbase Rosetta)
+- Multiple API servers: UTxO RPC, WIP Blockfrost-compatible REST, Mesh (Coinbase Rosetta)
 
 Note: On Windows systems, named pipes are used instead of Unix sockets for node-to-client communication.
 
@@ -163,14 +163,13 @@ storageMode: "api"
 
 ## API Servers
 
-Dingo includes four API servers, all disabled by default. Enable them by setting a non-zero port. All API servers except Bark require `storageMode: "api"`.
+Dingo includes three API servers. All APIs require `storageMode: "api"` and start automatically on their default ports in that mode. Set an individual port to 0 to disable a specific API. The Blockfrost server provides a WIP Blockfrost-compatible REST API with a growing subset of the compatibility surface.
 
 | API | Port Env Var | Default | Protocol |
 |-----|-------------|---------|----------|
 | UTxO RPC | `DINGO_UTXORPC_PORT` | disabled | gRPC |
 | Blockfrost | `DINGO_BLOCKFROST_PORT` | disabled | REST |
 | Mesh (Rosetta) | `DINGO_MESH_PORT` | disabled | REST |
-| Bark | `DINGO_BARK_PORT` | disabled | RPC |
 
 ```bash
 # Enable Blockfrost API on port 3100 and UTxO RPC on port 9090
@@ -441,9 +440,8 @@ For information on developing custom storage plugins, see [PLUGIN_DEVELOPMENT.md
   - [x] Genesis snapshot capture
 - [x] API Servers
   - [x] UTxO RPC (gRPC)
-  - [x] Blockfrost-compatible REST API
+  - [ ] WIP Blockfrost-compatible REST API
   - [x] Mesh (Coinbase Rosetta) API
-  - [x] Bark block archive API
 - [x] Mithril Bootstrap
   - [x] Built-in Mithril client
   - [x] Ledger state import (UTxOs, accounts, pools, DReps, epochs)

package/RELEASE_NOTES.md

@@ -1,6 +1,129 @@
 # Release Notes
 
 
+## v0.29.1 (April 2, 2026)
+
+**Title:** Safer APIs and steadier sync
+
+**Date:** April 2, 2026
+
+**Version:** v0.29.1
+
+Hi folks! Here’s what we shipped in v0.29.1.
+
+### ✨ What's New
+
+- **Rolled out expanded transaction builders and txpump testing:** End-to-end testing is easier because you can now build more transaction types and run a randomized txpump loop.
+- **Handy devnet and testnet setup tooling:** Spinning up local and testnet environments is simpler because you now have additional helper scripts, specs, and Antithesis wiring.
+
+### 💪 Improvements
+
+- **Safer API opt-in defaults:** Service exposure is clearer because APIs now only activate when you explicitly opt in.
+- **Steadier rollback iteration:** Catch-up and restart behavior is more predictable because chain iteration is now safer under rollbacks.
+- **Relaxed peer-tip validation during catch-up:** Sync is smoother because peer tip checks are less likely to reject useful peers while you’re catching up.
+- **More reproducible CI and release automation:** Builds are easier to operate because CI and Antithesis automation were hardened.
+- **Clearer release documentation:** What changed is easier to see because release documentation was updated.
+- **Refreshed dependency set:** Compatibility stays rock-solid because a key dependency was updated.
+
+### 🔧 Fixes
+
+- **Iterator cleanup in ledger iteration:** Long-running processes are steadier because ledger iteration now avoids potential resource leaks.
+
+### 📋 What You Need to Know
+
+- **No action required:** You're all set—just upgrade to v0.29.1.
+- **API users:** If you rely on Dingo APIs, make sure your configuration explicitly opts in so the endpoints are enabled.
+
+### 🙏 Thank You
+
+Thank you for trying!
+
+---
+
+
+## v0.29.0 (March 31, 2026)
+
+**Title:** Smoother operations and API refinements
+
+**Date:** March 31, 2026
+
+**Version:** v0.29.0
+
+Hi folks! Here’s what we shipped in v0.29.0.
+
+### ✨ What's New
+
+- **Conway-era transaction builders and txpump:** End-to-end testing is easier because you can now generate and run newer-era transactions in automated runs.
+- **Devnet and testnet helpers:** Spinning up test environments is simpler because you now have wallet-focused tests, a configurator script, local devnet helpers, a Dingo testnet spec, and Antithesis `docker-compose` wiring.
+- **Storage disk-usage metrics:** Capacity planning is easier because the blob store and metadata store now export disk-usage (`DiskSize`) Prometheus gauge metrics.
+
+### 💪 Improvements
+
+- **Faster post-snapshot replay:** Restarts are faster because chain-sync now uses a Mithril trust-boundary slot to skip replay work already covered by a snapshot.
+- **Configurable CBOR cache sizing:** Performance tuning is simpler because you can now set the CBOR cache size in configuration.
+- **More predictable Badger defaults:** Deployments are more consistent because storage-mode-specific defaults only apply when values are truly unset.
+- **More accurate Blockfrost responses:** Block and epoch data is more reliable because latest block, epoch, and protocol-parameter responses are now sourced from ledger state and the database.
+
+### 🔧 Fixes
+
+- **Safer rollbacks behind snapshots:** Rollback behavior is more rock-solid because the Mithril trust-boundary now resets when a rollback crosses it.
+- **Rock-solid rollback recovery:** Recovery is smoother because “rollback point not found” now follows the same handling path as `local_tip_plateau`.
+- **Rock-solid WatchTx rollbacks:** Transaction watching is more reliable because WatchTx now supports undo and rollback during chain reorganizations.
+
+### 📋 What You Need to Know
+
+- **No action required:** You're all set—just upgrade to v0.29.0.
+- **Replay and rollback near snapshots:** Testing runs may look different because chain-sync replay now respects the Mithril trust-boundary and resets it on rollback.
+
+### 🙏 Thank You
+
+Thank you for trying!
+
+---
+
+
+## v0.28.0 (March 30, 2026)
+
+**Title:** Network-aware metrics and steadier block production
+
+**Date:** March 30, 2026
+
+**Version:** v0.28.0
+
+Hi folks! Here's what we shipped in v0.28.0.
+
+### ✨ What's New
+
+- **Network-labelled Prometheus metrics and build info:** Dashboard setup is easier because every Prometheus metric now carries a `network` label automatically, and a new `dingo_build_info` gauge exposes version, commit, and Go version at a glance.
+- **Tip gap and epoch gauges:** Sync monitoring is simpler because three new gauges track tip gap (wall-clock slot minus chain tip), Shelley genesis start time, and epoch length.
+- **Transaction metadata label index (Blockfrost):** Metadata queries are faster because a new transaction metadata label table powers indexed lookups with deterministic pagination and rollback-safe cleanup.
+
+### 💪 Improvements
+
+- **Smarter chain selection near tip:** Tip following is steadier because chain selection now prefers the actually-delivered chainsync tip over the advertised remote tip and sticks with the incumbent peer when two peers report the same frontier.
+- **Paginated DumpHistory (UTxO RPC):** Large history queries are more reliable because `DumpHistory` now uses a chain iterator with `next_token` pagination and sensible defaults when `max_items` is omitted.
+- **Leaner TxSubmission pipeline:** CPU usage under load is lower because the unnecessary rate limiter on the pull-based TxSubmission protocol was removed, eliminating a tight retry loop that starved chainsync and blockfetch.
+- **Leios protocols gated behind config:** Compatibility with non-Leios peers is more rock-solid because Leios mini-protocols are now only registered when `EnableLeios` is set, preventing muxer errors from peers that reject unknown protocols.
+
+### 🔧 Fixes
+
+- **Post-Mithril leader election:** Block production after a Mithril bootstrap is more reliable because `EpochNonce()` now falls through to the database when the in-memory nonce is empty, and `CaptureGenesisSnapshot()` falls back to the latest epoch start slot when slot 0 yields no pools.
+- **Forged-block rollback exemption:** Fork resolution after slot battles is correct because the rollback loop detector now exempts rollbacks through slots where the node forged a block.
+- **Richer UTxO RPC responses:** Script evaluation and data queries are more complete because `evalTx` now includes redeemer payloads and `readData` now returns parsed datums.
+
+### 📋 What You Need to Know
+
+- **Metrics dashboards:** If you run Prometheus dashboards, all metrics now include a `network` label — update your queries or selectors if you filter by metric name alone.
+- **Leios users:** If you use Leios mode, make sure `EnableLeios` is set in your configuration; the protocols are no longer registered by default.
+- **Default make target:** `make` no longer runs tests by default — use `make test` explicitly.
+
+### 🙏 Thank You
+
+Thank you for trying!
+
+---
+
+
 ## v0.27.7 (March 24, 2026)
 
 **Title:** Steadier sync and leaner storage

package/dingo.yaml.example

@@ -139,26 +139,26 @@ relayPort: 3001
 
 # Storage mode controls how much data is persisted.
 # - "core": Only consensus data (UTxOs, certs, pools, pparams). Suitable for
-#   block producers and relay nodes with no APIs enabled.
+#   block producers and relay nodes. API ports are ignored in core mode.
 # - "api": Core data plus full transaction metadata (witnesses, scripts, datums,
-#   redeemers). Required when any API is enabled.
-# APIs will refuse to start if storage mode is not "api".
+#   redeemers). All APIs start automatically on their default ports.
 #
 # Can be overridden with DINGO_STORAGE_MODE
 storageMode: "core"
 
-# API ports (0 = disabled, default)
-# All APIs require storageMode: "api"
+# API ports — only used when storageMode is "api".
+# In API mode, all APIs start on their default ports. Set a port to 0 to
+# disable an individual API.
 #
-# UTxO RPC gRPC API port
+# UTxO RPC gRPC API port (default: 9090)
 # Can be overridden with DINGO_UTXORPC_PORT
-utxorpcPort: 0
-# Blockfrost-compatible REST API port
+utxorpcPort: 9090
+# Blockfrost-compatible REST API port (default: 3000)
 # Can be overridden with DINGO_BLOCKFROST_PORT
-blockfrostPort: 0
-# Mesh (Coinbase Rosetta) REST API port
+blockfrostPort: 3000
+# Mesh (Coinbase Rosetta) REST API port (default: 8080)
 # Can be overridden with DINGO_MESH_PORT
-meshPort: 0
+meshPort: 8080
 
 # base url of bark archive server
 barkBaseUrl: ""
@@ -173,20 +173,21 @@ barkPort: 0
 # ---
 # Deployment pattern examples (uncomment one block):
 #
-# Relay node (core storage, no APIs):
+# Relay node (core storage, API ports ignored):
 #   storageMode: "core"
 #   blockProducer: false
 #
-# Data node (API storage, one or more API ports enabled):
+# Data node (all APIs start on defaults automatically):
 #   storageMode: "api"
-#   utxorpcPort: 9090
-#   blockfrostPort: 3100
+#   # Override individual ports or set to 0 to disable:
+#   # blockfrostPort: 3100
+#   # meshPort: 0            # disable Mesh API
 #   # With storageMode: "api", leave mode-sensitive Badger settings unset to keep:
 #   #   block-cache-size: 268435456
 #   #   index-cache-size: 0
 #   #   compression: true
 #
-# Validator / block producer (core storage, no APIs):
+# Validator / block producer (core storage, API ports ignored):
 #   storageMode: "core"
 #   blockProducer: true
 #   shelleyVrfKey: "/keys/vrf.skey"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinklabs/dingo",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "Dingo is a Cardano blockchain data node",
   "main": "index.js",
   "bin": {