feat(lazer/js/sdk): add REST endpoints and examples (#3075)

* feat(lazer-sdk): add History service support with get_symbols() function

- Add LazerClientConfig type wrapping WebSocketPoolConfig with historyServiceUrl
- Implement get_symbols() method to query /v1/symbols endpoint
- Add TypeScript interfaces for SymbolResponse and query parameters
- Update example to demonstrate BTC symbol search and subscription
- Add cross-fetch dependency for Node.js compatibility
- Bump version to 2.1.0 following semver for new feature

Co-Authored-By: Tejas Badadare <[email protected]>

* move history endpoint to constants

* feat(lazer-sdk): add Router service support with latest_price and price endpoints

- Add TypeScript interfaces for LatestPriceRequest, PriceRequest, and JsonUpdate
- Update LazerClientConfig to include routerServiceUrl with default
- Implement get_latest_price() and get_price() HTTP methods in PythLazerClient
- Create router-example.ts demonstrating all Router endpoint use cases
- Bump version to 2.2.0 to reflect new Router service functionality
- Add router-example script to package.json for easy testing

Co-Authored-By: Tejas Badadare <[email protected]>

* feat(lazer-js-sdk): update names, add examples

* make wsp.urls optional (use default)

* make wsp.urls optional (use default)

* format

* lint, format

* update lazer sui js sdk to use updated js sdk

* display symbols in streaming example

* lint

* add comment

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

Author: tejasbadadare

Cargo.lock

@@ -1,44 +1,26 @@
 import { SuiClient } from "@mysten/sui/client";
 import { Ed25519Keypair } from "@mysten/sui/keypairs/ed25519";
 import { Transaction } from "@mysten/sui/transactions";
-import type { Request as SubscriptionRequest } from "@pythnetwork/pyth-lazer-sdk";
 import { PythLazerClient } from "@pythnetwork/pyth-lazer-sdk";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 
 import { addParseAndVerifyLeEcdsaUpdateCall } from "../src/client.js";
 
-async function getOneLeEcdsaUpdate(urls: string[], token: string) {
+async function getOneLeEcdsaUpdate(token: string) {
   const lazer = await PythLazerClient.create({
-    urls,
     token,
-    numConnections: 1,
   });
 
-  const subscription: SubscriptionRequest = {
-    subscriptionId: 1,
-    type: "subscribe",
+  const latestPrice = await lazer.get_latest_price({
     priceFeedIds: [1],
     properties: ["price", "bestBidPrice", "bestAskPrice", "exponent"],
     formats: ["leEcdsa"],
     channel: "fixed_rate@200ms",
-    deliveryFormat: "binary",
     jsonBinaryEncoding: "hex",
-  };
-
-  lazer.subscribe(subscription);
-
-  return new Promise<Uint8Array>((resolve) => {
-    lazer.addMessageListener((event) => {
-      if (event.type === "binary" && event.value.leEcdsa) {
-        const buf = event.value.leEcdsa;
-
-        // For the purposes of this example, we only need one update.
-        lazer.shutdown();
-        resolve(buf);
-      }
-    });
   });
+
+  return latestPrice;
 }
 
 async function main() {
@@ -87,10 +69,7 @@ async function main() {
   const provider = new SuiClient({ url: args.fullnodeUrl });
 
   // Fetch the price update
-  const updateBytes = await getOneLeEcdsaUpdate(
-    args.lazerUrls,
-    args.lazerToken,
-  );
+  const update = await getOneLeEcdsaUpdate(args.lazerToken);
 
   // Build the Sui transaction
   const tx = new Transaction();
@@ -100,7 +79,7 @@ async function main() {
     tx,
     packageId: args.packageId,
     stateObjectId: args.stateObjectId,
-    updateBytes,
+    updateBytes: Buffer.from(update.leEcdsa?.data ?? "", "hex"),
   });
 
   // --- You can add more calls to the transaction that consume the parsed update here ---

lazer/contracts/sui/sdk/js/examples/fetch-and-verify-update.ts

@@ -1,6 +1,6 @@
 {
   "name": "@pythnetwork/pyth-lazer-sui-js",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "TypeScript SDK for the Pyth Lazer Sui contract",
   "license": "Apache-2.0",
   "type": "module",

lazer/contracts/sui/sdk/js/package.json

@@ -0,0 +1,48 @@
+/* eslint-disable no-console */
+
+import { displayParsedPrices } from "./util.js";
+import { PythLazerClient } from "../src/index.js";
+
+const client = await PythLazerClient.create({
+  token: "your-token-here",
+  logger: console,
+});
+
+// Example 1: Get latest price for BTC using feed IDs
+console.log("\n=== Example 1: Latest BTC price (requested with feed ID) ===");
+const response1 = await client.get_latest_price({
+  priceFeedIds: [1],
+  properties: ["price", "confidence", "exponent"],
+  formats: [],
+  jsonBinaryEncoding: "hex",
+  parsed: true,
+  channel: "fixed_rate@200ms",
+});
+displayParsedPrices(response1);
+
+// Example 2: Get latest price using symbols
+console.log("\n=== Example 2: Latest ETH price (requested with symbols) ===");
+const response2 = await client.get_latest_price({
+  priceFeedIds: [2],
+  properties: ["price", "confidence", "exponent"],
+  formats: [],
+  parsed: true,
+  channel: "real_time",
+});
+displayParsedPrices(response2);
+
+// Example 3: Get historical price at specific timestamp
+console.log("\n=== Example 3: Historical BTC price at timestamp ===");
+const timestamp = 1_754_348_458_565_000;
+console.log(
+  `Requesting price from timestamp: ${timestamp.toString()} (${new Date(timestamp / 1000).toISOString()})`,
+);
+const response3 = await client.get_price({
+  timestamp: timestamp,
+  priceFeedIds: [1],
+  properties: ["price", "confidence", "exponent"],
+  formats: [],
+  parsed: true,
+  channel: "real_time",
+});
+displayParsedPrices(response3);