cardano-foundation/cardano-graphql 9.1.0

Cardano GraphQL 9.1.0

on GitHub

Features

• Payment credential and stake address on UTxOs and transaction outputs. utxos and transaction outputs now expose paymentCredential and stakeAddress, and both can be used in where, order_by and distinct_on. This makes CIP-113 programmable tokens queryable: they all share one payment credential (the programmable logic base script) and are owned by stake credential, so filtering by both returns a holder's programmable-token balance. Token metadata comes through as usual via the token registry (CIP-26 / CIP-68). Both filters use existing cardano-db-sync indexes. (#1060)
• Off-chain DRep profiles (CIP-119). New offChainVoteDrepData query with givenName, motivations, objectives, qualifications, imageUrl, imageHash and paymentAddress, plus an offChainVoteDrepData link on OffChainVoteData, so a DRep ID resolves to its profile in one query (drepRegistrations → votingAnchor → offChainData → offChainVoteDrepData). (#1065)

Upgrade notes

• hasura-setup must re-run. This release changes the Utxo and TransactionOutput views and the Hasura metadata. The provided docker-compose stack runs it automatically on up. Custom deployments (e.g. Kubernetes) must run the hasura-setup job (node setup.js) before starting the new server and background.
• No cardano-db-sync resync is required.
• Custom cardano-node configs: if you take the 11.1.x configs from upstream, set Prometheus to "PrometheusSimple suffix 0.0.0.0 12798". Upstream ships 127.0.0.1, which the server cannot reach, and cardanoDbMeta then fails.

Known issues

• Aliasing the same nested field twice (e.g. a: outputs(where: …) next to outputs(where: …)) can return the wrong data for the alias. Alias at the root level instead.
• OffChainVoteData.offChainVoteReference always returns null. This will be fixed together with a type change (it should be a list) in an upcoming breaking release.

Tested with

What's Changed

• feat: expose payment credential and stake address on utxos and outputs by @VladislavKudrin in #1060
• fix: parse nested hash filter arguments before delegating to hasura by @VladislavKudrin in #1061
• chore: bump node to 11.1.3, token registry to 1.7.0 and mithril to 2630.1-hotfix by @VladislavKudrin in #1062
• fix: never pull the submit-api image so unreleased node versions start in one command by @VladislavKudrin in #1063
• test: add preprod goldens and repair stale placeholder goldens by @VladislavKudrin in #1064
• feat: expose off-chain drep profile data by @VladislavKudrin in #1065