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

package/dist/index.cjs

@@ -42,6 +42,7 @@ __export(index_exports, {
   NotFoundError: () => NotFoundError,
   PRIMARY_LANGUAGES: () => PRIMARY_LANGUAGES,
   PostHogClient: () => PostHogClient,
+  SessionError: () => SessionError,
   TimeoutError: () => TimeoutError,
   UserApiClient: () => UserApiClient,
   addHexPrefix: () => addHexPrefix,
@@ -58,6 +59,7 @@ __export(index_exports, {
   createComputeModule: () => createComputeModule,
   createECloudClient: () => createECloudClient,
   createMetricsContext: () => createMetricsContext,
+  createSiweMessage: () => createSiweMessage,
   createTelemetryClient: () => createTelemetryClient,
   createViemClients: () => createClients,
   deleteLegacyPrivateKey: () => deleteLegacyPrivateKey,
@@ -74,6 +76,7 @@ __export(index_exports, {
   fetchTemplateCatalog: () => fetchTemplateCatalog,
   formatETH: () => formatETH,
   generateNewPrivateKey: () => generateNewPrivateKey,
+  generateNonce: () => generateNonce,
   getAddressFromPrivateKey: () => getAddressFromPrivateKey,
   getAllAppsByDeveloper: () => getAllAppsByDeveloper,
   getAppLatestReleaseBlockNumbers: () => getAppLatestReleaseBlockNumbers,
@@ -84,6 +87,7 @@ __export(index_exports, {
   getBuildType: () => getBuildType,
   getCategoryDescriptions: () => getCategoryDescriptions,
   getChainFromID: () => getChainFromID,
+  getComputeApiSession: () => getComputeApiSession,
   getCurrentInstanceType: () => getCurrentInstanceType,
   getEnvironmentConfig: () => getEnvironmentConfig,
   getLegacyKeys: () => getLegacyKeys,
@@ -96,10 +100,17 @@ __export(index_exports, {
   isEnvironmentAvailable: () => isEnvironmentAvailable,
   isMainnet: () => isMainnet,
   isNoopClient: () => isNoopClient,
+  isSessionValid: () => isSessionValid,
+  isSiweMessageExpired: () => isSiweMessageExpired,
+  isSiweMessageNotYetValid: () => isSiweMessageNotYetValid,
   isSubscriptionActive: () => isSubscriptionActive,
   keyExists: () => keyExists,
   listStoredKeys: () => listStoredKeys,
+  loginToComputeApi: () => loginToComputeApi,
+  logoutFromComputeApi: () => logoutFromComputeApi,
   logs: () => logs,
+  noopLogger: () => noopLogger,
+  parseSiweMessage: () => parseSiweMessage,
   prepareDeploy: () => prepareDeploy,
   prepareDeployFromVerifiableBuild: () => prepareDeployFromVerifiableBuild,
   prepareUpgrade: () => prepareUpgrade,
@@ -1237,6 +1248,18 @@ function extractRegistryNameNoDocker(imageRef) {
 // src/client/common/contract/eip7702.ts
 var import_viem = require("viem");
 
+// src/client/common/types/index.ts
+var noopLogger = {
+  debug: () => {
+  },
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  }
+};
+
 // src/client/common/abis/ERC7702Delegator.json
 var ERC7702Delegator_default = [
   {
@@ -2322,7 +2345,7 @@ async function checkERC7702Delegation(publicClient, account, delegatorAddress) {
   const expectedCode = `0xef0100${delegatorAddress.slice(2)}`;
   return code.toLowerCase() === expectedCode.toLowerCase();
 }
-async function executeBatch(options, logger) {
+async function executeBatch(options, logger = noopLogger) {
   const { walletClient, publicClient, environmentConfig, executions, pendingMessage, gas } = options;
   const account = walletClient.account;
   if (!account) {
@@ -4027,7 +4050,7 @@ async function calculateAppID(options) {
   });
   return appID;
 }
-async function prepareDeployBatch(options, logger) {
+async function prepareDeployBatch(options, logger = noopLogger) {
   const { walletClient, publicClient, environmentConfig, salt, release, publicLogs } = options;
   const account = walletClient.account;
   if (!account) {
@@ -4107,7 +4130,7 @@ async function prepareDeployBatch(options, logger) {
     environmentConfig
   };
 }
-async function executeDeployBatch(data, context, gas, logger) {
+async function executeDeployBatch(data, context, gas, logger = noopLogger) {
   const pendingMessage = "Deploying new app...";
   const txHash = await executeBatch(
     {
@@ -4122,7 +4145,7 @@ async function executeDeployBatch(data, context, gas, logger) {
   );
   return { appId: data.appId, txHash };
 }
-async function deployApp(options, logger) {
+async function deployApp(options, logger = noopLogger) {
   const prepared = await prepareDeployBatch(options, logger);
   const data = {
     appId: prepared.appId,
@@ -4137,7 +4160,15 @@ async function deployApp(options, logger) {
   return executeDeployBatch(data, context, options.gas, logger);
 }
 async function prepareUpgradeBatch(options) {
-  const { walletClient, publicClient, environmentConfig, appID, release, publicLogs, needsPermissionChange } = options;
+  const {
+    walletClient,
+    publicClient,
+    environmentConfig,
+    appID,
+    release,
+    publicLogs,
+    needsPermissionChange
+  } = options;
   const releaseForViem = {
     rmsRelease: {
       artifacts: release.rmsRelease.artifacts.map((artifact) => ({
@@ -4210,7 +4241,7 @@ async function prepareUpgradeBatch(options) {
     environmentConfig
   };
 }
-async function executeUpgradeBatch(data, context, gas, logger) {
+async function executeUpgradeBatch(data, context, gas, logger = noopLogger) {
   const pendingMessage = `Upgrading app ${data.appId}...`;
   const txHash = await executeBatch(
     {
@@ -4225,7 +4256,7 @@ async function executeUpgradeBatch(data, context, gas, logger) {
   );
   return txHash;
 }
-async function upgradeApp(options, logger) {
+async function upgradeApp(options, logger = noopLogger) {
   const prepared = await prepareUpgradeBatch(options);
   const data = {
     appId: prepared.appId,
@@ -4238,8 +4269,18 @@ async function upgradeApp(options, logger) {
   };
   return executeUpgradeBatch(data, context, options.gas, logger);
 }
-async function sendAndWaitForTransaction(options, logger) {
-  const { walletClient, publicClient, environmentConfig, to, data, value = 0n, pendingMessage, txDescription, gas } = options;
+async function sendAndWaitForTransaction(options, logger = noopLogger) {
+  const {
+    walletClient,
+    publicClient,
+    environmentConfig,
+    to,
+    data,
+    value = 0n,
+    pendingMessage,
+    txDescription,
+    gas
+  } = options;
   const account = walletClient.account;
   if (!account) {
     throw new Error("WalletClient must have an account attached");
@@ -4359,7 +4400,13 @@ async function getAllAppsByDeveloper(publicClient, env, developer, pageSize = 10
   const allApps = [];
   const allConfigs = [];
   while (true) {
-    const { apps, appConfigs } = await getAppsByDeveloper(publicClient, env, developer, offset, pageSize);
+    const { apps, appConfigs } = await getAppsByDeveloper(
+      publicClient,
+      env,
+      developer,
+      offset,
+      pageSize
+    );
     if (apps.length === 0) break;
     allApps.push(...apps);
     allConfigs.push(...appConfigs);
@@ -4415,7 +4462,7 @@ async function isDelegated(options) {
     environmentConfig.erc7702DelegatorAddress
   );
 }
-async function undelegate(options, logger) {
+async function undelegate(options, logger = noopLogger) {
   const { walletClient, publicClient, environmentConfig } = options;
   const account = walletClient.account;
   if (!account) {
@@ -4513,6 +4560,129 @@ async function calculateBillingAuthSignature(options) {
   return { signature, expiry };
 }
 
+// src/client/common/auth/session.ts
+var SessionError = class extends Error {
+  constructor(message, code, statusCode) {
+    super(message);
+    this.code = code;
+    this.statusCode = statusCode;
+    this.name = "SessionError";
+  }
+};
+function stripHexPrefix2(hex) {
+  return hex.startsWith("0x") ? hex.slice(2) : hex;
+}
+async function parseErrorResponse(response) {
+  try {
+    const data = await response.json();
+    return data.error || response.statusText;
+  } catch {
+    return response.statusText;
+  }
+}
+async function loginToComputeApi(config, request) {
+  let response;
+  try {
+    response = await fetch(`${config.baseUrl}/auth/siwe/login`, {
+      method: "POST",
+      credentials: "include",
+      // Include cookies for session management
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        message: request.message,
+        signature: stripHexPrefix2(request.signature)
+      })
+    });
+  } catch (error) {
+    throw new SessionError(
+      `Network error connecting to ${config.baseUrl}: ${error instanceof Error ? error.message : String(error)}`,
+      "NETWORK_ERROR"
+    );
+  }
+  if (!response.ok) {
+    const errorMessage = await parseErrorResponse(response);
+    const status = response.status;
+    if (status === 400) {
+      if (errorMessage.toLowerCase().includes("siwe")) {
+        throw new SessionError(`Invalid SIWE message: ${errorMessage}`, "INVALID_MESSAGE", status);
+      }
+      throw new SessionError(`Bad request: ${errorMessage}`, "INVALID_MESSAGE", status);
+    }
+    if (status === 401) {
+      throw new SessionError(`Invalid signature: ${errorMessage}`, "INVALID_SIGNATURE", status);
+    }
+    throw new SessionError(`Login failed: ${errorMessage}`, "UNKNOWN", status);
+  }
+  const data = await response.json();
+  return {
+    success: data.success,
+    address: data.address
+  };
+}
+async function getComputeApiSession(config) {
+  let response;
+  try {
+    response = await fetch(`${config.baseUrl}/auth/session`, {
+      method: "GET",
+      credentials: "include",
+      // Include cookies for session management
+      headers: {
+        "Content-Type": "application/json"
+      }
+    });
+  } catch {
+    return {
+      authenticated: false
+    };
+  }
+  if (response.status === 401) {
+    return {
+      authenticated: false
+    };
+  }
+  if (!response.ok) {
+    const errorMessage = await parseErrorResponse(response);
+    throw new SessionError(`Failed to get session: ${errorMessage}`, "UNKNOWN", response.status);
+  }
+  const data = await response.json();
+  return {
+    authenticated: data.authenticated,
+    address: data.address,
+    chainId: data.chain_id
+  };
+}
+async function logoutFromComputeApi(config) {
+  let response;
+  try {
+    response = await fetch(`${config.baseUrl}/auth/logout`, {
+      method: "POST",
+      credentials: "include",
+      // Include cookies for session management
+      headers: {
+        "Content-Type": "application/json"
+      }
+    });
+  } catch (error) {
+    throw new SessionError(
+      `Network error connecting to ${config.baseUrl}: ${error instanceof Error ? error.message : String(error)}`,
+      "NETWORK_ERROR"
+    );
+  }
+  if (response.status === 401) {
+    return;
+  }
+  if (!response.ok) {
+    const errorMessage = await parseErrorResponse(response);
+    throw new SessionError(`Logout failed: ${errorMessage}`, "UNKNOWN", response.status);
+  }
+}
+async function isSessionValid(config) {
+  const session = await getComputeApiSession(config);
+  return session.authenticated;
+}
+
 // src/client/common/utils/userapi.ts
 function isJsonObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -4530,15 +4700,16 @@ var CanViewAppLogsPermission = "0x2fd3f2fe";
 var CanViewSensitiveAppInfoPermission = "0x0e67b22f";
 var CanUpdateAppProfilePermission = "0x036fef61";
 function getDefaultClientId() {
-  const version = true ? "0.2.1-dev" : "0.0.0";
+  const version = true ? "0.2.2-dev" : "0.0.0";
   return `ecloud-sdk/v${version}`;
 }
 var UserApiClient = class {
-  constructor(config, walletClient, publicClient, clientId) {
+  constructor(config, walletClient, publicClient, options) {
     this.config = config;
     this.walletClient = walletClient;
     this.publicClient = publicClient;
-    this.clientId = clientId || getDefaultClientId();
+    this.clientId = options?.clientId || getDefaultClientId();
+    this.useSession = options?.useSession ?? false;
   }
   /**
    * Get the address of the connected wallet
@@ -4626,7 +4797,7 @@ var UserApiClient = class {
     const apps = result.apps || result.Apps || [];
     return apps.map((app, i) => ({
       address: app.address || appIDs[i],
-      status: app.status || app.Status || ""
+      status: app.app_status || app.App_Status || ""
     }));
   }
   /**
@@ -4658,9 +4829,11 @@ var UserApiClient = class {
     const headers = {
       "x-client-id": this.clientId
     };
-    const expiry = BigInt(Math.floor(Date.now() / 1e3) + 5 * 60);
-    const authHeaders = await this.generateAuthHeaders(CanUpdateAppProfilePermission, expiry);
-    Object.assign(headers, authHeaders);
+    if (!this.useSession) {
+      const expiry = BigInt(Math.floor(Date.now() / 1e3) + 5 * 60);
+      const authHeaders = await this.generateAuthHeaders(CanUpdateAppProfilePermission, expiry);
+      Object.assign(headers, authHeaders);
+    }
     try {
       const response = await import_axios.default.post(endpoint, formData, {
         headers,
@@ -4669,8 +4842,10 @@ var UserApiClient = class {
         // Don't throw on any status
         maxContentLength: Infinity,
         // Allow large file uploads
-        maxBodyLength: Infinity
+        maxBodyLength: Infinity,
         // Allow large file uploads
+        withCredentials: true
+        // Include cookies for session auth
       });
       const status = response.status;
       if (status !== 200 && status !== 201) {
@@ -4704,7 +4879,7 @@ Please check:
     const headers = {
       "x-client-id": this.clientId
     };
-    if (permission) {
+    if (permission && !this.useSession) {
       const expiry = BigInt(Math.floor(Date.now() / 1e3) + 5 * 60);
       const authHeaders = await this.generateAuthHeaders(permission, expiry);
       Object.assign(headers, authHeaders);
@@ -4713,8 +4888,10 @@ Please check:
       const response = await import_axios.default.get(url, {
         headers,
         maxRedirects: 0,
-        validateStatus: () => true
+        validateStatus: () => true,
         // Don't throw on any status
+        withCredentials: true
+        // Include cookies for session auth
       });
       const status = response.status;
       const statusText = status >= 200 && status < 300 ? "OK" : "Error";
@@ -4756,6 +4933,65 @@ Please check:
       "X-eigenx-expiry": expiry.toString()
     };
   }
+  // ==========================================================================
+  // SIWE Session Management
+  // ==========================================================================
+  /**
+   * Login to the compute API using SIWE (Sign-In with Ethereum)
+   *
+   * This establishes a session with the compute API by verifying the SIWE message
+   * and signature. On success, a session cookie is set in the browser.
+   *
+   * @param request - Login request containing SIWE message and signature
+   * @returns Login result with the authenticated address
+   *
+   * @example
+   * ```typescript
+   * import { createSiweMessage } from "@layr-labs/ecloud-sdk/browser";
+   *
+   * const { message } = createSiweMessage({
+   *   address: userAddress,
+   *   chainId: 11155111,
+   *   domain: window.location.host,
+   *   uri: window.location.origin,
+   * });
+   *
+   * const signature = await signMessageAsync({ message });
+   * const result = await client.siweLogin({ message, signature });
+   * ```
+   */
+  async siweLogin(request) {
+    return loginToComputeApi({ baseUrl: this.config.userApiServerURL }, request);
+  }
+  /**
+   * Logout from the compute API
+   *
+   * This destroys the current session and clears the session cookie.
+   *
+   * @example
+   * ```typescript
+   * await client.siweLogout();
+   * ```
+   */
+  async siweLogout() {
+    return logoutFromComputeApi({ baseUrl: this.config.userApiServerURL });
+  }
+  /**
+   * Get the current SIWE session status from the compute API
+   *
+   * @returns Session information including authentication status and address
+   *
+   * @example
+   * ```typescript
+   * const session = await client.getSiweSession();
+   * if (session.authenticated) {
+   *   console.log(`Logged in as ${session.address}`);
+   * }
+   * ```
+   */
+  async getSiweSession() {
+    return getComputeApiSession({ baseUrl: this.config.userApiServerURL });
+  }
 };
 function transformAppReleaseBuild(raw) {
   if (!isJsonObject(raw)) return void 0;
@@ -5387,9 +5623,13 @@ var BillingApiClient = class {
     }
     return account.address;
   }
-  async createSubscription(productId = "compute") {
+  async createSubscription(productId = "compute", options) {
     const endpoint = `${this.config.billingApiServerURL}/products/${productId}/subscription`;
-    const resp = await this.makeAuthenticatedRequest(endpoint, "POST", productId);
+    const body = options ? {
+      success_url: options.successUrl,
+      cancel_url: options.cancelUrl
+    } : void 0;
+    const resp = await this.makeAuthenticatedRequest(endpoint, "POST", productId, body);
     return resp.json();
   }
   async getSubscription(productId = "compute") {
@@ -5404,7 +5644,7 @@ var BillingApiClient = class {
   /**
    * Make an authenticated request to the billing API
    */
-  async makeAuthenticatedRequest(url, method, productId) {
+  async makeAuthenticatedRequest(url, method, productId, body) {
     const expiry = BigInt(Math.floor(Date.now() / 1e3) + 5 * 60);
     const { signature } = await calculateBillingAuthSignature({
       walletClient: this.walletClient,
@@ -5416,11 +5656,15 @@ var BillingApiClient = class {
       "X-Account": this.address,
       "X-Expiry": expiry.toString()
     };
+    if (body) {
+      headers["Content-Type"] = "application/json";
+    }
     try {
       const response = await (0, import_axios2.default)({
         method,
         url,
         headers,
+        data: body,
         timeout: 3e4,
         maxRedirects: 0,
         validateStatus: () => true
@@ -5429,8 +5673,8 @@ var BillingApiClient = class {
       const status = response.status;
       const statusText = status >= 200 && status < 300 ? "OK" : "Error";
       if (status < 200 || status >= 300) {
-        const body = typeof response.data === "string" ? response.data : JSON.stringify(response.data);
-        throw new Error(`BillingAPI request failed: ${status} ${statusText} - ${body}`);
+        const body2 = typeof response.data === "string" ? response.data : JSON.stringify(response.data);
+        throw new Error(`BillingAPI request failed: ${status} ${statusText} - ${body2}`);
       }
       return {
         json: async () => response.data,
@@ -6916,7 +7160,7 @@ async function logs(options, walletClient, publicClient, environmentConfig, logg
         environmentConfig,
         walletClient,
         publicClient,
-        options.clientId
+        options.clientId ? { clientId: options.clientId } : void 0
       );
       let logsText;
       let logsError = null;
@@ -7215,7 +7459,7 @@ function createAppModule(ctx) {
             environment,
             walletClient,
             publicClient,
-            ctx.clientId
+            ctx.clientId ? { clientId: ctx.clientId } : void 0
           );
           return userApiClient.uploadAppProfile(appId, profile.name, {
             website: profile.website,
@@ -7474,6 +7718,37 @@ function createBillingModule(config) {
 
 // src/client/common/utils/buildapi.ts
 var import_axios3 = __toESM(require("axios"), 1);
+var MAX_RETRIES = 5;
+var INITIAL_BACKOFF_MS = 1e3;
+var MAX_BACKOFF_MS = 3e4;
+async function sleep2(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+function getRetryDelay(res, attempt) {
+  const retryAfter = res.headers["retry-after"];
+  if (retryAfter) {
+    const seconds = parseInt(retryAfter, 10);
+    if (!isNaN(seconds)) {
+      return Math.min(seconds * 1e3, MAX_BACKOFF_MS);
+    }
+  }
+  return Math.min(INITIAL_BACKOFF_MS * Math.pow(2, attempt), MAX_BACKOFF_MS);
+}
+async function requestWithRetry(config) {
+  let lastResponse;
+  for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+    const res = await (0, import_axios3.default)({ ...config, validateStatus: () => true });
+    lastResponse = res;
+    if (res.status !== 429) {
+      return res;
+    }
+    if (attempt < MAX_RETRIES) {
+      const delay = getRetryDelay(res, attempt);
+      await sleep2(delay);
+    }
+  }
+  return lastResponse;
+}
 var BuildApiClient = class {
   constructor(options) {
     this.baseUrl = options.baseUrl.replace(/\/+$/, "");
@@ -7506,24 +7781,22 @@ var BuildApiClient = class {
     return this.authenticatedTextRequest(`/builds/${encodeURIComponent(buildId)}/logs`);
   }
   async listBuilds(params) {
-    const res = await (0, import_axios3.default)({
+    const res = await requestWithRetry({
       url: `${this.baseUrl}/builds`,
       method: "GET",
       params,
       headers: this.clientId ? { "x-client-id": this.clientId } : void 0,
-      timeout: 6e4,
-      validateStatus: () => true
+      timeout: 6e4
     });
     if (res.status < 200 || res.status >= 300) throw buildApiHttpError(res);
     return res.data;
   }
   async publicJsonRequest(path8) {
-    const res = await (0, import_axios3.default)({
+    const res = await requestWithRetry({
       url: `${this.baseUrl}${path8}`,
       method: "GET",
       headers: this.clientId ? { "x-client-id": this.clientId } : void 0,
-      timeout: 6e4,
-      validateStatus: () => true
+      timeout: 6e4
     });
     if (res.status < 200 || res.status >= 300) throw buildApiHttpError(res);
     return res.data;
@@ -7545,13 +7818,12 @@ var BuildApiClient = class {
     headers.Authorization = `Bearer ${signature}`;
     headers["X-eigenx-expiry"] = expiry.toString();
     headers["X-Account"] = this.address;
-    const res = await (0, import_axios3.default)({
+    const res = await requestWithRetry({
       url: `${this.baseUrl}${path8}`,
       method,
       headers,
       data: body,
-      timeout: 6e4,
-      validateStatus: () => true
+      timeout: 6e4
     });
     if (res.status < 200 || res.status >= 300) throw buildApiHttpError(res);
     return res.data;
@@ -7571,13 +7843,12 @@ var BuildApiClient = class {
     headers.Authorization = `Bearer ${signature}`;
     headers["X-eigenx-expiry"] = expiry.toString();
     headers["X-Account"] = this.address;
-    const res = await (0, import_axios3.default)({
+    const res = await requestWithRetry({
       url: `${this.baseUrl}${path8}`,
       method: "GET",
       headers,
       timeout: 6e4,
-      responseType: "text",
-      validateStatus: () => true
+      responseType: "text"
     });
     if (res.status < 200 || res.status >= 300) throw buildApiHttpError(res);
     return typeof res.data === "string" ? res.data : JSON.stringify(res.data);
@@ -7766,7 +8037,7 @@ function createBuildModule(config) {
         if (build.status === BUILD_STATUS.FAILED) {
           throw new BuildFailedError(build.errorMessage ?? "Build failed", buildId);
         }
-        await sleep2(pollIntervalMs);
+        await sleep3(pollIntervalMs);
       }
     },
     async *streamLogs(buildId, pollIntervalMs = DEFAULT_POLL_INTERVAL) {
@@ -7788,12 +8059,12 @@ function createBuildModule(config) {
           lastLength = logs2.length;
         }
         if (build.status !== BUILD_STATUS.BUILDING) break;
-        await sleep2(pollIntervalMs);
+        await sleep3(pollIntervalMs);
       }
     }
   };
 }
-function sleep2(ms) {
+function sleep3(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
 function transformBuild(raw) {
@@ -8076,6 +8347,74 @@ function generateNewPrivateKey() {
   };
 }
 
+// src/client/common/auth/siwe.ts
+var import_siwe = require("siwe");
+var generateNonce = import_siwe.generateNonce;
+function createSiweMessage(params) {
+  const now = /* @__PURE__ */ new Date();
+  const nonce = params.nonce || generateNonce();
+  const issuedAt = params.issuedAt || now;
+  const expirationTime = params.expirationTime || new Date(now.getTime() + 24 * 60 * 60 * 1e3);
+  const siweMessage = new import_siwe.SiweMessage({
+    domain: params.domain,
+    address: params.address,
+    statement: params.statement,
+    uri: params.uri,
+    version: "1",
+    chainId: params.chainId,
+    nonce,
+    issuedAt: issuedAt.toISOString(),
+    expirationTime: expirationTime.toISOString(),
+    notBefore: params.notBefore?.toISOString(),
+    requestId: params.requestId,
+    resources: params.resources
+  });
+  return {
+    message: siweMessage.prepareMessage(),
+    params: {
+      address: params.address,
+      chainId: params.chainId,
+      domain: params.domain,
+      uri: params.uri,
+      nonce,
+      issuedAt,
+      statement: params.statement,
+      expirationTime,
+      notBefore: params.notBefore,
+      requestId: params.requestId,
+      resources: params.resources
+    }
+  };
+}
+function parseSiweMessage(message) {
+  try {
+    const siweMessage = new import_siwe.SiweMessage(message);
+    return {
+      address: siweMessage.address,
+      chainId: siweMessage.chainId,
+      domain: siweMessage.domain,
+      uri: siweMessage.uri,
+      nonce: siweMessage.nonce,
+      statement: siweMessage.statement,
+      issuedAt: siweMessage.issuedAt ? new Date(siweMessage.issuedAt) : void 0,
+      expirationTime: siweMessage.expirationTime ? new Date(siweMessage.expirationTime) : void 0,
+      notBefore: siweMessage.notBefore ? new Date(siweMessage.notBefore) : void 0,
+      requestId: siweMessage.requestId,
+      resources: siweMessage.resources
+    };
+  } catch {
+    return null;
+  }
+}
+function isSiweMessageExpired(params) {
+  if (!params.expirationTime) return false;
+  return /* @__PURE__ */ new Date() > params.expirationTime;
+}
+function isSiweMessageNotYetValid(params) {
+  if (!params.notBefore) return false;
+  return /* @__PURE__ */ new Date() < params.notBefore;
+}
+
 // src/client/common/utils/instance.ts
 async function getCurrentInstanceType(preflightCtx, appID, logger, clientId) {
   try {
@@ -8083,7 +8422,7 @@ async function getCurrentInstanceType(preflightCtx, appID, logger, clientId) {
       preflightCtx.environmentConfig,
       preflightCtx.walletClient,
       preflightCtx.publicClient,
-      clientId
+      clientId ? { clientId } : void 0
     );
     const infos = await userApiClient.getInfos([appID], 1);
     if (infos.length === 0) {
@@ -8147,6 +8486,7 @@ function createECloudClient(cfg) {
   NotFoundError,
   PRIMARY_LANGUAGES,
   PostHogClient,
+  SessionError,
   TimeoutError,
   UserApiClient,
   addHexPrefix,
@@ -8163,6 +8503,7 @@ function createECloudClient(cfg) {
   createComputeModule,
   createECloudClient,
   createMetricsContext,
+  createSiweMessage,
   createTelemetryClient,
   createViemClients,
   deleteLegacyPrivateKey,
@@ -8179,6 +8520,7 @@ function createECloudClient(cfg) {
   fetchTemplateCatalog,
   formatETH,
   generateNewPrivateKey,
+  generateNonce,
   getAddressFromPrivateKey,
   getAllAppsByDeveloper,
   getAppLatestReleaseBlockNumbers,
@@ -8189,6 +8531,7 @@ function createECloudClient(cfg) {
   getBuildType,
   getCategoryDescriptions,
   getChainFromID,
+  getComputeApiSession,
   getCurrentInstanceType,
   getEnvironmentConfig,
   getLegacyKeys,
@@ -8201,10 +8544,17 @@ function createECloudClient(cfg) {
   isEnvironmentAvailable,
   isMainnet,
   isNoopClient,
+  isSessionValid,
+  isSiweMessageExpired,
+  isSiweMessageNotYetValid,
   isSubscriptionActive,
   keyExists,
   listStoredKeys,
+  loginToComputeApi,
+  logoutFromComputeApi,
   logs,
+  noopLogger,
+  parseSiweMessage,
   prepareDeploy,
   prepareDeployFromVerifiableBuild,
   prepareUpgrade,