@alchemy/cli 0.5.1 → 0.6.0

package/README.md

@@ -39,26 +39,20 @@ alchemy completions fish > ~/.config/fish/completions/alchemy.fish
 
 ### Authentication Quick Start
 
-Authentication is required before making requests. Configure auth first, then run commands.
-
-If you are using the CLI as a human in an interactive terminal, the easiest path is:
+Authentication is required before making requests. The recommended path is browser login:
 
 ```bash
-alchemy
+alchemy auth
 ```
 
-Then follow the setup flow in the terminal UI to configure auth.
+This opens a browser to link your Alchemy account, then prompts you to select an app. The selected app's API key is saved to your config automatically. Pass `-y` to skip the confirmation prompt.
 
-Know which auth method does what:
+If you run `alchemy` with no command and no auth configured, the CLI will guide you through browser login automatically.
 
-- **API key** - direct auth for blockchain queries (`balance`, `tx`, `block`, `nfts`, `tokens`, `rpc`)
-- **Access key** - Admin/API app management; app setup/selection can also provide API key auth for blockchain queries
-- **x402 wallet auth** - wallet-authenticated, pay-per-request model for supported blockchain queries
+If you have an auth token but haven't selected an app yet, the CLI will prompt you to pick one before running any command that requires an API key. Teams with many apps can type to search by name.
 
 If you use Notify webhooks, add webhook auth on top via `alchemy config set webhook-api-key <key>`, `--webhook-api-key`, or `ALCHEMY_WEBHOOK_API_KEY`.
 
-For setup commands, env vars, and resolution order, see [Authentication Reference](#authentication-reference).
-
 ### Usage By Workflow
 
 After auth is configured, use the CLI differently depending on who is driving it:
@@ -115,7 +109,7 @@ Use `alchemy help` or `alchemy help <command>` for generated command help.
 
 | Command | What it does | Example |
 |---|---|---|
-| `tokens [address]` | Lists ERC-20 balances for an address | `alchemy tokens 0x...` |
+| `tokens balances [address]` | Lists ERC-20 balances for an address | `alchemy tokens balances 0x...` |
 | `tokens metadata <contract>` | Gets ERC-20 metadata | `alchemy tokens metadata 0x...` |
 | `tokens allowance --owner --spender --contract` | Gets ERC-20 allowance | `alchemy tokens allowance --owner 0x... --spender 0x... --contract 0x...` |
 | `nfts [address]` | Lists NFTs owned by an address | `alchemy nfts 0x...` |
@@ -156,7 +150,7 @@ Use `alchemy help` or `alchemy help <command>` for generated command help.
 
 | Command | What it does | Example |
 |---|---|---|
-| `network list` | Lists RPC network IDs for use with `--network` (e.g. `eth-mainnet`) | `alchemy network list --configured` |
+| `network list` | Lists RPC network IDs for use with `--network` (e.g. `eth-mainnet`) | `alchemy network list --search ethereum` |
 | `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>"}'` |
 
@@ -165,6 +159,9 @@ Use `alchemy help` or `alchemy help <command>` for generated command help.
 | Command | What it does | Example |
 |---|---|---|
 | `(no command)` | Starts interactive REPL mode (TTY only) | `alchemy` |
+| `auth` (`auth login`) | Log in via browser (PKCE) | `alchemy auth` |
+| `auth status` | Show current authentication status | `alchemy auth status` |
+| `auth logout` | Clear saved authentication token | `alchemy auth logout` |
 | `apps list` | Lists apps (supports pagination/filtering) | `alchemy apps list --all` |
 | `apps chains` | Lists Admin API chain identifiers (e.g. `ETH_MAINNET`) | `alchemy apps chains` |
 | `apps get <id>` | Gets app details | `alchemy apps get <app-id>` |
@@ -231,6 +228,7 @@ Additional env vars:
 
 | Command | Flags |
 |---|---|
+| `auth login` | `--force`, `-y, --yes` |
 | `nfts` | `--limit <n>`, `--page-key <key>` |
 | `nfts metadata` | `--contract <address>` (required), `--token-id <id>` (required) |
 | `tokens` | `--page-key <key>` |
@@ -253,79 +251,32 @@ Additional env vars:
 | `apps address-allowlist` | `--addresses <addrs>` (required), `--dry-run` |
 | `apps origin-allowlist` | `--origins <origins>` (required), `--dry-run` |
 | `apps ip-allowlist` | `--ips <ips>` (required), `--dry-run` |
-| `network list` | `--configured`, `--app-id <id>` |
+| `network list` | `--mainnet-only`, `--testnet-only`, `--search <term>` |
 | `config reset` | `-y, --yes` |
 
 ## Authentication Reference
 
-The CLI supports three auth inputs:
-
-- API key for blockchain queries (`balance`, `tx`, `block`, `nfts`, `tokens`, `rpc`)
-- Access key for Admin API operations (`apps`, `chains`, configured network lookups`) and app setup/selection, which can also supply the API key used by blockchain query commands
-- x402 wallet key for wallet-authenticated blockchain queries in a pay-per-request model
-
-Notify/webhook commands use a webhook API key with resolution order:
-`--webhook-api-key` -> `ALCHEMY_WEBHOOK_API_KEY` -> `ALCHEMY_NOTIFY_AUTH_TOKEN` -> config `webhook-api-key` -> configured app webhook key.
-
-Get API/access keys at [alchemy.com](https://dashboard.alchemy.com/).
-
-#### API key
-
 ```bash
-# Config
-alchemy config set api-key <your-key>
+# Interactive login — opens browser to link your Alchemy account
+alchemy auth
 
-# Environment variable
-export ALCHEMY_API_KEY=<your-key>
-
-# Per-command override
-alchemy balance 0x... --api-key <your-key>
-```
+# Skip the confirmation prompt
+alchemy auth -y
 
-Resolution order: `--api-key` -> `ALCHEMY_API_KEY` -> config file -> configured app API key.
-
-#### Access key
-
-```bash
-# Config (in TTY, this may trigger app setup flow)
-alchemy config set access-key <your-key>
+# Force re-authentication
+alchemy auth login --force
 
-# Environment variable
-export ALCHEMY_ACCESS_KEY=<your-key>
+# Check auth status
+alchemy auth status
 
-# Per-command override
-alchemy apps list --access-key <your-key>
+# Log out
+alchemy auth logout
 ```
 
-Resolution order: `--access-key` -> `ALCHEMY_ACCESS_KEY` -> config file.
+After login, the CLI prompts you to select an app. The app's API key is saved to config and used for all subsequent commands. If you skip app selection during login, the CLI will prompt you to pick one before running any command that needs an API key.
 
-#### x402 wallet auth
-
-x402 is a wallet-authenticated, pay-per-request usage model for supported blockchain queries.
-The CLI can generate or import the wallet key used for these requests.
-
-```bash
-# Generate/import a wallet managed by CLI
-alchemy wallet generate
-# or
-alchemy wallet import ./private-key.txt
-
-# Use x402 per command
-alchemy balance 0x... --x402
-
-# Or enable by default
-alchemy config set x402 true
-```
-
-Generated/imported wallets are stored as unique key files under `~/.config/alchemy/wallet-keys/` so creating another wallet does not overwrite prior private keys.
-
-You can also provide wallet key directly:
-
-```bash
-export ALCHEMY_WALLET_KEY=0x...
-```
-
-Wallet key resolution order: `--wallet-key-file` -> `ALCHEMY_WALLET_KEY` -> `wallet-key-file` in config.
+Notify/webhook commands use a webhook API key with resolution order:
+`--webhook-api-key` -> `ALCHEMY_WEBHOOK_API_KEY` -> `ALCHEMY_NOTIFY_AUTH_TOKEN` -> config `webhook-api-key` -> configured app webhook key.
 
 ## REPL Mode
 

package/dist/{auth-7E33EMAI.js → auth-QB3BA7AN.js}

@@ -3,9 +3,13 @@ if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   registerAuth,
   selectAppAfterAuth
-} from "./chunk-LYUW7O6X.js";
-import "./chunk-IGD4NIK7.js";
-import "./chunk-T2XSNZE3.js";
+} from "./chunk-UMKDYHMO.js";
+import "./chunk-FFMNT74F.js";
+import "./chunk-KDMIWPZH.js";
+import "./chunk-ATX65U7J.js";
+import "./chunk-JQRGILIS.js";
+import "./chunk-NBDWF4ZQ.js";
+import "./chunk-BAAQ7ELR.js";
 import "./chunk-56ZVYB4G.js";
 export {
   registerAuth,

package/dist/{auth-E26YCAJV.js → auth-S4DTOWW3.js}

@@ -2,22 +2,24 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   AUTH_PORT,
-  DEFAULT_EXPIRES_IN_SECONDS,
+  OAUTH_CLIENT_ID,
   exchangeCodeForToken,
-  getLoginUrl,
+  getAuthorizeUrl,
   openBrowser,
   performBrowserLogin,
+  prepareBrowserLogin,
   revokeToken,
   waitForCallback
-} from "./chunk-IGD4NIK7.js";
+} from "./chunk-FFMNT74F.js";
 import "./chunk-56ZVYB4G.js";
 export {
   AUTH_PORT,
-  DEFAULT_EXPIRES_IN_SECONDS,
+  OAUTH_CLIENT_ID,
   exchangeCodeForToken,
-  getLoginUrl,
+  getAuthorizeUrl,
   openBrowser,
   performBrowserLogin,
+  prepareBrowserLogin,
   revokeToken,
   waitForCallback
 };

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

@@ -2,7 +2,7 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   configPath
-} from "./chunk-T2XSNZE3.js";
+} from "./chunk-BAAQ7ELR.js";
 import {
   esc
 } from "./chunk-56ZVYB4G.js";
@@ -53,7 +53,7 @@ function semverLT(a, b) {
   return false;
 }
 function currentVersion() {
-  return true ? "0.5.1" : "0.0.0";
+  return true ? "0.6.0" : "0.0.0";
 }
 function toUpdateStatus(latestVersion, checkedAt) {
   const current = currentVersion();