@alchemy/cli 0.4.0 → 0.5.0

package/dist/index.js

@@ -1,37 +1,65 @@
 #!/usr/bin/env node
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
-  adminClientFromFlags,
-  clientFromFlags,
-  fetchWithTimeout,
+  registerAuth
+} from "./chunk-LYUW7O6X.js";
+import "./chunk-IGD4NIK7.js";
+import {
   readStdinArg,
   readStdinLines,
   registerConfig,
   registerWallet,
-  resolveAPIKey,
   resolveAddress,
-  resolveAppId,
-  resolveNetwork,
   splitCommaList,
   validateAddress,
   validateTxHash
-} from "./chunk-PIWNNNMZ.js";
+} from "./chunk-44OGGLN4.js";
 import {
   getRPCNetworks,
   getSetupStatus,
   isSetupComplete,
   nativeTokenSymbol,
   shouldRunOnboarding
-} from "./chunk-Z3LXQFIY.js";
+} from "./chunk-5X6YRTPU.js";
 import {
-  EXIT_CODES,
-  ErrorCode,
+  getAvailableUpdate,
+  getUpdateStatus,
+  printUpdateNotice
+} from "./chunk-DUQFOLLZ.js";
+import {
+  adminClientFromFlags,
   bold,
   brand,
   brandedHelp,
-  debug,
+  clientFromFlags,
   dim,
   emptyState,
+  etherscanTxURL,
+  failBadge,
+  green,
+  isInteractiveAllowed,
+  load,
+  maskIf,
+  printKeyValueBox,
+  printSyntaxJSON,
+  printTable,
+  promptConfirm,
+  promptSelect,
+  red,
+  resolveAPIKey,
+  resolveAppId,
+  resolveNetwork,
+  resolveX402Client,
+  save,
+  successBadge,
+  timeAgo,
+  weiToEth,
+  withSpinner
+} from "./chunk-T2XSNZE3.js";
+import {
+  EXIT_CODES,
+  ErrorCode,
+  debug,
   errAppRequired,
   errAuthRequired,
   errInvalidAPIKey,
@@ -41,37 +69,20 @@ import {
   errRateLimited,
   errSetupRequired,
   esc,
-  etherscanTxURL,
   exitWithError,
-  failBadge,
+  fetchWithTimeout,
   formatCommanderError,
-  getAvailableUpdate,
-  getUpdateStatus,
-  green,
+  getBaseDomain,
   identity,
-  isInteractiveAllowed,
   isJSONMode,
-  load,
-  maskIf,
   noColor,
   printHuman,
   printJSON,
-  printKeyValueBox,
-  printSyntaxJSON,
-  printTable,
-  printUpdateNotice,
-  promptConfirm,
-  promptSelect,
   quiet,
-  red,
   setFlags,
   setNoColor,
-  successBadge,
-  timeAgo,
-  verbose,
-  weiToEth,
-  withSpinner
-} from "./chunk-TH75DFAY.js";
+  verbose
+} from "./chunk-56ZVYB4G.js";
 
 // src/index.ts
 import { Command, Help } from "commander";
@@ -829,11 +840,11 @@ Examples:
       const result = await withSpinner(
         "Fetching token allowance\u2026",
         "Token allowance fetched",
-        () => client.call("alchemy_getTokenAllowance", [
-          opts.owner,
-          opts.spender,
-          opts.contract
-        ])
+        () => client.call("alchemy_getTokenAllowance", [{
+          owner: opts.owner,
+          spender: opts.spender,
+          contract: opts.contract
+        }])
       );
       if (isJSONMode()) printJSON(result);
       else printSyntaxJSON(result);
@@ -1310,6 +1321,64 @@ function registerApps(program2) {
       exitWithError(err);
     }
   });
+  cmd.command("select [id]").description("Select an app to use as the default").action(async (id) => {
+    try {
+      const admin = adminClientFromFlags(program2);
+      let selected;
+      if (id) {
+        selected = await withSpinner(
+          "Fetching app\u2026",
+          "App fetched",
+          () => admin.getApp(id)
+        );
+      } else {
+        const result = await withSpinner(
+          "Fetching apps\u2026",
+          "Apps fetched",
+          () => admin.listAllApps()
+        );
+        if (result.apps.length === 0) {
+          emptyState("No apps found.");
+          return;
+        }
+        if (isJSONMode()) {
+          printJSON({ apps: result.apps.map(maskAppSecrets) });
+          return;
+        }
+        const appId = await promptSelect({
+          message: "Select an app",
+          options: result.apps.map((app) => ({
+            value: app.id,
+            label: app.name,
+            hint: `${app.chainNetworks.length} networks`
+          })),
+          cancelMessage: "Cancelled app selection."
+        });
+        if (!appId) return;
+        const found = result.apps.find((a) => a.id === appId);
+        if (!found) return;
+        selected = found;
+      }
+      const cfg = load();
+      save({
+        ...cfg,
+        app: {
+          id: selected.id,
+          name: selected.name,
+          apiKey: selected.apiKey,
+          webhookApiKey: selected.webhookApiKey
+        }
+      });
+      if (isJSONMode()) {
+        printJSON(maskAppSecrets(selected));
+        return;
+      }
+      console.log(`  ${green("\u2713")} Selected app: ${selected.name}`);
+      console.log(`  ${dim("Saved to config")}`);
+    } catch (err) {
+      exitWithError(err);
+    }
+  });
   cmd.command("chains").description("List Admin API chain identifiers for app configuration (e.g. ETH_MAINNET)").action(async () => {
     try {
       const admin = adminClientFromFlags(program2);
@@ -1599,13 +1668,13 @@ async function requestJSON(url, options) {
 }
 async function callApiData(apiKey, path, options = {}) {
   if (!apiKey) throw errAuthRequired();
-  const base = new URL(`https://api.g.alchemy.com/data/v1/${apiKey}/`);
+  const base = new URL(`https://api.g.${getBaseDomain()}/data/v1/${apiKey}/`);
   const url = withQuery(new URL(path.replace(/^\//, ""), base), options.query);
   return requestJSON(url, { ...options, path });
 }
 async function callApiPrices(apiKey, path, options = {}) {
   if (!apiKey) throw errAuthRequired();
-  const base = new URL(`https://api.g.alchemy.com/prices/v1/${apiKey}/`);
+  const base = new URL(`https://api.g.${getBaseDomain()}/prices/v1/${apiKey}/`);
   const url = withQuery(new URL(path.replace(/^\//, ""), base), options.query);
   return requestJSON(url, { ...options, path });
 }
@@ -1615,7 +1684,7 @@ async function callNotify(token, path, options = {}) {
       "Webhook API key required. Set ALCHEMY_WEBHOOK_API_KEY (or ALCHEMY_NOTIFY_AUTH_TOKEN) or pass --webhook-api-key."
     );
   }
-  const base = new URL("https://dashboard.alchemy.com/api/");
+  const base = new URL(`https://dashboard.${getBaseDomain()}/api/`);
   const url = withQuery(new URL(path.replace(/^\//, ""), base), options.query);
   return requestJSON(url, {
     ...options,
@@ -1632,14 +1701,14 @@ function registerPrices(program2) {
   const cmd = program2.command("prices").description("Prices API wrappers");
   cmd.command("symbol <symbols>").description("Get spot prices by symbol (comma-separated)").action(async (symbols) => {
     try {
-      const apiKey = resolveAPIKey(program2);
       const values = splitCommaList(symbols);
       const query = new URLSearchParams();
       for (const symbol of values) query.append("symbols", symbol);
+      const x402 = resolveX402Client(program2);
       const result = await withSpinner(
         "Fetching prices\u2026",
         "Prices fetched",
-        () => callApiPrices(apiKey, `/tokens/by-symbol?${query.toString()}`)
+        () => x402 ? x402.callRest(`prices/v1/tokens/by-symbol?${query.toString()}`) : callApiPrices(resolveAPIKey(program2), `/tokens/by-symbol?${query.toString()}`)
       );
       if (isJSONMode()) printJSON(result);
       else printSyntaxJSON(result);
@@ -1649,12 +1718,12 @@ function registerPrices(program2) {
   });
   cmd.command("address").description("Get spot prices by token addresses").requiredOption("--addresses <json>", "JSON array of {network,address}").action(async (opts) => {
     try {
-      const apiKey = resolveAPIKey(program2);
       const body = { addresses: JSON.parse(opts.addresses) };
+      const x402 = resolveX402Client(program2);
       const result = await withSpinner(
         "Fetching prices\u2026",
         "Prices fetched",
-        () => callApiPrices(apiKey, "/tokens/by-address", { method: "POST", body })
+        () => x402 ? x402.callRest("prices/v1/tokens/by-address", { method: "POST", body }) : callApiPrices(resolveAPIKey(program2), "/tokens/by-address", { method: "POST", body })
       );
       if (isJSONMode()) printJSON(result);
       else printSyntaxJSON(result);
@@ -1670,12 +1739,12 @@ Examples:
   alchemy prices historical --body '{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","network":"eth-mainnet","startTime":"2024-06-01","endTime":"2024-06-07","interval":"1d"}'`
   ).action(async (opts) => {
     try {
-      const apiKey = resolveAPIKey(program2);
       const payload = JSON.parse(opts.body);
+      const x402 = resolveX402Client(program2);
       const result = await withSpinner(
         "Fetching historical prices\u2026",
         "Historical prices fetched",
-        () => callApiPrices(apiKey, "/tokens/historical", { method: "POST", body: payload })
+        () => x402 ? x402.callRest("prices/v1/tokens/historical", { method: "POST", body: payload }) : callApiPrices(resolveAPIKey(program2), "/tokens/historical", { method: "POST", body: payload })
       );
       if (isJSONMode()) printJSON(result);
       else printSyntaxJSON(result);
@@ -1686,20 +1755,20 @@ Examples:
 }
 
 // src/commands/portfolio.ts
-async function runDataCall(apiKey, title, path, body) {
+async function runDataCall(program2, title, path, body) {
+  const x402 = resolveX402Client(program2);
   return withSpinner(
     `Fetching ${title}\u2026`,
     `${title} fetched`,
-    () => callApiData(apiKey, path, { method: "POST", body })
+    () => x402 ? x402.callRest(`data/v1${path}`, { method: "POST", body }) : callApiData(resolveAPIKey(program2), path, { method: "POST", body })
   );
 }
 function registerPortfolio(program2) {
   const cmd = program2.command("portfolio").description("Portfolio API wrappers");
   cmd.command("tokens").description("Get token portfolio by address/network pairs").requiredOption("--body <json>", "JSON body for /assets/tokens/by-address").action(async (opts) => {
     try {
-      const apiKey = resolveAPIKey(program2);
       const result = await runDataCall(
-        apiKey,
+        program2,
         "token portfolio",
         "/assets/tokens/by-address",
         JSON.parse(opts.body)
@@ -1712,9 +1781,8 @@ function registerPortfolio(program2) {
   });
   cmd.command("token-balances").description("Get token balances by address/network pairs").requiredOption("--body <json>", "JSON body for /assets/tokens/balances/by-address").action(async (opts) => {
     try {
-      const apiKey = resolveAPIKey(program2);
       const result = await runDataCall(
-        apiKey,
+        program2,
         "token balances",
         "/assets/tokens/balances/by-address",
         JSON.parse(opts.body)
@@ -1727,9 +1795,8 @@ function registerPortfolio(program2) {
   });
   cmd.command("nfts").description("Get NFT portfolio by address/network pairs").requiredOption("--body <json>", "JSON body for /assets/nfts/by-address").action(async (opts) => {
     try {
-      const apiKey = resolveAPIKey(program2);
       const result = await runDataCall(
-        apiKey,
+        program2,
         "NFT portfolio",
         "/assets/nfts/by-address",
         JSON.parse(opts.body)
@@ -1742,9 +1809,8 @@ function registerPortfolio(program2) {
   });
   cmd.command("nft-contracts").description("Get NFT contracts by address/network pairs").requiredOption("--body <json>", "JSON body for /assets/nfts/contracts/by-address").action(async (opts) => {
     try {
-      const apiKey = resolveAPIKey(program2);
       const result = await runDataCall(
-        apiKey,
+        program2,
         "NFT contracts",
         "/assets/nfts/contracts/by-address",
         JSON.parse(opts.body)
@@ -2623,7 +2689,7 @@ var ROOT_COMMAND_PILLARS = [
   },
   {
     label: "Admin",
-    commands: ["apps", "config", "setup", "completions", "agent-prompt", "update-check", "version", "help"]
+    commands: ["apps", "auth", "config", "setup", "completions", "agent-prompt", "update-check", "version", "help"]
   }
 ];
 function formatCommandSignature(sub) {
@@ -2672,7 +2738,7 @@ function resetUpdateNoticeState() {
 }
 program.name("alchemy").description(
   "The Alchemy CLI lets you query blockchain data, call JSON-RPC methods, and manage your Alchemy configuration."
-).version("0.4.0", "-v, --version", "display CLI version").option("--api-key <key>", "Alchemy API key (env: ALCHEMY_API_KEY)").option("--access-key <key>", "Alchemy access key (env: ALCHEMY_ACCESS_KEY)").option(
+).version("0.5.0", "-v, --version", "display CLI version").option("--api-key <key>", "Alchemy API key (env: ALCHEMY_API_KEY)").option("--access-key <key>", "Alchemy access key (env: ALCHEMY_ACCESS_KEY)").option(
   "-n, --network <network>",
   "Target network (default: eth-mainnet) (env: ALCHEMY_NETWORK)"
 ).option("--x402", "Use x402 wallet-based gateway auth").option("--wallet-key-file <path>", "Path to wallet private key file for x402").option("--json", "Force JSON output (auto-enabled when piped)").option("-q, --quiet", "Suppress non-essential output").option("--verbose", "Enable verbose output").option("--no-color", "Disable color output").option("--reveal", "Show secrets in plain text").option("--timeout <ms>", "Request timeout in milliseconds (default: none)", parseInt).option("--debug", "Enable debug diagnostics").option("--no-interactive", "Disable REPL and prompt-driven interactions").addHelpCommand(false).allowExcessArguments(true).exitOverride((err) => {
@@ -2852,7 +2918,7 @@ ${styledLine}`;
   if (isInteractiveAllowed(program)) {
     let latestForInteractiveStartup = null;
     if (shouldRunOnboarding(program, cfg)) {
-      const { runOnboarding } = await import("./onboarding-WQ2TWDM3.js");
+      const { runOnboarding } = await import("./onboarding-F5PZMFZU.js");
       const latest = getAvailableUpdateOnce();
       const completed = await runOnboarding(program, latest);
       updateShownDuringInteractiveStartup = Boolean(latest);
@@ -2864,7 +2930,7 @@ ${styledLine}`;
       latestForInteractiveStartup = getAvailableUpdateOnce();
       updateShownDuringInteractiveStartup = Boolean(latestForInteractiveStartup);
     }
-    const { startREPL } = await import("./interactive-NASSNJHQ.js");
+    const { startREPL } = await import("./interactive-K7XOS6U6.js");
     program.exitOverride();
     program.configureOutput({
       writeErr: () => {
@@ -2896,6 +2962,7 @@ registerGasManager(program);
 registerWebhooks(program);
 registerNetwork(program);
 registerApps(program);
+registerAuth(program);
 registerSetup(program);
 registerConfig(program);
 registerSolana(program);

package/dist/{interactive-NASSNJHQ.js → interactive-K7XOS6U6.js}

@@ -3,23 +3,27 @@ if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   getRPCNetworkIds,
   getSetupMethod
-} from "./chunk-Z3LXQFIY.js";
+} from "./chunk-5X6YRTPU.js";
+import {
+  getUpdateNoticeLines
+} from "./chunk-DUQFOLLZ.js";
 import {
-  bgRgb,
   bold,
   brand,
   brandedHelp,
   configDir,
   dim,
-  getUpdateNoticeLines,
   green,
-  isJSONMode,
   load,
+  setBrandedHelpSuppressed
+} from "./chunk-T2XSNZE3.js";
+import {
+  bgRgb,
+  isJSONMode,
   noColor,
   rgb,
-  setBrandedHelpSuppressed,
   setReplMode
-} from "./chunk-TH75DFAY.js";
+} from "./chunk-56ZVYB4G.js";
 
 // src/commands/interactive.ts
 import * as readline from "readline";
@@ -118,7 +122,8 @@ function formatSetupMethodLabel() {
   const method = getSetupMethod(load());
   if (method === "api_key") return "API key";
   if (method === "access_key_app") return "Access key + app";
-  if (method === "x402_wallet") return "x402 wallet";
+  if (method === "x402_wallet") return "SIWx wallet";
+  if (method === "auth_token") return "Auth token";
   return "Not configured";
 }
 function replHistoryPath() {

package/dist/{onboarding-WQ2TWDM3.js → onboarding-F5PZMFZU.js}

@@ -1,17 +1,19 @@
 #!/usr/bin/env node
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
-  AdminClient,
   generateAndPersistWallet,
   importAndPersistWallet,
   selectOrCreateApp
-} from "./chunk-PIWNNNMZ.js";
+} from "./chunk-44OGGLN4.js";
+import {
+  getUpdateNoticeLines
+} from "./chunk-DUQFOLLZ.js";
 import {
+  AdminClient,
   bold,
   brand,
   brandedHelp,
   dim,
-  getUpdateNoticeLines,
   green,
   load,
   maskIf,
@@ -19,17 +21,19 @@ import {
   promptSelect,
   promptText,
   save
-} from "./chunk-TH75DFAY.js";
+} from "./chunk-T2XSNZE3.js";
+import "./chunk-56ZVYB4G.js";
 
 // src/commands/onboarding.ts
 function printNextSteps(method) {
   const commandsByMethod = {
+    "browser-login": ["alchemy auth"],
     "api-key": ["alchemy config set api-key <key>"],
     "access-key": [
       "alchemy config set access-key <key>",
       "alchemy config set app <app-id>"
     ],
-    x402: [
+    siwx: [
       "alchemy wallet generate",
       "alchemy config set wallet-key-file <path>",
       "alchemy config set x402 true"
@@ -83,15 +87,15 @@ async function runAccessKeyOnboarding() {
   console.log(`  ${green("\u2713")} Saved access key`);
   await selectOrCreateApp(new AdminClient(key.trim()));
 }
-async function runX402Onboarding() {
+async function runSiwxOnboarding() {
   const action = await promptSelect({
-    message: "x402 wallet setup",
+    message: "SIWx wallet setup",
     options: [
       { label: "Generate a new wallet", value: "generate" },
       { label: "Import wallet from key file", value: "import" }
     ],
     initialValue: "generate",
-    cancelMessage: "Skipped x402 setup."
+    cancelMessage: "Skipped SIWx setup."
   });
   if (!action) return;
   const wallet = action === "generate" ? generateAndPersistWallet() : await (async () => {
@@ -105,7 +109,18 @@ async function runX402Onboarding() {
   if (!wallet) return;
   const cfg = load();
   save({ ...cfg, x402: true });
-  console.log(`  ${green("\u2713")} x402 enabled with wallet ${wallet.address}`);
+  console.log(`  ${green("\u2713")} SIWx enabled with wallet ${wallet.address}`);
+  try {
+    const { signSiwe } = await import("@alchemy/x402");
+    const { readFileSync } = await import("fs");
+    const keyPath = wallet.keyFile;
+    const privateKey = readFileSync(keyPath, "utf-8").trim();
+    const siweToken = await signSiwe({ privateKey, expiresAfter: "1h" });
+    const expiresAt = new Date(Date.now() + 60 * 60 * 1e3).toISOString();
+    save({ ...load(), siwe_token: siweToken, siwe_token_expires_at: expiresAt });
+    console.log(`  ${green("\u2713")} Signed SIWE token (cached for 1h)`);
+  } catch {
+  }
 }
 async function runOnboarding(_program, latestUpdate = null) {
   process.stdout.write(brandedHelp({ force: true }));
@@ -125,6 +140,11 @@ async function runOnboarding(_program, latestUpdate = null) {
   const method = await promptSelect({
     message: "Choose an auth setup path",
     options: [
+      {
+        label: "Browser login",
+        hint: "Log in via browser (recommended)",
+        value: "browser-login"
+      },
       {
         label: "API key",
         hint: "Query Alchemy RPC nodes",
@@ -136,16 +156,16 @@ async function runOnboarding(_program, latestUpdate = null) {
         value: "access-key"
       },
       {
-        label: "x402",
-        hint: "Agentic API access and payment",
-        value: "x402"
+        label: "SIWx",
+        hint: "Sign-In with Ethereum/Solana wallet",
+        value: "siwx"
       },
       {
         label: "exit",
         value: "exit"
       }
     ],
-    initialValue: "api-key",
+    initialValue: "browser-login",
     cancelMessage: "Skipped onboarding."
   });
   if (!method) return false;
@@ -153,6 +173,28 @@ async function runOnboarding(_program, latestUpdate = null) {
     console.log(`  ${dim("Exited onboarding.")}`);
     return false;
   }
+  if (method === "browser-login") {
+    const { performBrowserLogin, AUTH_PORT, getLoginUrl } = await import("./auth-E26YCAJV.js");
+    console.log(`  Opening browser to log in...`);
+    console.log(`  ${dim(getLoginUrl(AUTH_PORT))}`);
+    console.log(`  ${dim("Waiting for authentication...")}`);
+    try {
+      const result = await performBrowserLogin();
+      const cfg2 = load();
+      save({
+        ...cfg2,
+        auth_token: result.token,
+        auth_token_expires_at: result.expiresAt
+      });
+      console.log(`  ${green("\u2713")} Logged in successfully`);
+      const { selectAppAfterAuth } = await import("./auth-7E33EMAI.js");
+      await selectAppAfterAuth(result.token);
+      return true;
+    } catch (err) {
+      console.log(`  ${dim(`Login failed: ${err instanceof Error ? err.message : String(err)}`)}`);
+      return false;
+    }
+  }
   if (method === "api-key") {
     await runAPIKeyOnboarding();
     const complete2 = Boolean(load().api_key?.trim());
@@ -172,11 +214,11 @@ async function runOnboarding(_program, latestUpdate = null) {
     }
     return complete2;
   }
-  await runX402Onboarding();
+  await runSiwxOnboarding();
   const cfg = load();
   const complete = cfg.x402 === true && Boolean(cfg.wallet_key_file?.trim());
   if (!complete) {
-    printNextSteps("x402");
+    printNextSteps("siwx");
   }
   return complete;
 }

package/package.json

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