revx-auth

身份验证与账户设置（revx configure）

安装 CLI、生成 API 密钥并配置写操作安全性。

自动解决目标问题。 如果因身份验证错误而从其他 revx-* 技能调用，不要让用户返回手动设置。请根据下方的错误参考诊断故障，并自行修复（例如，运行 chmod 600 ~/.config/revolut-x/private.pem、revx configure generate-keypair、revx configure set --api-key <key>），然后返回调用方技能并重试原始命令。仅向用户索取只有他们能提供的信息：64 个字符的 API 密钥字符串、确认他们已在 Revolut X 个人资料中注册公钥，或批准将现有密钥对移到其他位置。

前置条件

• Node.js >= 20（使用 node -v 检查）
• npm（随 Node.js 一起提供）

安装

npm install -g @revolut/revolut-x-cli && npm link @revolut/revolut-x-cli

安装后，revx 即可作为全局命令使用：

revx --version                # Should print the version

---

开始使用

步骤 1：配置身份验证

revx configure                 # Interactive setup wizard

此操作将：

1. 生成一个 Ed25519 密钥对（私钥 + 公钥）
2. 显示公钥，请复制
3. 提示你前往 exchange.revolut.com -> Profile -> API Keys 注册公钥
4. 创建新的 API 密钥，请勾选 "Allow usage via Revolut X MCP and CLI" 复选框
5. 提示你输入注册后收到的 64 个字符的 API 密钥

或者，逐步完成：

revx configure generate-keypair          # Creates Ed25519 keypair
# Register public key at exchange.revolut.com -> Profile -> API Keys
# Create API key — tick "Allow usage via Revolut X MCP and CLI"
revx configure set --api-key <64-char-key>

步骤 2：验证配置

revx configure get             # Show config status (keys redacted)
revx configure path            # Print config directory path

配置命令

revx configure                          # Interactive setup wizard
revx configure get                      # Show config status (keys redacted)
revx configure set --api-key <key>      # Set API key
revx configure generate-keypair         # Generate Ed25519 keypair
revx configure path                     # Print config directory path

配置位置

平台	路径
macOS/Linux	~/.config/revolut-x/
Windows	%APPDATA%\revolut-x\
覆盖	REVOLUTX_CONFIG_DIR 环境变量

---

错误参考

错误	原因	修复方法
未配置身份验证	缺少 API 密钥或私钥	运行 revx configure
无法读取私钥或配置文件 <path>（EACCES）	当前用户无法读取该文件	确保该文件归当前用户所有，然后运行 chmod 600 <path>
<path> 不是文件	有文件夹挡住了该路径	询问用户是否同意将文件夹移到其他位置，然后运行 revx configure
缺少私钥 <path>	已设置 API 密钥，但密钥文件已丢失	如果用户有副本，将其放回 <path>。否则运行 revx configure generate-keypair，然后注册新公钥并为其创建新的 API 密钥
私钥 <path> 为空、包含公钥、受密码短语保护、采用 OpenSSH 格式、不是有效的 PEM 私钥，或不是 Ed25519 密钥	密钥文件已损坏或类型不正确	请先征求用户同意。然后将文件移至一个尚不存在的新名称，例如 mv -n <path> <path>.old-$(date +%s)；运行 revx configure generate-keypair，注册新公钥并为其创建新的 API 密钥。切勿删除旧文件
配置文件 <path> 不是有效的 JSON、不是设置对象、API 密钥不是由 64 个字母和数字组成，或 private_key_path 不是文本	config.json 已损坏	运行 revx configure set --api-key <key> 重新写入配置文件
身份验证失败（401）	密钥或签名无效	在 exchange.revolut.com 重新注册公钥
网络错误	连接失败或超时	检查网络连接，然后重试

---

后续步骤

配置完成后，可以进一步探索：

• 查看余额、交易和订单历史记录 — 参阅 revx-account 技能
• 查看市场价格和 K 线 — 参阅 revx-market 技能
• 下第一笔订单 — 参阅 revx-trading 技能

相关技能

技能	用途
revx-market	货币、交易对、行情、K 线、订单簿
revx-account	余额、交易历史、订单查询、交易历史记录
revx-trading	下单和撤单
revx-monitor	实时价格/指标提醒
revx-telegram	Telegram 通知设置
revx-strategy	网格机器人回测、优化和运行