Releases: IntersectMBO/cardano-db-sync
13.7.0.3
DB Sync 13.7.0.3
DB Sync 13.7.0.3 supports node version 10.7.1. It provides major performance improvements in speed and memory. It supports LSM (experimentally for now), which brings memory requirements down to ~6 GB.
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 | TODO |
| 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/13.7.0.3/CHANGELOG.md#13703
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 compatiblesnapshot-converteris shipped with node-10.7.1. --bootstrap-tx-outis 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
- Linux 64-bit
- Docker image
- Requires
ghc-9.6.xto build
Sign-off
| Role | Approval |
|---|---|
| Technical Lead | 🟢 |
| Intersect TSC | 🟢 |
| Intersect Product Committee | 🟢 |
| Test Engineer | 🟢 |
| Site Reliability Engineer |
13.7.0.2
DB Sync 13.7.0.2 supports node 10.7.1 and fixes an issue related to slow rollbacks #2083. It may be compatible with newer node versions or slightly older versions like 10.7.0, 10.6.2. It supports forking to PV11.
Upgrading
Upgrading from 13.7.0.1 may require a ledger state replay from genesis. The database migration is minimal.
Upgrading from 13.6.x.x requires a ledger state replay from genesis. The database migration is minimal (see files migration-2-0045-20250708.sql, migration-2-0046-20250223.sql, migration-4-0009-20250223.sql).
The release is compatible with both 13.7 and13.6 snapshots. These can be found at:
| Network | Link to snapshot |
|---|---|
| Mainnet-13.7 | TODO |
| 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/13.7.0.2/CHANGELOG.md#13702
Notes
When running db-sync make sure you enable only the data that you need. This can be configured in the db-sync config file as documented in configuration.md.
Platforms
- Linux 64-bit
- Docker
Requiresghc-9.6.xto build.
Sign off
| Role | Approval |
|---|---|
| Technical Lead | 🟢 |
| Intersect TSC | |
| Intersect Product Committee | |
| Test Engineer | |
| Site Reliability Engineer | 🟢 |
Cardano DB Sync 13.6.0.7
DB Sync 13.6.0.7 fixes an issue related to slow rollbacks #2083
| Network | Link to snapshot |
|---|---|
| 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/13.6.0.7/CHANGELOG.md#13607
Notes
When running db-sync make sure you enable only the data that you need. This can be configured in the db-sync config file as documented in configuration.md.
Platforms
- Linux 64-bit
- Docker
Requiresghc-8.10.xto build.
Sign off
| Role | Approval |
|---|---|
| Technical Lead | 🟢 |
| Intersect TSC | 🟢 |
| Intersect Product Committee | 🟢 |
| Test Engineer | 🟢 |
| Site Reliability Engineer | 🟢 |
13.7.0.1
DB Sync 13.7.0.1 is compatible with Node 10.6.2 and potentially newer versions. It supports forking to PV11 and is intended for testing on Sanchonet and other testnets.
Upgrading
Upgrading from 13.6.x.x and compatibility with existing snapshots is possible in principle, but this has not yet been tested.
Changelog
https://github.com/IntersectMBO/cardano-db-sync/blob/13.7.0.1/CHANGELOG.md#13701
Notes
When running db-sync make sure you enable only the data that you need. This can be configured in the db-sync config file as documented in configuration.md.
Platforms
- Linux 64-bit
- Docker
Requiresghc-9.6.xto build.
Sign off
| Role | Approval |
|---|---|
| Technical Lead | 🟢 |
| Intersect TSC | |
| Intersect Product Committee | |
| Test Engineer | |
| Site Reliability Engineer |
Cardano DB Sync 13.7.0.0
Pre-release 13.7.0.0
13.6.0.6-NOT RELEASED
DBSync 13.6.0.6 is a hotfix release. It is compatible with node-10.3.1 and later
Upgrading from older 13.6.0.5 db-sync instance doesn't require a resync from genesis. It may require a ledger replay
The release is compatible with both 13.6. These can be found at:
| Network | Link to snapshot |
|---|---|
| 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/13.6.0.6/CHANGELOG.md#13606
Notes
When running db-sync make sure you enable only the data that you need. This can be configured in the db-sync config file as documented in configuration.md.
Platforms
- Linux 64-bit
- Docker
Requiresghc-8.10.xto build.
Sign off
| Role | Approval |
|---|---|
| Technical Lead | 🟢 |
| Intersect TSC | |
| Intersect Product Committee | |
| Test Engineer | |
| Site Reliability Engineer |
Cardano DB Sync 13.6.0.5
DB Sync 13.6.0.5 fixes minor issues. It is compatible with node-10.1.4 and later
Upgrading from older 13.5.x.x db-sync instance requires a ledger state replay from genesis. This doesn't affect the database.
The release is compatible with both 13.6 and 13.5 snapshots. These can be found at:
| Network | Link to snapshot |
|---|---|
| Mainnet-13.6 | https://update-cardano-mainnet.iohk.io/cardano-db-sync/index.html#13.6/ |
| Mainnet-13.5 | https://update-cardano-mainnet.iohk.io/cardano-db-sync/index.html#13.5/ |
Changelog
https://github.com/IntersectMBO/cardano-db-sync/blob/13.6.0.5/CHANGELOG.md#13605
Notes
When running db-sync make sure you enable only the data that you need. This can be configured in the db-sync config file as documented in configuration.md.
Platforms
- Linux 64-bit
- Docker
Requiresghc-8.10.xto build.
Sign off
| Role | Approval |
|---|---|
| Technical Lead | 🟢 |
| Intersect TSC | 🟢 |
| Intersect Product Committee | 🟢 |
| Test Engineer | 🟢 |
| Site Reliability Engineer | 🟢 |
Cardano DB Sync 13.6.0.4
It is required that users upgrade to this version of db-sync.
DB Sync 13.6.0.4 is a mainnet-ready release that is capable of crossing the Chang#2 hard fork. It is compatible with node-10.1.4. This update addresses a ledger issue where DRep delegations could be removed under some conditions.
Upgrading from older 13.5.x.x db-sync instance requires a ledger state replay from genesis. This doesn't affect the database.
The release is compatible with both 13.6 and 13.5 snapshots. These can be found at:
| Network | Link to snapshot |
|---|---|
| Mainnet-13.6 | https://update-cardano-mainnet.iohk.io/cardano-db-sync/index.html#13.6/ |
| Mainnet-13.5 | https://update-cardano-mainnet.iohk.io/cardano-db-sync/index.html#13.5/ |
Changelog
https://github.com/IntersectMBO/cardano-db-sync/blob/13.6.0.4/CHANGELOG.md#13604
Known issues
For networks that were already in Protocol Version 10 (e.g. Preview and PreProd) before the upgrade to this release, the values of drep_distribution before the upgrade are not well defined and could be slightly different between different executions. This shouldn't have any cascading effect. For these networks it is advised to delete all ledger state files and let the ledger rules replay from genesis. You can read more about this issue here,
Documentation
Cardano DB Sync Overview
Building and Running the Cardano DB Sync Node
Schema Management
State snapshot
Smash
Postgres setup
It is advised to use a postgres version >= 14. The default docker postgres has been upgraded to 14.10-alpine.
There is a postgres requirement for users that don't use docker-compose and have to manually configure postgres:
It is advised to increase `maintenance_work_mem` from the Postgres configuration to 0.5GB - 1GB (the default is 64MB).
Also use the default (2) or higher for `max_parallel_maintenance_workers` (this parameter was introduced in `postgres` version 11)
Notes
When running db-sync make sure you enable only the data that you need. This can be configured in the db-sync config file as documented in configuration.md.
Platforms
- Linux 64-bit
- Docker
Requiresghc-8.10.xto build.
Sign off
| Role | Approval |
|---|---|
| Technical Lead | 🟢 |
| Cardano Head of Engineering | 🟢 |
| Cardano Head of Product | 🟢 |
| Test Engineer | 🟢 |
| Site Reliability Engineer | 🟢 |
13.6.0.3-consumed
kderme
Kostas Dermentzis
Fixes an issue with migration from 13.5.0.x when the consumed_tx_out config is enabled
Cardano DB Sync 13.6.0.2
This release is compatible with node-10.1.2 and supports the Chang#2 HF in mainnet. It fixes an issue of 13.6.0.1 where rollbacks were too slow.
Upgrading from any 13.5.x.x db-sync instance requires a ledger state replay from genesis. This doesn't affect the database.
It is compatible with 13.6 and 13.5 snapshots. They can be found at:
| Network | Link to snapshot |
|---|---|
| Mainnet-13.6 | https://update-cardano-mainnet.iohk.io/cardano-db-sync/index.html#13.6/ |
| Mainnet-13.5 | https://update-cardano-mainnet.iohk.io/cardano-db-sync/index.html#13.5/ |
Changelog
https://github.com/IntersectMBO/cardano-db-sync/blob/13.6.0.2/CHANGELOG.md#13602
Documentation
Cardano DB Sync Overview
Building and Running the Cardano DB Sync Node
Schema Management
State snapshot
Smash
Postgres setup
It is advised to use a postgres version >= 14. The default docker postgres has been upgraded to 14.10-alpine.
There is a postgres requirement for users that don't use docker-compose and have to manually configure postgres:
It is advised to increase `maintenance_work_mem` from the Postgres configuration to 0.5GB - 1GB (the default is 64MB).
Also use the default (2) or higher for `max_parallel_maintenance_workers` (this parameter was introduced in `postgres` version 11)
Notes
When running db-sync make sure you enable only the data that you need. This can be configured in the db-sync config file as documented here configuration.md
Platforms
- Linux 64-bit
- Docker
Requiresghc-8.10.xto build.
Sign off
| Role | Approval |
|---|---|
| Technical Lead | 🟢 |
| Cardano Head of Engineering | 🟢 |
| Cardano Head of Product | 🟢 |
| Test Engineer | 🟢 |
| Site Reliability Engineer | 🟢 |