@layr-labs/ecloud-sdk 0.2.0-dev → 0.2.0-dev.1

package/dist/index.d.cts

@@ -1,10 +1,10 @@
-import { C as ComputeModule } from './compute-B_ibIORD.cjs';
-export { e as ComputeModuleConfig, a as CreateAppOpts, 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, g as getAvailableTemplates, l as logs } from './compute-B_ibIORD.cjs';
+import { G as GasEstimate, C as ComputeModule } from './compute-CbmjA8kJ.cjs';
+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-CbmjA8kJ.cjs';
 import { BillingModule } from './billing.cjs';
 export { BillingModuleConfig, createBillingModule } from './billing.cjs';
-import { E as EnvironmentConfig, S as SubscriptionStatus, L as Logger, D as DeployResult } from './index-D-SUX3IG.cjs';
-export { m as AlreadyActiveResponse, A as AppId, f as AppProfile, g as AppProfileResponse, c as AppRecord, B as BillingEnvironmentConfig, q as CancelResponse, p as CancelSuccessResponse, C as ChainID, k as CheckoutCreatedResponse, j as CreateSubscriptionResponse, a as DeployAppOpts, d as DeployOptions, e as DockerImageConfig, I as ImageDigestResult, b as LifecycleOpts, N as NoActiveSubscriptionResponse, P as ParsedEnvironment, n as PaymentIssueResponse, h as ProductID, r as ProductSubscriptionResponse, R as Release, o as SubscribeResponse, i as SubscriptionLineItem, s as SubscriptionOpts, U as UpgradeAppOpts, l as logVisibility } from './index-D-SUX3IG.cjs';
 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.cjs';
+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.cjs';
 
 interface SubmitBuildRequest {
     repoUrl: string;
@@ -435,117 +435,12 @@ declare function isSubscriptionActive(status: SubscriptionStatus): boolean;
 /**
  * Ensure hex string has 0x prefix
  */
-declare function addHexPrefix(value: string): `0x${string}`;
+declare function addHexPrefix(value: string): Hex;
 /**
  * Remove 0x prefix from hex string if present
  */
 declare function stripHexPrefix(value: string): string;
 
-/**
- * Contract interactions
- *
- * This module handles on-chain contract interactions using viem
- */
-
-/**
- * Gas estimation result
- */
-interface GasEstimate {
-    /** Estimated gas limit for the transaction */
-    gasLimit: bigint;
-    /** Max fee per gas (EIP-1559) */
-    maxFeePerGas: bigint;
-    /** Max priority fee per gas (EIP-1559) */
-    maxPriorityFeePerGas: bigint;
-    /** Maximum cost in wei (gasLimit * maxFeePerGas) */
-    maxCostWei: bigint;
-    /** Maximum cost formatted as ETH string */
-    maxCostEth: string;
-}
-/**
- * Options for estimating transaction gas
- */
-interface EstimateGasOptions {
-    privateKey: string;
-    rpcUrl: string;
-    environmentConfig: EnvironmentConfig;
-    to: Address;
-    data: Hex;
-    value?: bigint;
-}
-/**
- * Format Wei to ETH string
- */
-declare function formatETH(wei: bigint): string;
-/**
- * Estimate gas cost for a transaction
- *
- * Use this to get cost estimate before prompting user for confirmation.
- */
-declare function estimateTransactionGas(options: EstimateGasOptions): Promise<GasEstimate>;
-/**
- * Prepared deploy batch ready for gas estimation and execution
- */
-interface PreparedDeployBatch {
-    /** The app ID that will be deployed */
-    appId: Address;
-    /** The salt used for deployment */
-    salt: Uint8Array;
-    /** Batch executions to be sent */
-    executions: Array<{
-        target: Address;
-        value: bigint;
-        callData: Hex;
-    }>;
-    /** Wallet client for sending transaction */
-    walletClient: WalletClient;
-    /** Public client for reading chain state */
-    publicClient: PublicClient;
-    /** Environment configuration */
-    environmentConfig: EnvironmentConfig;
-}
-/**
- * Prepared upgrade batch ready for gas estimation and execution
- */
-interface PreparedUpgradeBatch {
-    /** The app ID being upgraded */
-    appId: Address;
-    /** Batch executions to be sent */
-    executions: Array<{
-        target: Address;
-        value: bigint;
-        callData: Hex;
-    }>;
-    /** Wallet client for sending transaction */
-    walletClient: WalletClient;
-    /** Public client for reading chain state */
-    publicClient: PublicClient;
-    /** Environment configuration */
-    environmentConfig: EnvironmentConfig;
-}
-/**
- * Get apps by creator (paginated)
- */
-interface AppConfig {
-    release: any;
-    status: number;
-}
-/**
- * Fetch all apps by a developer by auto-pagination
- */
-declare function getAllAppsByDeveloper(rpcUrl: string, env: EnvironmentConfig, developer: Address, pageSize?: bigint): Promise<{
-    apps: Address[];
-    appConfigs: AppConfig[];
-}>;
-/**
- * Get latest release block numbers for multiple apps
- */
-declare function getAppLatestReleaseBlockNumbers(rpcUrl: string, environmentConfig: EnvironmentConfig, appIDs: Address[]): Promise<Map<Address, number>>;
-/**
- * Get block timestamps for multiple block numbers
- */
-declare function getBlockTimestamps(rpcUrl: string, environmentConfig: EnvironmentConfig, blockNumbers: number[]): Promise<Map<number, number>>;
-
 /**
  * Main deploy function
  *
@@ -588,23 +483,6 @@ interface SDKDeployOptions {
     /** Skip telemetry (used when called from CLI) - optional */
     skipTelemetry?: boolean;
 }
-/**
- * Prepared deployment ready for gas estimation and execution
- */
-interface PreparedDeploy {
-    /** The prepared batch (executions, clients, etc.) */
-    batch: PreparedDeployBatch;
-    /** App name */
-    appName: string;
-    /** Final image reference */
-    imageRef: string;
-    /** Preflight context for post-deploy operations */
-    preflightCtx: {
-        privateKey: string;
-        rpcUrl: string;
-        environmentConfig: EnvironmentConfig;
-    };
-}
 /**
  * Result from prepareDeploy - includes prepared batch and gas estimate
  */
@@ -614,6 +492,21 @@ interface PrepareDeployResult {
     /** Gas estimate for the batch transaction */
     gasEstimate: GasEstimate;
 }
+/** Options for executing a prepared deployment */
+interface ExecuteDeployOptions {
+    prepared: PreparedDeploy;
+    context: {
+        walletClient: WalletClient;
+        publicClient: PublicClient;
+        environmentConfig: EnvironmentConfig;
+    };
+    gas?: {
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+    };
+    logger?: Logger;
+    skipTelemetry?: boolean;
+}
 /**
  * Prepare a deployment from a pre-built image (already layered) without using Docker locally.
  *
@@ -649,10 +542,7 @@ declare function prepareDeploy(options: Omit<SDKDeployOptions, "gas"> & {
  * Note: This only submits the on-chain transaction. Call watchDeployment separately
  * to wait for the app to be running.
  */
-declare function executeDeploy(prepared: PreparedDeploy, gas: {
-    maxFeePerGas?: bigint;
-    maxPriorityFeePerGas?: bigint;
-} | undefined, logger?: Logger, skipTelemetry?: boolean): Promise<DeployResult>;
+declare function executeDeploy(options: ExecuteDeployOptions): Promise<DeployResult>;
 /**
  * Watch a deployment until the app is running
  *
@@ -705,28 +595,11 @@ interface SDKUpgradeOptions {
 }
 interface UpgradeResult {
     /** App ID (contract address) */
-    appId: string;
+    appId: AppId;
     /** Final image reference */
     imageRef: string;
     /** Transaction hash */
-    txHash: `0x${string}`;
-}
-/**
- * Prepared upgrade ready for gas estimation and execution
- */
-interface PreparedUpgrade {
-    /** The prepared batch (executions, clients, etc.) */
-    batch: PreparedUpgradeBatch;
-    /** App ID being upgraded */
-    appId: string;
-    /** Final image reference */
-    imageRef: string;
-    /** Preflight context for post-upgrade operations */
-    preflightCtx: {
-        privateKey: string;
-        rpcUrl: string;
-        environmentConfig: EnvironmentConfig;
-    };
+    txHash: Hex;
 }
 /**
  * Result from prepareUpgrade - includes prepared batch and gas estimate
@@ -737,6 +610,21 @@ interface PrepareUpgradeResult {
     /** Gas estimate for the batch transaction */
     gasEstimate: GasEstimate;
 }
+/** Options for executing a prepared upgrade */
+interface ExecuteUpgradeOptions {
+    prepared: PreparedUpgrade;
+    context: {
+        walletClient: WalletClient;
+        publicClient: PublicClient;
+        environmentConfig: EnvironmentConfig;
+    };
+    gas?: {
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+    };
+    logger?: Logger;
+    skipTelemetry?: boolean;
+}
 /**
  * Prepare an upgrade from a pre-built image (already layered) without using Docker locally.
  *
@@ -768,10 +656,7 @@ declare function prepareUpgrade(options: Omit<SDKUpgradeOptions, "gas"> & {
  * Note: This only submits the on-chain transaction. Call watchUpgrade separately
  * to wait for the upgrade to complete.
  */
-declare function executeUpgrade(prepared: PreparedUpgrade, gas: {
-    maxFeePerGas?: bigint;
-    maxPriorityFeePerGas?: bigint;
-} | undefined, logger?: Logger, skipTelemetry?: boolean): Promise<UpgradeResult>;
+declare function executeUpgrade(options: ExecuteUpgradeOptions): Promise<UpgradeResult>;
 /**
  * Watch an upgrade until it completes
  *
@@ -814,6 +699,7 @@ declare function isMainnet(environmentConfig: EnvironmentConfig): boolean;
  *
  * Uses a single key for all environments.
  */
+
 interface StoredKey {
     address: string;
 }
@@ -835,7 +721,7 @@ declare function storePrivateKey(privateKey: string): Promise<void>;
  * Note: Returns the single stored key for all environments.
  * The environment parameter is kept for API compatibility but is ignored.
  */
-declare function getPrivateKey(): Promise<`0x${string}` | null>;
+declare function getPrivateKey(): Promise<Hex | null>;
 /**
  * Delete a private key from OS keyring
  * Returns true if deletion was successful, false otherwise
@@ -887,8 +773,9 @@ declare function getAddressFromPrivateKey(privateKey: string): string;
  * 2. Environment variable (ECLOUD_PRIVATE_KEY)
  * 3. OS keyring (stored via `ecloud auth login`)
  */
+
 interface PrivateKeySource {
-    key: `0x${string}`;
+    key: Hex;
     source: string;
 }
 /**
@@ -1180,24 +1067,23 @@ declare function getCategoryDescriptions(catalog: TemplateCatalog, language: str
  * 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;
-    environmentConfig: EnvironmentConfig;
-    executions: Array<{
-        target: Address;
-        value: bigint;
-        callData: Hex;
-    }>;
+    account: Address;
+    executions: Execution[];
 }
 /**
  * Estimate gas cost for a batch transaction
  *
  * Use this to get cost estimate before prompting user for confirmation.
- * Note: This provides a conservative estimate since batch transactions
- * through EIP-7702 can have variable costs.
  */
 declare function estimateBatchGas(options: EstimateBatchGasOptions): Promise<GasEstimate>;
 /**
@@ -1235,7 +1121,7 @@ declare function getCurrentInstanceType(preflightCtx: PreflightContext, appID: A
 type Environment = "sepolia" | "sepolia-dev" | "mainnet-alpha";
 interface ClientConfig {
     verbose: boolean;
-    privateKey: `0x${string}`;
+    privateKey: Hex;
     environment: Environment | string;
     rpcUrl?: string;
 }
@@ -1245,4 +1131,4 @@ interface ECloudClient {
 }
 declare function createECloudClient(cfg: ClientConfig): ECloudClient;
 
-export { type AppEnvironment, 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, type EstimateGasOptions, ForbiddenError, type GasEstimate, type GeneratedKey, type LegacyKey, type LogChunk, type LogVisibility, Logger, type LogsParams, type Metric, type MetricsContext, NoopClient, NotFoundError, PostHogClient, type PrepareDeployResult, type PrepareUpgradeResult, type PreparedDeploy, type 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, estimateTransactionGas, executeDeploy, executeUpgrade, extractAppNameFromImage, fetchTemplateCatalog, formatETH, generateNewPrivateKey, getAddressFromPrivateKey, getAllAppsByDeveloper, getAppLatestReleaseBlockNumbers, getAvailableEnvironments, getBlockTimestamps, 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, 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 };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { C as ComputeModule } from './compute-gpepEsn3.js';
-export { e as ComputeModuleConfig, a as CreateAppOpts, 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, g as getAvailableTemplates, l as logs } from './compute-gpepEsn3.js';
+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 { BillingModule } from './billing.js';
 export { BillingModuleConfig, createBillingModule } from './billing.js';
-import { E as EnvironmentConfig, S as SubscriptionStatus, L as Logger, D as DeployResult } from './index-D-SUX3IG.js';
-export { m as AlreadyActiveResponse, A as AppId, f as AppProfile, g as AppProfileResponse, c as AppRecord, B as BillingEnvironmentConfig, q as CancelResponse, p as CancelSuccessResponse, C as ChainID, k as CheckoutCreatedResponse, j as CreateSubscriptionResponse, a as DeployAppOpts, d as DeployOptions, e as DockerImageConfig, I as ImageDigestResult, b as LifecycleOpts, N as NoActiveSubscriptionResponse, P as ParsedEnvironment, n as PaymentIssueResponse, h as ProductID, r as ProductSubscriptionResponse, R as Release, o as SubscribeResponse, i as SubscriptionLineItem, s as SubscriptionOpts, U as UpgradeAppOpts, l as logVisibility } from './index-D-SUX3IG.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';
 
 interface SubmitBuildRequest {
     repoUrl: string;
@@ -435,117 +435,12 @@ declare function isSubscriptionActive(status: SubscriptionStatus): boolean;
 /**
  * Ensure hex string has 0x prefix
  */
-declare function addHexPrefix(value: string): `0x${string}`;
+declare function addHexPrefix(value: string): Hex;
 /**
  * Remove 0x prefix from hex string if present
  */
 declare function stripHexPrefix(value: string): string;
 
-/**
- * Contract interactions
- *
- * This module handles on-chain contract interactions using viem
- */
-
-/**
- * Gas estimation result
- */
-interface GasEstimate {
-    /** Estimated gas limit for the transaction */
-    gasLimit: bigint;
-    /** Max fee per gas (EIP-1559) */
-    maxFeePerGas: bigint;
-    /** Max priority fee per gas (EIP-1559) */
-    maxPriorityFeePerGas: bigint;
-    /** Maximum cost in wei (gasLimit * maxFeePerGas) */
-    maxCostWei: bigint;
-    /** Maximum cost formatted as ETH string */
-    maxCostEth: string;
-}
-/**
- * Options for estimating transaction gas
- */
-interface EstimateGasOptions {
-    privateKey: string;
-    rpcUrl: string;
-    environmentConfig: EnvironmentConfig;
-    to: Address;
-    data: Hex;
-    value?: bigint;
-}
-/**
- * Format Wei to ETH string
- */
-declare function formatETH(wei: bigint): string;
-/**
- * Estimate gas cost for a transaction
- *
- * Use this to get cost estimate before prompting user for confirmation.
- */
-declare function estimateTransactionGas(options: EstimateGasOptions): Promise<GasEstimate>;
-/**
- * Prepared deploy batch ready for gas estimation and execution
- */
-interface PreparedDeployBatch {
-    /** The app ID that will be deployed */
-    appId: Address;
-    /** The salt used for deployment */
-    salt: Uint8Array;
-    /** Batch executions to be sent */
-    executions: Array<{
-        target: Address;
-        value: bigint;
-        callData: Hex;
-    }>;
-    /** Wallet client for sending transaction */
-    walletClient: WalletClient;
-    /** Public client for reading chain state */
-    publicClient: PublicClient;
-    /** Environment configuration */
-    environmentConfig: EnvironmentConfig;
-}
-/**
- * Prepared upgrade batch ready for gas estimation and execution
- */
-interface PreparedUpgradeBatch {
-    /** The app ID being upgraded */
-    appId: Address;
-    /** Batch executions to be sent */
-    executions: Array<{
-        target: Address;
-        value: bigint;
-        callData: Hex;
-    }>;
-    /** Wallet client for sending transaction */
-    walletClient: WalletClient;
-    /** Public client for reading chain state */
-    publicClient: PublicClient;
-    /** Environment configuration */
-    environmentConfig: EnvironmentConfig;
-}
-/**
- * Get apps by creator (paginated)
- */
-interface AppConfig {
-    release: any;
-    status: number;
-}
-/**
- * Fetch all apps by a developer by auto-pagination
- */
-declare function getAllAppsByDeveloper(rpcUrl: string, env: EnvironmentConfig, developer: Address, pageSize?: bigint): Promise<{
-    apps: Address[];
-    appConfigs: AppConfig[];
-}>;
-/**
- * Get latest release block numbers for multiple apps
- */
-declare function getAppLatestReleaseBlockNumbers(rpcUrl: string, environmentConfig: EnvironmentConfig, appIDs: Address[]): Promise<Map<Address, number>>;
-/**
- * Get block timestamps for multiple block numbers
- */
-declare function getBlockTimestamps(rpcUrl: string, environmentConfig: EnvironmentConfig, blockNumbers: number[]): Promise<Map<number, number>>;
-
 /**
  * Main deploy function
  *
@@ -588,23 +483,6 @@ interface SDKDeployOptions {
     /** Skip telemetry (used when called from CLI) - optional */
     skipTelemetry?: boolean;
 }
-/**
- * Prepared deployment ready for gas estimation and execution
- */
-interface PreparedDeploy {
-    /** The prepared batch (executions, clients, etc.) */
-    batch: PreparedDeployBatch;
-    /** App name */
-    appName: string;
-    /** Final image reference */
-    imageRef: string;
-    /** Preflight context for post-deploy operations */
-    preflightCtx: {
-        privateKey: string;
-        rpcUrl: string;
-        environmentConfig: EnvironmentConfig;
-    };
-}
 /**
  * Result from prepareDeploy - includes prepared batch and gas estimate
  */
@@ -614,6 +492,21 @@ interface PrepareDeployResult {
     /** Gas estimate for the batch transaction */
     gasEstimate: GasEstimate;
 }
+/** Options for executing a prepared deployment */
+interface ExecuteDeployOptions {
+    prepared: PreparedDeploy;
+    context: {
+        walletClient: WalletClient;
+        publicClient: PublicClient;
+        environmentConfig: EnvironmentConfig;
+    };
+    gas?: {
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+    };
+    logger?: Logger;
+    skipTelemetry?: boolean;
+}
 /**
  * Prepare a deployment from a pre-built image (already layered) without using Docker locally.
  *
@@ -649,10 +542,7 @@ declare function prepareDeploy(options: Omit<SDKDeployOptions, "gas"> & {
  * Note: This only submits the on-chain transaction. Call watchDeployment separately
  * to wait for the app to be running.
  */
-declare function executeDeploy(prepared: PreparedDeploy, gas: {
-    maxFeePerGas?: bigint;
-    maxPriorityFeePerGas?: bigint;
-} | undefined, logger?: Logger, skipTelemetry?: boolean): Promise<DeployResult>;
+declare function executeDeploy(options: ExecuteDeployOptions): Promise<DeployResult>;
 /**
  * Watch a deployment until the app is running
  *
@@ -705,28 +595,11 @@ interface SDKUpgradeOptions {
 }
 interface UpgradeResult {
     /** App ID (contract address) */
-    appId: string;
+    appId: AppId;
     /** Final image reference */
     imageRef: string;
     /** Transaction hash */
-    txHash: `0x${string}`;
-}
-/**
- * Prepared upgrade ready for gas estimation and execution
- */
-interface PreparedUpgrade {
-    /** The prepared batch (executions, clients, etc.) */
-    batch: PreparedUpgradeBatch;
-    /** App ID being upgraded */
-    appId: string;
-    /** Final image reference */
-    imageRef: string;
-    /** Preflight context for post-upgrade operations */
-    preflightCtx: {
-        privateKey: string;
-        rpcUrl: string;
-        environmentConfig: EnvironmentConfig;
-    };
+    txHash: Hex;
 }
 /**
  * Result from prepareUpgrade - includes prepared batch and gas estimate
@@ -737,6 +610,21 @@ interface PrepareUpgradeResult {
     /** Gas estimate for the batch transaction */
     gasEstimate: GasEstimate;
 }
+/** Options for executing a prepared upgrade */
+interface ExecuteUpgradeOptions {
+    prepared: PreparedUpgrade;
+    context: {
+        walletClient: WalletClient;
+        publicClient: PublicClient;
+        environmentConfig: EnvironmentConfig;
+    };
+    gas?: {
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+    };
+    logger?: Logger;
+    skipTelemetry?: boolean;
+}
 /**
  * Prepare an upgrade from a pre-built image (already layered) without using Docker locally.
  *
@@ -768,10 +656,7 @@ declare function prepareUpgrade(options: Omit<SDKUpgradeOptions, "gas"> & {
  * Note: This only submits the on-chain transaction. Call watchUpgrade separately
  * to wait for the upgrade to complete.
  */
-declare function executeUpgrade(prepared: PreparedUpgrade, gas: {
-    maxFeePerGas?: bigint;
-    maxPriorityFeePerGas?: bigint;
-} | undefined, logger?: Logger, skipTelemetry?: boolean): Promise<UpgradeResult>;
+declare function executeUpgrade(options: ExecuteUpgradeOptions): Promise<UpgradeResult>;
 /**
  * Watch an upgrade until it completes
  *
@@ -814,6 +699,7 @@ declare function isMainnet(environmentConfig: EnvironmentConfig): boolean;
  *
  * Uses a single key for all environments.
  */
+
 interface StoredKey {
     address: string;
 }
@@ -835,7 +721,7 @@ declare function storePrivateKey(privateKey: string): Promise<void>;
  * Note: Returns the single stored key for all environments.
  * The environment parameter is kept for API compatibility but is ignored.
  */
-declare function getPrivateKey(): Promise<`0x${string}` | null>;
+declare function getPrivateKey(): Promise<Hex | null>;
 /**
  * Delete a private key from OS keyring
  * Returns true if deletion was successful, false otherwise
@@ -887,8 +773,9 @@ declare function getAddressFromPrivateKey(privateKey: string): string;
  * 2. Environment variable (ECLOUD_PRIVATE_KEY)
  * 3. OS keyring (stored via `ecloud auth login`)
  */
+
 interface PrivateKeySource {
-    key: `0x${string}`;
+    key: Hex;
     source: string;
 }
 /**
@@ -1180,24 +1067,23 @@ declare function getCategoryDescriptions(catalog: TemplateCatalog, language: str
  * 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;
-    environmentConfig: EnvironmentConfig;
-    executions: Array<{
-        target: Address;
-        value: bigint;
-        callData: Hex;
-    }>;
+    account: Address;
+    executions: Execution[];
 }
 /**
  * Estimate gas cost for a batch transaction
  *
  * Use this to get cost estimate before prompting user for confirmation.
- * Note: This provides a conservative estimate since batch transactions
- * through EIP-7702 can have variable costs.
  */
 declare function estimateBatchGas(options: EstimateBatchGasOptions): Promise<GasEstimate>;
 /**
@@ -1235,7 +1121,7 @@ declare function getCurrentInstanceType(preflightCtx: PreflightContext, appID: A
 type Environment = "sepolia" | "sepolia-dev" | "mainnet-alpha";
 interface ClientConfig {
     verbose: boolean;
-    privateKey: `0x${string}`;
+    privateKey: Hex;
     environment: Environment | string;
     rpcUrl?: string;
 }
@@ -1245,4 +1131,4 @@ interface ECloudClient {
 }
 declare function createECloudClient(cfg: ClientConfig): ECloudClient;
 
-export { type AppEnvironment, 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, type EstimateGasOptions, ForbiddenError, type GasEstimate, type GeneratedKey, type LegacyKey, type LogChunk, type LogVisibility, Logger, type LogsParams, type Metric, type MetricsContext, NoopClient, NotFoundError, PostHogClient, type PrepareDeployResult, type PrepareUpgradeResult, type PreparedDeploy, type 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, estimateTransactionGas, executeDeploy, executeUpgrade, extractAppNameFromImage, fetchTemplateCatalog, formatETH, generateNewPrivateKey, getAddressFromPrivateKey, getAllAppsByDeveloper, getAppLatestReleaseBlockNumbers, getAvailableEnvironments, getBlockTimestamps, 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, 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 };