@layr-labs/ecloud-sdk 0.1.1 → 0.1.2

package/dist/{compute-gpepEsn3.d.ts → compute-BlUpqWKo.d.cts}

@@ -1,5 +1,5 @@
-import { L as Logger, a as DeployAppOpts, A as AppId, U as UpgradeAppOpts, b as LifecycleOpts } from './index-D-SUX3IG.js';
-import { Address } from 'viem';
+import { Address, Hex } from 'viem';
+import { L as Logger, E as EnvironmentConfig, b as DeployAppOpts, A as AppId, U as UpgradeAppOpts, c as PrepareDeployOpts, P as PreparedDeploy, G as GasOpts, e as ExecuteDeployResult, d as PrepareUpgradeOpts, a as PreparedUpgrade, f as ExecuteUpgradeResult, o as AppProfile, p as AppProfileResponse, i as LifecycleOpts } from './index-Fb_S-Cqk.cjs';
 
 /**
  * Create command
@@ -109,6 +109,71 @@ interface LogsOptions {
  */
 declare function logs(options: SDKLogsOptions | LogsOptions, logger?: Logger, skipTelemetry?: boolean): Promise<void>;
 
+/**
+ * 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>;
+/**
+ * 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 App namespace entry point
  */
@@ -116,47 +181,60 @@ declare function logs(options: SDKLogsOptions | LogsOptions, logger?: Logger, sk
 /**
  * Encode start app call data for gas estimation
  */
-declare function encodeStartAppData(appId: AppId): `0x${string}`;
+declare function encodeStartAppData(appId: AppId): Hex;
 /**
  * Encode stop app call data for gas estimation
  */
-declare function encodeStopAppData(appId: AppId): `0x${string}`;
+declare function encodeStopAppData(appId: AppId): Hex;
 /**
  * Encode terminate app call data for gas estimation
  */
-declare function encodeTerminateAppData(appId: AppId): `0x${string}`;
+declare function encodeTerminateAppData(appId: AppId): Hex;
 interface AppModule {
     create: (opts: CreateAppOpts) => Promise<void>;
     deploy: (opts: DeployAppOpts) => Promise<{
         appId: AppId;
-        tx: `0x${string}`;
+        tx: Hex;
         appName: string;
         imageRef: string;
         ipAddress?: string;
     }>;
     upgrade: (appId: AppId, opts: UpgradeAppOpts) => Promise<{
-        tx: `0x${string}`;
-        appId: string;
+        tx: Hex;
+        appId: AppId;
         imageRef: string;
     }>;
+    prepareDeploy: (opts: PrepareDeployOpts) => Promise<{
+        prepared: PreparedDeploy;
+        gasEstimate: GasEstimate;
+    }>;
+    executeDeploy: (prepared: PreparedDeploy, gas?: GasOpts) => Promise<ExecuteDeployResult>;
+    watchDeployment: (appId: AppId) => Promise<string | undefined>;
+    prepareUpgrade: (appId: AppId, opts: PrepareUpgradeOpts) => Promise<{
+        prepared: PreparedUpgrade;
+        gasEstimate: GasEstimate;
+    }>;
+    executeUpgrade: (prepared: PreparedUpgrade, gas?: GasOpts) => Promise<ExecuteUpgradeResult>;
+    watchUpgrade: (appId: AppId) => Promise<void>;
+    setProfile: (appId: AppId, profile: AppProfile) => Promise<AppProfileResponse>;
     logs: (opts: LogsOptions) => Promise<void>;
     start: (appId: AppId, opts?: LifecycleOpts) => Promise<{
-        tx: `0x${string}` | false;
+        tx: Hex | false;
     }>;
     stop: (appId: AppId, opts?: LifecycleOpts) => Promise<{
-        tx: `0x${string}` | false;
+        tx: Hex | false;
     }>;
     terminate: (appId: AppId, opts?: LifecycleOpts) => Promise<{
-        tx: `0x${string}` | false;
+        tx: Hex | false;
     }>;
     isDelegated: () => Promise<boolean>;
     undelegate: () => Promise<{
-        tx: `0x${string}` | false;
+        tx: Hex | false;
     }>;
 }
 interface AppModuleConfig {
     verbose?: boolean;
-    privateKey: `0x${string}`;
+    privateKey: Hex;
     rpcUrl: string;
     environment: string;
     clientId?: string;
@@ -173,7 +251,7 @@ interface ComputeModule {
 }
 interface ComputeModuleConfig {
     verbose?: boolean;
-    privateKey: `0x${string}`;
+    privateKey: Hex;
     rpcUrl: string;
     environment: string;
     clientId?: string;
@@ -181,4 +259,4 @@ interface ComputeModuleConfig {
 }
 declare function createComputeModule(config: ComputeModuleConfig): ComputeModule;
 
-export { type AppModule as A, type ComputeModule as C, type LogsOptions as L, PRIMARY_LANGUAGES as P, type SDKCreateAppOpts as S, type CreateAppOpts as a, type SDKLogsOptions as b, createApp as c, createComputeModule as d, type ComputeModuleConfig as e, encodeStartAppData as f, getAvailableTemplates as g, encodeStopAppData as h, encodeTerminateAppData as i, createAppModule as j, type AppModuleConfig as k, logs as l };
+export { type AppModule as A, type ComputeModule as C, type EstimateGasOptions as E, type GasEstimate as G, type LogsOptions as L, PRIMARY_LANGUAGES as P, type SDKCreateAppOpts as S, type CreateAppOpts as a, type SDKLogsOptions as b, createApp as c, createComputeModule as d, type ComputeModuleConfig as e, encodeStartAppData as f, getAvailableTemplates as g, encodeStopAppData as h, encodeTerminateAppData as i, getAllAppsByDeveloper as j, getAppLatestReleaseBlockNumbers as k, logs as l, getBlockTimestamps as m, estimateTransactionGas as n, formatETH as o, createAppModule as p, type AppModuleConfig as q };

package/dist/{compute-B_ibIORD.d.cts → compute-CottWiST.d.ts}

@@ -1,5 +1,5 @@
-import { L as Logger, a as DeployAppOpts, A as AppId, U as UpgradeAppOpts, b as LifecycleOpts } from './index-D-SUX3IG.cjs';
-import { Address } from 'viem';
+import { Address, Hex } from 'viem';
+import { L as Logger, E as EnvironmentConfig, b as DeployAppOpts, A as AppId, U as UpgradeAppOpts, c as PrepareDeployOpts, P as PreparedDeploy, G as GasOpts, e as ExecuteDeployResult, d as PrepareUpgradeOpts, a as PreparedUpgrade, f as ExecuteUpgradeResult, o as AppProfile, p as AppProfileResponse, i as LifecycleOpts } from './index-Fb_S-Cqk.js';
 
 /**
  * Create command
@@ -109,6 +109,71 @@ interface LogsOptions {
  */
 declare function logs(options: SDKLogsOptions | LogsOptions, logger?: Logger, skipTelemetry?: boolean): Promise<void>;
 
+/**
+ * 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>;
+/**
+ * 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 App namespace entry point
  */
@@ -116,47 +181,60 @@ declare function logs(options: SDKLogsOptions | LogsOptions, logger?: Logger, sk
 /**
  * Encode start app call data for gas estimation
  */
-declare function encodeStartAppData(appId: AppId): `0x${string}`;
+declare function encodeStartAppData(appId: AppId): Hex;
 /**
  * Encode stop app call data for gas estimation
  */
-declare function encodeStopAppData(appId: AppId): `0x${string}`;
+declare function encodeStopAppData(appId: AppId): Hex;
 /**
  * Encode terminate app call data for gas estimation
  */
-declare function encodeTerminateAppData(appId: AppId): `0x${string}`;
+declare function encodeTerminateAppData(appId: AppId): Hex;
 interface AppModule {
     create: (opts: CreateAppOpts) => Promise<void>;
     deploy: (opts: DeployAppOpts) => Promise<{
         appId: AppId;
-        tx: `0x${string}`;
+        tx: Hex;
         appName: string;
         imageRef: string;
         ipAddress?: string;
     }>;
     upgrade: (appId: AppId, opts: UpgradeAppOpts) => Promise<{
-        tx: `0x${string}`;
-        appId: string;
+        tx: Hex;
+        appId: AppId;
         imageRef: string;
     }>;
+    prepareDeploy: (opts: PrepareDeployOpts) => Promise<{
+        prepared: PreparedDeploy;
+        gasEstimate: GasEstimate;
+    }>;
+    executeDeploy: (prepared: PreparedDeploy, gas?: GasOpts) => Promise<ExecuteDeployResult>;
+    watchDeployment: (appId: AppId) => Promise<string | undefined>;
+    prepareUpgrade: (appId: AppId, opts: PrepareUpgradeOpts) => Promise<{
+        prepared: PreparedUpgrade;
+        gasEstimate: GasEstimate;
+    }>;
+    executeUpgrade: (prepared: PreparedUpgrade, gas?: GasOpts) => Promise<ExecuteUpgradeResult>;
+    watchUpgrade: (appId: AppId) => Promise<void>;
+    setProfile: (appId: AppId, profile: AppProfile) => Promise<AppProfileResponse>;
     logs: (opts: LogsOptions) => Promise<void>;
     start: (appId: AppId, opts?: LifecycleOpts) => Promise<{
-        tx: `0x${string}` | false;
+        tx: Hex | false;
     }>;
     stop: (appId: AppId, opts?: LifecycleOpts) => Promise<{
-        tx: `0x${string}` | false;
+        tx: Hex | false;
     }>;
     terminate: (appId: AppId, opts?: LifecycleOpts) => Promise<{
-        tx: `0x${string}` | false;
+        tx: Hex | false;
     }>;
     isDelegated: () => Promise<boolean>;
     undelegate: () => Promise<{
-        tx: `0x${string}` | false;
+        tx: Hex | false;
     }>;
 }
 interface AppModuleConfig {
     verbose?: boolean;
-    privateKey: `0x${string}`;
+    privateKey: Hex;
     rpcUrl: string;
     environment: string;
     clientId?: string;
@@ -173,7 +251,7 @@ interface ComputeModule {
 }
 interface ComputeModuleConfig {
     verbose?: boolean;
-    privateKey: `0x${string}`;
+    privateKey: Hex;
     rpcUrl: string;
     environment: string;
     clientId?: string;
@@ -181,4 +259,4 @@ interface ComputeModuleConfig {
 }
 declare function createComputeModule(config: ComputeModuleConfig): ComputeModule;
 
-export { type AppModule as A, type ComputeModule as C, type LogsOptions as L, PRIMARY_LANGUAGES as P, type SDKCreateAppOpts as S, type CreateAppOpts as a, type SDKLogsOptions as b, createApp as c, createComputeModule as d, type ComputeModuleConfig as e, encodeStartAppData as f, getAvailableTemplates as g, encodeStopAppData as h, encodeTerminateAppData as i, createAppModule as j, type AppModuleConfig as k, logs as l };
+export { type AppModule as A, type ComputeModule as C, type EstimateGasOptions as E, type GasEstimate as G, type LogsOptions as L, PRIMARY_LANGUAGES as P, type SDKCreateAppOpts as S, type CreateAppOpts as a, type SDKLogsOptions as b, createApp as c, createComputeModule as d, type ComputeModuleConfig as e, encodeStartAppData as f, getAvailableTemplates as g, encodeStopAppData as h, encodeTerminateAppData as i, getAllAppsByDeveloper as j, getAppLatestReleaseBlockNumbers as k, logs as l, getBlockTimestamps as m, estimateTransactionGas as n, formatETH as o, createAppModule as p, type AppModuleConfig as q };