@pythnetwork/pyth-lazer-sui-js 0.2.0 → 0.3.0

package/README.md

@@ -20,16 +20,22 @@ A runnable example is provided at `examples/FetchAndVerifyUpdate.ts`. It:
 
 ### Run the example
 
-Install `tsx` to run TypeScript scripts:
-
 ```sh
-npm install -g tsx
-```
+# Your Sui private key in Bech32 format
+# SUI_KEY=
 
-Execute the example script:
+# Lazer contract state ID
+# STATE_ID=
 
-```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>
+# Your Lazer API token
+# LAZER_TOKEN=
+
+SUI_FULLNODE_URL="https://fullnode.mainnet.sui.io:443"
+
+pnpm run example:fetch-and-verify \
+  --fullnode-url "$SUI_FULLNODE_URL" \
+  --state-id "$STATE_ID" \
+  --lazer-token "$LAZER_TOKEN"
 ```
 
 The script's core logic is summarized below:
@@ -37,38 +43,40 @@ 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(
-  [],
-);
+import { PythLazerClient } from "@pythnetwork/pyth-lazer-sdk";
+import { addParseAndVerifyLeEcdsaUpdateCall } from "@pythnetwork/pyth-lazer-sui-js";
+
+// 1. Fetch the price update from Pyth Lazer in "leEcdsa" format:
+const lazer = await PythLazerClient.create({ token: lazerToken });
+const latestPrice = await lazer.getLatestPrice({
+  priceFeedIds: [1],
+  properties: ["price", "bestBidPrice", "bestAskPrice", "exponent"],
+  formats: ["leEcdsa"],
+  channel: "fixed_rate@200ms",
+  jsonBinaryEncoding: "hex",
+});
+const update = Buffer.from(latestPrice.leEcdsa?.data ?? "", "hex");
 
-// Build transaction calling parse_and_verify_le_ecdsa_update
+// 2. Create a new Sui transaction:
+const client = new SuiClient({ url: fullnodeUrl });
 const tx = new Transaction();
-const packageId = "<pyth_lazer_package_id>";
-const stateObjectId = "<pyth_lazer_state_object_id>";
 
-const updateVal = client.addParseAndVerifyLeEcdsaUpdateCall({
+// 3. Add the parse and verify call:
+const verifiedUpdate = await addParseAndVerifyLeEcdsaUpdateCall({
+  client,
   tx,
-  packageId,
-  stateObjectId,
-  updateBytes: leEcdsa,
+  stateObjectId: stateId,
+  update,
 });
 
-// Sign and execute the transaction using your signer.
-```
-
-## Notes
+// 4. Consume `verifiedUpdate` in your own contract with additional calls...
 
-- FIXME: Automatic `packageId` management is coming soon. The Lazer contract doesn't support upgradeability yet.
+// 5. Sign and execute the transaction:
+const result = await client.signAndExecuteTransaction({
+  transaction: tx,
+  signer,
+});
+```
 
 ## References
 

package/dist/cjs/index.cjs

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "addParseAndVerifyLeEcdsaUpdateCall", {
+    enumerable: true,
+    get: function() {
+        return addParseAndVerifyLeEcdsaUpdateCall;
+    }
+});
+async function addParseAndVerifyLeEcdsaUpdateCall(opts) {
+    const { client, tx, stateObjectId, update } = opts;
+    const latestPackageId = await getLatestPackageId(client, stateObjectId);
+    return tx.moveCall({
+        target: `${latestPackageId}::pyth_lazer::parse_and_verify_le_ecdsa_update`,
+        arguments: [
+            tx.object(stateObjectId),
+            tx.object.clock(),
+            tx.pure.vector("u8", update)
+        ]
+    });
+}
+async function getLatestPackageId(client, stateObjectId) {
+    const { data: stateObject, error } = await client.getObject({
+        id: stateObjectId,
+        options: {
+            showContent: true
+        }
+    });
+    if (!stateObject?.content || error) {
+        throw new Error(`Failed to get Sui Lazer State: ${error?.code ?? "undefined"}`);
+    }
+    if (stateObject.content.dataType !== "moveObject") {
+        throw new Error(`Sui Lazer State must be an object, got: ${stateObject.content.dataType}`);
+    }
+    const state = stateObject.content;
+    if (!hasStructField(state, "upgrade_cap")) {
+        throw new Error("Missing 'upgrade_cap' in Sui Lazer State");
+    }
+    const upgradeCap = state.fields.upgrade_cap;
+    if (!hasStructField(upgradeCap, "package") || typeof upgradeCap.fields.package !== "string") {
+        throw new Error("Could not find 'package' string in Sui Lazer UpgradeCap");
+    }
+    return upgradeCap.fields.package;
+}
+function hasStructField(value, name) {
+    return hasProperty(value, "fields") && hasProperty(value.fields, name);
+}
+function hasProperty(value, name) {
+    return typeof value === "object" && !!value && name in value;
+}

package/dist/cjs/index.d.ts

@@ -0,0 +1,8 @@
+import type { SuiClient } from "@mysten/sui/client";
+import { Transaction } from "@mysten/sui/transactions";
+export declare function addParseAndVerifyLeEcdsaUpdateCall(opts: {
+    client: SuiClient;
+    tx: Transaction;
+    stateObjectId: string;
+    update: Uint8Array;
+}): Promise<import("@mysten/sui/transactions").TransactionResult>;

package/dist/esm/index.d.ts

@@ -0,0 +1,8 @@
+import type { SuiClient } from "@mysten/sui/client";
+import { Transaction } from "@mysten/sui/transactions";
+export declare function addParseAndVerifyLeEcdsaUpdateCall(opts: {
+    client: SuiClient;
+    tx: Transaction;
+    stateObjectId: string;
+    update: Uint8Array;
+}): Promise<import("@mysten/sui/transactions").TransactionResult>;

package/dist/esm/index.mjs

@@ -0,0 +1,41 @@
+export async function addParseAndVerifyLeEcdsaUpdateCall(opts) {
+    const { client, tx, stateObjectId, update } = opts;
+    const latestPackageId = await getLatestPackageId(client, stateObjectId);
+    return tx.moveCall({
+        target: `${latestPackageId}::pyth_lazer::parse_and_verify_le_ecdsa_update`,
+        arguments: [
+            tx.object(stateObjectId),
+            tx.object.clock(),
+            tx.pure.vector("u8", update)
+        ]
+    });
+}
+async function getLatestPackageId(client, stateObjectId) {
+    const { data: stateObject, error } = await client.getObject({
+        id: stateObjectId,
+        options: {
+            showContent: true
+        }
+    });
+    if (!stateObject?.content || error) {
+        throw new Error(`Failed to get Sui Lazer State: ${error?.code ?? "undefined"}`);
+    }
+    if (stateObject.content.dataType !== "moveObject") {
+        throw new Error(`Sui Lazer State must be an object, got: ${stateObject.content.dataType}`);
+    }
+    const state = stateObject.content;
+    if (!hasStructField(state, "upgrade_cap")) {
+        throw new Error("Missing 'upgrade_cap' in Sui Lazer State");
+    }
+    const upgradeCap = state.fields.upgrade_cap;
+    if (!hasStructField(upgradeCap, "package") || typeof upgradeCap.fields.package !== "string") {
+        throw new Error("Could not find 'package' string in Sui Lazer UpgradeCap");
+    }
+    return upgradeCap.fields.package;
+}
+function hasStructField(value, name) {
+    return hasProperty(value, "fields") && hasProperty(value.fields, name);
+}
+function hasProperty(value, name) {
+    return typeof value === "object" && !!value && name in value;
+}

package/package.json

@@ -1,53 +1,67 @@
 {
   "name": "@pythnetwork/pyth-lazer-sui-js",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "TypeScript SDK for the Pyth Lazer Sui contract",
   "license": "Apache-2.0",
   "type": "module",
-  "engines": {
-    "node": ">=22.14.0"
-  },
   "files": [
-    "dist/**/*"
+    "dist/**"
   ],
-  "exports": {
-    "./client": {
-      "require": {
-        "types": "./dist/cjs/client.d.ts",
-        "default": "./dist/cjs/client.cjs"
-      },
-      "import": {
-        "types": "./dist/esm/client.d.ts",
-        "default": "./dist/esm/client.mjs"
-      }
-    },
-    "./package.json": "./package.json"
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pyth-network/pyth-crosschain",
+    "directory": "lazer/contracts/pyth-lazer-sui-js"
   },
-  "sideEffects": false,
-  "dependencies": {
-    "@mysten/sui": "^1.3.0",
-    "@types/yargs": "^17.0.33",
-    "yargs": "^18.0.0",
-    "@pythnetwork/pyth-lazer-sdk": "5.2.0"
+  "engines": {
+    "node": "^24.0.0"
   },
+  "sideEffects": false,
   "devDependencies": {
     "@cprussin/eslint-config": "^4.0.2",
+    "@cprussin/prettier-config": "^2.2.2",
     "@cprussin/tsconfig": "^3.1.2",
+    "@pythnetwork/jest-config": "",
+    "@types/jest": "^29.5.14",
     "@types/node": "^22.14.0",
+    "@types/yargs": "^17.0.33",
     "eslint": "^9.23.0",
-    "prettier": "^3.5.3"
+    "jest": "^29.7.0",
+    "tsx": "4.20.6",
+    "yargs": "^18.0.0",
+    "@pythnetwork/pyth-lazer-sdk": "5.2.1"
+  },
+  "dependencies": {
+    "@mysten/sui": "^1.3.0"
   },
+  "private": false,
   "publishConfig": {
     "access": "public"
   },
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.cjs"
+      },
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.mjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "module": "./dist/esm/index.mjs",
+  "types": "./dist/cjs/index.d.ts",
+  "main": "./dist/cjs/index.cjs",
   "scripts": {
-    "build": "ts-duality --clean",
+    "build": "ts-duality --copyOtherFiles",
+    "clean": "rm -rf ./dist",
+    "fix:lint": "eslint --fix . --max-warnings 0",
     "fix:format": "prettier --write .",
-    "fix:lint": "eslint --fix .",
-    "test:format": "prettier --check .",
     "test:lint": "eslint . --max-warnings 0",
+    "test:format": "prettier --check .",
     "test:types": "tsc",
-    "example:fetch-and-verify": "tsx examples/fetch-and-verify-update.ts",
-    "clean": "rm -rf ./dist"
+    "test:unit": "test-unit",
+    "example:fetch-and-verify": "tsx src/examples/fetch-and-verify.ts"
   }
 }

package/dist/cjs/client.cjs

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "addParseAndVerifyLeEcdsaUpdateCall", {
-    enumerable: true,
-    get: function() {
-        return addParseAndVerifyLeEcdsaUpdateCall;
-    }
-});
-const _bcs = require("@mysten/sui/bcs");
-const _utils = 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.SUI_CLOCK_OBJECT_ID),
-            tx.pure(_bcs.bcs.vector(_bcs.bcs.U8).serialize(updateBytes).toBytes())
-        ]
-    });
-    return updateObj;
-}

package/dist/cjs/client.d.ts

@@ -1,10 +0,0 @@
-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/client.d.ts

@@ -1,10 +0,0 @@
-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/client.mjs

@@ -1,13 +0,0 @@
-import { bcs } from "@mysten/sui/bcs";
-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;
-}