Skip to content

envio specific env vars#693

Merged
DZakh merged 2 commits intomainfrom
dp/env-vars
Aug 20, 2025
Merged

envio specific env vars#693
DZakh merged 2 commits intomainfrom
dp/env-vars

Conversation

@DenhamPreen
Copy link
Contributor

@DenhamPreen DenhamPreen commented Aug 20, 2025

Summary by CodeRabbit

  • Documentation
    • Added “Envio-specific environment variables” section to the environment variables guide.
    • Documented variables: ENVIO_API_TOKEN, ENVIO_HASURA, ENVIO_PG_PORT, ENVIO_PG_PASSWORD, ENVIO_PG_USER, ENVIO_PG_DATABASE, ENVIO_PG_PUBLIC_SCHEMA.
    • Clarifies usage for self-hosted setups (access token, disabling Hasura, Postgres credentials), local development (port), and schema overrides.
    • Positioned between the existing Envio API Token section and Example Environment Variables.
    • No functional changes; documentation only.

@DenhamPreen DenhamPreen requested a review from DZakh August 20, 2025 11:31
@vercel
Copy link

vercel bot commented Aug 20, 2025

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

Project Deployment Preview Comments Updated (UTC)
envio-docs Ready Ready Preview Comment Aug 20, 2025 0:29am

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Aug 20, 2025

Walkthrough

Adds a new “Envio-specific environment variables” section to docs/HyperIndex/Guides/environment-variables.md, documenting seven ENVIO_* variables (API token, Hasura toggle, and Postgres settings). Inserted after the Envio API Token section and before Example Environment Variables. No code changes.

Changes

Cohort / File(s) Summary
Docs: HyperIndex env vars
docs/HyperIndex/Guides/environment-variables.md
Added section detailing ENVIO_API_TOKEN, ENVIO_HASURA, ENVIO_PG_PORT, ENVIO_PG_PASSWORD, ENVIO_PG_USER, ENVIO_PG_DATABASE, ENVIO_PG_PUBLIC_SCHEMA; placement between existing API token and examples sections.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

Suggested reviewers

  • DZakh
  • moose-code
  • Piroddi

Poem

I tap my paws and set my vars,
ENVIO_* beneath the stars.
Tokens snug, Postgres neat,
Hasura switch at my feet.
With whisker twitch, I document—
A burrow of configs, heaven-sent.
🐇✨

Tip

🔌 Remote MCP (Model Context Protocol) integration is now available!

Pro plan users can now connect to remote MCP servers from the Integrations page. Connect with popular remote MCPs such as Notion and Linear to add more context to your reviews and chats.

✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch dp/env-vars

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
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Comment on lines +27 to +40
## Envio-specific environment variables

The following variables are used by HyperIndex:

- `ENVIO_API_TOKEN`: API token for HyperSync access (required for continued access in self-hosted deployments)
- `ENVIO_HASURA`: Set to `false` to disable Hasura integration for self-hosted indexers
- `ENVIO_SAVE_BENCHMARK_DATA`: When `true`, saves benchmark data during runs for later summary

- `ENVIO_PG_PORT`: Port for the Postgres service used by HyperIndex during local development
- `ENVIO_PG_PASSWORD`: Postgres password (self-hosted)
- `ENVIO_PG_USER`: Postgres username (self-hosted)
- `ENVIO_PG_DATABASE`: Postgres database name (self-hosted)
- `ENVIO_PG_PUBLIC_SCHEMA`: Postgres schema name override for the generated/public schema

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I think there are some more too, such as for aggregate queries etc we can consider adding here too


- `ENVIO_API_TOKEN`: API token for HyperSync access (required for continued access in self-hosted deployments)
- `ENVIO_HASURA`: Set to `false` to disable Hasura integration for self-hosted indexers
- `ENVIO_SAVE_BENCHMARK_DATA`: When `true`, saves benchmark data during runs for later summary
Copy link
Member

Choose a reason for hiding this comment

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

Let's remove this. I'm keen on deprecating the feature in the future.

Copy link
Member

@DZakh DZakh left a comment

Choose a reason for hiding this comment

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

Nice 👍

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (4)
docs/HyperIndex/Guides/environment-variables.md (4)

27-29: Consider renaming the section to “HyperIndex-specific environment variables.”

The list that follows is scoped to HyperIndex usage. Renaming reduces ambiguity with other Envio-wide vars.

-## Envio-specific environment variables
+## HyperIndex-specific environment variables

29-33: Avoid duplicating ENVIO_API_TOKEN—cross-reference the section above instead.

ENVIO_API_TOKEN is already documented just above; keeping it in the list can be redundant and cause divergent copy later.

-The following variables are used by HyperIndex:
+The following variables are used by HyperIndex:
+This list excludes `ENVIO_API_TOKEN`, which is documented in the section above.
 
-- `ENVIO_API_TOKEN`: API token for HyperSync access (required for continued access in self-hosted deployments)
 - `ENVIO_HASURA`: Set to `false` to disable Hasura integration for self-hosted indexers

32-32: Clarify ENVIO_HASURA semantics (type, default, and potential deprecation).

Please specify:

  • accepted values (e.g., "true"/"false", case sensitivity),
  • default behavior if unset,
  • whether this toggle is slated for deprecation (a previous review mentioned deprecating related functionality).

If deprecation is planned, mark it as deprecated here to guide users.

I can update the wording once you confirm default behavior and deprecation status.


34-37: Align scope wording across Postgres variables and verify completeness.

  • ENVIO_PG_PORT mentions “local development,” while the others say “self-hosted.” Recommend consistent phrasing.
  • Confirm whether an ENVIO_PG_HOST (or similar) exists and should be documented alongside these.
-- `ENVIO_PG_PORT`: Port for the Postgres service used by HyperIndex during local development
+- `ENVIO_PG_PORT`: Postgres port (self-hosted)

If these vars also apply to local development, consider “(self-hosted/local development)” for all PG bullets instead.

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between b11e6a7 and 91f8fdb.

📒 Files selected for processing (1)
  • docs/HyperIndex/Guides/environment-variables.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/HyperIndex/Guides/environment-variables.md

[grammar] ~31-~31: There might be a mistake here.
Context: ...inued access in self-hosted deployments) - ENVIO_HASURA: Set to false to disable Hasura integ...

(QB_NEW_EN)


[grammar] ~34-~34: There might be a mistake here.
Context: ...d by HyperIndex during local development - ENVIO_PG_PASSWORD: Postgres password (self-hosted) - `ENV...

(QB_NEW_EN)


[grammar] ~35-~35: There might be a mistake here.
Context: ...SSWORD: Postgres password (self-hosted) - ENVIO_PG_USER: Postgres username (self-hosted) - ENV...

(QB_NEW_EN)


[grammar] ~36-~36: There might be a mistake here.
Context: ...G_USER: Postgres username (self-hosted) - ENVIO_PG_DATABASE`: Postgres database name (self-hosted) -...

(QB_NEW_EN)


[grammar] ~37-~37: There might be a mistake here.
Context: ...E: Postgres database name (self-hosted) - ENVIO_PG_PUBLIC_SCHEMA`: Postgres schema name override for the ...

(QB_NEW_EN)

🔇 Additional comments (3)
docs/HyperIndex/Guides/environment-variables.md (3)

27-39: Nice addition—clear, concise, and well-placed.

This section is helpful and sits in the right place between the token guidance and examples.


38-38: Clarify what “generated/public schema” means and document the default.

Please clarify whether this overrides the target schema for generated tables (and whether the default is “public”). An example value would also help users.


27-39: Document all ENVIO_ environment variables referenced in the repo*

I ran a scan across the repository and found these unique ENVIO_* names:

• ENVIO_API_TOKEN (documented)
• ENVIO_CHAIN_ID (missing)
• ENVIO_COINGECKO_API_KEY (documented)
• ENVIO_GREETER_ADDRESS (missing)
• ENVIO_GREETER_ADDRESSES (missing)
• ENVIO_HASURA (documented)
• ENVIO_MAINNET_API_KEY (missing)
• ENVIO_PG_DATABASE (documented)
• ENVIO_PG_PASSWORD (documented)
• ENVIO_PG_PORT (documented)
• ENVIO_PG_PUBLIC_SCHEMA (documented)
• ENVIO_PG_USER (documented)
• ENVIO_RPC_URL (documented)
• ENVIO_SAVE_BENCHMARK_DATA (missing)
• ENVIO_START_BLOCK (documented)
• ENVIO_VAR (unspecified)

Please confirm which of these are actually consumed by HyperIndex (versus other components like HyperIndex-LLM or community scripts) and update docs/HyperIndex/Guides/environment-variables.md to:

  • Add any missing, relevant variables.
  • Remove or annotate any variables no longer in use.
  • Ensure naming consistency (e.g. “RPC_URL” vs. “RPC-URL”, presence/absence of “MAINNET” vs. “CHAIN_ID”).

This will keep your environment-variables guide in sync with real code usage.

@DZakh DZakh merged commit 8635e75 into main Aug 20, 2025
3 checks passed
@DZakh DZakh deleted the dp/env-vars branch August 20, 2025 12:53
@DenhamPreen DenhamPreen mentioned this pull request Sep 1, 2025
This was referenced Oct 30, 2025
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.

2 participants