@layr-labs/ecloud-sdk 0.2.2-dev → 0.3.0-dev.0

package/dist/{helpers-CQuBwQnu.d.ts → helpers-BNGcO-VX.d.cts}

@@ -1,5 +1,5 @@
-import { a6 as EnvironmentConfig, ag as SubscriptionStatus, a5 as BillingEnvironmentConfig, ae as ProductID, ai as CreateSubscriptionOptions, aj as CreateSubscriptionResponse, ar as ProductSubscriptionResponse, G as GasEstimate, ab as Logger } from './index-DeQzn_yM.js';
-import { Address, Hex, WalletClient, PublicClient, Chain } from 'viem';
+import { a6 as EnvironmentConfig, ag as SubscriptionStatus, a5 as BillingEnvironmentConfig, ae as ProductID, ai as CreateSubscriptionOptions, aj as CreateSubscriptionResponse, ar as ProductSubscriptionResponse, G as GasEstimate, ab as Logger } from './index-5y9NG_Id.cjs';
+import { Address, Hex, WalletClient, PublicClient, SignAuthorizationReturnType, Chain } from 'viem';
 
 /**
  * Environment configuration for different networks
@@ -538,32 +538,273 @@ declare class UserApiClient {
     getSiweSession(): Promise<SessionInfo>;
 }
 
+/**
+ * Billing API Session Management
+ *
+ * This module provides utilities for managing authentication sessions with the billing API
+ * using SIWE (Sign-In with Ethereum).
+ *
+ * The billing API now supports the same SIWE-based session authentication as the compute API,
+ * allowing users to sign once and authenticate to both APIs simultaneously.
+ */
+
+interface BillingApiConfig {
+    /** Base URL of the billing API (e.g., "https://billing.eigencloud.xyz") */
+    baseUrl: string;
+}
+interface BillingSessionInfo {
+    /** Whether the session is authenticated */
+    authenticated: boolean;
+    /** Authenticated wallet address (if authenticated) */
+    address?: Address;
+    /** Chain ID used for authentication (if authenticated) */
+    chainId?: number;
+    /** Unix timestamp when authentication occurred (if authenticated) */
+    authenticatedAt?: number;
+}
+interface BillingLoginResult {
+    /** Whether login was successful */
+    success: boolean;
+    /** Authenticated wallet address */
+    address: Address;
+}
+interface BillingLoginRequest {
+    /** SIWE message string */
+    message: string;
+    /** Hex-encoded signature (with or without 0x prefix) */
+    signature: Hex | string;
+}
+/**
+ * Error thrown when billing session operations fail
+ */
+declare class BillingSessionError extends Error {
+    readonly code: "NETWORK_ERROR" | "INVALID_SIGNATURE" | "INVALID_MESSAGE" | "SESSION_EXPIRED" | "UNAUTHORIZED" | "UNKNOWN";
+    readonly statusCode?: number | undefined;
+    constructor(message: string, code: "NETWORK_ERROR" | "INVALID_SIGNATURE" | "INVALID_MESSAGE" | "SESSION_EXPIRED" | "UNAUTHORIZED" | "UNKNOWN", statusCode?: number | undefined);
+}
+/**
+ * Login to the billing API using SIWE
+ *
+ * This establishes a session with the billing API by verifying the SIWE message
+ * and signature. On success, a session cookie is set in the browser.
+ *
+ * The billing API accepts the same SIWE message format as the compute API,
+ * so users only need to sign once and can send the same message/signature
+ * to both APIs.
+ *
+ * @param config - Billing API configuration
+ * @param request - Login request containing SIWE message and signature
+ * @returns Login result with the authenticated address
+ *
+ * @example
+ * ```typescript
+ * import { createSiweMessage, loginToBillingApi } 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 });
+ *
+ * // Can send to both APIs with the same message/signature
+ * const [computeResult, billingResult] = await Promise.all([
+ *   loginToComputeApi({ baseUrl: computeApiUrl }, { message, signature }),
+ *   loginToBillingApi({ baseUrl: billingApiUrl }, { message, signature }),
+ * ]);
+ * ```
+ */
+declare function loginToBillingApi(config: BillingApiConfig, request: BillingLoginRequest): Promise<BillingLoginResult>;
+/**
+ * Get the current session status from the billing API
+ *
+ * @param config - Billing API configuration
+ * @returns Session information including authentication status and address
+ *
+ * @example
+ * ```typescript
+ * const session = await getBillingApiSession({ baseUrl: "https://billing.eigencloud.xyz" });
+ * if (session.authenticated) {
+ *   console.log(`Logged in as ${session.address}`);
+ * }
+ * ```
+ */
+declare function getBillingApiSession(config: BillingApiConfig): Promise<BillingSessionInfo>;
+/**
+ * Logout from the billing API
+ *
+ * This destroys the current session and clears the session cookie.
+ *
+ * @param config - Billing API configuration
+ *
+ * @example
+ * ```typescript
+ * await logoutFromBillingApi({ baseUrl: "https://billing.eigencloud.xyz" });
+ * ```
+ */
+declare function logoutFromBillingApi(config: BillingApiConfig): Promise<void>;
+/**
+ * Check if a billing session is still valid (not expired)
+ *
+ * This is a convenience function that checks the session status
+ * and returns a boolean.
+ *
+ * @param config - Billing API configuration
+ * @returns True if session is authenticated, false otherwise
+ */
+declare function isBillingSessionValid(config: BillingApiConfig): Promise<boolean>;
+/**
+ * Login to both compute and billing APIs simultaneously
+ *
+ * This is a convenience function that sends the same SIWE message and signature
+ * to both APIs in parallel, establishing sessions with both services at once.
+ *
+ * @param computeConfig - Compute API configuration
+ * @param billingConfig - Billing API configuration
+ * @param request - Login request containing SIWE message and signature
+ * @returns Object containing login results for both APIs
+ *
+ * @example
+ * ```typescript
+ * import { createSiweMessage, loginToBothApis } 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 { compute, billing } = await loginToBothApis(
+ *   { baseUrl: computeApiUrl },
+ *   { baseUrl: billingApiUrl },
+ *   { message, signature }
+ * );
+ * ```
+ */
+declare function loginToBothApis(computeConfig: {
+    baseUrl: string;
+}, billingConfig: BillingApiConfig, request: BillingLoginRequest): Promise<{
+    compute: BillingLoginResult;
+    billing: BillingLoginResult;
+}>;
+/**
+ * Logout from both compute and billing APIs simultaneously
+ *
+ * @param computeConfig - Compute API configuration
+ * @param billingConfig - Billing API configuration
+ *
+ * @example
+ * ```typescript
+ * await logoutFromBothApis(
+ *   { baseUrl: computeApiUrl },
+ *   { baseUrl: billingApiUrl }
+ * );
+ * ```
+ */
+declare function logoutFromBothApis(computeConfig: {
+    baseUrl: string;
+}, billingConfig: BillingApiConfig): Promise<void>;
+
 /**
  * BillingAPI Client to manage product subscriptions
  * Standalone client - does not depend on chain infrastructure
  *
  * Accepts viem's WalletClient which abstracts over both local accounts
  * (privateKeyToAccount) and external signers (MetaMask, etc.).
+ *
+ * Supports two authentication modes:
+ * 1. EIP-712 signature auth (default) - signs each request with typed data
+ * 2. Session auth (optional) - uses SIWE session cookies
  */
 
+interface BillingApiClientOptions {
+    /**
+     * Use session-based authentication instead of per-request signatures.
+     * When true, the client will rely on session cookies set by SIWE login.
+     * When false (default), uses EIP-712 typed data signatures for each request.
+     */
+    useSession?: boolean;
+}
 /**
  * BillingAPI Client for managing product subscriptions.
  */
 declare class BillingApiClient {
     private readonly config;
     private readonly walletClient;
-    constructor(config: BillingEnvironmentConfig, walletClient: WalletClient);
+    private readonly options;
+    private readonly useSession;
+    constructor(config: BillingEnvironmentConfig, walletClient: WalletClient | null, options?: BillingApiClientOptions);
     /**
      * Get the address of the connected wallet
+     * Returns undefined if using session auth without a wallet client
      */
-    get address(): Address;
+    get address(): Address | undefined;
+    /**
+     * Get the base URL of the billing API
+     */
+    get baseUrl(): string;
+    /**
+     * Login to the billing API using SIWE
+     *
+     * This establishes a session with the billing 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
+     * const { message } = createSiweMessage({
+     *   address: userAddress,
+     *   chainId: 11155111,
+     *   domain: window.location.host,
+     *   uri: window.location.origin,
+     * });
+     *
+     * const signature = await signMessageAsync({ message });
+     * const result = await billingClient.siweLogin({ message, signature });
+     * ```
+     */
+    siweLogin(request: BillingLoginRequest): Promise<BillingLoginResult>;
+    /**
+     * Logout from the billing API
+     *
+     * This destroys the current session and clears the session cookie.
+     */
+    siweLogout(): Promise<void>;
+    /**
+     * Get the current session status from the billing API
+     *
+     * @returns Session information including authentication status and address
+     */
+    getSession(): Promise<BillingSessionInfo>;
+    /**
+     * Check if there is a valid session
+     *
+     * @returns True if session is authenticated, false otherwise
+     */
+    isSessionValid(): Promise<boolean>;
     createSubscription(productId?: ProductID, options?: CreateSubscriptionOptions): Promise<CreateSubscriptionResponse>;
     getSubscription(productId?: ProductID): Promise<ProductSubscriptionResponse>;
     cancelSubscription(productId?: ProductID): Promise<void>;
     /**
      * Make an authenticated request to the billing API
+     *
+     * Uses session auth if useSession is true, otherwise uses EIP-712 signature auth.
      */
     private makeAuthenticatedRequest;
+    /**
+     * Make a request using session-based authentication (cookies)
+     */
+    private makeSessionAuthenticatedRequest;
+    /**
+     * Make a request using EIP-712 signature authentication
+     */
+    private makeSignatureAuthenticatedRequest;
 }
 
 /**
@@ -584,6 +825,7 @@ interface EstimateBatchGasOptions {
     publicClient: PublicClient;
     account: Address;
     executions: Execution[];
+    authorizationList?: SignAuthorizationReturnType[];
 }
 /**
  * Estimate gas cost for a batch transaction
@@ -599,6 +841,8 @@ interface ExecuteBatchOptions {
     pendingMessage: string;
     /** Optional gas params from estimation */
     gas?: GasEstimate;
+    /** Optional pre-created authorization list (skips internal creation if provided) */
+    authorizationList?: SignAuthorizationReturnType[];
 }
 /**
  * Check if account is delegated to ERC-7702 delegator
@@ -739,4 +983,4 @@ declare function addHexPrefix(value: string): Hex;
  */
 declare function stripHexPrefix(value: string): string;
 
-export { logoutFromComputeApi as $, type LogsParams as A, isSubscriptionActive as B, type ComputeApiConfig as C, generateNewPrivateKey as D, type UserApiClientOptions as E, type AppInfo as F, type GeneratedKey as G, type AppProfileInfo as H, type AppMetrics as I, type AppInfoResponse as J, BillingApiClient as K, type LogVisibility as L, estimateBatchGas as M, executeBatch as N, checkERC7702Delegation as O, type EstimateBatchGasOptions as P, type ExecuteBatchOptions as Q, type Execution as R, type SessionInfo as S, createSiweMessage as T, UserApiClient as U, parseSiweMessage as V, generateNonce as W, isSiweMessageExpired as X, isSiweMessageNotYetValid as Y, type SiweMessageResult as Z, loginToComputeApi as _, SessionError as a, getComputeApiSession as a0, isSessionValid as a1, type LoginResult as a2, type LoginRequest as a3, getChainFromID as a4, addHexPrefix as a5, stripHexPrefix as a6, type ResourceUsageMonitoring as a7, createClients as a8, type AppRelease as a9, type AppReleaseBuild as aa, type AppResponse as ab, validateFilePath as ac, assertValidFilePath as ad, validateImagePath as ae, validateResourceUsageMonitoring as af, type DeployParams as ag, validateDeployParams as ah, type UpgradeParams as ai, validateUpgradeParams as aj, type SiweMessageParams as b, getBillingEnvironmentConfig as c, getAvailableEnvironments as d, getBuildType as e, isMainnet as f, getEnvironmentConfig as g, validateImageReference as h, isEnvironmentAvailable as i, assertValidImageReference as j, extractAppNameFromImage as k, validateInstanceTypeSKU as l, validatePrivateKeyFormat as m, assertValidPrivateKey as n, validateURL as o, validateXURL as p, validateDescription as q, validateAppID as r, validateLogVisibility as s, sanitizeString as t, sanitizeURL as u, validateAppName as v, sanitizeXURL as w, validateCreateAppParams as x, validateLogsParams as y, type CreateAppParams as z };
+export { loginToComputeApi as $, type LogsParams as A, isSubscriptionActive as B, type ComputeApiConfig as C, generateNewPrivateKey as D, type UserApiClientOptions as E, type AppInfo as F, type GeneratedKey as G, type AppProfileInfo as H, type AppMetrics as I, type AppInfoResponse as J, BillingApiClient as K, type LogVisibility as L, type BillingApiClientOptions as M, estimateBatchGas as N, executeBatch as O, checkERC7702Delegation as P, type EstimateBatchGasOptions as Q, type ExecuteBatchOptions as R, type SessionInfo as S, type Execution as T, UserApiClient as U, createSiweMessage as V, parseSiweMessage as W, generateNonce as X, isSiweMessageExpired as Y, isSiweMessageNotYetValid as Z, type SiweMessageResult as _, SessionError as a, logoutFromComputeApi as a0, getComputeApiSession as a1, isSessionValid as a2, type LoginResult as a3, type LoginRequest as a4, loginToBillingApi as a5, logoutFromBillingApi as a6, getBillingApiSession as a7, isBillingSessionValid as a8, loginToBothApis as a9, logoutFromBothApis as aa, BillingSessionError as ab, type BillingApiConfig as ac, type BillingSessionInfo as ad, type BillingLoginResult as ae, type BillingLoginRequest as af, getChainFromID as ag, addHexPrefix as ah, stripHexPrefix as ai, type ResourceUsageMonitoring as aj, createClients as ak, type AppRelease as al, type AppReleaseBuild as am, type AppResponse as an, validateFilePath as ao, assertValidFilePath as ap, validateImagePath as aq, validateResourceUsageMonitoring as ar, type DeployParams as as, validateDeployParams as at, type UpgradeParams as au, validateUpgradeParams as av, type SiweMessageParams as b, getBillingEnvironmentConfig as c, getAvailableEnvironments as d, getBuildType as e, isMainnet as f, getEnvironmentConfig as g, validateImageReference as h, isEnvironmentAvailable as i, assertValidImageReference as j, extractAppNameFromImage as k, validateInstanceTypeSKU as l, validatePrivateKeyFormat as m, assertValidPrivateKey as n, validateURL as o, validateXURL as p, validateDescription as q, validateAppID as r, validateLogVisibility as s, sanitizeString as t, sanitizeURL as u, validateAppName as v, sanitizeXURL as w, validateCreateAppParams as x, validateLogsParams as y, type CreateAppParams as z };

package/dist/{helpers-CEvhJz7f.d.cts → helpers-Cp8qGRTb.d.ts}

@@ -1,5 +1,5 @@
-import { a6 as EnvironmentConfig, ag as SubscriptionStatus, a5 as BillingEnvironmentConfig, ae as ProductID, ai as CreateSubscriptionOptions, aj as CreateSubscriptionResponse, ar as ProductSubscriptionResponse, G as GasEstimate, ab as Logger } from './index-DeQzn_yM.cjs';
-import { Address, Hex, WalletClient, PublicClient, Chain } from 'viem';
+import { a6 as EnvironmentConfig, ag as SubscriptionStatus, a5 as BillingEnvironmentConfig, ae as ProductID, ai as CreateSubscriptionOptions, aj as CreateSubscriptionResponse, ar as ProductSubscriptionResponse, G as GasEstimate, ab as Logger } from './index-5y9NG_Id.js';
+import { Address, Hex, WalletClient, PublicClient, SignAuthorizationReturnType, Chain } from 'viem';
 
 /**
  * Environment configuration for different networks
@@ -538,32 +538,273 @@ declare class UserApiClient {
     getSiweSession(): Promise<SessionInfo>;
 }
 
+/**
+ * Billing API Session Management
+ *
+ * This module provides utilities for managing authentication sessions with the billing API
+ * using SIWE (Sign-In with Ethereum).
+ *
+ * The billing API now supports the same SIWE-based session authentication as the compute API,
+ * allowing users to sign once and authenticate to both APIs simultaneously.
+ */
+
+interface BillingApiConfig {
+    /** Base URL of the billing API (e.g., "https://billing.eigencloud.xyz") */
+    baseUrl: string;
+}
+interface BillingSessionInfo {
+    /** Whether the session is authenticated */
+    authenticated: boolean;
+    /** Authenticated wallet address (if authenticated) */
+    address?: Address;
+    /** Chain ID used for authentication (if authenticated) */
+    chainId?: number;
+    /** Unix timestamp when authentication occurred (if authenticated) */
+    authenticatedAt?: number;
+}
+interface BillingLoginResult {
+    /** Whether login was successful */
+    success: boolean;
+    /** Authenticated wallet address */
+    address: Address;
+}
+interface BillingLoginRequest {
+    /** SIWE message string */
+    message: string;
+    /** Hex-encoded signature (with or without 0x prefix) */
+    signature: Hex | string;
+}
+/**
+ * Error thrown when billing session operations fail
+ */
+declare class BillingSessionError extends Error {
+    readonly code: "NETWORK_ERROR" | "INVALID_SIGNATURE" | "INVALID_MESSAGE" | "SESSION_EXPIRED" | "UNAUTHORIZED" | "UNKNOWN";
+    readonly statusCode?: number | undefined;
+    constructor(message: string, code: "NETWORK_ERROR" | "INVALID_SIGNATURE" | "INVALID_MESSAGE" | "SESSION_EXPIRED" | "UNAUTHORIZED" | "UNKNOWN", statusCode?: number | undefined);
+}
+/**
+ * Login to the billing API using SIWE
+ *
+ * This establishes a session with the billing API by verifying the SIWE message
+ * and signature. On success, a session cookie is set in the browser.
+ *
+ * The billing API accepts the same SIWE message format as the compute API,
+ * so users only need to sign once and can send the same message/signature
+ * to both APIs.
+ *
+ * @param config - Billing API configuration
+ * @param request - Login request containing SIWE message and signature
+ * @returns Login result with the authenticated address
+ *
+ * @example
+ * ```typescript
+ * import { createSiweMessage, loginToBillingApi } 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 });
+ *
+ * // Can send to both APIs with the same message/signature
+ * const [computeResult, billingResult] = await Promise.all([
+ *   loginToComputeApi({ baseUrl: computeApiUrl }, { message, signature }),
+ *   loginToBillingApi({ baseUrl: billingApiUrl }, { message, signature }),
+ * ]);
+ * ```
+ */
+declare function loginToBillingApi(config: BillingApiConfig, request: BillingLoginRequest): Promise<BillingLoginResult>;
+/**
+ * Get the current session status from the billing API
+ *
+ * @param config - Billing API configuration
+ * @returns Session information including authentication status and address
+ *
+ * @example
+ * ```typescript
+ * const session = await getBillingApiSession({ baseUrl: "https://billing.eigencloud.xyz" });
+ * if (session.authenticated) {
+ *   console.log(`Logged in as ${session.address}`);
+ * }
+ * ```
+ */
+declare function getBillingApiSession(config: BillingApiConfig): Promise<BillingSessionInfo>;
+/**
+ * Logout from the billing API
+ *
+ * This destroys the current session and clears the session cookie.
+ *
+ * @param config - Billing API configuration
+ *
+ * @example
+ * ```typescript
+ * await logoutFromBillingApi({ baseUrl: "https://billing.eigencloud.xyz" });
+ * ```
+ */
+declare function logoutFromBillingApi(config: BillingApiConfig): Promise<void>;
+/**
+ * Check if a billing session is still valid (not expired)
+ *
+ * This is a convenience function that checks the session status
+ * and returns a boolean.
+ *
+ * @param config - Billing API configuration
+ * @returns True if session is authenticated, false otherwise
+ */
+declare function isBillingSessionValid(config: BillingApiConfig): Promise<boolean>;
+/**
+ * Login to both compute and billing APIs simultaneously
+ *
+ * This is a convenience function that sends the same SIWE message and signature
+ * to both APIs in parallel, establishing sessions with both services at once.
+ *
+ * @param computeConfig - Compute API configuration
+ * @param billingConfig - Billing API configuration
+ * @param request - Login request containing SIWE message and signature
+ * @returns Object containing login results for both APIs
+ *
+ * @example
+ * ```typescript
+ * import { createSiweMessage, loginToBothApis } 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 { compute, billing } = await loginToBothApis(
+ *   { baseUrl: computeApiUrl },
+ *   { baseUrl: billingApiUrl },
+ *   { message, signature }
+ * );
+ * ```
+ */
+declare function loginToBothApis(computeConfig: {
+    baseUrl: string;
+}, billingConfig: BillingApiConfig, request: BillingLoginRequest): Promise<{
+    compute: BillingLoginResult;
+    billing: BillingLoginResult;
+}>;
+/**
+ * Logout from both compute and billing APIs simultaneously
+ *
+ * @param computeConfig - Compute API configuration
+ * @param billingConfig - Billing API configuration
+ *
+ * @example
+ * ```typescript
+ * await logoutFromBothApis(
+ *   { baseUrl: computeApiUrl },
+ *   { baseUrl: billingApiUrl }
+ * );
+ * ```
+ */
+declare function logoutFromBothApis(computeConfig: {
+    baseUrl: string;
+}, billingConfig: BillingApiConfig): Promise<void>;
+
 /**
  * BillingAPI Client to manage product subscriptions
  * Standalone client - does not depend on chain infrastructure
  *
  * Accepts viem's WalletClient which abstracts over both local accounts
  * (privateKeyToAccount) and external signers (MetaMask, etc.).
+ *
+ * Supports two authentication modes:
+ * 1. EIP-712 signature auth (default) - signs each request with typed data
+ * 2. Session auth (optional) - uses SIWE session cookies
  */
 
+interface BillingApiClientOptions {
+    /**
+     * Use session-based authentication instead of per-request signatures.
+     * When true, the client will rely on session cookies set by SIWE login.
+     * When false (default), uses EIP-712 typed data signatures for each request.
+     */
+    useSession?: boolean;
+}
 /**
  * BillingAPI Client for managing product subscriptions.
  */
 declare class BillingApiClient {
     private readonly config;
     private readonly walletClient;
-    constructor(config: BillingEnvironmentConfig, walletClient: WalletClient);
+    private readonly options;
+    private readonly useSession;
+    constructor(config: BillingEnvironmentConfig, walletClient: WalletClient | null, options?: BillingApiClientOptions);
     /**
      * Get the address of the connected wallet
+     * Returns undefined if using session auth without a wallet client
      */
-    get address(): Address;
+    get address(): Address | undefined;
+    /**
+     * Get the base URL of the billing API
+     */
+    get baseUrl(): string;
+    /**
+     * Login to the billing API using SIWE
+     *
+     * This establishes a session with the billing 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
+     * const { message } = createSiweMessage({
+     *   address: userAddress,
+     *   chainId: 11155111,
+     *   domain: window.location.host,
+     *   uri: window.location.origin,
+     * });
+     *
+     * const signature = await signMessageAsync({ message });
+     * const result = await billingClient.siweLogin({ message, signature });
+     * ```
+     */
+    siweLogin(request: BillingLoginRequest): Promise<BillingLoginResult>;
+    /**
+     * Logout from the billing API
+     *
+     * This destroys the current session and clears the session cookie.
+     */
+    siweLogout(): Promise<void>;
+    /**
+     * Get the current session status from the billing API
+     *
+     * @returns Session information including authentication status and address
+     */
+    getSession(): Promise<BillingSessionInfo>;
+    /**
+     * Check if there is a valid session
+     *
+     * @returns True if session is authenticated, false otherwise
+     */
+    isSessionValid(): Promise<boolean>;
     createSubscription(productId?: ProductID, options?: CreateSubscriptionOptions): Promise<CreateSubscriptionResponse>;
     getSubscription(productId?: ProductID): Promise<ProductSubscriptionResponse>;
     cancelSubscription(productId?: ProductID): Promise<void>;
     /**
      * Make an authenticated request to the billing API
+     *
+     * Uses session auth if useSession is true, otherwise uses EIP-712 signature auth.
      */
     private makeAuthenticatedRequest;
+    /**
+     * Make a request using session-based authentication (cookies)
+     */
+    private makeSessionAuthenticatedRequest;
+    /**
+     * Make a request using EIP-712 signature authentication
+     */
+    private makeSignatureAuthenticatedRequest;
 }
 
 /**
@@ -584,6 +825,7 @@ interface EstimateBatchGasOptions {
     publicClient: PublicClient;
     account: Address;
     executions: Execution[];
+    authorizationList?: SignAuthorizationReturnType[];
 }
 /**
  * Estimate gas cost for a batch transaction
@@ -599,6 +841,8 @@ interface ExecuteBatchOptions {
     pendingMessage: string;
     /** Optional gas params from estimation */
     gas?: GasEstimate;
+    /** Optional pre-created authorization list (skips internal creation if provided) */
+    authorizationList?: SignAuthorizationReturnType[];
 }
 /**
  * Check if account is delegated to ERC-7702 delegator
@@ -739,4 +983,4 @@ declare function addHexPrefix(value: string): Hex;
  */
 declare function stripHexPrefix(value: string): string;
 
-export { logoutFromComputeApi as $, type LogsParams as A, isSubscriptionActive as B, type ComputeApiConfig as C, generateNewPrivateKey as D, type UserApiClientOptions as E, type AppInfo as F, type GeneratedKey as G, type AppProfileInfo as H, type AppMetrics as I, type AppInfoResponse as J, BillingApiClient as K, type LogVisibility as L, estimateBatchGas as M, executeBatch as N, checkERC7702Delegation as O, type EstimateBatchGasOptions as P, type ExecuteBatchOptions as Q, type Execution as R, type SessionInfo as S, createSiweMessage as T, UserApiClient as U, parseSiweMessage as V, generateNonce as W, isSiweMessageExpired as X, isSiweMessageNotYetValid as Y, type SiweMessageResult as Z, loginToComputeApi as _, SessionError as a, getComputeApiSession as a0, isSessionValid as a1, type LoginResult as a2, type LoginRequest as a3, getChainFromID as a4, addHexPrefix as a5, stripHexPrefix as a6, type ResourceUsageMonitoring as a7, createClients as a8, type AppRelease as a9, type AppReleaseBuild as aa, type AppResponse as ab, validateFilePath as ac, assertValidFilePath as ad, validateImagePath as ae, validateResourceUsageMonitoring as af, type DeployParams as ag, validateDeployParams as ah, type UpgradeParams as ai, validateUpgradeParams as aj, type SiweMessageParams as b, getBillingEnvironmentConfig as c, getAvailableEnvironments as d, getBuildType as e, isMainnet as f, getEnvironmentConfig as g, validateImageReference as h, isEnvironmentAvailable as i, assertValidImageReference as j, extractAppNameFromImage as k, validateInstanceTypeSKU as l, validatePrivateKeyFormat as m, assertValidPrivateKey as n, validateURL as o, validateXURL as p, validateDescription as q, validateAppID as r, validateLogVisibility as s, sanitizeString as t, sanitizeURL as u, validateAppName as v, sanitizeXURL as w, validateCreateAppParams as x, validateLogsParams as y, type CreateAppParams as z };
+export { loginToComputeApi as $, type LogsParams as A, isSubscriptionActive as B, type ComputeApiConfig as C, generateNewPrivateKey as D, type UserApiClientOptions as E, type AppInfo as F, type GeneratedKey as G, type AppProfileInfo as H, type AppMetrics as I, type AppInfoResponse as J, BillingApiClient as K, type LogVisibility as L, type BillingApiClientOptions as M, estimateBatchGas as N, executeBatch as O, checkERC7702Delegation as P, type EstimateBatchGasOptions as Q, type ExecuteBatchOptions as R, type SessionInfo as S, type Execution as T, UserApiClient as U, createSiweMessage as V, parseSiweMessage as W, generateNonce as X, isSiweMessageExpired as Y, isSiweMessageNotYetValid as Z, type SiweMessageResult as _, SessionError as a, logoutFromComputeApi as a0, getComputeApiSession as a1, isSessionValid as a2, type LoginResult as a3, type LoginRequest as a4, loginToBillingApi as a5, logoutFromBillingApi as a6, getBillingApiSession as a7, isBillingSessionValid as a8, loginToBothApis as a9, logoutFromBothApis as aa, BillingSessionError as ab, type BillingApiConfig as ac, type BillingSessionInfo as ad, type BillingLoginResult as ae, type BillingLoginRequest as af, getChainFromID as ag, addHexPrefix as ah, stripHexPrefix as ai, type ResourceUsageMonitoring as aj, createClients as ak, type AppRelease as al, type AppReleaseBuild as am, type AppResponse as an, validateFilePath as ao, assertValidFilePath as ap, validateImagePath as aq, validateResourceUsageMonitoring as ar, type DeployParams as as, validateDeployParams as at, type UpgradeParams as au, validateUpgradeParams as av, type SiweMessageParams as b, getBillingEnvironmentConfig as c, getAvailableEnvironments as d, getBuildType as e, isMainnet as f, getEnvironmentConfig as g, validateImageReference as h, isEnvironmentAvailable as i, assertValidImageReference as j, extractAppNameFromImage as k, validateInstanceTypeSKU as l, validatePrivateKeyFormat as m, assertValidPrivateKey as n, validateURL as o, validateXURL as p, validateDescription as q, validateAppID as r, validateLogVisibility as s, sanitizeString as t, sanitizeURL as u, validateAppName as v, sanitizeXURL as w, validateCreateAppParams as x, validateLogsParams as y, type CreateAppParams as z };

package/dist/{index-DeQzn_yM.d.cts → index-5y9NG_Id.d.cts}

@@ -1,4 +1,4 @@
-import { PublicClient, Address, Hex, WalletClient } from 'viem';
+import { PublicClient, Address, Hex, WalletClient, SignAuthorizationReturnType } from 'viem';
 
 /**
  * Contract interactions
@@ -503,6 +503,8 @@ interface PreparedDeployData {
         value: bigint;
         callData: Hex;
     }>;
+    /** Pre-created authorization list for gas estimation accuracy (optional) */
+    authorizationList?: SignAuthorizationReturnType[];
 }
 /** Data-only batch for upgrade (clients provided by module) */
 interface PreparedUpgradeData {
@@ -514,6 +516,8 @@ interface PreparedUpgradeData {
         value: bigint;
         callData: Hex;
     }>;
+    /** Pre-created authorization list for gas estimation accuracy (optional) */
+    authorizationList?: SignAuthorizationReturnType[];
 }
 /** Prepared deployment ready for execution */
 interface PreparedDeploy {
@@ -708,6 +712,10 @@ interface ProductSubscriptionResponse {
 }
 interface SubscriptionOpts {
     productId?: ProductID;
+    /** URL to redirect to after successful checkout */
+    successUrl?: string;
+    /** URL to redirect to if checkout is canceled */
+    cancelUrl?: string;
 }
 interface BillingEnvironmentConfig {
     billingApiServerURL: string;