@alchemy/cli 0.9.3 → 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-NUSUQI7X.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";
@@ -222,11 +226,11 @@ async function resolveENS(name, client) {
   if (dataHex.length < 64) {
     throw errInvalidArgs(`ENS name "${name}" could not be resolved.`);
   }
-  const address2 = "0x" + dataHex.slice(24, 64);
-  if (address2 === "0x0000000000000000000000000000000000000000") {
+  const address3 = "0x" + dataHex.slice(24, 64);
+  if (address3 === "0x0000000000000000000000000000000000000000") {
     throw errInvalidArgs(`ENS name "${name}" is not registered or has no address set.`);
   }
-  return address2;
+  return address3;
 }
 
 // src/lib/validators.ts
@@ -267,10 +271,10 @@ async function readStdinLines(name) {
   }
   return lines;
 }
-function validateAddress(address2) {
-  if (!ADDRESS_RE.test(address2)) {
+function validateAddress(address3) {
+  if (!ADDRESS_RE.test(address3)) {
     throw errInvalidArgs(
-      `Invalid address "${address2}". Expected 0x-prefixed 40-hex-character address.`
+      `Invalid address "${address3}". Expected 0x-prefixed 40-hex-character address.`
     );
   }
 }
@@ -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)")
@@ -2034,14 +2026,14 @@ function formatWalletStatus(value) {
 function walletKeysDirPath() {
   return join(configDir(), WALLET_KEYS_DIR);
 }
-function walletKeyPath(prefix, address2) {
-  const addr = address2.trim().toLowerCase().replace(/^0x/, "").replace(/[^a-z0-9]/g, "").slice(0, ADDRESS_SLICE_LEN);
+function walletKeyPath(prefix, address3) {
+  const addr = address3.trim().toLowerCase().replace(/^0x/, "").replace(/[^a-z0-9]/g, "").slice(0, ADDRESS_SLICE_LEN);
   const addressTag = addr || "unknown";
   const fileName = `${prefix}-${addressTag}-${Date.now()}-${randomUUID().slice(0, UUID_SLICE_LEN)}.txt`;
   return join(walletKeysDirPath(), fileName);
 }
-function persistWalletKey(prefix, privateKey, address2) {
-  const keyPath = walletKeyPath(prefix, address2);
+function persistWalletKey(prefix, privateKey, address3) {
+  const keyPath = walletKeyPath(prefix, address3);
   mkdirSync(dirname(keyPath), { recursive: true, mode: 493 });
   writeFileSync(keyPath, privateKey + "\n", { mode: 384, flag: "wx" });
   return keyPath;
@@ -2152,11 +2144,11 @@ function importAndPersistWallet(path) {
   } catch {
     throw errInvalidArgs(`Could not read key file: ${path}`);
   }
-  const address2 = getEvmWalletAddress(key);
-  const keyPath = persistWalletKey("wallet-key", key, address2);
+  const address3 = getEvmWalletAddress(key);
+  const keyPath = persistWalletKey("wallet-key", key, address3);
   const cfg = load();
-  save({ ...cfg, wallet_key_file: keyPath, wallet_address: address2 });
-  return { address: address2, keyFile: keyPath };
+  save({ ...cfg, wallet_key_file: keyPath, wallet_address: address3 });
+  return { address: address3, keyFile: keyPath };
 }
 function hasValidSessionWithEvm() {
   const session = resolveWalletSession();
@@ -2596,21 +2588,20 @@ async function runConnectFlow(program2, opts) {
   }
   if (!mode) {
     if (!isInteractiveAllowed(program2)) {
-      throw errInvalidArgs(
-        "Specify `--mode <session|local>` in non-interactive mode."
-      );
+      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;
     }
-    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;
   }
   if (mode === "session") {
     await runSessionConnect({
@@ -3312,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) {
@@ -3329,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")}`
       );
@@ -3349,7 +3342,7 @@ function registerNetwork(program2) {
         printJSON({
           mode: "all",
           networks: display,
-          currentNetwork: current
+          currentNetwork: current ?? null
         });
       }
     } catch (err) {
@@ -3401,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
   );
@@ -4127,15 +4120,176 @@ function printAccountSummary(args) {
 
 // src/commands/send-solana.ts
 import { address as solAddress2 } from "@solana/kit";
+
+// src/lib/solana-token.ts
+import {
+  AccountRole as AccountRole2,
+  address as address2,
+  getAddressEncoder,
+  getProgramDerivedAddress
+} from "@solana/kit";
+var SPL_TOKEN_PROGRAM_ADDRESS2 = address2("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
+var SPL_TOKEN_2022_PROGRAM_ADDRESS = address2("TokenzQdBNbLqP5VEhdkAS6EPYdWnYARjfkM8GoyZ2G");
+var ASSOCIATED_TOKEN_PROGRAM_ADDRESS = address2("ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL");
+var SYSTEM_PROGRAM_ADDRESS2 = address2("11111111111111111111111111111111");
+var SUPPORTED_TOKEN_PROGRAMS = /* @__PURE__ */ new Set([
+  SPL_TOKEN_PROGRAM_ADDRESS2,
+  SPL_TOKEN_2022_PROGRAM_ADDRESS
+]);
+async function deriveAssociatedTokenAccount(args) {
+  const addressEncoder = getAddressEncoder();
+  const [associatedTokenAccount] = await getProgramDerivedAddress({
+    programAddress: ASSOCIATED_TOKEN_PROGRAM_ADDRESS,
+    seeds: [
+      addressEncoder.encode(args.owner),
+      addressEncoder.encode(args.tokenProgramAddress),
+      addressEncoder.encode(args.mint)
+    ]
+  });
+  return associatedTokenAccount;
+}
+async function fetchSplMintInfo(client, mint) {
+  const account = await fetchParsedAccount(client, mint);
+  if (!account) {
+    throw errInvalidArgs(`SPL token mint ${mint} was not found on this network.`);
+  }
+  const tokenProgramAddress = address2(account.owner);
+  assertSupportedTokenProgram(tokenProgramAddress);
+  const data = parseAccountData(account.data);
+  const decimals = data?.parsed?.info?.decimals;
+  if (typeof decimals !== "number" || !Number.isInteger(decimals) || decimals < 0 || decimals > 255) {
+    throw errInvalidArgs(`Could not read decimals for SPL token mint ${mint}.`);
+  }
+  return {
+    mint,
+    decimals,
+    tokenProgramAddress
+  };
+}
+async function fetchSplTokenAccountInfo(client, tokenAccount) {
+  const account = await fetchParsedAccount(client, tokenAccount);
+  if (!account) return null;
+  const tokenProgramAddress = address2(account.owner);
+  assertSupportedTokenProgram(tokenProgramAddress);
+  const data = parseAccountData(account.data);
+  const info = data?.parsed?.info;
+  if (!info || data?.parsed?.type !== "account") {
+    throw errInvalidArgs(`Account ${tokenAccount} is not an SPL token account.`);
+  }
+  const mint = readAddressField(info, "mint", `Account ${tokenAccount} is missing token mint metadata.`);
+  const owner = readAddressField(info, "owner", `Account ${tokenAccount} is missing token owner metadata.`);
+  return {
+    address: tokenAccount,
+    mint,
+    owner,
+    tokenProgramAddress
+  };
+}
+function buildCreateAssociatedTokenAccountIdempotentInstruction(args) {
+  return {
+    programAddress: ASSOCIATED_TOKEN_PROGRAM_ADDRESS,
+    accounts: [
+      { address: args.payer.address, role: AccountRole2.WRITABLE_SIGNER },
+      { address: args.associatedTokenAccount, role: AccountRole2.WRITABLE },
+      { address: args.owner, role: AccountRole2.READONLY },
+      { address: args.mint, role: AccountRole2.READONLY },
+      { address: SYSTEM_PROGRAM_ADDRESS2, role: AccountRole2.READONLY },
+      { address: args.tokenProgramAddress, role: AccountRole2.READONLY }
+    ],
+    data: new Uint8Array([1])
+  };
+}
+function buildSplTokenTransferCheckedInstruction(args) {
+  if (!Number.isInteger(args.decimals) || args.decimals < 0 || args.decimals > 255) {
+    throw errInvalidArgs("Token decimals must be an integer between 0 and 255.");
+  }
+  return {
+    programAddress: args.tokenProgramAddress,
+    accounts: [
+      { address: args.sourceTokenAccount, role: AccountRole2.WRITABLE },
+      { address: args.mint, role: AccountRole2.READONLY },
+      { address: args.destinationTokenAccount, role: AccountRole2.WRITABLE },
+      { address: args.owner.address, role: AccountRole2.READONLY_SIGNER }
+    ],
+    data: new Uint8Array([
+      12,
+      ...encodeU64LE2(args.amount),
+      args.decimals
+    ])
+  };
+}
+function assertTokenAccountMatches(args) {
+  if (args.account.mint !== args.expectedMint) {
+    throw errInvalidArgs(
+      `${args.label} ${args.account.address} is for mint ${args.account.mint}, expected ${args.expectedMint}.`
+    );
+  }
+  if (args.expectedOwner && args.account.owner !== args.expectedOwner) {
+    throw errInvalidArgs(
+      `${args.label} ${args.account.address} is owned by ${args.account.owner}, expected ${args.expectedOwner}.`
+    );
+  }
+}
+function assertSupportedTokenProgram(tokenProgramAddress) {
+  if (!SUPPORTED_TOKEN_PROGRAMS.has(tokenProgramAddress)) {
+    throw errInvalidArgs(
+      `Unsupported Solana token program ${tokenProgramAddress}. Only SPL Token and Token-2022 mints are supported.`
+    );
+  }
+}
+async function fetchParsedAccount(client, accountAddress) {
+  const result = await client.call("getAccountInfo", [
+    accountAddress,
+    { encoding: "jsonParsed" }
+  ]);
+  return result.value;
+}
+function parseAccountData(data) {
+  if (!data || typeof data !== "object" || Array.isArray(data)) return null;
+  return data;
+}
+function readAddressField(info, field, errorMessage) {
+  const value = info[field];
+  if (typeof value !== "string") {
+    throw errInvalidArgs(errorMessage);
+  }
+  return address2(value);
+}
+function encodeU64LE2(value) {
+  if (value < 0n || value > 0xffffffffffffffffn) {
+    throw errInvalidArgs("Amount must fit in an unsigned 64-bit integer.");
+  }
+  const bytes = new Uint8Array(8);
+  let remaining = value;
+  for (let i = 0; i < bytes.length; i++) {
+    bytes[i] = Number(remaining & 0xffn);
+    remaining >>= 8n;
+  }
+  return bytes;
+}
+
+// src/commands/send-solana.ts
 function registerSolanaSend(program2) {
-  const sendCmd = program2.command("send <to> <amount>").description("Send SOL to an address").option("--token <address>", "SPL token contract address (not yet supported)").option("--fee-sponsored", "Enable Solana fee sponsorship").option("--fee-policy-id <id>", "Solana fee policy ID for sponsorship");
+  const sendCmd = program2.command("send <to> <amount>").description("Send SOL or SPL tokens to an address").option("--token <mint>", "SPL token mint address (omit for native SOL)").option("--dry-run", "Preview transaction without signing or sending").option("--fail-if-associated-token-account-missing", "Fail if the recipient associated token account is missing").option("--from-token-account <address>", "Source SPL token account (defaults to sender associated token account)").option("--recipient-token-account <address>", "Destination SPL token account (defaults to recipient associated token account)").option("--fee-sponsored", "Enable Solana fee sponsorship").option("--fee-policy-id <id>", "Solana fee policy ID for sponsorship").addHelpText(
+    "after",
+    `
+Examples:
+  alchemy solana send <pubkey> 0.1
+  alchemy solana send <pubkey> 10 --token <mint>
+  alchemy solana send <pubkey> 10 --token <mint> --dry-run
+  alchemy solana send <pubkey> 10 --token <mint> --fail-if-associated-token-account-missing`
+  );
   addSignerOption(sendCmd);
   sendCmd.action(
     async (toArg, amountArg, _opts, actionCommand) => {
       try {
         const opts = actionCommand.opts();
         await performSolanaSend(actionCommand, toArg, amountArg, opts.token, {
-          signer: parseSignerOpt(opts.signer)
+          signer: parseSignerOpt(opts.signer),
+          dryRun: opts.dryRun,
+          failIfAssociatedTokenAccountMissing: opts.failIfAssociatedTokenAccountMissing,
+          fromTokenAccount: opts.fromTokenAccount,
+          recipientTokenAccount: opts.recipientTokenAccount
         });
       } catch (err) {
         exitWithError(err);
@@ -4144,75 +4298,378 @@ function registerSolanaSend(program2) {
   );
 }
 async function performSolanaSend(program2, toArg, amountArg, tokenAddress, opts = {}) {
-  if (tokenAddress) {
-    throw errInvalidArgs("SPL token transfers are not yet supported. Omit --token for native SOL transfers.");
-  }
+  validateSolanaTokenOptions(tokenAddress, opts);
   const signer = await resolveSolanaSigner(program2, opts.signer);
   validateSolanaAddress(toArg);
   const to = solAddress2(toArg);
   const network = resolveSolanaNetwork(program2);
-  const symbol = nativeTokenSymbol(network);
-  const lamports = parseAmount(amountArg, SOL_DECIMALS);
-  const instruction = buildSolTransferInstruction(
-    { address: solAddress2(signer.address) },
+  const { sponsored, feePolicyId } = await resolveSolanaFeeSponsorship(program2);
+  const client = clientFromFlags(program2, { forceNetwork: network });
+  if (tokenAddress) {
+    await performSplTokenSend({
+      client,
+      signer,
+      to,
+      toArg,
+      amountArg,
+      tokenAddress,
+      network,
+      sponsored,
+      feePolicyId,
+      opts
+    });
+    return;
+  }
+  await performNativeSolSend({
+    client,
+    signer,
     to,
+    toArg,
+    amountArg,
+    network,
+    sponsored,
+    feePolicyId,
+    dryRun: opts.dryRun
+  });
+}
+async function performNativeSolSend(args) {
+  const symbol = nativeTokenSymbol(args.network);
+  const lamports = parseAmount(args.amountArg, SOL_DECIMALS);
+  const instruction = buildSolTransferInstruction(
+    { address: solAddress2(args.signer.address) },
+    args.to,
     lamports
   );
-  const { sponsored, feePolicyId } = await resolveSolanaFeeSponsorship(program2);
-  const client = clientFromFlags(program2, { forceNetwork: network });
+  if (args.dryRun) {
+    printNativeDryRun({
+      from: args.signer.address,
+      to: args.toArg,
+      amount: args.amountArg,
+      symbol,
+      network: args.network,
+      sponsored: args.sponsored
+    });
+    return;
+  }
   const result = await withSpinner(
     "Sending transaction\u2026",
     "Transaction submitted",
     async () => {
-      if (signer.type === "session") {
+      if (args.signer.type === "session") {
         return await buildAndSendSolanaTransactionWithSession({
-          client,
+          client: args.client,
           instructions: [instruction],
-          session: signer.session,
-          authToken: signer.authToken,
-          sponsored,
-          gasPolicyId: feePolicyId
+          session: args.signer.session,
+          authToken: args.signer.authToken,
+          sponsored: args.sponsored,
+          gasPolicyId: args.feePolicyId
         });
       }
       return await buildAndSendSolanaTransaction({
-        client,
+        client: args.client,
         instructions: [instruction],
-        senderKeyBytes: signer.keyBytes,
-        sponsored,
-        gasPolicyId: feePolicyId
+        senderKeyBytes: args.signer.keyBytes,
+        sponsored: args.sponsored,
+        gasPolicyId: args.feePolicyId
       });
     }
   );
   const confirmed = await withSpinner(
     "Waiting for confirmation\u2026",
     "Confirmation status received",
-    () => waitForSolanaConfirmation(client, result.signature)
+    () => waitForSolanaConfirmation(args.client, result.signature)
+  );
+  printNativeResult({
+    result,
+    to: args.toArg,
+    amount: args.amountArg,
+    symbol,
+    network: args.network,
+    sponsored: args.sponsored,
+    status: confirmed ? "confirmed" : "pending"
+  });
+}
+function validateSolanaTokenOptions(tokenAddress, opts) {
+  if (tokenAddress) return;
+  const splOnlyFlags = [
+    opts.fromTokenAccount ? "--from-token-account" : void 0,
+    opts.recipientTokenAccount ? "--recipient-token-account" : void 0,
+    opts.failIfAssociatedTokenAccountMissing ? "--fail-if-associated-token-account-missing" : void 0
+  ].filter((flag) => flag !== void 0);
+  if (splOnlyFlags.length === 0) return;
+  throw errInvalidArgs(
+    `${splOnlyFlags.join(", ")} ${splOnlyFlags.length === 1 ? "requires" : "require"} --token <mint>.`
+  );
+}
+async function performSplTokenSend(args) {
+  validateSolanaAddress(args.tokenAddress);
+  if (args.opts.fromTokenAccount) validateSolanaAddress(args.opts.fromTokenAccount);
+  if (args.opts.recipientTokenAccount) validateSolanaAddress(args.opts.recipientTokenAccount);
+  const mint = solAddress2(args.tokenAddress);
+  const owner = solAddress2(args.signer.address);
+  const mintInfo = await fetchSplMintInfo(args.client, mint);
+  const amount = parseAmount(args.amountArg, mintInfo.decimals);
+  const plan = await buildSplSendPlan({
+    client: args.client,
+    owner,
+    recipient: args.to,
+    mint,
+    amount,
+    decimals: mintInfo.decimals,
+    tokenProgramAddress: mintInfo.tokenProgramAddress,
+    failIfAssociatedTokenAccountMissing: Boolean(args.opts.failIfAssociatedTokenAccountMissing),
+    fromTokenAccount: args.opts.fromTokenAccount ? solAddress2(args.opts.fromTokenAccount) : void 0,
+    recipientTokenAccount: args.opts.recipientTokenAccount ? solAddress2(args.opts.recipientTokenAccount) : void 0
+  });
+  if (args.opts.dryRun) {
+    printSplDryRun({
+      from: args.signer.address,
+      to: args.toArg,
+      amount: args.amountArg,
+      network: args.network,
+      sponsored: args.sponsored,
+      plan
+    });
+    return;
+  }
+  const result = await submitSolanaInstructions({
+    client: args.client,
+    signer: args.signer,
+    instructions: plan.instructions,
+    sponsored: args.sponsored,
+    feePolicyId: args.feePolicyId
+  });
+  const confirmed = await withSpinner(
+    "Waiting for confirmation\u2026",
+    "Confirmation status received",
+    () => waitForSolanaConfirmation(args.client, result.signature)
   );
+  printSplResult({
+    result,
+    to: args.toArg,
+    amount: args.amountArg,
+    network: args.network,
+    sponsored: args.sponsored,
+    plan,
+    status: confirmed ? "confirmed" : "pending"
+  });
+}
+async function buildSplSendPlan(args) {
+  const sourceTokenAccount = args.fromTokenAccount ?? await deriveAssociatedTokenAccount({
+    owner: args.owner,
+    mint: args.mint,
+    tokenProgramAddress: args.tokenProgramAddress
+  });
+  const sourceAccount = await fetchSplTokenAccountInfo(args.client, sourceTokenAccount);
+  if (!sourceAccount) {
+    throw errInvalidArgs(
+      `Source token account ${sourceTokenAccount} was not found. Fund the sender's associated token account for mint ${args.mint} and retry.`
+    );
+  }
+  assertTokenAccountMatches({
+    account: sourceAccount,
+    expectedMint: args.mint,
+    expectedOwner: args.owner,
+    label: "Source token account"
+  });
+  const destinationTokenAccount = args.recipientTokenAccount ?? await deriveAssociatedTokenAccount({
+    owner: args.recipient,
+    mint: args.mint,
+    tokenProgramAddress: args.tokenProgramAddress
+  });
+  const destinationAccount = await fetchSplTokenAccountInfo(args.client, destinationTokenAccount);
+  const createDestinationTokenAccount = !destinationAccount && !args.recipientTokenAccount && !args.failIfAssociatedTokenAccountMissing;
+  if (!destinationAccount && args.recipientTokenAccount) {
+    throw errInvalidArgs(`Recipient token account ${destinationTokenAccount} was not found.`);
+  }
+  if (!destinationAccount && args.failIfAssociatedTokenAccountMissing) {
+    throw errInvalidArgs(
+      `Recipient associated token account ${destinationTokenAccount} does not exist. Omit --fail-if-associated-token-account-missing to create it automatically.`
+    );
+  }
+  if (destinationAccount) {
+    assertTokenAccountMatches({
+      account: destinationAccount,
+      expectedMint: args.mint,
+      ...args.recipientTokenAccount ? {} : { expectedOwner: args.recipient },
+      label: "Recipient token account"
+    });
+  }
+  const instructions = [];
+  if (createDestinationTokenAccount) {
+    instructions.push(buildCreateAssociatedTokenAccountIdempotentInstruction({
+      payer: { address: args.owner },
+      associatedTokenAccount: destinationTokenAccount,
+      owner: args.recipient,
+      mint: args.mint,
+      tokenProgramAddress: args.tokenProgramAddress
+    }));
+  }
+  instructions.push(buildSplTokenTransferCheckedInstruction({
+    sourceTokenAccount,
+    mint: args.mint,
+    destinationTokenAccount,
+    owner: { address: args.owner },
+    amount: args.amount,
+    decimals: args.decimals,
+    tokenProgramAddress: args.tokenProgramAddress
+  }));
+  return {
+    instructions,
+    mint: args.mint,
+    tokenProgramAddress: args.tokenProgramAddress,
+    sourceTokenAccount,
+    destinationTokenAccount,
+    createdDestinationTokenAccount: createDestinationTokenAccount,
+    decimals: args.decimals
+  };
+}
+async function submitSolanaInstructions(args) {
+  const result = await withSpinner(
+    "Sending transaction\u2026",
+    "Transaction submitted",
+    async () => {
+      if (args.signer.type === "session") {
+        return await buildAndSendSolanaTransactionWithSession({
+          client: args.client,
+          instructions: args.instructions,
+          session: args.signer.session,
+          authToken: args.signer.authToken,
+          sponsored: args.sponsored,
+          gasPolicyId: args.feePolicyId
+        });
+      }
+      return await buildAndSendSolanaTransaction({
+        client: args.client,
+        instructions: args.instructions,
+        senderKeyBytes: args.signer.keyBytes,
+        sponsored: args.sponsored,
+        gasPolicyId: args.feePolicyId
+      });
+    }
+  );
+  return result;
+}
+function printNativeDryRun(args) {
   if (isJSONMode()) {
     printJSON({
-      from: result.fromAddress,
-      to: toArg,
-      amount: amountArg,
-      token: symbol,
-      network,
-      sponsored,
-      signature: result.signature,
-      status: confirmed ? "confirmed" : "pending"
+      dryRun: true,
+      action: "solana-send",
+      from: args.from,
+      to: args.to,
+      amount: args.amount,
+      token: args.symbol,
+      network: args.network,
+      sponsored: args.sponsored,
+      instructions: ["transferSol"]
     });
-  } else {
-    const pairs = [
-      ["From", result.fromAddress],
-      ["To", toArg],
-      ["Amount", green(`${amountArg} ${symbol}`)],
-      ["Network", network]
-    ];
-    if (sponsored) {
-      pairs.push(["Fee", green("Sponsored")]);
-    }
-    pairs.push(["Signature", result.signature]);
-    pairs.push(["Status", confirmed ? `${successBadge()} ${green("Confirmed")}` : "Pending"]);
-    printKeyValue(pairs);
+    return;
+  }
+  const pairs = [
+    ["Dry Run", "yes"],
+    ["From", args.from],
+    ["To", args.to],
+    ["Amount", green(`${args.amount} ${args.symbol}`)],
+    ["Network", args.network],
+    ["Instructions", "transferSol"]
+  ];
+  if (args.sponsored) pairs.push(["Fee", green("Sponsored")]);
+  printKeyValue(pairs);
+}
+function printNativeResult(args) {
+  if (isJSONMode()) {
+    printJSON({
+      from: args.result.fromAddress,
+      to: args.to,
+      amount: args.amount,
+      token: args.symbol,
+      network: args.network,
+      sponsored: args.sponsored,
+      signature: args.result.signature,
+      status: args.status
+    });
+    return;
   }
+  const pairs = [
+    ["From", args.result.fromAddress],
+    ["To", args.to],
+    ["Amount", green(`${args.amount} ${args.symbol}`)],
+    ["Network", args.network]
+  ];
+  if (args.sponsored) pairs.push(["Fee", green("Sponsored")]);
+  pairs.push(["Signature", args.result.signature]);
+  pairs.push(["Status", args.status === "confirmed" ? `${successBadge()} ${green("Confirmed")}` : "Pending"]);
+  printKeyValue(pairs);
+}
+function printSplDryRun(args) {
+  const instructions = args.plan.createdDestinationTokenAccount ? ["createAssociatedTokenAccountIdempotent", "transferChecked"] : ["transferChecked"];
+  if (isJSONMode()) {
+    printJSON({
+      dryRun: true,
+      action: "solana-send",
+      from: args.from,
+      to: args.to,
+      amount: args.amount,
+      token: args.plan.mint,
+      tokenAddress: args.plan.mint,
+      network: args.network,
+      sponsored: args.sponsored,
+      tokenProgramAddress: args.plan.tokenProgramAddress,
+      sourceTokenAccount: args.plan.sourceTokenAccount,
+      destinationTokenAccount: args.plan.destinationTokenAccount,
+      createdDestinationTokenAccount: args.plan.createdDestinationTokenAccount,
+      instructions
+    });
+    return;
+  }
+  const pairs = [
+    ["Dry Run", "yes"],
+    ["From", args.from],
+    ["To", args.to],
+    ["Amount", green(`${args.amount} ${args.plan.mint}`)],
+    ["Mint", args.plan.mint],
+    ["Source Token Account", args.plan.sourceTokenAccount],
+    ["Destination Token Account", args.plan.destinationTokenAccount],
+    ["Created Destination Token Account", args.plan.createdDestinationTokenAccount ? "yes" : "no"],
+    ["Network", args.network],
+    ["Instructions", instructions.join(", ")]
+  ];
+  if (args.sponsored) pairs.push(["Fee", green("Sponsored")]);
+  printKeyValue(pairs);
+}
+function printSplResult(args) {
+  if (isJSONMode()) {
+    printJSON({
+      from: args.result.fromAddress,
+      to: args.to,
+      amount: args.amount,
+      token: args.plan.mint,
+      tokenAddress: args.plan.mint,
+      network: args.network,
+      sponsored: args.sponsored,
+      tokenProgramAddress: args.plan.tokenProgramAddress,
+      sourceTokenAccount: args.plan.sourceTokenAccount,
+      destinationTokenAccount: args.plan.destinationTokenAccount,
+      createdDestinationTokenAccount: args.plan.createdDestinationTokenAccount,
+      signature: args.result.signature,
+      status: args.status
+    });
+    return;
+  }
+  const pairs = [
+    ["From", args.result.fromAddress],
+    ["To", args.to],
+    ["Amount", green(`${args.amount} ${args.plan.mint}`)],
+    ["Mint", args.plan.mint],
+    ["Source Token Account", args.plan.sourceTokenAccount],
+    ["Destination Token Account", args.plan.destinationTokenAccount],
+    ["Created Destination Token Account", args.plan.createdDestinationTokenAccount ? "yes" : "no"],
+    ["Network", args.network]
+  ];
+  if (args.sponsored) pairs.push(["Fee", green("Sponsored")]);
+  pairs.push(["Signature", args.result.signature]);
+  pairs.push(["Status", args.status === "confirmed" ? `${successBadge()} ${green("Confirmed")}` : "Pending"]);
+  printKeyValue(pairs);
 }
 async function resolveSolanaSigner(program2, signer) {
   if (signer === "session") {
@@ -4466,9 +4923,9 @@ async function debugRecoveredTypedDataAddress(args) {
 }
 function createDelegatedAccount(args) {
   const sessionBinding = buildSessionBindingInput(args.session);
-  const address2 = args.session.evmAddress;
+  const address3 = args.session.evmAddress;
   return toAccount({
-    address: address2,
+    address: address3,
     async signTransaction() {
       throw errInvalidArgs(
         "Delegated signer does not support direct transaction signing. Use wallet commands that execute through Alchemy smart wallets."
@@ -4499,7 +4956,7 @@ function createDelegatedAccount(args) {
         message: remoteMessage.message,
         encoding: remoteMessage.encoding,
         signature: signedMessage,
-        expectedAddress: address2
+        expectedAddress: address3
       });
       return signedMessage;
     },
@@ -4535,7 +4992,7 @@ function createDelegatedAccount(args) {
       await debugRecoveredTypedDataAddress({
         typedData: serializedTypedData,
         signature: typedDataSignature,
-        expectedAddress: address2
+        expectedAddress: address3
       });
       return typedDataSignature;
     },
@@ -4581,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);
@@ -4592,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,
@@ -4647,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);
@@ -4689,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,
@@ -4782,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) => {
@@ -5773,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>",
@@ -5892,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",
@@ -5953,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"
@@ -5997,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}`);
     }
@@ -6174,8 +6632,8 @@ function registrySymbolSuggestions(network) {
 }
 
 // src/commands/approve.ts
-function isNativeToken(address2) {
-  return address2.toLowerCase() === NATIVE_TOKEN_ADDRESS.toLowerCase();
+function isNativeToken(address3) {
+  return address3.toLowerCase() === NATIVE_TOKEN_ADDRESS.toLowerCase();
 }
 function buildApprovalRequest(opts, tokenMeta) {
   validateApprovalMode(opts);
@@ -6281,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());
@@ -6307,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;
@@ -6424,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;
@@ -6703,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);
@@ -6721,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();
@@ -6787,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;
@@ -6847,18 +7305,18 @@ async function performContractCall(program2, addressArg, functionArg, opts) {
 // src/commands/balance.ts
 async function fetchBalance(program2, addressInput, blockParam) {
   const client = clientFromFlags(program2);
-  const address2 = await resolveAddress(addressInput, client);
+  const address3 = await resolveAddress(addressInput, client);
   const result = await withSpinner(
     "Fetching balance\u2026",
     "Balance fetched",
-    () => client.call("eth_getBalance", [address2, blockParam])
+    () => client.call("eth_getBalance", [address3, blockParam])
   );
   const wei = BigInt(result);
   const network = resolveNetwork(program2);
   const symbol = nativeTokenSymbol(network);
   if (isJSONMode()) {
     printJSON({
-      address: address2,
+      address: address3,
       wei: wei.toString(),
       balance: weiToEth(wei),
       symbol,
@@ -6866,7 +7324,7 @@ async function fetchBalance(program2, addressInput, blockParam) {
     });
   } else {
     printKeyValue([
-      ["Address", address2],
+      ["Address", address3],
       ["Balance", green(`${weiToEth(wei)} ${symbol}`)],
       ["Network", network]
     ]);
@@ -6874,7 +7332,7 @@ async function fetchBalance(program2, addressInput, blockParam) {
       console.log("");
       printJSON({
         rpcMethod: "eth_getBalance",
-        rpcParams: [address2, blockParam],
+        rpcParams: [address3, blockParam],
         rpcResult: result
       });
     }
@@ -6898,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);
@@ -6951,17 +7409,17 @@ 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");
       const client = clientFromFlags(program2);
-      const address2 = await resolveAddress(addressInput, client);
+      const address3 = await resolveAddress(addressInput, client);
       const params = {
-        owner: address2,
+        owner: address3,
         withMetadata: "true"
       };
       if (opts.limit) params.pageSize = String(opts.limit);
@@ -6995,7 +7453,7 @@ Examples:
           break;
         }
         const nextParams = {
-          owner: address2,
+          owner: address3,
           withMetadata: "true",
           pageKey
         };
@@ -7037,15 +7495,15 @@ Examples:
       exitWithError(err);
     }
   });
-  cmd.command("contract <address>").description("Get NFT contract metadata").action(async (address2) => {
+  cmd.command("contract <address>").description("Get NFT contract metadata").action(async (address3) => {
     try {
-      validateAddress(address2);
+      validateAddress(address3);
       const client = clientFromFlags(program2);
       const result = await withSpinner(
         "Fetching contract metadata\u2026",
         "Contract metadata fetched",
         () => client.callEnhanced("getContractMetadata", {
-          contractAddress: address2
+          contractAddress: address3
         })
       );
       if (isJSONMode()) printJSON(result);
@@ -7175,15 +7633,15 @@ 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");
       const client = clientFromFlags(program2);
-      const address2 = await resolveAddress(addressInput, client);
-      const params = [address2];
+      const address3 = await resolveAddress(addressInput, client);
+      const params = [address3];
       if (opts.pageKey) {
         params.push("erc20", { pageKey: opts.pageKey });
       }
@@ -7220,7 +7678,7 @@ Examples:
       }
       let totalShown = nonZero.length;
       printKeyValue([
-        ["Address", address2],
+        ["Address", address3],
         ["Network", client.network],
         ["Tokens", String(totalShown)]
       ]);
@@ -7246,7 +7704,7 @@ Examples:
         const nextResult = await withSpinner(
           "Fetching next page\u2026",
           "Page fetched",
-          () => client.call("alchemy_getTokenBalances", [address2, "erc20", { pageKey }])
+          () => client.call("alchemy_getTokenBalances", [address3, "erc20", { pageKey }])
         );
         if (isJSONMode()) {
           printJSON(nextResult);
@@ -7282,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);
@@ -7353,20 +7811,20 @@ 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);
-      const address2 = addressArg ? await resolveAddress(addressArg, client) : void 0;
+      const address3 = addressArg ? await resolveAddress(addressArg, client) : void 0;
       if (opts.fromAddress) opts.fromAddress = await resolveAddress(opts.fromAddress, client);
       if (opts.toAddress) opts.toAddress = await resolveAddress(opts.toAddress, client);
       const baseFilter = {
@@ -7382,8 +7840,8 @@ Examples:
       }
       if (opts.pageKey) baseFilter.pageKey = opts.pageKey;
       const filter = { ...baseFilter };
-      if (address2 && !opts.fromAddress && !opts.toAddress) {
-        filter.fromAddress = address2;
+      if (address3 && !opts.fromAddress && !opts.toAddress) {
+        filter.fromAddress = address3;
       } else {
         if (opts.fromAddress) filter.fromAddress = opts.fromAddress;
         if (opts.toAddress) filter.toAddress = opts.toAddress;
@@ -7620,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);
@@ -7734,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");
@@ -7826,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");
@@ -7893,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)) {
@@ -7956,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();
@@ -7971,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);
     }
   });
@@ -7980,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 {
@@ -8145,14 +8615,13 @@ import {
 // src/lib/wallet-quote-client.ts
 import { createClient } from "viem";
 import { parseAccount } from "viem/accounts";
-function buildWalletQuoteClient(program2, address2) {
+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(address2),
+    account: parseAccount(address3),
     transport: createAlchemyWalletTransport(apiKey),
     chain,
     name: "alchemyQuoteClient"
@@ -8164,7 +8633,7 @@ function buildWalletQuoteClient(program2, address2) {
     client,
     network,
     chain,
-    address: address2,
+    address: address3,
     paymaster: void 0
   };
 }
@@ -8241,8 +8710,8 @@ function normalizeQuoteError(err, flow) {
 
 // src/commands/swap.ts
 var NATIVE_DECIMALS = 18;
-function isNativeToken2(address2) {
-  return address2.toLowerCase() === NATIVE_TOKEN_ADDRESS.toLowerCase();
+function isNativeToken2(address3) {
+  return address3.toLowerCase() === NATIVE_TOKEN_ADDRESS.toLowerCase();
 }
 function slippagePercentToBasisPoints(percent) {
   return BigInt(Math.round(percent * 100));
@@ -8252,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;
@@ -8318,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);
@@ -8338,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();
@@ -8528,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, {});
@@ -8616,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;
   }
@@ -8637,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) {
@@ -8683,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");
@@ -8934,8 +9403,8 @@ import {
   swapActions as swapActions2
 } from "@alchemy/wallet-apis/experimental";
 var NATIVE_DECIMALS2 = 18;
-function isNativeToken3(address2) {
-  return address2.toLowerCase() === NATIVE_TOKEN_ADDRESS.toLowerCase();
+function isNativeToken3(address3) {
+  return address3.toLowerCase() === NATIVE_TOKEN_ADDRESS.toLowerCase();
 }
 function slippagePercentToBasisPoints2(percent) {
   return BigInt(Math.round(percent * 100));
@@ -9034,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:
@@ -9055,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:
@@ -9740,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
   };
@@ -9888,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.9.3", "-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"
@@ -10026,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")}`,
@@ -10075,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);
@@ -10114,7 +10582,7 @@ ${styledLine}`;
   if (isInteractiveAllowed(program)) {
     let latestForInteractiveStartup = null;
     if (shouldRunOnboarding(program, cfg)) {
-      const { runOnboarding } = await import("./onboarding-IJQ72DK7.js");
+      const { runOnboarding } = await import("./onboarding-2FLKQYLY.js");
       const latest = getAvailableUpdateOnce();
       const completed = await runOnboarding(program, latest);
       updateShownDuringInteractiveStartup = Boolean(latest);
@@ -10128,7 +10596,7 @@ ${styledLine}`;
         latestForInteractiveStartup
       );
     }
-    const { startREPL } = await import("./interactive-KLVEYTQM.js");
+    const { startREPL } = await import("./interactive-EXQM6HWQ.js");
     program.exitOverride();
     program.configureOutput({
       writeErr: () => {