@alchemy/cli 0.7.0-alpha.5 → 0.7.0

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 API keys, access keys, or x402 wallet auth depending on the command.
+You can use browser login, API keys, access keys, or x402 wallet auth depending on the command.
 
 ## Installation
 
@@ -51,7 +51,7 @@ If you run `alchemy` with no command and no auth configured, the CLI will guide
 
 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`.
+If you use Notify webhooks, add webhook auth on top via `alchemy config set webhook-api-key <key>`, `--webhook-api-key` on `alchemy webhook` commands, or `ALCHEMY_WEBHOOK_API_KEY`.
 
 ### Usage By Workflow
 
@@ -79,7 +79,7 @@ Have your agent run `agent-prompt` as its first step to get a complete, machine-
 
 ```bash
 # Agent runs this once to learn everything the CLI can do
-alchemy --json agent-prompt
+alchemy --json --no-interactive agent-prompt
 ```
 
 This returns a single JSON document with execution policy, preflight instructions, auth matrix, the full command tree with all arguments and options, error codes with recovery actions, and example invocations. No external docs required.
@@ -114,24 +114,21 @@ Use `alchemy help` or `alchemy help <command>` for generated command help.
 
 ### Wallets
 
-`alchemy wallets` exposes a unified onchain-actions surface. The **session wallet** (Alchemy/Privy-managed, P-256 delegated signer) is the recommended flow; a **local wallet** (private key stored on disk) is supported as an alternative and is currently the only path for Solana.
+`alchemy wallet` exposes a unified onchain-actions surface. The **session wallet** (Alchemy/Privy-managed, P-256 delegated signer) is the recommended flow; a **local wallet** (private key stored on disk) is supported as an alternative.
 
 | Command | What it does | Example |
 |---|---|---|
-| `wallets connect` | Interactive: choose a session wallet (recommended) or a local wallet. For scripts, pass `--mode <session\|local>`. | `alchemy wallets connect` |
-| `wallets connect --mode local --chain evm` | Create a new local EVM key (non-interactive). `--chain` accepts `evm`, `solana`, or `both`. | `alchemy wallets connect --mode local --chain both` |
-| `wallets connect --mode local --import <path>` | Import an existing EVM private key from a file. | `alchemy wallets connect --mode local --import ./key.txt` |
-| `wallets status [--verify]` | Reports session, local EVM, local Solana, and the active signer. `--verify` reconciles the session with the backend. | `alchemy wallets status --verify` |
-| `wallets address` | Prints addresses for every configured signer. | `alchemy wallets address` |
-| `wallets use <session\|local>` | Selects which signer `evm send`, `evm swap`, `evm approve`, `xchain bridge`, and `evm contract call` use for EVM transactions. | `alchemy wallets use local` |
-| `wallets disconnect` | Revokes the current session (local + backend). Clears `active_signer` if it pointed at the session. | `alchemy wallets disconnect` |
-| `wallets qr [--type <evm\|solana>]` | Renders a configured address as a QR code. | `alchemy wallets qr --type evm` |
+| `wallet connect` | Interactive: choose a session wallet (recommended) or a local wallet. For scripts, pass `--mode <session\|local>`. | `alchemy wallet connect` |
+| `wallet connect --mode local --chain evm` | Create a new local EVM key (non-interactive). `--chain` accepts `evm`, `solana`, or `both`. | `alchemy wallet connect --mode local --chain both` |
+| `wallet connect --mode local --import <path>` | Import an existing EVM private key from a file. | `alchemy wallet connect --mode local --import ./key.txt` |
+| `wallet connect --mode session --instance-name <name>` | Connect a named session wallet instance. | `alchemy wallet connect --mode session --instance-name laptop` |
+| `wallet status [--verify]` | Reports session, local EVM, local Solana, and the active signer. `--verify` reconciles the session with the backend. | `alchemy wallet status --verify` |
+| `wallet address` | Prints addresses for every configured signer. | `alchemy wallet address` |
+| `wallet use <session\|local>` | Selects which signer `evm send`, `evm swap`, `evm approve`, `xchain bridge`, and `evm contract call` use for EVM transactions. | `alchemy wallet use local` |
+| `wallet disconnect` | Revokes the current session (local + backend). Clears `active_signer` if it pointed at the session. | `alchemy wallet disconnect` |
+| `wallet qr [--type <evm\|solana>]` | Renders a configured address as a QR code. | `alchemy wallet qr --type evm` |
 
 Per-command override: pass `--signer <session\|local>` to `evm send`, `evm approve`, `evm swap`, `xchain bridge`, or `evm contract call` to override the active signer for a single invocation.
-| `webhooks list` | Lists Notify webhooks | `alchemy webhooks list --webhook-api-key <key>` |
-| `webhooks create --body <json>` | Creates Notify webhook | `alchemy webhooks create --body '{...}' --webhook-api-key <key>` |
-| `webhooks update --body <json>` | Updates Notify webhook | `alchemy webhooks update --body '{...}' --webhook-api-key <key>` |
-| `webhooks delete <id>` | Deletes Notify webhook | `alchemy webhooks delete <id> --webhook-api-key <key>` |
 
 ### Chains
 
@@ -140,6 +137,10 @@ Per-command override: pass `--signer <session\|local>` to `evm send`, `evm appro
 | `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 network list` | Lists networks from the Solana namespace | `alchemy solana network list --search solana` |
+| `solana send <to> <amount>` | Sends SOL to an address | `alchemy solana send <pubkey> 0.1` |
+| `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>` |
 | `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
@@ -150,26 +151,34 @@ Per-command override: pass `--signer <session\|local>` to `evm send`, `evm appro
 | `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>` |
-| `apps create` | Creates app | `alchemy apps create --name "My App" --networks eth-mainnet` |
-| `apps update <id>` | Updates app name/description | `alchemy apps update <app-id> --name "New Name"` |
-| `apps delete <id>` | Deletes app | `alchemy apps delete <app-id>` |
-| `apps networks <id>` | Updates app network allowlist | `alchemy apps networks <app-id> --networks eth-mainnet,polygon-mainnet` |
-| `apps address-allowlist <id>` | Updates app address allowlist | `alchemy apps address-allowlist <app-id> --addresses 0xabc,0xdef` |
-| `apps origin-allowlist <id>` | Updates app origin allowlist | `alchemy apps origin-allowlist <app-id> --origins https://example.com` |
-| `apps ip-allowlist <id>` | Updates app IP allowlist | `alchemy apps ip-allowlist <app-id> --ips 1.2.3.4,5.6.7.8` |
+| `app list` | Lists apps (supports pagination/filtering) | `alchemy app list --all` |
+| `app chains` | Lists Admin API chain identifiers (e.g. `ETH_MAINNET`) | `alchemy app chains` |
+| `app get <id>` | Gets app details | `alchemy app get <app-id>` |
+| `app create` | Creates app | `alchemy app create --name "My App" --networks eth-mainnet` |
+| `app update <id>` | Updates app name/description | `alchemy app update <app-id> --name "New Name"` |
+| `app delete <id>` | Deletes app | `alchemy app delete <app-id>` |
+| `app networks <id>` | Updates app network allowlist | `alchemy app networks <app-id> --networks eth-mainnet,polygon-mainnet` |
+| `app address-allowlist <id>` | Updates app address allowlist | `alchemy app address-allowlist <app-id> --addresses 0xabc,0xdef` |
+| `app origin-allowlist <id>` | Updates app origin allowlist | `alchemy app origin-allowlist <app-id> --origins https://example.com` |
+| `app ip-allowlist <id>` | Updates app IP allowlist | `alchemy app ip-allowlist <app-id> --ips 1.2.3.4,5.6.7.8` |
+| `app configured-networks` | Lists RPC network slugs configured for an app | `alchemy app configured-networks --app-id <app-id>` |
+| `app select [id]` | Selects the default app interactively or by ID | `alchemy app select <app-id>` |
+| `webhook list` | Lists Notify webhooks | `alchemy webhook list --webhook-api-key <key>` |
+| `webhook create --body <json>` | Creates Notify webhook | `alchemy webhook create --body '{...}' --webhook-api-key <key>` |
+| `webhook update --body <json>` | Updates Notify webhook | `alchemy webhook update --body '{...}' --webhook-api-key <key>` |
+| `webhook delete <id>` | Deletes Notify webhook | `alchemy webhook delete <id> --webhook-api-key <key>` |
+| `webhook addresses <id>` | Gets address activity webhook addresses | `alchemy webhook addresses <id> --webhook-api-key <key>` |
+| `webhook nft-filters <id>` | Gets NFT activity webhook filters | `alchemy webhook nft-filters <id> --webhook-api-key <key>` |
 | `doctor` | Runs readiness checks and suggestions | `alchemy doctor` |
 | `install mcp` | Installs Alchemy's remote MCP server config | `alchemy install mcp --client claude --dry-run` |
 | `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 api-key <key>` |
+| `config set ...` | Sets config values | `alchemy config set app <app-id>` |
 | `config get <key>` | Gets one config value | `alchemy config get network` |
 | `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)"` |
-| `agent-prompt` | Emits complete agent/automation usage instructions | `alchemy --json agent-prompt` |
+| `agent-prompt` | Emits complete agent/automation usage instructions | `alchemy --json --no-interactive agent-prompt` |
 | `version` | Prints CLI version | `alchemy version` |
 
 ## Flags
@@ -183,10 +192,10 @@ These apply to all commands.
 | Flag | Env var | Description |
 |---|---|---|
 | `--api-key <key>` | `ALCHEMY_API_KEY` | API key for blockchain query commands |
-| `--access-key <key>` | `ALCHEMY_ACCESS_KEY` | Access key for Admin API operations |
 | `-n, --network <network>` | `ALCHEMY_NETWORK` | Target network (default: `eth-mainnet`) |
 | `--x402` | — | Enable x402 wallet-based gateway auth |
-| `--wallet-key-file <path>` | — | Wallet private key file for x402 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 |
 
 #### Output & formatting
 
@@ -211,7 +220,14 @@ Additional env vars:
 | Env var | Description |
 |---|---|
 | `ALCHEMY_CONFIG` | Custom path to config file |
-| `ALCHEMY_WALLET_KEY` | Wallet private key for x402 auth |
+| `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`) |
+| `ALCHEMY_EVM_GAS_SPONSORED` | Enable EVM gas sponsorship when set to `true` |
+| `ALCHEMY_EVM_GAS_POLICY_ID` | EVM gas sponsorship policy ID |
+| `ALCHEMY_SOLANA_FEE_SPONSORED` | Enable Solana fee sponsorship when set to `true` |
+| `ALCHEMY_SOLANA_FEE_POLICY_ID` | Solana fee sponsorship policy ID |
 | `ALCHEMY_WEBHOOK_API_KEY` | Webhook API key for Notify commands |
 
 ### Command-specific flags
@@ -228,18 +244,34 @@ 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) |
-| `webhooks *` | `--webhook-api-key <key>` (or `ALCHEMY_WEBHOOK_API_KEY`, `ALCHEMY_NOTIFY_AUTH_TOKEN`, config `webhook-api-key`, or app webhook key) |
-| `apps list` | `--cursor <cursor>`, `--limit <n>`, `--all`, `--search <query>`, `--id <appId>` |
-| `apps create` | `--name <name>` (required), `--networks <networks>` (required), `--description <desc>`, `--products <products>`, `--dry-run` |
-| `apps update` | `--name <name>`, `--description <desc>`, `--dry-run` |
-| `apps delete` | `--dry-run` |
-| `apps networks` | `--networks <networks>` (required), `--dry-run` |
-| `apps address-allowlist` | `--addresses <addrs>` (required), `--dry-run` |
-| `apps origin-allowlist` | `--origins <origins>` (required), `--dry-run` |
-| `apps ip-allowlist` | `--ips <ips>` (required), `--dry-run` |
+| `evm send` | `--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>` |
+| `evm approve` | `--token-address <token_address>`, `--amount <decimal_amount>`, `--unlimited`, `--revoke`, `--reset-first`, `-y, --yes`, `--gas-sponsored`, `--gas-policy-id <id>`, `--signer <session\|local>` |
+| `xchain bridge quote` | `--from <token_address>`, `--to <token_address>`, `--amount <number>`, `--to-network <network>`, `--slippage <percent>`, `--signer <session\|local>` |
+| `xchain bridge execute` | `--from <token_address>`, `--to <token_address>`, `--amount <number>`, `--to-network <network>`, `--slippage <percent>`, `--gas-sponsored`, `--gas-policy-id <id>`, `--signer <session\|local>` |
+| `wallet connect` | `--mode <session\|local>`, `--chain <evm\|solana\|both>`, `--import <path>`, `--instance-name <name>`, `--force` |
+| `wallet status` | `--verify` |
+| `wallet qr` | `--type <evm\|solana>`, `--solana` |
+| `solana send` | `--fee-sponsored`, `--fee-policy-id <id>`, `--signer <local>` (session signing is not yet supported for Solana) |
+| `solana program accounts` | `--filters <json>`, `--encoding <encoding>`, `--limit <n>` |
+| `solana delegate approve` | `--token-account <address>`, `--mint <address>`, `--delegate <address>`, `--amount <number>`, `--decimals <n>`, `--fee-sponsored`, `--fee-policy-id <id>` |
+| `solana delegate revoke` | `--token-account <address>`, `--fee-sponsored`, `--fee-policy-id <id>` |
+| `webhook *` | `--webhook-api-key <key>` (or `ALCHEMY_WEBHOOK_API_KEY`, `ALCHEMY_NOTIFY_AUTH_TOKEN`, config `webhook-api-key`, or app webhook key) |
+| `app list` | `--cursor <cursor>`, `--limit <n>`, `--all`, `--search <query>`, `--id <appId>` |
+| `app create` | `--name <name>` (required), `--networks <networks>` (required), `--description <desc>`, `--products <products>`, `--dry-run` |
+| `app update` | `--name <name>`, `--description <desc>`, `--dry-run` |
+| `app delete` | `--dry-run`, `-y, --yes` |
+| `app networks` | `--networks <networks>` (required), `--dry-run` |
+| `app address-allowlist` | `--addresses <addrs>` (required), `--dry-run` |
+| `app origin-allowlist` | `--origins <origins>` (required), `--dry-run` |
+| `app ip-allowlist` | `--ips <ips>` (required), `--dry-run` |
+| `app configured-networks` | `--app-id <id>` |
 | `install mcp` | `--client <claude,cursor,codex,other,all>`, `--dry-run` |
 | `install skills` | `--client <claude,cursor,codex,all>`, `--dry-run` |
 | `evm network list` | `--mainnet-only`, `--testnet-only`, `--search <term>` |
+| `config set` | `webhook-api-key`, `app`, `network`, `verbose`, `wallet-key-file`, `x402`, `evm-gas-sponsored`, `evm-gas-policy-id`, `solana-fee-sponsored`, `solana-fee-policy-id` |
 | `config reset` | `-y, --yes` |
 
 ## Authentication Reference
@@ -294,8 +326,8 @@ Errors are structured JSON in JSON mode:
 {
   "error": {
     "code": "AUTH_REQUIRED",
-    "message": "Not authenticated. Set ALCHEMY_API_KEY or run 'alchemy config set api-key <key>'.",
-    "hint": "alchemy config set api-key <your-key>"
+    "message": "Not authenticated. Run 'alchemy auth' to log in, or set ALCHEMY_API_KEY.",
+    "hint": "alchemy auth"
   }
 }
 ```

package/dist/{auth-I5WFLU46.js → auth-4HAUNG54.js}

@@ -3,12 +3,12 @@ if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   registerAuth,
   selectAppAfterAuth
-} from "./chunk-NT3G6BKD.js";
+} from "./chunk-I3X4G2UY.js";
 import "./chunk-HSKKIATB.js";
 import "./chunk-HYCRHNPX.js";
-import "./chunk-PKAN5FKD.js";
+import "./chunk-TOEVZMIP.js";
 import "./chunk-A6L3WCJN.js";
-import "./chunk-B3R6PRAL.js";
+import "./chunk-7WD3YLRK.js";
 import "./chunk-QEDAULQ2.js";
 export {
   registerAuth,

package/dist/{chunk-B3R6PRAL.js → chunk-7WD3YLRK.js}

@@ -15,6 +15,7 @@ function maskIf(value) {
 
 // src/lib/config.ts
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { createHash, randomUUID } from "crypto";
 import { homedir } from "os";
 import { join, dirname } from "path";
 import { z } from "zod";
@@ -51,13 +52,18 @@ var KEY_MAP = {
   "delegated-wallet": "delegated_wallet",
   delegated_wallet: "delegated_wallet",
   "active-signer": "active_signer",
-  active_signer: "active_signer"
+  active_signer: "active_signer",
+  "wallet-client-instance-name": "wallet_client_instance_name",
+  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;
+var MAX_WALLET_CLIENT_INSTANCE_NAME_LEN = 64;
 var CONTROL_CHAR_RE = /[\u0000-\u001f\u007f]/;
+var WALLET_CLIENT_INSTANCE_ID_NAMESPACE = "alchemy-cli:wallet-client-instance-name:v1";
 var safeTextSchema = (maxLen) => z.string().min(1).max(maxLen).refine((value) => !CONTROL_CHAR_RE.test(value));
 var appConfigSchema = z.object({
   id: z.string().regex(SAFE_ID_RE),
@@ -87,8 +93,13 @@ var configSchema = z.object({
   solana_fee_sponsored: z.boolean().optional().catch(void 0),
   solana_fee_policy_id: safeTextSchema(MAX_SECRET_LEN).optional().catch(void 0),
   delegated_wallet: z.boolean().optional().catch(void 0),
-  active_signer: z.enum(["session", "local"]).optional().catch(void 0)
+  active_signer: z.enum(["session", "local"]).optional().catch(void 0),
+  wallet_client_instance_id: z.string().regex(UUID_RE).optional().catch(void 0),
+  wallet_client_instance_name: z.string().transform(normalizeWhitespace).pipe(safeTextSchema(MAX_WALLET_CLIENT_INSTANCE_NAME_LEN)).optional().catch(void 0)
 }).strip();
+function normalizeWhitespace(value) {
+  return value.trim().replace(/\s+/g, " ");
+}
 function sanitizeConfig(input) {
   const parsed = configSchema.safeParse(input);
   if (!parsed.success) {
@@ -134,6 +145,57 @@ function save(cfg) {
     mode: 384
   });
 }
+function normalizeWalletClientInstanceName(value) {
+  const normalized = normalizeWhitespace(value);
+  const parsed = safeTextSchema(MAX_WALLET_CLIENT_INSTANCE_NAME_LEN).safeParse(normalized);
+  return parsed.success ? parsed.data : void 0;
+}
+function deriveWalletClientInstanceIdFromName(name) {
+  const normalized = normalizeWalletClientInstanceName(name);
+  if (normalized === void 0) {
+    throw new Error("Invalid wallet client instance name.");
+  }
+  const digest = createHash("sha256").update(WALLET_CLIENT_INSTANCE_ID_NAMESPACE).update("\0").update(normalized.toLowerCase()).digest();
+  const bytes = Buffer.from(digest.subarray(0, 16));
+  bytes[6] = bytes[6] & 15 | 80;
+  bytes[8] = bytes[8] & 63 | 128;
+  const hex = bytes.toString("hex");
+  return [
+    hex.slice(0, 8),
+    hex.slice(8, 12),
+    hex.slice(12, 16),
+    hex.slice(16, 20),
+    hex.slice(20, 32)
+  ].join("-");
+}
+function getOrCreateWalletClientInstance(input = {}) {
+  const cfg = load();
+  const instanceName = input.instanceName === void 0 ? cfg.wallet_client_instance_name : normalizeWalletClientInstanceName(input.instanceName);
+  if (input.instanceName !== void 0 && instanceName === void 0) {
+    throw new Error("Invalid wallet client instance name.");
+  }
+  if (instanceName !== void 0) {
+    const walletClientInstanceId2 = deriveWalletClientInstanceIdFromName(instanceName);
+    save({
+      ...cfg,
+      wallet_client_instance_id: walletClientInstanceId2,
+      wallet_client_instance_name: instanceName
+    });
+    return {
+      id: walletClientInstanceId2,
+      name: instanceName
+    };
+  }
+  if (cfg.wallet_client_instance_id) {
+    return { id: cfg.wallet_client_instance_id };
+  }
+  const walletClientInstanceId = randomUUID();
+  save({
+    ...cfg,
+    wallet_client_instance_id: walletClientInstanceId
+  });
+  return { id: walletClientInstanceId };
+}
 function get(cfg, key) {
   if (key === "app") {
     if (!cfg.app) return void 0;
@@ -192,6 +254,7 @@ export {
   configDir,
   load,
   save,
+  getOrCreateWalletClientInstance,
   get,
   validKeys,
   toMap

package/dist/{chunk-NT3G6BKD.js → chunk-I3X4G2UY.js}

@@ -11,7 +11,7 @@ import {
 import {
   AdminClient,
   resolveAuthToken
-} from "./chunk-PKAN5FKD.js";
+} from "./chunk-TOEVZMIP.js";
 import {
   bold,
   brand,
@@ -26,7 +26,7 @@ import {
   load,
   maskIf,
   save
-} from "./chunk-B3R6PRAL.js";
+} from "./chunk-7WD3YLRK.js";
 import {
   CLIError,
   ErrorCode,

package/dist/{chunk-PKAN5FKD.js → chunk-TOEVZMIP.js}

@@ -4,7 +4,7 @@ import {
   configDir,
   load,
   save
-} from "./chunk-B3R6PRAL.js";
+} from "./chunk-7WD3YLRK.js";
 import {
   CLIError,
   ErrorCode,
@@ -875,7 +875,9 @@ var walletSessionEnvironmentSchema = z.object({
   platform: z.string().min(1),
   arch: z.string().min(1),
   nodeVersion: z.string().min(1),
-  interactive: z.boolean()
+  interactive: z.boolean(),
+  clientInstanceId: z.string().uuid().optional(),
+  clientInstanceName: z.string().min(1).max(64).optional()
 }).strict();
 var walletSessionSchema = z.object({
   sessionId: z.string().uuid(),

package/dist/{chunk-MUT4TFQ5.js → chunk-V4IK4CJN.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-HYCRHNPX.js";
 import {
   resolveAuthToken
-} from "./chunk-PKAN5FKD.js";
+} from "./chunk-TOEVZMIP.js";
 
 // src/lib/onboarding.ts
 function hasAPIKey(cfg) {
@@ -43,7 +43,7 @@ function getSetupStatus(cfg) {
   return {
     complete: false,
     satisfiedBy: null,
-    missing: ["Provide one auth path: alchemy auth OR api-key OR access-key+app OR SIWx wallet"],
+    missing: ["Provide one auth path: alchemy auth OR api-key OR ALCHEMY_ACCESS_KEY+app OR SIWx wallet"],
     nextCommands: [
       "alchemy auth",
       "alchemy config set app",

package/dist/{chunk-5MXODL63.js → chunk-WWWVMK3J.js}

@@ -2,7 +2,7 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   configPath
-} from "./chunk-B3R6PRAL.js";
+} from "./chunk-7WD3YLRK.js";
 import {
   esc
 } from "./chunk-QEDAULQ2.js";
@@ -53,7 +53,7 @@ function semverLT(a, b) {
   return false;
 }
 function currentVersion() {
-  return true ? "0.7.0-alpha.5" : "0.0.0";
+  return true ? "0.7.0" : "0.0.0";
 }
 function toUpdateStatus(latestVersion, checkedAt) {
   const current = currentVersion();

package/dist/index.js

@@ -2,7 +2,7 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   registerAuth
-} from "./chunk-NT3G6BKD.js";
+} from "./chunk-I3X4G2UY.js";
 import {
   openBrowser
 } from "./chunk-HSKKIATB.js";
@@ -10,7 +10,7 @@ import {
   getSetupStatus,
   isSetupComplete,
   shouldRunOnboarding
-} from "./chunk-MUT4TFQ5.js";
+} from "./chunk-V4IK4CJN.js";
 import {
   isInteractiveAllowed
 } from "./chunk-HYCRHNPX.js";
@@ -41,12 +41,12 @@ import {
   resolveX402Client,
   saveSession,
   updateSession
-} from "./chunk-PKAN5FKD.js";
+} from "./chunk-TOEVZMIP.js";
 import {
   getAvailableUpdate,
   getUpdateStatus,
   printUpdateNotice
-} from "./chunk-5MXODL63.js";
+} from "./chunk-WWWVMK3J.js";
 import {
   bold,
   brand,
@@ -75,12 +75,13 @@ import {
   KEY_MAP,
   configDir,
   get,
+  getOrCreateWalletClientInstance,
   load,
   maskIf,
   save,
   toMap,
   validKeys
-} from "./chunk-B3R6PRAL.js";
+} from "./chunk-7WD3YLRK.js";
 import {
   CLIError,
   EXIT_CODES,
@@ -628,7 +629,7 @@ function registerConfig(program2) {
       printJSON(toMap(cfg));
       return;
     }
-    const { resolveAuthToken: resolveAuthToken2 } = await import("./resolve-X7HLVLGA.js");
+    const { resolveAuthToken: resolveAuthToken2 } = await import("./resolve-R4JZZCCF.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 = [
@@ -1476,13 +1477,49 @@ function toProviderSigningBindingInput(input) {
   };
 }
 async function createRemoteWalletSession(token, input) {
-  const data = await request(
-    token,
-    "POST",
-    "/wallet/sessions",
-    input
-  );
-  return unwrapAdminData(walletSessionCreateResponseSchema, data);
+  let data;
+  let requestInput = input;
+  for (let attempt = 0; attempt < 3; attempt += 1) {
+    try {
+      data = await request(
+        token,
+        "POST",
+        "/wallet/sessions",
+        requestInput
+      );
+      return unwrapAdminData(walletSessionCreateResponseSchema, data);
+    } catch (err) {
+      const retryInput = getClientInstanceCompatibilityRetryInput(requestInput, err);
+      if (retryInput === void 0) {
+        throw err;
+      }
+      requestInput = retryInput;
+    }
+  }
+  throw new CLIError(ErrorCode.NETWORK_ERROR, "Unable to create wallet session.");
+}
+function getClientInstanceCompatibilityRetryInput(input, err) {
+  if (input.environment.clientInstanceName !== void 0 && isUnsupportedClientInstanceMetadataError(err, "clientInstanceName")) {
+    const { clientInstanceName: _, ...environment } = input.environment;
+    return {
+      ...input,
+      environment
+    };
+  }
+  if (input.environment.clientInstanceId !== void 0 && isUnsupportedClientInstanceMetadataError(err, "clientInstanceId")) {
+    const { clientInstanceId: _, clientInstanceName: __, ...environment } = input.environment;
+    return {
+      ...input,
+      environment
+    };
+  }
+  return void 0;
+}
+function isUnsupportedClientInstanceMetadataError(err, fieldName) {
+  if (!(err instanceof CLIError)) {
+    return false;
+  }
+  return err.code === ErrorCode.NETWORK_ERROR && err.message.includes("HTTP 400") && (err.details?.includes(fieldName) ?? true);
 }
 async function getRemoteWalletSession(token, sessionId) {
   const data = await request(
@@ -2050,11 +2087,23 @@ async function runSessionConnect(opts) {
     clearSession();
   }
   const session = createPendingSession();
+  let clientInstance;
+  try {
+    clientInstance = getOrCreateWalletClientInstance({
+      instanceName: opts.instanceName
+    });
+  } catch {
+    throw errInvalidArgs(
+      "`--instance-name` must be 1-64 characters and cannot contain control characters."
+    );
+  }
   const sessionEnvironment = {
     platform: process.platform,
     arch: process.arch,
     nodeVersion: process.version,
-    interactive: isInteractiveAllowed(opts.program)
+    interactive: isInteractiveAllowed(opts.program),
+    clientInstanceId: clientInstance.id,
+    ...clientInstance.name === void 0 ? {} : { clientInstanceName: clientInstance.name }
   };
   updateSession({
     chainType: "evm",
@@ -2077,13 +2126,17 @@ async function runSessionConnect(opts) {
     expiresAt: remoteSession.expiresAt ?? session.expiresAt
   });
   if (!isJSONMode()) {
-    printKeyValue([
+    const summaryPairs = [
       ["Session ID", remoteSession.sessionId],
       ["Status", "pending"],
       ["Approval URL", remoteSession.approvalUrl],
       ["Created", session.createdAt],
       ["Expires", remoteSession.expiresAt ?? session.expiresAt]
-    ]);
+    ];
+    if (clientInstance.name !== void 0) {
+      summaryPairs.splice(1, 0, ["Instance", clientInstance.name]);
+    }
+    printKeyValue(summaryPairs);
     console.log(`  ${green("\u2713")} Wallet session created`);
   }
   if (!isJSONMode() && isInteractiveAllowed(opts.program)) {
@@ -2236,6 +2289,12 @@ async function runConnectFlow(program2, opts) {
   } else if (opts.mode !== void 0) {
     throw errInvalidArgs("`--mode` must be 'session' or 'local'.");
   }
+  if (opts.instanceName !== void 0) {
+    if (mode2 === "local") {
+      throw errInvalidArgs("`--instance-name` is only valid with `--mode session`.");
+    }
+    mode2 = "session";
+  }
   if (importPath) {
     if (mode2 === "session") {
       throw errInvalidArgs("`--import` is only valid with `--mode local`.");
@@ -2272,7 +2331,7 @@ async function runConnectFlow(program2, opts) {
     mode2 = choice;
   }
   if (mode2 === "session") {
-    await runSessionConnect({ program: program2, force });
+    await runSessionConnect({ program: program2, force, instanceName: opts.instanceName });
     printCrossModeHintAfterSessionConnect();
     return;
   }
@@ -2333,7 +2392,7 @@ async function buildSessionSnapshot(program2, verify) {
 }
 function registerWallets(program2) {
   const cmd = program2.command("wallet").description("Manage wallets");
-  cmd.command("connect").description("Connect a wallet for onchain actions (session or local)").option("--mode <mode>", "session | local").option("--chain <chain>", "For --mode local: evm | solana | both (default: both)").option("--import <path>", "For --mode local: import EVM key from file (implies --chain evm)").option("--force", "Replace the existing signer").action(async (opts) => {
+  cmd.command("connect").description("Connect a wallet for onchain actions (session or local)").option("--mode <mode>", "session | local").option("--chain <chain>", "For --mode local: evm | solana | both (default: both)").option("--import <path>", "For --mode local: import EVM key from file (implies --chain evm)").option("--instance-name <name>", "For --mode session: name this CLI instance").option("--force", "Replace the existing signer").action(async (opts) => {
     try {
       await runConnectFlow(program2, opts);
     } catch (err) {
@@ -4584,7 +4643,7 @@ var ERROR_RECOVERY = {
   NOT_FOUND: "Verify the resource identifier (address, hash, id) is correct",
   RATE_LIMITED: "Wait and retry; consider upgrading your Alchemy plan",
   PAYMENT_REQUIRED: "Fund your x402 wallet or switch to API key auth",
-  SETUP_REQUIRED: "Run preflight: alchemy --json config status, then follow nextCommands",
+  SETUP_REQUIRED: "Run preflight: alchemy --json --no-interactive config status, then follow nextCommands",
   INTERNAL_ERROR: "Unexpected error; retry or report a bug"
 };
 function buildCommandSchema(cmd) {
@@ -4638,7 +4697,7 @@ function buildAgentPrompt(program2) {
       "Run alchemy --json --no-interactive update-check when you need to detect available CLI upgrades"
     ],
     preflight: {
-      command: "alchemy --json config status",
+      command: "alchemy --json --no-interactive config status",
       description: "Check auth readiness before first command. If complete is false, follow nextCommands in the response to configure auth."
     },
     auth: [
@@ -4646,7 +4705,6 @@ function buildAgentPrompt(program2) {
         method: "API key",
         envVar: "ALCHEMY_API_KEY",
         flag: "--api-key <key>",
-        configKey: "api-key",
         commandFamilies: [
           "evm data",
           "evm tx",
@@ -4666,9 +4724,9 @@ function buildAgentPrompt(program2) {
       {
         method: "Access key",
         envVar: "ALCHEMY_ACCESS_KEY",
-        flag: "--access-key <key>",
         configKey: "access-key",
-        commandFamilies: ["app", "evm network"]
+        commandFamilies: ["app", "evm network"],
+        notes: "No command-line flag exists for access-key auth; use the env var or saved config."
       },
       {
         method: "Webhook API key",
@@ -4726,7 +4784,7 @@ function buildAgentPrompt(program2) {
       "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 --json --no-interactive app list --access-key $ALCHEMY_ACCESS_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 network list",
       "alchemy --json --no-interactive evm send 0xRecipient 0.001 -n eth-sepolia",
@@ -4755,7 +4813,9 @@ function formatAsSystemPrompt(payload) {
   for (const auth of payload.auth) {
     lines.push(`  ${auth.method}:`);
     lines.push(`    env:      ${auth.envVar}`);
-    lines.push(`    flag:     ${auth.flag}`);
+    if (auth.flag) {
+      lines.push(`    flag:     ${auth.flag}`);
+    }
     if (auth.configKey) {
       lines.push(`    config:   alchemy config set ${auth.configKey} <value>`);
     }
@@ -4783,7 +4843,7 @@ function formatAsSystemPrompt(payload) {
   lines.push("  For RPC method signatures, parameters, and supported networks.");
   lines.push("");
   lines.push(
-    "For full command tree, run: alchemy --json agent-prompt"
+    "For full command tree, run: alchemy --json --no-interactive agent-prompt"
   );
   lines.push("");
   return lines.join("\n");
@@ -7893,7 +7953,7 @@ function resetUpdateNoticeState() {
 }
 program.name("alchemy").description(
   "The Alchemy CLI lets you query blockchain data, call JSON-RPC methods, and manage your Alchemy configuration."
-).version("0.7.0-alpha.5", "-v, --version", "display CLI version").option("--api-key <key>", "Alchemy API key (env: ALCHEMY_API_KEY)").option(
+).version("0.7.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)"
 ).option("--x402", "Use x402 wallet-based gateway auth").option(
@@ -8080,11 +8140,11 @@ ${styledLine}`;
     "wallet"
   ];
   if (!skipAppPrompt.includes(cmdName) && isInteractiveAllowed(program) && !opts.apiKey && !process.env.ALCHEMY_API_KEY) {
-    const { resolveAuthToken: resolveAuthToken2 } = await import("./resolve-X7HLVLGA.js");
+    const { resolveAuthToken: resolveAuthToken2 } = await import("./resolve-R4JZZCCF.js");
     const authToken = resolveAuthToken2(cfg);
     const hasApiKey = Boolean(cfg.api_key?.trim() || cfg.app?.apiKey);
     if (authToken && !hasApiKey) {
-      const { selectAppAfterAuth } = await import("./auth-I5WFLU46.js");
+      const { selectAppAfterAuth } = await import("./auth-4HAUNG54.js");
       console.log("");
       console.log(`  No app selected. Please select an app to continue.`);
       await selectAppAfterAuth(authToken);
@@ -8115,7 +8175,7 @@ ${styledLine}`;
   if (isInteractiveAllowed(program)) {
     let latestForInteractiveStartup = null;
     if (shouldRunOnboarding(program, cfg)) {
-      const { runOnboarding } = await import("./onboarding-CEHXSNYD.js");
+      const { runOnboarding } = await import("./onboarding-RBJF5E7U.js");
       const latest = getAvailableUpdateOnce();
       const completed = await runOnboarding(program, latest);
       updateShownDuringInteractiveStartup = Boolean(latest);
@@ -8129,7 +8189,7 @@ ${styledLine}`;
         latestForInteractiveStartup
       );
     }
-    const { startREPL } = await import("./interactive-VXPD6N7Z.js");
+    const { startREPL } = await import("./interactive-F2AFLW7U.js");
     program.exitOverride();
     program.configureOutput({
       writeErr: () => {

package/dist/{interactive-VXPD6N7Z.js → interactive-F2AFLW7U.js}

@@ -2,14 +2,14 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   getSetupMethod
-} from "./chunk-MUT4TFQ5.js";
+} from "./chunk-V4IK4CJN.js";
 import "./chunk-HYCRHNPX.js";
 import {
   getRPCNetworkIds
-} from "./chunk-PKAN5FKD.js";
+} from "./chunk-TOEVZMIP.js";
 import {
   getUpdateNoticeLines
-} from "./chunk-5MXODL63.js";
+} from "./chunk-WWWVMK3J.js";
 import {
   bold,
   brand,
@@ -21,7 +21,7 @@ import {
 import {
   configDir,
   load
-} from "./chunk-B3R6PRAL.js";
+} from "./chunk-7WD3YLRK.js";
 import {
   bgRgb,
   isJSONMode,

package/dist/{onboarding-CEHXSNYD.js → onboarding-RBJF5E7U.js}

@@ -2,7 +2,7 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   getUpdateNoticeLines
-} from "./chunk-5MXODL63.js";
+} from "./chunk-WWWVMK3J.js";
 import {
   bold,
   brand,
@@ -14,7 +14,7 @@ import {
 import {
   load,
   save
-} from "./chunk-B3R6PRAL.js";
+} from "./chunk-7WD3YLRK.js";
 import "./chunk-QEDAULQ2.js";
 
 // src/commands/onboarding.ts
@@ -51,7 +51,7 @@ async function runOnboarding(_program, latestUpdate = null) {
       auth_token_expires_at: result.expiresAt
     });
     console.log(`  ${green("\u2713")} Logged in successfully`);
-    const { selectAppAfterAuth } = await import("./auth-I5WFLU46.js");
+    const { selectAppAfterAuth } = await import("./auth-4HAUNG54.js");
     await selectAppAfterAuth(result.token);
     return true;
   } catch (err) {

package/dist/{resolve-X7HLVLGA.js → resolve-R4JZZCCF.js}

@@ -22,8 +22,8 @@ import {
   resolveWalletSession,
   resolveX402,
   resolveX402Client
-} from "./chunk-PKAN5FKD.js";
-import "./chunk-B3R6PRAL.js";
+} from "./chunk-TOEVZMIP.js";
+import "./chunk-7WD3YLRK.js";
 import "./chunk-QEDAULQ2.js";
 export {
   adminClientFromFlags,

package/package.json

@@ -1,11 +1,28 @@
 {
   "name": "@alchemy/cli",
-  "version": "0.7.0-alpha.5",
+  "version": "0.7.0",
   "description": "Alchemy CLI — interact with blockchain data",
   "type": "module",
   "bin": {
     "alchemy": "./dist/index.js"
   },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "live:check": "node --env-file-if-exists=.env.local --import=tsx scripts/live-check.ts",
+    "postinstall": "node ./scripts/postinstall.cjs",
+    "sync:skills": "node scripts/sync-skills.mjs",
+    "update:skills": "npx skills update && pnpm sync:skills",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:e2e": "pnpm build && vitest run --config vitest.e2e.config.ts",
+    "test:live": "pnpm build && node --env-file-if-exists=.env.local ./node_modules/vitest/vitest.mjs run --config vitest.live.config.ts",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "pnpm build && changeset publish"
+  },
   "keywords": [
     "alchemy",
     "blockchain",
@@ -17,10 +34,6 @@
     "README.md",
     "scripts/postinstall.cjs"
   ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/OMGWINNING/alchemy-cli.git"
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -29,7 +42,7 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@alchemy/wallet-apis": "5.0.0-beta.22",
+    "@alchemy/wallet-apis": "5.0.0-beta.28",
     "@alchemy/x402": "^0.4.0",
     "@noble/hashes": "^2.0.1",
     "@solana-program/system": "^0.12.0",
@@ -51,21 +64,10 @@
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "live:check": "node --env-file-if-exists=.env.local --import=tsx scripts/live-check.ts",
-    "postinstall": "node ./scripts/postinstall.cjs",
-    "sync:skills": "node scripts/sync-skills.mjs",
-    "update:skills": "npx skills update && pnpm sync:skills",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "test:e2e": "pnpm build && vitest run --config vitest.e2e.config.ts",
-    "test:live": "pnpm build && node --env-file-if-exists=.env.local ./node_modules/vitest/vitest.mjs run --config vitest.live.config.ts",
-    "test:watch": "vitest",
-    "lint": "tsc --noEmit",
-    "changeset": "changeset",
-    "version-packages": "changeset version",
-    "release": "pnpm build && changeset publish"
+  "packageManager": "pnpm@10.18.2+sha512.9fb969fa749b3ade6035e0f109f0b8a60b5d08a1a87fdf72e337da90dcc93336e2280ca4e44f2358a649b83c17959e9993e777c2080879f3801e6f0d999ad3dd",
+  "pnpm": {
+    "overrides": {
+      "typebox": "1.0.81"
+    }
   }
-}
+}