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

package/dist/browser.d.cts

@@ -1,7 +1,93 @@
-import { A as AppId } from './index-D5oW73Dx.cjs';
-export { O as AlreadyActiveResponse, h as AppConfig, C as AppProfile, F as AppProfileResponse, t as AppRecord, B as BillingEnvironmentConfig, X as CancelResponse, V as CancelSuccessResponse, J as ChainID, N as CheckoutCreatedResponse, M as CreateSubscriptionResponse, D as DeployAppOpts, u as DeployOptions, v as DeployResult, y as DockerImageConfig, w as EnvironmentConfig, E as EstimateGasOptions, n as ExecuteDeployResult, o as ExecuteUpgradeResult, G as GasEstimate, m as GasOpts, I as ImageDigestResult, L as LifecycleOpts, z as Logger, W as NoActiveSubscriptionResponse, x as ParsedEnvironment, Q as PaymentIssueResponse, j as PrepareDeployFromVerifiableBuildOpts, P as PrepareDeployOpts, k as PrepareUpgradeFromVerifiableBuildOpts, i as PrepareUpgradeOpts, r as PreparedDeploy, p as PreparedDeployData, s as PreparedUpgrade, q as PreparedUpgradeData, H as ProductID, Y as ProductSubscriptionResponse, R as Release, T as SubscribeResponse, K as SubscriptionLineItem, Z as SubscriptionOpts, S as SubscriptionStatus, U as UpgradeAppOpts, e as estimateTransactionGas, f as formatETH, c as getActiveAppCount, g as getAllAppsByDeveloper, a as getAppsByCreator, b as getAppsByDeveloper, d as getMaxActiveAppsPerUser, l as logVisibility } from './index-D5oW73Dx.cjs';
-export { A as AppInfo, D as AppInfoResponse, B as AppMetrics, z as AppProfileInfo, C as CreateAppParams, F as EstimateBatchGasOptions, G as GeneratedKey, L as LogVisibility, w as LogsParams, U as UserApiClient, e as assertValidImageReference, k as assertValidPrivateKey, E as estimateBatchGas, f as extractAppNameFromImage, y as generateNewPrivateKey, a as getAvailableEnvironments, 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, n as validateDescription, d as validateImageReference, h as validateInstanceTypeSKU, p as validateLogVisibility, u as validateLogsParams, j as validatePrivateKeyFormat, l as validateURL, m as validateXURL } from './eip7702-DeqoCP5b.cjs';
-import 'viem';
+import { A as AppId } from './index-C0w92tCs.cjs';
+export { al as AlreadyActiveResponse, w as AppConfig, ac as AppProfile, ad as AppProfileResponse, a2 as AppRecord, K as BatchedDeployResult, a5 as BillingEnvironmentConfig, C as CalculateAppIDOptions, aq as CancelResponse, ao as CancelSuccessResponse, af as ChainID, ak as CheckoutCreatedResponse, ai as CreateSubscriptionOptions, aj as CreateSubscriptionResponse, D as DeployAppOptions, N as DeployAppOpts, a3 as DeployOptions, at as DeployProgressCallback, a4 as DeployResult, au as DeployStep, aa as DockerImageConfig, a6 as EnvironmentConfig, E as EstimateGasOptions, J as ExecuteDeployBatchedOptions, X as ExecuteDeployResult, H as ExecuteDeploySequentialOptions, Y as ExecuteUpgradeResult, G as GasEstimate, W as GasOpts, a9 as ImageDigestResult, I as IsDelegatedOptions, a1 as LifecycleOpts, ab as Logger, ap as NoActiveSubscriptionResponse, a8 as ParsedEnvironment, am as PaymentIssueResponse, P as PrepareDeployBatchOptions, T as PrepareDeployFromVerifiableBuildOpts, Q as PrepareDeployOpts, x as PrepareUpgradeBatchOptions, V as PrepareUpgradeFromVerifiableBuildOpts, R as PrepareUpgradeOpts, $ as PreparedDeploy, y as PreparedDeployBatch, Z as PreparedDeployData, a0 as PreparedUpgrade, z as PreparedUpgradeBatch, _ as PreparedUpgradeData, ae as ProductID, ar as ProductSubscriptionResponse, a7 as Release, S as SendTransactionOptions, av as SequentialDeployResult, an as SubscribeResponse, ah as SubscriptionLineItem, as as SubscriptionOpts, ag as SubscriptionStatus, B as SuspendOptions, F as UndelegateOptions, U as UpgradeAppOptions, O as UpgradeAppOpts, j as calculateAppID, i as deployApp, e as estimateTransactionGas, h as executeDeployBatch, l as executeDeployBatched, k as executeDeploySequential, o as executeUpgradeBatch, f as formatETH, c as getActiveAppCount, g as getAllAppsByDeveloper, a as getAppsByCreator, b as getAppsByDeveloper, d as getMaxActiveAppsPerUser, r as isDelegated, M as logVisibility, L as noopLogger, p as prepareDeployBatch, n as prepareUpgradeBatch, q as sendAndWaitForTransaction, m as supportsEIP5792, s as supportsEIP7702, t as suspend, v as undelegate, u as upgradeApp } from './index-C0w92tCs.cjs';
+import { C as ComputeApiConfig, S as SessionInfo, a as SessionError, b as SiweMessageParams } from './helpers-Dk0zwgms.cjs';
+export { F as AppInfo, J as AppInfoResponse, I as AppMetrics, H as AppProfileInfo, K as BillingApiClient, M as BillingApiClientOptions, ac as BillingApiConfig, af as BillingLoginRequest, ae as BillingLoginResult, ab as BillingSessionError, ad as BillingSessionInfo, z as CreateAppParams, Q as EstimateBatchGasOptions, R as ExecuteBatchOptions, T as Execution, G as GeneratedKey, L as LogVisibility, a4 as LoginRequest, a3 as LoginResult, A as LogsParams, _ as SiweMessageResult, U as UserApiClient, E as UserApiClientOptions, ah as addHexPrefix, j as assertValidImageReference, n as assertValidPrivateKey, P as checkERC7702Delegation, V as createSiweMessage, N as estimateBatchGas, O as executeBatch, k as extractAppNameFromImage, D as generateNewPrivateKey, X as generateNonce, d as getAvailableEnvironments, a7 as getBillingApiSession, c as getBillingEnvironmentConfig, e as getBuildType, ag as getChainFromID, a1 as getComputeApiSession, g as getEnvironmentConfig, a8 as isBillingSessionValid, i as isEnvironmentAvailable, f as isMainnet, a2 as isSessionValid, Y as isSiweMessageExpired, Z as isSiweMessageNotYetValid, B as isSubscriptionActive, a5 as loginToBillingApi, a9 as loginToBothApis, $ as loginToComputeApi, a6 as logoutFromBillingApi, aa as logoutFromBothApis, a0 as logoutFromComputeApi, W as parseSiweMessage, t as sanitizeString, u as sanitizeURL, w as sanitizeXURL, ai as stripHexPrefix, r as validateAppID, v as validateAppName, x as validateCreateAppParams, q as validateDescription, h as validateImageReference, l as validateInstanceTypeSKU, s as validateLogVisibility, y as validateLogsParams, m as validatePrivateKeyFormat, o as validateURL, p as validateXURL } from './helpers-Dk0zwgms.cjs';
+import { WalletClient, Address, Hex } from 'viem';
+import { Buffer as Buffer$1 } from 'buffer';
+
+/**
+ * Build API Client to manage verifiable builds and provenance
+ *
+ * This is a standalone HTTP client that talks to the (compute) UserAPI host.
+ */
+
+interface BuildApiClientOptions {
+    baseUrl: string;
+    walletClient?: WalletClient;
+    clientId?: string;
+    /** Use session-based auth (cookies) instead of signature-based auth */
+    useSession?: boolean;
+    /**
+     * Billing session ID (value of the billing_session cookie).
+     * When provided with useSession=true, this is sent via X-Billing-Session header
+     * to authenticate with the billing API for subscription verification.
+     * Required for submitBuild when using session auth.
+     */
+    billingSessionId?: string;
+}
+declare class BuildApiClient {
+    private readonly baseUrl;
+    private readonly walletClient?;
+    private readonly clientId?;
+    private readonly useSession;
+    private billingSessionId?;
+    constructor(options: BuildApiClientOptions);
+    /**
+     * Update the billing session ID.
+     * Call this after logging into the billing API to enable session-based auth for builds.
+     */
+    setBillingSessionId(sessionId: string | undefined): void;
+    /**
+     * Get the address of the connected wallet
+     */
+    get address(): Address;
+    /**
+     * Submit a new build request.
+     * Supports two auth modes (session auth is tried first when billingSessionId is available):
+     * 1. Session-based auth: X-Billing-Session header (forwarded billing_session cookie)
+     * 2. Signature-based auth: Authorization + X-Account + X-eigenx-expiry headers (requires walletClient)
+     */
+    submitBuild(payload: {
+        repo_url: string;
+        git_ref: string;
+        dockerfile_path: string;
+        caddyfile_path?: string;
+        build_context_path: string;
+        dependencies: string[];
+    }): Promise<{
+        build_id: string;
+    }>;
+    getBuild(buildId: string): Promise<any>;
+    getBuildByDigest(digest: string): Promise<any>;
+    verify(identifier: string): Promise<any>;
+    /**
+     * Get build logs. Supports session auth (identity verification only, no billing check).
+     */
+    getLogs(buildId: string): Promise<string>;
+    listBuilds(params: {
+        billing_address: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<any[]>;
+    private publicJsonRequest;
+    /**
+     * Make a request that ALWAYS requires signature auth (for billing verification).
+     * Used for endpoints like POST /builds that need to verify subscription status.
+     */
+    private signatureAuthJsonRequest;
+    /**
+     * Make a request using billing session auth (for billing verification without wallet signature).
+     * Forwards the billing_session cookie value via X-Billing-Session header.
+     * Used for endpoints that need to verify subscription status when using session-based auth.
+     */
+    private billingSessionAuthJsonRequest;
+    /**
+     * Make an authenticated request that can use session OR signature auth.
+     * When useSession is true, relies on cookies for identity verification.
+     * Used for endpoints that only need identity verification (not billing).
+     */
+    private sessionOrSignatureTextRequest;
+}
 
 /**
  * Browser-safe app action encoders
@@ -23,6 +109,158 @@ declare function encodeStopAppData(appId: AppId): `0x${string}`;
  */
 declare function encodeTerminateAppData(appId: AppId): `0x${string}`;
 
+/**
+ * React Hook for Compute API Session Management
+ *
+ * This hook provides a convenient way to manage compute API sessions in React applications.
+ * It handles session state, auto-refresh, and provides login/logout methods.
+ *
+ * IMPORTANT: This hook requires React 18+ as a peer dependency.
+ * Make sure your application has React installed.
+ */
+
+interface UseComputeSessionConfig extends ComputeApiConfig {
+    /**
+     * Interval in milliseconds to check session validity
+     * Set to 0 to disable auto-refresh
+     * @default 60000 (1 minute)
+     */
+    refreshInterval?: number;
+    /**
+     * Whether to automatically check session on mount
+     * @default true
+     */
+    checkOnMount?: boolean;
+    /**
+     * Callback when session expires or becomes invalid
+     */
+    onSessionExpired?: () => void;
+    /**
+     * Callback when session is successfully refreshed/validated
+     */
+    onSessionRefreshed?: (session: SessionInfo) => void;
+    /**
+     * Callback when an error occurs
+     */
+    onError?: (error: SessionError) => void;
+}
+interface UseComputeSessionReturn {
+    /** Current session information */
+    session: SessionInfo | null;
+    /** Whether the session is currently being loaded/checked */
+    isLoading: boolean;
+    /** Any error that occurred during session operations */
+    error: SessionError | null;
+    /** Whether the user is authenticated */
+    isAuthenticated: boolean;
+    /**
+     * Login to compute API with SIWE
+     *
+     * @param params - SIWE message parameters (address, chainId required)
+     * @param signMessage - Function to sign the message (from wagmi's useSignMessage)
+     * @returns Login result
+     */
+    login: (params: Omit<SiweMessageParams, "domain" | "uri"> & {
+        domain?: string;
+        uri?: string;
+    }, signMessage: (args: {
+        message: string;
+    }) => Promise<Hex>) => Promise<SessionInfo>;
+    /**
+     * Logout from compute API
+     */
+    logout: () => Promise<void>;
+    /**
+     * Manually refresh/check session status
+     */
+    refresh: () => Promise<SessionInfo>;
+    /**
+     * Clear any error state
+     */
+    clearError: () => void;
+}
+/**
+ * React hook for managing compute API sessions with SIWE authentication
+ *
+ * @param config - Configuration options including baseUrl and refresh settings
+ * @returns Session state and methods for login/logout/refresh
+ *
+ * @example
+ * ```tsx
+ * import { useComputeSession } from "@layr-labs/ecloud-sdk/browser";
+ * import { useSignMessage, useAccount } from "wagmi";
+ *
+ * function MyComponent() {
+ *   const { address, chainId } = useAccount();
+ *   const { signMessageAsync } = useSignMessage();
+ *
+ *   const {
+ *     session,
+ *     isLoading,
+ *     isAuthenticated,
+ *     login,
+ *     logout,
+ *     error,
+ *   } = useComputeSession({
+ *     baseUrl: "https://api.eigencloud.xyz",
+ *     onSessionExpired: () => console.log("Session expired!"),
+ *   });
+ *
+ *   const handleLogin = async () => {
+ *     if (!address || !chainId) return;
+ *     await login(
+ *       { address, chainId },
+ *       signMessageAsync
+ *     );
+ *   };
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <div>
+ *       {isAuthenticated ? (
+ *         <>
+ *           <p>Logged in as {session?.address}</p>
+ *           <button onClick={logout}>Logout</button>
+ *         </>
+ *       ) : (
+ *         <button onClick={handleLogin}>Login</button>
+ *       )}
+ *       {error && <p>Error: {error.message}</p>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useComputeSession(config: UseComputeSessionConfig): UseComputeSessionReturn;
+
+/**
+ * KMS encryption utilities
+ * Implements RSA-OAEP-256 + AES-256-GCM encryption using JWE format
+ */
+
+/**
+ * Get app protected headers for encryption
+ */
+declare function getAppProtectedHeaders(appID: string): Record<string, string>;
+/**
+ * Encrypt data using RSA-OAEP-256 for key encryption and AES-256-GCM for data encryption
+ * Uses jose library which properly implements JWE with RSA-OAEP-256
+ */
+declare function encryptRSAOAEPAndAES256GCM(encryptionKeyPEM: string | Buffer$1, plaintext: Buffer$1, protectedHeaders?: Record<string, string> | null): Promise<string>;
+
+/**
+ * KMS key loading utilities
+ */
+type BuildType = "dev" | "prod";
+/**
+ * Get KMS keys for environment
+ */
+declare function getKMSKeysForEnvironment(environment: string, build?: BuildType): {
+    encryptionKey: Buffer;
+    signingKey: Buffer;
+};
+
 /**
  * Browser-safe SDK entry point
  *
@@ -39,4 +277,4 @@ declare function encodeTerminateAppData(appId: AppId): `0x${string}`;
 
 type Environment = "sepolia" | "sepolia-dev" | "mainnet-alpha";
 
-export { AppId, type Environment, encodeStartAppData, encodeStopAppData, encodeTerminateAppData };
+export { AppId, BuildApiClient, type BuildApiClientOptions, ComputeApiConfig, type Environment, SessionError, SessionInfo, SiweMessageParams, type UseComputeSessionConfig, type UseComputeSessionReturn, encodeStartAppData, encodeStopAppData, encodeTerminateAppData, encryptRSAOAEPAndAES256GCM, getAppProtectedHeaders, getKMSKeysForEnvironment, useComputeSession };

package/dist/browser.d.ts

@@ -1,7 +1,93 @@
-import { A as AppId } from './index-D5oW73Dx.js';
-export { O as AlreadyActiveResponse, h as AppConfig, C as AppProfile, F as AppProfileResponse, t as AppRecord, B as BillingEnvironmentConfig, X as CancelResponse, V as CancelSuccessResponse, J as ChainID, N as CheckoutCreatedResponse, M as CreateSubscriptionResponse, D as DeployAppOpts, u as DeployOptions, v as DeployResult, y as DockerImageConfig, w as EnvironmentConfig, E as EstimateGasOptions, n as ExecuteDeployResult, o as ExecuteUpgradeResult, G as GasEstimate, m as GasOpts, I as ImageDigestResult, L as LifecycleOpts, z as Logger, W as NoActiveSubscriptionResponse, x as ParsedEnvironment, Q as PaymentIssueResponse, j as PrepareDeployFromVerifiableBuildOpts, P as PrepareDeployOpts, k as PrepareUpgradeFromVerifiableBuildOpts, i as PrepareUpgradeOpts, r as PreparedDeploy, p as PreparedDeployData, s as PreparedUpgrade, q as PreparedUpgradeData, H as ProductID, Y as ProductSubscriptionResponse, R as Release, T as SubscribeResponse, K as SubscriptionLineItem, Z as SubscriptionOpts, S as SubscriptionStatus, U as UpgradeAppOpts, e as estimateTransactionGas, f as formatETH, c as getActiveAppCount, g as getAllAppsByDeveloper, a as getAppsByCreator, b as getAppsByDeveloper, d as getMaxActiveAppsPerUser, l as logVisibility } from './index-D5oW73Dx.js';
-export { A as AppInfo, D as AppInfoResponse, B as AppMetrics, z as AppProfileInfo, C as CreateAppParams, F as EstimateBatchGasOptions, G as GeneratedKey, L as LogVisibility, w as LogsParams, U as UserApiClient, e as assertValidImageReference, k as assertValidPrivateKey, E as estimateBatchGas, f as extractAppNameFromImage, y as generateNewPrivateKey, a as getAvailableEnvironments, 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, n as validateDescription, d as validateImageReference, h as validateInstanceTypeSKU, p as validateLogVisibility, u as validateLogsParams, j as validatePrivateKeyFormat, l as validateURL, m as validateXURL } from './eip7702-CXCYfOnk.js';
-import 'viem';
+import { A as AppId } from './index-C0w92tCs.js';
+export { al as AlreadyActiveResponse, w as AppConfig, ac as AppProfile, ad as AppProfileResponse, a2 as AppRecord, K as BatchedDeployResult, a5 as BillingEnvironmentConfig, C as CalculateAppIDOptions, aq as CancelResponse, ao as CancelSuccessResponse, af as ChainID, ak as CheckoutCreatedResponse, ai as CreateSubscriptionOptions, aj as CreateSubscriptionResponse, D as DeployAppOptions, N as DeployAppOpts, a3 as DeployOptions, at as DeployProgressCallback, a4 as DeployResult, au as DeployStep, aa as DockerImageConfig, a6 as EnvironmentConfig, E as EstimateGasOptions, J as ExecuteDeployBatchedOptions, X as ExecuteDeployResult, H as ExecuteDeploySequentialOptions, Y as ExecuteUpgradeResult, G as GasEstimate, W as GasOpts, a9 as ImageDigestResult, I as IsDelegatedOptions, a1 as LifecycleOpts, ab as Logger, ap as NoActiveSubscriptionResponse, a8 as ParsedEnvironment, am as PaymentIssueResponse, P as PrepareDeployBatchOptions, T as PrepareDeployFromVerifiableBuildOpts, Q as PrepareDeployOpts, x as PrepareUpgradeBatchOptions, V as PrepareUpgradeFromVerifiableBuildOpts, R as PrepareUpgradeOpts, $ as PreparedDeploy, y as PreparedDeployBatch, Z as PreparedDeployData, a0 as PreparedUpgrade, z as PreparedUpgradeBatch, _ as PreparedUpgradeData, ae as ProductID, ar as ProductSubscriptionResponse, a7 as Release, S as SendTransactionOptions, av as SequentialDeployResult, an as SubscribeResponse, ah as SubscriptionLineItem, as as SubscriptionOpts, ag as SubscriptionStatus, B as SuspendOptions, F as UndelegateOptions, U as UpgradeAppOptions, O as UpgradeAppOpts, j as calculateAppID, i as deployApp, e as estimateTransactionGas, h as executeDeployBatch, l as executeDeployBatched, k as executeDeploySequential, o as executeUpgradeBatch, f as formatETH, c as getActiveAppCount, g as getAllAppsByDeveloper, a as getAppsByCreator, b as getAppsByDeveloper, d as getMaxActiveAppsPerUser, r as isDelegated, M as logVisibility, L as noopLogger, p as prepareDeployBatch, n as prepareUpgradeBatch, q as sendAndWaitForTransaction, m as supportsEIP5792, s as supportsEIP7702, t as suspend, v as undelegate, u as upgradeApp } from './index-C0w92tCs.js';
+import { C as ComputeApiConfig, S as SessionInfo, a as SessionError, b as SiweMessageParams } from './helpers-4w0Iojmm.js';
+export { F as AppInfo, J as AppInfoResponse, I as AppMetrics, H as AppProfileInfo, K as BillingApiClient, M as BillingApiClientOptions, ac as BillingApiConfig, af as BillingLoginRequest, ae as BillingLoginResult, ab as BillingSessionError, ad as BillingSessionInfo, z as CreateAppParams, Q as EstimateBatchGasOptions, R as ExecuteBatchOptions, T as Execution, G as GeneratedKey, L as LogVisibility, a4 as LoginRequest, a3 as LoginResult, A as LogsParams, _ as SiweMessageResult, U as UserApiClient, E as UserApiClientOptions, ah as addHexPrefix, j as assertValidImageReference, n as assertValidPrivateKey, P as checkERC7702Delegation, V as createSiweMessage, N as estimateBatchGas, O as executeBatch, k as extractAppNameFromImage, D as generateNewPrivateKey, X as generateNonce, d as getAvailableEnvironments, a7 as getBillingApiSession, c as getBillingEnvironmentConfig, e as getBuildType, ag as getChainFromID, a1 as getComputeApiSession, g as getEnvironmentConfig, a8 as isBillingSessionValid, i as isEnvironmentAvailable, f as isMainnet, a2 as isSessionValid, Y as isSiweMessageExpired, Z as isSiweMessageNotYetValid, B as isSubscriptionActive, a5 as loginToBillingApi, a9 as loginToBothApis, $ as loginToComputeApi, a6 as logoutFromBillingApi, aa as logoutFromBothApis, a0 as logoutFromComputeApi, W as parseSiweMessage, t as sanitizeString, u as sanitizeURL, w as sanitizeXURL, ai as stripHexPrefix, r as validateAppID, v as validateAppName, x as validateCreateAppParams, q as validateDescription, h as validateImageReference, l as validateInstanceTypeSKU, s as validateLogVisibility, y as validateLogsParams, m as validatePrivateKeyFormat, o as validateURL, p as validateXURL } from './helpers-4w0Iojmm.js';
+import { WalletClient, Address, Hex } from 'viem';
+import { Buffer as Buffer$1 } from 'buffer';
+
+/**
+ * Build API Client to manage verifiable builds and provenance
+ *
+ * This is a standalone HTTP client that talks to the (compute) UserAPI host.
+ */
+
+interface BuildApiClientOptions {
+    baseUrl: string;
+    walletClient?: WalletClient;
+    clientId?: string;
+    /** Use session-based auth (cookies) instead of signature-based auth */
+    useSession?: boolean;
+    /**
+     * Billing session ID (value of the billing_session cookie).
+     * When provided with useSession=true, this is sent via X-Billing-Session header
+     * to authenticate with the billing API for subscription verification.
+     * Required for submitBuild when using session auth.
+     */
+    billingSessionId?: string;
+}
+declare class BuildApiClient {
+    private readonly baseUrl;
+    private readonly walletClient?;
+    private readonly clientId?;
+    private readonly useSession;
+    private billingSessionId?;
+    constructor(options: BuildApiClientOptions);
+    /**
+     * Update the billing session ID.
+     * Call this after logging into the billing API to enable session-based auth for builds.
+     */
+    setBillingSessionId(sessionId: string | undefined): void;
+    /**
+     * Get the address of the connected wallet
+     */
+    get address(): Address;
+    /**
+     * Submit a new build request.
+     * Supports two auth modes (session auth is tried first when billingSessionId is available):
+     * 1. Session-based auth: X-Billing-Session header (forwarded billing_session cookie)
+     * 2. Signature-based auth: Authorization + X-Account + X-eigenx-expiry headers (requires walletClient)
+     */
+    submitBuild(payload: {
+        repo_url: string;
+        git_ref: string;
+        dockerfile_path: string;
+        caddyfile_path?: string;
+        build_context_path: string;
+        dependencies: string[];
+    }): Promise<{
+        build_id: string;
+    }>;
+    getBuild(buildId: string): Promise<any>;
+    getBuildByDigest(digest: string): Promise<any>;
+    verify(identifier: string): Promise<any>;
+    /**
+     * Get build logs. Supports session auth (identity verification only, no billing check).
+     */
+    getLogs(buildId: string): Promise<string>;
+    listBuilds(params: {
+        billing_address: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<any[]>;
+    private publicJsonRequest;
+    /**
+     * Make a request that ALWAYS requires signature auth (for billing verification).
+     * Used for endpoints like POST /builds that need to verify subscription status.
+     */
+    private signatureAuthJsonRequest;
+    /**
+     * Make a request using billing session auth (for billing verification without wallet signature).
+     * Forwards the billing_session cookie value via X-Billing-Session header.
+     * Used for endpoints that need to verify subscription status when using session-based auth.
+     */
+    private billingSessionAuthJsonRequest;
+    /**
+     * Make an authenticated request that can use session OR signature auth.
+     * When useSession is true, relies on cookies for identity verification.
+     * Used for endpoints that only need identity verification (not billing).
+     */
+    private sessionOrSignatureTextRequest;
+}
 
 /**
  * Browser-safe app action encoders
@@ -23,6 +109,158 @@ declare function encodeStopAppData(appId: AppId): `0x${string}`;
  */
 declare function encodeTerminateAppData(appId: AppId): `0x${string}`;
 
+/**
+ * React Hook for Compute API Session Management
+ *
+ * This hook provides a convenient way to manage compute API sessions in React applications.
+ * It handles session state, auto-refresh, and provides login/logout methods.
+ *
+ * IMPORTANT: This hook requires React 18+ as a peer dependency.
+ * Make sure your application has React installed.
+ */
+
+interface UseComputeSessionConfig extends ComputeApiConfig {
+    /**
+     * Interval in milliseconds to check session validity
+     * Set to 0 to disable auto-refresh
+     * @default 60000 (1 minute)
+     */
+    refreshInterval?: number;
+    /**
+     * Whether to automatically check session on mount
+     * @default true
+     */
+    checkOnMount?: boolean;
+    /**
+     * Callback when session expires or becomes invalid
+     */
+    onSessionExpired?: () => void;
+    /**
+     * Callback when session is successfully refreshed/validated
+     */
+    onSessionRefreshed?: (session: SessionInfo) => void;
+    /**
+     * Callback when an error occurs
+     */
+    onError?: (error: SessionError) => void;
+}
+interface UseComputeSessionReturn {
+    /** Current session information */
+    session: SessionInfo | null;
+    /** Whether the session is currently being loaded/checked */
+    isLoading: boolean;
+    /** Any error that occurred during session operations */
+    error: SessionError | null;
+    /** Whether the user is authenticated */
+    isAuthenticated: boolean;
+    /**
+     * Login to compute API with SIWE
+     *
+     * @param params - SIWE message parameters (address, chainId required)
+     * @param signMessage - Function to sign the message (from wagmi's useSignMessage)
+     * @returns Login result
+     */
+    login: (params: Omit<SiweMessageParams, "domain" | "uri"> & {
+        domain?: string;
+        uri?: string;
+    }, signMessage: (args: {
+        message: string;
+    }) => Promise<Hex>) => Promise<SessionInfo>;
+    /**
+     * Logout from compute API
+     */
+    logout: () => Promise<void>;
+    /**
+     * Manually refresh/check session status
+     */
+    refresh: () => Promise<SessionInfo>;
+    /**
+     * Clear any error state
+     */
+    clearError: () => void;
+}
+/**
+ * React hook for managing compute API sessions with SIWE authentication
+ *
+ * @param config - Configuration options including baseUrl and refresh settings
+ * @returns Session state and methods for login/logout/refresh
+ *
+ * @example
+ * ```tsx
+ * import { useComputeSession } from "@layr-labs/ecloud-sdk/browser";
+ * import { useSignMessage, useAccount } from "wagmi";
+ *
+ * function MyComponent() {
+ *   const { address, chainId } = useAccount();
+ *   const { signMessageAsync } = useSignMessage();
+ *
+ *   const {
+ *     session,
+ *     isLoading,
+ *     isAuthenticated,
+ *     login,
+ *     logout,
+ *     error,
+ *   } = useComputeSession({
+ *     baseUrl: "https://api.eigencloud.xyz",
+ *     onSessionExpired: () => console.log("Session expired!"),
+ *   });
+ *
+ *   const handleLogin = async () => {
+ *     if (!address || !chainId) return;
+ *     await login(
+ *       { address, chainId },
+ *       signMessageAsync
+ *     );
+ *   };
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <div>
+ *       {isAuthenticated ? (
+ *         <>
+ *           <p>Logged in as {session?.address}</p>
+ *           <button onClick={logout}>Logout</button>
+ *         </>
+ *       ) : (
+ *         <button onClick={handleLogin}>Login</button>
+ *       )}
+ *       {error && <p>Error: {error.message}</p>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useComputeSession(config: UseComputeSessionConfig): UseComputeSessionReturn;
+
+/**
+ * KMS encryption utilities
+ * Implements RSA-OAEP-256 + AES-256-GCM encryption using JWE format
+ */
+
+/**
+ * Get app protected headers for encryption
+ */
+declare function getAppProtectedHeaders(appID: string): Record<string, string>;
+/**
+ * Encrypt data using RSA-OAEP-256 for key encryption and AES-256-GCM for data encryption
+ * Uses jose library which properly implements JWE with RSA-OAEP-256
+ */
+declare function encryptRSAOAEPAndAES256GCM(encryptionKeyPEM: string | Buffer$1, plaintext: Buffer$1, protectedHeaders?: Record<string, string> | null): Promise<string>;
+
+/**
+ * KMS key loading utilities
+ */
+type BuildType = "dev" | "prod";
+/**
+ * Get KMS keys for environment
+ */
+declare function getKMSKeysForEnvironment(environment: string, build?: BuildType): {
+    encryptionKey: Buffer;
+    signingKey: Buffer;
+};
+
 /**
  * Browser-safe SDK entry point
  *
@@ -39,4 +277,4 @@ declare function encodeTerminateAppData(appId: AppId): `0x${string}`;
 
 type Environment = "sepolia" | "sepolia-dev" | "mainnet-alpha";
 
-export { AppId, type Environment, encodeStartAppData, encodeStopAppData, encodeTerminateAppData };
+export { AppId, BuildApiClient, type BuildApiClientOptions, ComputeApiConfig, type Environment, SessionError, SessionInfo, SiweMessageParams, type UseComputeSessionConfig, type UseComputeSessionReturn, encodeStartAppData, encodeStopAppData, encodeTerminateAppData, encryptRSAOAEPAndAES256GCM, getAppProtectedHeaders, getKMSKeysForEnvironment, useComputeSession };