Skip to content

Koios gRest v1.0.8

Pre-release
Pre-release
Compare
Choose a tag to compare
@rdlrt rdlrt released this 06 Oct 23:28
80936ee

Koios 1.0.8

This is a minor update that primarily focuses on bugfixes for changes introduced in koios-1.0.7 - thanks to reports from excellent community ⭐.

API Docs and Schedule for release:

The schedule for monitoring layers to apply update, as well as live documentation can be browsed as per table below:

Network Date URL Specs Release gRest Instance Release DBSync Node
GuildNet 05-10-2022 08:00 UTC https://guild.koios.rest/ v1.0.8 koios-1.0.8 13.0.5 1.35.3
Testnet 06-10-2022 20:00 UTC https://testnet.koios.rest/ v1.0.8 koios-1.0.8 13.0.5 1.35.2
Mainnet 08-10-2022 20:00 UTC https://api.koios.rest/ v1.0.8 koios-1.0.8 13.0.5 1.35.3
PreProd < Awaiting reset date from IO>
Preview < Awaiting reset date from IO>

Known Issue(s)

  • As part of issue in dbsync 13.0.5 (fixed on master , but not yet part of a release), the pool metadata might be missing a few entries , tho this would typically be for those who might have done multiple updates to their pool metadata, should be sorted with next dbsync release
  • (For instance providers only) - cardano-db-sync v13.0.5 will require resync from genesis (see issue here ) to avoid data consistency issue for datum table

Changes for API

New endpoints added

  • None

Data Input/Output changes

  • tx_info and tx_metadata - Align metadata for JSON output format #1542
  • blocks - Query Output aligned to specs (epoch => epoch_no)
  • epoch_block_protocols - [ ** Specs only ** ] Fix Documentation schema , which was accidentally showing wrong output
  • pool_delegators_history - List all epochs instead of current, if no _epoch_no is specified #1545

Changes for Instance Providers

  • asset_info - Fix metadata aggregaton for minting transactions with multiple metadata keys #1543
  • stake_distribution_new_accounts - Leftover reference for account_info which now accepts array, resulted in error to populate stake distribution cache for new accounts #1541
  • grest-poll.sh - Remove query view section from polling script, and remove grestrpcs re-creation per hour (it's already updated when setup-grest.sh is run) , in preparation for #1545

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

Instructions for Instance Providers

If you're setting up as a new instance provider, you can find instructions here. The tag to use for setup-grest.sh would be koios-1.0.8 - for which you can visit the SQL queries used here.

If you're an existing instance provider using koios-1.0.7, the update process would be executing :

./setup-grest.sh -q -b koios-1.0.8
sudo systemctl restart cnode-postgrest
sudo systemctl restart cnode-haproxy

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.
There are bi-weekly meetings held for development activities on Koios gRest project at every 2nd and 4th Thursday of the month at 8am UTC, the details for which can be found in the group above.