@blinklabs/dingo 0.27.7 → 0.29.0

package/README.md

@@ -209,6 +209,8 @@ CARDANO_BLOCK_PRODUCER=true \
   ./dingo
 ```
 
+When `storageMode=core`, the Badger blob store defaults to mmap-only settings: `block-cache-size=0`, `index-cache-size=0`, and `compression=false`. When `storageMode=api`, the default Badger profile is `block-cache-size=268435456`, `index-cache-size=0`, and `compression=true`. YAML, environment variable, and CLI Badger options override those defaults only when explicitly set.
+
 See `dingo.yaml.example` for the full set of configuration options.
 
 ## Fast Bootstrapping with Mithril
@@ -313,8 +315,11 @@ BadgerDB Options:
 - `data-dir` - Directory for database files
 - `block-cache-size` - Block cache size in bytes
 - `index-cache-size` - Index cache size in bytes
+- `compression` - Enable Snappy compression
 - `gc` - Enable garbage collection
 
+Leave the mode-sensitive Badger settings unset if you want Dingo's storage-mode defaults. `storageMode=core` uses `block-cache-size=0`, `index-cache-size=0`, and `compression=false`; `storageMode=api` uses `block-cache-size=268435456`, `index-cache-size=0`, and `compression=true`.
+
 Google Cloud Storage Options:
 - `bucket` - GCS bucket name
 - `project-id` - Google Cloud project ID

package/RELEASE_NOTES.md

@@ -1,6 +1,47 @@
 # Release Notes
 
 
+## v0.27.7 (March 24, 2026)
+
+**Title:** Steadier sync and leaner storage
+
+**Date:** March 24, 2026
+
+**Version:** v0.27.7
+
+Hi folks! Here’s what we shipped in v0.27.7.
+
+### ✨ What's New
+
+- **Configurable network ID:** Connecting to the right Cardano network is more rock-solid because you can now set the network identifier in configuration.
+- **Optional blob-store compression:** Disk usage can be lower because you can now enable compression for blob storage in some environments.
+- **Devnet transaction pump:** Testing transaction flow is easier because development networks now include an additional transaction pump service.
+
+### 💪 Improvements
+
+- **More stable chain following:** Sync is more rock-solid because chain following and recovery is now more stable during tip changes and temporary peer issues.
+- **Safer rollbacks and replay:** Reorg handling is more predictable because rollback and ledger replay behavior is now safer.
+- **Lighter rewind pruning:** Larger cleanups are smoother because rewind and pruning operations now put less pressure on storage backends.
+- **Stickier best-peer selection:** Peer churn can be lower because peer selection now better preserves stable connections when multiple peers report equivalent tips.
+
+### 🔧 Fixes
+
+- **More consistent blob deletion:** Cleanup is more reliable because blob deletion now better matches transaction behavior.
+- **Graceful missing-blob recovery:** Processing is more resilient because missing blob data is now handled more gracefully in some cases.
+
+### 📋 What You Need to Know
+
+- **Multi-network deployments:** If you run against different Cardano networks, review your config to ensure the correct network is selected.
+- **Docker builds:** If you rely on custom Docker build caching, Docker builds may behave differently.
+- **Tooling refreshes:** Routine updates to build tooling and libraries may land as part of keeping the project secure and compatible.
+
+### 🙏 Thank You
+
+Thank you for trying!
+
+---
+
+
 ## v0.27.5 (March 19, 2026)
 
 **Title:** Faster UTxO lookups and steadier sync

package/dingo.yaml.example

@@ -1,5 +1,7 @@
 # Example config file for dingo
-# The values shown below correspond to the in-code defaults
+# The values shown below correspond to the in-code defaults unless a
+# setting is left commented out to preserve a storage-mode-specific
+# runtime default.
 
 # Public bind address for the Dingo server
 bindAddr: "0.0.0.0"
@@ -19,12 +21,21 @@ database:
     badger:
       # Data directory for BadgerDB storage
       data-dir: ".dingo/badger"
-      # Block cache size in bytes (default: 1610612736 ~1.5GB)
-      block-cache-size: 1610612736
-      # Index cache size in bytes (default: 536870912 ~512MB)
-      index-cache-size: 536870912
+      # Block cache size in bytes.
+      # Leave unset to use the storage-mode default:
+      # - 0 when storageMode: "core"
+      # - 268435456 (256MB) when storageMode: "api"
+      # block-cache-size: 0
+      # Index cache size in bytes.
+      # Leave unset to use the runtime default (0 in both core and api modes).
+      # index-cache-size: 0
       # Enable garbage collection (default: true)
       gc: true
+      # Enable Snappy compression.
+      # Leave unset to use the storage-mode default:
+      # - false when storageMode: "core"
+      # - true when storageMode: "api"
+      # compression: false
     gcs:
       # Google Cloud Storage bucket name
       bucket: ""
@@ -170,6 +181,10 @@ barkPort: 0
 #   storageMode: "api"
 #   utxorpcPort: 9090
 #   blockfrostPort: 3100
+#   # 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):
 #   storageMode: "core"
@@ -177,6 +192,11 @@ barkPort: 0
 #   shelleyVrfKey: "/keys/vrf.skey"
 #   shelleyKesKey: "/keys/kes.skey"
 #   shelleyOperationalCertificate: "/keys/opcert.cert"
+#   # With storageMode: "core", Badger blob defaults switch to mmap-only:
+#   #   block-cache-size: 0
+#   #   index-cache-size: 0
+#   #   compression: false
+#   # You can still override any of those explicitly under database.blob.badger.
 #   # Optional forging tolerances (0 = defaults)
 #   forgeSyncToleranceSlots: 0
 #   forgeStaleGapThresholdSlots: 0

package/package.json

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