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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layr-labs/ecloud-sdk",
-  "version": "0.2.1-dev",
+  "version": "0.2.2-dev",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -54,12 +54,22 @@
     "js-yaml": "^4.1.1",
     "node-forge": "^1.3.2",
     "posthog-node": "^5.17.2",
+    "siwe": "^2.3.2",
     "viem": "^2.38.6"
   },
   "devDependencies": {
     "@types/dockerode": "^3.3.45",
     "@types/form-data": "^2.5.2",
     "@types/js-yaml": "^4.0.9",
-    "@types/node-forge": "^1.3.14"
+    "@types/node-forge": "^1.3.14",
+    "@types/react": "^18.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
   }
 }

package/dist/eip7702-CXCYfOnk.d.ts

@@ -1,400 +0,0 @@
-import { w as EnvironmentConfig, S as SubscriptionStatus, G as GasEstimate } from './index-D5oW73Dx.js';
-import { Address, WalletClient, PublicClient, Hex } from 'viem';
-
-/**
- * Environment configuration for different networks
- */
-
-/**
- * Get environment configuration
- */
-declare function getEnvironmentConfig(environment: string, chainID?: bigint): EnvironmentConfig;
-/**
- * Get billing environment configuration
- * @param build - The build type ("dev" or "prod")
- */
-declare function getBillingEnvironmentConfig(build: "dev" | "prod"): {
-    billingApiServerURL: string;
-};
-declare function getBuildType(): "dev" | "prod";
-/**
- * Get available environments based on build type
- * - dev: only "sepolia-dev"
- * - prod: "sepolia" and "mainnet-alpha"
- */
-declare function getAvailableEnvironments(): string[];
-/**
- * Check if an environment is available in the current build
- */
-declare function isEnvironmentAvailable(environment: string): boolean;
-/**
- * Check if environment is mainnet (chain ID 1)
- */
-declare function isMainnet(environmentConfig: EnvironmentConfig): boolean;
-
-/**
- * Non-interactive validation utilities for SDK
- *
- * These functions validate parameters without any interactive prompts.
- * They either return the validated value or throw an error.
- */
-
-/**
- * Validate app name format
- * @throws Error if name is invalid
- */
-declare function validateAppName(name: string): void;
-/**
- * Validate Docker image reference format
- * @returns true if valid, error message string if invalid
- */
-declare function validateImageReference(value: string): true | string;
-/**
- * Validate image reference and throw if invalid
- * @throws Error if image reference is invalid
- */
-declare function assertValidImageReference(value: string): void;
-/**
- * Extract app name from image reference
- */
-declare function extractAppNameFromImage(imageRef: string): string;
-/**
- * Validate that a file path exists
- * @returns true if valid, error message string if invalid
- */
-declare function validateFilePath(value: string): true | string;
-/**
- * Validate file path and throw if invalid
- * @throws Error if file path is invalid or doesn't exist
- */
-declare function assertValidFilePath(value: string): void;
-/**
- * Validate instance type SKU against available types
- * @returns the validated SKU
- * @throws Error if SKU is not in the available types list
- */
-declare function validateInstanceTypeSKU(sku: string, availableTypes: Array<{
-    sku: string;
-}>): string;
-/**
- * Validate private key format
- * Matches Go's common.ValidatePrivateKey() function
- */
-declare function validatePrivateKeyFormat(key: string): boolean;
-/**
- * Validate private key and throw if invalid
- * @throws Error if private key format is invalid
- */
-declare function assertValidPrivateKey(key: string): void;
-/**
- * Validate URL format
- * @returns undefined if valid, error message string if invalid
- */
-declare function validateURL(rawURL: string): string | undefined;
-/**
- * Validate X/Twitter URL format
- * @returns undefined if valid, error message string if invalid
- */
-declare function validateXURL(rawURL: string): string | undefined;
-/**
- * Validate description length
- * @returns undefined if valid, error message string if invalid
- */
-declare function validateDescription(description: string): string | undefined;
-/**
- * Validate image file path
- * @returns undefined if valid, error message string if invalid
- */
-declare function validateImagePath(filePath: string): string | undefined;
-/**
- * Validate and normalize app ID address
- * @param appID - App ID (must be a valid address)
- * @returns Normalized app address
- * @throws Error if app ID is not a valid address
- *
- * Note: Name resolution should be handled by CLI before calling SDK functions.
- * The SDK only accepts resolved addresses.
- */
-declare function validateAppID(appID: string | Address): Address;
-type LogVisibility = "public" | "private" | "off";
-/**
- * Validate and convert log visibility setting to internal format
- * @param logVisibility - Log visibility setting
- * @returns Object with logRedirect and publicLogs settings
- * @throws Error if log visibility value is invalid
- */
-declare function validateLogVisibility(logVisibility: LogVisibility): {
-    logRedirect: string;
-    publicLogs: boolean;
-};
-type ResourceUsageMonitoring = "enable" | "disable";
-/**
- * Validate and convert resource usage monitoring setting to internal format
- * @param resourceUsageMonitoring - Resource usage monitoring setting
- * @returns The resourceUsageAllow value for the Dockerfile label ("always" or "never")
- * @throws Error if resource usage monitoring value is invalid
- */
-declare function validateResourceUsageMonitoring(resourceUsageMonitoring: ResourceUsageMonitoring | undefined): string;
-/**
- * Sanitize string (HTML escape and trim)
- */
-declare function sanitizeString(s: string): string;
-/**
- * Sanitize URL (add https:// if missing, validate)
- * @throws Error if URL is invalid after sanitization
- */
-declare function sanitizeURL(rawURL: string): string;
-/**
- * Sanitize X/Twitter URL (handle username-only input, normalize)
- * @throws Error if URL is invalid after sanitization
- */
-declare function sanitizeXURL(rawURL: string): string;
-interface DeployParams {
-    dockerfilePath?: string;
-    imageRef?: string;
-    appName: string;
-    envFilePath?: string;
-    instanceType: string;
-    logVisibility: LogVisibility;
-}
-/**
- * Validate deploy parameters
- * @throws Error if required parameters are missing or invalid
- */
-declare function validateDeployParams(params: Partial<DeployParams>): void;
-interface UpgradeParams {
-    appID: string | Address;
-    dockerfilePath?: string;
-    imageRef?: string;
-    envFilePath?: string;
-    instanceType: string;
-    logVisibility: LogVisibility;
-}
-/**
- * Validate upgrade parameters
- * @throws Error if required parameters are missing or invalid
- */
-declare function validateUpgradeParams(params: Partial<UpgradeParams>): void;
-interface CreateAppParams {
-    name: string;
-    language: string;
-    template?: string;
-    templateVersion?: string;
-}
-/**
- * Validate create app parameters
- * @throws Error if required parameters are missing or invalid
- */
-declare function validateCreateAppParams(params: Partial<CreateAppParams>): void;
-interface LogsParams {
-    appID: string | Address;
-    watch?: boolean;
-}
-/**
- * Validate logs parameters
- * @throws Error if required parameters are missing or invalid
- */
-declare function validateLogsParams(params: Partial<LogsParams>): void;
-
-/**
- * Billing utility functions
- */
-
-/**
- * Check if subscription status allows deploying apps
- */
-declare function isSubscriptionActive(status: SubscriptionStatus): boolean;
-
-/**
- * Private Key Generation
- *
- * Generate new secp256k1 private keys for Ethereum
- */
-interface GeneratedKey {
-    privateKey: string;
-    address: string;
-}
-/**
- * Generate a new secp256k1 private key
- */
-declare function generateNewPrivateKey(): GeneratedKey;
-
-interface AppProfileInfo {
-    name: string;
-    website?: string;
-    description?: string;
-    xURL?: string;
-    imageURL?: string;
-}
-interface AppMetrics {
-    cpu_utilization_percent?: number;
-    memory_utilization_percent?: number;
-    memory_used_bytes?: number;
-    memory_total_bytes?: number;
-}
-interface DerivedAddress {
-    address: string;
-    derivationPath: string;
-}
-interface AppInfo {
-    address: Address;
-    status: string;
-    ip: string;
-    machineType: string;
-    profile?: AppProfileInfo;
-    metrics?: AppMetrics;
-    evmAddresses: DerivedAddress[];
-    solanaAddresses: DerivedAddress[];
-}
-interface AppInfoResponse {
-    apps: Array<{
-        addresses: {
-            data: {
-                evmAddresses: DerivedAddress[];
-                solanaAddresses: DerivedAddress[];
-            };
-            signature: string;
-        };
-        app_status: string;
-        ip: string;
-        machine_type: string;
-        profile?: AppProfileInfo;
-        metrics?: AppMetrics;
-    }>;
-}
-type AppContractStatus = "STARTED" | "STOPPED" | "TERMINATED" | "SUSPENDED" | string;
-interface AppReleaseBuild {
-    buildId?: string;
-    billingAddress?: string;
-    repoUrl?: string;
-    gitRef?: string;
-    status?: string;
-    buildType?: string;
-    imageName?: string;
-    imageDigest?: string;
-    imageUrl?: string;
-    provenanceJson?: unknown;
-    provenanceSignature?: string;
-    createdAt?: string;
-    updatedAt?: string;
-    errorMessage?: string;
-    dependencies?: Record<string, AppReleaseBuild>;
-}
-interface AppRelease {
-    appId?: string;
-    rmsReleaseId?: string;
-    imageDigest?: string;
-    registryUrl?: string;
-    publicEnv?: string;
-    encryptedEnv?: string;
-    upgradeByTime?: number;
-    createdAt?: string;
-    createdAtBlock?: string;
-    build?: AppReleaseBuild;
-}
-interface AppResponse {
-    id: string;
-    creator?: string;
-    contractStatus?: AppContractStatus;
-    releases: AppRelease[];
-}
-/**
- * UserAPI Client for interacting with the EigenCloud UserAPI service.
- */
-declare class UserApiClient {
-    private readonly config;
-    private readonly walletClient;
-    private readonly publicClient;
-    private readonly clientId;
-    constructor(config: EnvironmentConfig, walletClient: WalletClient, publicClient: PublicClient, clientId?: string);
-    /**
-     * Get the address of the connected wallet
-     */
-    get address(): Address;
-    getInfos(appIDs: Address[], addressCount?: number): Promise<AppInfo[]>;
-    /**
-     * Get app details from UserAPI (includes releases and build/provenance info when available).
-     *
-     * Endpoint: GET /apps/:appAddress
-     */
-    getApp(appAddress: Address): Promise<AppResponse>;
-    /**
-     * Get available SKUs (instance types) from UserAPI
-     */
-    getSKUs(): Promise<{
-        skus: Array<{
-            sku: string;
-            description: string;
-        }>;
-    }>;
-    /**
-     * Get logs for an app
-     */
-    getLogs(appID: Address): Promise<string>;
-    /**
-     * Get statuses for apps
-     */
-    getStatuses(appIDs: Address[]): Promise<Array<{
-        address: Address;
-        status: string;
-    }>>;
-    /**
-     * Upload app profile information with optional image
-     *
-     * @param appAddress - The app's contract address
-     * @param name - Display name for the app
-     * @param options - Optional fields including website, description, xURL, and image
-     * @param options.image - Image file as Blob or File (browser: from input element, Node.js: new Blob([buffer]))
-     * @param options.imageName - Filename for the image (required if image is provided)
-     */
-    uploadAppProfile(appAddress: Address, name: string, options?: {
-        website?: string;
-        description?: string;
-        xURL?: string;
-        image?: Blob | File;
-        imageName?: string;
-    }): Promise<{
-        name: string;
-        website?: string;
-        description?: string;
-        xURL?: string;
-        imageURL?: string;
-    }>;
-    private makeAuthenticatedRequest;
-    /**
-     * Generate authentication headers for UserAPI requests
-     */
-    private generateAuthHeaders;
-}
-
-/**
- * EIP-7702 transaction handling
- *
- * This module handles EIP-7702 delegation and batch execution.
- */
-
-type Execution = {
-    target: Address;
-    value: bigint;
-    callData: Hex;
-};
-/**
- * Options for estimating batch gas
- */
-interface EstimateBatchGasOptions {
-    publicClient: PublicClient;
-    account: Address;
-    executions: Execution[];
-}
-/**
- * Estimate gas cost for a batch transaction
- *
- * Use this to get cost estimate before prompting user for confirmation.
- */
-declare function estimateBatchGas(options: EstimateBatchGasOptions): Promise<GasEstimate>;
-/**
- * Check if account is delegated to ERC-7702 delegator
- */
-declare function checkERC7702Delegation(publicClient: PublicClient, account: Address, delegatorAddress: Address): Promise<boolean>;
-
-export { type AppInfo as A, type AppMetrics as B, type CreateAppParams as C, type AppInfoResponse as D, estimateBatchGas as E, type EstimateBatchGasOptions as F, type GeneratedKey as G, getBillingEnvironmentConfig as H, checkERC7702Delegation as I, type AppRelease as J, type AppReleaseBuild as K, type LogVisibility as L, type AppResponse as M, validateFilePath as N, assertValidFilePath as O, validateImagePath as P, validateResourceUsageMonitoring as Q, type ResourceUsageMonitoring as R, type DeployParams as S, validateDeployParams as T, UserApiClient as U, type UpgradeParams as V, validateUpgradeParams as W, getAvailableEnvironments as a, getBuildType as b, isMainnet as c, validateImageReference as d, assertValidImageReference as e, extractAppNameFromImage as f, getEnvironmentConfig as g, validateInstanceTypeSKU as h, isEnvironmentAvailable as i, validatePrivateKeyFormat as j, assertValidPrivateKey as k, validateURL as l, validateXURL as m, validateDescription as n, validateAppID as o, validateLogVisibility as p, sanitizeURL as q, sanitizeXURL as r, sanitizeString as s, validateCreateAppParams as t, validateLogsParams as u, validateAppName as v, type LogsParams as w, isSubscriptionActive as x, generateNewPrivateKey as y, type AppProfileInfo as z };