@blinklabs/dingo 0.21.0 → 0.23.0

package/{devnet.sh → devmode.sh}

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-# Copyright 2025 Blink Labs Software
+# Copyright 2026 Blink Labs Software
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -21,11 +21,11 @@ export CARDANO_DEV_MODE=true
 
 DEBUG=${DEBUG:-false}
 
-conf=$(dirname $CARDANO_CONFIG)
+conf="$(dirname "$CARDANO_CONFIG")"
 now=$(date -u +%s)
-echo setting start time in $conf to $now
-sed -i -e "s/startTime\": .*,/startTime\": $now,/" $conf/byron-genesis.json
-sed -i -e "s/systemStart\": .*,/systemStart\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ --date=@$now)\",/" $conf/shelley-genesis.json
+echo "setting start time in $conf to $now"
+sed -i -e "s/startTime\": .*,/startTime\": $now,/" "$conf/byron-genesis.json"
+sed -i -e "s/systemStart\": .*,/systemStart\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ --date=@$now)\",/" "$conf/shelley-genesis.json"
 
 echo resetting .devnet
 rm -rf .devnet/*

package/dingo.yaml.example

@@ -33,6 +33,8 @@ database:
       # Path prefix within the bucket
       prefix: ""
     s3:
+      # AWS Endpoint
+      endpoint: ""
       # AWS S3 bucket name
       bucket: ""
       # AWS region
@@ -124,8 +126,64 @@ privatePort: 3002
 # Can be overridden with the port environment variable
 relayPort: 3001
 
-# TCP port to bind for listening for UTxO RPC
-utxorpcPort: 9090
+# 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.
+# - "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".
+#
+# Can be overridden with DINGO_STORAGE_MODE
+storageMode: "core"
+
+# API ports (0 = disabled, default)
+# All APIs require storageMode: "api"
+#
+# UTxO RPC gRPC API port
+# Can be overridden with DINGO_UTXORPC_PORT
+utxorpcPort: 0
+# Blockfrost-compatible REST API port
+# Can be overridden with DINGO_BLOCKFROST_PORT
+blockfrostPort: 0
+# Mesh (Coinbase Rosetta) REST API port
+# Can be overridden with DINGO_MESH_PORT
+meshPort: 0
+
+# base url of bark archive server
+barkBaseUrl: ""
+
+# number of slots from tip within which blocks
+# will not be found in the bark archive
+barkSecurityWindow: 10000
+
+# TCP port bind for listening for bark RPC calls
+barkPort: 0
+
+# ---
+# Deployment pattern examples (uncomment one block):
+#
+# Relay node (core storage, no APIs):
+#   storageMode: "core"
+#   blockProducer: false
+#
+# Data node (API storage, one or more API ports enabled):
+#   storageMode: "api"
+#   utxorpcPort: 9090
+#   blockfrostPort: 3100
+#
+# Validator / block producer (core storage, no APIs):
+#   storageMode: "core"
+#   blockProducer: true
+#   shelleyVrfKey: "/keys/vrf.skey"
+#   shelleyKesKey: "/keys/kes.skey"
+#   shelleyOperationalCertificate: "/keys/opcert.cert"
+#   # Optional forging tolerances (0 = defaults)
+#   forgeSyncToleranceSlots: 0
+#   forgeStaleGapThresholdSlots: 0
+#
+# Dev mode (isolated, forge blocks, no outbound):
+#   runMode: "dev"
+# ---
 
 # Ignore prior chain history and start from current tip (default: false)
 # This is experimental and may break — use with caution
@@ -136,6 +194,13 @@ intersectTip: false
 # Default: 1048576 (1 MB)
 mempoolCapacity: 1048576
 
+# Forging tolerances (0 = defaults)
+# forgeSyncToleranceSlots controls how far the local chain can lag the upstream
+# tip before forging is skipped. forgeStaleGapThresholdSlots controls when to
+# log an error if the chain tip is far ahead of the slot clock.
+forgeSyncToleranceSlots: 0
+forgeStaleGapThresholdSlots: 0
+
 # Operational mode: "serve" (default), "load", or "dev"
 # - serve: Full node with network connectivity (default)
 # - load: Batch import from ImmutableDB (requires immutableDbPath)
@@ -177,3 +242,43 @@ activePeersTopologyQuota: 0
 activePeersGossipQuota: 0
 # Active peer slots for ledger sources
 activePeersLedgerQuota: 0
+
+# Cache configuration for tiered CBOR cache system
+# This controls the in-memory caching of UTxO and transaction CBOR data
+cache:
+  # Number of entries in the hot UTxO cache (LFU eviction)
+  # Default: 50000
+  hotUtxoEntries: 50000
+  # Number of entries in the hot transaction cache (LFU eviction)
+  # Default: 10000
+  hotTxEntries: 10000
+  # Maximum memory in bytes for hot transaction cache
+  # Default: 268435456 (256 MB)
+  hotTxMaxBytes: 268435456
+  # Number of blocks to keep in the block LRU cache
+  # Default: 500
+  blockLruEntries: 500
+  # Number of recent blocks to warm up on startup
+  # Default: 1000
+  warmupBlocks: 1000
+  # Wait for cache warmup to complete before serving requests
+  # Default: true
+  warmupSync: true
+
+# Mithril snapshot bootstrap configuration
+# Use 'dingo mithril sync' or 'dingo sync --mithril' to bootstrap from a snapshot
+mithril:
+  # Enable Mithril integration (default: true)
+  enabled: true
+  # Override aggregator URL (auto-detected from network if empty)
+  # Supported networks: mainnet, preprod, preview
+  aggregatorUrl: ""
+  # Directory for downloading snapshot archives
+  # If empty, a randomized temporary directory is created automatically
+  # downloadDir: ""
+  # Remove temporary files after loading completes
+  # Default: true
+  cleanupAfterLoad: true
+  # Verify the Mithril certificate chain from snapshot back to genesis
+  # Default: true
+  verifyCertificates: true

package/docker-compose.yml

@@ -0,0 +1,51 @@
+# Dingo Cardano Node - Docker Compose Configuration
+#
+# Usage:
+#   docker compose up -d                        # Start with defaults (preview network)
+#   CARDANO_NETWORK=mainnet docker compose up -d # Start on mainnet
+#
+# With Mithril snapshot bootstrap (first run only):
+#   RESTORE_SNAPSHOT=1 docker compose up -d
+
+services:
+  # --------------------------------------------------------------------------
+  # Basic relay node
+  # --------------------------------------------------------------------------
+  dingo:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: ghcr.io/blinklabs-io/dingo:latest
+    restart: unless-stopped
+    environment:
+      - CARDANO_NETWORK=${CARDANO_NETWORK:-preview}
+      - CARDANO_DATABASE_PATH=/data/db
+      - DINGO_SOCKET_PATH=/ipc/dingo.socket
+      # Uncomment to enable debug logging
+      # - DINGO_DEBUG=1
+      # Uncomment to bootstrap from Mithril snapshot on first run
+      # - RESTORE_SNAPSHOT=1
+    ports:
+      # Ouroboros Node-to-Node (relay port)
+      - "3001:3001"
+      # Prometheus metrics (localhost only by default)
+      - "127.0.0.1:12798:12798"
+      # UTxO RPC (gRPC, localhost only by default)
+      - "127.0.0.1:9090:9090"
+    volumes:
+      # Persistent database storage
+      - dingo-data:/data/db
+      # Unix socket for cardano-cli and other NtC clients
+      - dingo-ipc:/ipc
+    healthcheck:
+      test: ["CMD", "wget", "-qO-", "http://127.0.0.1:12798/metrics"]
+      interval: 30s
+      timeout: 5s
+      start_period: 60s
+      retries: 3
+
+volumes:
+  dingo-data:
+    driver: local
+  dingo-ipc:
+    driver: local

package/package.json

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