@blinklabs/dingo 0.35.3 → 0.36.1

package/CLAUDE.md

@@ -0,0 +1,33 @@
+# CLAUDE.md
+
+Go-based Cardano node implementing Ouroboros. Most of what you need is derivable from code (`Makefile`, `go.mod`, `node.go`, `dingo.yaml.example`). Below is what isn't.
+
+## Testing rules
+
+- **Never use `time.Sleep()` for synchronization.** Use helpers in `internal/test/testutil/`:
+  - `WaitForCondition` / `require.Eventually` for polling (2–5s timeout, 5–10ms interval, lock shared state inside the condition fn)
+  - `RequireReceive` / `RequireNoReceive` for channel assertions
+  - `context.WithTimeout` for graceful shutdown — not sleep
+- Race detection is on by default in `make test`.
+- Integration tests in `internal/integration/` load real blocks from `database/immutable/testdata/`.
+
+## Before committing
+
+```bash
+golangci-lint run ./...   # .golangci.yml configured
+nilaway ./...
+modernize ./...           # --fix to auto-apply
+```
+
+## Non-obvious architecture
+
+- **CBOR offset storage**: UTxOs/txs store 52-byte `CborOffset` refs (magic `"DOFF"`, slot, hash, offset, length), not full CBOR. Resolved via `TieredCborCache` (hot → block LRU → cold extract from blob store). See `database/cbor_offset.go`, `database/cbor_cache.go`, `database/block_indexer.go`.
+- **Plugins** (`database/plugin/`): blob = `badger` (default) / `gcs` / `s3`; metadata = `sqlite` (default) / `mysql` / `postgres`.
+- **Event bus**: components communicate via `event.EventBus.SubscribeFunc()`, not direct calls.
+
+## Profiling
+
+```bash
+./dingo --cpuprofile=cpu.prof --memprofile=mem.prof load database/immutable/testdata
+go tool pprof cpu.prof
+```

package/RELEASE_NOTES.md

@@ -1,6 +1,83 @@
 # Release Notes
 
 
+## v0.36.0 (April 20, 2026)
+
+**Title:** Asset endpoints and steadier chain operations
+
+**Date:** April 20, 2026
+
+**Version:** v0.36.0
+
+Hi folks! Here’s what we shipped in v0.36.0.
+
+### ✨ What's New
+
+* Added **asset queries for Blockfrost API users:** Blockfrost API users can now query native assets through `/api/v0/assets/{asset}` with the combined asset identifier format.
+* Expanded **era transition visibility:** Era history now shows confirmed upcoming change points more clearly, so slot and time forecasts stay aligned with known transitions.
+* Clarified **safe epoch boundaries:** Era history now reports when an era change cannot happen in the current epoch, which makes forecast results steadier near the epoch boundary.
+
+### 💪 Improvements
+
+* Improved **contributor setup guidance:** Development work is easier to follow because the project now includes clearer guidance for testing, architecture, and profiling.
+* Refreshed **build cache stability:** Automation now uses a newer cache action release for steadier build runs.
+* Updated **protocol support alignment:** Network compatibility stays current with newer upstream protocol updates.
+* Modernized **operator tooling support:** Operational workflows stay aligned with newer Cardano command line tooling.
+* Streamlined **era rollover handling:** Era changes now follow one transition path, which makes chain operations more consistent during rollovers.
+* Restored **release history continuity:** Recent changes stay easier to scan in one place through the updated release notes.
+
+### 🔧 Fixes
+
+* Fixed **single relay sync stalls:** Single-relay block producers now keep chain progress steadier when the relay reconnects first after an interruption.
+* Hardened **ledger startup safeguards:** Startup and rollback related paths now stop immediately when the Ouroboros security parameter K is missing or zero.
+* Corrected **fork recovery error reporting:** Fork recovery now returns ancestor lookup failures directly, which makes recovery issues easier to detect.
+* Prevented **Blockfrost startup crashes:** Blockfrost startup now returns a clear error when ledger state is missing instead of crashing.
+* Set **forged block version markers:** Forged blocks now carry the expected minor protocol version for steadier interoperability.
+
+### 📋 What You Need to Know
+
+* Blockfrost API users can now query native assets through /api/v0/assets/{asset} using the concatenated {policy_id}{asset_name_hex} identifier format.
+* Operators should ensure ledger initialization provides a positive Ouroboros security parameter K, because startup and rollback-related paths now fail fast when K is unset or zero.
+* Most users can upgrade normally to v0.36.0; single-relay block producers should see steadier sync behavior, and Blockfrost startup now reports missing ledger state as an error instead of panicking.
+
+### 🙏 Thank You
+
+Thank you for trying!
+
+---
+
+## v0.35.3 (April 19, 2026)
+
+**Title:** Improve peer sharing compatibility
+
+**Date:** April 19, 2026
+
+**Version:** v0.35.3
+
+Hi folks! Here’s what we shipped in v0.35.3.
+
+### ✨ What's New
+
+* Noted **no new features:** This patch focuses on improvements and fixes.
+
+### 💪 Improvements
+
+* Refined **release history continuity:** RELEASE_NOTES.md now stays up to date, so recent changes are easier to scan in one place.
+
+### 🔧 Fixes
+
+* Corrected **safer peer sharing behavior:** Dingo now avoids asking peers to share more peers when they do not offer that capability, so connections stay steadier and compatibility is smoother across mixed peer setups.
+
+### 📋 What You Need to Know
+
+* Simplified **upgrade guidance:** Most users only need to upgrade to v0.35.3, and peer sharing now behaves more safely with peers that do not advertise sharing.
+
+### 🙏 Thank You
+
+Thank you for trying!
+
+---
+
 ## v0.35.2 (April 18, 2026)
 
 **Title:** Safer era forecasts and refreshed dependencies

package/package.json

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