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

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,6 +352,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">>;
 export type ProvisionCvmRequest = z.input<typeof ProvisionCvmRequestSchema> & {
     node_id?: number;
@@ -325,6 +363,8 @@ export type ProvisionCvmRequest = z.input<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) {
@@ -3596,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) {
@@ -3390,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.2",
+  "version": "0.2.1-beta.3",
   "description": "TypeScript SDK for Phala Cloud API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -43,7 +43,7 @@
     "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": {