@alchemy/cli 0.6.1 → 0.6.3-alpha.6

package/dist/{chunk-56ZVYB4G.js → chunk-QEDAULQ2.js}

@@ -12,203 +12,48 @@ var esc = (code) => (s) => noColor ? s : `\x1B[${code}m${s}\x1B[0m`;
 var rgb = (r, g, b) => (s) => noColor ? s : `\x1B[38;2;${r};${g};${b}m${s}\x1B[39m`;
 var bgRgb = (r, g, b) => (s) => noColor ? s : `\x1B[48;2;${r};${g};${b}m${s}\x1B[49m`;
 
-// src/lib/errors.ts
-var ErrorCode = {
-  AUTH_REQUIRED: "AUTH_REQUIRED",
-  INVALID_API_KEY: "INVALID_API_KEY",
-  NETWORK_NOT_ENABLED: "NETWORK_NOT_ENABLED",
-  INVALID_ACCESS_KEY: "INVALID_ACCESS_KEY",
-  ACCESS_KEY_REQUIRED: "ACCESS_KEY_REQUIRED",
-  APP_REQUIRED: "APP_REQUIRED",
-  ADMIN_API_ERROR: "ADMIN_API_ERROR",
-  NETWORK_ERROR: "NETWORK_ERROR",
-  RPC_ERROR: "RPC_ERROR",
-  INVALID_ARGS: "INVALID_ARGS",
-  NOT_FOUND: "NOT_FOUND",
-  RATE_LIMITED: "RATE_LIMITED",
-  PAYMENT_REQUIRED: "PAYMENT_REQUIRED",
-  SETUP_REQUIRED: "SETUP_REQUIRED",
-  INTERNAL_ERROR: "INTERNAL_ERROR"
-};
-var RETRYABLE_CODES = /* @__PURE__ */ new Set([
-  ErrorCode.RATE_LIMITED,
-  ErrorCode.NETWORK_ERROR
-]);
-var EXIT_CODES = {
-  AUTH_REQUIRED: 3,
-  INVALID_API_KEY: 3,
-  NETWORK_NOT_ENABLED: 3,
-  INVALID_ACCESS_KEY: 3,
-  ACCESS_KEY_REQUIRED: 3,
-  APP_REQUIRED: 3,
-  INVALID_ARGS: 2,
-  NOT_FOUND: 4,
-  RATE_LIMITED: 5,
-  NETWORK_ERROR: 6,
-  RPC_ERROR: 7,
-  ADMIN_API_ERROR: 8,
-  PAYMENT_REQUIRED: 9,
-  SETUP_REQUIRED: 3,
-  INTERNAL_ERROR: 1
-};
-var CLIError = class extends Error {
-  code;
-  hint;
-  details;
-  data;
-  constructor(code, message, hint, details, data) {
-    super(message);
-    this.name = "CLIError";
-    this.code = code;
-    this.hint = hint;
-    this.details = details;
-    this.data = data;
-  }
-  toJSON() {
-    return {
-      error: {
-        code: this.code,
-        message: this.message,
-        ...this.hint && { hint: this.hint },
-        ...this.details && { details: this.details },
-        ...this.data !== void 0 && { data: this.data },
-        retryable: RETRYABLE_CODES.has(this.code)
-      }
-    };
-  }
-  format() {
-    let out = `${this.code}: ${this.message}`;
-    if (this.hint) out += `
-Hint: ${this.hint}`;
-    return out;
-  }
-};
-function errAuthRequired() {
-  return new CLIError(
-    ErrorCode.AUTH_REQUIRED,
-    "Not authenticated. Run 'alchemy auth' to log in, or set ALCHEMY_API_KEY.",
-    "alchemy auth"
-  );
-}
-function errAccessKeyRequired() {
-  return new CLIError(
-    ErrorCode.ACCESS_KEY_REQUIRED,
-    "Access key required. Set ALCHEMY_ACCESS_KEY or run 'alchemy config set access-key <key>'.",
-    "Get an access key: https://www.alchemy.com/docs/reference/admin-api/overview"
-  );
-}
-function errInvalidAPIKey(details) {
-  return new CLIError(
-    ErrorCode.INVALID_API_KEY,
-    "Invalid API key. Check your key and try again.",
-    "alchemy config set api-key <your-key>",
-    details
-  );
-}
-function errNetworkNotEnabled(network, details) {
-  const networkLabel = network.toLowerCase().replace(/_/g, "-");
-  return new CLIError(
-    ErrorCode.NETWORK_NOT_ENABLED,
-    `API key is valid, but ${networkLabel} is not enabled for this app.`,
-    void 0,
-    details
-  );
-}
-function errNetwork(detail) {
-  return new CLIError(
-    ErrorCode.NETWORK_ERROR,
-    `Network error: ${detail}`,
-    "Check your internet connection and try again."
-  );
-}
-var RPC_ERROR_HINTS = {
-  [-32700]: "Parse error. The request JSON is malformed.",
-  [-32600]: "Invalid request. Check the JSON-RPC request format.",
-  [-32601]: "Method not supported. Check the method name and ensure your plan supports it.",
-  [-32602]: "Invalid parameters. Check argument types and format.",
-  [-32603]: "Internal JSON-RPC error."
-};
-function errRPC(code, message) {
-  const hint = RPC_ERROR_HINTS[code];
-  return new CLIError(ErrorCode.RPC_ERROR, `RPC error ${code}: ${message}`, hint);
-}
-function errInvalidArgs(detail) {
-  return new CLIError(ErrorCode.INVALID_ARGS, detail);
-}
-function errNotFound(resource) {
-  return new CLIError(ErrorCode.NOT_FOUND, `Not found: ${resource}`);
-}
-function errRateLimited() {
-  return new CLIError(
-    ErrorCode.RATE_LIMITED,
-    "Rate limited. Please wait and try again.",
-    "Consider upgrading your Alchemy plan for higher rate limits."
-  );
-}
-function errInvalidAccessKey() {
-  return new CLIError(
-    ErrorCode.INVALID_ACCESS_KEY,
-    "Invalid access key. Check your key and try again.",
-    "Get an access key: https://www.alchemy.com/docs/reference/admin-api/overview"
-  );
-}
-function errAccessDenied(detail) {
-  const message = detail ? `Access denied: ${detail}` : "Access denied. Your access key may not have permission for this operation.";
-  return new CLIError(
-    ErrorCode.INVALID_ACCESS_KEY,
-    message,
-    "Check your account tier and feature access at https://dashboard.alchemy.com/"
-  );
-}
-function errAppRequired() {
-  return new CLIError(
-    ErrorCode.APP_REQUIRED,
-    "No app selected. Set an app to resolve the API key automatically.",
-    "alchemy config set app <app-id>"
-  );
+// src/lib/output.ts
+var forceJSON = false;
+var quiet = false;
+var verbose = false;
+var debugMode = false;
+var timeout;
+var reveal = false;
+function setFlags(opts) {
+  forceJSON = opts.json ?? false;
+  quiet = opts.quiet ?? false;
+  verbose = opts.verbose ?? false;
+  debugMode = opts.debug ?? false;
+  reveal = opts.reveal ?? false;
+  timeout = opts.timeout;
 }
-function errWalletKeyRequired() {
-  return new CLIError(
-    ErrorCode.AUTH_REQUIRED,
-    "Wallet key required for x402. Set ALCHEMY_WALLET_KEY, run 'alchemy wallet generate', or use --wallet-key-file.",
-    "alchemy wallet generate"
-  );
+function isRevealMode() {
+  return reveal;
 }
-function errAdminAPI(status, message) {
-  return new CLIError(
-    ErrorCode.ADMIN_API_ERROR,
-    `Admin API error (HTTP ${status}): ${message}`
-  );
+function isJSONMode() {
+  if (forceJSON) return true;
+  return !process.stdout.isTTY;
 }
-function errSetupRequired(data) {
-  return new CLIError(
-    ErrorCode.SETUP_REQUIRED,
-    "Setup required before running in non-interactive mode.",
-    "Run 'alchemy' in a TTY for guided onboarding, or run 'alchemy setup status --json' for machine-readable remediation steps.",
-    void 0,
-    data
-  );
+function printJSON(value) {
+  console.log(JSON.stringify(value, null, 2));
 }
-var replMode = false;
-function setReplMode(enabled) {
-  replMode = enabled;
+function printHuman(humanText, jsonValue) {
+  if (isJSONMode()) {
+    printJSON(jsonValue);
+  } else {
+    process.stdout.write(humanText);
+  }
 }
-function exitWithError(err) {
-  const cliErr = err instanceof CLIError ? err : new CLIError(
-    ErrorCode.INTERNAL_ERROR,
-    err instanceof Error ? err.message : String(err)
-  );
-  printError(cliErr);
-  if (replMode) {
-    throw cliErr;
+function debug(message, ...args) {
+  if (debugMode) {
+    console.error(`[debug] ${message}`, ...args);
   }
-  process.exit(EXIT_CODES[cliErr.code]);
 }
 
 // src/lib/client-utils.ts
 var DEFAULT_BASE_DOMAIN = "alchemy.com";
 function getBaseDomain() {
-  if (process.env.ALCHEMY_UNSAFE_OVERRIDES === "1" && process.env.ALCHEMY_BASE_DOMAIN) {
+  if (process.env.ALCHEMY_BASE_DOMAIN) {
     return process.env.ALCHEMY_BASE_DOMAIN;
   }
   return DEFAULT_BASE_DOMAIN;
@@ -216,7 +61,7 @@ function getBaseDomain() {
 function isLocalhost(hostname) {
   return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1";
 }
-function parseBaseURLOverride(envVarName) {
+function parseBaseURLOverride(envVarName, options = {}) {
   const raw = process.env[envVarName];
   if (!raw) return null;
   let parsed;
@@ -225,9 +70,12 @@ function parseBaseURLOverride(envVarName) {
   } catch {
     throw errInvalidArgs(`Invalid ${envVarName} value.`);
   }
-  if (!isLocalhost(parsed.hostname)) {
+  const allowedHostnames = options.allowedHostnames ?? [];
+  const isAllowedHost = allowedHostnames.includes(parsed.hostname);
+  if (!isLocalhost(parsed.hostname) && !isAllowedHost) {
+    const targetDescription = allowedHostnames.length > 0 ? `localhost or one of: ${allowedHostnames.join(", ")}` : "localhost or 127.0.0.1";
     throw errInvalidArgs(
-      `${envVarName} must target localhost or 127.0.0.1.`
+      `${envVarName} must target ${targetDescription}.`
     );
   }
   if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
@@ -270,7 +118,7 @@ async function fetchWithTimeout(url, init) {
         const networkSlug = hostname.replace(new RegExp(`\\.g\\.${escapeRegExp(getBaseDomain())}$`), "");
         if (networkSlug !== hostname) {
           throw errInvalidArgs(
-            `Unknown network '${networkSlug}'. Run 'alchemy network list' to see available networks.`
+            `Unknown network '${networkSlug}'. Run 'alchemy evm network list' to see available networks.`
           );
         }
       } catch (innerErr) {
@@ -352,10 +200,15 @@ function toSafeErrorJSON(err) {
 }
 function wrapWithPrefix(text, prefix, width) {
   const safeWidth = Math.max(20, width - prefix.length);
+  const continuation = " ".repeat(prefix.length);
   const words = text.trim().split(/\s+/);
   if (words.length === 0 || words.length === 1 && words[0] === "") return [prefix];
   const lines = [];
   let current = "";
+  const flush = () => {
+    const linePrefix = lines.length === 0 ? prefix : continuation;
+    lines.push(`${linePrefix}${current}`);
+  };
   for (const word of words) {
     if (current.length === 0) {
       current = word;
@@ -364,12 +217,12 @@ function wrapWithPrefix(text, prefix, width) {
     if (current.length + 1 + word.length <= safeWidth) {
       current += ` ${word}`;
     } else {
-      lines.push(`${prefix}${current}`);
+      flush();
       current = word;
     }
   }
   if (current.length > 0) {
-    lines.push(`${prefix}${current}`);
+    flush();
   }
   return lines;
 }
@@ -454,42 +307,226 @@ ${styled.join("\n")}
 `;
 }
 
-// src/lib/output.ts
-var forceJSON = false;
-var quiet = false;
-var verbose = false;
-var debugMode = false;
-var timeout;
-var reveal = false;
-function setFlags(opts) {
-  forceJSON = opts.json ?? false;
-  quiet = opts.quiet ?? false;
-  verbose = opts.verbose ?? false;
-  debugMode = opts.debug ?? false;
-  reveal = opts.reveal ?? false;
-  timeout = opts.timeout;
+// src/lib/errors.ts
+var ErrorCode = {
+  AUTH_REQUIRED: "AUTH_REQUIRED",
+  INVALID_API_KEY: "INVALID_API_KEY",
+  NETWORK_NOT_ENABLED: "NETWORK_NOT_ENABLED",
+  INVALID_ACCESS_KEY: "INVALID_ACCESS_KEY",
+  ACCESS_KEY_REQUIRED: "ACCESS_KEY_REQUIRED",
+  APP_REQUIRED: "APP_REQUIRED",
+  ADMIN_API_ERROR: "ADMIN_API_ERROR",
+  NETWORK_ERROR: "NETWORK_ERROR",
+  RPC_ERROR: "RPC_ERROR",
+  INVALID_ARGS: "INVALID_ARGS",
+  NOT_FOUND: "NOT_FOUND",
+  RATE_LIMITED: "RATE_LIMITED",
+  PAYMENT_REQUIRED: "PAYMENT_REQUIRED",
+  SETUP_REQUIRED: "SETUP_REQUIRED",
+  INTERNAL_ERROR: "INTERNAL_ERROR"
+};
+var RETRYABLE_CODES = /* @__PURE__ */ new Set([
+  ErrorCode.RATE_LIMITED,
+  ErrorCode.NETWORK_ERROR
+]);
+var EXIT_CODES = {
+  AUTH_REQUIRED: 3,
+  INVALID_API_KEY: 3,
+  NETWORK_NOT_ENABLED: 3,
+  INVALID_ACCESS_KEY: 3,
+  ACCESS_KEY_REQUIRED: 3,
+  APP_REQUIRED: 3,
+  INVALID_ARGS: 2,
+  NOT_FOUND: 4,
+  RATE_LIMITED: 5,
+  NETWORK_ERROR: 6,
+  RPC_ERROR: 7,
+  ADMIN_API_ERROR: 8,
+  PAYMENT_REQUIRED: 9,
+  SETUP_REQUIRED: 3,
+  INTERNAL_ERROR: 1
+};
+var CLIError = class extends Error {
+  code;
+  hint;
+  details;
+  data;
+  constructor(code, message, hint, details, data) {
+    super(message);
+    this.name = "CLIError";
+    this.code = code;
+    this.hint = hint;
+    this.details = details;
+    this.data = data;
+  }
+  toJSON() {
+    return {
+      error: {
+        code: this.code,
+        message: this.message,
+        ...this.hint && { hint: this.hint },
+        ...this.details && { details: this.details },
+        ...this.data !== void 0 && { data: this.data },
+        retryable: RETRYABLE_CODES.has(this.code)
+      }
+    };
+  }
+  format() {
+    let out = `${this.code}: ${this.message}`;
+    if (this.hint) out += `
+Hint: ${this.hint}`;
+    return out;
+  }
+};
+function errAuthRequired() {
+  return new CLIError(
+    ErrorCode.AUTH_REQUIRED,
+    "Not authenticated. Run 'alchemy auth' to log in, or set ALCHEMY_API_KEY.",
+    "alchemy auth"
+  );
 }
-function isRevealMode() {
-  return reveal;
+function errAccessKeyRequired() {
+  return new CLIError(
+    ErrorCode.ACCESS_KEY_REQUIRED,
+    "Access key required. Set ALCHEMY_ACCESS_KEY or run 'alchemy config set access-key <key>'.",
+    "Get an access key: https://www.alchemy.com/docs/reference/admin-api/overview"
+  );
 }
-function isJSONMode() {
-  if (forceJSON) return true;
-  return !process.stdout.isTTY;
+function errInvalidAPIKey(details) {
+  return new CLIError(
+    ErrorCode.INVALID_API_KEY,
+    "Invalid API key. Check your key and try again.",
+    "alchemy config set app",
+    details
+  );
 }
-function printJSON(value) {
-  console.log(JSON.stringify(value, null, 2));
+function errNetworkNotEnabled(network, details) {
+  const networkLabel = network.toLowerCase().replace(/_/g, "-");
+  return new CLIError(
+    ErrorCode.NETWORK_NOT_ENABLED,
+    `API key is valid, but ${networkLabel} is not enabled for this app.`,
+    void 0,
+    details
+  );
 }
-function printHuman(humanText, jsonValue) {
-  if (isJSONMode()) {
-    printJSON(jsonValue);
-  } else {
-    process.stdout.write(humanText);
-  }
+function errNetwork(detail) {
+  return new CLIError(
+    ErrorCode.NETWORK_ERROR,
+    `Network error: ${detail}`,
+    "Check your internet connection and try again."
+  );
 }
-function debug(message, ...args) {
-  if (debugMode) {
-    console.error(`[debug] ${message}`, ...args);
+var RPC_ERROR_HINTS = {
+  [-32700]: "Parse error. The request JSON is malformed.",
+  [-32600]: "Invalid request. Check the JSON-RPC request format.",
+  [-32601]: "Method not supported. Check the method name and ensure your plan supports it.",
+  [-32602]: "Invalid parameters. Check argument types and format.",
+  [-32603]: "Internal JSON-RPC error."
+};
+function errRPC(code, message) {
+  const hint = RPC_ERROR_HINTS[code];
+  return new CLIError(ErrorCode.RPC_ERROR, `RPC error ${code}: ${message}`, hint);
+}
+function errInvalidArgs(detail) {
+  return new CLIError(ErrorCode.INVALID_ARGS, detail);
+}
+function errNotFound(resource) {
+  return new CLIError(ErrorCode.NOT_FOUND, `Not found: ${resource}`);
+}
+function errRateLimited() {
+  return new CLIError(
+    ErrorCode.RATE_LIMITED,
+    "Rate limited. Please wait and try again.",
+    "Consider upgrading your Alchemy plan for higher rate limits."
+  );
+}
+function errInvalidAccessKey() {
+  return new CLIError(
+    ErrorCode.INVALID_ACCESS_KEY,
+    "Invalid access key. Check your key and try again.",
+    "Get an access key: https://www.alchemy.com/docs/reference/admin-api/overview"
+  );
+}
+function errAccessDenied(detail) {
+  const message = detail ? `Access denied: ${detail}` : "Access denied. Your access key may not have permission for this operation.";
+  return new CLIError(
+    ErrorCode.INVALID_ACCESS_KEY,
+    message,
+    "Check your account tier and feature access at https://dashboard.alchemy.com/"
+  );
+}
+function errAppRequired() {
+  return new CLIError(
+    ErrorCode.APP_REQUIRED,
+    "No app selected. Set an app to resolve the API key automatically.",
+    "alchemy config set app <app-id>"
+  );
+}
+function errWalletKeyRequired() {
+  return new CLIError(
+    ErrorCode.AUTH_REQUIRED,
+    "Wallet key required for x402. Set ALCHEMY_WALLET_KEY, run 'alchemy wallet connect --mode local --chain evm', or use --wallet-key-file.",
+    "alchemy wallet connect --mode local --chain evm"
+  );
+}
+function errSessionExpired() {
+  return new CLIError(
+    ErrorCode.AUTH_REQUIRED,
+    "Your wallet session has expired or been revoked.",
+    "alchemy wallet connect --force"
+  );
+}
+function errNoActiveSession() {
+  return new CLIError(
+    ErrorCode.AUTH_REQUIRED,
+    "No active wallet session. Session signing was requested but no session is connected.",
+    "alchemy wallet connect"
+  );
+}
+function errSolanaWalletKeyRequired() {
+  return new CLIError(
+    ErrorCode.AUTH_REQUIRED,
+    "Solana wallet key required. Set ALCHEMY_SOLANA_WALLET_KEY, run 'alchemy wallet connect --mode local --chain solana', or use --solana-wallet-key-file.",
+    "alchemy wallet connect --mode local --chain solana"
+  );
+}
+function errSolanaTransactionFailed(details) {
+  return new CLIError(
+    ErrorCode.RPC_ERROR,
+    "Solana transaction failed.",
+    void 0,
+    details
+  );
+}
+function errAdminAPI(status, message) {
+  return new CLIError(
+    ErrorCode.ADMIN_API_ERROR,
+    `Admin API error (HTTP ${status}): ${message}`
+  );
+}
+function errSetupRequired(data) {
+  return new CLIError(
+    ErrorCode.SETUP_REQUIRED,
+    "Setup required before running in non-interactive mode.",
+    "Run 'alchemy' in a TTY for guided onboarding, or run 'alchemy config status --json' for machine-readable remediation steps.",
+    void 0,
+    data
+  );
+}
+var replMode = false;
+function setReplMode(enabled) {
+  replMode = enabled;
+}
+function exitWithError(err) {
+  const cliErr = err instanceof CLIError ? err : new CLIError(
+    ErrorCode.INTERNAL_ERROR,
+    err instanceof Error ? err.message : String(err)
+  );
+  printError(cliErr);
+  if (replMode) {
+    throw cliErr;
   }
+  process.exit(EXIT_CODES[cliErr.code]);
 }
 
 export {
@@ -529,6 +566,10 @@ export {
   errAccessDenied,
   errAppRequired,
   errWalletKeyRequired,
+  errSessionExpired,
+  errNoActiveSession,
+  errSolanaWalletKeyRequired,
+  errSolanaTransactionFailed,
   errAdminAPI,
   errSetupRequired,
   setReplMode,

package/dist/errors-3CNFGAXT.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
+import {
+  CLIError,
+  EXIT_CODES,
+  ErrorCode,
+  errAccessDenied,
+  errAccessKeyRequired,
+  errAdminAPI,
+  errAppRequired,
+  errAuthRequired,
+  errInvalidAPIKey,
+  errInvalidAccessKey,
+  errInvalidArgs,
+  errNetwork,
+  errNetworkNotEnabled,
+  errNoActiveSession,
+  errNotFound,
+  errRPC,
+  errRateLimited,
+  errSessionExpired,
+  errSetupRequired,
+  errSolanaTransactionFailed,
+  errSolanaWalletKeyRequired,
+  errWalletKeyRequired,
+  exitWithError,
+  setReplMode
+} from "./chunk-QEDAULQ2.js";
+export {
+  CLIError,
+  EXIT_CODES,
+  ErrorCode,
+  errAccessDenied,
+  errAccessKeyRequired,
+  errAdminAPI,
+  errAppRequired,
+  errAuthRequired,
+  errInvalidAPIKey,
+  errInvalidAccessKey,
+  errInvalidArgs,
+  errNetwork,
+  errNetworkNotEnabled,
+  errNoActiveSession,
+  errNotFound,
+  errRPC,
+  errRateLimited,
+  errSessionExpired,
+  errSetupRequired,
+  errSolanaTransactionFailed,
+  errSolanaWalletKeyRequired,
+  errWalletKeyRequired,
+  exitWithError,
+  setReplMode
+};