cardano-foundation/cardano-graphql 9.0.0

Cardano GraphQL 9.0.0

on GitHub

⚠️ Hardfork ready mandatory upgrade.

Breaking Changes

• Ogmios is no longer required. Transaction submission now uses cardano-submit-api instead of Ogmios. OGMIOS_HOST and OGMIOS_PORT server env vars have been removed.
• cardano-submit-api is now a required service - included in the provided docker-compose.yml, sharing the same image as cardano-node. New env vars: CARDANO_SUBMIT_API_HOST (default: cardano-submit-api) and CARDANO_SUBMIT_API_PORT (default: 8090).
• CHAIN_FOLLOWER_START_SLOT and CHAIN_FOLLOWER_START_ID have been removed - chain following was replaced with db-sync polling.
• CARDANO_NODE_PROMETHEUS_HOST and CARDANO_NODE_PROMETHEUS_PORT are new server env vars (defaults: localhost, 12798).

Infrastructure

• The cardanofoundation/cardano-graphql-cardano-node image is now built from source. The image bundles cardano-node, cardano-cli, and cardano-submit-api.

Performance:

• Asset metadata initial scan is now significantly faster. The previous chain-following approach (Ogmios) discovered assets block-by-block; the new db-sync polling approach bulk-inserts all existing assets in a single query at startup.
• Critical fix: the asset metadata job queue could grow unboundedly in 8.5.5 due to a double-scheduling bug in the UPDATE cycle (observed: 34M+ jobs on preprod). Fixed, the queue now stays stable at one job per asset.
• The index service now includes idx_ma_tx_mint_ident on ma_tx_mint(ident), which is recommended for all production COMPOSE_PROFILES=indexes. See Index Service docs.

New features:

• cardanoDbMeta { assetSyncPercentage } - new nullable field showing what percentage of native assets have been synced into the metadata table. Useful for tracking backfill progress after a fresh sync
• conway governance queries: govActionProposal, voteProcedure, drepRegistrations, epochParams, offChainVoteData, offChainVoteGovActionData, delegationVotes- see example queries in src/example_queries/
• reliable startup ordering via hasura-setup init container - server and background now wait for Hasura schema to be fully applied before starting

Note for custom deployments:

• If you run cardano-node outside of the provided docker-compose stack, ensure Prometheus is bound to 0.0.0.0 (not 127.0.0.1) on port 12798 so the server can reach it

What's Changed:

• feat: remove ogmios chain follower by @VladislavKudrin in #1001
• fix: start asset polling before metadata registry sync by @VladislavKudrin in #1003
• feat: build cardano node from source by @VladislavKudrin in #1005
• fix: restore asset metadata update cycle broken by singletonKey by @VladislavKudrin in #1006
• feat: replace ogmios submission with submit api by @VladislavKudrin in #1007
• fix: prevent asset metadata UPDATE job multiplication by @VladislavKudrin in #1008
• feat: remove ogmios dead code by @VladislavKudrin in #1009
• fix: purge update jobs on startup by @VladislavKudrin in #1010 && #1011
• fix: skip overlength ticker by @VladislavKudrin in #1012
• feat: add Conway governance queries by @VladislavKudrin in #1015

Tested with

Full Changelog: 8.5.5...9.0.0