Skip to content

Clarify Hyperindex endpoints and GainForest source#136

Merged
Kzoeps merged 1 commit into
mainfrom
hyperindex-docs
May 19, 2026
Merged

Clarify Hyperindex endpoints and GainForest source#136
Kzoeps merged 1 commit into
mainfrom
hyperindex-docs

Conversation

@Kzoeps

@Kzoeps Kzoeps commented May 19, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Explain that the Certified indexer is forked from GainForest's Hyperindex repository
  • Document the hosted GraphQL, GraphiQL, WebSocket, and introspection/codegen usage\n- Add GraphiQL rows to Certified Services and align roadmap endpoint references

Summary by CodeRabbit

  • Documentation
    • Added GraphiQL explorer links for Hyperindex production and staging endpoints in the API reference
    • Updated GraphQL/GraphiQL domain and endpoint references across docs and roadmap
    • Enhanced FAQ to note GraphQL introspection and typed-client generation, with GraphiQL link
    • Expanded endpoint descriptions, WebSocket/GraphiQL details, hosted production query URL, and clarified upstream fork attribution

Review Change Stack

@vercel

vercel Bot commented May 19, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
hypercerts-v0.2-documentation Ready Ready Preview, Comment May 19, 2026 4:14pm

Request Review

@coderabbitai

coderabbitai Bot commented May 19, 2026

Copy link
Copy Markdown

Warning

Rate limit exceeded

@Kzoeps has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 32 minutes and 25 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: ecf180ea-9309-4cfa-b1df-9dee36cfedaf

📥 Commits

Reviewing files that changed from the base of the PR and between ba322e3 and 8ad7fd5.

📒 Files selected for processing (4)
  • pages/reference/certified-services.md
  • pages/reference/faq.md
  • pages/roadmap.md
  • pages/tools/hyperindex.md
📝 Walkthrough

Walkthrough

Documentation across four files is updated to reflect the migration of Hyperindex API infrastructure to a new domain (api.indexer.hypercerts.dev), add GraphiQL explorer endpoint documentation (production and staging), and refine endpoint descriptions and attribution language.

Changes

Hyperindex API Documentation Update

Layer / File(s) Summary
Domain migration to new infrastructure
pages/roadmap.md
GraphQL and GraphiQL endpoint URLs in the Hyperindex AppView endpoints section and Links & resources table are updated from hyperindex.certified.app to api.indexer.hypercerts.dev.
GraphiQL endpoint documentation and API capabilities
pages/reference/certified-services.md, pages/reference/faq.md, pages/tools/hyperindex.md
GraphiQL explorer endpoints (production and staging) are added to the Indexers reference table. FAQ entry now mentions GraphQL introspection for typed client generation and links to the GraphiQL explorer. Tools docs add a Certified-hosted production block with GraphQL, GraphiQL, and WebSocket endpoints and schema/codegen guidance.
Hyperindex documentation clarity and branding adjustments
pages/tools/hyperindex.md
Attribution line rephrased; endpoint table descriptions for /graphql, /graphql/ws, /admin/graphql, and /graphiql expanded; GitHub repository bullet updated to describe the upstream fork relationship.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Suggested reviewers

  • s-adamantine

Poem

🐰 I hopped through docs with a nibble and cheer,
New hosts and endpoints now crystal clear,
GraphiQL lights up to query and play,
Schemas and links guide the curious way,
Hooray — the docs hop forward today!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title directly reflects the main objectives of the changeset—clarifying Hyperindex endpoints across multiple documentation files and documenting the GainForest source relationship.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch hyperindex-docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (2)
pages/tools/hyperindex.md (2)

73-73: 💤 Low value

Minor clarity: intro mentions only /graphql but section covers multiple endpoints.

The sentence "Access your indexed data at /graphql" introduces a section that actually documents three distinct endpoints (GraphQL API, GraphiQL explorer, and WebSocket subscriptions). Consider rewording to better frame the multi-endpoint content that follows.

♻️ Proposed clarification
-Access your indexed data at `/graphql`. For the Certified-hosted production indexer, use:
+Access your indexed data through the following endpoints. For the Certified-hosted production indexer, use:
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@pages/tools/hyperindex.md` at line 73, The intro line "Access your indexed
data at `/graphql`" is misleading because the section documents three endpoints;
update that sentence to indicate multiple endpoints and briefly list them (e.g.,
"Access your indexed data via multiple endpoints: `/graphql` (GraphQL API),
`/graphiql` (GraphiQL explorer), and the WebSocket subscriptions endpoint") so
readers know the scope before the details for each endpoint follow.

15-15: 💤 Low value

Consider breaking this sentence for improved readability.

This line combines several distinct pieces of information (language, origin, fork relationship, expected references, and upstream implementation) into one long sentence. Breaking it into separate sentences would improve clarity.

♻️ Proposed refactor for readability
-Built in Go. Hyperindex was originally built by our friends at GainForest; the Certified indexer is forked from [github.com/gainforest/hyperindex](https://github.com/gainforest/hyperindex). Seeing the GainForest GitHub organization or GainForest-hosted Hyperindex references in related tooling is expected. Tap reference implementation: [github.com/bluesky-social](https://github.com/bluesky-social/indigo/tree/main/cmd/tap).
+Built in Go. Hyperindex was originally built by our friends at GainForest, and the Certified indexer is forked from [github.com/gainforest/hyperindex](https://github.com/gainforest/hyperindex). You may see GainForest GitHub organization or GainForest-hosted Hyperindex references in related tooling, which is expected. The Tap reference implementation is at [github.com/bluesky-social](https://github.com/bluesky-social/indigo/tree/main/cmd/tap).
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@pages/tools/hyperindex.md` at line 15, Split the long sentence in
pages/tools/hyperindex.md into multiple clearer sentences: one stating the
language ("Built in Go"), one noting origin and fork relationship ("Originally
built by GainForest; the Certified indexer is forked from
github.com/gainforest/hyperindex"), one mentioning expected references in
tooling ("References to the GainForest organization or GainForest-hosted
Hyperindex are expected"), and a final sentence pointing to the tap reference
implementation ("Tap reference implementation:
github.com/bluesky-social/indigo/tree/main/cmd/tap"); ensure links and
punctuation remain correct and the phrasing around "Certified indexer" and "Tap
reference implementation" is preserved.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@pages/tools/hyperindex.md`:
- Line 73: The intro line "Access your indexed data at `/graphql`" is misleading
because the section documents three endpoints; update that sentence to indicate
multiple endpoints and briefly list them (e.g., "Access your indexed data via
multiple endpoints: `/graphql` (GraphQL API), `/graphiql` (GraphiQL explorer),
and the WebSocket subscriptions endpoint") so readers know the scope before the
details for each endpoint follow.
- Line 15: Split the long sentence in pages/tools/hyperindex.md into multiple
clearer sentences: one stating the language ("Built in Go"), one noting origin
and fork relationship ("Originally built by GainForest; the Certified indexer is
forked from github.com/gainforest/hyperindex"), one mentioning expected
references in tooling ("References to the GainForest organization or
GainForest-hosted Hyperindex are expected"), and a final sentence pointing to
the tap reference implementation ("Tap reference implementation:
github.com/bluesky-social/indigo/tree/main/cmd/tap"); ensure links and
punctuation remain correct and the phrasing around "Certified indexer" and "Tap
reference implementation" is preserved.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 501e3dee-0c21-4ea7-b793-df648c3474d8

📥 Commits

Reviewing files that changed from the base of the PR and between 20b2648 and 7bb2747.

📒 Files selected for processing (4)
  • pages/reference/certified-services.md
  • pages/reference/faq.md
  • pages/roadmap.md
  • pages/tools/hyperindex.md

@Kzoeps Kzoeps force-pushed the hyperindex-docs branch from 3337e2f to 8ad7fd5 Compare May 19, 2026 16:13
@Kzoeps Kzoeps merged commit d10fea9 into main May 19, 2026
3 checks passed
@Kzoeps Kzoeps deleted the hyperindex-docs branch May 19, 2026 16:15
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