@blinklabs/dingo 0.28.0 → 0.29.1

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
@@ -209,6 +208,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 +314,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
@@ -436,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,89 @@
 # Release Notes
 
 
+## 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

@@ -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: ""
@@ -128,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: ""
@@ -162,21 +173,31 @@ 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"
 #   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.28.0",
+  "version": "0.29.1",
   "description": "Dingo is a Cardano blockchain data node",
   "main": "index.js",
   "bin": {