github IntersectMBO/cardano-db-sync 13.7.0.5

pre-release5 hours ago

DB Sync 13.7.0.5

DB Sync 13.7.0.5 supports node version 11.0.1 and the PV11 intra-era hard fork. It's a minor fix and version update over 13.7.0.4.

For Linux, liburing, protobuf-compiler, and snappy-c are new dependencies.

Upgrading

Upgrading from older versions (13.6, 13.7) is possible with minor changes
to the database (see migration-2-0045-20250708.sql, migration-2-0046-20250223.sql, migration-2-0047-20260421.sql, migration-4-0009-20250223.sql).

The ledger snapshot format has changed and is now fully compatible with cardano-node. Upgrading requires a ledger replay from genesis. You will see log lines such as:

Migrating: removing <N> old .lstate snapshots

followed by a replay that takes a few hours.

Snapshots

The release is compatible with both 13.7 and 13.6 DB snapshots:

Network Link
Mainnet 13.7 https://update-cardano-mainnet.iohk.io/cardano-db-sync/index.html#13.7/
Mainnet 13.6 https://update-cardano-mainnet.iohk.io/cardano-db-sync/index.html#13.6/

Changelog

https://github.com/IntersectMBO/cardano-db-sync/blob/release/13.7.0.5/CHANGELOG.md#13705

LSM (experimental)

  • Enable by setting "ledger_backend": "lsm" in the db-sync config — see config docs.
  • Snapshots can be converted between InMemory and LSM with snapshot-converter — see snapshot docs.
    The compatible snapshot-converter is shipped with node-11.0.1.
  • --bootstrap-tx-out is not supported with LSM.

Notes

When running db-sync, enable only the data you actually need. This is
configured in the db-sync config file — see config docs.

Platforms

Known issues (same as cardano-node)

  • When using the LSM storage backend, db-sync cannot read blocks with more than 4096 items due to a bug in blockio-uring. This issue already has a fix that will be included into the next release.
  • When using the LSM storage backend, db-sync could crash due to how ghc handles system threads. This only happens on resource-constrained devices such as the Raspberry Pi. The fix will be shipped in the next release.
  • When using the LSM storage backend, the CPU idle time is reported as iowait. This is not a performance or correctness issue, but it may be confusing. The fix will be shipped in the next release.

Sign-off

Role Approval
Technical Lead 🟢
Intersect TSC
Intersect Product Committee
Test Engineer
Site Reliability Engineer

Don't miss a new cardano-db-sync release

NewReleases is sending notifications on new releases.