alchemy-cli

用途：Alchemy CLI 是面向实时智能体工作的终端工具，用于本会话内的链上实时查询、分析与账户/应用管理。安装：npm i -g @alchemy/cli。会话开始时运行 alchemy --json --no-interactive agent-prompt 获取完整命令契约。所有命令应始终加 --json --no-interactive，退出码 0 解析 stdout，非 0 解析 stderr 的 JSON。首次使用建议先跑 setup status 与 gas 两个预检，再按需执行 alchemy auth login 或 alchemy config set api-key <key> 等认证配置。主要能力：查询 ETH 余额、交易、收据、区块、gas、日志、原始 RPC、trace/debug；Token 余额与元数据、NFT 列表与元数据、转账历史、价格、跨网络 Portfolio；交易模拟（资产变化与执行轨迹）；Solana RPC 与 DAS；Webhooks 增删改查；ERC-4337 bundler 与 gas-manager；x402 钱包生成与导入；Apps 管理、网络列表与 CLI 配置。适用场景为智能体在当前会话中做实时链上查询、分析与管理。限制：不用于编写生产应用代码，此类需求应转 alchemy-api 或 agentic-gateway；有对应 CLI 命令时不应改用 curl 或原始 HTTP；x402 相关命令需钱包密钥；部分 apps 子命令需访问密钥。错误以结构化 JSON 返回，含 code、exitCode、retryable 与恢复提示。