mirror of https://github.com/discountry/ritmex-bot.git synced 2026-09-09 08:18:07 +00:00

Files

T

discountry a6394191d8 docs: update README and add bilingual configuration guides for exchanges

- Changed installation command from `npx` to `bunx` for consistency.
- Added bilingual configuration guides for Aster and Backpack exchanges.
- Updated exchange details in the README to reflect new market types and required settings.
- Enhanced clarity in the supported exchanges section with updated variable names and descriptions.

2026-07-12 11:51:45 +08:00

3.9 KiB

Raw Blame History

Nado 配置教程

English version: Nado Configuration Guide

适用范围

本教程用于 Nado 永续适配器。Nado 使用 Ink 网络、子账户和 linked signer。ritmex-bot 需要已授权 linked signer 的私钥、子账户 owner 地址和子账户名称。

1. 准备 Nado 账户

在 Nado 连接 EVM 钱包。
为 Ink 网络准备 ETH gas 和受支持的保证金资产。
完成入金并创建目标子账户。
记录子账户 owner 的 EVM 地址和子账户名称，默认名称为 default。

2. 获取 linked signer 私钥

Nado 官方 SDK 提供 createStandardLinkedSigner 和 createDeterministicLinkedSignerPrivateKey，用于创建并授权子账户 linked signer。

当前 Nado Web UI 会在官方域名的浏览器本地存储中保存已授权 signer 信息。使用 Web UI 创建 signer 后，可以在浏览器开发者工具的 Application → Local Storage 中检查 nado.userSettings，读取其中的 privateKey 字段。该值属于交易私钥，应在读取后关闭开发者工具并清理任何临时记录。

NADO_SIGNER_PRIVATE_KEY 必须是 0x 加 64 个十六进制字符。它应是 linked signer 私钥。钱包助记词和主钱包私钥不应填入该变量。

3. 主网最小配置

EXCHANGE=nado
NADO_ENV=inkMainnet
NADO_SIGNER_PRIVATE_KEY=<0x_linked_signer_private_key>
NADO_SUBACCOUNT_OWNER=<0x_owner_address>
NADO_SUBACCOUNT_NAME=default
NADO_SYMBOL=BTC-PERP

NADO_SUBACCOUNT_OWNER 可以使用兼容别名 NADO_EVM_ADDRESS。

4. 测试网配置

NADO_ENV=inkTestnet
NADO_SIGNER_PRIVATE_KEY=<0x_testnet_linked_signer_private_key>
NADO_SUBACCOUNT_OWNER=<0x_testnet_owner_address>
NADO_SUBACCOUNT_NAME=default
NADO_SYMBOL=BTC-PERP

linked signer 的授权与环境绑定。主网 signer 无法用于测试网子账户。

5. 符号格式

Nado 永续市场使用 BTC-PERP、ETH-PERP 这类产品符号。适配器还接受：

BTCPERP → BTC-PERP
BTCUSDT0 → BTC-PERP
BTC/PERP → BTC-PERP

应优先使用 Nado API 返回的原始 *-PERP 符号。

6. 可选配置

变量	默认值	说明
`NADO_GATEWAY_WS_URL`	按环境选择	交易网关 WebSocket
`NADO_SUBSCRIPTIONS_WS_URL`	按环境选择	行情订阅 WebSocket
`NADO_ARCHIVE_URL`	生产/测试 archive	历史和索引查询地址
`NADO_TRIGGER_URL`	生产/测试 trigger	止损止盈服务地址
`NADO_MARKET_SLIPPAGE_PCT`	`0.01`	市价/触发单保护范围，`0.01` 表示 1%
`NADO_STOP_TRIGGER_SOURCE`	`oracle`	`oracle`、`last` 或 `mid`
`NADO_MIN_SIZE_POLICY`	`adjust`	`adjust` 自动上调到最小量；`reject` 直接拒绝
`NADO_DEBUG`	`false`	详细错误日志

7. 验证配置

bun run index.ts doctor --exchange nado --symbol BTC-PERP --json
bun run index.ts market ticker --exchange nado --symbol BTC-PERP --json

行情检查会验证网络、linked signer、子账户和产品元数据，不会创建订单。

常见问题

Missing NADO_SIGNER_PRIVATE_KEY：填写已授权 linked signer 的 32 字节私钥。
Invalid NADO private key：确认值包含 0x 和 64 个十六进制字符。
Missing NADO_SUBACCOUNT_OWNER：填写子账户 owner 的 20 字节 EVM 地址。
签名/权限错误：确认 signer 已链接到相同 owner、子账户名称和网络。
产品未找到：使用 BTC-PERP 这类 Nado 原始符号。

安全要求

linked signer 可以执行交易，应使用专用 signer 并定期轮换。
主钱包私钥和助记词不进入 ritmex-bot 配置。
signer 泄露后立即在 Nado 撤销授权并创建新 signer。

3.9 KiB Raw Blame History