@phala/cloud 0.0.1 → 0.0.2

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.2",
   "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.2",
     "ofetch": "^1.3.3",
     "viem": "^2.7.0",
     "zod": "^3.22.4"