@phala/cloud 0.0.1 → 0.0.3

package/dist/utils/as-hex.d.ts

@@ -0,0 +1,17 @@
+import { type Hex } from "viem";
+/**
+ * Converts a value to a hex string with 0x prefix.
+ *
+ * @param value - The value to convert to hex. Can be a string with or without 0x prefix.
+ * @returns A valid hex string with 0x prefix.
+ * @throws Error if the value cannot be converted to a valid hex string.
+ *
+ * @example
+ * ```typescript
+ * asHex("abc123") // "0xabc123"
+ * asHex("0xabc123") // "0xabc123"
+ * asHex("xyz") // throws Error
+ * ```
+ */
+export declare function asHex(value: unknown): Hex;
+//# sourceMappingURL=as-hex.d.ts.map

package/dist/utils/as-hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"as-hex.d.ts","sourceRoot":"","sources":["../../src/utils/as-hex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAS,MAAM,MAAM,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CASzC"}

package/dist/utils/client-factories.d.ts

@@ -0,0 +1,44 @@
+import { type Chain, type Hash } from "viem";
+import { type NetworkClients } from "./network";
+interface EthereumProvider {
+    request: (args: {
+        method: string;
+        params?: unknown[];
+    }) => Promise<unknown>;
+    on?(event: string, handler: (...args: unknown[]) => void): void;
+    removeListener?(event: string, handler: (...args: unknown[]) => void): void;
+}
+/**
+ * CONVENIENCE: Create clients from private key (server-side)
+ * You can also create your own viem clients and use createNetworkClients() directly
+ */
+export declare function createClientsFromPrivateKey(chain: Chain, privateKey: Hash, rpcUrl?: string): NetworkClients;
+/**
+ * CONVENIENCE: Create clients from browser wallet (client-side)
+ * You can also create your own viem clients and use createNetworkClients() directly
+ */
+export declare function createClientsFromBrowser(chain: Chain, rpcUrl?: string): Promise<NetworkClients>;
+/**
+ * CONVENIENCE: Switch to a specific network in browser wallet
+ */
+export declare function switchToNetwork(provider: EthereumProvider, chainId: number): Promise<void>;
+/**
+ * CONVENIENCE: Add a custom network to browser wallet
+ */
+export declare function addNetwork(provider: EthereumProvider, config: {
+    chainId: number;
+    name: string;
+    rpcUrl: string;
+    blockExplorer?: string;
+}): Promise<void>;
+/**
+ * CONVENIENCE: Auto-detect environment and create clients
+ * You can also create your own viem clients and use createNetworkClients() directly
+ */
+export declare function autoCreateClients(chain: Chain, options?: {
+    privateKey?: Hash;
+    rpcUrl?: string;
+    preferBrowser?: boolean;
+}): Promise<NetworkClients>;
+export {};
+//# sourceMappingURL=client-factories.d.ts.map

package/dist/utils/client-factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-factories.d.ts","sourceRoot":"","sources":["../../src/utils/client-factories.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,KAAK,EAEV,KAAK,IAAI,EACV,MAAM,MAAM,CAAC;AAEd,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAkBnB,UAAU,gBAAgB;IACxB,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAChE,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CAC7E;AAUD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,IAAI,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,cAAc,CAuBhB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,KAAK,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC,CA2DzB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBhG;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE;IACN,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;CACpB,GACL,OAAO,CAAC,cAAc,CAAC,CAiBzB"}

package/dist/utils/get_compose_hash.d.ts

@@ -0,0 +1,15 @@
+type SortableValue = string | number | boolean | null | undefined | SortableObject | SortableArray;
+interface SortableObject {
+    [key: string]: SortableValue;
+}
+interface SortableArray extends Array<SortableValue> {
+}
+export interface AppCompose extends SortableObject {
+    runner?: string;
+    docker_compose_file?: string;
+    bash_script?: string;
+    pre_launch_script?: string;
+}
+export declare function getComposeHash(app_compose: AppCompose): string;
+export {};
+//# sourceMappingURL=get_compose_hash.d.ts.map

package/dist/utils/get_compose_hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_compose_hash.d.ts","sourceRoot":"","sources":["../../src/utils/get_compose_hash.ts"],"names":[],"mappings":"AAEA,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,GAAG,aAAa,CAAC;AACnG,UAAU,cAAc;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;CAC9B;AACD,UAAU,aAAc,SAAQ,KAAK,CAAC,aAAa,CAAC;CAAG;AAoBvD,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAsBD,wBAAgB,cAAc,CAAC,WAAW,EAAE,UAAU,GAAG,MAAM,CAI9D"}

package/dist/utils/get_error_message.d.ts

@@ -0,0 +1,3 @@
+import type { ApiError } from "../types";
+export declare function getErrorMessage(error: ApiError): string;
+//# sourceMappingURL=get_error_message.d.ts.map

package/dist/utils/get_error_message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_error_message.d.ts","sourceRoot":"","sources":["../../src/utils/get_error_message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAiBvD"}

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+export { encryptEnvVars } from "@phala/dstack-sdk/encrypt-env-vars";
+export { getComposeHash, type AppCompose } from "./get_compose_hash";
+export { getErrorMessage } from "./get_error_message";
+export { asHex } from "./as-hex";
+export { validateActionParameters, safeValidateActionParameters } from "./validate-parameters";
+export { createNetworkClients, extractNetworkClients, checkNetworkStatus, checkBalance, validateNetworkPrerequisites, waitForTransactionReceipt, executeTransaction, NetworkError, WalletError, TransactionError, type NetworkConfig, type WalletConnection, type NetworkClients, type BalanceCheckResult, type TransactionOptions, type TransactionResult, } from "./network";
+export { createTransactionTracker, executeBatchTransactions, executeTransactionWithRetry, estimateTransactionGas, type TransactionState, type TransactionStatus, type TransactionTracker, type BatchTransactionOptions, type BatchTransactionResult, type RetryOptions, type GasEstimationOptions, } from "./transaction";
+export { createClientsFromPrivateKey, createClientsFromBrowser, autoCreateClients, switchToNetwork, addNetwork, } from "./client-factories";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAG/F,OAAO,EAEL,oBAAoB,EACpB,qBAAqB,EAErB,kBAAkB,EAClB,YAAY,EACZ,4BAA4B,EAE5B,yBAAyB,EACzB,kBAAkB,EAElB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAEhB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAEL,wBAAwB,EAExB,wBAAwB,EAExB,2BAA2B,EAE3B,sBAAsB,EAEtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAEL,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB,EAEjB,eAAe,EACf,UAAU,GACX,MAAM,oBAAoB,CAAC"}

package/dist/utils/network.d.ts

@@ -0,0 +1,101 @@
+import { type Address, type Hash, type PublicClient, type WalletClient, type TransactionReceipt } from "viem";
+export interface NetworkClients {
+    publicClient: PublicClient;
+    walletClient: WalletClient;
+    address: Address;
+    chainId: number;
+}
+export interface NetworkConfig {
+    chainId: number;
+    name: string;
+    rpcUrl: string;
+    blockExplorer?: string;
+}
+export interface WalletConnection {
+    address: Address;
+    chainId: number;
+}
+export interface BalanceCheckResult {
+    address: Address;
+    balance: bigint;
+    sufficient: boolean;
+    required?: bigint;
+}
+export interface TransactionOptions {
+    timeout?: number;
+    confirmations?: number;
+    onSubmitted?: (hash: Hash) => void;
+    onConfirmed?: (receipt: TransactionReceipt) => void;
+    onError?: (error: Error, hash?: Hash) => void;
+}
+export interface TransactionResult {
+    hash: Hash;
+    receipt: TransactionReceipt;
+    success: boolean;
+}
+export declare class NetworkError extends Error {
+    code?: string | undefined;
+    details?: unknown | undefined;
+    constructor(message: string, code?: string | undefined, details?: unknown | undefined);
+}
+export declare class WalletError extends Error {
+    code?: string | undefined;
+    details?: unknown | undefined;
+    constructor(message: string, code?: string | undefined, details?: unknown | undefined);
+}
+export declare class TransactionError extends Error {
+    hash?: Hash | undefined;
+    details?: unknown | undefined;
+    constructor(message: string, hash?: Hash | undefined, details?: unknown | undefined);
+}
+/**
+ * Create a NetworkClients object from existing viem clients
+ * This is the primary way to create NetworkClients - the caller provides pre-configured clients
+ */
+export declare function createNetworkClients(publicClient: PublicClient, walletClient: WalletClient, address: Address, chainId: number): NetworkClients;
+/**
+ * Check wallet connection and network status
+ */
+export declare function checkNetworkStatus(clients: NetworkClients, targetChainId: number): Promise<{
+    isCorrectNetwork: boolean;
+    currentChainId: number;
+}>;
+/**
+ * Check wallet balance
+ */
+export declare function checkBalance(publicClient: PublicClient, address: Address, minBalance?: bigint): Promise<BalanceCheckResult>;
+/**
+ * Wait for transaction receipt with timeout and polling
+ */
+export declare function waitForTransactionReceipt(publicClient: PublicClient, hash: Hash, options?: {
+    timeout?: number;
+    pollingInterval?: number;
+    confirmations?: number;
+}): Promise<TransactionReceipt>;
+/**
+ * Execute a transaction with automatic receipt waiting and error handling
+ */
+export declare function executeTransaction<T extends unknown[]>(clients: NetworkClients, operation: (clients: NetworkClients, ...args: T) => Promise<Hash>, args: T, options?: TransactionOptions): Promise<TransactionResult>;
+/**
+ * Extract NetworkClients info from existing viem clients
+ * Useful when you have existing clients and want to create a NetworkClients object
+ */
+export declare function extractNetworkClients(publicClient: PublicClient, walletClient: WalletClient): Promise<NetworkClients>;
+/**
+ * Comprehensive network validation
+ */
+export declare function validateNetworkPrerequisites(clients: NetworkClients, requirements: {
+    targetChainId: number;
+    minBalance?: bigint;
+    requiredAddress?: Address;
+}): Promise<{
+    networkValid: boolean;
+    balanceValid: boolean;
+    addressValid: boolean;
+    details: {
+        currentChainId: number;
+        balance: bigint;
+        address: Address;
+    };
+}>;
+//# sourceMappingURL=network.d.ts.map

package/dist/utils/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/utils/network.ts"],"names":[],"mappings":"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"}

package/dist/utils/transaction.d.ts

@@ -0,0 +1,81 @@
+import type { Hash, TransactionReceipt } from "viem";
+import { NetworkClients, TransactionOptions, TransactionResult } from "./network";
+export type TransactionState = "idle" | "submitting" | "pending" | "success" | "error" | "timeout";
+export interface TransactionStatus {
+    state: TransactionState;
+    hash?: Hash;
+    receipt?: TransactionReceipt;
+    error?: string;
+    startTime?: number;
+    submitTime?: number;
+    confirmTime?: number;
+    aborted?: boolean;
+}
+export interface TransactionTracker {
+    readonly status: TransactionStatus;
+    readonly isIdle: boolean;
+    readonly isSubmitting: boolean;
+    readonly isPending: boolean;
+    readonly isSuccess: boolean;
+    readonly isError: boolean;
+    readonly isTimeout: boolean;
+    readonly isAborted: boolean;
+    readonly isComplete: boolean;
+    abort(): void;
+    reset(): void;
+    execute<T extends unknown[]>(operation: (clients: NetworkClients, ...args: T) => Promise<Hash>, clients: NetworkClients, args: T, options?: TransactionOptions & {
+        signal?: AbortSignal;
+    }): Promise<TransactionResult>;
+}
+/**
+ * Create a transaction tracker for monitoring transaction state
+ */
+export declare function createTransactionTracker(): TransactionTracker;
+/**
+ * Batch transaction executor with sequential or parallel execution
+ */
+export interface BatchTransactionOptions {
+    mode: "sequential" | "parallel";
+    failFast?: boolean;
+    timeout?: number;
+    onProgress?: (completed: number, total: number, results: (TransactionResult | Error)[]) => void;
+}
+export interface BatchTransactionResult {
+    results: (TransactionResult | Error)[];
+    successCount: number;
+    errorCount: number;
+    allSuccessful: boolean;
+}
+/**
+ * Execute multiple transactions in batch
+ */
+export declare function executeBatchTransactions<T extends unknown[]>(operations: Array<{
+    operation: (clients: NetworkClients, ...args: T) => Promise<Hash>;
+    args: T;
+    options?: TransactionOptions;
+}>, clients: NetworkClients, batchOptions: BatchTransactionOptions): Promise<BatchTransactionResult>;
+/**
+ * Transaction retry utility with exponential backoff
+ */
+export interface RetryOptions {
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffFactor?: number;
+    retryCondition?: (error: Error) => boolean;
+}
+export declare function executeTransactionWithRetry<T extends unknown[]>(operation: (clients: NetworkClients, ...args: T) => Promise<Hash>, clients: NetworkClients, args: T, options?: TransactionOptions, retryOptions?: RetryOptions): Promise<TransactionResult>;
+/**
+ * Smart gas estimation and transaction optimization
+ */
+export interface GasEstimationOptions {
+    gasLimitMultiplier?: number;
+    maxFeePerGasMultiplier?: number;
+    priorityFeeMultiplier?: number;
+}
+export declare function estimateTransactionGas(clients: NetworkClients, transaction: Parameters<typeof clients.publicClient.estimateGas>[0], options?: GasEstimationOptions): Promise<{
+    gasLimit: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+}>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/utils/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/utils/transaction.ts"],"names":[],"mappings":"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"}

package/dist/utils/validate-parameters.d.ts

@@ -0,0 +1,20 @@
+import type { SafeResult } from "../client";
+/**
+ * Validates action parameters, specifically the schema parameter
+ *
+ * @param parameters - The parameters to validate
+ * @throws Error if schema parameter is invalid (for non-safe functions)
+ */
+export declare function validateActionParameters<T>(parameters?: {
+    schema?: T;
+}): void;
+/**
+ * Validates action parameters for safe functions
+ *
+ * @param parameters - The parameters to validate
+ * @returns SafeResult with error if validation fails, undefined if validation passes
+ */
+export declare function safeValidateActionParameters<T, ReturnType>(parameters?: {
+    schema?: T;
+}): SafeResult<ReturnType> | undefined;
+//# sourceMappingURL=validate-parameters.d.ts.map

package/dist/utils/validate-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-parameters.d.ts","sourceRoot":"","sources":["../../src/utils/validate-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,CAAC,CAAA;CAAE,GAAG,IAAI,CAW7E;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,CAAC,CAAA;CAAE,GACnF,UAAU,CAAC,UAAU,CAAC,GACtB,SAAS,CA2BZ"}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@phala/cloud",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "TypeScript SDK for Phala Cloud API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": ["dist/**/*", "README.md"],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "build": "tsup src/index.ts --format cjs,esm && tsc --emitDeclarationOnly --declaration --outDir dist",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "fmt": "biome format --write",
     "test": "vitest --run --exclude '**/*.e2e.test.ts'",
@@ -17,13 +17,19 @@
     "check": "npm run lint && npm run test",
     "type-check": "tsc --noEmit",
     "typecheck": "tsc --noEmit",
-    "publish-stable": "npm run build && npm publish --access public"
+    "version:patch": "npm version patch",
+    "version:minor": "npm version minor",
+    "version:major": "npm version major",
+    "prepublish-stable": "npm run build && npm run check",
+    "publish-stable": "npm run prepublish-stable && npm publish --access public",
+    "prepublish-beta": "npm run build && npm run check",
+    "publish-beta": "npm run prepublish-beta && npm publish --access public --tag beta"
   },
   "keywords": ["phala", "cloud", "cvm", "tee", "blockchain", "deployment"],
   "author": "Leechael Yim",
   "license": "Apache-2.0",
   "dependencies": {
-    "@phala/dstack-sdk": "0.5.0",
+    "@phala/dstack-sdk": "0.5.4-beta.5",
     "ofetch": "^1.3.3",
     "viem": "^2.7.0",
     "zod": "^3.22.4"