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

package/dist/{index-D2QufVB9.d.ts → index-D5oW73Dx.d.ts}

@@ -1,4 +1,101 @@
-import { Address, Hex } from 'viem';
+import { PublicClient, Address, Hex } from 'viem';
+
+/**
+ * Contract interactions
+ *
+ * This module handles on-chain contract interactions using viem.
+ *
+ * Accepts viem's WalletClient and PublicClient directly, which abstract over both
+ * local accounts (privateKeyToAccount) and external signers (MetaMask, etc.).
+ *
+ * @example
+ * // CLI usage with private key
+ * const { walletClient, publicClient } = createClients({ privateKey, rpcUrl, chainId });
+ * await deployApp({ walletClient, publicClient, environmentConfig, ... }, logger);
+ *
+ * @example
+ * // Browser usage with external wallet
+ * const walletClient = createWalletClient({ chain, transport: custom(window.ethereum!) });
+ * const publicClient = createPublicClient({ chain, transport: custom(window.ethereum!) });
+ * await deployApp({ walletClient, publicClient, environmentConfig, ... }, logger);
+ */
+
+/**
+ * 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 {
+    publicClient: PublicClient;
+    from: Address;
+    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>;
+/**
+ * Get active app count for a user
+ */
+declare function getActiveAppCount(publicClient: PublicClient, environmentConfig: EnvironmentConfig, user: Address): Promise<number>;
+/**
+ * Get max active apps per user (quota limit)
+ */
+declare function getMaxActiveAppsPerUser(publicClient: PublicClient, environmentConfig: EnvironmentConfig, user: Address): Promise<number>;
+/**
+ * Get apps by creator (paginated)
+ */
+interface AppConfig {
+    release: any;
+    status: number;
+}
+declare function getAppsByCreator(publicClient: PublicClient, environmentConfig: EnvironmentConfig, creator: Address, offset: bigint, limit: bigint): Promise<{
+    apps: Address[];
+    appConfigs: AppConfig[];
+}>;
+/**
+ * Get apps by developer
+ */
+declare function getAppsByDeveloper(publicClient: PublicClient, environmentConfig: EnvironmentConfig, developer: Address, offset: bigint, limit: bigint): Promise<{
+    apps: Address[];
+    appConfigs: AppConfig[];
+}>;
+/**
+ * Fetch all apps by a developer by auto-pagination
+ */
+declare function getAllAppsByDeveloper(publicClient: PublicClient, env: EnvironmentConfig, developer: Address, pageSize?: bigint): Promise<{
+    apps: Address[];
+    appConfigs: AppConfig[];
+}>;
+/**
+ * Get latest release block numbers for multiple apps
+ */
+declare function getAppLatestReleaseBlockNumbers(publicClient: PublicClient, environmentConfig: EnvironmentConfig, appIDs: Address[]): Promise<Map<Address, number>>;
+/**
+ * Get block timestamps for multiple block numbers
+ */
+declare function getBlockTimestamps(publicClient: PublicClient, blockNumbers: number[]): Promise<Map<number, number>>;
 
 /**
  * Core types for ECloud SDK
@@ -20,10 +117,7 @@ interface DeployAppOpts {
     /** Log visibility setting - required */
     logVisibility: logVisibility;
     /** Optional gas params from estimation */
-    gas?: {
-        maxFeePerGas?: bigint;
-        maxPriorityFeePerGas?: bigint;
-    };
+    gas?: GasEstimate;
 }
 interface UpgradeAppOpts {
     /** Path to Dockerfile (if building from Dockerfile) - either this or imageRef is required */
@@ -36,10 +130,7 @@ interface UpgradeAppOpts {
     instanceType: string;
     /** Log visibility setting - required */
     logVisibility: logVisibility;
-    gas?: {
-        maxFeePerGas?: bigint;
-        maxPriorityFeePerGas?: bigint;
-    };
+    gas?: GasEstimate;
 }
 /** Options for prepareDeploy */
 interface PrepareDeployOpts {
@@ -166,10 +257,7 @@ interface PreparedUpgrade {
     imageRef: string;
 }
 interface LifecycleOpts {
-    gas?: {
-        maxFeePerGas?: bigint;
-        maxPriorityFeePerGas?: bigint;
-    };
+    gas?: GasEstimate;
 }
 interface AppRecord {
     id: AppId;
@@ -267,7 +355,9 @@ interface AppProfile {
     /** X (Twitter) URL (optional) */
     xURL?: string;
     /** Path to image file (optional) */
-    imagePath?: string;
+    image?: Blob | File;
+    /** Image name (optional) */
+    imageName?: string;
 }
 /**
  * Profile response from API
@@ -339,4 +429,4 @@ interface BillingEnvironmentConfig {
     billingApiServerURL: string;
 }
 
-export type { AppId as A, BillingEnvironmentConfig as B, ChainID as C, DeployResult as D, EnvironmentConfig as E, CancelResponse as F, GasOpts as G, ProductSubscriptionResponse as H, ImageDigestResult as I, SubscriptionOpts as J, Logger as L, NoActiveSubscriptionResponse as N, PreparedDeploy as P, Release as R, SubscriptionStatus as S, UpgradeAppOpts as U, PreparedUpgrade as a, DeployAppOpts as b, PrepareDeployOpts as c, PrepareUpgradeOpts as d, PrepareDeployFromVerifiableBuildOpts as e, PrepareUpgradeFromVerifiableBuildOpts as f, ExecuteDeployResult as g, ExecuteUpgradeResult as h, PreparedDeployData as i, PreparedUpgradeData as j, LifecycleOpts as k, logVisibility as l, AppRecord as m, DeployOptions as n, ParsedEnvironment as o, DockerImageConfig as p, AppProfile as q, AppProfileResponse as r, ProductID as s, SubscriptionLineItem as t, CreateSubscriptionResponse as u, CheckoutCreatedResponse as v, AlreadyActiveResponse as w, PaymentIssueResponse as x, SubscribeResponse as y, CancelSuccessResponse as z };
+export { getBlockTimestamps as $, type AppId as A, type BillingEnvironmentConfig as B, type AppProfile as C, type DeployAppOpts as D, type EstimateGasOptions as E, type AppProfileResponse as F, type GasEstimate as G, type ProductID as H, type ImageDigestResult as I, type ChainID as J, type SubscriptionLineItem as K, type LifecycleOpts as L, type CreateSubscriptionResponse as M, type CheckoutCreatedResponse as N, type AlreadyActiveResponse as O, type PrepareDeployOpts as P, type PaymentIssueResponse as Q, type Release as R, type SubscriptionStatus as S, type SubscribeResponse as T, type UpgradeAppOpts as U, type CancelSuccessResponse as V, type NoActiveSubscriptionResponse as W, type CancelResponse as X, type ProductSubscriptionResponse as Y, type SubscriptionOpts as Z, getAppLatestReleaseBlockNumbers as _, getAppsByCreator as a, getAppsByDeveloper as b, getActiveAppCount as c, getMaxActiveAppsPerUser as d, estimateTransactionGas as e, formatETH as f, getAllAppsByDeveloper as g, type AppConfig as h, type PrepareUpgradeOpts as i, type PrepareDeployFromVerifiableBuildOpts as j, type PrepareUpgradeFromVerifiableBuildOpts as k, type logVisibility as l, type GasOpts as m, type ExecuteDeployResult as n, type ExecuteUpgradeResult as o, type PreparedDeployData as p, type PreparedUpgradeData as q, type PreparedDeploy as r, type PreparedUpgrade as s, type AppRecord as t, type DeployOptions as u, type DeployResult as v, type EnvironmentConfig as w, type ParsedEnvironment as x, type DockerImageConfig as y, type Logger as z };