@layr-labs/ecloud-sdk 0.2.0 → 0.2.1-dev

package/dist/index.d.ts

@@ -1,10 +1,12 @@
-import { G as GasEstimate, C as ComputeModule } from './compute-CF2HOXed.js';
-export { e as ComputeModuleConfig, a as CreateAppOpts, E as EstimateGasOptions, L as LogsOptions, P as PRIMARY_LANGUAGES, S as SDKCreateAppOpts, b as SDKLogsOptions, c as createApp, d as createComputeModule, f as encodeStartAppData, h as encodeStopAppData, i as encodeTerminateAppData, n as estimateTransactionGas, o as formatETH, j as getAllAppsByDeveloper, k as getAppLatestReleaseBlockNumbers, g as getAvailableTemplates, m as getBlockTimestamps, l as logs } from './compute-CF2HOXed.js';
+import { C as ComputeModule } from './compute-B85ikS78.js';
+export { d as ComputeModuleConfig, a as CreateAppOpts, L as LogsOptions, P as PRIMARY_LANGUAGES, S as SDKCreateAppOpts, c as createApp, b as createComputeModule, e as encodeStartAppData, f as encodeStopAppData, h as encodeTerminateAppData, g as getAvailableTemplates, l as logs } from './compute-B85ikS78.js';
 import { BillingModule } from './billing.js';
 export { BillingModuleConfig, createBillingModule } from './billing.js';
-import { Address, Hex, WalletClient, PublicClient, PrivateKeyAccount } from 'viem';
-import { E as EnvironmentConfig, S as SubscriptionStatus, L as Logger, P as PreparedDeploy, D as DeployResult, a as PreparedUpgrade, A as AppId } from './index-D2QufVB9.js';
-export { w as AlreadyActiveResponse, q as AppProfile, r as AppProfileResponse, m as AppRecord, B as BillingEnvironmentConfig, F as CancelResponse, z as CancelSuccessResponse, C as ChainID, v as CheckoutCreatedResponse, u as CreateSubscriptionResponse, b as DeployAppOpts, n as DeployOptions, p as DockerImageConfig, g as ExecuteDeployResult, h as ExecuteUpgradeResult, G as GasOpts, I as ImageDigestResult, k as LifecycleOpts, N as NoActiveSubscriptionResponse, o as ParsedEnvironment, x as PaymentIssueResponse, e as PrepareDeployFromVerifiableBuildOpts, c as PrepareDeployOpts, f as PrepareUpgradeFromVerifiableBuildOpts, d as PrepareUpgradeOpts, i as PreparedDeployData, j as PreparedUpgradeData, s as ProductID, H as ProductSubscriptionResponse, R as Release, y as SubscribeResponse, t as SubscriptionLineItem, J as SubscriptionOpts, U as UpgradeAppOpts, l as logVisibility } from './index-D2QufVB9.js';
+import { WalletClient, Hex, Chain, PublicClient, Address } from 'viem';
+import { B as BillingEnvironmentConfig, H as ProductID, M as CreateSubscriptionResponse, Y as ProductSubscriptionResponse, G as GasEstimate, z as Logger, r as PreparedDeploy, w as EnvironmentConfig, v as DeployResult, s as PreparedUpgrade, A as AppId } from './index-D5oW73Dx.js';
+export { O as AlreadyActiveResponse, C as AppProfile, F as AppProfileResponse, t as AppRecord, X as CancelResponse, V as CancelSuccessResponse, J as ChainID, N as CheckoutCreatedResponse, D as DeployAppOpts, u as DeployOptions, y as DockerImageConfig, E as EstimateGasOptions, n as ExecuteDeployResult, o as ExecuteUpgradeResult, m as GasOpts, I as ImageDigestResult, L as LifecycleOpts, W as NoActiveSubscriptionResponse, x as ParsedEnvironment, Q as PaymentIssueResponse, j as PrepareDeployFromVerifiableBuildOpts, P as PrepareDeployOpts, k as PrepareUpgradeFromVerifiableBuildOpts, i as PrepareUpgradeOpts, p as PreparedDeployData, q as PreparedUpgradeData, R as Release, T as SubscribeResponse, K as SubscriptionLineItem, Z as SubscriptionOpts, S as SubscriptionStatus, U as UpgradeAppOpts, e as estimateTransactionGas, f as formatETH, g as getAllAppsByDeveloper, _ as getAppLatestReleaseBlockNumbers, $ as getBlockTimestamps, l as logVisibility } from './index-D5oW73Dx.js';
+import { L as LogVisibility, R as ResourceUsageMonitoring } from './eip7702-CXCYfOnk.js';
+export { A as AppInfo, B as AppMetrics, z as AppProfileInfo, J as AppRelease, K as AppReleaseBuild, M as AppResponse, C as CreateAppParams, S as DeployParams, F as EstimateBatchGasOptions, G as GeneratedKey, w as LogsParams, V as UpgradeParams, U as UserApiClient, O as assertValidFilePath, e as assertValidImageReference, k as assertValidPrivateKey, I as checkERC7702Delegation, E as estimateBatchGas, f as extractAppNameFromImage, y as generateNewPrivateKey, a as getAvailableEnvironments, H as getBillingEnvironmentConfig, b as getBuildType, g as getEnvironmentConfig, i as isEnvironmentAvailable, c as isMainnet, x as isSubscriptionActive, s as sanitizeString, q as sanitizeURL, r as sanitizeXURL, o as validateAppID, v as validateAppName, t as validateCreateAppParams, T as validateDeployParams, n as validateDescription, N as validateFilePath, P as validateImagePath, d as validateImageReference, h as validateInstanceTypeSKU, p as validateLogVisibility, u as validateLogsParams, j as validatePrivateKeyFormat, Q as validateResourceUsageMonitoring, l as validateURL, W as validateUpgradeParams, m as validateXURL } from './eip7702-CXCYfOnk.js';
 
 interface SubmitBuildRequest {
     repoUrl: string;
@@ -102,10 +104,14 @@ declare class BadRequestError extends BuildError {
 
 /**
  * Build module entry point (verifiable builds + provenance)
+ *
+ * Accepts viem's WalletClient which abstracts over both local accounts
+ * (privateKeyToAccount) and external signers (MetaMask, etc.).
  */
 
 interface BuildModuleConfig {
-    privateKey?: string;
+    /** Wallet client for signing requests (optional - only needed for authenticated endpoints) */
+    walletClient?: WalletClient;
     environment?: string;
     verbose?: boolean;
     clientId?: string;
@@ -139,308 +145,85 @@ interface BuildModule {
 declare function createBuildModule(config: BuildModuleConfig): BuildModule;
 
 /**
- * Non-interactive validation utilities for SDK
- *
- * These functions validate parameters without any interactive prompts.
- * They either return the validated value or throw an error.
+ * General utility helpers
  */
 
 /**
- * Validate app name format
- * @throws Error if name is invalid
- */
-declare function validateAppName(name: string): void;
-/**
- * Validate Docker image reference format
- * @returns true if valid, error message string if invalid
- */
-declare function validateImageReference(value: string): true | string;
-/**
- * Validate image reference and throw if invalid
- * @throws Error if image reference is invalid
- */
-declare function assertValidImageReference(value: string): void;
-/**
- * Extract app name from image reference
- */
-declare function extractAppNameFromImage(imageRef: string): string;
-/**
- * Validate that a file path exists
- * @returns true if valid, error message string if invalid
- */
-declare function validateFilePath(value: string): true | string;
-/**
- * Validate file path and throw if invalid
- * @throws Error if file path is invalid or doesn't exist
- */
-declare function assertValidFilePath(value: string): void;
-/**
- * Validate instance type SKU against available types
- * @returns the validated SKU
- * @throws Error if SKU is not in the available types list
- */
-declare function validateInstanceTypeSKU(sku: string, availableTypes: Array<{
-    sku: string;
-}>): string;
-/**
- * Validate private key format
- * Matches Go's common.ValidatePrivateKey() function
- */
-declare function validatePrivateKeyFormat(key: string): boolean;
-/**
- * Validate private key and throw if invalid
- * @throws Error if private key format is invalid
- */
-declare function assertValidPrivateKey(key: string): void;
-/**
- * Validate URL format
- * @returns undefined if valid, error message string if invalid
+ * Get a viem Chain object from a chain ID.
+ * Supports mainnet (1) and sepolia (11155111), defaults to the fallback chain for unknown chains.
  */
-declare function validateURL(rawURL: string): string | undefined;
+declare function getChainFromID(chainID: bigint, fallback?: Chain): Chain;
 /**
- * Validate X/Twitter URL format
- * @returns undefined if valid, error message string if invalid
- */
-declare function validateXURL(rawURL: string): string | undefined;
-/**
- * Validate description length
- * @returns undefined if valid, error message string if invalid
- */
-declare function validateDescription(description: string): string | undefined;
-/**
- * Validate image file path
- * @returns undefined if valid, error message string if invalid
- */
-declare function validateImagePath(filePath: string): string | undefined;
-/**
- * Validate and normalize app ID address
- * @param appID - App ID (must be a valid address)
- * @returns Normalized app address
- * @throws Error if app ID is not a valid address
+ * Create viem clients from a private key
  *
- * Note: Name resolution should be handled by CLI before calling SDK functions.
- * The SDK only accepts resolved addresses.
- */
-declare function validateAppID(appID: string | Address): Address;
-type LogVisibility = "public" | "private" | "off";
-/**
- * Validate and convert log visibility setting to internal format
- * @param logVisibility - Log visibility setting
- * @returns Object with logRedirect and publicLogs settings
- * @throws Error if log visibility value is invalid
+ * This is a convenience helper for CLI and server applications that have direct
+ * access to a private key. For browser applications using external wallets (MetaMask, etc.),
+ * create the WalletClient directly using viem's createWalletClient with a custom transport.
+ *
+ * @example
+ * // CLI usage with private key
+ * const { walletClient, publicClient } = createClients({
+ *   privateKey: '0x...',
+ *   rpcUrl: 'https://sepolia.infura.io/v3/...',
+ *   chainId: 11155111n
+ * });
+ *
+ * @example
+ * // Browser usage with external wallet (create clients directly)
+ * const walletClient = createWalletClient({
+ *   chain: sepolia,
+ *   transport: custom(window.ethereum!)
+ * });
+ * const publicClient = createPublicClient({
+ *   chain: sepolia,
+ *   transport: custom(window.ethereum!)
+ * });
  */
-declare function validateLogVisibility(logVisibility: LogVisibility): {
-    logRedirect: string;
-    publicLogs: boolean;
+declare function createClients(options: {
+    privateKey: string | Hex;
+    rpcUrl: string;
+    chainId: bigint;
+}): {
+    walletClient: WalletClient;
+    publicClient: PublicClient;
 };
-type ResourceUsageMonitoring = "enable" | "disable";
 /**
- * Validate and convert resource usage monitoring setting to internal format
- * @param resourceUsageMonitoring - Resource usage monitoring setting
- * @returns The resourceUsageAllow value for the Dockerfile label ("always" or "never")
- * @throws Error if resource usage monitoring value is invalid
- */
-declare function validateResourceUsageMonitoring(resourceUsageMonitoring: ResourceUsageMonitoring | undefined): string;
-/**
- * Sanitize string (HTML escape and trim)
- */
-declare function sanitizeString(s: string): string;
-/**
- * Sanitize URL (add https:// if missing, validate)
- * @throws Error if URL is invalid after sanitization
- */
-declare function sanitizeURL(rawURL: string): string;
-/**
- * Sanitize X/Twitter URL (handle username-only input, normalize)
- * @throws Error if URL is invalid after sanitization
- */
-declare function sanitizeXURL(rawURL: string): string;
-interface DeployParams {
-    dockerfilePath?: string;
-    imageRef?: string;
-    appName: string;
-    envFilePath?: string;
-    instanceType: string;
-    logVisibility: LogVisibility;
-}
-/**
- * Validate deploy parameters
- * @throws Error if required parameters are missing or invalid
- */
-declare function validateDeployParams(params: Partial<DeployParams>): void;
-interface UpgradeParams {
-    appID: string | Address;
-    dockerfilePath?: string;
-    imageRef?: string;
-    envFilePath?: string;
-    instanceType: string;
-    logVisibility: LogVisibility;
-}
-/**
- * Validate upgrade parameters
- * @throws Error if required parameters are missing or invalid
+ * Ensure hex string has 0x prefix
  */
-declare function validateUpgradeParams(params: Partial<UpgradeParams>): void;
-interface CreateAppParams {
-    name: string;
-    language: string;
-    template?: string;
-    templateVersion?: string;
-}
+declare function addHexPrefix(value: string): Hex;
 /**
- * Validate create app parameters
- * @throws Error if required parameters are missing or invalid
+ * Remove 0x prefix from hex string if present
  */
-declare function validateCreateAppParams(params: Partial<CreateAppParams>): void;
-interface LogsParams {
-    appID: string | Address;
-    watch?: boolean;
-}
+declare function stripHexPrefix(value: string): string;
+
 /**
- * Validate logs parameters
- * @throws Error if required parameters are missing or invalid
+ * BillingAPI Client to manage product subscriptions
+ * Standalone client - does not depend on chain infrastructure
+ *
+ * Accepts viem's WalletClient which abstracts over both local accounts
+ * (privateKeyToAccount) and external signers (MetaMask, etc.).
  */
-declare function validateLogsParams(params: Partial<LogsParams>): void;
 
 /**
- * UserAPI Client to manage interactions with the coordinator
+ * BillingAPI Client for managing product subscriptions.
  */
-
-interface AppProfileInfo {
-    name: string;
-    website?: string;
-    description?: string;
-    xURL?: string;
-    imageURL?: string;
-}
-interface AppMetrics {
-    cpu_utilization_percent?: number;
-    memory_utilization_percent?: number;
-    memory_used_bytes?: number;
-    memory_total_bytes?: number;
-}
-interface DerivedAddress {
-    address: string;
-    derivationPath: string;
-}
-interface AppInfo {
-    address: Address;
-    status: string;
-    ip: string;
-    machineType: string;
-    profile?: AppProfileInfo;
-    metrics?: AppMetrics;
-    evmAddresses: DerivedAddress[];
-    solanaAddresses: DerivedAddress[];
-}
-type AppContractStatus = "STARTED" | "STOPPED" | "TERMINATED" | "SUSPENDED" | string;
-interface AppReleaseBuild {
-    buildId?: string;
-    billingAddress?: string;
-    repoUrl?: string;
-    gitRef?: string;
-    status?: string;
-    buildType?: string;
-    imageName?: string;
-    imageDigest?: string;
-    imageUrl?: string;
-    provenanceJson?: unknown;
-    provenanceSignature?: string;
-    createdAt?: string;
-    updatedAt?: string;
-    errorMessage?: string;
-    dependencies?: Record<string, AppReleaseBuild>;
-}
-interface AppRelease {
-    appId?: string;
-    rmsReleaseId?: string;
-    imageDigest?: string;
-    registryUrl?: string;
-    publicEnv?: string;
-    encryptedEnv?: string;
-    upgradeByTime?: number;
-    createdAt?: string;
-    createdAtBlock?: string;
-    build?: AppReleaseBuild;
-}
-interface AppResponse {
-    id: string;
-    creator?: string;
-    contractStatus?: AppContractStatus;
-    releases: AppRelease[];
-}
-declare class UserApiClient {
+declare class BillingApiClient {
     private readonly config;
-    private readonly account?;
-    private readonly rpcUrl?;
-    private readonly clientId;
-    constructor(config: EnvironmentConfig, privateKey?: string | Hex, rpcUrl?: string, clientId?: string);
-    getInfos(appIDs: Address[], addressCount?: number): Promise<AppInfo[]>;
+    private readonly walletClient;
+    constructor(config: BillingEnvironmentConfig, walletClient: WalletClient);
     /**
-     * Get app details from UserAPI (includes releases and build/provenance info when available).
-     *
-     * Endpoint: GET /apps/:appAddress
+     * Get the address of the connected wallet
      */
-    getApp(appAddress: Address): Promise<AppResponse>;
+    get address(): Address;
+    createSubscription(productId?: ProductID): Promise<CreateSubscriptionResponse>;
+    getSubscription(productId?: ProductID): Promise<ProductSubscriptionResponse>;
+    cancelSubscription(productId?: ProductID): Promise<void>;
     /**
-     * Get available SKUs (instance types) from UserAPI
+     * Make an authenticated request to the billing API
      */
-    getSKUs(): Promise<{
-        skus: Array<{
-            sku: string;
-            description: string;
-        }>;
-    }>;
-    /**
-     * Get logs for an app
-     */
-    getLogs(appID: Address): Promise<string>;
-    /**
-     * Get statuses for apps
-     */
-    getStatuses(appIDs: Address[]): Promise<Array<{
-        address: Address;
-        status: string;
-    }>>;
-    /**
-     * Upload app profile information with optional image
-     */
-    uploadAppProfile(appAddress: Address, name: string, website?: string, description?: string, xURL?: string, imagePath?: string): Promise<{
-        name: string;
-        website?: string;
-        description?: string;
-        xURL?: string;
-        imageURL?: string;
-    }>;
     private makeAuthenticatedRequest;
-    /**
-     * Generate authentication headers for UserAPI requests
-     */
-    private generateAuthHeaders;
 }
 
-/**
- * Billing utility functions
- */
-
-/**
- * Check if subscription status allows deploying apps
- */
-declare function isSubscriptionActive(status: SubscriptionStatus): boolean;
-
-/**
- * General utility helpers
- */
-
-/**
- * Ensure hex string has 0x prefix
- */
-declare function addHexPrefix(value: string): Hex;
-/**
- * Remove 0x prefix from hex string if present
- */
-declare function stripHexPrefix(value: string): string;
-
 /**
  * Main deploy function
  *
@@ -453,12 +236,15 @@ declare function stripHexPrefix(value: string): string;
 
 /**
  * Required deploy options for SDK (non-interactive)
+ *
+ * Accepts viem's WalletClient and PublicClient for transaction signing.
+ * The caller is responsible for creating these clients (e.g., from a private key).
  */
 interface SDKDeployOptions {
-    /** Private key for signing transactions (hex string with or without 0x prefix) */
-    privateKey: string;
-    /** RPC URL for blockchain connection - optional, uses environment default if not provided */
-    rpcUrl?: string;
+    /** Wallet client for signing transactions */
+    walletClient: WalletClient;
+    /** Public client for reading blockchain state */
+    publicClient: PublicClient;
     /** Environment name (e.g., 'sepolia', 'mainnet-alpha') - defaults to 'sepolia' */
     environment?: string;
     /** Path to Dockerfile (if building from Dockerfile) - either this or imageRef is required */
@@ -475,11 +261,8 @@ interface SDKDeployOptions {
     logVisibility: LogVisibility;
     /** Resource usage monitoring setting - optional, defaults to 'enable' */
     resourceUsageMonitoring?: ResourceUsageMonitoring;
-    /** Optional gas params from estimation */
-    gas?: {
-        maxFeePerGas?: bigint;
-        maxPriorityFeePerGas?: bigint;
-    };
+    /** Optional gas params from estimation (use result from prepareDeploy) */
+    gas?: GasEstimate;
     /** Skip telemetry (used when called from CLI) - optional */
     skipTelemetry?: boolean;
 }
@@ -500,13 +283,40 @@ interface ExecuteDeployOptions {
         publicClient: PublicClient;
         environmentConfig: EnvironmentConfig;
     };
-    gas?: {
-        maxFeePerGas?: bigint;
-        maxPriorityFeePerGas?: bigint;
-    };
+    gas?: GasEstimate;
     logger?: Logger;
     skipTelemetry?: boolean;
 }
+/**
+ * Options for verifiable build deployment
+ *
+ * Similar to SDKDeployOptions but uses a pre-built image with known digest
+ * instead of building from Dockerfile.
+ */
+interface VerifiableBuildOptions {
+    /** Wallet client for signing transactions */
+    walletClient: WalletClient;
+    /** Public client for reading blockchain state */
+    publicClient: PublicClient;
+    /** Environment name (e.g., 'sepolia', 'mainnet-alpha') - defaults to 'sepolia' */
+    environment?: string;
+    /** Image reference (registry/path:tag) - required */
+    imageRef: string;
+    /** Image digest (sha256:...) - required */
+    imageDigest: string;
+    /** Path to .env file - optional */
+    envFilePath?: string;
+    /** App name - required */
+    appName: string;
+    /** Instance type SKU - required */
+    instanceType: string;
+    /** Log visibility setting - required */
+    logVisibility: LogVisibility;
+    /** Resource usage monitoring setting - optional, defaults to 'enable' */
+    resourceUsageMonitoring?: ResourceUsageMonitoring;
+    /** Skip telemetry (used when called from CLI) - optional */
+    skipTelemetry?: boolean;
+}
 /**
  * Prepare a deployment from a pre-built image (already layered) without using Docker locally.
  *
@@ -519,11 +329,7 @@ interface ExecuteDeployOptions {
  * - Skips prepareRelease() image layering and digest extraction
  * - Uses provided imageDigest + derived registry name to construct the Release struct
  */
-declare function prepareDeployFromVerifiableBuild(options: Omit<SDKDeployOptions, "gas" | "dockerfilePath" | "imageRef"> & {
-    imageRef: string;
-    imageDigest: string;
-    skipTelemetry?: boolean;
-}, logger?: Logger): Promise<PrepareDeployResult>;
+declare function prepareDeployFromVerifiableBuild(options: VerifiableBuildOptions, logger?: Logger): Promise<PrepareDeployResult>;
 /**
  * Prepare deployment - does all work up to the transaction
  *
@@ -549,7 +355,7 @@ declare function executeDeploy(options: ExecuteDeployOptions): Promise<DeployRes
  * Call this after executeDeploy to wait for the app to be provisioned.
  * Can be called separately to allow for intermediate operations (e.g., profile upload).
  */
-declare function watchDeployment(appId: string, privateKey: string, rpcUrl: string, environment: string, logger?: Logger, clientId?: string, skipTelemetry?: boolean): Promise<string | undefined>;
+declare function watchDeployment(appId: string, walletClient: WalletClient, publicClient: PublicClient, environmentConfig: EnvironmentConfig, logger?: Logger, skipTelemetry?: boolean): Promise<string | undefined>;
 
 /**
  * Main upgrade function
@@ -567,10 +373,10 @@ declare function watchDeployment(appId: string, privateKey: string, rpcUrl: stri
 interface SDKUpgradeOptions {
     /** App ID to upgrade - required */
     appId: string | Address;
-    /** Private key for signing transactions (hex string with or without 0x prefix) */
-    privateKey: string;
-    /** RPC URL for blockchain connection - optional, uses environment default if not provided */
-    rpcUrl?: string;
+    /** Wallet client for signing transactions */
+    walletClient: WalletClient;
+    /** Public client for reading blockchain state */
+    publicClient: PublicClient;
     /** Environment name (e.g., 'sepolia', 'mainnet-alpha') - defaults to 'sepolia' */
     environment?: string;
     /** Path to Dockerfile (if building from Dockerfile) - either this or imageRef is required */
@@ -585,11 +391,8 @@ interface SDKUpgradeOptions {
     logVisibility: LogVisibility;
     /** Resource usage monitoring setting - optional, defaults to 'enable' */
     resourceUsageMonitoring?: ResourceUsageMonitoring;
-    /** Optional gas params from estimation */
-    gas?: {
-        maxFeePerGas?: bigint;
-        maxPriorityFeePerGas?: bigint;
-    };
+    /** Optional gas params from estimation (use result from prepareUpgrade) */
+    gas?: GasEstimate;
     /** Skip telemetry (used when called from CLI) - optional */
     skipTelemetry?: boolean;
 }
@@ -618,10 +421,7 @@ interface ExecuteUpgradeOptions {
         publicClient: PublicClient;
         environmentConfig: EnvironmentConfig;
     };
-    gas?: {
-        maxFeePerGas?: bigint;
-        maxPriorityFeePerGas?: bigint;
-    };
+    gas?: GasEstimate;
     logger?: Logger;
     skipTelemetry?: boolean;
 }
@@ -663,31 +463,7 @@ declare function executeUpgrade(options: ExecuteUpgradeOptions): Promise<Upgrade
  * Call this after executeUpgrade to wait for the upgrade to finish.
  * Can be called separately to allow for intermediate operations.
  */
-declare function watchUpgrade(appId: string, privateKey: string, rpcUrl: string, environment: string, logger?: Logger, clientId?: string, skipTelemetry?: boolean): Promise<void>;
-
-/**
- * Environment configuration for different networks
- */
-
-/**
- * Get environment configuration
- */
-declare function getEnvironmentConfig(environment: string, chainID?: bigint): EnvironmentConfig;
-declare function getBuildType(): "dev" | "prod";
-/**
- * Get available environments based on build type
- * - dev: only "sepolia-dev"
- * - prod: "sepolia" and "mainnet-alpha"
- */
-declare function getAvailableEnvironments(): string[];
-/**
- * Check if an environment is available in the current build
- */
-declare function isEnvironmentAvailable(environment: string): boolean;
-/**
- * Check if environment is mainnet (chain ID 1)
- */
-declare function isMainnet(environmentConfig: EnvironmentConfig): boolean;
+declare function watchUpgrade(appId: string, walletClient: WalletClient, publicClient: PublicClient, environmentConfig: EnvironmentConfig, logger?: Logger, skipTelemetry?: boolean): Promise<void>;
 
 /**
  * OS Keyring Integration
@@ -798,20 +574,6 @@ declare function requirePrivateKey(options: {
     privateKey?: string;
 }): Promise<PrivateKeySource>;
 
-/**
- * Private Key Generation
- *
- * Generate new secp256k1 private keys for Ethereum
- */
-interface GeneratedKey {
-    privateKey: string;
-    address: string;
-}
-/**
- * Generate a new secp256k1 private key
- */
-declare function generateNewPrivateKey(): GeneratedKey;
-
 /**
  * Telemetry types
  */
@@ -1061,45 +823,18 @@ declare function getTemplate(catalog: TemplateCatalog, category: string, languag
  */
 declare function getCategoryDescriptions(catalog: TemplateCatalog, language: string): Record<string, string>;
 
-/**
- * EIP-7702 transaction handling
- *
- * This module handles EIP-7702 delegation and batch execution
- */
-
-type Execution = {
-    target: Address;
-    value: bigint;
-    callData: Hex;
-};
-/**
- * Options for estimating batch gas
- */
-interface EstimateBatchGasOptions {
-    publicClient: PublicClient;
-    account: Address;
-    executions: Execution[];
-}
-/**
- * Estimate gas cost for a batch transaction
- *
- * Use this to get cost estimate before prompting user for confirmation.
- */
-declare function estimateBatchGas(options: EstimateBatchGasOptions): Promise<GasEstimate>;
-/**
- * Check if account is delegated to ERC-7702 delegator
- */
-declare function checkERC7702Delegation(publicClient: PublicClient, account: Address, delegatorAddress: Address): Promise<boolean>;
-
 /**
  * Preflight checks
+ *
+ * Performs early validation of authentication and network connectivity.
+ * Accepts viem's WalletClient and PublicClient - the caller is responsible
+ * for creating these from a private key if needed.
  */
 
 interface PreflightContext {
-    privateKey: string;
-    rpcUrl: string;
+    walletClient: WalletClient;
+    publicClient: PublicClient;
     environmentConfig: EnvironmentConfig;
-    account: PrivateKeyAccount;
     selfAddress: Address;
 }
 
@@ -1131,4 +866,4 @@ interface ECloudClient {
 }
 declare function createECloudClient(cfg: ClientConfig): ECloudClient;
 
-export { type AppEnvironment, AppId, type AppInfo, type AppMetrics, type AppProfileInfo, type AppRelease, type AppReleaseBuild, type AppResponse, AuthRequiredError, BUILD_STATUS, BadRequestError, BillingModule, type Build, BuildError, BuildFailedError, type BuildModule, type BuildModuleConfig, type BuildProgress, type BuildStatus, type ClientConfig, ComputeModule, ConflictError, type CreateAppParams, type DeployParams, DeployResult, type ECloudClient, type Environment, EnvironmentConfig, type EstimateBatchGasOptions, ForbiddenError, GasEstimate, type GeneratedKey, type LegacyKey, type LogChunk, type LogVisibility, Logger, type LogsParams, type Metric, type MetricsContext, NoopClient, NotFoundError, PostHogClient, type PrepareDeployResult, type PrepareUpgradeResult, PreparedDeploy, PreparedUpgrade, type PrivateKeySource, type ResourceUsageMonitoring, type SDKDeployOptions, type SDKUpgradeOptions, type StoredKey, type SubmitBuildRequest, type SubmitBuildResponse, SubscriptionStatus, type TelemetryClient, type TelemetryClientOptions, type TelemetryWrapperOptions, TimeoutError, type UpgradeParams, UserApiClient, type VerifyProvenanceFailure, type VerifyProvenanceResult, type VerifyProvenanceSuccess, addHexPrefix, addMetric, addMetricWithDimensions, assertValidFilePath, assertValidImageReference, assertValidPrivateKey, checkERC7702Delegation, createAppEnvironment, createBuildModule, createECloudClient, createMetricsContext, createTelemetryClient, deleteLegacyPrivateKey, deletePrivateKey, emitMetrics, estimateBatchGas, executeDeploy, executeUpgrade, extractAppNameFromImage, fetchTemplateCatalog, generateNewPrivateKey, getAddressFromPrivateKey, getAvailableEnvironments, getBuildType, getCategoryDescriptions, getCurrentInstanceType, getEnvironmentConfig, getLegacyKeys, getLegacyPrivateKey, getPostHogAPIKey, getPostHogEndpoint, getPrivateKey, getPrivateKeyWithSource, getTemplate, isEnvironmentAvailable, isMainnet, isNoopClient, isSubscriptionActive, keyExists, listStoredKeys, prepareDeploy, prepareDeployFromVerifiableBuild, prepareUpgrade, prepareUpgradeFromVerifiableBuild, requirePrivateKey, sanitizeString, sanitizeURL, sanitizeXURL, storePrivateKey, stripHexPrefix, validateAppID, validateAppName, validateCreateAppParams, validateDeployParams, validateDescription, validateFilePath, validateImagePath, validateImageReference, validateInstanceTypeSKU, validateLogVisibility, validateLogsParams, validatePrivateKey, validatePrivateKeyFormat, validateResourceUsageMonitoring, validateURL, validateUpgradeParams, validateXURL, watchDeployment, watchUpgrade, withSDKTelemetry };
+export { type AppEnvironment, AppId, AuthRequiredError, BUILD_STATUS, BadRequestError, BillingApiClient, BillingEnvironmentConfig, BillingModule, type Build, BuildError, BuildFailedError, type BuildModule, type BuildModuleConfig, type BuildProgress, type BuildStatus, type ClientConfig, ComputeModule, ConflictError, CreateSubscriptionResponse, DeployResult, type ECloudClient, type Environment, EnvironmentConfig, ForbiddenError, GasEstimate, type LegacyKey, type LogChunk, LogVisibility, Logger, type Metric, type MetricsContext, NoopClient, NotFoundError, PostHogClient, type PrepareDeployResult, type PrepareUpgradeResult, PreparedDeploy, PreparedUpgrade, type PrivateKeySource, ProductID, ProductSubscriptionResponse, ResourceUsageMonitoring, type SDKDeployOptions, type SDKUpgradeOptions, type StoredKey, type SubmitBuildRequest, type SubmitBuildResponse, type TelemetryClient, type TelemetryClientOptions, type TelemetryWrapperOptions, TimeoutError, type VerifyProvenanceFailure, type VerifyProvenanceResult, type VerifyProvenanceSuccess, addHexPrefix, addMetric, addMetricWithDimensions, createAppEnvironment, createBuildModule, createECloudClient, createMetricsContext, createTelemetryClient, createClients as createViemClients, deleteLegacyPrivateKey, deletePrivateKey, emitMetrics, executeDeploy, executeUpgrade, fetchTemplateCatalog, getAddressFromPrivateKey, getCategoryDescriptions, getChainFromID, getCurrentInstanceType, getLegacyKeys, getLegacyPrivateKey, getPostHogAPIKey, getPostHogEndpoint, getPrivateKey, getPrivateKeyWithSource, getTemplate, isNoopClient, keyExists, listStoredKeys, prepareDeploy, prepareDeployFromVerifiableBuild, prepareUpgrade, prepareUpgradeFromVerifiableBuild, requirePrivateKey, storePrivateKey, stripHexPrefix, validatePrivateKey, watchDeployment, watchUpgrade, withSDKTelemetry };