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

package/dist/index.d.cts

@@ -1,142 +1,10 @@
-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 { 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 { BillingModule } from './billing.cjs';
 export { BillingModuleConfig, createBillingModule } from './billing.cjs';
+import { E as EnvironmentConfig, L as Logger, D as DeployResult, S as SubscriptionStatus } 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;
-    gitRef: string;
-    dockerfilePath?: string;
-    /**
-     * Path to a Caddyfile within the repository (relative to buildContextPath).
-     * If omitted, the build service will not copy a Caddyfile into the image.
-     */
-    caddyfilePath?: string;
-    buildContextPath?: string;
-    dependencies?: string[];
-}
-interface SubmitBuildResponse {
-    buildId: string;
-}
-declare const BUILD_STATUS: {
-    readonly BUILDING: "building";
-    readonly SUCCESS: "success";
-    readonly FAILED: "failed";
-};
-type BuildStatus = (typeof BUILD_STATUS)[keyof typeof BUILD_STATUS];
-interface Build {
-    buildId: string;
-    billingAddress: string;
-    repoUrl: string;
-    gitRef: string;
-    status: BuildStatus;
-    /** 'application' | 'dependency' (as returned by the API) */
-    buildType: string;
-    imageName: string;
-    imageUrl?: string;
-    imageDigest?: string;
-    provenanceJson?: Record<string, unknown>;
-    provenanceSignature?: string;
-    errorMessage?: string;
-    createdAt: string;
-    updatedAt: string;
-    dependencies?: Record<string, Build>;
-}
-type VerifyProvenanceResult = VerifyProvenanceSuccess | VerifyProvenanceFailure;
-interface VerifyProvenanceSuccess {
-    status: "verified";
-    buildId: string;
-    imageUrl: string;
-    imageDigest: string;
-    repoUrl: string;
-    gitRef: string;
-    provenanceJson: Record<string, unknown>;
-    provenanceSignature: string;
-    payloadType: string;
-    payload: string;
-}
-interface VerifyProvenanceFailure {
-    status: "failed";
-    error: string;
-    buildId?: string;
-}
-interface LogChunk {
-    content: string;
-    totalLength: number;
-    isComplete: boolean;
-    finalStatus?: BuildStatus;
-}
-interface BuildProgress {
-    build: Build;
-    logs: string;
-}
-
-declare class BuildError extends Error {
-    constructor(message: string);
-}
-declare class AuthRequiredError extends BuildError {
-    constructor(message?: string);
-}
-declare class BuildFailedError extends BuildError {
-    readonly buildId: string;
-    constructor(message: string, buildId: string);
-}
-declare class ConflictError extends BuildError {
-    constructor(message?: string);
-}
-declare class NotFoundError extends BuildError {
-    constructor(message?: string);
-}
-declare class ForbiddenError extends BuildError {
-    constructor(message?: string);
-}
-declare class TimeoutError extends BuildError {
-    constructor(message?: string);
-}
-declare class BadRequestError extends BuildError {
-    constructor(message?: string);
-}
-
-/**
- * Build module entry point (verifiable builds + provenance)
- */
-
-interface BuildModuleConfig {
-    privateKey?: string;
-    environment?: string;
-    verbose?: boolean;
-    clientId?: string;
-    skipTelemetry?: boolean;
-}
-interface BuildModule {
-    submit(request: SubmitBuildRequest): Promise<SubmitBuildResponse>;
-    getLogs(buildId: string): Promise<string>;
-    list(options: {
-        billingAddress: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<Build[]>;
-    get(buildId: string): Promise<Build>;
-    getByDigest(digest: string): Promise<Build>;
-    verify(identifier: string): Promise<VerifyProvenanceResult>;
-    submitAndWait(request: SubmitBuildRequest, options?: {
-        onLog?: (chunk: string) => void;
-        onProgress?: (progress: BuildProgress) => void;
-        pollIntervalMs?: number;
-        timeoutMs?: number;
-    }): Promise<Build>;
-    waitForBuild(buildId: string, options?: {
-        onLog?: (chunk: string) => void;
-        onProgress?: (progress: BuildProgress) => void;
-        pollIntervalMs?: number;
-        timeoutMs?: number;
-    }): Promise<Build>;
-    streamLogs(buildId: string, pollIntervalMs?: number): AsyncGenerator<LogChunk, void, unknown>;
-}
-declare function createBuildModule(config: BuildModuleConfig): BuildModule;
 
 /**
  * Non-interactive validation utilities for SDK
@@ -303,143 +171,109 @@ interface LogsParams {
 declare function validateLogsParams(params: Partial<LogsParams>): void;
 
 /**
- * UserAPI Client to manage interactions with the coordinator
+ * Contract interactions
+ *
+ * This module handles on-chain contract interactions using viem
  */
 
-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;
+/**
+ * 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;
 }
-interface AppResponse {
-    id: string;
-    creator?: string;
-    contractStatus?: AppContractStatus;
-    releases: AppRelease[];
+/**
+ * Options for estimating transaction gas
+ */
+interface EstimateGasOptions {
+    privateKey: string;
+    rpcUrl: string;
+    environmentConfig: EnvironmentConfig;
+    to: Address;
+    data: Hex;
+    value?: bigint;
 }
-declare class UserApiClient {
-    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[]>;
-    /**
-     * Get app details from UserAPI (includes releases and build/provenance info when available).
-     *
-     * Endpoint: GET /apps/:appAddress
-     */
-    getApp(appAddress: Address): Promise<AppResponse>;
-    /**
-     * Get available SKUs (instance types) from UserAPI
-     */
-    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;
+/**
+ * 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;
     }>;
-    private makeAuthenticatedRequest;
-    /**
-     * Generate authentication headers for UserAPI requests
-     */
-    private generateAuthHeaders;
+    /** Wallet client for sending transaction */
+    walletClient: WalletClient;
+    /** Public client for reading chain state */
+    publicClient: PublicClient;
+    /** Environment configuration */
+    environmentConfig: EnvironmentConfig;
 }
-
 /**
- * Billing utility functions
+ * 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;
+}
 /**
- * Check if subscription status allows deploying apps
+ * Get apps by creator (paginated)
  */
-declare function isSubscriptionActive(status: SubscriptionStatus): boolean;
-
+interface AppConfig {
+    release: any;
+    status: number;
+}
 /**
- * General utility helpers
+ * 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[];
+}>;
 /**
- * Ensure hex string has 0x prefix
+ * Get latest release block numbers for multiple apps
  */
-declare function addHexPrefix(value: string): Hex;
+declare function getAppLatestReleaseBlockNumbers(rpcUrl: string, environmentConfig: EnvironmentConfig, appIDs: Address[]): Promise<Map<Address, number>>;
 /**
- * Remove 0x prefix from hex string if present
+ * Get block timestamps for multiple block numbers
  */
-declare function stripHexPrefix(value: string): string;
+declare function getBlockTimestamps(rpcUrl: string, environmentConfig: EnvironmentConfig, blockNumbers: number[]): Promise<Map<number, number>>;
 
 /**
  * Main deploy function
@@ -483,6 +317,23 @@ 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
  */
@@ -492,38 +343,6 @@ 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.
- *
- * This is intended for verifiable builds where the build service outputs:
- * - imageRef (tagged image URL)
- * - imageDigest (sha256:... digest)
- *
- * Flow is the same as prepareDeploy, except:
- * - Skips ensureDockerIsRunning()
- * - 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>;
 /**
  * Prepare deployment - does all work up to the transaction
  *
@@ -542,7 +361,10 @@ 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(options: ExecuteDeployOptions): Promise<DeployResult>;
+declare function executeDeploy(prepared: PreparedDeploy, gas: {
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+} | undefined, logger?: Logger, skipTelemetry?: boolean): Promise<DeployResult>;
 /**
  * Watch a deployment until the app is running
  *
@@ -595,11 +417,28 @@ interface SDKUpgradeOptions {
 }
 interface UpgradeResult {
     /** App ID (contract address) */
-    appId: AppId;
+    appId: string;
     /** Final image reference */
     imageRef: string;
     /** Transaction hash */
-    txHash: Hex;
+    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;
+    };
 }
 /**
  * Result from prepareUpgrade - includes prepared batch and gas estimate
@@ -610,34 +449,6 @@ 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.
- *
- * Intended for verifiable builds: build service provides imageRef + imageDigest (sha256:...).
- * This skips:
- * - ensureDockerIsRunning()
- * - prepareRelease() layering/digest extraction
- */
-declare function prepareUpgradeFromVerifiableBuild(options: Omit<SDKUpgradeOptions, "gas" | "dockerfilePath" | "imageRef"> & {
-    imageRef: string;
-    imageDigest: string;
-    skipTelemetry?: boolean;
-}, logger?: Logger): Promise<PrepareUpgradeResult>;
 /**
  * Prepare upgrade - does all work up to the transaction
  *
@@ -656,7 +467,10 @@ 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(options: ExecuteUpgradeOptions): Promise<UpgradeResult>;
+declare function executeUpgrade(prepared: PreparedUpgrade, gas: {
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+} | undefined, logger?: Logger, skipTelemetry?: boolean): Promise<UpgradeResult>;
 /**
  * Watch an upgrade until it completes
  *
@@ -689,6 +503,15 @@ declare function isEnvironmentAvailable(environment: string): boolean;
  */
 declare function isMainnet(environmentConfig: EnvironmentConfig): boolean;
 
+/**
+ * Billing utility functions
+ */
+
+/**
+ * Check if subscription status allows deploying apps
+ */
+declare function isSubscriptionActive(status: SubscriptionStatus): boolean;
+
 /**
  * OS Keyring Integration
  *
@@ -699,7 +522,6 @@ declare function isMainnet(environmentConfig: EnvironmentConfig): boolean;
  *
  * Uses a single key for all environments.
  */
-
 interface StoredKey {
     address: string;
 }
@@ -721,7 +543,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<Hex | null>;
+declare function getPrivateKey(): Promise<`0x${string}` | null>;
 /**
  * Delete a private key from OS keyring
  * Returns true if deletion was successful, false otherwise
@@ -773,9 +595,8 @@ declare function getAddressFromPrivateKey(privateKey: string): string;
  * 2. Environment variable (ECLOUD_PRIVATE_KEY)
  * 3. OS keyring (stored via `ecloud auth login`)
  */
-
 interface PrivateKeySource {
-    key: Hex;
+    key: `0x${string}`;
     source: string;
 }
 /**
@@ -1067,23 +888,24 @@ 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;
-    account: Address;
-    executions: Execution[];
+    environmentConfig: EnvironmentConfig;
+    executions: Array<{
+        target: Address;
+        value: bigint;
+        callData: Hex;
+    }>;
 }
 /**
  * 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>;
 /**
@@ -1114,6 +936,81 @@ interface PreflightContext {
  */
 declare function getCurrentInstanceType(preflightCtx: PreflightContext, appID: Address, logger: Logger, clientId?: string): Promise<string>;
 
+/**
+ * UserAPI Client to manage interactions with the coordinator
+ */
+
+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[];
+}
+declare class UserApiClient {
+    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[]>;
+    /**
+     * Get available SKUs (instance types) from UserAPI
+     */
+    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;
+}
+
 /**
  * Main SDK Client entry point
  */
@@ -1121,7 +1018,7 @@ declare function getCurrentInstanceType(preflightCtx: PreflightContext, appID: A
 type Environment = "sepolia" | "sepolia-dev" | "mainnet-alpha";
 interface ClientConfig {
     verbose: boolean;
-    privateKey: Hex;
+    privateKey: `0x${string}`;
     environment: Environment | string;
     rpcUrl?: string;
 }
@@ -1131,4 +1028,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, type AppInfo, type AppMetrics, type AppProfileInfo, BillingModule, type ClientConfig, ComputeModule, type CreateAppParams, type DeployParams, DeployResult, type ECloudClient, type Environment, EnvironmentConfig, type EstimateBatchGasOptions, type EstimateGasOptions, type GasEstimate, type GeneratedKey, type LegacyKey, type LogVisibility, Logger, type LogsParams, type Metric, type MetricsContext, NoopClient, PostHogClient, type PrepareDeployResult, type PrepareUpgradeResult, type PreparedDeploy, type PreparedUpgrade, type PrivateKeySource, type ResourceUsageMonitoring, type SDKDeployOptions, type SDKUpgradeOptions, type StoredKey, SubscriptionStatus, type TelemetryClient, type TelemetryClientOptions, type TelemetryWrapperOptions, type UpgradeParams, UserApiClient, addMetric, addMetricWithDimensions, assertValidFilePath, assertValidImageReference, assertValidPrivateKey, checkERC7702Delegation, createAppEnvironment, 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, prepareUpgrade, requirePrivateKey, sanitizeString, sanitizeURL, sanitizeXURL, storePrivateKey, validateAppID, validateAppName, validateCreateAppParams, validateDeployParams, validateDescription, validateFilePath, validateImagePath, validateImageReference, validateInstanceTypeSKU, validateLogVisibility, validateLogsParams, validatePrivateKey, validatePrivateKeyFormat, validateResourceUsageMonitoring, validateURL, validateUpgradeParams, validateXURL, watchDeployment, watchUpgrade, withSDKTelemetry };