@phala/cloud 0.2.1-beta.1 → 0.2.1-beta.3

package/dist/actions/cvms/get_cvm_state.d.ts

@@ -5,23 +5,35 @@ import { type CvmIdInput } from "../../types/cvm_id";
  * CVM state response schema
  */
 export declare const CvmStateSchema: z.ZodObject<{
-    status: z.ZodString;
-    derived_status: z.ZodOptional<z.ZodString>;
-    vm_uuid: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
     instance_id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    status: z.ZodString;
     uptime: z.ZodOptional<z.ZodString>;
+    exited_at: z.ZodOptional<z.ZodString>;
+    boot_progress: z.ZodOptional<z.ZodString>;
+    boot_error: z.ZodOptional<z.ZodString>;
+    shutdown_progress: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     status: string;
+    name: string;
+    id?: string | undefined;
     uptime?: string | undefined;
     instance_id?: string | undefined;
-    vm_uuid?: string | undefined;
-    derived_status?: string | undefined;
+    exited_at?: string | undefined;
+    boot_progress?: string | undefined;
+    boot_error?: string | undefined;
+    shutdown_progress?: string | undefined;
 }, {
     status: string;
+    name: string;
+    id?: string | undefined;
     uptime?: string | undefined;
     instance_id?: string | undefined;
-    vm_uuid?: string | undefined;
-    derived_status?: string | undefined;
+    exited_at?: string | undefined;
+    boot_progress?: string | undefined;
+    boot_error?: string | undefined;
+    shutdown_progress?: string | undefined;
 }>;
 export type CvmState = z.infer<typeof CvmStateSchema>;
 export declare const GetCvmStateRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
@@ -64,10 +76,14 @@ export type GetCvmStateRequest = CvmIdInput;
 declare const getCvmState: {
     (client: Client, params: CvmIdInput): Promise<{
         status: string;
+        name: string;
+        id?: string | undefined;
         uptime?: string | undefined;
         instance_id?: string | undefined;
-        vm_uuid?: string | undefined;
-        derived_status?: string | undefined;
+        exited_at?: string | undefined;
+        boot_progress?: string | undefined;
+        boot_error?: string | undefined;
+        shutdown_progress?: string | undefined;
     }>;
     <T extends z.ZodTypeAny>(client: Client, params: CvmIdInput, parameters: {
         schema: T;
@@ -78,10 +94,14 @@ declare const getCvmState: {
 }, safeGetCvmState: {
     (client: Client, params: CvmIdInput): Promise<import("../..").SafeResult<{
         status: string;
+        name: string;
+        id?: string | undefined;
         uptime?: string | undefined;
         instance_id?: string | undefined;
-        vm_uuid?: string | undefined;
-        derived_status?: string | undefined;
+        exited_at?: string | undefined;
+        boot_progress?: string | undefined;
+        boot_error?: string | undefined;
+        shutdown_progress?: string | undefined;
     }>>;
     <T extends z.ZodTypeAny>(client: Client, params: CvmIdInput, parameters: {
         schema: T;

package/dist/actions/cvms/provision_cvm.d.ts

@@ -56,6 +56,25 @@ import { type Client } from "../../client";
  *   compose_file: { /* ... *\/ },
  * });
  *
+ * // Example 4: Manual nonce specification (Advanced - PHALA KMS only)
+ * import { nextAppIds } from '@phala/cloud';
+ *
+ * // Step 1: Predict next available app_id and nonce
+ * const prediction = await nextAppIds(client, { counts: 1 });
+ * const { app_id, nonce } = prediction.app_ids[0];
+ *
+ * console.log(`Predicted app_id: ${app_id}, nonce: ${nonce}`);
+ *
+ * // Step 2: Provision with the predicted nonce and app_id
+ * const provision = await provisionCvm(client, {
+ *   name: 'my-app-with-manual-nonce',
+ *   instance_type: 'tdx.small',
+ *   kms: 'PHALA',                 // Required: only works with PHALA KMS
+ *   nonce: nonce,                 // Use predicted nonce
+ *   app_id: app_id,               // Use predicted app_id
+ *   compose_file: { /* ... *\/ },
+ * });
+ *
  * console.log(provision.app_id);
  * console.log(provision.compose_hash); // Required for commitCvmProvision
  * ```
@@ -73,6 +92,19 @@ import { type Client } from "../../client";
  *   - Examples: "tdx.small", "tdx.medium", "tdx.large"
  *   - Omit to use the default small instance type
  *
+ * ### Manual Nonce Specification (Advanced - PHALA KMS only)
+ * - **nonce**: User-specified nonce for deterministic app_id generation
+ * - **app_id**: Expected app_id (must match the nonce)
+ * - Workflow:
+ *   1. Call `nextAppIds()` to predict available app_ids and nonces
+ *   2. Use the predicted `nonce` and `app_id` in provision request
+ *   3. System validates that the app_id matches the nonce
+ * - When `nonce` is provided:
+ *   - `app_id` MUST also be provided
+ *   - Only works with PHALA KMS type
+ *   - Use case: Predicting app_id before deployment for smart contract integration
+ * - If both omitted, system automatically generates the next available nonce
+ *
  * ### Node Selection (all optional - system auto-selects if omitted)
  * - **node_id**: Specific node ID to deploy on
  * - **region**: Region preference (e.g., "us-east", "eu-west")
@@ -224,6 +256,8 @@ export declare const ProvisionCvmRequestSchema: z.ZodObject<{
     kms: z.ZodOptional<z.ZodEnum<["PHALA", "ETHEREUM", "BASE"]>>;
     kms_contract: z.ZodOptional<z.ZodString>;
     env_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    nonce: z.ZodOptional<z.ZodNumber>;
+    app_id: z.ZodOptional<z.ZodString>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     node_id: z.ZodOptional<z.ZodNumber>;
     teepod_id: z.ZodOptional<z.ZodNumber>;
@@ -270,6 +304,8 @@ export declare const ProvisionCvmRequestSchema: z.ZodObject<{
     kms: z.ZodOptional<z.ZodEnum<["PHALA", "ETHEREUM", "BASE"]>>;
     kms_contract: z.ZodOptional<z.ZodString>;
     env_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    nonce: z.ZodOptional<z.ZodNumber>;
+    app_id: z.ZodOptional<z.ZodString>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     node_id: z.ZodOptional<z.ZodNumber>;
     teepod_id: z.ZodOptional<z.ZodNumber>;
@@ -316,8 +352,10 @@ export declare const ProvisionCvmRequestSchema: z.ZodObject<{
     kms: z.ZodOptional<z.ZodEnum<["PHALA", "ETHEREUM", "BASE"]>>;
     kms_contract: z.ZodOptional<z.ZodString>;
     env_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    nonce: z.ZodOptional<z.ZodNumber>;
+    app_id: z.ZodOptional<z.ZodString>;
 }, z.ZodTypeAny, "passthrough">>;
-export type ProvisionCvmRequest = z.infer<typeof ProvisionCvmRequestSchema> & {
+export type ProvisionCvmRequest = z.input<typeof ProvisionCvmRequestSchema> & {
     node_id?: number;
     teepod_id?: number;
     compose_file?: {
@@ -325,6 +363,8 @@ export type ProvisionCvmRequest = z.infer<typeof ProvisionCvmRequestSchema> & {
         tproxy_enabled?: boolean;
         [key: string]: unknown;
     };
+    nonce?: number;
+    app_id?: string;
 };
 declare const provisionCvm: {
     (client: Client, params: ProvisionCvmRequest): Promise<z.objectOutputType<{

package/dist/client.d.ts

@@ -4,6 +4,7 @@ import { type SafeResult, type ClientConfig } from "./types/client";
 import type { Prettify } from "./types/common";
 import { PhalaCloudError } from "./utils/errors";
 export type { SafeResult } from "./types/client";
+export declare const SUPPORTED_API_VERSIONS: readonly ["2025-05-31", "2025-10-28"];
 /**
  * Client event types
  */

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { createClient as createBaseClient, type Client as BaseClient } from "./client";
+export { createClient as createBaseClient, type Client as BaseClient, SUPPORTED_API_VERSIONS, } from "./client";
 export { createClient, type Client } from "./create-client";
 export * from "./types";
 export * from "./actions";

package/dist/index.js

@@ -94,6 +94,7 @@ __export(index_exports, {
   RequestError: () => RequestError,
   ResourceError: () => ResourceError,
   RestartCvmRequestSchema: () => RestartCvmRequestSchema,
+  SUPPORTED_API_VERSIONS: () => SUPPORTED_API_VERSIONS,
   SUPPORTED_CHAINS: () => SUPPORTED_CHAINS,
   ServerError: () => ServerError,
   ShutdownCvmRequestSchema: () => ShutdownCvmRequestSchema,
@@ -1413,7 +1414,12 @@ var ProvisionCvmRequestSchema = import_zod10.z.object({
   // KMS type selection (defaults to PHALA)
   kms_contract: import_zod10.z.string().optional(),
   // KMS contract address for on-chain KMS
-  env_keys: import_zod10.z.array(import_zod10.z.string()).optional()
+  env_keys: import_zod10.z.array(import_zod10.z.string()).optional(),
+  // Manual nonce specification (Advanced - PHALA KMS only)
+  nonce: import_zod10.z.number().optional(),
+  // User-specified nonce for deterministic app_id generation
+  app_id: import_zod10.z.string().optional()
+  // Expected app_id (must match calculated app_id from nonce)
 }).passthrough();
 function handleGatewayCompatibility(appCompose) {
   if (!appCompose.compose_file) {
@@ -2004,12 +2010,15 @@ var { action: updateOsImage, safeAction: safeUpdateOsImage } = defineAction(impo
 // src/actions/cvms/get_cvm_state.ts
 var import_zod30 = require("zod");
 var CvmStateSchema = import_zod30.z.object({
-  status: import_zod30.z.string(),
-  derived_status: import_zod30.z.string().optional(),
-  vm_uuid: import_zod30.z.string().optional(),
+  id: import_zod30.z.string().optional(),
   instance_id: import_zod30.z.string().optional(),
-  uptime: import_zod30.z.string().optional()
-  // Add other state fields as needed
+  name: import_zod30.z.string(),
+  status: import_zod30.z.string(),
+  uptime: import_zod30.z.string().optional(),
+  exited_at: import_zod30.z.string().optional(),
+  boot_progress: import_zod30.z.string().optional(),
+  boot_error: import_zod30.z.string().optional(),
+  shutdown_progress: import_zod30.z.string().optional()
 });
 var GetCvmStateRequestSchema = CvmIdSchema;
 var { action: getCvmState, safeAction: safeGetCvmState } = defineAction(CvmStateSchema, async (client, request) => {
@@ -3593,6 +3602,7 @@ var import_verify_env_encrypt_public_key = require("@phala/dstack-sdk/verify-env
   RequestError,
   ResourceError,
   RestartCvmRequestSchema,
+  SUPPORTED_API_VERSIONS,
   SUPPORTED_CHAINS,
   ServerError,
   ShutdownCvmRequestSchema,

package/dist/index.mjs

@@ -1189,7 +1189,12 @@ var ProvisionCvmRequestSchema = z10.object({
   // KMS type selection (defaults to PHALA)
   kms_contract: z10.string().optional(),
   // KMS contract address for on-chain KMS
-  env_keys: z10.array(z10.string()).optional()
+  env_keys: z10.array(z10.string()).optional(),
+  // Manual nonce specification (Advanced - PHALA KMS only)
+  nonce: z10.number().optional(),
+  // User-specified nonce for deterministic app_id generation
+  app_id: z10.string().optional()
+  // Expected app_id (must match calculated app_id from nonce)
 }).passthrough();
 function handleGatewayCompatibility(appCompose) {
   if (!appCompose.compose_file) {
@@ -1780,12 +1785,15 @@ var { action: updateOsImage, safeAction: safeUpdateOsImage } = defineAction(z29.
 // src/actions/cvms/get_cvm_state.ts
 import { z as z30 } from "zod";
 var CvmStateSchema = z30.object({
-  status: z30.string(),
-  derived_status: z30.string().optional(),
-  vm_uuid: z30.string().optional(),
+  id: z30.string().optional(),
   instance_id: z30.string().optional(),
-  uptime: z30.string().optional()
-  // Add other state fields as needed
+  name: z30.string(),
+  status: z30.string(),
+  uptime: z30.string().optional(),
+  exited_at: z30.string().optional(),
+  boot_progress: z30.string().optional(),
+  boot_error: z30.string().optional(),
+  shutdown_progress: z30.string().optional()
 });
 var GetCvmStateRequestSchema = CvmIdSchema;
 var { action: getCvmState, safeAction: safeGetCvmState } = defineAction(CvmStateSchema, async (client, request) => {
@@ -3387,6 +3395,7 @@ export {
   RequestError,
   ResourceError,
   RestartCvmRequestSchema,
+  SUPPORTED_API_VERSIONS,
   SUPPORTED_CHAINS,
   ServerError,
   ShutdownCvmRequestSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phala/cloud",
-  "version": "0.2.1-beta.1",
+  "version": "0.2.1-beta.3",
   "description": "TypeScript SDK for Phala Cloud API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -38,12 +38,12 @@
   "author": "Leechael Yim",
   "license": "Apache-2.0",
   "dependencies": {
-    "@phala/dstack-sdk": "0.5.4-beta.6",
+    "@phala/dstack-sdk": "0.5.7",
     "debug": "^4.4.1",
     "mitt": "^3.0.1",
     "ofetch": "^1.3.3",
     "viem": "^2.7.0",
-    "zod": "^3.22.4"
+    "zod": "^3.24.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
@@ -59,7 +59,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/Phala-Network/phala-cloud-sdks",
+    "url": "https://github.com/Phala-Network/phala-cloud",
     "directory": "js"
   },
   "engines": {