@alchemy/cli 0.6.0 → 0.6.2

package/dist/{chunk-3W4ICF67.js → chunk-TK3HZ5UT.js}

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

package/dist/index.js

@@ -29,7 +29,7 @@ import {
   getAvailableUpdate,
   getUpdateStatus,
   printUpdateNotice
-} from "./chunk-3W4ICF67.js";
+} from "./chunk-TK3HZ5UT.js";
 import {
   bold,
   brand,
@@ -649,7 +649,7 @@ function registerConfig(program2) {
 
 // src/commands/rpc.ts
 function registerRPC(program2) {
-  program2.command("rpc").argument("<method>", "JSON-RPC method name (e.g. eth_blockNumber)").argument("[params...]", "Method parameters as JSON values").description("Make a raw JSON-RPC call").addHelpText(
+  program2.command("rpc").argument("<method>", "JSON-RPC method name (e.g. eth_blockNumber)").argument("[params...]", "Method parameters as JSON values").description("Sends a raw JSON-RPC request to an Alchemy node (e.g. eth_call, eth_getCode, eth_blockNumber). Use for low-level RPC calls only. For higher-level operations like balances, transfers, simulation, or token data, use the dedicated subcommands instead.").addHelpText(
     "after",
     `
 Examples:
@@ -729,7 +729,7 @@ function resolveBlockParam(block) {
   return blockParam;
 }
 function registerBalance(program2) {
-  program2.command("balance").argument("[address]", "Wallet address (0x...) or ENS name, or pipe via stdin").alias("bal").description("Get the native token balance of an address").addHelpText(
+  program2.command("balance").argument("[address]", "Wallet address (0x...) or ENS name, or pipe via stdin").alias("bal").description("Returns the native token balance (ETH, MATIC, etc.) for a single address on the current network. Use for 'how much ETH does this wallet have' queries only. Does NOT return ERC-20 tokens or multi-network portfolio data \u2014 use `alchemy tokens balances` for ERC-20s, or `alchemy portfolio tokens` for a full cross-network portfolio overview.").addHelpText(
     "after",
     `
 Examples:
@@ -1059,7 +1059,7 @@ function formatNFTRows(nfts) {
   ]);
 }
 function registerNFTs(program2) {
-  const cmd = program2.command("nfts").description("NFT API wrappers").argument("[address]", "Wallet address or ENS name (default action: list owned NFTs)").option("--limit <n>", "Maximum number of NFTs to return per page", parseInt).option("--page-key <key>", "Pagination key from a previous response").addHelpText(
+  const cmd = program2.command("nfts").description("Lists all NFTs owned by a wallet address on the current network via the Alchemy NFT API. Use for single-network NFT ownership queries. For all NFTs across multiple networks in a portfolio view, use `alchemy portfolio nfts`.").argument("[address]", "Wallet address or ENS name (default action: list owned NFTs)").option("--limit <n>", "Maximum number of NFTs to return per page", parseInt).option("--page-key <key>", "Pagination key from a previous response").addHelpText(
     "after",
     `
 Examples:
@@ -2057,7 +2057,7 @@ function registerWallet(program2) {
       exitWithError(err);
     }
   });
-  cmd.command("address").description("Display the address of the configured wallet").action(() => {
+  cmd.command("address").description("Display the address of the locally configured x402 wallet. This shows the CLI's own signing wallet only \u2014 it does NOT look up arbitrary addresses or retrieve wallet history. To check a wallet's ETH balance, use `alchemy balance`. For transfer history, use `alchemy transfers`. For token portfolio, use `alchemy portfolio tokens`. For NFTs owned by a wallet, use `alchemy nfts`.").action(() => {
     try {
       const key = resolveWalletKey(program2);
       if (!key) throw errWalletKeyRequired();
@@ -2202,7 +2202,7 @@ function formatTransferRows(transfers) {
   });
 }
 function registerTransfers(program2) {
-  program2.command("transfers").argument("[address]", "Wallet address or ENS name \u2014 queries outgoing transfers (use --to-address for incoming)").description("Get transfer history (alchemy_getAssetTransfers)").option("--from-address <address>", "Filter sender address").option("--to-address <address>", "Filter recipient address").option("--from-block <block>", "Start block (default: 0x0)").option("--to-block <block>", "End block (default: latest)").option("--category <list>", "Comma-separated categories (erc20,erc721,erc1155,external,internal,specialnft)").option("--max-count <hexOrDecimal>", "Max records to return per page").option("--page-key <key>", "Pagination key").addHelpText(
+  program2.command("transfers").argument("[address]", "Wallet address or ENS name \u2014 queries outgoing transfers (use --to-address for incoming)").description("Retrieves transfer history \u2014 all inbound and outbound asset movements (ERC-20, ERC-721, ERC-1155, and native ETH) for a wallet address. USE WHEN: user asks for transaction history, past transfers, or asset movements. Does NOT return current balances \u2014 use `alchemy balance` or `alchemy tokens balances` for that.").option("--from-address <address>", "Filter sender address").option("--to-address <address>", "Filter recipient address").option("--from-block <block>", "Start block (default: 0x0)").option("--to-block <block>", "End block (default: latest)").option("--category <list>", "Comma-separated categories (erc20,erc721,erc1155,external,internal,specialnft)").option("--max-count <hexOrDecimal>", "Max records to return per page").option("--page-key <key>", "Pagination key").addHelpText(
     "after",
     `
 Examples:
@@ -2424,7 +2424,7 @@ async function runDataCall(program2, title, path, 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) => {
+  cmd.command("tokens").description("Returns a full cross-network portfolio of all ERC-20 token holdings and USD values for a wallet address. USE WHEN: user asks for portfolio overview, all tokens held, or assets across multiple networks. For NFTs only, use `alchemy nfts`. For native ETH balance only, use `alchemy balance`.").requiredOption("--body <json>", "JSON body for /assets/tokens/by-address").action(async (opts) => {
     try {
       const result = await runDataCall(
         program2,
@@ -2452,7 +2452,7 @@ function registerPortfolio(program2) {
       exitWithError(err);
     }
   });
-  cmd.command("nfts").description("Get NFT portfolio by address/network pairs").requiredOption("--body <json>", "JSON body for /assets/nfts/by-address").action(async (opts) => {
+  cmd.command("nfts").description("Returns all NFTs owned by a wallet address across one or more networks. Use to list all NFTs a wallet holds in a portfolio view. For metadata on a specific NFT by contract + token ID, use `alchemy nfts metadata`.").requiredOption("--body <json>", "JSON body for /assets/nfts/by-address").action(async (opts) => {
     try {
       const result = await runDataCall(
         program2,
@@ -2494,7 +2494,7 @@ async function runSimulateCall(program2, options) {
 }
 function registerSimulate(program2) {
   const cmd = program2.command("simulate").description("Simulation API wrappers");
-  cmd.command("asset-changes").description("Call alchemy_simulateAssetChanges").requiredOption("--tx <json>", "Transaction object JSON").option("--block-tag <tag>", "Block tag (default latest)", "latest").action(async (opts) => {
+  cmd.command("asset-changes").description("Simulates a transaction and returns a human-readable breakdown of asset changes (token transfers, ETH movements, NFT transfers) before it is broadcast. Use to preview what a transaction will do. For raw JSON-RPC calls, use `alchemy rpc` instead.").requiredOption("--tx <json>", "Transaction object JSON").option("--block-tag <tag>", "Block tag (default latest)", "latest").action(async (opts) => {
     try {
       await runSimulateCall(program2, {
         method: "alchemy_simulateAssetChanges",
@@ -2544,7 +2544,7 @@ function resolveWebhookApiKey(opts) {
 function registerWebhooks(program2) {
   const cmd = program2.command("webhooks").description("Notify API wrappers");
   cmd.option("--webhook-api-key <key>", "Webhook API key").option("--notify-token <token>", "Deprecated alias for webhook API key");
-  cmd.command("list").description("List team webhooks").action(async () => {
+  cmd.command("list").description("Lists all existing registered Alchemy webhooks (read-only). USE WHEN: user wants to view, see, audit, or check current webhooks. DOES NOT create or modify webhooks \u2014 use `alchemy webhooks create` to register a new one.").action(async () => {
     try {
       const token = resolveWebhookApiKey(cmd.opts());
       const result = await withSpinner(
@@ -2558,7 +2558,7 @@ function registerWebhooks(program2) {
       exitWithError(err);
     }
   });
-  cmd.command("create").description("Create webhook").requiredOption("--body <json>", "Create webhook JSON payload").option("--dry-run", "Preview without executing").action(async (opts) => {
+  cmd.command("create").description("Creates and registers a NEW Alchemy webhook endpoint (write operation). USE WHEN: user wants to set up, add, register, or create a webhook for address activity, mined/dropped transactions, etc. DOES NOT list existing webhooks \u2014 use `alchemy webhooks list` for that.").requiredOption("--body <json>", "Create webhook JSON payload").option("--dry-run", "Preview without executing").action(async (opts) => {
     try {
       const payload = parseRequiredJSON(opts.body, "--body");
       if (opts.dryRun) {
@@ -3397,7 +3397,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.6.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.6.2", "-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) => {
@@ -3600,7 +3600,7 @@ ${styledLine}`;
   if (isInteractiveAllowed(program)) {
     let latestForInteractiveStartup = null;
     if (shouldRunOnboarding(program, cfg)) {
-      const { runOnboarding } = await import("./onboarding-S3GAP4OV.js");
+      const { runOnboarding } = await import("./onboarding-IP4R44EQ.js");
       const latest = getAvailableUpdateOnce();
       const completed = await runOnboarding(program, latest);
       updateShownDuringInteractiveStartup = Boolean(latest);
@@ -3612,7 +3612,7 @@ ${styledLine}`;
       latestForInteractiveStartup = getAvailableUpdateOnce();
       updateShownDuringInteractiveStartup = Boolean(latestForInteractiveStartup);
     }
-    const { startREPL } = await import("./interactive-OM476LBG.js");
+    const { startREPL } = await import("./interactive-UGD7GYJM.js");
     program.exitOverride();
     program.configureOutput({
       writeErr: () => {

package/dist/{interactive-OM476LBG.js → interactive-UGD7GYJM.js}

@@ -9,7 +9,7 @@ import "./chunk-ATX65U7J.js";
 import "./chunk-JQRGILIS.js";
 import {
   getUpdateNoticeLines
-} from "./chunk-3W4ICF67.js";
+} from "./chunk-TK3HZ5UT.js";
 import {
   bold,
   brand,

package/dist/{onboarding-S3GAP4OV.js → onboarding-IP4R44EQ.js}

@@ -2,7 +2,7 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   getUpdateNoticeLines
-} from "./chunk-3W4ICF67.js";
+} from "./chunk-TK3HZ5UT.js";
 import {
   bold,
   brand,

package/package.json

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