Release Notes - v0.87.0
v0.87.0
Section titled “v0.87.0”Title: Improve resource safety, networking, and consensus compatibility
Version: v0.87.0
Release: v0.87.0
Comparison: v0.86.0…v0.87.0
Dingo v0.87.0 improves resource controls, peer networking, synchronization safety, API behavior, configuration security, and consensus compatibility.
Recommended Network Compatibility ⚠️
Section titled “Recommended Network Compatibility ⚠️”| Network | Compatible |
|---|---|
| mainnet | ⛔ |
| preprod-testnet | ✅ |
| preview-testnet | ✅ |
| musashi | ✅ |
Breaking changes
Section titled “Breaking changes”- Limited UTxO RPC
FollowTiphistorical replay with process and per-client concurrency limits, pacing, and history budgets. The service now returnsResourceExhaustedwhen demand reaches a configured limit. - Added DMQ peer listener, topology, and minimum and maximum peer settings through YAML, environment variables, and CLI options. Dingo validates these settings before startup.
- Returned retriable HTTP
503from Mesh mempool listings when a pool exceeds its configured capacity instead of returning an incomplete prefix; listings now return transaction hashes only and enforce bounded concurrency. - Changed Blockfrost address summaries to honor cancellation, limit enrichment, and return HTTP
400when requests exceed their budget or HTTP429when demand reaches capacity. - Bound generated devnet APIs to loopback and blocked state, key, and file operations from following symlink redirection.
- Updated only Musashi: v0.87.0 includes the
rc-2026w42respin with new bundled Byron and Shelley genesis hashes. These changes make the existing Musashi chain database incompatible, so operators must remove the configured database and resynchronize from a fresh Mithril snapshot or from genesis.
Security and reliability
Section titled “Security and reliability”- Authenticated token registry archive size and digest before Dingo parses gzip and tar contents.
- Validated local ImmutableDB block body hashes before importing blocks.
- Restricted decompressed Mithril tar stream consumption and honored cancellation during processing.
- Refused MCP reads while the metadata SQLite write-ahead log exceeded
128 MiB, then resumed reads after recovery. - Normalized Leios announcement headers for deduplication and semantic validation while preserving the bytes used for relay.
APIs, synchronization, and integrations
Section titled “APIs, synchronization, and integrations”- Updated
google.golang.org/apitov0.304.0and refreshed related dependencies. - Corrected future epoch genesis overlay parameter forecasting during from-genesis synchronization.
- Required one Byron witness for every transaction input.
- Refreshed the AWS SDK configuration and related modules.
- Expanded Bark
ArchiveServicewith configurable global and per-caller lookup budgets; the service returnsRESOURCE_EXHAUSTEDbefore a cloud lookup would exceed a budget.
Storage, consensus, and security
Section titled “Storage, consensus, and security”- Rebuilt SQLite and PostgreSQL UTXO spender indexes as non-null partial indexes while leaving MySQL unchanged.
- Introduced a selectable consensus provider with Praos as the default, persisted the provider identity, and rejected schedules that do not match that identity.
- Moved ledger waits outside locks and bounded deferred header verification with revalidation when Dingo applies the header.
- Pinned Go to
1.26.10for thecrypto/x509security fix. - Verified competing fork headers with fork-derived candidate nonces and withheld unauthenticated ancestry without recycling peers.
Additional changes
Section titled “Additional changes”- Updated the Go build image to
ghcr.io/blinklabs-io/go:1.27.3-1, refreshed runtime images and Debian snapshot pins, and updated the devnet and ERAcardano-nodepins. - Corrected
GetPoolDistr2andGetStakeDistribution2CBOR tag24encoding to use the barePoolDistrlayout; decoders must use that layout for these responses. - Added file-backed secret values through
_FILECLI and environment inputs, with validation, precedence, and conflict rules for Koios and node parity inputs; invalid or conflicting configuration now fails closed. - Queued deferred headers that extend the local chain and waited for unapplied local work before admitting blocks within the forecast horizon.
- Waited for unapplied ancestors before forged block self-validation and dropped unjudged blocks when Dingo could not reach the parent.
- Improved ChainSync, LocalStateQuery, and
GetUTxOWholeavailability under synchronization load.GetUTxOWholenow returns a complete UTxO result through paged as-of reads, rollback retries, and snapshot detach and reattach; node-to-client roll-forwards wait for ledger application, tip snapshots defer during epoch boundary work, and chain selection records refused advertised tips for corroboration. - Resynchronized without penalizing peers when forecast horizon admission finds no local work to process.
- Authenticated local Bark snapshot manifests with the configured trust key, used an authenticated cloud mirror when needed, and failed closed when neither source passed verification.
- Preserved Alonzo
extraConfigcost models across Conway and Dijkstra, refreshed Musashirc-2026w42configurations, enabled node-managed Mithril v2 synchronization throughmithril.enabled, applied Dijkstrablock_transactionandis_validhandling to Leios, optimized rollback stake lookup, and refreshed gouroboros integration. - Sanitized tracing endpoint errors by removing credentials from userinfo, query, and fragment components.
- Added regression coverage for DRep pending deregistration so the node preserves correct registration state during that transition.
- Exposed validated certified Leios endorser block transactions consistently through Blockfrost and UTxO RPC, returning validation errors for missing or inconsistent data and honoring context cancellation.
- Hardened node parity from-genesis preprod validation with epoch oracle lookup, session and reconnect handling, retries, LocalStateQuery ingress backpressure, a single-message ChainSync pipeline, and Koios timeouts.
- Removed Mithril v1 backend support, so v1 configuration and pins no longer work; bootstrap now uses v2 only and fails closed when verified ancillary state or digests are missing.
- Redacted credentials from remote ImmutableDB load URLs in query strings, fragments, userinfo, wrapped errors, and
errors.Asresults. - Validated DMQ topology JSON at startup, logged distinct peers, warned when no peers were configured, and warned while ignoring unsupported fields.
- Ignored unverified advertised fork heights when breaking chain-selection ties.
- Expanded bounded stale-reference corroboration to include peer references ahead of the local tip within twice the security parameter.
- Enabled ledger signature validation ahead by default and added
ledgerValidateAheadEnabledcontrol through YAML, environment variables, and CLI options. - Moved downstream Homebrew, Ansible, cardano-up, and Helm consumer updates from
publish.ymltorelease-fanout; release propagation now follows the dedicated fanout workflow. - Bounded MCP
get_mempool_infowith a default limit of10, a maximum of50, and retained-byte accounting. - Honored Cardano
ConsensusModePraosModeby disabling Genesis chain selection for Musashi. - Prevented same-block batched live stake from being counted more than once.
- Constrained LeiosVotes
RequestNextvalues to the inclusive range1through1000. - Introduced bounded and cancellable Mesh
/account/coinsreads with cursor pagination. Clients must request pagination when a complete result does not fit one response; otherwise, the service returns HTTP400, and concurrency exhaustion returns HTTP503. - Corrected Byron version-triggered boundary handling so it cannot skip Shelley.
- Limited MCP
get_asset_infoscans to50,000rows and shared a four-slot read budget across requests.
Docs authored by Doc Holiday