@alchemy/cli 0.10.0 → 0.11.1

package/README.md

@@ -2,7 +2,7 @@
 
 Alchemy CLI is a command-line tool for querying blockchain data and managing Alchemy apps/configuration.
 It supports both human-friendly terminal output and JSON output for automation.
-You can use browser login, API keys, access keys, or x402 wallet auth depending on the command.
+You can use browser login, API keys, or x402 wallet auth depending on the command.
 
 ## Installation
 
@@ -67,7 +67,7 @@ Quick usage examples:
 alchemy
 
 # Agent/script-friendly command
-alchemy evm data balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --json --no-interactive
+alchemy evm data balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -n eth-mainnet --json --no-interactive
 
 # Agent checks whether a newer CLI version is available
 alchemy update-check --json --no-interactive
@@ -95,22 +95,22 @@ Use `alchemy help` or `alchemy help <command>` for generated command help.
 
 | Command | What it does | Example |
 |---|---|---|
-| `evm rpc <method> [params...]` | Makes raw Ethereum JSON-RPC calls | `alchemy evm rpc eth_blockNumber` |
-| `evm data balance [address]` | Gets native token balance for an address | `alchemy evm data balance 0x...` |
-| `evm data tokens balances [address]` | Lists ERC-20 balances for an address | `alchemy evm data tokens balances 0x...` |
-| `evm data nfts [address]` | Lists NFTs owned by an address | `alchemy evm data nfts 0x...` |
-| `evm data history [address]` | Gets transfer history (`alchemy_getAssetTransfers`) | `alchemy evm data history 0x... --category erc20,erc721` |
+| `evm rpc <method> [params...]` | Makes raw Ethereum JSON-RPC calls | `alchemy evm rpc eth_blockNumber -n eth-mainnet` |
+| `evm data balance [address]` | Gets native token balance for an address | `alchemy evm data balance 0x... -n eth-mainnet` |
+| `evm data tokens balances [address]` | Lists ERC-20 balances for an address | `alchemy evm data tokens balances 0x... -n eth-mainnet` |
+| `evm data nfts [address]` | Lists NFTs owned by an address | `alchemy evm data nfts 0x... -n eth-mainnet` |
+| `evm data history [address]` | Gets transfer history (`alchemy_getAssetTransfers`) | `alchemy evm data history 0x... --category erc20,erc721 -n eth-mainnet` |
 | `evm data price symbol <symbols>` | Gets current token prices by symbol | `alchemy evm data price symbol ETH,USDC` |
 | `evm data portfolio tokens --body <json>` | Gets token portfolio data | `alchemy evm data portfolio tokens --body '{...}'` |
-| `evm send <to> <amount>` | Sends native tokens or ERC-20 tokens | `alchemy evm send vitalik.eth 0.1 -n base-mainnet` |
-| `evm contract read/call` | Reads or writes smart contracts | `alchemy evm contract read 0x... "balanceOf(address)(uint256)" --args '["0x..."]'` |
-| `evm swap quote/execute` | Swaps tokens on the same chain | `alchemy evm swap quote --from 0xEeee... --to 0xA0b8... --amount 1` |
-| `evm approve <spender_address>` | Approves an ERC-20 token allowance | `alchemy evm approve 0x... --token-address 0x... --amount 10` |
-| `evm status [id]` | Checks transaction or operation status | `alchemy evm status 0x...` |
+| `evm send <to> <amount>` | Sends native tokens for `--network`, or ERC-20 tokens with `--token` | `alchemy evm send vitalik.eth 0.1 -n base-mainnet` |
+| `evm contract read/call` | Reads or writes smart contracts | `alchemy evm contract read 0x... "balanceOf(address)(uint256)" --args '["0x..."]' -n eth-mainnet` |
+| `evm swap quote/execute` | Swaps tokens on the same chain | `alchemy evm swap quote --from 0xEeee... --to 0xA0b8... --amount 1 -n eth-mainnet` |
+| `evm approve <spender_address>` | Approves an ERC-20 token allowance | `alchemy evm approve 0x... --token-address 0x... --amount 10 -n eth-mainnet` |
+| `evm status [id]` | Checks transaction or operation status | `alchemy evm status 0x... -n eth-mainnet` |
 | `evm network list` | Lists RPC network IDs for use with `--network` | `alchemy evm network list --search base` |
-| `evm tx/receipt/block/gas/logs` | Fetches common node resources | `alchemy evm block latest` |
-| `evm trace/debug` | Calls Trace and Debug API methods | `alchemy evm trace call '{"to":"0x..."}' '["trace"]' latest` |
-| `evm simulate *` | Calls simulation APIs | `alchemy evm simulate execution --tx '{"to":"0x..."}'` |
+| `evm tx/receipt/block/gas/logs` | Fetches common node resources | `alchemy evm block latest -n eth-mainnet` |
+| `evm trace/debug` | Calls Trace and Debug API methods | `alchemy evm trace call '{"to":"0x..."}' '["trace"]' latest -n eth-mainnet` |
+| `evm simulate *` | Calls simulation APIs | `alchemy evm simulate execution --tx '{"to":"0x..."}' -n eth-mainnet` |
 
 ### Wallets
 
@@ -134,14 +134,14 @@ Per-command override: pass `--signer <session\|local>` to `evm send`, `evm appro
 
 | Command | What it does | Example |
 |---|---|---|
-| `solana rpc <method> [params...]` | Calls Solana JSON-RPC methods | `alchemy solana rpc getBalance '"<pubkey>"'` |
-| `solana das <method> [params...]` | Calls Solana DAS methods | `alchemy solana das getAssetsByOwner '{"ownerAddress":"<pubkey>"}'` |
+| `solana rpc <method> [params...]` | Calls Solana JSON-RPC methods | `alchemy solana rpc getBalance '"<pubkey>"' -n solana-mainnet` |
+| `solana das <method> [params...]` | Calls Solana DAS methods | `alchemy solana das getAssetsByOwner '{"ownerAddress":"<pubkey>"}' -n solana-mainnet` |
 | `solana network list` | Lists networks from the Solana namespace | `alchemy solana network list --search solana` |
-| `solana send <to> <amount>` | Sends SOL or SPL tokens to an address | `alchemy solana send <pubkey> 0.1` |
-| `solana send <to> <amount> --token <mint>` | Sends an SPL token and creates the recipient ATA if needed | `alchemy solana send <pubkey> 10 --token <mint>` |
-| `solana program accounts/account/show` | Inspects Solana program accounts and account metadata | `alchemy solana program accounts <program-id>` |
-| `solana delegate approve/revoke` | Approves or revokes SPL token delegates | `alchemy solana delegate approve --token-account <addr> --mint <mint> --delegate <addr> --amount 1 --decimals 6` |
-| `solana status [id]` | Checks Solana transaction or operation status | `alchemy solana status <signature>` |
+| `solana send <to> <amount>` | Sends SOL or SPL tokens to an address | `alchemy solana send <pubkey> 0.1 -n solana-mainnet` |
+| `solana send <to> <amount> --token <mint>` | Sends an SPL token and creates the recipient ATA if needed | `alchemy solana send <pubkey> 10 --token <mint> -n solana-mainnet` |
+| `solana program accounts/account/show` | Inspects Solana program accounts and account metadata | `alchemy solana program accounts <program-id> -n solana-mainnet` |
+| `solana delegate approve/revoke` | Approves or revokes SPL token delegates | `alchemy solana delegate approve --token-account <addr> --mint <mint> --delegate <addr> --amount 1 --decimals 6 -n solana-mainnet` |
+| `solana status [id]` | Checks Solana transaction or operation status | `alchemy solana status <signature> -n solana-mainnet` |
 | `xchain bridge quote/execute` | Bridges tokens across chains | `alchemy xchain bridge quote --from 0xEeee... --to 0xEeee... --amount 0.1 --to-network base-mainnet -n eth-mainnet` |
 
 ### CLI Admin
@@ -175,7 +175,7 @@ Per-command override: pass `--signer <session\|local>` to `evm send`, `evm appro
 | `install skills` | Installs bundled Alchemy skills | `alchemy install skills --client cursor --dry-run` |
 | `update-check` | Checks whether a newer CLI version is available | `alchemy update-check --json --no-interactive` |
 | `config set ...` | Sets config values | `alchemy config set app <app-id>` |
-| `config get <key>` | Gets one config value | `alchemy config get network` |
+| `config get <key>` | Gets one config value | `alchemy config get verbose` |
 | `config list` | Lists all config values | `alchemy config list` |
 | `config reset [key]` | Resets one or all config values | `alchemy config reset --yes` |
 | `completions <shell>` | Generates shell completion scripts (bash/zsh/fish) | `eval "$(alchemy completions zsh)"` |
@@ -193,7 +193,7 @@ These apply to all commands.
 | Flag | Env var | Description |
 |---|---|---|
 | `--api-key <key>` | `ALCHEMY_API_KEY` | API key for blockchain query commands |
-| `-n, --network <network>` | `ALCHEMY_NETWORK` | Target network (default: `eth-mainnet`) |
+| `-n, --network <network>` | — | Target network for networked commands |
 | `--x402` | — | Enable x402 wallet-based gateway auth |
 | `--wallet-key-file <path>` | — | EVM wallet private key file for x402 auth and local signing |
 | `--solana-wallet-key-file <path>` | — | Solana wallet private key file for local signing |
@@ -221,7 +221,6 @@ Additional env vars:
 | Env var | Description |
 |---|---|
 | `ALCHEMY_CONFIG` | Custom path to config file |
-| `ALCHEMY_ACCESS_KEY` | Access key for Admin API operations |
 | `ALCHEMY_WALLET_KEY` | EVM wallet private key for x402 auth and local signing |
 | `ALCHEMY_SOLANA_WALLET_KEY` | Solana wallet private key |
 | `ALCHEMY_ACTIVE_SIGNER` | Active EVM signer override (`session` or `local`) |
@@ -245,7 +244,7 @@ Additional env vars:
 | `evm data price historical` | `--body <json>` (required) |
 | `evm data portfolio *` | `--body <json>` (required per subcommand) |
 | `evm simulate *` | `--tx <json>` or `--txs <json>` (required) |
-| `evm send` | `--token <address>`, `--gas-sponsored`, `--gas-policy-id <id>`, `--signer <session\|local>` |
+| `evm send` | `-n, --network <network>` (required), `--token <address>`, `--gas-sponsored`, `--gas-policy-id <id>`, `--signer <session\|local>` |
 | `evm contract call` | `--args <json>`, `--abi-file <path>`, `--abi <json>`, `--value <ether>`, `--gas-sponsored`, `--gas-policy-id <id>`, `--signer <session\|local>` |
 | `evm swap quote` | `--from <token_address>`, `--to <token_address>`, `--amount <number>`, `--slippage <percent>`, `--signer <session\|local>` |
 | `evm swap execute` | `--from <token_address>`, `--to <token_address>`, `--amount <number>`, `--slippage <percent>`, `--gas-sponsored`, `--gas-policy-id <id>`, `--signer <session\|local>` |

package/dist/{auth-KS6VPHHU.js → auth-5XFZB2BU.js}

@@ -11,8 +11,8 @@ import {
   prepareLogin,
   revokeToken,
   waitForCallback
-} from "./chunk-AMGGO36F.js";
-import "./chunk-CTTW4PA4.js";
+} from "./chunk-I6YQX7PF.js";
+import "./chunk-5BEJA752.js";
 export {
   AUTH_PORT,
   DEFAULT_EXPIRES_IN_SECONDS,

package/dist/auth-AU7LPEQL.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
+import {
+  registerAuth,
+  selectAppAfterAuth
+} from "./chunk-ILPOKA4Y.js";
+import "./chunk-I6YQX7PF.js";
+import "./chunk-RPSHRYCZ.js";
+import "./chunk-OL5MEN62.js";
+import "./chunk-DXQAGBW6.js";
+import "./chunk-LANOFNO6.js";
+import "./chunk-5BEJA752.js";
+export {
+  registerAuth,
+  selectAppAfterAuth
+};

package/dist/{chunk-CTTW4PA4.js → chunk-5BEJA752.js}

@@ -113,9 +113,7 @@ async function fetchWithTimeout(url, init) {
 // src/lib/redact.ts
 var SENSITIVE_ERROR_CODES = /* @__PURE__ */ new Set([
   "AUTH_REQUIRED",
-  "INVALID_API_KEY",
-  "INVALID_ACCESS_KEY",
-  "ACCESS_KEY_REQUIRED"
+  "INVALID_API_KEY"
 ]);
 function getAlchemyKeyPathMarkers() {
   const domain = getBaseDomain();
@@ -293,8 +291,6 @@ var ErrorCode = {
   AUTH_REQUIRED: "AUTH_REQUIRED",
   INVALID_API_KEY: "INVALID_API_KEY",
   NETWORK_NOT_ENABLED: "NETWORK_NOT_ENABLED",
-  INVALID_ACCESS_KEY: "INVALID_ACCESS_KEY",
-  ACCESS_KEY_REQUIRED: "ACCESS_KEY_REQUIRED",
   APP_REQUIRED: "APP_REQUIRED",
   ADMIN_API_ERROR: "ADMIN_API_ERROR",
   NETWORK_ERROR: "NETWORK_ERROR",
@@ -315,8 +311,6 @@ var EXIT_CODES = {
   AUTH_REQUIRED: 3,
   INVALID_API_KEY: 3,
   NETWORK_NOT_ENABLED: 3,
-  INVALID_ACCESS_KEY: 3,
-  ACCESS_KEY_REQUIRED: 3,
   APP_REQUIRED: 3,
   INVALID_ARGS: 2,
   NOT_FOUND: 4,
@@ -368,13 +362,6 @@ function errAuthRequired() {
     "alchemy auth"
   );
 }
-function errAccessKeyRequired() {
-  return new CLIError(
-    ErrorCode.ACCESS_KEY_REQUIRED,
-    "Access key required. Set ALCHEMY_ACCESS_KEY or run 'alchemy config set access-key <key>'.",
-    "Get an access key: https://www.alchemy.com/docs/reference/admin-api/overview"
-  );
-}
 function errLoginRequired() {
   return new CLIError(
     ErrorCode.AUTH_REQUIRED,
@@ -406,6 +393,13 @@ function errNetwork(detail) {
     "Check your internet connection and try again."
   );
 }
+function errNetworkRequired(networkListCommand = "alchemy evm network list") {
+  return new CLIError(
+    ErrorCode.INVALID_ARGS,
+    "Network required. Pass -n/--network <network>.",
+    networkListCommand
+  );
+}
 var RPC_ERROR_HINTS = {
   [-32700]: "Parse error. The request JSON is malformed.",
   [-32600]: "Invalid request. Check the JSON-RPC request format.",
@@ -430,19 +424,12 @@ function errRateLimited() {
     "Consider upgrading your Alchemy plan for higher rate limits."
   );
 }
-function errInvalidAccessKey() {
-  return new CLIError(
-    ErrorCode.INVALID_ACCESS_KEY,
-    "Invalid access key. Check your key and try again.",
-    "Get an access key: https://www.alchemy.com/docs/reference/admin-api/overview"
-  );
-}
 function errAccessDenied(detail) {
-  const message = detail ? `Access denied: ${detail}` : "Access denied. Your access key may not have permission for this operation.";
+  const message = detail ? `Access denied: ${detail}` : "Access denied. Check that your Alchemy account has permission for this operation.";
   return new CLIError(
-    ErrorCode.INVALID_ACCESS_KEY,
+    ErrorCode.AUTH_REQUIRED,
     message,
-    "Check your account tier and feature access at https://dashboard.alchemy.com/"
+    "Run 'alchemy auth login' or check your account access at https://dashboard.alchemy.com/"
   );
 }
 function errAppRequired() {
@@ -455,10 +442,17 @@ function errAppRequired() {
 function errWalletKeyRequired() {
   return new CLIError(
     ErrorCode.AUTH_REQUIRED,
-    "Wallet key required for x402. Set ALCHEMY_WALLET_KEY, run 'alchemy wallet connect --mode local', or use --wallet-key-file.",
+    "No local wallet configured. Run 'alchemy wallet connect --mode local', set ALCHEMY_WALLET_KEY, or use --wallet-key-file.",
     "alchemy wallet connect --mode local"
   );
 }
+function errWalletRequired() {
+  return new CLIError(
+    ErrorCode.AUTH_REQUIRED,
+    "No wallet connected. Run 'alchemy wallet connect' to connect a session wallet, or run 'alchemy wallet connect --mode local' to use a local wallet.",
+    "alchemy wallet connect"
+  );
+}
 function errSessionExpired() {
   return new CLIError(
     ErrorCode.AUTH_REQUIRED,
@@ -548,19 +542,19 @@ export {
   EXIT_CODES,
   CLIError,
   errAuthRequired,
-  errAccessKeyRequired,
   errLoginRequired,
   errInvalidAPIKey,
   errNetworkNotEnabled,
   errNetwork,
+  errNetworkRequired,
   errRPC,
   errInvalidArgs,
   errNotFound,
   errRateLimited,
-  errInvalidAccessKey,
   errAccessDenied,
   errAppRequired,
   errWalletKeyRequired,
+  errWalletRequired,
   errSessionExpired,
   errNoActiveSession,
   errSolanaWalletKeyRequired,

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

@@ -3,7 +3,7 @@ if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   gasManagerClientFromFlags,
   toAdminNetworkId
-} from "./chunk-ANONMDDZ.js";
+} from "./chunk-OL5MEN62.js";
 import {
   dim,
   green,
@@ -11,16 +11,16 @@ import {
   promptConfirm,
   promptText,
   withSpinner
-} from "./chunk-PMNRIXJI.js";
+} from "./chunk-DXQAGBW6.js";
 import {
   load,
   save
-} from "./chunk-GLKB4JM7.js";
+} from "./chunk-LANOFNO6.js";
 import {
   errAppRequired,
   errInvalidArgs,
   errLoginRequired
-} from "./chunk-CTTW4PA4.js";
+} from "./chunk-5BEJA752.js";
 
 // src/lib/policy-prompt.ts
 var CREATE_NEW_SENTINEL = "__create_new__";

package/dist/{chunk-PMNRIXJI.js → chunk-DXQAGBW6.js}

@@ -5,7 +5,7 @@ import {
   isJSONMode,
   quiet,
   rgb
-} from "./chunk-CTTW4PA4.js";
+} from "./chunk-5BEJA752.js";
 
 // src/lib/terminal-ui.ts
 import * as readline from "readline";

package/dist/{chunk-AMGGO36F.js → chunk-I6YQX7PF.js}

@@ -2,7 +2,7 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   getBaseDomain
-} from "./chunk-CTTW4PA4.js";
+} from "./chunk-5BEJA752.js";
 
 // src/lib/auth.ts
 import { createHash, randomBytes } from "crypto";

package/dist/{chunk-L5E7GEUU.js → chunk-ILPOKA4Y.js}

@@ -4,14 +4,14 @@ import {
   completeLogin,
   prepareLogin,
   revokeToken
-} from "./chunk-AMGGO36F.js";
+} from "./chunk-I6YQX7PF.js";
 import {
   isInteractiveAllowed
-} from "./chunk-3GBDYROJ.js";
+} from "./chunk-RPSHRYCZ.js";
 import {
   AdminClient,
   resolveAuthToken
-} from "./chunk-ANONMDDZ.js";
+} from "./chunk-OL5MEN62.js";
 import {
   bold,
   brand,
@@ -20,13 +20,13 @@ import {
   promptAutocomplete,
   promptText,
   withSpinner
-} from "./chunk-PMNRIXJI.js";
+} from "./chunk-DXQAGBW6.js";
 import {
   configPath,
   load,
   maskIf,
   save
-} from "./chunk-GLKB4JM7.js";
+} from "./chunk-LANOFNO6.js";
 import {
   CLIError,
   ErrorCode,
@@ -34,7 +34,7 @@ import {
   exitWithError,
   isJSONMode,
   printHuman
-} from "./chunk-CTTW4PA4.js";
+} from "./chunk-5BEJA752.js";
 
 // src/commands/auth.ts
 function registerAuth(program) {

package/dist/{chunk-GLKB4JM7.js → chunk-LANOFNO6.js}

@@ -2,7 +2,7 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   isRevealMode
-} from "./chunk-CTTW4PA4.js";
+} from "./chunk-5BEJA752.js";
 
 // src/lib/secrets.ts
 function maskSecret(value) {
@@ -22,11 +22,8 @@ import { z } from "zod";
 var KEY_MAP = {
   "api-key": "api_key",
   api_key: "api_key",
-  "access-key": "access_key",
-  access_key: "access_key",
   "webhook-api-key": "webhook_api_key",
   webhook_api_key: "webhook_api_key",
-  network: "network",
   verbose: "verbose",
   "wallet-key-file": "wallet_key_file",
   wallet_key_file: "wallet_key_file",
@@ -57,7 +54,6 @@ var KEY_MAP = {
   wallet_client_instance_name: "wallet_client_instance_name"
 };
 var SAFE_ID_RE = /^[A-Za-z0-9:_-]{1,128}$/;
-var SAFE_NETWORK_RE = /^[A-Za-z0-9:_-]{1,128}$/;
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 var MAX_SECRET_LEN = 512;
 var MAX_APP_NAME_LEN = 128;
@@ -74,10 +70,8 @@ var appConfigSchema = z.object({
 var MAX_PATH_LEN = 4096;
 var configSchema = z.object({
   api_key: safeTextSchema(MAX_SECRET_LEN).optional().catch(void 0),
-  access_key: safeTextSchema(MAX_SECRET_LEN).optional().catch(void 0),
   webhook_api_key: safeTextSchema(MAX_SECRET_LEN).optional().catch(void 0),
   app: appConfigSchema.optional().catch(void 0),
-  network: z.string().regex(SAFE_NETWORK_RE).optional().catch(void 0),
   verbose: z.boolean().optional().catch(void 0),
   wallet_key_file: safeTextSchema(MAX_PATH_LEN).optional().catch(void 0),
   wallet_address: safeTextSchema(MAX_SECRET_LEN).optional().catch(void 0),
@@ -212,9 +206,7 @@ function get(cfg, key) {
 function validKeys() {
   return [
     "api-key",
-    "access-key",
     "webhook-api-key",
-    "network",
     "verbose",
     "wallet-key-file",
     "x402",
@@ -227,10 +219,8 @@ function validKeys() {
 function toMap(cfg) {
   const m = {};
   if (cfg.api_key) m["api-key"] = maskIf(cfg.api_key);
-  if (cfg.access_key) m["access-key"] = maskIf(cfg.access_key);
   if (cfg.webhook_api_key) m["webhook-api-key"] = maskIf(cfg.webhook_api_key);
   if (cfg.app) m["app"] = `${cfg.app.name} (${cfg.app.id})`;
-  if (cfg.network) m["network"] = cfg.network;
   if (cfg.verbose !== void 0) m["verbose"] = String(cfg.verbose);
   if (cfg.wallet_key_file) m["wallet-key-file"] = cfg.wallet_key_file;
   if (cfg.wallet_address) m["wallet-address"] = cfg.wallet_address;