Merge remote-tracking branch 'origin/main' into doc/add-rtdata-example-info

Author: masterjedy

AGENTS.md

@@ -0,0 +1,43 @@
+# Agent Playbook
+
+## Repository Snapshot
+
+- Documentation site built with Next.js 13 and Nextra (`pages/` holds `.mdx` content, `_meta.json` defines navigation order).
+- Key scripts: `npm run dev`, `npm run build`, `npm run start`, `npm run lint`.
+- Node.js 22 is available; Python execution may be blocked in this environment.
+
+## Workflow Guidelines
+
+- Default to `apply_patch` for hand edits; avoid bulk formatters unless requested.
+- Keep additions ASCII unless the surrounding file already uses Unicode.
+- Preserve any pre-existing local changes; never revert files you did not modify for the current task.
+- When touching documentation directories, update the sibling `_meta.json` so every `.mdx`/`.md` page appears in the navigation.
+- Comment only when clarification is essential—most prose and code should remain self-explanatory.
+
+## Documentation Style
+
+- Organize content according to the [Diátaxis](https://diataxis.fr/) framework: Tutorials (learning-oriented), How-to guides (goal-oriented), Explanations (understanding-oriented), and Reference (information-oriented).
+- Tutorials: guide the reader through a concrete end-to-end task; assume no prior knowledge, provide step-by-step instructions, and postpone theory until after success.
+- How-to guides: focus on achieving a specific outcome; start with prerequisites, list concise actionable steps, and limit background details to what is essential for completing the task.
+- Explanations: clarify concepts, trade-offs, and rationale; connect ideas, reference related materials, and avoid procedural instructions.
+- Reference: present facts, APIs, configuration tables, and schemas; structure information for quick lookup with consistent formatting and terminology.
+- Match the existing section type when editing; move or split content if it drifts outside the intended Diátaxis category.
+- Lead with user needs, keep paragraphs short, and surface actionable steps early for tutorials and how-to guides.
+- Use consistent terminology across related pages; prefer active voice and second person.
+- Include code snippets or command blocks only when they advance the user goal for that section type.
+
+## Command & Sandbox Notes
+
+- Run shell commands through `bash -lc` and always set the `workdir` argument (usually the repo root).
+- Network access is restricted; prefer local data. Use `rg` for searching.
+- Destructive git commands (`reset --hard`, `checkout --`) are off limits unless the user explicitly requests them.
+
+## Validation
+
+- Run `npm run lint` after significant content or component changes when feasible.
+- For structural documentation edits, double-check rendered navigation by restarting the docs dev server if already running.
+
+## Deliverables
+
+- Summaries should state what changed and reference file paths with line numbers when practical.
+- Suggest logical follow-up actions (tests, builds, deploy checks) when they help the user.

README.md

@@ -4,11 +4,6 @@ This repository contains interactive documentation for the [Pyth Network](https:
 
 ## Documentation Format
 
-### Interactive components
-
-The interactive components on each page use a shared-key value store to communicate with each other.
-This key-value store is
-
 ## Local Development
 
 First, run `npm i` to install the dependencies.
@@ -27,21 +22,6 @@ docker run -d -p 3000:3000 documentation
 
 Then navigate to localhost:3000 in the browser.
 
-## Tests
-
-Simply run `npm run test`.
-
-The tests include a compiler check for all code snippets written in .mdx files. These tests will automatically extract
-the relevant snippets into separate files under the `.code_tests` folder (ignored by git) and then try to build each one.
-The files are named per the file path to the code snippet.
-These files remain after the tests complete, which allows you to examine them to help debug the error in case a test fails.
-
-You can also run the code tests for a specific mdx file using:
-
-```
-npm run test -- -t get-price.mdx
-```
-
 ## License
 
 This project is derived from the [Nextra Docs Template](https://github.com/shuding/nextra-docs-template).

components/EntropyDeploymentTable.tsx

@@ -8,7 +8,9 @@ const EntropyDeploymentTable = ({
   deployments: Record<string, EntropyDeployment>;
   showReveal: boolean;
 }) => {
-  const sortedDeployments = Object.entries(deployments).sort();
+  const sortedDeployments = Object.entries(deployments)
+    .filter(([name]) => name !== "monad" && name !== "etherlink-testnet")
+    .sort();
   return (
     <table>
       <thead>

components/EntropyDeploymentsConfig.ts

@@ -16,10 +16,26 @@ export const EntropyDeploymentsConfig: Record<string, ChainOverride> = {
   "998": {
     rpc: "https://rpc.hyperliquid-testnet.xyz/evm",
     nativeCurrency: "HYPE",
-    explorer: "https://testnet.purrsec.com/",
+    explorer: "https://app.hyperliquid-testnet.xyz/explorer",
   },
   "999": {
     rpc: "https://rpc.hypurrscan.io",
     nativeCurrency: "HYPE",
+    explorer: "https://hyperevmscan.io",
+  },
+  "1328": {
+    explorer: "https://testnet.seiscan.io",
+  },
+  "1992": {
+    explorer: "https://sanko-arb-sepolia.explorer.caldera.xyz",
+  },
+  "9788": {
+    explorer: "https://testnetv2.tabiscan.com",
+  },
+  "14601": {
+    explorer: "https://testnet.sonicscan.org",
+  },
+  "91342": {
+    explorer: "https://sepolia-explorer.giwa.io",
   },
 };

components/EntropyFeeTable.tsx

@@ -42,7 +42,9 @@ const FeeTable = ({
     }
   }, [deployments]);
 
-  const sortedDeployments = Object.entries(deployments).sort();
+  const sortedDeployments = Object.entries(deployments)
+    .filter(([name]) => name !== "etherlink-testnet")
+    .sort();
   return (
     <table>
       <thead>

components/LazerPriceIdTable.tsx

@@ -69,22 +69,32 @@ const LoadedLazerPriceIdTable = ({
   }, []);
 
   const filteredFeeds = useMemo(() => {
+    const searchTerms = search
+      .split(/[,\s]+/)
+      .map((term) => term.trim().toLowerCase())
+      .filter((term) => term.length > 0);
+
+    if (searchTerms.length === 0) {
+      return priceFeeds;
+    }
+
     return priceFeeds.filter((feed) => {
-      const searchLower = search.toLowerCase();
-      return (
-        feed.symbol.toLowerCase().includes(searchLower) ||
-        feed.name.toLowerCase().includes(searchLower) ||
-        feed.description.toLowerCase().includes(searchLower) ||
-        feed.pyth_lazer_id.toString().includes(searchLower)
-      );
+      return searchTerms.some((searchTerm) => {
+        return (
+          feed.symbol.toLowerCase().includes(searchTerm) ||
+          feed.name.toLowerCase().includes(searchTerm) ||
+          feed.description.toLowerCase().includes(searchTerm) ||
+          feed.pyth_lazer_id.toString().includes(searchTerm)
+        );
+      });
     });
   }, [priceFeeds, search]);
 
   return (
     <div>
       <input
         type="text"
-        placeholder="Search by symbol, name, description, or pyth lazer id..."
+        placeholder="Search by symbol, name, description, or pyth pro id (comma or space separated for multiple)..."
         value={search}
         onChange={updateSearch}
         className="w-full p-2 mb-4 border border-gray-300 rounded-md"
@@ -96,7 +106,7 @@ const LoadedLazerPriceIdTable = ({
             <th>Description</th>
             <th>Name</th>
             <th>Symbol</th>
-            <th>Pyth Lazer Id</th>
+            <th>Pyth Pro Id</th>
             <th>Exponent</th>
           </tr>
         </thead>

components/icons/ProductIcons.tsx

@@ -9,6 +9,11 @@ import {
   Clock,
   ArrowsOutCardinal,
   DiceSixIcon,
+  ListBullets,
+  Key,
+  Play,
+  BookOpen,
+  MoneyWavy,
 } from "@phosphor-icons/react";
 
 export function BarChartIcon() {
@@ -46,3 +51,23 @@ export function MultiChainIcon() {
 export function DiceIcon() {
   return <DiceSixIcon className="w-5 h-5" weight="regular" />;
 }
+
+export function ListIcon() {
+  return <ListBullets className="w-5 h-5" weight="regular" />;
+}
+
+export function KeyIcon() {
+  return <Key className="w-5 h-5" weight="regular" />;
+}
+
+export function PlayIcon() {
+  return <Play className="w-5 h-5" weight="regular" />;
+}
+
+export function BookIcon() {
+  return <BookOpen className="w-5 h-5" weight="regular" />;
+}
+
+export function MoneyWavyIcon() {
+  return <MoneyWavy className="w-5 h-5" weight="regular" />;
+}

images/entropy/commit_and_reveal.png

@@ -86,11 +86,19 @@ const permanentRedirectArray = [
   ["/pythnet-price-feeds/hermes", "/price-feeds/how-pyth-works/hermes"],
   [
     "/documentation/pythnet-price-feeds/scheduler",
+    "/price-feeds/schedule-price-updates/using-price-pusher",
+  ],
+  [
     "/price-feeds/schedule-price-updates/using-scheduler",
+    "/price-feeds/schedule-price-updates/using-price-pusher",
   ],
   [
     "/documentation/pythnet-price-feeds/off-chain",
+    "/price-feeds/core/fetch-price-updates",
+  ],
+  [
     "/price-feeds/use-real-time-data/off-chain",
+    "/price-feeds/core/fetch-price-updates",
   ],
   [
     "/documentation/pythnet-price-feeds/evm",
@@ -114,6 +122,23 @@ const permanentRedirectArray = [
     "/home/oracle-integrity-staking/reward-examples",
   ],
   ["/guides", "/price-feeds"],
+
+  // Lazer (top-level) to Pyth Pro Redirects - MUST come before general price-feeds redirects
+  ["/lazer", "/price-feeds/pro"],
+  ["/lazer/:path*", "/price-feeds/pro/:path*"],
+
+  // Explicitly map legacy lazer paths under /price-feeds to Pro - MUST come before general price-feeds redirects
+  ["/price-feeds/lazer", "/price-feeds/pro"],
+  ["/price-feeds/lazer/:path*", "/price-feeds/pro/:path*"],
+
+  ["/price-feeds/:path((?!core/|pro(?:/|$)).*)", "/price-feeds/core/:path"],
+  // some other price feed redirects
+  ["/price-feeds/sponsored-feeds", "/price-feeds/push-feeds"],
+  [
+    "/price-feeds/use-real-time-data/:path((?!pull-integration(?:/|$)).*)",
+    "/price-feeds/use-real-time-data/pull-integration/:path",
+  ],
+
   ["/benchmarks", "/price-feeds/use-historic-price-data"],
   [
     "/benchmarks/how-to-create-tradingview-charts",

next.config.js

@@ -9,11 +9,6 @@
     "type": "page"
   },
 
-  "lazer": {
-    "title": "Lazer",
-    "type": "page"
-  },
-
   "express-relay": {
     "title": "Express Relay",
     "type": "page"