Skip to content

v2.29#703

Merged
DZakh merged 2 commits intomainfrom
dz/2.29.0
Sep 15, 2025
Merged

v2.29#703
DZakh merged 2 commits intomainfrom
dz/2.29.0

Conversation

@DZakh
Copy link
Member

@DZakh DZakh commented Sep 15, 2025

Summary by CodeRabbit

  • Documentation
    • Added Advanced guide describing a GraphQL _meta query for per-chain indexing metadata with examples and field explanations.
    • Added Block Handlers guide (v2.29) covering onBlock usage, options, examples, patterns, and limitations.
    • Updated configuration guide link to the Config File Reference.
    • Updated supported networks tables: Damon tier change; Gnosis Traces tier change; HyperSync replaced Sei with Sepolia; HyperRPC removed Lightlink and Sei.
    • Updated Damon network tier page and sidebar ordering to include new guides.
  • Chores
    • Reformatted supported-networks.json (no content changes).

@vercel
Copy link

vercel bot commented Sep 15, 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 Sep 15, 2025 0:09am

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Sep 15, 2025

Walkthrough

Adds two new HyperIndex docs pages (metadata GraphQL _meta query and Block Handlers/onBlock), tweaks links and supported-network tiers/entries across docs, reorders and augments the HyperIndex sidebar, removes Lightlink and Sei from some HyperRPC/HyperSync docs, and reformats supported-networks.json without content changes.

Changes

Cohort / File(s) Summary of changes
New docs pages
docs/HyperIndex/Advanced/metadata-query.md, docs/HyperIndex/Guides/block-handlers.md
Added a metadata GraphQL _meta query reference (per-chain indexing metadata) and a Block Handlers (v2.29) guide describing onBlock usage, options, examples, limitations, and behavior notes.
HyperIndex docs tweaks
docs/HyperIndex/Guides/configuration-file.mdx
Updated a link target in the Event Field Selection example to point to the Config File Reference anchor.
Supported networks docs updates
docs/HyperIndex/supported-networks/damon.md, docs/HyperSync/HyperRPC/hyperrpc-supported-networks.md, docs/HyperSync/hypersync-supported-networks.md
Adjusted tier labels (Damon, Gnosis Traces), removed Lightlink and Sei entries from HyperRPC docs, and replaced Sei with Sepolia in HyperSync listings.
Sidebar configuration
sidebarsHyperIndex.js
Added Guides/block-handlers; inserted Advanced/metadata-query; reordered Advanced/config-schema-reference location.
Data formatting
supported-networks.json
Reformatted/reflowed the JSON file (line wrapping) with no substantive content changes.

Sequence Diagram(s)

sequenceDiagram
  autonumber
  actor Dev as Developer
  participant Gen as Generated Module
  participant HI as HyperIndex Runtime

  Dev->>Gen: import { onBlock }
  Dev->>Gen: onBlock({ name, chain, interval?, startBlock?, endBlock? }, handler)
  Note over Gen,HI: Preload optimization may trigger the handler twice (preload + execute)
  Gen->>HI: Register block handler
  HI-->>Gen: Schedule per chain/interval
  loop For each eligible block
    HI->>Gen: Invoke handler({ block, context })
    alt Historical window
      HI-->>Gen: Run at configured historical interval
    else Realtime window
      HI-->>Gen: Run at realtime interval
    end
  end
Loading
sequenceDiagram
  autonumber
  actor Client
  participant GQL as HyperIndex GraphQL API
  participant IDX as Indexer Metadata Store

  Client->>GQL: query { _meta { chainId progressBlock ... isReady } }
  GQL->>IDX: Fetch per-chain metadata
  IDX-->>GQL: Metadata rows
  GQL-->>Client: JSON result (one row per chain)
  Note over GQL,Client: Fields include configuration, transactional, and throttled metadata
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • DenhamPreen
  • moose-code

Poem

A rabbit taps its paws in sync,
New blocks to nibble, stats to link.
Meta hums, handlers bound to run—
Sidebars hop beneath the sun.
Thump-thump, docs updated, trails begun.

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check ✅ Passed The title "v2.29" is directly related to the changeset (this PR appears to bundle docs and sidebar updates for the v2.29 release, e.g., new Block Handlers and metadata-query pages) but is very terse and does not summarize the primary changes, which makes it less useful for reviewers or future history inspection. Per the check criteria it is partially related to the changeset but lacks descriptive context about the main changes.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
✨ Finishing touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch dz/2.29.0

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 4b8a87d and a0cb890.

📒 Files selected for processing (1)
  • docs/HyperIndex/Guides/block-handlers.md (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/HyperIndex/Guides/block-handlers.md

Tip

👮 Agentic pre-merge checks are now available in preview!

Pro plan users can now enable pre-merge checks in their settings to enforce checklists before merging PRs.

  • Built-in checks – Quickly apply ready-made checks to enforce title conventions, require pull request descriptions that follow templates, validate linked issues for compliance, and more.
  • Custom agentic checks – Define your own rules using CodeRabbit’s advanced agentic capabilities to enforce organization-specific policies and workflows. For example, you can instruct CodeRabbit’s agent to verify that API documentation is updated whenever API schema files are modified in a PR. Note: Upto 5 custom checks are currently allowed during the preview period. Pricing for this feature will be announced in a few weeks.

Please see the documentation for more information.

Example:

reviews:
  pre_merge_checks:
    custom_checks:
      - name: "Undocumented Breaking Changes"
        mode: "warning"
        instructions: |
          Pass/fail criteria: All breaking changes to public APIs, CLI flags, environment variables, configuration keys, database schemas, or HTTP/GraphQL endpoints must be documented in the "Breaking Change" section of the PR description and in CHANGELOG.md. Exclude purely internal or private changes (e.g., code not exported from package entry points or explicitly marked as internal).

Please share your feedback with us on this Discord post.


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.

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: 4

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
docs/HyperSync/hypersync-supported-networks.md (1)

50-51: Remove Chainweb Testnet 20 & 21 — endpoints return HTTP 404

All four tested endpoints return HTTP 404; remove these rows from docs/HyperSync/hypersync-supported-networks.md (lines 50–51).

Apply:

-| Chainweb Testnet 20  | 5920       | https://chainweb-testnet-20.hypersync.xyz or https://5920.hypersync.xyz             | 🪨   |                 |
-| Chainweb Testnet 21  | 5921       | https://chainweb-testnet-21.hypersync.xyz or https://5921.hypersync.xyz             | 🪨   |                 |
🧹 Nitpick comments (4)
docs/HyperSync/hypersync-supported-networks.md (1)

56-56: Fix markdownlint MD034 (bare URLs) or suppress consistently.

Lint flags the changed rows for bare URLs. Either:

  • Wrap URLs in angle brackets: https://…, or
  • Convert to markdown links: https://…,
    and consider applying the same style across the table for consistency.

Also applies to: 66-66

docs/HyperIndex/Guides/block-handlers.md (2)

108-111: Typo: “receipt” → “recipe”.

Tiny wording fix for clarity.

Apply:

-Here's the receipt how to speed up your historical sync, by increasing the interval for historical blocks.
+Here's the recipe to speed up your historical sync by increasing the interval for historical blocks.

57-58: Unify Discord invite link.

Elsewhere in the docs this repo uses the “Q9qt8gZ2fX” invite. Consider using a single canonical link across pages.

docs/HyperIndex/Advanced/metadata-query.md (1)

64-65: Typo: “actuall” → “actual”.

Minor grammar fix.

Apply:

-...before querying actuall data, building custom dashboards...
+...before querying actual data, building custom dashboards...
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2690c4f and 4b8a87d.

📒 Files selected for processing (8)
  • docs/HyperIndex/Advanced/metadata-query.md (1 hunks)
  • docs/HyperIndex/Guides/block-handlers.md (1 hunks)
  • docs/HyperIndex/Guides/configuration-file.mdx (1 hunks)
  • docs/HyperIndex/supported-networks/damon.md (1 hunks)
  • docs/HyperSync/HyperRPC/hyperrpc-supported-networks.md (0 hunks)
  • docs/HyperSync/hypersync-supported-networks.md (2 hunks)
  • sidebarsHyperIndex.js (2 hunks)
  • supported-networks.json (1 hunks)
💤 Files with no reviewable changes (1)
  • docs/HyperSync/HyperRPC/hyperrpc-supported-networks.md
🧰 Additional context used
🧠 Learnings (1)
📚 Learning: 2025-07-29T14:30:03.677Z
Learnt from: DenhamPreen
PR: enviodev/docs#673
File: docs/HyperIndex/supported-networks/chainweb-testnet-21.md:14-16
Timestamp: 2025-07-29T14:30:03.677Z
Learning: Chainweb Testnet 20 (ID: 5920) and Chainweb Testnet 21 (ID: 5921) have non-functional HyperSync endpoints that return HTTP 404, indicating these networks are not properly supported and should be removed from documentation.

Applied to files:

  • docs/HyperSync/hypersync-supported-networks.md
🪛 markdownlint-cli2 (0.17.2)
docs/HyperSync/hypersync-supported-networks.md

56-56: Bare URL used

(MD034, no-bare-urls)


56-56: Bare URL used

(MD034, no-bare-urls)


66-66: Bare URL used

(MD034, no-bare-urls)


66-66: Bare URL used

(MD034, no-bare-urls)

🔇 Additional comments (5)
docs/HyperIndex/supported-networks/damon.md (1)

20-23: Tier update to STONE looks correct and consistent.

Matches the HyperSync networks table update for Damon. No further changes needed.

docs/HyperSync/hypersync-supported-networks.md (2)

56-56: Damon tier change: LGTM.

STONE emoji aligns with Damon’s updated support tier.


66-66: Gnosis Traces tier adjustment: LGTM.

Bronze reflects the updated support level.

sidebarsHyperIndex.js (1)

109-116: New Advanced doc wiring: looks good.

“Advanced/config-schema-reference” reordering and adding “Advanced/metadata-query” align with the new pages.

docs/HyperIndex/Advanced/metadata-query.md (1)

1-8: Version note: LGTM.

“Starting from envio@2.28” matches the release sequencing alongside v2.29 features in this PR.

Comment on lines +168 to +171
// You don't need preload optimization here,
// so don't forget to disable it to prevent double-run.
if (context.isPreload) return;

Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue

Don’t advise disabling Preload; guard with isPreload instead.

Earlier you state Block Handlers require Preload Optimization. Here it says “disable it,” which is contradictory and could break handlers. Recommend clarifying to keep Preload enabled and skip work during the preload phase.

Apply:

-    // You don't need preload optimization here,
-    // so don't forget to disable it to prevent double-run.
-    if (context.isPreload) return;
+    // Keep Preload Optimization enabled for block handlers.
+    // Avoid double-run by skipping work during the preload phase.
+    if (context.isPreload) return;
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
// You don't need preload optimization here,
// so don't forget to disable it to prevent double-run.
if (context.isPreload) return;
// Keep Preload Optimization enabled for block handlers.
// Avoid double-run by skipping work during the preload phase.
if (context.isPreload) return;
🤖 Prompt for AI Agents
In docs/HyperIndex/Guides/block-handlers.md around lines 168 to 171, the text
and code comment incorrectly advise disabling Preload optimization; update the
prose to instruct readers to keep Preload enabled and guard expensive or
duplicate work by returning early when context.isPreload is true. Replace the
comment that says “don’t forget to disable it to prevent double-run” with
wording that explicitly tells users to “keep Preload enabled and skip work
during the preload phase by returning when context.isPreload is true,” and
ensure the example code remains as if (context.isPreload) return; so it
documents guarding, not disabling Preload.

Comment on lines +184 to 185
See all possible options in the [Config File Reference](/docs/HyperIndex/config-schema-reference#transactionfield) or use IDE autocomplete for your help.

Copy link
Contributor

Choose a reason for hiding this comment

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

💡 Verification agent

🧩 Analysis chain

Verify target slug and anchor for the Config Schema Reference link.

Sidebars reference “Advanced/config-schema-reference”, while this link points to “/docs/HyperIndex/config-schema-reference#transactionfield”. Please confirm the page’s front‑matter id/slug and that the “transactionfield” anchor exists to avoid a 404.

Run:


🏁 Script executed:

#!/bin/bash
set -euo pipefail
echo "Locate config-schema-reference doc:"
fd -a 'config-schema-reference.*' docs/HyperIndex | sed 's/^/  /'
echo
echo "Show front‑matter id/slug:"
rg -nU -C3 '^(id|slug):\s*config-schema-reference' docs/HyperIndex || true
echo
echo "Search for a heading that would produce #transactionfield or similar:"
rg -nP '^\s*#+\s*(transaction\s*field|transactionfield|transaction_fields|Transaction\s*Fields?)' docs/HyperIndex || true

Length of output: 714


Fix Config Schema Reference link — use front‑matter slug and existing anchor

Front‑matter for docs/HyperIndex/Advanced/config-schema-reference.md: id: config-schema-reference, slug: /config-schema-reference. The anchor exists: "### TransactionField {#transactionfield}". Update the link in docs/HyperIndex/Guides/configuration-file.mdx (lines 184–185) from /docs/HyperIndex/config-schema-reference#transactionfield to /config-schema-reference#transactionfield.

🤖 Prompt for AI Agents
In docs/HyperIndex/Guides/configuration-file.mdx around lines 184 to 185, update
the Config File Reference link to use the front‑matter slug and existing anchor:
change the href from /docs/HyperIndex/config-schema-reference#transactionfield
to /config-schema-reference#transactionfield so it points to the page by slug
and the "TransactionField" anchor.

Comment on lines +54 to 55
"Guides/block-handlers",
"Advanced/multichain-indexing",
Copy link
Contributor

Choose a reason for hiding this comment

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

💡 Verification agent

🧩 Analysis chain

Ensure sidebar id matches the new doc’s id.

“Guides/block-handlers” assumes the doc’s resolved id is “Guides/block-handlers”. The page front‑matter sets id: block-handlers; this should be fine, but please confirm no id/slug collision.

Run:


🏁 Script executed:

#!/bin/bash
set -euo pipefail
echo "Block Handlers doc:"
fd -a 'block-handlers.*' docs/HyperIndex | sed 's/^/  /'
rg -nU -C2 '^(id|slug):\s*block-handlers' docs/HyperIndex/Guides/block-handlers.md || true

Length of output: 167


Fix sidebar id mismatch

sidebarsHyperIndex.js references "Guides/block-handlers" but docs/HyperIndex/Guides/block-handlers.md frontmatter sets id: block-handlers — update the sidebar entry to "block-handlers" or change the doc frontmatter id to "Guides/block-handlers".
Locations: sidebarsHyperIndex.js (lines 54–55); docs/HyperIndex/Guides/block-handlers.md (frontmatter — line 2: id: block-handlers).

🤖 Prompt for AI Agents
In sidebarsHyperIndex.js around lines 54–55 the sidebar entry
"Guides/block-handlers" does not match the doc frontmatter id in
docs/HyperIndex/Guides/block-handlers.md (id: block-handlers); update either the
sidebar entry to "block-handlers" or change the document frontmatter id to
"Guides/block-handlers" so both identifiers match, then run the docs build to
verify the sidebar links resolve correctly.

"supported-networks/local-anvil",
"supported-networks/local-hardhat",
"supported-networks/0g-newton-testnet","supported-networks/abstract","supported-networks/aleph-zero-evm","supported-networks/altlayer-op-demo-testnet","supported-networks/ancient8","supported-networks/arbitrum","supported-networks/arbitrum-blueberry","supported-networks/arbitrum-nova","supported-networks/arbitrum-sepolia","supported-networks/artela-testnet","supported-networks/arthera-mainnet","supported-networks/asset-chain-mainnet","supported-networks/astar-zkevm","supported-networks/astar-zkyoto","supported-networks/aurora","supported-networks/aurora-turbo","supported-networks/avalanche","supported-networks/b2-hub-testnet","supported-networks/b3","supported-networks/b3-sepolia-testnet","supported-networks/base","supported-networks/base-sepolia","supported-networks/beam","supported-networks/berachain","supported-networks/berachain-artio-testnet","supported-networks/berachain-bartio","supported-networks/bevm-mainnet","supported-networks/bevm-testnet","supported-networks/bitfinity-mainnet","supported-networks/bitfinity-testnet","supported-networks/bitgert-mainnet","supported-networks/bitlayer","supported-networks/blast","supported-networks/blast-sepolia","supported-networks/bob-mainnet","supported-networks/boba","supported-networks/boba-bnb-mainnet","supported-networks/botanix-testnet","supported-networks/bsc","supported-networks/bsc-testnet","supported-networks/canto","supported-networks/canto-testnet","supported-networks/celo","supported-networks/celo-alfajores-testnet","supported-networks/chainweb-testnet-20","supported-networks/chainweb-testnet-21","supported-networks/chiliz","supported-networks/chiliz-testnet-spicy","supported-networks/citrea-devnet","supported-networks/citrea-testnet","supported-networks/core","supported-networks/creator-testnet","supported-networks/cronos-zkevm","supported-networks/cronos-zkevm-testnet","supported-networks/crossfi-mainnet","supported-networks/crossfi-mainnet","supported-networks/crossfi-testnet","supported-networks/curtis","supported-networks/cyber","supported-networks/damon","supported-networks/degen-chain","supported-networks/dfk-chain","supported-networks/dogechain-mainnet","supported-networks/dogechain-testnet","supported-networks/dos-chain","supported-networks/energy-web","supported-networks/eos","supported-networks/eth","supported-networks/etherlink-testnet","supported-networks/exosama","supported-networks/fantom","supported-networks/fantom-testnet","supported-networks/flare","supported-networks/flare-songbird","supported-networks/flow","supported-networks/flow-testnet","supported-networks/fraxtal","supported-networks/fuel-mainnet","supported-networks/fuel-testnet","supported-networks/fuji","supported-networks/galadriel-devnet","supported-networks/gnosis","supported-networks/gnosis-chiado","supported-networks/gravity-alpha-mainnet","supported-networks/harmony-shard-0","supported-networks/heco-chain","supported-networks/holesky","supported-networks/hyperliquid","supported-networks/immutable-zkevm","supported-networks/immutable-zkevm-testnet","supported-networks/ink","supported-networks/iotex-network","supported-networks/japan-open-chain","supported-networks/kaia","supported-networks/kakarot-starknet-sepolia","supported-networks/kroma","supported-networks/layeredge-testnet","supported-networks/lightlink","supported-networks/lightlink-pegasus-testnet","supported-networks/linea","supported-networks/lisk","supported-networks/lukso","supported-networks/lukso-testnet","supported-networks/manta","supported-networks/manta-pacific-sepolia","supported-networks/mantle","supported-networks/megaeth-testnet","supported-networks/merlin","supported-networks/metall2","supported-networks/meter-mainnet","supported-networks/meter-testnet","supported-networks/mev-commit","supported-networks/mint-mainnet","supported-networks/mode","supported-networks/monad-testnet","supported-networks/moonbase-alpha","supported-networks/moonbeam","supported-networks/morph","supported-networks/nautilus","supported-networks/neo-x-testnet","supported-networks/nibiru-testnet","supported-networks/now-chaint","supported-networks/oasis-emerald","supported-networks/oasis-sapphire","supported-networks/onigiri-subnet","supported-networks/onigiri-test-subnet","supported-networks/ontology-mainnet","supported-networks/ontology-testnet","supported-networks/op-celestia-raspberry","supported-networks/opbnb","supported-networks/optimism","supported-networks/optimism-sepolia","supported-networks/optopia","supported-networks/peaq","supported-networks/plume","supported-networks/polygon","supported-networks/polygon-amoy","supported-networks/polygon-zkevm","supported-networks/polygon-zkevm-cardona-testnet","supported-networks/public-goods-network","supported-networks/pulsechain","supported-networks/puppynet-shibarium","supported-networks/ronin","supported-networks/rootstock","supported-networks/saakuru","supported-networks/satoshivm","supported-networks/scroll","supported-networks/scroll-sepolia","supported-networks/sei","supported-networks/sepolia","supported-networks/shibarium","supported-networks/shimmer-evm","supported-networks/skale-europa","supported-networks/soneium","supported-networks/sonic","supported-networks/sophon","supported-networks/sophon-testnet","supported-networks/stratovm-testnet","supported-networks/superseed","supported-networks/superseed-sepolia-testnet","supported-networks/swell","supported-networks/taiko","supported-networks/tangle","supported-networks/tanssi-demo","supported-networks/taraxa","supported-networks/telos-evm-mainnet","supported-networks/telos-evm-testnet","supported-networks/torus-mainnet","supported-networks/torus-testnet","supported-networks/unichain","supported-networks/unichain-sepolia","supported-networks/unicorn-ultra-nebulas-testnet","supported-networks/velas-mainnet","supported-networks/viction","supported-networks/worldchain","supported-networks/x-layer-mainnet","supported-networks/x-layer-testnet","supported-networks/xdc","supported-networks/xdc-testnet","supported-networks/zeta","supported-networks/zeta-testnet","supported-networks/zircuit","supported-networks/zklink-nova-mainnet","supported-networks/zksync","supported-networks/zksync-sepolia-testnet","supported-networks/zora","supported-networks/zora-sepolia"]} No newline at end of file
"supported-networks/0g-newton-testnet","supported-networks/abstract","supported-networks/aleph-zero-evm","supported-networks/altlayer-op-demo-testnet","supported-networks/ancient8","supported-networks/arbitrum","supported-networks/arbitrum-blueberry","supported-networks/arbitrum-nova","supported-networks/arbitrum-sepolia","supported-networks/artela-testnet","supported-networks/arthera-mainnet","supported-networks/asset-chain-mainnet","supported-networks/astar-zkevm","supported-networks/astar-zkyoto","supported-networks/aurora","supported-networks/aurora-turbo","supported-networks/avalanche","supported-networks/b2-hub-testnet","supported-networks/b3","supported-networks/b3-sepolia-testnet","supported-networks/base","supported-networks/base-sepolia","supported-networks/beam","supported-networks/berachain","supported-networks/berachain-artio-testnet","supported-networks/berachain-bartio","supported-networks/bevm-mainnet","supported-networks/bevm-testnet","supported-networks/bitfinity-mainnet","supported-networks/bitfinity-testnet","supported-networks/bitgert-mainnet","supported-networks/bitlayer","supported-networks/blast","supported-networks/blast-sepolia","supported-networks/bob-mainnet","supported-networks/boba","supported-networks/boba-bnb-mainnet","supported-networks/botanix-testnet","supported-networks/bsc","supported-networks/bsc-testnet","supported-networks/canto","supported-networks/canto-testnet","supported-networks/celo","supported-networks/celo-alfajores-testnet","supported-networks/chainweb-testnet-20","supported-networks/chainweb-testnet-21","supported-networks/chiliz","supported-networks/chiliz-testnet-spicy","supported-networks/citrea-devnet","supported-networks/citrea-testnet","supported-networks/core","supported-networks/creator-testnet","supported-networks/cronos-zkevm","supported-networks/cronos-zkevm-testnet","supported-networks/crossfi-mainnet","supported-networks/crossfi-mainnet","supported-networks/crossfi-testnet","supported-networks/curtis","supported-networks/cyber","supported-networks/damon","supported-networks/degen-chain","supported-networks/dfk-chain","supported-networks/dogechain-mainnet","supported-networks/dogechain-testnet","supported-networks/dos-chain","supported-networks/energy-web","supported-networks/eos","supported-networks/eth","supported-networks/etherlink-testnet","supported-networks/exosama","supported-networks/fantom","supported-networks/fantom-testnet","supported-networks/flare","supported-networks/flare-songbird","supported-networks/flow","supported-networks/flow-testnet","supported-networks/fraxtal","supported-networks/fuel-mainnet","supported-networks/fuel-testnet","supported-networks/fuji","supported-networks/galadriel-devnet","supported-networks/gnosis","supported-networks/gnosis-chiado","supported-networks/gravity-alpha-mainnet","supported-networks/harmony-shard-0","supported-networks/heco-chain","supported-networks/holesky","supported-networks/hyperliquid","supported-networks/immutable-zkevm","supported-networks/immutable-zkevm-testnet","supported-networks/ink","supported-networks/iotex-network","supported-networks/japan-open-chain","supported-networks/kaia","supported-networks/kakarot-starknet-sepolia","supported-networks/kroma","supported-networks/layeredge-testnet","supported-networks/lightlink-pegasus-testnet","supported-networks/lightlink-phoenix","supported-networks/linea","supported-networks/lisk","supported-networks/lukso","supported-networks/lukso-testnet","supported-networks/manta","supported-networks/manta-pacific-sepolia","supported-networks/mantle","supported-networks/megaeth-testnet","supported-networks/merlin","supported-networks/metall2","supported-networks/meter-mainnet","supported-networks/meter-testnet","supported-networks/mev-commit","supported-networks/mint-mainnet","supported-networks/mode","supported-networks/monad-testnet","supported-networks/moonbase-alpha","supported-networks/moonbeam","supported-networks/morph","supported-networks/nautilus","supported-networks/neo-x-testnet","supported-networks/nibiru-testnet","supported-networks/now-chaint","supported-networks/oasis-emerald","supported-networks/oasis-sapphire","supported-networks/onigiri-subnet","supported-networks/onigiri-test-subnet","supported-networks/ontology-mainnet","supported-networks/ontology-testnet","supported-networks/op-celestia-raspberry","supported-networks/opbnb","supported-networks/optimism","supported-networks/optimism-sepolia","supported-networks/optopia","supported-networks/peaq","supported-networks/plume","supported-networks/polygon","supported-networks/polygon-amoy","supported-networks/polygon-zkevm","supported-networks/polygon-zkevm-cardona-testnet","supported-networks/public-goods-network","supported-networks/pulsechain","supported-networks/puppynet-shibarium","supported-networks/ronin","supported-networks/rootstock","supported-networks/saakuru","supported-networks/satoshivm","supported-networks/scroll","supported-networks/scroll-sepolia","supported-networks/sepolia","supported-networks/shibarium","supported-networks/shimmer-evm","supported-networks/skale-europa","supported-networks/soneium","supported-networks/sonic","supported-networks/sophon","supported-networks/sophon-testnet","supported-networks/stratovm-testnet","supported-networks/superseed","supported-networks/superseed-sepolia-testnet","supported-networks/swell","supported-networks/taiko","supported-networks/tangle","supported-networks/tanssi-demo","supported-networks/taraxa","supported-networks/telos-evm-mainnet","supported-networks/telos-evm-testnet","supported-networks/torus-mainnet","supported-networks/torus-testnet","supported-networks/unichain","supported-networks/unichain-sepolia","supported-networks/unicorn-ultra-nebulas-testnet","supported-networks/velas-mainnet","supported-networks/viction","supported-networks/worldchain","supported-networks/x-layer-mainnet","supported-networks/x-layer-testnet","supported-networks/xdc","supported-networks/xdc-testnet","supported-networks/zeta","supported-networks/zeta-testnet","supported-networks/zircuit","supported-networks/zklink-nova-mainnet","supported-networks/zksync","supported-networks/zksync-sepolia-testnet","supported-networks/zora","supported-networks/zora-sepolia"]} No newline at end of file
Copy link
Contributor

Choose a reason for hiding this comment

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

💡 Verification agent

🧩 Analysis chain

Duplicate entry: “supported-networks/crossfi-mainnet”.

The array includes this slug twice, which will produce duplicate sidebar items.

Apply:

- ..."supported-networks/crossfi-mainnet","supported-networks/crossfi-mainnet","supported-networks/crossfi-testnet",...
+ ..."supported-networks/crossfi-mainnet","supported-networks/crossfi-testnet",...

Also, please verify for other duplicates and missing files (e.g., potential typo “now-chaint”).

Run:


🏁 Script executed:

#!/bin/bash
set -euo pipefail
echo "Duplicate slugs:"
jq -r '.supportedNetworks[]' supported-networks.json | sort | uniq -d | sed 's/^/  /' || true
echo
echo "Missing doc files (expects .md or .mdx under docs/HyperIndex):"
jq -r '.supportedNetworks[]' supported-networks.json | while read -r slug; do
  if ! test -f "docs/HyperIndex/${slug}.md" && ! test -f "docs/HyperIndex/${slug}.mdx"; then
    echo "  MISSING: ${slug}"
  fi
done

Length of output: 7677


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "Duplicate slugs (sorted):"
jq -r '.supportedNetworks[]' supported-networks.json | sort | uniq -d || true

echo
echo "Duplicates with counts:"
jq -r '.supportedNetworks[]' supported-networks.json | sort | uniq -c | awk '$1>1{print "  "$1"  "$2}' || true

echo
echo "Checking missing docs (docs/HyperIndex/*.md or *.mdx):"
missing_count=0
while IFS= read -r slug; do
  if [ ! -f "docs/HyperIndex/${slug}.md" ] && [ ! -f "docs/HyperIndex/${slug}.mdx" ]; then
    echo "  MISSING: ${slug}"
    missing_count=$((missing_count+1))
  fi
done < <(jq -r '.supportedNetworks[]' supported-networks.json)
echo "Total missing: $missing_count"

echo
echo "Searching for suspicious slugs containing 'chaint' or 'now-':"
jq -r '.supportedNetworks[]' supported-networks.json | grep -nE 'chaint|now-' || true

Length of output: 239


Remove duplicate supported-networks/crossfi-mainnet in supported-networks.json

Confirmed: "supported-networks/crossfi-mainnet" appears 2× — remove the extra entry to avoid duplicate sidebar items.

Apply:

- ..."supported-networks/crossfi-mainnet","supported-networks/crossfi-mainnet","supported-networks/crossfi-testnet",...
+ ..."supported-networks/crossfi-mainnet","supported-networks/crossfi-testnet",...
  • Unable to verify missing docs in this environment (process-substitution /dev/fd error). Run locally to list missing docs:
    jq -r '.supportedNetworks[]' supported-networks.json | while IFS= read -r slug; do if [ ! -f "docs/HyperIndex/${slug}.md" ] && [ ! -f "docs/HyperIndex/${slug}.mdx" ]; then echo "MISSING: ${slug}"; fi; done

  • Verify slug "now-chaint" for a typo in supported-networks.json.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
"supported-networks/0g-newton-testnet","supported-networks/abstract","supported-networks/aleph-zero-evm","supported-networks/altlayer-op-demo-testnet","supported-networks/ancient8","supported-networks/arbitrum","supported-networks/arbitrum-blueberry","supported-networks/arbitrum-nova","supported-networks/arbitrum-sepolia","supported-networks/artela-testnet","supported-networks/arthera-mainnet","supported-networks/asset-chain-mainnet","supported-networks/astar-zkevm","supported-networks/astar-zkyoto","supported-networks/aurora","supported-networks/aurora-turbo","supported-networks/avalanche","supported-networks/b2-hub-testnet","supported-networks/b3","supported-networks/b3-sepolia-testnet","supported-networks/base","supported-networks/base-sepolia","supported-networks/beam","supported-networks/berachain","supported-networks/berachain-artio-testnet","supported-networks/berachain-bartio","supported-networks/bevm-mainnet","supported-networks/bevm-testnet","supported-networks/bitfinity-mainnet","supported-networks/bitfinity-testnet","supported-networks/bitgert-mainnet","supported-networks/bitlayer","supported-networks/blast","supported-networks/blast-sepolia","supported-networks/bob-mainnet","supported-networks/boba","supported-networks/boba-bnb-mainnet","supported-networks/botanix-testnet","supported-networks/bsc","supported-networks/bsc-testnet","supported-networks/canto","supported-networks/canto-testnet","supported-networks/celo","supported-networks/celo-alfajores-testnet","supported-networks/chainweb-testnet-20","supported-networks/chainweb-testnet-21","supported-networks/chiliz","supported-networks/chiliz-testnet-spicy","supported-networks/citrea-devnet","supported-networks/citrea-testnet","supported-networks/core","supported-networks/creator-testnet","supported-networks/cronos-zkevm","supported-networks/cronos-zkevm-testnet","supported-networks/crossfi-mainnet","supported-networks/crossfi-mainnet","supported-networks/crossfi-testnet","supported-networks/curtis","supported-networks/cyber","supported-networks/damon","supported-networks/degen-chain","supported-networks/dfk-chain","supported-networks/dogechain-mainnet","supported-networks/dogechain-testnet","supported-networks/dos-chain","supported-networks/energy-web","supported-networks/eos","supported-networks/eth","supported-networks/etherlink-testnet","supported-networks/exosama","supported-networks/fantom","supported-networks/fantom-testnet","supported-networks/flare","supported-networks/flare-songbird","supported-networks/flow","supported-networks/flow-testnet","supported-networks/fraxtal","supported-networks/fuel-mainnet","supported-networks/fuel-testnet","supported-networks/fuji","supported-networks/galadriel-devnet","supported-networks/gnosis","supported-networks/gnosis-chiado","supported-networks/gravity-alpha-mainnet","supported-networks/harmony-shard-0","supported-networks/heco-chain","supported-networks/holesky","supported-networks/hyperliquid","supported-networks/immutable-zkevm","supported-networks/immutable-zkevm-testnet","supported-networks/ink","supported-networks/iotex-network","supported-networks/japan-open-chain","supported-networks/kaia","supported-networks/kakarot-starknet-sepolia","supported-networks/kroma","supported-networks/layeredge-testnet","supported-networks/lightlink-pegasus-testnet","supported-networks/lightlink-phoenix","supported-networks/linea","supported-networks/lisk","supported-networks/lukso","supported-networks/lukso-testnet","supported-networks/manta","supported-networks/manta-pacific-sepolia","supported-networks/mantle","supported-networks/megaeth-testnet","supported-networks/merlin","supported-networks/metall2","supported-networks/meter-mainnet","supported-networks/meter-testnet","supported-networks/mev-commit","supported-networks/mint-mainnet","supported-networks/mode","supported-networks/monad-testnet","supported-networks/moonbase-alpha","supported-networks/moonbeam","supported-networks/morph","supported-networks/nautilus","supported-networks/neo-x-testnet","supported-networks/nibiru-testnet","supported-networks/now-chaint","supported-networks/oasis-emerald","supported-networks/oasis-sapphire","supported-networks/onigiri-subnet","supported-networks/onigiri-test-subnet","supported-networks/ontology-mainnet","supported-networks/ontology-testnet","supported-networks/op-celestia-raspberry","supported-networks/opbnb","supported-networks/optimism","supported-networks/optimism-sepolia","supported-networks/optopia","supported-networks/peaq","supported-networks/plume","supported-networks/polygon","supported-networks/polygon-amoy","supported-networks/polygon-zkevm","supported-networks/polygon-zkevm-cardona-testnet","supported-networks/public-goods-network","supported-networks/pulsechain","supported-networks/puppynet-shibarium","supported-networks/ronin","supported-networks/rootstock","supported-networks/saakuru","supported-networks/satoshivm","supported-networks/scroll","supported-networks/scroll-sepolia","supported-networks/sepolia","supported-networks/shibarium","supported-networks/shimmer-evm","supported-networks/skale-europa","supported-networks/soneium","supported-networks/sonic","supported-networks/sophon","supported-networks/sophon-testnet","supported-networks/stratovm-testnet","supported-networks/superseed","supported-networks/superseed-sepolia-testnet","supported-networks/swell","supported-networks/taiko","supported-networks/tangle","supported-networks/tanssi-demo","supported-networks/taraxa","supported-networks/telos-evm-mainnet","supported-networks/telos-evm-testnet","supported-networks/torus-mainnet","supported-networks/torus-testnet","supported-networks/unichain","supported-networks/unichain-sepolia","supported-networks/unicorn-ultra-nebulas-testnet","supported-networks/velas-mainnet","supported-networks/viction","supported-networks/worldchain","supported-networks/x-layer-mainnet","supported-networks/x-layer-testnet","supported-networks/xdc","supported-networks/xdc-testnet","supported-networks/zeta","supported-networks/zeta-testnet","supported-networks/zircuit","supported-networks/zklink-nova-mainnet","supported-networks/zksync","supported-networks/zksync-sepolia-testnet","supported-networks/zora","supported-networks/zora-sepolia"]}
"supported-networks/0g-newton-testnet","supported-networks/abstract","supported-networks/aleph-zero-evm","supported-networks/altlayer-op-demo-testnet","supported-networks/ancient8","supported-networks/arbitrum","supported-networks/arbitrum-blueberry","supported-networks/arbitrum-nova","supported-networks/arbitrum-sepolia","supported-networks/artela-testnet","supported-networks/arthera-mainnet","supported-networks/asset-chain-mainnet","supported-networks/astar-zkevm","supported-networks/astar-zkyoto","supported-networks/aurora","supported-networks/aurora-turbo","supported-networks/avalanche","supported-networks/b2-hub-testnet","supported-networks/b3","supported-networks/b3-sepolia-testnet","supported-networks/base","supported-networks/base-sepolia","supported-networks/beam","supported-networks/berachain","supported-networks/berachain-artio-testnet","supported-networks/berachain-bartio","supported-networks/bevm-mainnet","supported-networks/bevm-testnet","supported-networks/bitfinity-mainnet","supported-networks/bitfinity-testnet","supported-networks/bitgert-mainnet","supported-networks/bitlayer","supported-networks/blast","supported-networks/blast-sepolia","supported-networks/bob-mainnet","supported-networks/boba","supported-networks/boba-bnb-mainnet","supported-networks/botanix-testnet","supported-networks/bsc","supported-networks/bsc-testnet","supported-networks/canto","supported-networks/canto-testnet","supported-networks/celo","supported-networks/celo-alfajores-testnet","supported-networks/chainweb-testnet-20","supported-networks/chainweb-testnet-21","supported-networks/chiliz","supported-networks/chiliz-testnet-spicy","supported-networks/citrea-devnet","supported-networks/citrea-testnet","supported-networks/core","supported-networks/creator-testnet","supported-networks/cronos-zkevm","supported-networks/cronos-zkevm-testnet","supported-networks/crossfi-mainnet","supported-networks/crossfi-testnet","supported-networks/curtis","supported-networks/cyber","supported-networks/damon","supported-networks/degen-chain","supported-networks/dfk-chain","supported-networks/dogechain-mainnet","supported-networks/dogechain-testnet","supported-networks/dos-chain","supported-networks/energy-web","supported-networks/eos","supported-networks/eth","supported-networks/etherlink-testnet","supported-networks/exosama","supported-networks/fantom","supported-networks/fantom-testnet","supported-networks/flare","supported-networks/flare-songbird","supported-networks/flow","supported-networks/flow-testnet","supported-networks/fraxtal","supported-networks/fuel-mainnet","supported-networks/fuel-testnet","supported-networks/fuji","supported-networks/galadriel-devnet","supported-networks/gnosis","supported-networks/gnosis-chiado","supported-networks/gravity-alpha-mainnet","supported-networks/harmony-shard-0","supported-networks/heco-chain","supported-networks/holesky","supported-networks/hyperliquid","supported-networks/immutable-zkevm","supported-networks/immutable-zkevm-testnet","supported-networks/ink","supported-networks/iotex-network","supported-networks/japan-open-chain","supported-networks/kaia","supported-networks/kakarot-starknet-sepolia","supported-networks/kroma","supported-networks/layeredge-testnet","supported-networks/lightlink-pegasus-testnet","supported-networks/lightlink-phoenix","supported-networks/linea","supported-networks/lisk","supported-networks/lukso","supported-networks/lukso-testnet","supported-networks/manta","supported-networks/manta-pacific-sepolia","supported-networks/mantle","supported-networks/megaeth-testnet","supported-networks/merlin","supported-networks/metall2","supported-networks/meter-mainnet","supported-networks/meter-testnet","supported-networks/mev-commit","supported-networks/mint-mainnet","supported-networks/mode","supported-networks/monad-testnet","supported-networks/moonbase-alpha","supported-networks/moonbeam","supported-networks/morph","supported-networks/nautilus","supported-networks/neo-x-testnet","supported-networks/nibiru-testnet","supported-networks/now-chaint","supported-networks/oasis-emerald","supported-networks/oasis-sapphire","supported-networks/onigiri-subnet","supported-networks/onigiri-test-subnet","supported-networks/ontology-mainnet","supported-networks/ontology-testnet","supported-networks/op-celestia-raspberry","supported-networks/opbnb","supported-networks/optimism","supported-networks/optimism-sepolia","supported-networks/optopia","supported-networks/peaq","supported-networks/plume","supported-networks/polygon","supported-networks/polygon-amoy","supported-networks/polygon-zkevm","supported-networks/polygon-zkevm-cardona-testnet","supported-networks/public-goods-network","supported-networks/pulsechain","supported-networks/puppynet-shibarium","supported-networks/ronin","supported-networks/rootstock","supported-networks/saakuru","supported-networks/satoshivm","supported-networks/scroll","supported-networks/scroll-sepolia","supported-networks/sepolia","supported-networks/shibarium","supported-networks/shimmer-evm","supported-networks/skale-europa","supported-networks/soneium","supported-networks/sonic","supported-networks/sophon","supported-networks/sophon-testnet","supported-networks/stratovm-testnet","supported-networks/superseed","supported-networks/superseed-sepolia-testnet","supported-networks/swell","supported-networks/taiko","supported-networks/tangle","supported-networks/tanssi-demo","supported-networks/taraxa","supported-networks/telos-evm-mainnet","supported-networks/telos-evm-testnet","supported-networks/torus-mainnet","supported-networks/torus-testnet","supported-networks/unichain","supported-networks/unichain-sepolia","supported-networks/unicorn-ultra-nebulas-testnet","supported-networks/velas-mainnet","supported-networks/viction","supported-networks/worldchain","supported-networks/x-layer-mainnet","supported-networks/x-layer-testnet","supported-networks/xdc","supported-networks/xdc-testnet","supported-networks/zeta","supported-networks/zeta-testnet","supported-networks/zircuit","supported-networks/zklink-nova-mainnet","supported-networks/zksync","supported-networks/zksync-sepolia-testnet","supported-networks/zora","supported-networks/zora-sepolia"]}
🤖 Prompt for AI Agents
supported-networks.json around line 5: the array contains a duplicated
"supported-networks/crossfi-mainnet" entry causing duplicate sidebar items;
remove the extra duplicate entry (ensure commas and JSON remain valid) so each
slug is unique, then locally run the provided jq-based check to list missing
docs and manually verify the "now-chaint" slug for a possible typo and correct
it if needed.

Copy link
Contributor

@DenhamPreen DenhamPreen left a comment

Choose a reason for hiding this comment

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

Wohooo!!

@DZakh DZakh merged commit d0c8445 into main Sep 15, 2025
3 checks passed
@DZakh DZakh deleted the dz/2.29.0 branch September 15, 2025 12:52
This was referenced Oct 30, 2025
@coderabbitai coderabbitai bot mentioned this pull request Feb 5, 2026
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