@alchemy/cli 0.6.2 → 0.7.0-alpha.5

package/README.md

@@ -67,7 +67,7 @@ Quick usage examples:
 alchemy
 
 # Agent/script-friendly command
-alchemy balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --json --no-interactive
+alchemy evm data balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --json --no-interactive
 
 # Agent checks whether a newer CLI version is available
 alchemy update-check --json --no-interactive
@@ -91,56 +91,43 @@ Agents can also call `alchemy --json --no-interactive update-check` to retrieve
 Run commands as `alchemy <command>`.
 Use `alchemy help` or `alchemy help <command>` for generated command help.
 
-### Node
+### EVM
 
 | Command | What it does | Example |
 |---|---|---|
-| `balance [address]` (`bal [address]`) | Gets ETH balance for an address | `alchemy bal 0x...` |
-| `tx [hash]` | Gets transaction + receipt by hash | `alchemy tx 0x...` |
-| `receipt [hash]` | Gets transaction receipt (status, gas, logs) | `alchemy receipt 0x...` |
-| `block <number>` | Gets block details (`latest`, decimal, or hex) | `alchemy block latest` |
-| `gas` | Gets current gas prices (base fee + priority fee) | `alchemy gas -n polygon-mainnet` |
-| `logs` | Queries event logs (`eth_getLogs`) | `alchemy logs --address 0x... --from-block 18000000 --to-block 18000010` |
-| `rpc <method> [params...]` | Makes raw JSON-RPC call | `alchemy rpc eth_blockNumber` |
-| `trace <method> [params...]` | Calls Trace API methods | `alchemy trace call '{"to":"0x..."}' '["trace"]' latest` |
-| `debug <method> [params...]` | Calls Debug API methods | `alchemy debug traceTransaction "0x..."` |
-
-### Data
-
-| Command | What it does | Example |
-|---|---|---|
-| `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...` |
-| `nfts metadata --contract <addr> --token-id <id>` | Gets NFT metadata by contract/token | `alchemy nfts metadata --contract 0x... --token-id 1` |
-| `nfts contract <address>` | Gets NFT contract metadata | `alchemy nfts contract 0x...` |
-| `transfers [address]` | Gets transfer history (`alchemy_getAssetTransfers`) | `alchemy transfers 0x... --category erc20,erc721` |
-| `prices symbol <symbols>` | Gets current token prices by symbol | `alchemy prices symbol ETH,USDC` |
-| `prices address --addresses <json>` | Gets current token prices by address/network pairs | `alchemy prices address --addresses '[{"network":"eth-mainnet","address":"0x..."}]'` |
-| `prices historical --body <json>` | Gets historical prices | `alchemy prices historical --body '{"symbol":"ETH","startTime":"...","endTime":"..."}'` |
-| `portfolio tokens --body <json>` | Gets token portfolio data | `alchemy portfolio tokens --body '{...}'` |
-| `portfolio token-balances --body <json>` | Gets token balance snapshots | `alchemy portfolio token-balances --body '{...}'` |
-| `portfolio nfts --body <json>` | Gets NFT portfolio data | `alchemy portfolio nfts --body '{...}'` |
-| `portfolio nft-contracts --body <json>` | Gets NFT contract portfolio data | `alchemy portfolio nft-contracts --body '{...}'` |
-| `portfolio transactions --body <json>` | Gets portfolio transaction history | `alchemy portfolio transactions --body '{...}'` |
-| `simulate asset-changes --tx <json>` | Simulates asset changes | `alchemy simulate asset-changes --tx '{"from":"0x...","to":"0x..."}'` |
-| `simulate execution --tx <json>` | Simulates execution traces | `alchemy simulate execution --tx '{"from":"0x...","to":"0x..."}'` |
-| `simulate asset-changes-bundle --txs <json>` | Simulates bundle asset changes | `alchemy simulate asset-changes-bundle --txs '[{...}]'` |
-| `simulate execution-bundle --txs <json>` | Simulates bundle execution traces | `alchemy simulate execution-bundle --txs '[{...}]'` |
+| `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 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 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..."}'` |
 
 ### 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.
+
 | Command | What it does | Example |
 |---|---|---|
-| `wallet generate` | Generates wallet for x402 and saves to config | `alchemy wallet generate` |
-| `wallet import <path>` | Imports wallet key file for x402 | `alchemy wallet import ./private-key.txt` |
-| `wallet address` | Prints configured wallet address | `alchemy wallet address` |
-| `bundler send-user-operation ...` | Sends ERC-4337 user op | `alchemy bundler send-user-operation --user-op '{...}' --entry-point 0x...` |
-| `bundler estimate-user-operation-gas ...` | Estimates ERC-4337 user op gas | `alchemy bundler estimate-user-operation-gas --user-op '{...}' --entry-point 0x...` |
-| `bundler get-user-operation-receipt ...` | Gets ERC-4337 user op receipt | `alchemy bundler get-user-operation-receipt --user-op-hash 0x...` |
-| `gas-manager request-gas-and-paymaster --body <json>` | Requests paymaster data | `alchemy gas-manager request-gas-and-paymaster --body '{...}'` |
-| `gas-manager request-paymaster-token-quote --body <json>` | Gets paymaster token quote | `alchemy gas-manager request-paymaster-token-quote --body '{...}'` |
+| `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` |
+
+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>` |
@@ -150,9 +137,10 @@ 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 --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>"}'` |
+| `solana network list` | Lists networks from the Solana namespace | `alchemy solana network list --search solana` |
+| `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
 
@@ -172,7 +160,9 @@ Use `alchemy help` or `alchemy help <command>` for generated command help.
 | `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` |
-| `setup status` | Shows setup status + next commands | `alchemy setup status` |
+| `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 get <key>` | Gets one config value | `alchemy config get network` |
@@ -229,20 +219,16 @@ 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>` |
-| `tokens allowance` | `--owner <address>` (required), `--spender <address>` (required), `--contract <address>` (required) |
-| `transfers` | `--from-address <address>`, `--to-address <address>`, `--from-block <block>`, `--to-block <block>`, `--category <list>`, `--max-count <n>`, `--page-key <key>` |
-| `prices address` | `--addresses <json>` (required) |
-| `prices historical` | `--body <json>` (required) |
-| `portfolio *` | `--body <json>` (required per subcommand) |
-| `simulate *` | `--tx <json>` or `--txs <json>` (required) |
+| `evm data nfts` | `--limit <n>`, `--page-key <key>` |
+| `evm data nfts metadata` | `--contract <address>` (required), `--token-id <id>` (required) |
+| `evm data tokens balances` | `--page-key <key>` |
+| `evm data tokens allowance` | `--owner <address>` (required), `--spender <address>` (required), `--contract <address>` (required) |
+| `evm data history` | `--from-address <address>`, `--to-address <address>`, `--from-block <block>`, `--to-block <block>`, `--category <list>`, `--max-count <n>`, `--page-key <key>` |
+| `evm data price address` | `--addresses <json>` (required) |
+| `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) |
-| `bundler send-user-operation` | `--user-op <json>` (required), `--entry-point <address>` (required) |
-| `bundler estimate-user-operation-gas` | `--user-op <json>` (required), `--entry-point <address>` (required), `--state-override <json>` |
-| `bundler get-user-operation-receipt` | `--user-op-hash <hash>` (required) |
-| `gas-manager *` | `--body <json>` (required) |
 | `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` |
@@ -251,7 +237,9 @@ 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` | `--mainnet-only`, `--testnet-only`, `--search <term>` |
+| `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 reset` | `-y, --yes` |
 
 ## Authentication Reference
@@ -284,8 +272,8 @@ Run `alchemy` with no command in an interactive terminal:
 
 ```bash
 alchemy
-alchemy ◆ balance 0x...
-alchemy ◆ block latest
+alchemy ◆ evm data balance 0x...
+alchemy ◆ evm block latest
 alchemy ◆ exit
 ```
 

package/dist/auth-I5WFLU46.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-NT3G6BKD.js";
+import "./chunk-HSKKIATB.js";
+import "./chunk-HYCRHNPX.js";
+import "./chunk-PKAN5FKD.js";
+import "./chunk-A6L3WCJN.js";
+import "./chunk-B3R6PRAL.js";
+import "./chunk-QEDAULQ2.js";
+export {
+  registerAuth,
+  selectAppAfterAuth
+};

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

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

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

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

package/dist/{chunk-NBDWF4ZQ.js → chunk-A6L3WCJN.js}

@@ -5,7 +5,7 @@ import {
   isJSONMode,
   quiet,
   rgb
-} from "./chunk-56ZVYB4G.js";
+} from "./chunk-QEDAULQ2.js";
 
 // src/lib/terminal-ui.ts
 import * as readline from "readline";
@@ -48,6 +48,9 @@ function suspendStdinKeypressListeners() {
 }
 async function runListPrompt(opts) {
   if (!stdin.isTTY || !stdout.isTTY) {
+    if (opts.allowMultiple) {
+      return { value: opts.initialValues ?? [], cancelled: false };
+    }
     const initial = opts.initialValue ?? opts.options.find((o) => !o.disabled)?.value ?? null;
     return { value: initial, cancelled: false };
   }
@@ -61,7 +64,7 @@ async function runListPrompt(opts) {
     0,
     opts.options.findIndex((o) => o.value === opts.initialValue && !o.disabled)
   );
-  const selected = /* @__PURE__ */ new Set();
+  const selected = new Set(opts.initialValues ?? []);
   const maxVisible = 8;
   let renderedLines = 0;
   const getFiltered = () => {
@@ -104,10 +107,11 @@ async function runListPrompt(opts) {
         const active = start + i === cursor;
         const disabled = option.disabled === true;
         const selectedMark = opts.allowMultiple ? selected.has(option.value) ? ansi.green("\u25C6") : ansi.dim("\u25C7") : active ? ansi.cyan("\u25C6") : ansi.dim("\u25C7");
+        const activeMark = active ? ansi.cyan("\u203A") : " ";
         const label = optionLabel(option);
         const value = disabled ? ansi.dim(label) : label;
         const hint = option.hint ? ` ${ansi.dim(`\u2014 ${option.hint}`)}` : "";
-        lines.push(`  ${ansi.dim(FLOW_PIPE)}  ${selectedMark} ${value}${hint}`);
+        lines.push(`  ${ansi.dim(FLOW_PIPE)} ${activeMark} ${selectedMark} ${value}${hint}`);
       }
       if (filtered.length > maxVisible) {
         lines.push(`  ${ansi.dim(FLOW_PIPE)} ${ansi.dim(`${filtered.length} options`)}`);
@@ -217,16 +221,26 @@ async function promptText(opts) {
   const question = `  ${ansi.cyan("\u25C6")} ${opts.message}${opts.placeholder ? ` ${ansi.dim(`(${opts.placeholder})`)}` : ""}: `;
   const previousRawMode = stdin.isRaw;
   if (previousRawMode) stdin.setRawMode(false);
+  const ABORTED = /* @__PURE__ */ Symbol("aborted");
   const value = await new Promise((resolve) => {
     rl.on("SIGINT", () => resolve(null));
     rl.question(question, (answer) => resolve(answer));
+    if (opts.abortSignal) {
+      const onAbort = () => resolve(ABORTED);
+      if (opts.abortSignal.aborted) {
+        onAbort();
+      } else {
+        opts.abortSignal.addEventListener("abort", onAbort, { once: true });
+      }
+    }
   });
   rl.close();
   restoreKeypressListeners();
   if (previousRawMode) stdin.setRawMode(true);
-  if (opts.clearAfterSubmit) {
+  if (opts.clearAfterSubmit || value === ABORTED) {
     clearRenderedLines(2);
   }
+  if (value === ABORTED) return "";
   if (value === null) {
     printCancel(opts.cancelMessage);
     return null;
@@ -281,6 +295,7 @@ async function promptMultiselect(opts) {
   const result = await runListPrompt({
     message: opts.message,
     options: opts.options,
+    initialValues: opts.initialValues,
     allowMultiple: true,
     required: opts.required,
     commitLabel: "Selected"
@@ -362,29 +377,24 @@ async function withSpinner(label, doneLabel, fn) {
   if (isJSONMode() || quiet) return fn();
   return runWithSpinner(label, doneLabel, fn);
 }
-function printKeyValueBox(pairs) {
+function printKeyValue(pairs, withBottomPadding = true) {
   if (isJSONMode()) return;
+  console.log("");
   if (pairs.length === 0) {
-    console.log(`  ${ansi2.brand("\u250C\u2500\u2500\u2510")}`);
-    console.log(`  ${ansi2.brand("\u2514\u2500\u2500\u2518")}`);
+    if (withBottomPadding) {
+      console.log("");
+    }
     return;
   }
-  const keyWidth = Math.max(...pairs.map(([k]) => stripAnsi(k).length));
-  const contentRows = pairs.map(([key, value]) => {
+  const maxLen = Math.max(...pairs.map(([k]) => stripAnsi(k).length));
+  for (const [key, value] of pairs) {
     const visibleKeyLen = stripAnsi(key).length;
-    const paddedKey = key + " ".repeat(Math.max(0, keyWidth - visibleKeyLen));
-    return `${ansi2.dim(paddedKey)}  ${value}`;
-  });
-  const contentWidth = Math.max(...contentRows.map((row) => stripAnsi(row).length));
-  const top = `\u250C${"\u2500".repeat(contentWidth + 2)}\u2510`;
-  const bottom = `\u2514${"\u2500".repeat(contentWidth + 2)}\u2518`;
-  console.log(`  ${ansi2.dim(top)}`);
-  for (const row of contentRows) {
-    const visibleLen = stripAnsi(row).length;
-    const padded = row + " ".repeat(Math.max(0, contentWidth - visibleLen));
-    console.log(`  ${ansi2.dim("\u2502")} ${padded} ${ansi2.dim("\u2502")}`);
+    const paddedKey = key + " ".repeat(Math.max(0, maxLen - visibleKeyLen));
+    console.log(`  ${ansi2.dim(paddedKey)}  ${value}`);
+  }
+  if (withBottomPadding) {
+    console.log("");
   }
-  console.log(`  ${ansi2.dim(bottom)}`);
 }
 function emptyState(message) {
   if (isJSONMode()) return;
@@ -543,7 +553,7 @@ export {
   successBadge,
   failBadge,
   withSpinner,
-  printKeyValueBox,
+  printKeyValue,
   emptyState,
   printSyntaxJSON,
   printTable,

package/dist/{chunk-BAAQ7ELR.js → chunk-B3R6PRAL.js}

@@ -2,7 +2,7 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   isRevealMode
-} from "./chunk-56ZVYB4G.js";
+} from "./chunk-QEDAULQ2.js";
 
 // src/lib/secrets.ts
 function maskSecret(value) {
@@ -35,7 +35,23 @@ var KEY_MAP = {
   "auth-token": "auth_token",
   auth_token: "auth_token",
   "auth-token-expires-at": "auth_token_expires_at",
-  auth_token_expires_at: "auth_token_expires_at"
+  auth_token_expires_at: "auth_token_expires_at",
+  "solana-wallet-key-file": "solana_wallet_key_file",
+  solana_wallet_key_file: "solana_wallet_key_file",
+  "solana-wallet-address": "solana_wallet_address",
+  solana_wallet_address: "solana_wallet_address",
+  "evm-gas-sponsored": "evm_gas_sponsored",
+  evm_gas_sponsored: "evm_gas_sponsored",
+  "evm-gas-policy-id": "evm_gas_policy_id",
+  evm_gas_policy_id: "evm_gas_policy_id",
+  "solana-fee-sponsored": "solana_fee_sponsored",
+  solana_fee_sponsored: "solana_fee_sponsored",
+  "solana-fee-policy-id": "solana_fee_policy_id",
+  solana_fee_policy_id: "solana_fee_policy_id",
+  "delegated-wallet": "delegated_wallet",
+  delegated_wallet: "delegated_wallet",
+  "active-signer": "active_signer",
+  active_signer: "active_signer"
 };
 var SAFE_ID_RE = /^[A-Za-z0-9:_-]{1,128}$/;
 var SAFE_NETWORK_RE = /^[A-Za-z0-9:_-]{1,128}$/;
@@ -63,7 +79,15 @@ var configSchema = z.object({
   auth_token: safeTextSchema(MAX_SECRET_LEN).optional().catch(void 0),
   auth_token_expires_at: safeTextSchema(MAX_SECRET_LEN).optional().catch(void 0),
   siwe_token: safeTextSchema(MAX_PATH_LEN).optional().catch(void 0),
-  siwe_token_expires_at: safeTextSchema(MAX_SECRET_LEN).optional().catch(void 0)
+  siwe_token_expires_at: safeTextSchema(MAX_SECRET_LEN).optional().catch(void 0),
+  solana_wallet_key_file: safeTextSchema(MAX_PATH_LEN).optional().catch(void 0),
+  solana_wallet_address: safeTextSchema(MAX_SECRET_LEN).optional().catch(void 0),
+  evm_gas_sponsored: z.boolean().optional().catch(void 0),
+  evm_gas_policy_id: safeTextSchema(MAX_SECRET_LEN).optional().catch(void 0),
+  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)
 }).strip();
 function sanitizeConfig(input) {
   const parsed = configSchema.safeParse(input);
@@ -72,6 +96,13 @@ function sanitizeConfig(input) {
   }
   return parsed.data;
 }
+function applyLegacyMigration(cfg) {
+  if (cfg.active_signer === void 0 && cfg.delegated_wallet === true) {
+    const { delegated_wallet: _, ...rest } = cfg;
+    return { ...rest, active_signer: "session" };
+  }
+  return cfg;
+}
 function getHome() {
   return process.env.HOME || homedir();
 }
@@ -88,7 +119,7 @@ function load() {
   if (!existsSync(p)) return {};
   try {
     const data = readFileSync(p, "utf-8");
-    return sanitizeConfig(JSON.parse(data));
+    return applyLegacyMigration(sanitizeConfig(JSON.parse(data)));
   } catch {
     console.error(`warning: could not parse config file at ${p} \u2014 using defaults`);
     return {};
@@ -97,6 +128,7 @@ function load() {
 function save(cfg) {
   const p = configPath();
   const sanitized = sanitizeConfig(cfg);
+  delete sanitized.delegated_wallet;
   mkdirSync(dirname(p), { recursive: true, mode: 493 });
   writeFileSync(p, JSON.stringify(sanitized, null, 2) + "\n", {
     mode: 384
@@ -115,6 +147,21 @@ function get(cfg, key) {
   if (typeof value === "string") return value;
   return void 0;
 }
+function validKeys() {
+  return [
+    "api-key",
+    "access-key",
+    "webhook-api-key",
+    "network",
+    "verbose",
+    "wallet-key-file",
+    "x402",
+    "evm-gas-sponsored",
+    "evm-gas-policy-id",
+    "solana-fee-sponsored",
+    "solana-fee-policy-id"
+  ];
+}
 function toMap(cfg) {
   const m = {};
   if (cfg.api_key) m["api-key"] = maskIf(cfg.api_key);
@@ -128,6 +175,13 @@ function toMap(cfg) {
   if (cfg.x402 !== void 0) m["x402"] = String(cfg.x402);
   if (cfg.auth_token) m["auth-token"] = maskIf(cfg.auth_token);
   if (cfg.auth_token_expires_at) m["auth-token-expires-at"] = cfg.auth_token_expires_at;
+  if (cfg.solana_wallet_key_file) m["solana-wallet-key-file"] = cfg.solana_wallet_key_file;
+  if (cfg.solana_wallet_address) m["solana-wallet-address"] = cfg.solana_wallet_address;
+  if (cfg.evm_gas_sponsored !== void 0) m["evm-gas-sponsored"] = String(cfg.evm_gas_sponsored);
+  if (cfg.evm_gas_policy_id) m["evm-gas-policy-id"] = cfg.evm_gas_policy_id;
+  if (cfg.solana_fee_sponsored !== void 0) m["solana-fee-sponsored"] = String(cfg.solana_fee_sponsored);
+  if (cfg.solana_fee_policy_id) m["solana-fee-policy-id"] = cfg.solana_fee_policy_id;
+  if (cfg.active_signer !== void 0) m["active-signer"] = cfg.active_signer;
   return m;
 }
 
@@ -139,5 +193,6 @@ export {
   load,
   save,
   get,
+  validKeys,
   toMap
 };