@alchemy/cli 0.11.1 → 0.13.0

package/README.md

@@ -118,8 +118,8 @@ Use `alchemy help` or `alchemy help <command>` for generated command help.
 
 | Command | What it does | Example |
 |---|---|---|
-| `wallet connect` | Interactive: choose a session wallet (recommended) or a local wallet. For scripts, pass `--mode <session\|local>`. | `alchemy wallet connect` |
-| `wallet connect --mode local --chain evm` | Create a new local EVM key (non-interactive). `--chain` accepts `evm`, `solana`, or `both`. | `alchemy wallet connect --mode local --chain both` |
+| `wallet connect` | Connects a session wallet by default. Pass `--mode local` only when you explicitly need local keys. | `alchemy wallet connect` |
+| `wallet connect --mode local` | Create new local EVM and Solana keys. | `alchemy wallet connect --mode local` |
 | `wallet connect --mode local --import <path>` | Import an existing EVM private key from a file. | `alchemy wallet connect --mode local --import ./key.txt` |
 | `wallet connect --mode session --instance-name <name>` | Connect a named session wallet instance. | `alchemy wallet connect --mode session --instance-name laptop` |
 | `wallet status [--verify]` | Reports session, local EVM, local Solana, and the active signer. `--verify` reconciles the session with the backend. | `alchemy wallet status --verify` |

package/dist/{auth-AU7LPEQL.js → auth-YB6AALZO.js}

@@ -3,10 +3,10 @@ if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   registerAuth,
   selectAppAfterAuth
-} from "./chunk-ILPOKA4Y.js";
+} from "./chunk-5DR7BHUX.js";
 import "./chunk-I6YQX7PF.js";
 import "./chunk-RPSHRYCZ.js";
-import "./chunk-OL5MEN62.js";
+import "./chunk-PRSZJXA6.js";
 import "./chunk-DXQAGBW6.js";
 import "./chunk-LANOFNO6.js";
 import "./chunk-5BEJA752.js";

package/dist/{chunk-ILPOKA4Y.js → chunk-5DR7BHUX.js}

@@ -11,7 +11,7 @@ import {
 import {
   AdminClient,
   resolveAuthToken
-} from "./chunk-OL5MEN62.js";
+} from "./chunk-PRSZJXA6.js";
 import {
   bold,
   brand,

package/dist/{chunk-QWLBZTG5.js → chunk-DWNXGFON.js}

@@ -6,7 +6,7 @@ import {
 import {
   resolveAuthToken,
   resolveWalletSession
-} from "./chunk-OL5MEN62.js";
+} from "./chunk-PRSZJXA6.js";
 
 // src/lib/onboarding.ts
 var SETUP_CAPABILITY_ORDER = [
@@ -69,10 +69,7 @@ function getSetupCapabilities(cfg) {
       complete: hasLocalWallet || hasSessionWallet,
       satisfiedBy: hasSessionWallet ? "wallet_session" : hasLocalWallet ? "local_wallet" : null,
       missing: hasLocalWallet || hasSessionWallet ? [] : ["wallet signer"],
-      nextCommands: hasLocalWallet || hasSessionWallet ? [] : [
-        "alchemy wallet connect",
-        "alchemy wallet connect --mode local"
-      ]
+      nextCommands: hasLocalWallet || hasSessionWallet ? [] : ["alchemy wallet connect"]
     }),
     x402: capabilityStatus({
       complete: x402Ready,

package/dist/{chunk-SRGDGXY5.js → chunk-OE6B6S2H.js}

@@ -53,7 +53,7 @@ function semverLT(a, b) {
   return false;
 }
 function currentVersion() {
-  return true ? "0.11.1" : "0.0.0";
+  return true ? "0.13.0" : "0.0.0";
 }
 function toUpdateStatus(latestVersion, checkedAt) {
   const current = currentVersion();

package/dist/{chunk-OL5MEN62.js → chunk-PRSZJXA6.js}

@@ -1092,7 +1092,7 @@ var AdminClient = class _AdminClient {
   }
   async updateNetworkAllowlist(id, networks) {
     const resp = await this.request("PUT", `/v1/apps/${id}/networks`, {
-      chainNetworks: networks
+      networkAllowlist: networks
     });
     return resp.data;
   }

package/dist/{chunk-CJDHJYLM.js → chunk-PYIVNQEI.js}

@@ -3,7 +3,7 @@ if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   gasManagerClientFromFlags,
   toAdminNetworkId
-} from "./chunk-OL5MEN62.js";
+} from "./chunk-PRSZJXA6.js";
 import {
   dim,
   green,

package/dist/index.js

@@ -5,10 +5,10 @@ import {
   errNotLoggedInForPolicyLookup,
   errSponsorshipNeedsPolicy,
   selectOrCreatePolicy
-} from "./chunk-CJDHJYLM.js";
+} from "./chunk-PYIVNQEI.js";
 import {
   registerAuth
-} from "./chunk-ILPOKA4Y.js";
+} from "./chunk-5DR7BHUX.js";
 import {
   openBrowser
 } from "./chunk-I6YQX7PF.js";
@@ -18,7 +18,7 @@ import {
   getSetupStatus,
   isSetupComplete,
   shouldRunOnboarding
-} from "./chunk-QWLBZTG5.js";
+} from "./chunk-DWNXGFON.js";
 import {
   isInteractiveAllowed
 } from "./chunk-RPSHRYCZ.js";
@@ -63,12 +63,12 @@ import {
   updateSession,
   validateNetwork,
   walletNetworkToChain
-} from "./chunk-OL5MEN62.js";
+} from "./chunk-PRSZJXA6.js";
 import {
   getAvailableUpdate,
   getUpdateStatus,
   printUpdateNotice
-} from "./chunk-SRGDGXY5.js";
+} from "./chunk-OE6B6S2H.js";
 import {
   bold,
   brand,
@@ -581,8 +581,8 @@ function registerConfig(program2) {
           "Interactive policy selection requires an interactive terminal. Pass an ID: `alchemy config set evm-gas-policy-id <id>`."
         );
       }
-      const { selectOrCreatePolicy: selectOrCreatePolicy2 } = await import("./policy-prompt-YU6L2VJZ.js");
-      const { resolveNetwork: resolveNetwork2 } = await import("./resolve-WXXPXPCU.js");
+      const { selectOrCreatePolicy: selectOrCreatePolicy2 } = await import("./policy-prompt-LY6DMMT4.js");
+      const { resolveNetwork: resolveNetwork2 } = await import("./resolve-GELBKDTP.js");
       const network = resolveNetwork2(program2);
       await selectOrCreatePolicy2({
         flavor: "sponsorship",
@@ -636,8 +636,8 @@ function registerConfig(program2) {
           "Interactive policy selection requires an interactive terminal. Pass an ID: `alchemy config set solana-fee-policy-id <id>`."
         );
       }
-      const { selectOrCreatePolicy: selectOrCreatePolicy2 } = await import("./policy-prompt-YU6L2VJZ.js");
-      const { resolveSolanaNetwork: resolveSolanaNetwork2 } = await import("./resolve-WXXPXPCU.js");
+      const { selectOrCreatePolicy: selectOrCreatePolicy2 } = await import("./policy-prompt-LY6DMMT4.js");
+      const { resolveSolanaNetwork: resolveSolanaNetwork2 } = await import("./resolve-GELBKDTP.js");
       const network = resolveSolanaNetwork2(program2);
       await selectOrCreatePolicy2({
         flavor: "solana",
@@ -694,7 +694,7 @@ function registerConfig(program2) {
       printJSON(toMap(cfg));
       return;
     }
-    const { resolveAuthToken: resolveAuthToken2 } = await import("./resolve-WXXPXPCU.js");
+    const { resolveAuthToken: resolveAuthToken2 } = await import("./resolve-GELBKDTP.js");
     const validToken = resolveAuthToken2(cfg);
     const authStatus = cfg.auth_token ? validToken ? `${green("\u2713")} authenticated${cfg.auth_token_expires_at ? ` ${dim(`(expires ${cfg.auth_token_expires_at})`)}` : ""}` : `${yellow("\u25C6")} expired${cfg.auth_token_expires_at ? ` ${dim(`(${cfg.auth_token_expires_at})`)}` : ""}` : dim("(not set) \u2014 run 'alchemy auth' to log in");
     const pairs = [
@@ -874,6 +874,21 @@ function matchesSearch(app, query) {
 function appToTableRow(app) {
   return [app.id, app.name, String(app.chainNetworks.length), app.createdAt];
 }
+function appToListJSON(app) {
+  return {
+    id: app.id,
+    name: app.name,
+    createdAt: app.createdAt,
+    networkCount: app.chainNetworks.length,
+    networks: app.chainNetworks.map((network) => ({
+      id: network.id,
+      name: network.name
+    }))
+  };
+}
+function appToJSON(app, opts) {
+  return opts.full ? maskAppSecrets(app) : appToListJSON(app);
+}
 function handleDryRun(opts, action, payload, humanMsg) {
   if (!opts.dryRun) return false;
   if (isJSONMode()) {
@@ -885,7 +900,7 @@ function handleDryRun(opts, action, payload, humanMsg) {
 }
 function registerApps(program2) {
   const cmd = program2.command("app").description("Manage Alchemy apps");
-  cmd.command("list").description("List all apps").option("--cursor <cursor>", "Pagination cursor").option("--limit <n>", "Max results per page", parseInt).option("--all", "Fetch all pages").option("--search <query>", "Search apps by name or id (client-side)").option("--id <appId>", "Filter by exact app id (client-side)").action(async (opts) => {
+  cmd.command("list").description("List all apps").option("--cursor <cursor>", "Pagination cursor").option("--limit <n>", "Max results per page", parseInt).option("--all", "Fetch all pages").option("--search <query>", "Search apps by name or id (client-side)").option("--id <appId>", "Filter by exact app id (client-side)").option("--full", "Return full sanitized app payload in JSON mode").action(async (opts) => {
     try {
       const admin = adminClientFromFlags(program2);
       const fetchAll = Boolean(opts.all);
@@ -918,7 +933,7 @@ function registerApps(program2) {
         const filteredApps = hasId ? result2.apps.filter((a) => a.id === idQuery) : hasSearch ? result2.apps.filter((a) => matchesSearch(a, searchQuery)) : result2.apps;
         if (isJSONMode()) {
           printJSON({
-            apps: filteredApps.map(maskAppSecrets),
+            apps: filteredApps.map((app) => appToJSON(app, { full: opts.full })),
             pageInfo: {
               mode: fetchAll ? "all" : "search",
               pages: result2.pages,
@@ -952,7 +967,10 @@ function registerApps(program2) {
         () => admin.listApps({ cursor: opts.cursor, limit: opts.limit })
       );
       if (isJSONMode()) {
-        printJSON({ ...result, apps: result.apps.map(maskAppSecrets) });
+        printJSON({
+          ...result,
+          apps: result.apps.map((app) => appToJSON(app, { full: opts.full }))
+        });
         return;
       }
       const interactivePagination = isInteractiveAllowed(program2) && !opts.all;
@@ -1043,7 +1061,7 @@ function registerApps(program2) {
       const products = opts.products ? splitCommaList(opts.products) : void 0;
       const payload = {
         name: opts.name,
-        networks,
+        networkAllowlist: networks,
         ...opts.description && { description: opts.description },
         ...products && { products }
       };
@@ -1134,7 +1152,12 @@ function registerApps(program2) {
   cmd.command("networks <id>").description("Update app network allowlist").requiredOption("--networks <networks>", "Comma-separated network IDs").option("--dry-run", "Preview without executing").action(async (id, opts) => {
     try {
       const networks = splitCommaList(opts.networks);
-      if (handleDryRun(opts, "networks", { id, networks }, `Would update networks for app ${id}: ${networks.join(", ")}`)) return;
+      if (handleDryRun(
+        opts,
+        "networks",
+        { id, networkAllowlist: networks },
+        `Would update networks for app ${id}: ${networks.join(", ")}`
+      )) return;
       const admin = adminClientFromFlags(program2);
       const app = await withSpinner(
         "Updating networks\u2026",
@@ -2594,28 +2617,11 @@ async function runConnectFlow(program2, opts) {
     }
     mode = "session";
   }
-  if (importPath) {
-    if (mode === "session") {
-      throw errInvalidArgs("`--import` is only valid with `--mode local`.");
-    }
-    mode = "local";
+  if (importPath && mode !== "local") {
+    throw errInvalidArgs("`--import` is only valid with `--mode local`.");
   }
   if (!mode) {
-    if (!isInteractiveAllowed(program2)) {
-      mode = "session";
-    } else {
-      const choice = await promptSelect({
-        message: "Choose a wallet to connect",
-        options: [
-          { value: "session", label: "Session wallet", hint: "Recommended \u2014 Alchemy-managed, more secure" },
-          { value: "local", label: "Local wallet", hint: "Private key stored on this machine" }
-        ],
-        initialValue: "session",
-        cancelMessage: "Wallet connect cancelled."
-      });
-      if (choice === null) throw new WalletConnectInterruptedError();
-      mode = choice;
-    }
+    mode = "session";
   }
   if (mode === "session") {
     await runSessionConnect({
@@ -2757,7 +2763,7 @@ async function buildSessionSnapshot(program2, verify) {
 }
 function registerWallets(program2) {
   const cmd = program2.command("wallet").description("Manage wallets");
-  cmd.command("connect").description("Connect a wallet for onchain actions (session or local)").option("--mode <mode>", "session | local").option("--import <path>", "For --mode local: import an EVM key from file instead of creating both wallets").option("--instance-name <name>", "For --mode session: name this CLI instance").option("--force", "Replace the existing signer").action(async (opts) => {
+  cmd.command("connect").description("Connect a session wallet for onchain actions").option("--mode <mode>", "session | local (default: session; local must be explicit)").option("--import <path>", "For --mode local: import an EVM key from file instead of creating both wallets").option("--instance-name <name>", "For --mode session: name this CLI instance").option("--force", "Replace the existing signer").action(async (opts) => {
     try {
       await runConnectFlow(program2, opts);
     } catch (err) {
@@ -6434,7 +6440,7 @@ function buildAgentPrompt(program2) {
           "evm approve",
           "xchain bridge"
         ],
-        notes: "`--signer local` only selects the local signer. You still need a local EVM key via env, flag, or saved config."
+        notes: "Use only when you explicitly need a local private key. `--signer local` selects the local signer but still requires a local EVM key via env, flag, or saved config."
       }
     ],
     commands,
@@ -10390,7 +10396,7 @@ async function flushProcessOutput() {
 }
 program.name("alchemy").description(
   "The Alchemy CLI lets you query blockchain data, call JSON-RPC methods, and manage your Alchemy configuration."
-).version("0.11.1", "-v, --version", "display CLI version").option("--api-key <key>", "Alchemy API key (env: ALCHEMY_API_KEY)").option(
+).version("0.13.0", "-v, --version", "display CLI version").option("--api-key <key>", "Alchemy API key (env: ALCHEMY_API_KEY)").option(
   "-n, --network <network>",
   "Target network for networked commands"
 ).option("--x402", "Use x402 wallet-based gateway auth").option(
@@ -10577,11 +10583,11 @@ ${styledLine}`;
     "wallet"
   ];
   if (!skipAppPrompt.includes(cmdName) && isInteractiveAllowed(program) && !opts.apiKey && !process.env.ALCHEMY_API_KEY) {
-    const { resolveAuthToken: resolveAuthToken2 } = await import("./resolve-WXXPXPCU.js");
+    const { resolveAuthToken: resolveAuthToken2 } = await import("./resolve-GELBKDTP.js");
     const authToken = resolveAuthToken2(cfg);
     const hasApiKey = Boolean(cfg.api_key?.trim() || cfg.app?.apiKey);
     if (authToken && !hasApiKey) {
-      const { selectAppAfterAuth } = await import("./auth-AU7LPEQL.js");
+      const { selectAppAfterAuth } = await import("./auth-YB6AALZO.js");
       console.log("");
       console.log(`  No app selected. Please select an app to continue.`);
       await selectAppAfterAuth(authToken);
@@ -10616,7 +10622,7 @@ ${styledLine}`;
   if (isInteractiveAllowed(program)) {
     let latestForInteractiveStartup = null;
     if (shouldRunOnboarding(program, cfg)) {
-      const { runOnboarding } = await import("./onboarding-QOZOX4CZ.js");
+      const { runOnboarding } = await import("./onboarding-TYRUMFUL.js");
       const latest = getAvailableUpdateOnce();
       const completed = await runOnboarding(program, latest);
       updateShownDuringInteractiveStartup = Boolean(latest);
@@ -10630,7 +10636,7 @@ ${styledLine}`;
         latestForInteractiveStartup
       );
     }
-    const { startREPL } = await import("./interactive-NPBITOGO.js");
+    const { startREPL } = await import("./interactive-6SOB4IYV.js");
     program.exitOverride();
     program.configureOutput({
       writeErr: () => {

package/dist/{interactive-NPBITOGO.js → interactive-6SOB4IYV.js}

@@ -2,14 +2,14 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   getSetupMethod
-} from "./chunk-QWLBZTG5.js";
+} from "./chunk-DWNXGFON.js";
 import "./chunk-RPSHRYCZ.js";
 import {
   getRPCNetworkIds
-} from "./chunk-OL5MEN62.js";
+} from "./chunk-PRSZJXA6.js";
 import {
   getUpdateNoticeLines
-} from "./chunk-SRGDGXY5.js";
+} from "./chunk-OE6B6S2H.js";
 import {
   bold,
   brand,

package/dist/{onboarding-QOZOX4CZ.js → onboarding-TYRUMFUL.js}

@@ -2,7 +2,7 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   getUpdateNoticeLines
-} from "./chunk-SRGDGXY5.js";
+} from "./chunk-OE6B6S2H.js";
 import {
   bold,
   brand,
@@ -51,7 +51,7 @@ async function runOnboarding(_program, latestUpdate = null) {
       auth_token_expires_at: result.expiresAt
     });
     console.log(`  ${green("\u2713")} Logged in successfully`);
-    const { selectAppAfterAuth } = await import("./auth-AU7LPEQL.js");
+    const { selectAppAfterAuth } = await import("./auth-YB6AALZO.js");
     await selectAppAfterAuth(result.token);
     return true;
   } catch (err) {

package/dist/{policy-prompt-YU6L2VJZ.js → policy-prompt-LY6DMMT4.js}

@@ -5,8 +5,8 @@ import {
   errNotLoggedInForPolicyLookup,
   errSponsorshipNeedsPolicy,
   selectOrCreatePolicy
-} from "./chunk-CJDHJYLM.js";
-import "./chunk-OL5MEN62.js";
+} from "./chunk-PYIVNQEI.js";
+import "./chunk-PRSZJXA6.js";
 import "./chunk-DXQAGBW6.js";
 import "./chunk-LANOFNO6.js";
 import "./chunk-5BEJA752.js";

package/dist/{resolve-WXXPXPCU.js → resolve-GELBKDTP.js}

@@ -26,7 +26,7 @@ import {
   resolveWalletSession,
   resolveX402,
   resolveX402Client
-} from "./chunk-OL5MEN62.js";
+} from "./chunk-PRSZJXA6.js";
 import "./chunk-LANOFNO6.js";
 import "./chunk-5BEJA752.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alchemy/cli",
-  "version": "0.11.1",
+  "version": "0.13.0",
   "description": "Alchemy CLI — interact with blockchain data",
   "type": "module",
   "bin": {