@layr-labs/ecloud-cli 0.0.1-rfc.1 → 0.1.0-dev

package/dist/commands/compute/app/list.js

@@ -0,0 +1,578 @@
+#!/usr/bin/env node
+
+// src/commands/compute/app/list.ts
+import { Command, Flags as Flags2 } from "@oclif/core";
+import {
+  getEnvironmentConfig as getEnvironmentConfig2,
+  getAllAppsByDeveloper as getAllAppsByDeveloper3,
+  getAppLatestReleaseBlockNumbers,
+  getBlockTimestamps,
+  UserApiClient as UserApiClient3
+} from "@layr-labs/ecloud-sdk";
+
+// src/flags.ts
+import { Flags } from "@oclif/core";
+
+// src/utils/prompts.ts
+import { input, select, password, confirm as inquirerConfirm } from "@inquirer/prompts";
+import fs3 from "fs";
+import path3 from "path";
+import os3 from "os";
+import { isAddress as isAddress2 } from "viem";
+import { privateKeyToAccount as privateKeyToAccount2 } from "viem/accounts";
+import {
+  getEnvironmentConfig,
+  getAvailableEnvironments,
+  isEnvironmentAvailable,
+  getAllAppsByDeveloper as getAllAppsByDeveloper2,
+  getCategoryDescriptions,
+  fetchTemplateCatalog,
+  PRIMARY_LANGUAGES,
+  validateAppName,
+  validateImageReference,
+  validateFilePath,
+  validatePrivateKeyFormat,
+  extractAppNameFromImage,
+  UserApiClient as UserApiClient2
+} from "@layr-labs/ecloud-sdk";
+
+// src/utils/appResolver.ts
+import { isAddress } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import {
+  UserApiClient,
+  getAllAppsByDeveloper
+} from "@layr-labs/ecloud-sdk";
+
+// src/utils/globalConfig.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import { load as loadYaml, dump as dumpYaml } from "js-yaml";
+import { getBuildType } from "@layr-labs/ecloud-sdk";
+var GLOBAL_CONFIG_FILE = "config.yaml";
+var PROFILE_CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+function getGlobalConfigDir() {
+  const configHome = process.env.XDG_CONFIG_HOME;
+  let baseDir;
+  if (configHome && path.isAbsolute(configHome)) {
+    baseDir = configHome;
+  } else {
+    baseDir = path.join(os.homedir(), ".config");
+  }
+  const buildType = getBuildType();
+  const buildSuffix = buildType === "dev" ? "-dev" : "";
+  const configDirName = `ecloud${buildSuffix}`;
+  return path.join(baseDir, configDirName);
+}
+function getGlobalConfigPath() {
+  return path.join(getGlobalConfigDir(), GLOBAL_CONFIG_FILE);
+}
+function loadGlobalConfig() {
+  const configPath = getGlobalConfigPath();
+  if (!fs.existsSync(configPath)) {
+    return {
+      first_run: true
+    };
+  }
+  try {
+    const content = fs.readFileSync(configPath, "utf-8");
+    const config = loadYaml(content);
+    return config || { first_run: true };
+  } catch {
+    return {
+      first_run: true
+    };
+  }
+}
+function getDefaultEnvironment() {
+  const config = loadGlobalConfig();
+  return config.default_environment;
+}
+
+// src/utils/appNames.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+import * as os2 from "os";
+import { load as loadYaml2, dump as dumpYaml2 } from "js-yaml";
+var CONFIG_DIR = path2.join(os2.homedir(), ".eigenx");
+var APPS_DIR = path2.join(CONFIG_DIR, "apps");
+var APP_REGISTRY_VERSION = "1.0.0";
+function getAppRegistryPath(environment) {
+  return path2.join(APPS_DIR, `${environment}.yaml`);
+}
+function loadAppRegistry(environment) {
+  const filePath = getAppRegistryPath(environment);
+  if (!fs2.existsSync(filePath)) {
+    return {
+      version: APP_REGISTRY_VERSION,
+      apps: {}
+    };
+  }
+  try {
+    const content = fs2.readFileSync(filePath, "utf-8");
+    const registry = loadYaml2(content);
+    if (!registry.apps) {
+      registry.apps = {};
+    }
+    return registry;
+  } catch {
+    return {
+      version: APP_REGISTRY_VERSION,
+      apps: {}
+    };
+  }
+}
+function getAppName(environment, appID) {
+  const registry = loadAppRegistry(environment);
+  const normalizedAppID = appID.toLowerCase();
+  for (const [name, app] of Object.entries(registry.apps)) {
+    if (app?.app_id && String(app.app_id).toLowerCase() === normalizedAppID) {
+      return name;
+    }
+  }
+  return "";
+}
+
+// src/utils/version.ts
+function getCliVersion() {
+  return true ? "0.1.0-dev" : "0.0.0";
+}
+function getClientId() {
+  return `ecloud-cli/v${getCliVersion()}`;
+}
+
+// src/utils/appResolver.ts
+var CHUNK_SIZE = 10;
+async function getAppInfosChunked(userApiClient, appIds, addressCount) {
+  if (appIds.length === 0) {
+    return [];
+  }
+  const chunks = [];
+  for (let i = 0; i < appIds.length; i += CHUNK_SIZE) {
+    chunks.push(appIds.slice(i, i + CHUNK_SIZE));
+  }
+  const chunkResults = await Promise.all(
+    chunks.map((chunk) => userApiClient.getInfos(chunk, addressCount))
+  );
+  return chunkResults.flat();
+}
+
+// src/utils/prompts.ts
+var ContractAppStatusStarted = 1;
+var ContractAppStatusStopped = 2;
+var ContractAppStatusTerminated = 3;
+var ContractAppStatusSuspended = 4;
+function getContractStatusString(status) {
+  switch (status) {
+    case ContractAppStatusStarted:
+      return "Started";
+    case ContractAppStatusStopped:
+      return "Stopped";
+    case ContractAppStatusTerminated:
+      return "Terminated";
+    case ContractAppStatusSuspended:
+      return "Suspended";
+    default:
+      return "Unknown";
+  }
+}
+function getStatusSortPriority(status) {
+  switch (status.toLowerCase()) {
+    case "running":
+    case "started":
+      return 0;
+    // Running apps first
+    case "deploying":
+    case "upgrading":
+    case "resuming":
+      return 1;
+    // In-progress operations second
+    case "stopped":
+    case "stopping":
+      return 2;
+    // Stopped third
+    case "suspended":
+      return 3;
+    // Suspended fourth
+    case "failed":
+      return 4;
+    // Failed fifth
+    case "terminated":
+      return 5;
+    // Terminated last
+    default:
+      return 6;
+  }
+}
+async function getPrivateKeyInteractive(privateKey) {
+  if (privateKey) {
+    if (!validatePrivateKeyFormat(privateKey)) {
+      throw new Error("Invalid private key format");
+    }
+    return privateKey;
+  }
+  const { getPrivateKeyWithSource } = await import("@layr-labs/ecloud-sdk");
+  const result = await getPrivateKeyWithSource({ privateKey: void 0 });
+  if (result) {
+    return result.key;
+  }
+  const key = await password({
+    message: "Enter private key:",
+    mask: true,
+    validate: (value) => {
+      if (!value.trim()) {
+        return "Private key is required";
+      }
+      if (!validatePrivateKeyFormat(value)) {
+        return "Invalid private key format (must be 64 hex characters, optionally prefixed with 0x)";
+      }
+      return true;
+    }
+  });
+  return key.trim();
+}
+async function getEnvironmentInteractive(environment) {
+  if (environment) {
+    try {
+      getEnvironmentConfig(environment);
+      if (!isEnvironmentAvailable(environment)) {
+        throw new Error(`Environment ${environment} is not available in this build`);
+      }
+      return environment;
+    } catch {
+    }
+  }
+  const availableEnvs = getAvailableEnvironments();
+  let defaultEnv;
+  const configDefaultEnv = getDefaultEnvironment();
+  if (configDefaultEnv && availableEnvs.includes(configDefaultEnv)) {
+    try {
+      getEnvironmentConfig(configDefaultEnv);
+      defaultEnv = configDefaultEnv;
+    } catch {
+    }
+  }
+  const choices = [];
+  if (availableEnvs.includes("sepolia")) {
+    choices.push({ name: "sepolia - Ethereum Sepolia testnet", value: "sepolia" });
+  }
+  if (availableEnvs.includes("sepolia-dev")) {
+    choices.push({ name: "sepolia-dev - Ethereum Sepolia testnet (dev)", value: "sepolia-dev" });
+  }
+  if (availableEnvs.includes("mainnet-alpha")) {
+    choices.push({
+      name: "mainnet-alpha - Ethereum mainnet (\u26A0\uFE0F  uses real funds)",
+      value: "mainnet-alpha"
+    });
+  }
+  if (choices.length === 0) {
+    throw new Error("No environments available in this build");
+  }
+  const env = await select({
+    message: "Select environment:",
+    choices,
+    default: defaultEnv
+  });
+  return env;
+}
+var MAX_IMAGE_SIZE = 4 * 1024 * 1024;
+
+// src/flags.ts
+var commonFlags = {
+  environment: Flags.string({
+    required: false,
+    description: "Deployment environment to use",
+    env: "ECLOUD_ENV"
+  }),
+  "private-key": Flags.string({
+    required: false,
+    description: "Private key for signing transactions",
+    env: "ECLOUD_PRIVATE_KEY"
+  }),
+  "rpc-url": Flags.string({
+    required: false,
+    description: "RPC URL to connect to blockchain",
+    env: "ECLOUD_RPC_URL"
+  }),
+  verbose: Flags.boolean({
+    required: false,
+    description: "Enable verbose logging (default: false)",
+    default: false
+  })
+};
+async function validateCommonFlags(flags) {
+  if (!flags["environment"]) {
+    flags["environment"] = getDefaultEnvironment();
+  }
+  flags["environment"] = await getEnvironmentInteractive(flags["environment"]);
+  flags["private-key"] = await getPrivateKeyInteractive(flags["private-key"]);
+  return flags;
+}
+
+// src/commands/compute/app/list.ts
+import { privateKeyToAccount as privateKeyToAccount3 } from "viem/accounts";
+
+// src/utils/format.ts
+import chalk from "chalk";
+function formatBytes(bytes) {
+  if (bytes === 0) return "0 B";
+  const k = 1024;
+  const sizes = ["B", "KB", "MB", "GB", "TB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${(bytes / Math.pow(k, i)).toFixed(1)} ${sizes[i]}`;
+}
+function formatStatus(status) {
+  switch (status.toLowerCase()) {
+    case "running":
+    case "started":
+      return chalk.green(status);
+    case "stopped":
+      return chalk.yellow(status);
+    case "terminated":
+      return chalk.red(status);
+    case "suspended":
+      return chalk.red(status);
+    case "deploying":
+    case "upgrading":
+    case "resuming":
+    case "stopping":
+      return chalk.cyan(status);
+    case "failed":
+      return chalk.red(status);
+    default:
+      return chalk.gray(status);
+  }
+}
+function formatAppDisplay(options) {
+  const { appInfo, appName, status, releaseTimestamp, showProfileDetails = false } = options;
+  const displayName = appName || appInfo.profile?.name;
+  const name = displayName ? chalk.cyan(displayName) : chalk.gray("(unnamed)");
+  const id = chalk.gray(appInfo.address);
+  const releaseTime = releaseTimestamp ? chalk.gray(new Date(releaseTimestamp * 1e3).toISOString().replace("T", " ").slice(0, 19)) : chalk.gray("-");
+  const statusStr = status || appInfo.status;
+  const formattedStatus = formatStatus(statusStr);
+  const instance = appInfo.machineType && appInfo.machineType !== "No instance assigned" ? chalk.gray(appInfo.machineType) : chalk.gray("-");
+  const ip = appInfo.ip && appInfo.ip !== "No IP assigned" ? chalk.white(appInfo.ip) : chalk.gray("No IP assigned");
+  const metrics = appInfo.metrics;
+  const cpu = metrics?.cpu_utilization_percent !== void 0 ? chalk.white(`${metrics.cpu_utilization_percent.toFixed(1)}%`) : chalk.gray("-");
+  const memory = metrics?.memory_utilization_percent !== void 0 ? chalk.white(`${metrics.memory_utilization_percent.toFixed(1)}%`) : chalk.gray("-");
+  const memoryUsage = metrics?.memory_used_bytes !== void 0 && metrics?.memory_total_bytes !== void 0 ? chalk.gray(
+    `(${formatBytes(metrics.memory_used_bytes)} / ${formatBytes(metrics.memory_total_bytes)})`
+  ) : "";
+  const evmAddresses = (appInfo.evmAddresses || []).map((addr) => ({
+    address: addr.address,
+    path: addr.derivationPath
+  }));
+  const solanaAddresses = (appInfo.solanaAddresses || []).map((addr) => ({
+    address: addr.address,
+    path: addr.derivationPath
+  }));
+  let profile;
+  if (showProfileDetails && appInfo.profile) {
+    const p = appInfo.profile;
+    if (p.website || p.description || p.xURL) {
+      profile = {
+        website: p.website,
+        description: p.description,
+        xURL: p.xURL
+      };
+    }
+  }
+  return {
+    name,
+    id,
+    releaseTime,
+    status: formattedStatus,
+    instance,
+    ip,
+    cpu,
+    memory,
+    memoryUsage,
+    evmAddresses,
+    solanaAddresses,
+    profile
+  };
+}
+function printAppDisplay(display, log, indent = "  ", options = {}) {
+  const { singleAddress = false, showProfile = false } = options;
+  log(`${indent}ID:             ${display.id}`);
+  log(`${indent}Release Time:   ${display.releaseTime}`);
+  log(`${indent}Status:         ${display.status}`);
+  log(`${indent}Instance:       ${display.instance}`);
+  log(`${indent}IP:             ${display.ip}`);
+  log(`${indent}CPU:            ${display.cpu}`);
+  log(`${indent}Memory:         ${display.memory} ${display.memoryUsage}`);
+  if (display.evmAddresses.length > 0) {
+    const addrs = singleAddress ? display.evmAddresses.slice(0, 1) : display.evmAddresses;
+    for (let i = 0; i < addrs.length; i++) {
+      const addr = addrs[i];
+      const label = i === 0 ? "EVM Address:" : "            ";
+      log(`${indent}${label}    ${chalk.gray(`${addr.address} (path: ${addr.path})`)}`);
+    }
+  } else {
+    log(`${indent}EVM Address:    ${chalk.gray("-")}`);
+  }
+  if (display.solanaAddresses.length > 0) {
+    const addrs = singleAddress ? display.solanaAddresses.slice(0, 1) : display.solanaAddresses;
+    for (let i = 0; i < addrs.length; i++) {
+      const addr = addrs[i];
+      const label = i === 0 ? "Solana Address:" : "               ";
+      log(`${indent}${label} ${chalk.gray(`${addr.address} (path: ${addr.path})`)}`);
+    }
+  } else {
+    log(`${indent}Solana Address: ${chalk.gray("-")}`);
+  }
+  if (showProfile && display.profile) {
+    log(
+      chalk.gray(`${indent}\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`)
+    );
+    if (display.profile.website) {
+      log(`${indent}Website:        ${chalk.gray(display.profile.website)}`);
+    }
+    if (display.profile.description) {
+      log(`${indent}Description:    ${chalk.gray(display.profile.description)}`);
+    }
+    if (display.profile.xURL) {
+      log(`${indent}X (Twitter):    ${chalk.gray(display.profile.xURL)}`);
+    }
+  }
+}
+
+// src/commands/compute/app/list.ts
+import chalk2 from "chalk";
+var AppList = class _AppList extends Command {
+  static description = "List all deployed apps";
+  static flags = {
+    ...commonFlags,
+    all: Flags2.boolean({
+      description: "Show all apps including terminated ones",
+      char: "a",
+      default: false
+    }),
+    "address-count": Flags2.integer({
+      description: "Number of addresses to fetch",
+      default: 1
+    })
+  };
+  async run() {
+    const { flags } = await this.parse(_AppList);
+    const validatedFlags = await validateCommonFlags(flags);
+    const environment = validatedFlags.environment || "sepolia";
+    const environmentConfig = getEnvironmentConfig2(environment);
+    const rpcUrl = validatedFlags["rpc-url"] || environmentConfig.defaultRPCURL;
+    const privateKey = validatedFlags["private-key"];
+    const account = privateKeyToAccount3(privateKey);
+    const developerAddr = account.address;
+    if (flags.verbose) {
+      this.log(`Fetching apps for developer: ${developerAddr}`);
+    }
+    const result = await getAllAppsByDeveloper3(rpcUrl, environmentConfig, developerAddr);
+    if (result.apps.length === 0) {
+      this.log(`
+No apps found for developer ${developerAddr}`);
+      return;
+    }
+    const filteredApps = [];
+    const filteredConfigs = [];
+    for (let i = 0; i < result.apps.length; i++) {
+      const config = result.appConfigs[i];
+      if (!flags.all && config.status === ContractAppStatusTerminated) {
+        continue;
+      }
+      filteredApps.push(result.apps[i]);
+      filteredConfigs.push(config);
+    }
+    if (filteredApps.length === 0) {
+      if (flags.all) {
+        this.log(`
+No apps found for developer ${developerAddr}`);
+      } else {
+        this.log(
+          `
+No active apps found for developer ${developerAddr} (use --all to show terminated apps)`
+        );
+      }
+      return;
+    }
+    const userApiClient = new UserApiClient3(environmentConfig, privateKey, rpcUrl, getClientId());
+    const addressCount = flags["address-count"];
+    const [appInfos, releaseBlockNumbers] = await Promise.all([
+      getAppInfosChunked(userApiClient, filteredApps, addressCount).catch((err) => {
+        if (flags.verbose) {
+          this.warn(`Could not fetch app info from UserAPI: ${err}`);
+        }
+        return [];
+      }),
+      getAppLatestReleaseBlockNumbers(rpcUrl, environmentConfig, filteredApps).catch((err) => {
+        if (flags.verbose) {
+          this.warn(`Could not fetch release block numbers: ${err}`);
+        }
+        return /* @__PURE__ */ new Map();
+      })
+    ]);
+    const blockNumbers = Array.from(releaseBlockNumbers.values()).filter((n) => n > 0);
+    const blockTimestamps = blockNumbers.length > 0 ? await getBlockTimestamps(rpcUrl, environmentConfig, blockNumbers).catch((err) => {
+      if (flags.verbose) {
+        this.warn(`Could not fetch block timestamps: ${err}`);
+      }
+      return /* @__PURE__ */ new Map();
+    }) : /* @__PURE__ */ new Map();
+    const appItems = [];
+    for (let i = 0; i < filteredApps.length; i++) {
+      const appAddr = filteredApps[i];
+      const config = filteredConfigs[i];
+      const apiInfo = appInfos.find(
+        (info) => info.address && String(info.address).toLowerCase() === appAddr.toLowerCase()
+      );
+      const profileName = apiInfo?.profile?.name;
+      const localName = getAppName(environment, appAddr);
+      const appName = profileName || localName;
+      const status = apiInfo?.status || getContractStatusString(config.status);
+      const releaseBlockNumber = releaseBlockNumbers.get(appAddr);
+      const releaseTimestamp = releaseBlockNumber ? blockTimestamps.get(releaseBlockNumber) : void 0;
+      appItems.push({ appAddr, apiInfo, appName, status, releaseTimestamp });
+    }
+    appItems.sort((a, b) => {
+      const aPriority = getStatusSortPriority(a.status);
+      const bPriority = getStatusSortPriority(b.status);
+      if (aPriority !== bPriority) {
+        return aPriority - bPriority;
+      }
+      const aTime = a.releaseTimestamp || 0;
+      const bTime = b.releaseTimestamp || 0;
+      return bTime - aTime;
+    });
+    console.log();
+    this.log(chalk2.bold(`Apps for ${developerAddr} (${environment}):`));
+    console.log();
+    for (let i = 0; i < appItems.length; i++) {
+      const { apiInfo, appName, status, releaseTimestamp } = appItems[i];
+      if (!apiInfo) {
+        continue;
+      }
+      const display = formatAppDisplay({
+        appInfo: apiInfo,
+        appName,
+        status,
+        releaseTimestamp
+      });
+      this.log(`  ${display.name}`);
+      printAppDisplay(display, this.log.bind(this), "    ", {
+        singleAddress: addressCount === 1,
+        showProfile: false
+      });
+      if (i < appItems.length - 1) {
+        this.log(
+          chalk2.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500")
+        );
+      }
+    }
+    console.log();
+    this.log(chalk2.gray(`Total: ${appItems.length} app(s)`));
+  }
+};
+export {
+  AppList as default
+};
+//# sourceMappingURL=list.js.map