Skip to content

fix: align GraphQL docs with live schema#79

Merged
jonathanprozzi merged 5 commits intomainfrom
fix/graphql-docs-schema-accuracy
Apr 1, 2026
Merged

fix: align GraphQL docs with live schema#79
jonathanprozzi merged 5 commits intomainfrom
fix/graphql-docs-schema-accuracy

Conversation

@jonathanprozzi
Copy link
Copy Markdown
Member

Summary

  • Fix ghost fields: Removed non-existent fields from overview example queries (signal_type, block_timestamp, created_at on accounts), corrected a renamed function reference, and fixed an inconsistent search argument
  • Fix response field types: Corrected documented types across 9 query docs to match schema introspection (wrong scalars, wrong object type names)
  • Add missing fields: Documented schema fields missing from response tables (PnL percentages, signal deposit/redemption IDs, indexer progress stats)

Verified against live schema introspection — 242/242 queries pass, mainnet and testnet in sync.

Test plan

  • node scripts/validate-graphql-queries.js passes (242/242 queries valid)
  • Pre-commit hooks pass on all 3 commits (link validator + GraphQL validator)
  • Schema snapshots current with live endpoints (no drift)

🤖 Generated with Claude Code

jonathanprozzi and others added 3 commits April 1, 2026 09:42
Verified against live schema introspection. Fixes non-existent fields
in example queries (signal_type, block_timestamp, created_at on accounts),
a renamed function reference, and an inconsistent search argument name.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Aligned documented types with schema introspection across 9 query docs.
Fixes incorrect scalar types (String→numeric, Int→numeric, DateTime→
timestamptz) and object type names (Account→accounts, Term→terms) to
match actual Hasura schema types.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Adds undocumented fields that exist in the live schema: realized/
unrealized PnL percentages on leaderboard entries, deposit/redemption
IDs and curve ID on signals, and indexer progress fields on stats.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The example term_id didn't exist on-chain, causing the interactive
query to return null. Replaced with the actual "Intuition" atom and
updated the expected response to match live data.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
All hardcoded example IDs (account, atom, triple) were returning null
from the live API. Replaced with real intuitionbilly.eth data so
interactive playground examples return actual results.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@jonathanprozzi jonathanprozzi temporarily deployed to fix/graphql-docs-schema-accuracy - intuition-docs PR #79 April 1, 2026 15:06 — with Render Destroyed
@jonathanprozzi jonathanprozzi merged commit 20c7d01 into main Apr 1, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant