Skip to content

v1.4.2

Latest
Latest

Choose a tag to compare

View all tags
@rdlrt rdlrt released this 14 Jul 13:16
v1.4.2
d10752b

Koios 1.4.2

This release focuses on bug fixes and accuracy improvements for governance-related endpoints (committee/pool voting summaries, HardForkInitiation handling), a couple of small output enhancements, and performance fixes for epoch/DRep queries , as well as compatibility with — following up on issues reported by the community since v1.4.0.

Caution

Please note that next major release of Koios (v1.5.x) will convert all lovelace fields back to numeric. Those who will need to access lovelace in string format can use server-side cast in URL (i.e. select=*,::text). For example:
https://api.koios.rest/api/v1/totals?select=epoch_no,treasury::text

API Docs and Schedule for Release

Network Date (Estimated) UTC URL Specs Release gRest Instance Release DBSync Node
Preview 14-06-2025 https://preview.koios.rest/ v1.4.2 koios-1.4.2 13.7.2.1 11.0.1
PreProd 14-06-2025 https://preprod.koios.rest/ v1.4.2 koios-1.4.2 13.7.2.1 11.0.1
Mainnet* 17-06-2025 https://api.koios.rest/ v1.4.2 koios-1.4.2 13.7.2.1 11.0.1

Mainnet dates may shift if any issues emerge.

Changes for API

Expand

🔄 Input / Output Enhancements

  • Proposal List (/proposal_list): Added previous_gov_action_proposal_id field.
  • DRep Info (/drep_info): Added live_delegator_count field, plus an extra index on voting_procedure to address a performance issue observed on preprod.
  • Pool List (/pool_list): Added a temporary pathway to query as numeric without introducing a breaking change (mitigation for request-size/413 issue below).
  • Specs: Added documentation for the error messages returned when request-body size limits are hit.
    • Commit: e5335dd (related to #413 — undocumented request body limit causing 413s on /pool_info and /drep_info at ~6 KB / ~100 ids)

🛠️ Chores & Performance

  • HardForkInitiation Pool Votes: Fixed proposal_voting_summary incorrectly reporting >50% yes for pool votes on recent HardForkInitiation proposals (more accurate figure is in the 30s) — always_abstain delegation logic doesn't apply to hard-fork gov actions the same way; pools not actively voting are now correctly counted as "no" voting power.
  • Committee Vote Calculation: Fixed committee vote % calculation to only join on the latest committee registration record and disregard resigned members when computing total committee size (numerator/denominator were both off for proposals like the ratified Tweag one).
  • Pool Retirement Trigger: Fixed retiring-pool updates and the retired-status trigger; relocated the trigger to epoch_state (since epoch moved from table to view), and added handling for simplistic pool schedule retirement actions. Also corrected the epoch_no return type in proposal_voting_summary.
  • Epoch Calculation Performance: Switched max-epoch calculation to use max(epoch_no) from epoch_param instead of the new epoch view, due to performance regressions.
  • Cache Maintenance: Updates to pool_info_cache.sql, epoch_info_cache.sql, and drep_info.sql.
  • Specs: Reorganized specs into a more modular structure.

Full Changelog can be found here for SQL queries and Specs.

Instructions for Instance Providers

Expand

If you're setting up as a new instance provider, you can find instructions here. The tag to use for setup-grest.sh is koios-1.4.2.

The update process, as usual, would be:

  1. Update your node, submitapi, dbsync and ogmios binaries. You can use the sample below as a reference (change network and top folder according to your environment):
./guild-deploy.sh -n $NETWORK -t cnode -b koios-1.4.2 -s plfdom
  1. With dbsync updated and on tip, you'd now be ready to go to the next step - updating koios. You'd want to update all components and reset your grest schema, sample command below:
./setup-grest.sh -b koios-1.4.2 -r -i prmcdg
sudo systemctl restart cnode-postgrest cnode-haproxy

The configs have been updated across versions, please ensure to force overwrite and re-download each component

Since we're rebuilding the cache, expect it to take a bit (a few minutes on non-mainnet, while a few hours on mainnet).

Other Notes

Expand

Bug Reports/Feature Requests

Everyone is invited to create future feature requests here to help us triage issues.

Support/Discussions Group

Please ensure to join the Koios Support/Discussions group.
We're open to having meetings to work together as well as discuss future additions. Feel free to ask.

Contributors

We are blessed to have a community that contributes in various ways, be it by serving community instances, library implementations, testing, or feedback. Special thanks to all the contributors who have been helping us improve the query layer along the way:
@Scitz0, @rdlrt, @dostrelith678, @redoracle, @hodlonaut, @reqlez, @huths0lo, @chadle-git, @gufmar, @ray-wallet, @edridudi, @mkungla, @xray-robot, @nothingalike, @safestak-keith, @QuixoteSystems, @abdelkrimdev, @cardano-apexpool , @AlexDochioiu, @DCOneCrypto, @PatrickTobler, @agaffney, @rcmorano, @gitmachtl, @Crypto2099, @robinboening, @fallen-icarus, @M4rc0Russ0, @HT-Moh, @ducpm2303, @michele-nuzzi, @maxee, @Jack-0, @larestrepo, @MadOrkestra, @mpizenberg, @quinn-logicalmechanism, @DevStakePool

Contributors

rcmorano, robinboening, and 35 other contributors
Assets 2
Loading