@pythnetwork/pyth-lazer-sui-js 0.1.0

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2025 Pyth Data Association.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,77 @@
+# Pyth Lazer Sui JS SDK
+
+This package provides utilities to create a Sui Programmable Transaction to parse & verify a Pyth Lazer price update on-chain.
+
+## Build
+
+From the repository root:
+
+```sh
+pnpm turbo build -F @pythnetwork/pyth-lazer-sui-js
+```
+
+## Quickstart
+
+A runnable example is provided at `examples/FetchAndVerifyUpdate.ts`. It:
+
+- connects to Lazer via `@pythnetwork/pyth-lazer-sdk`,
+- fetches a single `leEcdsa` payload,
+- composes a Sui transaction calling `parse_and_verify_le_ecdsa_update`.
+
+### Run the example
+
+Install `tsx` to run TypeScript scripts:
+
+```sh
+npm install -g tsx
+```
+
+Execute the example script:
+
+```sh
+SUI_KEY=<YOUR_SUI_PRIVATE_KEY> pnpm -F @pythnetwork/pyth-lazer-sui-js example:fetch-and-verify --fullnodeUrl <SUI_FULLNODE_URL> --packageId <PYTH_LAZER_PACKAGE_ID> --stateObjectId <PYTH_LAZER_STATE_OBJECT_ID> --token <LAZER_TOKEN>
+```
+
+The script's core logic is summarized below:
+
+```ts
+import { SuiClient } from "@mysten/sui/client";
+import { Transaction } from "@mysten/sui/transactions";
+import { SuiLazerClient } from "@pythnetwork/pyth-lazer-sui-js";
+
+// Prepare Mysten Sui client
+const provider = new SuiClient({ url: "<sui-fullnode-url>" });
+
+// Create SDK client
+const client = new SuiLazerClient(provider);
+
+// Obtain a Lazer leEcdsa payload using @pythnetwork/pyth-lazer-sdk.
+// See examples/FetchAndVerifyUpdate.ts for a runnable end-to-end example.
+const leEcdsa: Buffer = /* fetch via @pythnetwork/pyth-lazer-sdk */ Buffer.from(
+  [],
+);
+
+// Build transaction calling parse_and_verify_le_ecdsa_update
+const tx = new Transaction();
+const packageId = "<pyth_lazer_package_id>";
+const stateObjectId = "<pyth_lazer_state_object_id>";
+
+const updateVal = client.addParseAndVerifyLeEcdsaUpdateCall({
+  tx,
+  packageId,
+  stateObjectId,
+  updateBytes: leEcdsa,
+});
+
+// Sign and execute the transaction using your signer.
+```
+
+## Notes
+
+- FIXME: Automatic `packageId` management is coming soon. The Lazer contract doesn't support upgradeability yet.
+
+## References
+
+- Pyth Lazer Sui contract: `lazer/contracts/sui/`
+- Lazer JS SDK (data source): `lazer/sdk/js/`
+- Mysten Sui TS SDK docs: https://sdk.mystenlabs.com/typescript/transaction-building/basics

package/dist/cjs/examples/fetch-and-verify-update.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/examples/fetch-and-verify-update.js

@@ -0,0 +1,106 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const client_1 = require("@mysten/sui/client");
+const ed25519_1 = require("@mysten/sui/keypairs/ed25519");
+const transactions_1 = require("@mysten/sui/transactions");
+const pyth_lazer_sdk_1 = require("@pythnetwork/pyth-lazer-sdk");
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const client_js_1 = require("../src/client.js");
+async function getOneLeEcdsaUpdate(urls, token) {
+    const lazer = await pyth_lazer_sdk_1.PythLazerClient.create({
+        urls,
+        token,
+        numConnections: 1,
+    });
+    const subscription = {
+        subscriptionId: 1,
+        type: "subscribe",
+        priceFeedIds: [1],
+        properties: ["price", "bestBidPrice", "bestAskPrice", "exponent"],
+        formats: ["leEcdsa"],
+        channel: "fixed_rate@200ms",
+        deliveryFormat: "binary",
+        jsonBinaryEncoding: "hex",
+    };
+    lazer.subscribe(subscription);
+    return new Promise((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);
+            }
+        });
+    });
+}
+async function main() {
+    const args = await (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+        .option("fullnodeUrl", {
+        type: "string",
+        description: "URL of the full Sui node RPC endpoint. e.g: https://fullnode.testnet.sui.io:443",
+        demandOption: true,
+    })
+        .option("packageId", {
+        type: "string",
+        description: "Lazer contract package ID",
+        demandOption: true,
+    })
+        .option("stateObjectId", {
+        type: "string",
+        description: "Lazer contract shared State object ID",
+        demandOption: true,
+    })
+        .option("lazerUrls", {
+        type: "array",
+        string: true,
+        description: "Lazer WebSocket URLs",
+        default: [
+            "wss://pyth-lazer-0.dourolabs.app/v1/stream",
+            "wss://pyth-lazer-1.dourolabs.app/v1/stream",
+        ],
+    })
+        .option("lazerToken", {
+        type: "string",
+        description: "Lazer authentication token",
+        demandOption: true,
+    })
+        .help()
+        .parseAsync();
+    // Defined as a dependency in turbo.json
+    // eslint-disable-next-line n/no-process-env
+    if (process.env.SUI_KEY === undefined) {
+        throw new Error(`SUI_KEY environment variable should be set to your Sui private key in hex format.`);
+    }
+    const provider = new client_1.SuiClient({ url: args.fullnodeUrl });
+    // Fetch the price update
+    const updateBytes = await getOneLeEcdsaUpdate(args.lazerUrls, args.lazerToken);
+    // Build the Sui transaction
+    const tx = new transactions_1.Transaction();
+    // Add the parse and verify call
+    (0, client_js_1.addParseAndVerifyLeEcdsaUpdateCall)({
+        tx,
+        packageId: args.packageId,
+        stateObjectId: args.stateObjectId,
+        updateBytes,
+    });
+    // --- You can add more calls to the transaction that consume the parsed update here ---
+    const wallet = ed25519_1.Ed25519Keypair.fromSecretKey(
+    // eslint-disable-next-line n/no-process-env
+    Buffer.from(process.env.SUI_KEY, "hex"));
+    const res = await provider.signAndExecuteTransaction({
+        signer: wallet,
+        transaction: tx,
+        options: { showEffects: true, showEvents: true },
+    });
+    // eslint-disable-next-line no-console
+    console.log("Execution result:", JSON.stringify(res, undefined, 2));
+}
+// eslint-disable-next-line unicorn/prefer-top-level-await
+main().catch((error) => {
+    throw error;
+});

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/src/client.d.ts

@@ -0,0 +1,10 @@
+import { Transaction } from "@mysten/sui/transactions";
+export declare function addParseAndVerifyLeEcdsaUpdateCall({ tx, packageId, stateObjectId, updateBytes, }: {
+    tx: Transaction;
+    packageId: string;
+    stateObjectId: string;
+    updateBytes: Uint8Array;
+}): {
+    $kind: "NestedResult";
+    NestedResult: [number, number];
+} | undefined;

package/dist/cjs/src/client.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addParseAndVerifyLeEcdsaUpdateCall = addParseAndVerifyLeEcdsaUpdateCall;
+const bcs_1 = require("@mysten/sui/bcs");
+const utils_1 = require("@mysten/sui/utils");
+function addParseAndVerifyLeEcdsaUpdateCall({ tx, packageId, stateObjectId, updateBytes, }) {
+    const [updateObj] = tx.moveCall({
+        target: `${packageId}::pyth_lazer::parse_and_verify_le_ecdsa_update`,
+        arguments: [
+            tx.object(stateObjectId),
+            tx.object(utils_1.SUI_CLOCK_OBJECT_ID),
+            tx.pure(bcs_1.bcs.vector(bcs_1.bcs.U8).serialize(updateBytes).toBytes()),
+        ],
+    });
+    return updateObj;
+}

package/dist/esm/examples/fetch-and-verify-update.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/examples/fetch-and-verify-update.js

@@ -0,0 +1,101 @@
+import { SuiClient } from "@mysten/sui/client";
+import { Ed25519Keypair } from "@mysten/sui/keypairs/ed25519";
+import { Transaction } from "@mysten/sui/transactions";
+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, token) {
+    const lazer = await PythLazerClient.create({
+        urls,
+        token,
+        numConnections: 1,
+    });
+    const subscription = {
+        subscriptionId: 1,
+        type: "subscribe",
+        priceFeedIds: [1],
+        properties: ["price", "bestBidPrice", "bestAskPrice", "exponent"],
+        formats: ["leEcdsa"],
+        channel: "fixed_rate@200ms",
+        deliveryFormat: "binary",
+        jsonBinaryEncoding: "hex",
+    };
+    lazer.subscribe(subscription);
+    return new Promise((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);
+            }
+        });
+    });
+}
+async function main() {
+    const args = await yargs(hideBin(process.argv))
+        .option("fullnodeUrl", {
+        type: "string",
+        description: "URL of the full Sui node RPC endpoint. e.g: https://fullnode.testnet.sui.io:443",
+        demandOption: true,
+    })
+        .option("packageId", {
+        type: "string",
+        description: "Lazer contract package ID",
+        demandOption: true,
+    })
+        .option("stateObjectId", {
+        type: "string",
+        description: "Lazer contract shared State object ID",
+        demandOption: true,
+    })
+        .option("lazerUrls", {
+        type: "array",
+        string: true,
+        description: "Lazer WebSocket URLs",
+        default: [
+            "wss://pyth-lazer-0.dourolabs.app/v1/stream",
+            "wss://pyth-lazer-1.dourolabs.app/v1/stream",
+        ],
+    })
+        .option("lazerToken", {
+        type: "string",
+        description: "Lazer authentication token",
+        demandOption: true,
+    })
+        .help()
+        .parseAsync();
+    // Defined as a dependency in turbo.json
+    // eslint-disable-next-line n/no-process-env
+    if (process.env.SUI_KEY === undefined) {
+        throw new Error(`SUI_KEY environment variable should be set to your Sui private key in hex format.`);
+    }
+    const provider = new SuiClient({ url: args.fullnodeUrl });
+    // Fetch the price update
+    const updateBytes = await getOneLeEcdsaUpdate(args.lazerUrls, args.lazerToken);
+    // Build the Sui transaction
+    const tx = new Transaction();
+    // Add the parse and verify call
+    addParseAndVerifyLeEcdsaUpdateCall({
+        tx,
+        packageId: args.packageId,
+        stateObjectId: args.stateObjectId,
+        updateBytes,
+    });
+    // --- You can add more calls to the transaction that consume the parsed update here ---
+    const wallet = Ed25519Keypair.fromSecretKey(
+    // eslint-disable-next-line n/no-process-env
+    Buffer.from(process.env.SUI_KEY, "hex"));
+    const res = await provider.signAndExecuteTransaction({
+        signer: wallet,
+        transaction: tx,
+        options: { showEffects: true, showEvents: true },
+    });
+    // eslint-disable-next-line no-console
+    console.log("Execution result:", JSON.stringify(res, undefined, 2));
+}
+// eslint-disable-next-line unicorn/prefer-top-level-await
+main().catch((error) => {
+    throw error;
+});

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/esm/src/client.d.ts

@@ -0,0 +1,10 @@
+import { Transaction } from "@mysten/sui/transactions";
+export declare function addParseAndVerifyLeEcdsaUpdateCall({ tx, packageId, stateObjectId, updateBytes, }: {
+    tx: Transaction;
+    packageId: string;
+    stateObjectId: string;
+    updateBytes: Uint8Array;
+}): {
+    $kind: "NestedResult";
+    NestedResult: [number, number];
+} | undefined;

package/dist/esm/src/client.js

@@ -0,0 +1,14 @@
+import { bcs } from "@mysten/sui/bcs";
+import { Transaction } from "@mysten/sui/transactions";
+import { SUI_CLOCK_OBJECT_ID } from "@mysten/sui/utils";
+export function addParseAndVerifyLeEcdsaUpdateCall({ tx, packageId, stateObjectId, updateBytes, }) {
+    const [updateObj] = tx.moveCall({
+        target: `${packageId}::pyth_lazer::parse_and_verify_le_ecdsa_update`,
+        arguments: [
+            tx.object(stateObjectId),
+            tx.object(SUI_CLOCK_OBJECT_ID),
+            tx.pure(bcs.vector(bcs.U8).serialize(updateBytes).toBytes()),
+        ],
+    });
+    return updateObj;
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@pythnetwork/pyth-lazer-sui-js",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Pyth Lazer Sui contract",
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": "22"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/client.d.ts",
+        "default": "./dist/esm/client.js"
+      },
+      "require": {
+        "types": "./dist/cjs/client.d.ts",
+        "default": "./dist/cjs/client.js"
+      }
+    }
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@mysten/sui": "^1.3.0",
+    "@types/yargs": "^17.0.33",
+    "yargs": "^18.0.0",
+    "@pythnetwork/pyth-lazer-sdk": "2.0.0"
+  },
+  "devDependencies": {
+    "@cprussin/eslint-config": "^4.0.2",
+    "@cprussin/tsconfig": "^3.1.2",
+    "@types/node": "^22.14.0",
+    "eslint": "^9.23.0",
+    "prettier": "^3.5.3",
+    "typescript": "^5.8.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build:cjs": "tsc --project tsconfig.build.json --verbatimModuleSyntax false --module commonjs --outDir ./dist/cjs && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
+    "build:esm": "tsc --project tsconfig.build.json --outDir ./dist/esm && echo '{\"type\":\"module\"}' > dist/esm/package.json",
+    "fix:format": "prettier --write .",
+    "fix:lint": "eslint --fix .",
+    "test:format": "prettier --check .",
+    "test:lint": "eslint . --max-warnings 0",
+    "test:types": "tsc",
+    "example:fetch-and-verify": "tsx examples/fetch-and-verify-update.ts"
+  }
+}