@alchemy/cli 0.10.0 → 0.11.0

package/dist/index.js

@@ -5,26 +5,27 @@ import {
   errNotLoggedInForPolicyLookup,
   errSponsorshipNeedsPolicy,
   selectOrCreatePolicy
-} from "./chunk-D2RUM2DD.js";
+} from "./chunk-KIYIW6SX.js";
 import {
   registerAuth
-} from "./chunk-L5E7GEUU.js";
+} from "./chunk-XZS6KZHN.js";
 import {
   openBrowser
-} from "./chunk-AMGGO36F.js";
+} from "./chunk-I6YQX7PF.js";
 import {
   SETUP_CAPABILITY_LABELS,
   SETUP_CAPABILITY_ORDER,
   getSetupStatus,
   isSetupComplete,
   shouldRunOnboarding
-} from "./chunk-VN5JUWHO.js";
+} from "./chunk-CSBYGYG6.js";
 import {
   isInteractiveAllowed
-} from "./chunk-3GBDYROJ.js";
+} from "./chunk-RPSHRYCZ.js";
 import {
   RpcApiError,
   adminClientFromFlags,
+  apiKeyClientFromFlags,
   clearSession,
   clientFromFlags,
   createPendingSession,
@@ -47,6 +48,8 @@ import {
   resolveGasPolicyId,
   resolveGasSponsored,
   resolveNetwork,
+  resolveOptionalNetwork,
+  resolveRequiredNetwork,
   resolveSolanaFeePolicyId,
   resolveSolanaFeeSponsored,
   resolveSolanaNetwork,
@@ -60,12 +63,12 @@ import {
   updateSession,
   validateNetwork,
   walletNetworkToChain
-} from "./chunk-ANONMDDZ.js";
+} from "./chunk-B5KVL3ZR.js";
 import {
   getAvailableUpdate,
   getUpdateStatus,
   printUpdateNotice
-} from "./chunk-HRWD4V2P.js";
+} from "./chunk-4QSVWWSK.js";
 import {
   bold,
   brand,
@@ -89,7 +92,7 @@ import {
   weiToEth,
   withSpinner,
   yellow
-} from "./chunk-PMNRIXJI.js";
+} from "./chunk-DXQAGBW6.js";
 import {
   KEY_MAP,
   configDir,
@@ -100,7 +103,7 @@ import {
   save,
   toMap,
   validKeys
-} from "./chunk-GLKB4JM7.js";
+} from "./chunk-LANOFNO6.js";
 import {
   CLIError,
   EXIT_CODES,
@@ -120,6 +123,7 @@ import {
   errSolanaTransactionFailed,
   errSolanaWalletKeyRequired,
   errWalletKeyRequired,
+  errWalletRequired,
   esc,
   exitWithError,
   fetchWithTimeout,
@@ -138,7 +142,7 @@ import {
   setNoColor,
   timeout,
   verbose
-} from "./chunk-CTTW4PA4.js";
+} from "./chunk-5BEJA752.js";
 
 // src/index.ts
 import { Command, Help } from "commander";
@@ -497,16 +501,6 @@ function registerConfig(program2) {
       exitWithError(err);
     }
   });
-  setCmd.command("network <network>").description("Set the default network (e.g. eth-mainnet, polygon-mainnet)").action((network) => {
-    try {
-      const cfg = load();
-      save({ ...cfg, network });
-      printHuman(`${green("\u2713")} Set network to ${network}
-`, { key: "network", value: network, status: "set" });
-    } catch (err) {
-      exitWithError(err);
-    }
-  });
   setCmd.command("verbose <enabled>").description("Set default verbose output (true|false)").action((enabled) => {
     try {
       const normalized = enabled.trim().toLowerCase();
@@ -585,8 +579,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-V6W7CPAO.js");
-      const { resolveNetwork: resolveNetwork2 } = await import("./resolve-REZCFZZ7.js");
+      const { selectOrCreatePolicy: selectOrCreatePolicy2 } = await import("./policy-prompt-3EVE7DW3.js");
+      const { resolveNetwork: resolveNetwork2 } = await import("./resolve-FRMIY357.js");
       const network = resolveNetwork2(program2);
       await selectOrCreatePolicy2({
         flavor: "sponsorship",
@@ -640,8 +634,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-V6W7CPAO.js");
-      const { resolveSolanaNetwork: resolveSolanaNetwork2 } = await import("./resolve-REZCFZZ7.js");
+      const { selectOrCreatePolicy: selectOrCreatePolicy2 } = await import("./policy-prompt-3EVE7DW3.js");
+      const { resolveSolanaNetwork: resolveSolanaNetwork2 } = await import("./resolve-FRMIY357.js");
       const network = resolveSolanaNetwork2(program2);
       await selectOrCreatePolicy2({
         flavor: "solana",
@@ -663,13 +657,12 @@ function registerConfig(program2) {
       exitWithError(err);
     }
   });
-  cmd.command("get <key>").description("Get a config value (api-key, app, network, verbose, wallet-key-file, x402)").action((key) => {
+  cmd.command("get <key>").description("Get a config value (api-key, app, verbose, wallet-key-file, x402)").action((key) => {
     const cfg = load();
     let value = get(cfg, key);
     let isDefault = false;
     if (value === void 0) {
       const defaults = {
-        network: "eth-mainnet",
         verbose: "false",
         x402: "false",
         evm_gas_sponsored: "false",
@@ -699,7 +692,7 @@ function registerConfig(program2) {
       printJSON(toMap(cfg));
       return;
     }
-    const { resolveAuthToken: resolveAuthToken2 } = await import("./resolve-REZCFZZ7.js");
+    const { resolveAuthToken: resolveAuthToken2 } = await import("./resolve-FRMIY357.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 = [
@@ -713,7 +706,6 @@ function registerConfig(program2) {
         "app",
         cfg.app ? `${cfg.app.name} ${dim(`(${cfg.app.id})`)}` : dim("(not set) \u2014 set automatically via 'alchemy auth' or 'config set app'")
       ],
-      ["network", cfg.network || dim("(not set, defaults to eth-mainnet)")],
       [
         "verbose",
         cfg.verbose !== void 0 ? String(cfg.verbose) : dim("(not set, defaults to false)")
@@ -3311,7 +3303,7 @@ function registerNetwork(program2) {
   cmd.command("list").description("List RPC network IDs for use with --network (e.g. eth-mainnet)").option("--mainnet-only", "Show only mainnet networks").option("--testnet-only", "Show only testnet networks").option("--search <term>", "Filter networks by name or ID").action(async (opts) => {
     try {
       let display = getRPCNetworks();
-      const current = resolveNetwork(program2);
+      const current = resolveOptionalNetwork(program2);
       if (opts.mainnetOnly) {
         display = display.filter((n) => !n.isTestnet);
       } else if (opts.testnetOnly) {
@@ -3328,15 +3320,17 @@ function registerNetwork(program2) {
         return;
       }
       const rows = display.map((network) => {
-        const isCurrent = network.id === current;
+        const isCurrent = current !== void 0 && network.id === current;
         const idCell = isCurrent ? green(network.id) : network.id;
         const nameCell = isCurrent ? green(network.name) : network.name;
         const testnetCell = network.isTestnet ? dim("yes") : "no";
         return [idCell, nameCell, network.family, testnetCell];
       });
       printTable(["Network ID", "Name", "Family", "Testnet"], rows);
-      console.log(`
+      if (current) {
+        console.log(`
   Current: ${green(current)}`);
+      }
       console.log(
         `  ${dim("Need Admin API chain identifiers (e.g. ETH_MAINNET)? See: app chains")}`
       );
@@ -3348,7 +3342,7 @@ function registerNetwork(program2) {
         printJSON({
           mode: "all",
           networks: display,
-          currentNetwork: current
+          currentNetwork: current ?? null
         });
       }
     } catch (err) {
@@ -3400,7 +3394,7 @@ function formatTokenAmount(rawAmount, decimals) {
   return frac ? `${whole}.${frac}` : whole;
 }
 async function fetchTokenDecimals(program2, tokenAddress, opts) {
-  const client = clientFromFlags(
+  const client = apiKeyClientFromFlags(
     program2,
     opts?.network ? { forceNetwork: opts.network } : void 0
   );
@@ -5044,7 +5038,7 @@ function createAlchemyWalletTransport(apiKey) {
 }
 
 // src/lib/smart-wallet.ts
-async function ensureGasPolicyResolved(program2) {
+async function ensureGasPolicyResolved(program2, options = {}) {
   const cfg = load();
   if (!resolveGasSponsored(program2, cfg)) return void 0;
   const existing = resolveGasPolicyId(program2, cfg);
@@ -5055,7 +5049,7 @@ async function ensureGasPolicyResolved(program2) {
   if (!hasAuthLoginToken(cfg)) {
     throw errNotLoggedInForPolicyLookup();
   }
-  const network = resolveNetwork(program2, cfg);
+  const network = options.networkOverride ?? resolveNetwork(program2);
   const policyId = await selectOrCreatePolicy({
     flavor: "sponsorship",
     network,
@@ -5110,7 +5104,7 @@ function buildWalletClient(program2, options = {}) {
   const apiKey = resolveAPIKey(program2);
   if (!apiKey) throw errAuthRequired();
   const cfg = load();
-  const network = resolveNetwork(program2, cfg);
+  const network = options.networkOverride ?? resolveNetwork(program2);
   const chain = networkToChain(network);
   const gasSponsored = resolveGasSponsored(program2, cfg);
   const gasPolicyId = options.gasPolicyIdOverride ?? resolveGasPolicyId(program2, cfg);
@@ -5152,7 +5146,9 @@ function buildWalletClient(program2, options = {}) {
         address: evmSession.evmAddress
       };
     }
-    if (!localKey) throw errWalletKeyRequired();
+    if (!localKey) {
+      throw pref === "local" ? errWalletKeyRequired() : errWalletRequired();
+    }
     const account = privateKeyToAccount2(normalizeKey(localKey));
     return {
       signer: account,
@@ -5245,10 +5241,10 @@ function registerStatus(program2, options = {}) {
     "after",
     `
 Examples:
-  alchemy evm status call-123                               EVM smart wallet operation
+  alchemy evm status call-123 -n eth-mainnet                EVM smart wallet operation
   alchemy evm status 0xTxHash... -n eth-mainnet             Raw EVM transaction
   alchemy solana status 5wHu1qwD7q... -n solana-devnet      Solana transaction
-  echo "call-123" | alchemy evm status
+  echo "call-123" | alchemy evm status -n eth-mainnet
 
 Tip: use an EVM network for operation IDs and tx hashes, or a Solana network for signatures.`
   ).action(async (idArg) => {
@@ -6236,10 +6232,8 @@ var ERROR_RECOVERY = {
   AUTH_REQUIRED: "Set ALCHEMY_API_KEY env var or run: alchemy config set app",
   INVALID_API_KEY: "Check your API key and select a valid app: alchemy config set app",
   NETWORK_NOT_ENABLED: "Enable the target network for your app at dashboard.alchemy.com",
-  INVALID_ACCESS_KEY: "Check your access key: https://dashboard.alchemy.com/",
-  ACCESS_KEY_REQUIRED: "Set ALCHEMY_ACCESS_KEY env var or run: alchemy config set access-key <key>",
   APP_REQUIRED: "Select an app: alchemy config set app <app-id>",
-  ADMIN_API_ERROR: "Check the error message for details; verify access key permissions",
+  ADMIN_API_ERROR: "Check the error message for details; verify account permissions",
   NETWORK_ERROR: "Check internet connection and retry",
   RPC_ERROR: "Check RPC method, params, and network; verify API key has access",
   INVALID_ARGS: "Check command usage via: alchemy --json help <command>",
@@ -6355,11 +6349,10 @@ function buildAgentPrompt(program2) {
         ]
       },
       {
-        method: "Access key",
-        envVar: "ALCHEMY_ACCESS_KEY",
-        configKey: "access-key",
-        commandFamilies: ["app", "evm network"],
-        notes: "No command-line flag exists for access-key auth; use the env var or saved config."
+        method: "Alchemy login",
+        setup: "alchemy auth login",
+        commandFamilies: ["app", "evm network", "gas-manager"],
+        notes: "Admin surfaces use the browser login session stored by `alchemy auth login`."
       },
       {
         method: "Webhook API key",
@@ -6416,15 +6409,15 @@ function buildAgentPrompt(program2) {
     examples: [
       "alchemy --json --no-interactive config status",
       "alchemy --json --no-interactive update-check",
-      "alchemy --json --no-interactive evm data balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --api-key $ALCHEMY_API_KEY",
-      "ALCHEMY_ACCESS_KEY=ak_xxx alchemy --json --no-interactive app list",
-      "alchemy --json --no-interactive evm rpc eth_blockNumber --api-key $ALCHEMY_API_KEY",
+      "alchemy --json --no-interactive evm data balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --api-key $ALCHEMY_API_KEY -n eth-mainnet",
+      "alchemy --json --no-interactive app list",
+      "alchemy --json --no-interactive evm rpc eth_blockNumber --api-key $ALCHEMY_API_KEY -n eth-mainnet",
       "alchemy --json --no-interactive evm network list",
       "alchemy --json --no-interactive evm send 0xRecipient 0.001 --dry-run -n eth-sepolia",
       `alchemy --json --no-interactive evm contract read 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 "balanceOf(address)(uint256)" --args '["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"]' -n eth-mainnet`,
       "alchemy --json --no-interactive evm swap quote --from 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE --to 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --amount 1.0 --from-address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -n eth-mainnet",
-      "alchemy --json --no-interactive evm logs --from-block latest --limit 25",
-      "alchemy --json --no-interactive evm block latest --summary",
+      "alchemy --json --no-interactive evm logs --from-block latest --limit 25 -n eth-mainnet",
+      "alchemy --json --no-interactive evm block latest --summary -n eth-mainnet",
       "alchemy --json --no-interactive evm status 0xCallId -n eth-mainnet"
     ],
     docs: "https://www.alchemy.com/docs"
@@ -6460,7 +6453,9 @@ function formatAsSystemPrompt(payload) {
   lines.push("Auth methods:");
   for (const auth of payload.auth) {
     lines.push(`  ${auth.method}:`);
-    lines.push(`    env:      ${auth.envVar}`);
+    if (auth.envVar) {
+      lines.push(`    env:      ${auth.envVar}`);
+    }
     if (auth.flag) {
       lines.push(`    flag:     ${auth.flag}`);
     }
@@ -6744,11 +6739,11 @@ function registerApprove(program2) {
     "after",
     `
 Examples:
-  alchemy evm approve 0xRouter --token-address 0xUSDC --amount 100
-  alchemy evm approve 0xRouter --token-address 0xUSDC --amount 100 --reset-first
-  alchemy evm approve 0xRouter --token-address 0xUSDC --unlimited
-  alchemy evm approve 0xRouter --token-address 0xUSDC --unlimited --yes
-  alchemy evm approve 0xRouter --token-address 0xUSDC --revoke`
+  alchemy evm approve 0xRouter --token-address 0xUSDC --amount 100 -n eth-mainnet
+  alchemy evm approve 0xRouter --token-address 0xUSDC --amount 100 --reset-first -n eth-mainnet
+  alchemy evm approve 0xRouter --token-address 0xUSDC --unlimited -n eth-mainnet
+  alchemy evm approve 0xRouter --token-address 0xUSDC --unlimited --yes -n eth-mainnet
+  alchemy evm approve 0xRouter --token-address 0xUSDC --revoke -n eth-mainnet`
   ).action(async (spenderArg, _opts, cmd) => {
     try {
       await performApprove(cmd, spenderArg, cmd.opts());
@@ -6770,8 +6765,8 @@ async function performApprove(program2, spenderArg, opts) {
     signer,
     ...gasPolicyIdOverride && { gasPolicyIdOverride }
   });
-  const rpcClient = clientFromFlags(program2);
-  const tokenMeta = await fetchTokenDecimals(program2, opts.tokenAddress);
+  const rpcClient = apiKeyClientFromFlags(program2, { forceNetwork: network });
+  const tokenMeta = await fetchTokenDecimals(program2, opts.tokenAddress, { network });
   const approval = buildApprovalRequest(opts, tokenMeta);
   if (!await confirmUnlimitedApproval(program2, tokenMeta.symbol, spenderArg, opts)) {
     return;
@@ -6887,9 +6882,9 @@ function registerBlock(program2) {
     "after",
     `
 Examples:
-  alchemy evm block latest
-  alchemy evm block 17000000
-  alchemy evm block 0x1`
+  alchemy evm block latest -n eth-mainnet
+  alchemy evm block 17000000 -n eth-mainnet
+  alchemy evm block 0x1 -n eth-mainnet`
   ).action(async (blockId, opts) => {
     try {
       let blockParam;
@@ -7166,11 +7161,11 @@ function registerContract(program2) {
     "after",
     `
 Examples:
-  alchemy evm contract read 0xA0b8...USDC "balanceOf(address)(uint256)" --args '["0xHolder"]'
-  alchemy evm contract read 0xA0b8...USDC "name()(string)"
-  alchemy evm contract read 0xA0b8...USDC "decimals()(uint8)"
-  alchemy evm contract read 0xContract balanceOf --abi-file ./erc20.json --args '["0xHolder"]'
-  alchemy evm contract read 0xPool "quote((address,uint256))(uint256)" --args '[["0xToken", "1000000"]]' --block 12345678`
+  alchemy evm contract read 0xA0b8...USDC "balanceOf(address)(uint256)" --args '["0xHolder"]' -n eth-mainnet
+  alchemy evm contract read 0xA0b8...USDC "name()(string)" -n eth-mainnet
+  alchemy evm contract read 0xA0b8...USDC "decimals()(uint8)" -n eth-mainnet
+  alchemy evm contract read 0xContract balanceOf --abi-file ./erc20.json --args '["0xHolder"]' -n eth-mainnet
+  alchemy evm contract read 0xPool "quote((address,uint256))(uint256)" --args '[["0xToken", "1000000"]]' --block 12345678 -n eth-mainnet`
   ).action(async (addressArg, functionArg, opts) => {
     try {
       await performContractRead(program2, addressArg, functionArg, opts);
@@ -7184,9 +7179,9 @@ Examples:
     "after",
     `
 Examples:
-  alchemy evm contract call 0xToken "approve(address,uint256)" --args '["0xSpender", "1000000"]'
-  alchemy evm contract call 0xToken "transfer(address,uint256)" --args '["0xTo", "1000000"]'
-  alchemy evm contract call 0xContract deposit --abi-file ./contract.json --value 0.1`
+  alchemy evm contract call 0xToken "approve(address,uint256)" --args '["0xSpender", "1000000"]' -n eth-mainnet
+  alchemy evm contract call 0xToken "transfer(address,uint256)" --args '["0xTo", "1000000"]' -n eth-mainnet
+  alchemy evm contract call 0xContract deposit --abi-file ./contract.json --value 0.1 -n eth-mainnet`
   ).action(async (addressArg, functionArg, _opts, cmd2) => {
     try {
       const opts = cmd2.opts();
@@ -7250,7 +7245,7 @@ async function performContractCall(program2, addressArg, functionArg, opts) {
     signer,
     ...gasPolicyIdOverride && { gasPolicyIdOverride }
   });
-  const rpcClient = clientFromFlags(program2);
+  const rpcClient = apiKeyClientFromFlags(program2, { forceNetwork: network });
   const contractAddress = await resolveAddress(addressArg, rpcClient);
   const data = encodeFunctionData2({ abi, functionName, args });
   const value = opts.value !== void 0 ? parseEthValue(opts.value) : void 0;
@@ -7361,12 +7356,12 @@ function registerBalance(program2) {
     "after",
     `
 Examples:
-  alchemy evm data balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
+  alchemy evm data balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -n eth-mainnet
   alchemy evm data balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -n polygon-mainnet
-  echo 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 | alchemy evm data balance
-  alchemy evm data balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --block 15537393
-  alchemy evm data balance vitalik.eth
-  cat addresses.txt | alchemy evm data balance`
+  echo 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 | alchemy evm data balance -n eth-mainnet
+  alchemy evm data balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --block 15537393 -n eth-mainnet
+  alchemy evm data balance vitalik.eth -n eth-mainnet
+  cat addresses.txt | alchemy evm data balance -n eth-mainnet`
   ).option("--block <block>", "Block number, hex, or tag (default: latest)").action(async (addressArg, opts) => {
     try {
       const blockParam = resolveBlockParam2(opts?.block);
@@ -7414,10 +7409,10 @@ function registerNFTs(program2) {
     "after",
     `
 Examples:
-  alchemy evm data nfts 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
-  alchemy evm data nfts metadata --contract 0x... --token-id 1
-  alchemy evm data nfts contract 0x...
-  echo 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 | alchemy evm data nfts`
+  alchemy evm data nfts 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -n eth-mainnet
+  alchemy evm data nfts metadata --contract 0x... --token-id 1 -n eth-mainnet
+  alchemy evm data nfts contract 0x... -n eth-mainnet
+  echo 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 | alchemy evm data nfts -n eth-mainnet`
   ).action(async (addressArg, opts) => {
     try {
       const addressInput = addressArg ?? await readStdinArg("address");
@@ -7638,9 +7633,9 @@ function registerTokens(program2) {
     "after",
     `
 Examples:
-  alchemy evm data tokens balances 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
-  alchemy evm data tokens balances 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --metadata
-  echo 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 | alchemy evm data tokens balances`
+  alchemy evm data tokens balances 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -n eth-mainnet
+  alchemy evm data tokens balances 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --metadata -n eth-mainnet
+  echo 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 | alchemy evm data tokens balances -n eth-mainnet`
   ).action(async (addressArg, opts) => {
     try {
       const addressInput = addressArg ?? await readStdinArg("address");
@@ -7745,7 +7740,7 @@ Examples:
     "after",
     `
 Examples:
-  alchemy evm data tokens metadata 0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eB48`
+  alchemy evm data tokens metadata 0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eB48 -n eth-mainnet`
   ).action(async (contract) => {
     try {
       validateAddress(contract);
@@ -7816,16 +7811,16 @@ function registerTransfers(program2) {
     `
 Examples:
   # Outgoing transfers from an address
-  alchemy evm data history 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
+  alchemy evm data history 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -n eth-mainnet
 
   # Incoming transfers to an address
-  alchemy evm data history --to-address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
+  alchemy evm data history --to-address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -n eth-mainnet
 
   # Outgoing ERC-20 transfers only
-  alchemy evm data history --from-address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --category erc20
+  alchemy evm data history --from-address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --category erc20 -n eth-mainnet
 
   # Transfers within a block range
-  alchemy evm data history 0xd8dA... --from-block 0x100000 --to-block latest`
+  alchemy evm data history 0xd8dA... --from-block 0x100000 --to-block latest -n eth-mainnet`
   ).action(async (addressArg, opts) => {
     try {
       const client = clientFromFlags(program2);
@@ -8083,9 +8078,9 @@ function registerGas(program2) {
     "after",
     `
 Examples:
-  alchemy evm gas
+  alchemy evm gas -n eth-mainnet
   alchemy evm gas -n polygon-mainnet
-  alchemy evm gas --json`
+  alchemy evm gas --json -n eth-mainnet`
   ).action(async () => {
     try {
       const client = clientFromFlags(program2);
@@ -8197,10 +8192,10 @@ function registerLogs(program2) {
     "after",
     `
 Examples:
-  alchemy evm logs --from-block 18000000 --to-block 18000010
-  alchemy evm logs --address 0xdAC17F958D2ee523a2206206994597C13D831ec7 --from-block 18000000 --to-block 18000010
-  alchemy evm logs --address 0xdAC17F958D2ee523a2206206994597C13D831ec7 --topic 0xddf252ad...
-  alchemy evm logs --from-block latest --json`
+  alchemy evm logs --from-block 18000000 --to-block 18000010 -n eth-mainnet
+  alchemy evm logs --address 0xdAC17F958D2ee523a2206206994597C13D831ec7 --from-block 18000000 --to-block 18000010 -n eth-mainnet
+  alchemy evm logs --address 0xdAC17F958D2ee523a2206206994597C13D831ec7 --topic 0xddf252ad... -n eth-mainnet
+  alchemy evm logs --from-block latest --json -n eth-mainnet`
   ).option("--address <address>", "Contract address to filter logs").option("--topic <topic...>", "Event topic(s) to filter (topic0, topic1, ...)").option("--from-block <block>", "Start block (number, hex, or tag)", "latest").option("--to-block <block>", "End block (number, hex, or tag)", "latest").option("--limit <n>", "Limit returned logs in output").action(async (opts) => {
     try {
       const outputLimit = parseOptionalInt(opts.limit, "--limit");
@@ -8289,10 +8284,10 @@ function registerReceipt(program2) {
     "after",
     `
 Examples:
-  alchemy evm receipt 0xabc123...
-  echo 0xabc123... | alchemy evm receipt
+  alchemy evm receipt 0xabc123... -n eth-mainnet
+  echo 0xabc123... | alchemy evm receipt -n eth-mainnet
 
-Tip: use 'alchemy evm tx <hash>' for transaction details (value, block, nonce). Receipt provides execution results (status, gas used, logs).`
+Tip: use 'alchemy evm tx <hash> -n <net>' for transaction details (value, block, nonce). Receipt provides execution results (status, gas used, logs).`
   ).action(async (hashArg) => {
     try {
       const hash = hashArg ?? await readStdinArg("hash");
@@ -8356,9 +8351,9 @@ function registerRPC(program2) {
     "after",
     `
 Examples:
-  alchemy evm rpc eth_blockNumber
-  alchemy evm rpc eth_getBalance "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" "latest"
-  alchemy evm rpc eth_getBlockByNumber "0x1" true`
+  alchemy evm rpc eth_blockNumber -n eth-mainnet
+  alchemy evm rpc eth_getBalance "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" "latest" -n eth-mainnet
+  alchemy evm rpc eth_getBlockByNumber "0x1" true -n eth-mainnet`
   ).action(async (method, params) => {
     try {
       if (outputRpcHelp(cmd, method, params)) {
@@ -8419,13 +8414,17 @@ function registerEvmSend(program2) {
   sendCmd.option("--gas-sponsored", "Enable gas sponsorship (env: ALCHEMY_EVM_GAS_SPONSORED)").option("--gas-policy-id <id>", "Gas policy ID for sponsorship (env: ALCHEMY_EVM_GAS_POLICY_ID)").addHelpText(
     "after",
     `
+Omit --token to send the native token for the selected network.
+Network is required via -n/--network.
+
 Examples:
-  alchemy evm send 0xAbC...123 1.5                          Send 1.5 ETH
-  alchemy evm send vitalik.eth 0.1 -n base-mainnet          Send 0.1 ETH on Base
-  alchemy evm send 0xAbC...123 100 --token 0xA0b8...USDC    Send 100 USDC
-  alchemy evm send 0xAbC...123 1.5 --dry-run                Preview without signing or sending
-  alchemy evm send 0xAbC...123 1 --gas-sponsored --gas-policy-id <id>
-  alchemy evm send 0xAbC...123 1.5 --signer local           Force the local wallet`
+  alchemy evm send 0xAbC...123 1.5 -n eth-mainnet                         Send 1.5 ETH
+  alchemy evm send vitalik.eth 0.1 -n base-mainnet                         Send 0.1 ETH on Base
+  alchemy evm send 0xAbC...123 1 -n monad-testnet                          Send 1 MON
+  alchemy evm send 0xAbC...123 100 --token 0xA0b8...USDC -n eth-mainnet     Send 100 USDC
+  alchemy evm send 0xAbC...123 1.5 --dry-run -n eth-mainnet                Preview without signing or sending
+  alchemy evm send 0xAbC...123 1 -n base-mainnet --gas-sponsored --gas-policy-id <id>
+  alchemy evm send 0xAbC...123 1.5 --signer local -n eth-mainnet           Force the local wallet`
   ).action(async (toArg, amountArg, _opts, cmd) => {
     try {
       const opts = cmd.opts();
@@ -8434,7 +8433,7 @@ Examples:
         dryRun: opts.dryRun
       });
     } catch (err) {
-      const { exitWithError: exitWithError2 } = await import("./errors-YPNK3AVF.js");
+      const { exitWithError: exitWithError2 } = await import("./errors-6BEPCY5N.js");
       exitWithError2(err);
     }
   });
@@ -8443,17 +8442,25 @@ async function performEvmSend(program2, toArg, amountArg, tokenAddress, opts = {
   if (tokenAddress) {
     validateAddress(tokenAddress);
   }
-  const gasPolicyIdOverride = await ensureGasPolicyResolved(program2);
-  const { client, network, address: from, paymaster } = buildWalletClient(program2, {
+  const network = resolveRequiredNetwork(program2);
+  const gasPolicyIdOverride = await ensureGasPolicyResolved(program2, {
+    networkOverride: network
+  });
+  const { client, address: from, paymaster } = buildWalletClient(program2, {
     signer: opts.signer,
+    networkOverride: network,
     ...gasPolicyIdOverride && { gasPolicyIdOverride }
   });
-  const rpcClient = clientFromFlags(program2);
+  const rpcClient = apiKeyClientFromFlags(program2, {
+    forceNetwork: network
+  });
   const to = await resolveAddress(toArg, rpcClient);
   let decimals;
   let symbol;
   if (tokenAddress) {
-    const meta = await fetchTokenDecimals(program2, tokenAddress);
+    const meta = await fetchTokenDecimals(program2, tokenAddress, {
+      network
+    });
     decimals = meta.decimals;
     symbol = meta.symbol;
   } else {
@@ -8611,8 +8618,7 @@ import { parseAccount } from "viem/accounts";
 function buildWalletQuoteClient(program2, address3) {
   const apiKey = resolveAPIKey(program2);
   if (!apiKey) throw errAuthRequired();
-  const cfg = load();
-  const network = resolveNetwork(program2, cfg);
+  const network = resolveNetwork(program2);
   const chain = networkToChain(network);
   const client = createClient({
     account: parseAccount(address3),
@@ -8715,7 +8721,7 @@ async function resolveTokenInfo(network, program2, tokenAddress) {
     return { decimals: NATIVE_DECIMALS, symbol: nativeTokenSymbol(network) };
   }
   try {
-    return await fetchTokenDecimals(program2, tokenAddress);
+    return await fetchTokenDecimals(program2, tokenAddress, { network });
   } catch (err) {
     if (err instanceof CLIError && err.code === "INVALID_ARGS") {
       throw err;
@@ -8781,14 +8787,14 @@ function registerSwap(program2) {
   quoteCmd.addHelpText(
     "after",
     `
-Tip: use 'alchemy evm token <SYMBOL>' to resolve common token addresses
+Tip: use 'alchemy evm token <SYMBOL> -n <net>' to resolve common token addresses
 (ETH, USDC, WETH, USDT, DAI, \u2026). Example:
-  --from $(alchemy evm token ETH --address-only) \\
+  --from $(alchemy evm token ETH --address-only -n eth-mainnet) \\
   --to $(alchemy evm token USDC --address-only -n eth-mainnet)
 
 Examples:
   alchemy evm swap quote --from 0xEeee...EEeE --to 0xA0b8...USDC --amount 1.0 -n eth-mainnet
-  alchemy evm swap quote --from 0xUSDC --to 0xDAI --amount 100 --slippage 1.0`
+  alchemy evm swap quote --from 0xUSDC --to 0xDAI --amount 100 --slippage 1.0 -n eth-mainnet`
   ).action(async (opts) => {
     try {
       await performSwapQuote(program2, opts);
@@ -8801,14 +8807,14 @@ Examples:
   executeCmd.option("--gas-sponsored", "Enable gas sponsorship (env: ALCHEMY_EVM_GAS_SPONSORED)").option("--gas-policy-id <id>", "Gas policy ID for sponsorship (env: ALCHEMY_EVM_GAS_POLICY_ID)").addHelpText(
     "after",
     `
-Tip: use 'alchemy evm token <SYMBOL>' to resolve common token addresses
-(ETH, USDC, WETH, USDT, DAI, \u2026). Run 'alchemy evm token list' to discover
-known symbols on the current network.
+Tip: use 'alchemy evm token <SYMBOL> -n <net>' to resolve common token addresses
+(ETH, USDC, WETH, USDT, DAI, \u2026). Run 'alchemy evm token list -n <net>' to discover
+known symbols on that network.
 
 Examples:
   alchemy evm swap execute --from 0xEeee...EEeE --to 0xA0b8...USDC --amount 1.0 -n eth-mainnet
-  alchemy evm swap execute --from 0xUSDC --to 0xDAI --amount 100 --slippage 1.0
-  alchemy evm swap execute --from 0xEeee...EEeE --to 0xUSDC --amount 0.1 --gas-sponsored --gas-policy-id <id>`
+  alchemy evm swap execute --from 0xUSDC --to 0xDAI --amount 100 --slippage 1.0 -n eth-mainnet
+  alchemy evm swap execute --from 0xEeee...EEeE --to 0xUSDC --amount 0.1 --gas-sponsored --gas-policy-id <id> -n eth-mainnet`
   ).action(async (_opts, cmd2) => {
     try {
       const opts = cmd2.opts();
@@ -8991,20 +8997,20 @@ applicable. The native gas token (ETH, POL, BNB, AVAX, \u2026) resolves to the
 EIP-7528 native sentinel 0xEeee\u2026EEeE.
 
 Examples:
-  alchemy evm token ETH                          # uses current network
+  alchemy evm token ETH -n eth-mainnet
   alchemy evm token USDC -n base-mainnet
   alchemy evm token USDC.e -n arb-mainnet
-  alchemy evm token USDC --address-only           # prints just the 0x address
-  alchemy --json evm token USDC | jq -r .address
+  alchemy evm token USDC --address-only -n base-mainnet
+  alchemy --json evm token USDC -n base-mainnet | jq -r .address
 
-  alchemy evm token list                          # list tokens on current network
+  alchemy evm token list -n eth-mainnet
   alchemy evm token list --all                    # list tokens across all networks`
   ).action(async (symbol, opts) => {
     try {
       if (!symbol) {
         if (opts.addressOnly) {
           throw errInvalidArgs(
-            "--address-only requires a symbol. Example: alchemy evm token USDC --address-only"
+            "--address-only requires a symbol. Example: alchemy evm token USDC --address-only -n base-mainnet"
           );
         }
         await runList(program2, {});
@@ -9079,7 +9085,7 @@ async function runList(program2, opts) {
     }
     console.log(
       `
-  ${dim("Tip: pass -n/--network <net> to scope a lookup. Use 'alchemy evm token <SYMBOL>' to fetch a single address.")}`
+  ${dim("Tip: pass -n/--network <net> to scope a lookup. Use 'alchemy evm token <SYMBOL> -n <net>' to fetch a single address.")}`
     );
     return;
   }
@@ -9100,7 +9106,7 @@ async function runList(program2, opts) {
   printTokenTable(tokens);
   console.log(
     `
-  ${dim("Tip: 'alchemy evm token <SYMBOL>' resolves one symbol. Add --all to see every network.")}`
+  ${dim("Tip: 'alchemy evm token <SYMBOL> -n <net>' resolves one symbol. Add --all to see every network.")}`
   );
 }
 function printTokenTable(tokens) {
@@ -9146,10 +9152,10 @@ function registerTx(program2) {
     "after",
     `
 Examples:
-  alchemy evm tx 0xabc123...
-  echo 0xabc123... | alchemy evm tx
+  alchemy evm tx 0xabc123... -n eth-mainnet
+  echo 0xabc123... | alchemy evm tx -n eth-mainnet
 
-Tip: use 'alchemy evm receipt <hash>' to get the transaction receipt (status, gas used, logs).`
+Tip: use 'alchemy evm receipt <hash> -n <net>' to get the transaction receipt (status, gas used, logs).`
   ).action(async (hashArg) => {
     try {
       const hash = hashArg ?? await readStdinArg("hash");
@@ -9497,7 +9503,7 @@ function registerBridge(program2) {
 Source network comes from the global -n/--network flag. Use --to-network for the destination chain.
 For same-chain token exchanges, use 'alchemy evm swap'.
 
-Tip: use 'alchemy evm token <SYMBOL>' to resolve common token addresses
+Tip: use 'alchemy evm token <SYMBOL> -n <net>' to resolve common token addresses
 (ETH, USDC, WETH, USDT, DAI, \u2026) per chain.
 
 Examples:
@@ -9518,7 +9524,7 @@ Examples:
 Source network comes from the global -n/--network flag. Use --to-network for the destination chain.
 For same-chain token exchanges, use 'alchemy evm swap'.
 
-Tip: use 'alchemy evm token <SYMBOL>' to resolve common token addresses
+Tip: use 'alchemy evm token <SYMBOL> -n <net>' to resolve common token addresses
 (ETH, USDC, WETH, USDT, DAI, \u2026) per chain.
 
 Examples:
@@ -10203,11 +10209,10 @@ function doctorSetupStatus(setup) {
     ...setup,
     complete: x402OnlySetup ? false : setup.complete,
     satisfiedBy: x402OnlySetup ? null : setup.satisfiedBy,
-    missing: x402OnlySetup ? ["Provide one auth path: alchemy auth OR api-key OR ALCHEMY_ACCESS_KEY+app"] : removeX402SetupMissing(setup.missing),
+    missing: x402OnlySetup ? ["Provide one auth path: alchemy auth OR api-key"] : removeX402SetupMissing(setup.missing),
     nextCommands: x402OnlySetup ? [
       "alchemy auth",
-      "alchemy config set app",
-      "alchemy config set access-key <key> && alchemy config set app <app-id>"
+      "alchemy config set app"
     ] : removeX402NextCommands(setup.nextCommands),
     capabilities: sanitizedCapabilities
   };
@@ -10351,9 +10356,9 @@ 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.10.0", "-v, --version", "display CLI version").option("--api-key <key>", "Alchemy API key (env: ALCHEMY_API_KEY)").option(
+).version("0.11.0", "-v, --version", "display CLI version").option("--api-key <key>", "Alchemy API key (env: ALCHEMY_API_KEY)").option(
   "-n, --network <network>",
-  "Target network (default: eth-mainnet) (env: ALCHEMY_NETWORK)"
+  "Target network for networked commands"
 ).option("--x402", "Use x402 wallet-based gateway auth").option(
   "--wallet-key-file <path>",
   "Path to wallet private key file for x402"
@@ -10489,9 +10494,9 @@ ${styledLine}`;
     `${hBrand("\u25C6")} ${hBold("Quick Start")}`,
     `  ${hDim("\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")}`,
     `  ${hBrand("alchemy")}                              ${hDim("Interactive mode with guided setup")}`,
-    `  ${hBrand("alchemy evm data balance")} ${hDim("<address>")}    ${hDim("Get native token balance")}`,
-    `  ${hBrand("alchemy evm block latest")}              ${hDim("Latest block summary")}`,
-    `  ${hBrand("alchemy evm rpc eth_chainId")}           ${hDim("Raw JSON-RPC call")}`,
+    `  ${hBrand("alchemy evm data balance")} ${hDim("<address> -n eth-mainnet")} ${hDim("Get native token balance")}`,
+    `  ${hBrand("alchemy evm block latest")} ${hDim("-n eth-mainnet")}           ${hDim("Latest block summary")}`,
+    `  ${hBrand("alchemy evm rpc eth_chainId")} ${hDim("-n eth-mainnet")}        ${hDim("Raw JSON-RPC call")}`,
     `  ${hBrand("alchemy config list")}                   ${hDim("View current configuration")}`,
     "",
     `${hBrand("\u25C6")} ${hBold("Exit Codes")}`,
@@ -10538,11 +10543,11 @@ ${styledLine}`;
     "wallet"
   ];
   if (!skipAppPrompt.includes(cmdName) && isInteractiveAllowed(program) && !opts.apiKey && !process.env.ALCHEMY_API_KEY) {
-    const { resolveAuthToken: resolveAuthToken2 } = await import("./resolve-REZCFZZ7.js");
+    const { resolveAuthToken: resolveAuthToken2 } = await import("./resolve-FRMIY357.js");
     const authToken = resolveAuthToken2(cfg);
     const hasApiKey = Boolean(cfg.api_key?.trim() || cfg.app?.apiKey);
     if (authToken && !hasApiKey) {
-      const { selectAppAfterAuth } = await import("./auth-23OYLRWN.js");
+      const { selectAppAfterAuth } = await import("./auth-6X2DBBYQ.js");
       console.log("");
       console.log(`  No app selected. Please select an app to continue.`);
       await selectAppAfterAuth(authToken);
@@ -10577,7 +10582,7 @@ ${styledLine}`;
   if (isInteractiveAllowed(program)) {
     let latestForInteractiveStartup = null;
     if (shouldRunOnboarding(program, cfg)) {
-      const { runOnboarding } = await import("./onboarding-A7IOH2MX.js");
+      const { runOnboarding } = await import("./onboarding-2FLKQYLY.js");
       const latest = getAvailableUpdateOnce();
       const completed = await runOnboarding(program, latest);
       updateShownDuringInteractiveStartup = Boolean(latest);
@@ -10591,7 +10596,7 @@ ${styledLine}`;
         latestForInteractiveStartup
       );
     }
-    const { startREPL } = await import("./interactive-D34T7RI6.js");
+    const { startREPL } = await import("./interactive-EXQM6HWQ.js");
     program.exitOverride();
     program.configureOutput({
       writeErr: () => {