@alchemy/cli 0.1.0

package/README.md

@@ -0,0 +1,336 @@
+# Alchemy CLI
+
+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.
+
+## Installation
+
+The current repository workflow is source install:
+
+```bash
+git clone https://github.com/alchemyplatform/alchemy-cli.git
+cd alchemy-cli
+pnpm install
+pnpm build
+pnpm link --global
+```
+
+This makes the `alchemy` command available globally.  
+To unlink later: `pnpm unlink --global`.
+
+## Command Reference
+
+Run commands as `alchemy <command>`.
+Use `alchemy help` or `alchemy help <command>` for generated command help.
+
+### Node
+
+| 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...` |
+| `block <number>` | Gets block details (`latest`, decimal, or hex) | `alchemy block latest` |
+| `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 [address]` | Lists ERC-20 balances for an address | `alchemy tokens 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 '[{...}]'` |
+
+### Wallets
+
+| 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 '{...}'` |
+| `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
+
+| Command | What it does | Example |
+|---|---|---|
+| `network list` | Lists supported RPC networks | `alchemy network list --configured` |
+| `chains list` | Lists Admin API chain enums | `alchemy chains list` |
+| `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>"}'` |
+
+### CLI Admin
+
+| Command | What it does | Example |
+|---|---|---|
+| `(no command)` | Starts interactive REPL mode (TTY only) | `alchemy` |
+| `apps list` | Lists apps (supports pagination/filtering) | `alchemy apps list --all` |
+| `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` |
+| `setup status` | Shows setup status + next commands | `alchemy setup status` |
+| `config set ...` | Sets config values | `alchemy config set api-key <key>` |
+| `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` |
+| `version` | Prints CLI version | `alchemy version` |
+
+## Flags
+
+### Global flags
+
+These apply to all commands.
+
+#### Auth & network
+
+| 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 |
+
+#### Output & formatting
+
+| Flag | Env var | Description |
+|---|---|---|
+| `--json` | — | Force JSON output |
+| `-q, --quiet` | — | Suppress non-essential output |
+| `-v, --verbose` | — | Enable verbose output |
+| `--no-color` | `NO_COLOR` | Disable color output |
+| `--reveal` | — | Show secrets in plain text (TTY only) |
+
+#### Runtime & behavior
+
+| Flag | Env var | Description |
+|---|---|---|
+| `--timeout <ms>` | — | Request timeout in milliseconds |
+| `--debug` | — | Enable internal debug diagnostics |
+| `--no-interactive` | — | Disable REPL and prompt-driven interactions |
+
+Additional env vars:
+
+| Env var | Description |
+|---|---|
+| `ALCHEMY_CONFIG` | Custom path to config file |
+| `ALCHEMY_WALLET_KEY` | Wallet private key for x402 auth |
+| `ALCHEMY_WEBHOOK_API_KEY` | Webhook API key for Notify commands |
+
+### Command-specific flags
+
+| Command | Flags |
+|---|---|
+| `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) |
+| `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` |
+| `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` |
+| `network list` | `--configured`, `--app-id <id>` |
+| `config reset` | `-y, --yes` |
+
+## Authentication
+
+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)
+- x402 wallet key for wallet-authenticated blockchain queries
+
+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>
+
+# Environment variable
+export ALCHEMY_API_KEY=<your-key>
+
+# Per-command override
+alchemy balance 0x... --api-key <your-key>
+```
+
+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>
+
+# Environment variable
+export ALCHEMY_ACCESS_KEY=<your-key>
+
+# Per-command override
+alchemy apps list --access-key <your-key>
+```
+
+Resolution order: `--access-key` -> `ALCHEMY_ACCESS_KEY` -> config file.
+
+#### x402 wallet auth
+
+```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.
+
+## REPL Mode
+
+Run `alchemy` with no command in an interactive terminal:
+
+```bash
+alchemy
+alchemy ◆ balance 0x...
+alchemy ◆ block latest
+alchemy ◆ exit
+```
+
+Use `--no-interactive` to disable REPL/prompts in automation.
+
+## Output Modes
+
+- TTY: formatted human output
+- Non-TTY: JSON output (script-friendly)
+- `--json`: forces JSON output in any context
+- `--verbose` or `alchemy config set verbose true`: includes richer payload output on supported commands
+
+## Error Format
+
+Errors are structured JSON in JSON mode:
+
+```json
+{
+  "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>"
+  }
+}
+```
+
+## Development
+
+Prerequisites:
+
+- [Node.js 18+](https://nodejs.org/)
+- [pnpm](https://pnpm.io/)
+
+Run during development:
+
+```bash
+# Run without building
+npx tsx src/index.ts balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
+
+# Build in watch mode
+pnpm dev
+```
+
+Build:
+
+```bash
+pnpm build
+```
+
+Test:
+
+```bash
+pnpm test
+pnpm test:e2e
+```
+
+Type check:
+
+```bash
+pnpm lint
+```
+
+Coverage:
+
+```bash
+pnpm test:coverage
+```
+
+### Endpoint Override Env Vars (Local Testing Only)
+
+These are for local/mock testing, not normal production usage:
+
+- `ALCHEMY_RPC_BASE_URL`
+- `ALCHEMY_ADMIN_API_BASE_URL`
+- `ALCHEMY_X402_BASE_URL`
+
+Safety constraints:
+
+- Only localhost targets are accepted (`localhost`, `127.0.0.1`, `::1`)
+- Non-HTTPS transport is allowed only for localhost
+- Production defaults are unchanged when unset

package/dist/chunk-F7KTEZFZ.js

@@ -0,0 +1,282 @@
+#!/usr/bin/env node
+if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
+import {
+  isInteractiveAllowed
+} from "./chunk-QKXQW4OF.js";
+
+// src/lib/networks.ts
+var TESTNET_TOKEN_RE = /(testnet|sepolia|holesky|hoodi|devnet|minato|amoy|fuji|saigon|cardona|aeneid|curtis|chiado|cassiopeia|blaze|ropsten|signet|mocha|fam|bepolia)$/i;
+var FAMILY_ALIASES = {
+  arb: "Arbitrum",
+  arbnova: "Arbitrum Nova",
+  avax: "Avalanche",
+  bnb: "BNB Smart Chain",
+  eth: "Ethereum",
+  opt: "OP Mainnet",
+  polygonzkevm: "Polygon zkEVM"
+};
+var NAME_ALIASES = {
+  arb: "Arbitrum",
+  avax: "Avalanche",
+  bnb: "BNB",
+  eth: "Ethereum",
+  opbnb: "opBNB",
+  opt: "OP Mainnet",
+  sui: "SUI",
+  xmtp: "XMTP",
+  zksync: "ZKsync"
+};
+var RPC_NETWORK_IDS = [
+  "abstract-mainnet",
+  "abstract-testnet",
+  "adi-mainnet",
+  "adi-testnet",
+  "alchemy-internal",
+  "alchemy-sepolia",
+  "alchemyarb-fam",
+  "alchemyarb-sepolia",
+  "alterscope-mainnet",
+  "anime-mainnet",
+  "anime-sepolia",
+  "apechain-curtis",
+  "apechain-mainnet",
+  "aptos-mainnet",
+  "aptos-testnet",
+  "arb-mainnet",
+  "arb-sepolia",
+  "arbnova-mainnet",
+  "arc-testnet",
+  "astar-mainnet",
+  "avax-fuji",
+  "avax-mainnet",
+  "base-mainnet",
+  "base-sepolia",
+  "berachain-bepolia",
+  "berachain-mainnet",
+  "bitcoin-mainnet",
+  "bitcoin-signet",
+  "bitcoin-testnet",
+  "blast-mainnet",
+  "blast-sepolia",
+  "bnb-mainnet",
+  "bnb-testnet",
+  "bob-mainnet",
+  "bob-sepolia",
+  "boba-mainnet",
+  "boba-sepolia",
+  "botanix-mainnet",
+  "botanix-testnet",
+  "celestiabridge-mainnet",
+  "celestiabridge-mocha",
+  "celo-mainnet",
+  "celo-sepolia",
+  "citrea-mainnet",
+  "citrea-testnet",
+  "clankermon-mainnet",
+  "commons-mainnet",
+  "crossfi-mainnet",
+  "crossfi-testnet",
+  "degen-mainnet",
+  "degen-sepolia",
+  "earnm-mainnet",
+  "earnm-sepolia",
+  "edge-mainnet",
+  "edge-testnet",
+  "eth-holesky",
+  "eth-holeskybeacon",
+  "eth-hoodi",
+  "eth-hoodibeacon",
+  "eth-mainnet",
+  "eth-mainnetbeacon",
+  "eth-sepolia",
+  "eth-sepoliabeacon",
+  "flow-mainnet",
+  "flow-testnet",
+  "frax-hoodi",
+  "frax-mainnet",
+  "galactica-cassiopeia",
+  "galactica-mainnet",
+  "gensyn-mainnet",
+  "gensyn-testnet",
+  "gnosis-chiado",
+  "gnosis-mainnet",
+  "humanity-mainnet",
+  "humanity-testnet",
+  "hyperliquid-mainnet",
+  "hyperliquid-testnet",
+  "ink-mainnet",
+  "ink-sepolia",
+  "lens-mainnet",
+  "lens-sepolia",
+  "linea-mainnet",
+  "linea-sepolia",
+  "mantle-mainnet",
+  "mantle-sepolia",
+  "megaeth-mainnet",
+  "megaeth-testnet",
+  "metis-mainnet",
+  "mode-mainnet",
+  "mode-sepolia",
+  "monad-mainnet",
+  "monad-testnet",
+  "moonbeam-mainnet",
+  "mythos-mainnet",
+  "opbnb-mainnet",
+  "opbnb-testnet",
+  "openloot-sepolia",
+  "opt-mainnet",
+  "opt-sepolia",
+  "plasma-mainnet",
+  "plasma-testnet",
+  "polygon-amoy",
+  "polygon-mainnet",
+  "polygonzkevm-cardona",
+  "polygonzkevm-mainnet",
+  "polynomial-mainnet",
+  "polynomial-sepolia",
+  "race-mainnet",
+  "race-sepolia",
+  "risa-testnet",
+  "rise-testnet",
+  "ronin-mainnet",
+  "ronin-saigon",
+  "rootstock-mainnet",
+  "rootstock-testnet",
+  "scroll-mainnet",
+  "scroll-sepolia",
+  "sei-mainnet",
+  "sei-testnet",
+  "settlus-mainnet",
+  "settlus-septestnet",
+  "shape-mainnet",
+  "shape-sepolia",
+  "solana-devnet",
+  "solana-mainnet",
+  "soneium-mainnet",
+  "soneium-minato",
+  "sonic-blaze",
+  "sonic-mainnet",
+  "sonic-testnet",
+  "stable-mainnet",
+  "stable-testnet",
+  "standard-mainnet",
+  "starknet-mainnet",
+  "starknet-sepolia",
+  "story-aeneid",
+  "story-mainnet",
+  "sui-mainnet",
+  "sui-testnet",
+  "superseed-mainnet",
+  "superseed-sepolia",
+  "synd-mainnet",
+  "syndicate-manchego",
+  "tea-sepolia",
+  "tempo-testnet",
+  "tron-mainnet",
+  "tron-testnet",
+  "unichain-mainnet",
+  "unichain-sepolia",
+  "unite-mainnet",
+  "unite-testnet",
+  "worldchain-mainnet",
+  "worldchain-sepolia",
+  "worldl3-devnet",
+  "worldmobile-devnet",
+  "worldmobile-testnet",
+  "worldmobilechain-mainnet",
+  "xmtp-mainnet",
+  "xmtp-ropsten",
+  "xprotocol-mainnet",
+  "zetachain-mainnet",
+  "zetachain-testnet",
+  "zksync-mainnet",
+  "zksync-sepolia",
+  "zora-mainnet",
+  "zora-sepolia"
+];
+function isTestnetNetwork(id) {
+  return TESTNET_TOKEN_RE.test(id);
+}
+function tokenToName(token) {
+  const alias = NAME_ALIASES[token];
+  if (alias) return alias;
+  return token.charAt(0).toUpperCase() + token.slice(1);
+}
+function toFamily(id) {
+  const [head] = id.split("-");
+  return FAMILY_ALIASES[head] ?? tokenToName(head);
+}
+function toDisplayName(id) {
+  return id.split("-").map((part) => tokenToName(part)).join(" ");
+}
+function toHttpsUrlTemplate(id) {
+  if (id === "starknet-mainnet" || id === "starknet-sepolia") {
+    return `https://${id}.g.alchemy.com/starknet/version/rpc/v0_10/{apiKey}`;
+  }
+  return `https://${id}.g.alchemy.com/v2/{apiKey}`;
+}
+function getRPCNetworks() {
+  return RPC_NETWORK_IDS.map((id) => ({
+    id,
+    name: toDisplayName(id),
+    family: toFamily(id),
+    isTestnet: isTestnetNetwork(id),
+    httpsUrlTemplate: toHttpsUrlTemplate(id)
+  }));
+}
+function getRPCNetworkIds() {
+  return [...RPC_NETWORK_IDS];
+}
+
+// src/lib/onboarding.ts
+function hasAPIKey(cfg) {
+  return Boolean(cfg.api_key?.trim());
+}
+function hasAccessKeyAndApp(cfg) {
+  return Boolean(cfg.access_key?.trim() && cfg.app?.id && cfg.app.apiKey);
+}
+function hasX402Wallet(cfg) {
+  return cfg.x402 === true && Boolean(cfg.wallet_key_file?.trim());
+}
+function getSetupMethod(cfg) {
+  if (hasAPIKey(cfg)) return "api_key";
+  if (hasAccessKeyAndApp(cfg)) return "access_key_app";
+  if (hasX402Wallet(cfg)) return "x402_wallet";
+  return null;
+}
+function isSetupComplete(cfg) {
+  return getSetupMethod(cfg) !== null;
+}
+function getSetupStatus(cfg) {
+  const satisfiedBy = getSetupMethod(cfg);
+  if (satisfiedBy) {
+    return {
+      complete: true,
+      satisfiedBy,
+      missing: [],
+      nextCommands: []
+    };
+  }
+  return {
+    complete: false,
+    satisfiedBy: null,
+    missing: ["Provide one auth path: api-key OR access-key+app OR x402+wallet-key-file"],
+    nextCommands: [
+      "alchemy config set api-key <key>",
+      "alchemy config set access-key <key> && alchemy config set app <app-id>",
+      "alchemy wallet generate && alchemy config set x402 true"
+    ]
+  };
+}
+function shouldRunOnboarding(program, cfg) {
+  return isInteractiveAllowed(program) && !isSetupComplete(cfg);
+}
+
+export {
+  getRPCNetworks,
+  getRPCNetworkIds,
+  getSetupMethod,
+  isSetupComplete,
+  getSetupStatus,
+  shouldRunOnboarding
+};