炼金液

Alchemy CLI是查询块链数据和管理Alchemy应用/配置的命令行工具. 它既支持人性友好的终端输出,也支持JSON输出自动化. 您可以根据命令使用浏览器登录、 API 密钥或 x402 钱包认证 .

能力一览

安装

从 npm 全球安装 :

npm i -g @alchemy/cli

或者不在全球安装就运行 :

npx @alchemy/cli <command>

贝壳补全

为所有命令和子命令启用标签补全 :

# zsh (add to ~/.zshrc)
echo 'eval "$(alchemy completions zsh)"' >> ~/.zshrc
source ~/.zshrc

# bash (add to ~/.bashrc)
echo 'eval "$(alchemy completions bash)"' >> ~/.bashrc
source ~/.bashrc

# fish
alchemy completions fish > ~/.config/fish/completions/alchemy.fish

开始

认证快速启动

在提出请求之前需要认证。 建议的路径是浏览器登录 :

alchemy auth

这将打开浏览器链接您的 Alchemy 账户, 然后提示您选择一个应用程序 。 选中的应用程序的 API 密钥自动保存到您的配置中 。 过 -y 以跳过确认提示.

如果你运行 alchemy 没有命令和未配置认证, CLI 将自动引导您通过浏览器登录 .

如果您有认证符但还没有选择应用程序, CLI 将提示您在运行任何需要 API 密钥的命令之前先选择一个 。 拥有许多应用程序的团队可以按名进行打入搜索.

如果您使用 Noty webhooks,请在上方通过 alchemy config set webhook-api-key <key>, (中文(简体) ), --webhook-api-key 打开 alchemy webhook 命令,或 ALCHEMY_WEBHOOK_API_KEY。 。 。 .

按工作流程使用

Auth 配置后, 根据驾驶者使用不同的 CLI :

• 人类(互动终端): 开始 alchemy 并使用终端 UI/设置流程;这是推荐给人类使用的路径
• 代理/记录(自动): 使用情况 --json --no-interactive 以保证 JSON 输出和禁用提示( JSON 在管道被自动启用, 但是 --json 是安全默认)

快速使用示例 :

# Human recommended entrypoint
alchemy

# Agent/script-friendly command
alchemy evm data balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -n eth-mainnet --json --no-interactive

# Agent checks whether a newer CLI version is available
alchemy update-check --json --no-interactive

代理拖带

让你的经纪人跑 agent-prompt 作为获得完整、机器可读合同的第一步,该合同描述了每个命令、认证方法、错误代码和执行规则:

# Agent runs this once to learn everything the CLI can do
alchemy --json --no-interactive agent-prompt

这将返回一个带有执行策略的 JSON 文件、 运行时发现指示、 飞行前指示、 认证矩阵、 包含所有参数和选项的完整命令树、 包含恢复动作的错误代码以及实例引用 。 不需要外部文件 .

特工也可以打电话 alchemy --json --no-interactive update-check 以获取当前 CLI 版本、最新已知版本并安装升级命令.

命令参考

运行命令为 alchemy <command>。 。 。 . 使用 alchemy help 或者说 alchemy help <command> 用于生成命令帮助.

EVM( 视频)

钱包

alchemy wallet 暴露出一个统一的链动表面. 这个 会话钱包 (Alchemy/Privy管理,P-256授权签字人)是建议流量;a 本地钱包 (私钥存储于磁盘上)作为替代支持.

每个命令覆盖: 通过 --signer <session\|local> 改为 evm send, (中文(简体) ), evm approve, (中文(简体) ), evm swap, (中文(简体) ), xchain bridge,或 evm contract call 为单一引用而覆盖当前签名符.

链条

x402 (韩语)

非交互式运行(包括 --json要求 --max-payment,它作为支付授权;支付签名在当地核实,以便在发送前恢复到钱包地址.

CLI 管理员

反馈

feedback 为经认证的Alchemy用户/团队提交产品反馈。 这个 使用浏览器-login auth,不需要选择的应用或应用 API 密钥.

alchemy feedback Love the new usage command
printf "Line one\nLine two\n" | alchemy feedback -

用法 API( alpha)

这个 usage 命令在 阿尔法 反应形状可能改变,以及 访问仅限于在使用法API alpha注册的队伍.

使用时间序列范围受计划限制:

小时查询( E)--granularity hour),每个计划限为后7天.

CLI 获取请求的全部范围 。 用法 API 页面回复 7天块; CLI 自动跟随这些页.

alchemy --json usage summary
alchemy usage timeseries --start-date 2026-06-01 --granularity day

旗帜

全球旗帜

这些适用于所有命令.

认证网络( N)

输出格式化( F)

运行时间行为( P)

移交

外壳:

命令专用旗帜

认证引用

# Interactive login — opens browser to link your Alchemy account
alchemy auth

# Skip the confirmation prompt
alchemy auth -y

# Force re-authentication
alchemy auth login --force

# Check auth status
alchemy auth status

# Log out
alchemy auth logout

登录后,CLI会提示您选择一个团队,如果您属于多个团队,然后是应用程序. 该app的API密钥被保存为配置并用于所有后续的命令. 如果您在登录时跳过应用程序选择, CLI 将提示您在运行任何需要 API 密钥的命令之前先选择一个 .

通知/webhook 命令使用有分辨率命令的webhook API 密钥 : --webhook-api-key - > (中文) ALCHEMY_WEBHOOK_API_KEY - > (中文) ALCHEMY_NOTIFY_AUTH_TOKEN - > 配置 webhook-api-key - > 配置了 app webhook 密钥 .

遥测

本节介绍CLI的选出用法遥测:它涵盖什么,当有人告诉你时,以及如何关闭.

默认启用收藏 。 在收集或发送任何事件之前,适用以下选择退出控制.

收集的内容: 命令和设置步骤,结果和时间,CLI版本,节点主版本,OS与环境(CI,终端,JSON或REPL模式),网络,旗名,引用源,以及被检测到的AI工具及其版本,当知道时.

链接到: 您的Alchemy用户和团队ID,您的计划,以及随机安装和每个运行的ID.

从未收集 : 提示、秘密、地址、文件路径或参数值,但允许的网络和推荐标签除外.

通知出现时: 在第一次适用遥测时,CLI显示一次性通知,说明上述情况.

• 在终端: 在第一个命令之前.
• 在 JSON 模式下 (单位:千美元)--json,或当stdout被管: 在错误中 JSON 表示 error.notice 如果第一个命令失败, 否则在结果后作为 JSON 线在 stderr 上 : {"notice": "..."}。 。 。 .
• 预览失败和 --help 编号 : --version 旗帜 别显出. 这些跑道上没有任何东西被收集,通知出现在下一个命令上.

选择退出 :

alchemy telemetry disable           # persistent opt-out; deletes queued events
alchemy telemetry enable            # opt back in
alchemy telemetry status            # show the current state
export ALCHEMY_TELEMETRY_DISABLED=1 # or DO_NOT_TRACK=1, per shell or CI job

ALCHEMY_TELEMETRY_DISABLED 财务报告和审定财务报表 DO_NOT_TRACK 当遥测被设定为真实值时,例如 1,无论节省的偏好。 空着, 0, (中文(简体) ), false, (中文(简体) ), no 财务报告和审定财务报表 off 不要数.

在州内生活: $XDG_CONFIG_HOME/alchemy/telemetry.json (默认) ~/.config/alchemy/telemetry.json),或位于由 ALCHEMY_CONFIG。它持有随机安装ID、打开/关闭首选和查询源。 通知是否在 telemetry/notice-shown 在同一目录中.

转介来源: --ref <source> 或者说 ALCHEMY_REF 被记录一次,当遥测状态最初创建,然后被忽略.

RAPL 模式

运行 alchemy 在交互式终端中没有命令 :

alchemy
alchemy ◆ evm data balance 0x...
alchemy ◆ evm block latest
alchemy ◆ exit

使用 --no-interactive 在自动化中禁用 REPL/ prompts.

输出模式

• TTY( 直线) : 格式化的人类产出(表、颜色、旋转器)
• 非TTY(管道/重定向): JSON 自动输出——不需要旗帜
• --json: 强迫 JSON 输出, 甚至在终端
• --verbose 或者说 alchemy config set verbose true: 日志请求/答复细节(方法、 URL、 状态、 时间) 到 stderr

错误格式

错误在 JSON 模式中是结构化的 JSON :

{
  "error": {
    "code": "AUTH_REQUIRED",
    "message": "Not authenticated. Run 'alchemy auth' to log in, or set ALCHEMY_API_KEY.",
    "hint": "alchemy auth"
  }
}