Chore(lazer) add lazer docs (#554)

* layout

* table

* pre-commit

* temp

* fetch price updates guide

* update

* evm example

* updates

* push

* update

* restructure

* update

* udpate

* fix build

* svm guide update

* fix: remove todos and non existent links

---------

Co-authored-by: Ali Behjati <bahjatia@gmail.com>

Author: aditya520

components/LazerPriceIdTable.tsx

@@ -0,0 +1,98 @@
+import { useEffect, useState } from "react";
+import { StyledTd } from "./Table";
+import { Spinner } from "./Spinner";
+const fetchLazerPriceIdMetadata = async () => {
+  const response = await fetch(
+    "https://pyth-lazer-staging.dourolabs.app/history/v1/symbols"
+  );
+  const data = await response.json();
+  return data;
+};
+
+type LazerPriceIdMetadata = {
+  asset_type: string;
+  description: string;
+  exponent: number;
+  name: string;
+  pyth_lazer_id: number;
+  symbol: string;
+};
+
+enum LazerPriceIdStateType {
+  NotLoaded,
+  Loading,
+  Loaded,
+  Error,
+}
+
+const LazerPriceIdState = {
+  NotLoaded: () => ({ type: LazerPriceIdStateType.NotLoaded as const }),
+  Loading: () => ({ type: LazerPriceIdStateType.Loading as const }),
+  Loaded: (priceFeeds: LazerPriceIdMetadata[]) => ({
+    type: LazerPriceIdStateType.Loaded as const,
+    priceFeeds,
+  }),
+  Error: (error: unknown) => ({
+    type: LazerPriceIdStateType.Error as const,
+    error,
+  }),
+};
+
+type LazerPriceIdState = ReturnType<
+  typeof LazerPriceIdState[keyof typeof LazerPriceIdState]
+>;
+
+const useLazerPriceIdState = () => {
+  const [state, setState] = useState<LazerPriceIdState>(
+    LazerPriceIdState.NotLoaded()
+  );
+
+  useEffect(() => {
+    setState(LazerPriceIdState.Loading());
+    fetchLazerPriceIdMetadata()
+      .then((priceFeeds) => setState(LazerPriceIdState.Loaded(priceFeeds)))
+      .catch((error) => setState(LazerPriceIdState.Error(error)));
+  }, []);
+
+  return state;
+};
+
+export function LazerPriceIdTable() {
+  const lazerPriceIdState = useLazerPriceIdState();
+
+  switch (lazerPriceIdState.type) {
+    case LazerPriceIdStateType.NotLoaded:
+      return <div>Loading...</div>;
+    case LazerPriceIdStateType.Loading:
+      return <Spinner />;
+    case LazerPriceIdStateType.Loaded:
+      return (
+        <table>
+          <thead>
+            <tr>
+              <th>Asset Type</th>
+              <th>Description</th>
+              <th>Name</th>
+              <th>Symbol</th>
+              <th>Pyth Lazer Id</th>
+              <th>Exponent</th>
+            </tr>
+          </thead>
+          <tbody>
+            {lazerPriceIdState.priceFeeds.map((priceFeed) => (
+              <tr key={priceFeed.symbol}>
+                <StyledTd>{priceFeed.asset_type}</StyledTd>
+                <StyledTd>{priceFeed.description}</StyledTd>
+                <StyledTd>{priceFeed.name}</StyledTd>
+                <StyledTd>{priceFeed.symbol}</StyledTd>
+                <StyledTd>{priceFeed.pyth_lazer_id}</StyledTd>
+                <StyledTd>{priceFeed.exponent}</StyledTd>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      );
+    case LazerPriceIdStateType.Error:
+      return <div>Error</div>;
+  }
+}

components/Spinner.tsx

@@ -0,0 +1,23 @@
+import { SVGProps } from "react";
+export const Spinner = (props: SVGProps<SVGSVGElement>) => (
+  <div role="status">
+    <svg
+      aria-hidden="true"
+      className="w-8 h-8 text-gray-200 animate-spin dark:text-gray-600 fill-blue-600"
+      viewBox="0 0 100 101"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+      {...props}
+    >
+      <path
+        d="M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z"
+        fill="currentColor"
+      />
+      <path
+        d="M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z"
+        fill="currentFill"
+      />
+    </svg>
+    <span className="sr-only">Loading...</span>
+  </div>
+);

images/lazer/Pyth_Laser_table.png

@@ -9,6 +9,11 @@
     "type": "page"
   },
 
+  "lazer": {
+    "title": "Lazer",
+    "type": "page"
+  },
+
   "benchmarks": {
     "title": "Benchmarks",
     "type": "page"

pages/_meta.json

@@ -11,6 +11,11 @@
     "href": "/price-feeds"
   },
 
+  "Lazer": {
+    "title": "Lazer →",
+    "href": "/lazer"
+  },
+
   "Benchmarks": {
     "title": "Benchmarks →",
     "href": "/benchmarks"

pages/home/_meta.json

@@ -8,6 +8,7 @@ Pyth Network offers several products for developers:
 
 - [Price Feeds](../price-feeds) provide real-time prices for 500+ assets on 55+ blockchain ecosystems, including Solana, many EVM chains,
   Aptos, Sui, NEAR, and several Cosmos chains.
+- [Lazer](../lazer) [TODO]
 - [Benchmarks](../benchmarks) provides historical Pyth prices for both on- and off-chain use.
 - [Express Relay](../express-relay/) enables protocols to eliminate their MEV while gaining access to active searchers and liquidators.
 - [Entropy](../entropy) allows developers to generate secure random numbers on the blockchain.

pages/home/index.mdx

@@ -0,0 +1,46 @@
+{
+  "documentation-home": {
+    "title": "← Documentation Home",
+    "href": "/home"
+  },
+
+  "-- Lazer": {
+    "title": "Lazer",
+    "type": "separator"
+  },
+  "index": "Introduction",
+  "getting-started": "Getting Started",
+
+  "-- How-to Guides": {
+    "title": "How-To Guides",
+    "type": "separator"
+  },
+
+  "subscribe-price-updates": "Subscribe to Price Updates",
+  "integrate-as-consumer": "Integrate as a Consumer",
+  "integrate-as-publisher": "Integrate as a Publisher",
+
+  "-- Reference Material": {
+    "title": "Reference Material",
+    "type": "separator"
+  },
+  "price-feeds-ids": "Price Feed IDs",
+
+  "websocket-api-reference": {
+    "title": "Websocket API Reference ↗",
+    "href": "https://pyth-lazer.dourolabs.app/docs",
+    "newWindow": true
+  },
+
+  "examples": {
+    "title": "Example Applications ↗",
+    "href": "https://github.com/pyth-network/pyth-examples/tree/main/lazer",
+    "newWindow": true
+  },
+  "-- Understand Lazer": {
+    "title": "Understanding Lazer",
+    "type": "separator"
+  },
+
+  "how-lazer-works": "How Lazer Works"
+}

pages/lazer/_meta.json

@@ -0,0 +1,3 @@
+# Getting Started with Pyth Lazer
+
+Please refer to the how-to guides to get started.

pages/lazer/getting-started.mdx

@@ -0,0 +1,5 @@
+# How Pyth Lazer works
+
+Pyth Lazer is a permissioned service that provides ultra-low-latency price and market data to highly latency-sensitive users.
+
+We are working on writing a detailed technical overview how Lazer works. Details will be added here as they are completed.

pages/lazer/how-lazer-works.mdx

@@ -0,0 +1,20 @@
+import Image from "next/image";
+
+# Pyth Lazer
+
+Pyth Lazer is a low latency, highly customizable price oracle.
+It offers a customizable set of price feeds, target chains (EVM or Solana) and channels (real time or fixed rate):
+
+- Real time channels send updates as frequently as they become available;
+- Fixed rate channels send updates at fixed time intervals (you can choose between 50 ms or 200 ms).
+
+The table below shows the difference between Pyth Core and Pyth Lazer:
+
+|                         | **Pyth Core**                                                                                            | **Pyth Lazer**                                                                                                                      |
+| ----------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| **Solution Type**       | Stable, secure, and decentralized price data source for a broad spectrum of DeFi or TradFi applications. | **Permissioned** service focused on **ultra-low-latency** price and market data for highly latency-sensitive users.                 |
+| **Frequency**           | 400ms on Pythnet appchain with support for risk mitigation via Benchmarks and confidence intervals.      | **1ms** (**real-time**), 50ms, and 200ms channels, **customizable** frequencies, and throttling support to address different needs. |
+| **Data Types**          | Aggregate price and confidence intervals.                                                                | Aggregate price, bid/ask price, and **customizable** market data (market depth and more).                                           |
+| **Fees**                | On-chain fee per signed cross-chain price update.                                                        | On-chain fee per signed cross-chain price update.                                                                                   |
+| **Update Costs**        | >1,000-byte proofs and complex signature verification.                                                   | **100-byte proofs** and simple signature verification.                                                                              |
+| **Integration Process** | Open and permissionless integration for any Web3 or Web2 protocol.                                       | **Specialized** and **permissioned** solution for protocols prioritizing performance over some elements of decentralization.        |