Skip to content

Cardano GraphQL 2.0.0 Beta

Pre-release
Pre-release
Compare
Choose a tag to compare
@tatyanavych tatyanavych released this 26 Jul 18:32
· 689 commits to master since this release
2.0.0-beta.0
f830e5b
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.

This new major version brings the first round of Shelley-era features to the API, introduces a new genesis file API package, and hardens the migrations and metadata handling. This version is required for transitioning through the upcoming Shelley hard fork.

Compatible with

New Features

  • New queries
    • stakePools, stakePools_aggregate
    • delegations, delegations_aggregate
    • stakeRegistrations, stakeRegistrations_aggregate
    • stakeDeregistrations, stakeDeregistrations_aggregate
    • withdrawals, withdrawals_aggregate
    • genesis
  • Metadata and SQL migrations are now performed within the application layer, and make the service immune to schema
    being removed should cardano-db-sync restart using the Hasura CLI, which is included in the Dockerfile and NixOS service; however outside of this you must install and place hasura on PATH.
  • A new API package @cardano-graphql/api-genesis allows access to the network genesis files. It's integrated into the server, with the config exposed as environment variables. The docker-compose.yaml serves as a good reference.

Breaking Changes ⚠️

Removed fields

  • cardanoDbSync.slotDiffFromNetworkTip removed in response to a change in strategy for determining
    sync status with cardano-db-sync
  • Block.slotWithinEpoch removed due to complexity with variation across eras. The Genesis API has information
    for calculations based on the context

Changed fields

  • Dates were previously formatted according to ISO 3339, however, ISO 8601 is being adopted with this release for alignment with the Shelley genesis file format and simplification when the precision is not required, e.g.
    2017-10-03T21:43:51.000Z -> 2017-10-03T21:43:51Z
  • Block.createdAt -> Block.forgedAt
  • Block.createdBy -> Block.slotLeader links to an object, with a nullable stakePool field. For previous behaviour, Block.slotLeader.description can be used, however the description prefixes have changed upstream from SlotLeader to ByronGenesis
Assets 2
Loading