mirror of
https://github.com/discountry/ritmex-bot.git
synced 2026-09-12 01:38:07 +00:00
Compare commits
5
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 discountry
|
abe464c505 | ||
|
discountry
|
27abeb9fa4 | ||
|
discountry
|
98c58727c7 | ||
|
discountry
|
4205d5dc12 | ||
|
discountry
|
227484152d |
@@ -1,3 +0,0 @@
|
||||
docs/
|
||||
.claude/
|
||||
.cursor/
|
||||
@@ -1,12 +0,0 @@
|
||||
{
|
||||
"$schema": "./node_modules/oxlint/configuration_schema.json",
|
||||
"ignorePatterns": [
|
||||
"coverage/**",
|
||||
"data/**",
|
||||
"dist/**",
|
||||
"docs/**",
|
||||
"node_modules/**",
|
||||
"out/**",
|
||||
".tmp/**"
|
||||
]
|
||||
}
|
||||
@@ -21,24 +21,7 @@ A Bun-powered multi-exchange perpetuals workstation that ships an SMA30 trend en
|
||||
* [Paradex 手续费优惠注册链接](https://paradex.io/ref/xingxingjun)
|
||||
* [Apex 手续费优惠注册链接](https://join.omni.apex.exchange/SEA)
|
||||
|
||||
## CLI 命令模式（ritmex-bot）
|
||||
`ritmex-bot` 支持 Agent 友好的结构化命令调用，覆盖交易所能力查询、行情、账户、仓位、下单、撤单与策略启动。
|
||||
|
||||
- 保持现有环境变量体系，不新增也不改名，只读取当前执行环境中的变量。
|
||||
- `--symbol` 原样透传，不对交易对做统一改写。
|
||||
- 支持 `--dry-run` 模拟执行与 `--json` 结构化输出，便于自动化系统集成。
|
||||
|
||||
### 安装当前项目 Skill（skills add）
|
||||
```bash
|
||||
npx skills add https://github.com/discountry/ritmex-bot --skill use-ritmex-bot
|
||||
```
|
||||
如需指定分支，可追加 `--ref <branch-or-tag>`。
|
||||
|
||||
完整文档请见：[ritmex-bot CLI 使用手册（中文）](cli-guide.md)
|
||||
|
||||
## 文档索引
|
||||
- [ritmex-bot CLI 使用手册（中文）](cli-guide.md)
|
||||
- [ritmex-bot CLI User Guide (English)](cli-guide.en.md)
|
||||
- [简明上手指南（零基础）](simple-readme.md)
|
||||
- [基础网格策略使用教程](grid-trading.md)
|
||||
|
||||
@@ -226,40 +209,9 @@ EXCHANGE=binance BINANCE_MARKET_TYPE=spot BINANCE_SYMBOL=BTCUSDT bun run index.t
|
||||
bun run index.ts # 启动 CLI（默认入口）
|
||||
bun run start # 等价于运行 index.ts
|
||||
bun run dev # 调试模式
|
||||
bun run lint # 执行 Oxlint 检查
|
||||
bun run lint:fix # 自动修复可安全修复的问题
|
||||
bun x vitest run # 执行全部测试
|
||||
```
|
||||
|
||||
## ritmex-bot 命令模式（Agent 友好）
|
||||
项目现已支持独立命令模式，命令名为 `ritmex-bot`：
|
||||
|
||||
```bash
|
||||
ritmex-bot doctor
|
||||
ritmex-bot exchange list
|
||||
ritmex-bot market ticker --exchange binance --symbol BTCUSDT
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side buy --type limit --quantity 0.01 --price 90000 --dry-run
|
||||
ritmex-bot strategy run --strategy maker --exchange standx --silent --dry-run
|
||||
```
|
||||
|
||||
### 运行方式
|
||||
```bash
|
||||
# 全局安装
|
||||
npm install -g ritmex-bot
|
||||
ritmex-bot doctor
|
||||
|
||||
# 不安装直接运行
|
||||
npx ritmex-bot doctor
|
||||
bunx ritmex-bot doctor
|
||||
```
|
||||
|
||||
### 全局参数
|
||||
- `--exchange`：按现有逻辑选择交易所（不修改原有环境变量体系）
|
||||
- `--symbol`：原样透传，不做统一或改写
|
||||
- `--dry-run`：模拟执行，不发真实下单/撤单请求
|
||||
- `--json`：输出结构化 JSON，便于 AI Agent 解析
|
||||
- `--timeout`：命令超时毫秒数
|
||||
|
||||
## 静默启动与后台运行
|
||||
### 直接静默启动
|
||||
无需进入 Ink 菜单，可用命令行直接拉起指定策略：
|
||||
@@ -294,8 +246,6 @@ bun run pm2:start:offset
|
||||
## 测试
|
||||
项目使用 Vitest：
|
||||
```bash
|
||||
bun run lint
|
||||
bun run lint:fix
|
||||
bun run test
|
||||
bun x vitest --watch
|
||||
```
|
||||
|
||||
@@ -17,24 +17,7 @@ If you'd like to support this project and get fee discounts, please consider usi
|
||||
* [Paradex referral link](https://paradex.io/ref/xingxingjun)
|
||||
* [Apex referral link](https://join.omni.apex.exchange/SEA)
|
||||
|
||||
## CLI Command Mode (`ritmex-bot`)
|
||||
`ritmex-bot` provides an agent-friendly command interface for exchange capability checks, market data, account/position queries, order operations, and strategy execution.
|
||||
|
||||
- It keeps the current environment-variable system intact: no renaming and no new required keys.
|
||||
- `--symbol` is passed through exactly as provided (no symbol normalization).
|
||||
- It supports `--dry-run` simulation and `--json` structured output for automation.
|
||||
|
||||
### Install This Project Skill (`skills add`)
|
||||
```bash
|
||||
npx skills add https://github.com/discountry/ritmex-bot --skill use-ritmex-bot
|
||||
```
|
||||
If you need a specific branch/tag, append `--ref <branch-or-tag>`.
|
||||
|
||||
Full guide: [ritmex-bot CLI User Guide (English)](cli-guide.en.md)
|
||||
|
||||
## Documentation Map
|
||||
- [ritmex-bot CLI User Guide (English)](cli-guide.en.md)
|
||||
- [ritmex-bot CLI 使用手册（中文）](cli-guide.md)
|
||||
- [Beginner-friendly Quick Start](simple-readme.md)
|
||||
- [Grid Trading Strategy Guide](grid-trading.md)
|
||||
|
||||
@@ -222,40 +205,9 @@ Please keep these credentials safe and do not share them with anyone.
|
||||
bun run index.ts # Launch the CLI (default entrypoint)
|
||||
bun run start # Alias for bun run index.ts
|
||||
bun run dev # Development entrypoint
|
||||
bun run lint # Run Oxlint checks
|
||||
bun run lint:fix # Apply safe Oxlint fixes
|
||||
bun x vitest run # Execute the full Vitest suite
|
||||
```
|
||||
|
||||
## ritmex-bot Command Mode (Agent-friendly)
|
||||
The project now supports a standalone command mode with the command name `ritmex-bot`:
|
||||
|
||||
```bash
|
||||
ritmex-bot doctor
|
||||
ritmex-bot exchange list
|
||||
ritmex-bot market ticker --exchange binance --symbol BTCUSDT
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side buy --type limit --quantity 0.01 --price 90000 --dry-run
|
||||
ritmex-bot strategy run --strategy maker --exchange standx --silent --dry-run
|
||||
```
|
||||
|
||||
### Run Modes
|
||||
```bash
|
||||
# Global install
|
||||
npm install -g ritmex-bot
|
||||
ritmex-bot doctor
|
||||
|
||||
# No install
|
||||
npx ritmex-bot doctor
|
||||
bunx ritmex-bot doctor
|
||||
```
|
||||
|
||||
### Global Flags
|
||||
- `--exchange`: picks exchange using the existing env/config logic
|
||||
- `--symbol`: passed through as-is (no symbol normalization)
|
||||
- `--dry-run`: simulation mode (no real create/cancel side effects)
|
||||
- `--json`: structured JSON output for AI agents
|
||||
- `--timeout`: command timeout in milliseconds
|
||||
|
||||
## Silent & Background Execution
|
||||
### Direct silent launch
|
||||
Skip the Ink menu and start a strategy directly:
|
||||
@@ -290,8 +242,6 @@ Run `pm2 save` afterwards if you want the process list to survive reboots.
|
||||
## Testing
|
||||
Powered by Vitest:
|
||||
```bash
|
||||
bun run lint
|
||||
bun run lint:fix
|
||||
bun run test
|
||||
bun x vitest --watch
|
||||
```
|
||||
|
||||
@@ -1,19 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
import { spawnSync } from "node:child_process";
|
||||
import { dirname, resolve } from "node:path";
|
||||
import { fileURLToPath } from "node:url";
|
||||
|
||||
const __dirname = dirname(fileURLToPath(import.meta.url));
|
||||
const entry = resolve(__dirname, "..", "index.ts");
|
||||
const bunBinary = process.env.BUN_BIN || "bun";
|
||||
|
||||
const result = spawnSync(bunBinary, ["run", entry, ...process.argv.slice(2)], {
|
||||
stdio: "inherit",
|
||||
});
|
||||
|
||||
if (result.error) {
|
||||
console.error("[ritmex-bot] Bun is required to run this CLI. Install Bun from https://bun.sh");
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
process.exit(result.status ?? 1);
|
||||
@@ -5,27 +5,26 @@
|
||||
"": {
|
||||
"name": "ritmex-bot",
|
||||
"dependencies": {
|
||||
"@grvt/client": "^1.6.27",
|
||||
"@nadohq/client": "^0.1.0-alpha.51",
|
||||
"@grvt/client": "^1.6.4",
|
||||
"@nadohq/client": "^0.1.0-alpha.41",
|
||||
"@noble/ed25519": "^3.0.0",
|
||||
"axios": "^1.13.6",
|
||||
"bignumber.js": "^10.0.2",
|
||||
"ccxt": "^4.5.40",
|
||||
"dotenv": "^17.3.1",
|
||||
"ethereum-cryptography": "^3.2.0",
|
||||
"ink": "^6.8.0",
|
||||
"react": "^19.2.4",
|
||||
"axios": "^1.12.2",
|
||||
"bignumber.js": "^9.3.1",
|
||||
"ccxt": "^4.5.12",
|
||||
"dotenv": "^17.2.2",
|
||||
"ethereum-cryptography": "^2.1.3",
|
||||
"ink": "^6.3.1",
|
||||
"react": "^19.1.1",
|
||||
"trading-signals": "^7.4.3",
|
||||
"viem": "^2.46.3",
|
||||
"ws": "^8.19.0",
|
||||
"viem": "^2.43.1",
|
||||
"ws": "^8.18.3",
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/bun": "^1.3.9",
|
||||
"oxlint": "^1.54.0",
|
||||
"vitest": "^4.0.18",
|
||||
"@types/bun": "latest",
|
||||
"vitest": "^3.2.4",
|
||||
},
|
||||
"peerDependencies": {
|
||||
"typescript": "^5.9.3",
|
||||
"typescript": "^5",
|
||||
},
|
||||
},
|
||||
},
|
||||
@@ -86,65 +85,27 @@
|
||||
|
||||
"@esbuild/win32-x64": ["@esbuild/win32-x64@0.25.10", "", { "os": "win32", "cpu": "x64" }, "sha512-9KpxSVFCu0iK1owoez6aC/s/EdUQLDN3adTxGCqxMVhrPDj6bt5dbrHDXUuq+Bs2vATFBBrQS5vdQ/Ed2P+nbw=="],
|
||||
|
||||
"@grvt/client": ["@grvt/client@1.6.27", "", { "dependencies": { "axios": "^1.13.5" } }, "sha512-YUb7bsPPRNhZs/T+RGDBp/AKbegRHvjB8KXpTEAy5Dbf44RI00KoX9S/R12HzxLtS5rSblmcpD7hmCtDnlcN5Q=="],
|
||||
"@grvt/client": ["@grvt/client@1.6.25", "", { "dependencies": { "axios": "^1.13.2" } }, "sha512-LG3oZSJDq1Qz6mLiHDmg+v/Hp+Nd+yOp8GIvkBVyIdOcPVzuzC8UQD7IxvS+g5EfQQKLiKzXSjKLc39a11Uj1A=="],
|
||||
|
||||
"@jridgewell/sourcemap-codec": ["@jridgewell/sourcemap-codec@1.5.5", "", {}, "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og=="],
|
||||
|
||||
"@nadohq/client": ["@nadohq/client@0.1.0-alpha.51", "", { "dependencies": { "@nadohq/engine-client": "0.1.0-alpha.51", "@nadohq/indexer-client": "0.1.0-alpha.51", "@nadohq/shared": "0.1.0-alpha.51", "@nadohq/trigger-client": "0.1.0-alpha.51", "ts-mixer": "*" }, "peerDependencies": { "viem": "*" } }, "sha512-t94DGAbnGPjHu517NlYixtzhsBmavv+Hu4OgIKy4WEbOwSWT0NZJRLVqhzfmsZQ1fzg/z0PGss3Z59v9fVjfgg=="],
|
||||
"@nadohq/client": ["@nadohq/client@0.1.0-alpha.45", "", { "dependencies": { "@nadohq/engine-client": "^0.1.0-alpha.45", "@nadohq/indexer-client": "^0.1.0-alpha.45", "@nadohq/shared": "^0.1.0-alpha.45", "@nadohq/trigger-client": "^0.1.0-alpha.45", "ts-mixer": "*" }, "peerDependencies": { "viem": "*" } }, "sha512-63S7eT5xSk3hxEXRLGDI94mPeu/zd1Nu4oUOZrY8wzhaT7Gl7PVP2snb8JH/PduVQzgs7+qblr4aTBI/j6QvLQ=="],
|
||||
|
||||
"@nadohq/engine-client": ["@nadohq/engine-client@0.1.0-alpha.51", "", { "dependencies": { "@nadohq/shared": "0.1.0-alpha.51", "axios": "*", "ts-mixer": "*" }, "peerDependencies": { "viem": "*" } }, "sha512-gP0IHFOWq+IXMOkURVXA+bb9yh4qc+rCXy210mwmETAVT7h0kvcIij+fU6/k9nMl2G4EaGRzfocKpn3OTb6Hlw=="],
|
||||
"@nadohq/engine-client": ["@nadohq/engine-client@0.1.0-alpha.45", "", { "dependencies": { "@nadohq/shared": "^0.1.0-alpha.45", "axios": "*", "ts-mixer": "*" }, "peerDependencies": { "viem": "*" } }, "sha512-GqaRrsB0Z2EgNY6wu4nG5OTc5hF+buNRMc0+jPLlOQonlPJAC4OiMCgCigm4nJecYwsdiQD05W3Z4YUqggxbyw=="],
|
||||
|
||||
"@nadohq/indexer-client": ["@nadohq/indexer-client@0.1.0-alpha.51", "", { "dependencies": { "@nadohq/engine-client": "0.1.0-alpha.51", "@nadohq/shared": "0.1.0-alpha.51", "axios": "*", "ts-mixer": "*" }, "peerDependencies": { "viem": "*" } }, "sha512-4ZJTwUOxKpYKi8TGnMRscuX3tkzzOJR7Uaqs4Se+BrE48POinaMd8SnJWu7KEvWNc6JnVwb/p5LWHLEsPWtC7A=="],
|
||||
"@nadohq/indexer-client": ["@nadohq/indexer-client@0.1.0-alpha.45", "", { "dependencies": { "@nadohq/engine-client": "^0.1.0-alpha.45", "@nadohq/shared": "^0.1.0-alpha.45", "axios": "*", "ts-mixer": "*" }, "peerDependencies": { "viem": "*" } }, "sha512-8PzG9taYh380lsKT8i4UvGfhZiPpt+zPisx+ErVqMifyhcJAhgMeYNcfijwMQFNJdgTaBvtI0R5JK98l4Y0YQw=="],
|
||||
|
||||
"@nadohq/shared": ["@nadohq/shared@0.1.0-alpha.51", "", { "dependencies": { "abitype": "^1.2.3" }, "peerDependencies": { "bignumber.js": "^9.3.0", "viem": "*" } }, "sha512-889WGX2WcSgYpXfLx1TvStzyo/kkx19pcgn0ZebBcUHnYM+xqXJH+ty+BuFaheP+IkPfWfuS9S3Q757j04R4rg=="],
|
||||
"@nadohq/shared": ["@nadohq/shared@0.1.0-alpha.45", "", { "peerDependencies": { "bignumber.js": "^9.3.0", "viem": "*" } }, "sha512-4Ml8dO9mkwnIidflpunwVMLX2KJA79b53T9xTBkH1Yzy0iOnbEE27r25wvgJgyszU0aznbPBv2++FZ0d0B5Zhg=="],
|
||||
|
||||
"@nadohq/trigger-client": ["@nadohq/trigger-client@0.1.0-alpha.51", "", { "dependencies": { "@nadohq/engine-client": "0.1.0-alpha.51", "@nadohq/shared": "0.1.0-alpha.51", "axios": "*", "ts-mixer": "*" }, "peerDependencies": { "viem": "*" } }, "sha512-OmM6opQy6E2lvZqP4IDf/BF1r0KogJIEZezQ8zRJROtuKYxHnSOcItnlS1vihxp9FR7Y25l/tnQ1JxoWmZnwSw=="],
|
||||
"@nadohq/trigger-client": ["@nadohq/trigger-client@0.1.0-alpha.45", "", { "dependencies": { "@nadohq/engine-client": "^0.1.0-alpha.45", "@nadohq/shared": "^0.1.0-alpha.45", "axios": "*", "ts-mixer": "*" }, "peerDependencies": { "viem": "*" } }, "sha512-Xt8W9zxOZhMvoXSRnx9kUR26wWuHc3EgTVTBbUXt7SlI9v3IP9I3idS6SU3j2f08flcvNqRmC2EbXyYDC2XeyQ=="],
|
||||
|
||||
"@noble/ciphers": ["@noble/ciphers@1.3.0", "", {}, "sha512-2I0gnIVPtfnMw9ee9h1dJG7tp81+8Ob3OJb3Mv37rx5L40/b0i7djjCVvGOVqc9AEIQyvyu1i6ypKdFw8R8gQw=="],
|
||||
|
||||
"@noble/curves": ["@noble/curves@1.9.0", "", { "dependencies": { "@noble/hashes": "1.8.0" } }, "sha512-7YDlXiNMdO1YZeH6t/kvopHHbIZzlxrCV9WLqCY6QhcXOoXiNCMDqJIglZ9Yjx5+w7Dz30TITFrlTjnRg7sKEg=="],
|
||||
"@noble/curves": ["@noble/curves@1.4.2", "", { "dependencies": { "@noble/hashes": "1.4.0" } }, "sha512-TavHr8qycMChk8UwMld0ZDRvatedkzWfH8IiaeGCfymOP5i0hSCozz9vHOL0nkwk7HRMlFnAiKpS2jrUmSybcw=="],
|
||||
|
||||
"@noble/ed25519": ["@noble/ed25519@3.0.0", "", {}, "sha512-QyteqMNm0GLqfa5SoYbSC3+Pvykwpn95Zgth4MFVSMKBB75ELl9tX1LAVsN4c3HXOrakHsF2gL4zWDAYCcsnzg=="],
|
||||
|
||||
"@noble/hashes": ["@noble/hashes@1.8.0", "", {}, "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A=="],
|
||||
|
||||
"@oxlint/binding-android-arm-eabi": ["@oxlint/binding-android-arm-eabi@1.54.0", "", { "os": "android", "cpu": "arm" }, "sha512-khWlVXUa4CPvp4eXnj7/TUNeyiarwvTEmZggylPIPUCSWgPqUBFGElIBa9xKNCQt4pb+WSGArCNEAy22ekQQxg=="],
|
||||
|
||||
"@oxlint/binding-android-arm64": ["@oxlint/binding-android-arm64@1.54.0", "", { "os": "android", "cpu": "arm64" }, "sha512-p3qEVSDVmyducpI9ORTJNbaMyXfICidDXGaf3WwyDyiXPExyZdfc6UsPepGPxImlfFJs5kxOCPqP4ut12Ed9pg=="],
|
||||
|
||||
"@oxlint/binding-darwin-arm64": ["@oxlint/binding-darwin-arm64@1.54.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-tUQ+vn/AL2P2Rz6cl3gsFA+4pMBFMRR0e6AVePoezV9iGTSMZUXIf0YWHq203bwNDXcY04vSXDqPB6E1b9WULA=="],
|
||||
|
||||
"@oxlint/binding-darwin-x64": ["@oxlint/binding-darwin-x64@1.54.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-9tzH/OLGZCzVGEXW0D3I0OrQOOWciHYWV9mcxjqqQE6f1DMOXT23mWj5/OQtqhW3E1VfHf0uf2MzMbM2gboPlA=="],
|
||||
|
||||
"@oxlint/binding-freebsd-x64": ["@oxlint/binding-freebsd-x64@1.54.0", "", { "os": "freebsd", "cpu": "x64" }, "sha512-XelGa+x7vC9epF5JzXWHaQtdxqcL5R+H2WcEkr+JDkfmY3dAXVLa+51qW3+MWt7CZanakaOyhraLzdM32pWFfg=="],
|
||||
|
||||
"@oxlint/binding-linux-arm-gnueabihf": ["@oxlint/binding-linux-arm-gnueabihf@1.54.0", "", { "os": "linux", "cpu": "arm" }, "sha512-t5FubAU899vMF+6rBtxDewkwSAeFn8OUCKb/+jJ1XqPU0FTR+RffnTfXafVE8WXw39eN4pzUK3rkxUWlcsFuaw=="],
|
||||
|
||||
"@oxlint/binding-linux-arm-musleabihf": ["@oxlint/binding-linux-arm-musleabihf@1.54.0", "", { "os": "linux", "cpu": "arm" }, "sha512-Du6cwkoMRi9DAgITzQpzS1QaEqE+5BP3Tfgr1yPy3C034n6IHISCwf4KMB+wojg8FE/kYvrJDibT0ENdcR3jUg=="],
|
||||
|
||||
"@oxlint/binding-linux-arm64-gnu": ["@oxlint/binding-linux-arm64-gnu@1.54.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-R4PjJ1lfghsVBuAegW79jkvUWbN8P4F28KaKbM72dW6ZWTYMg6M0pkTilXFZ+q/mb8f0MEyR1rO16useoa6KTA=="],
|
||||
|
||||
"@oxlint/binding-linux-arm64-musl": ["@oxlint/binding-linux-arm64-musl@1.54.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-WBNFe1foIFg6ipgzjzJfDLn7C5nZpLr/UHlnlT7GI3scCD2xpJiJTGMTTpJqA8p0Q1l2NsEnAOj9PtreF0Tkzg=="],
|
||||
|
||||
"@oxlint/binding-linux-ppc64-gnu": ["@oxlint/binding-linux-ppc64-gnu@1.54.0", "", { "os": "linux", "cpu": "ppc64" }, "sha512-M+UAW76rZHHiYKKy4e7Te5MNikANiFhYWl0qYF1MTIhQczYIqWVDQ+SX0SzW8ipOB/oK3+enOvlvJuhMoA968Q=="],
|
||||
|
||||
"@oxlint/binding-linux-riscv64-gnu": ["@oxlint/binding-linux-riscv64-gnu@1.54.0", "", { "os": "linux", "cpu": "none" }, "sha512-sGassljr8TR5F1WCqOaacrp3mYi107MnjkqlSXOMHACps7U2bL4v7M3RY7P7NMcGkNhzRHF3VO5+XyPWhTVM6w=="],
|
||||
|
||||
"@oxlint/binding-linux-riscv64-musl": ["@oxlint/binding-linux-riscv64-musl@1.54.0", "", { "os": "linux", "cpu": "none" }, "sha512-mW5Z6XTO8QWtlUjlf6yjntarjnbrmGVSK/V6XYy2rjH8xUfv9pn9G1vO92DBBBi0eUwnVpcOY3hMkP851WZNWg=="],
|
||||
|
||||
"@oxlint/binding-linux-s390x-gnu": ["@oxlint/binding-linux-s390x-gnu@1.54.0", "", { "os": "linux", "cpu": "s390x" }, "sha512-nfPmEGW9BfWEUD0PVXGaYa2RS4wVblofNih1gsyUoLSWSyliNisIWd7F+QXrDSL5SJ78BPZjDW6FainV8qRiTg=="],
|
||||
|
||||
"@oxlint/binding-linux-x64-gnu": ["@oxlint/binding-linux-x64-gnu@1.54.0", "", { "os": "linux", "cpu": "x64" }, "sha512-gybxMQx4NN1T+pa8TLwgVS4u9H9Hxwm7Sl0qvnQJF2WRhNN1oTOCzkmmCBbW/29DYLeV99WU76zh7srCamK9yw=="],
|
||||
|
||||
"@oxlint/binding-linux-x64-musl": ["@oxlint/binding-linux-x64-musl@1.54.0", "", { "os": "linux", "cpu": "x64" }, "sha512-EAXMh2w3pzSj/aiB67kXzcHIoKxAywC1i1IgxA1sLY7iffEaZowDTOJgirY7WxeR/WiiKwak89gPeh9wUdLnIw=="],
|
||||
|
||||
"@oxlint/binding-openharmony-arm64": ["@oxlint/binding-openharmony-arm64@1.54.0", "", { "os": "none", "cpu": "arm64" }, "sha512-Ih7CfITkbw86+LjgV5gDwNmNQlvz7X+51gdeLLUDwuA/9lojDxCmRQEzeMl44KStQlwzCuNIcgGMae0MllV5ww=="],
|
||||
|
||||
"@oxlint/binding-win32-arm64-msvc": ["@oxlint/binding-win32-arm64-msvc@1.54.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-qGQ8KIEfdgwwJd09Nc0d5hzlHQAM0EMoshMzHG/nNlMAHXrY7RFyat6VbzjflifAFb7LPAw+Yw9AB8cfzR7L8g=="],
|
||||
|
||||
"@oxlint/binding-win32-ia32-msvc": ["@oxlint/binding-win32-ia32-msvc@1.54.0", "", { "os": "win32", "cpu": "ia32" }, "sha512-GXos7N5oZIcIE8hlXgtUkI+y3frIqwiztx9p4+ZrpNgASbnIsxxy8bgLJqXE2SGCAdmtjBO1mdKhGTtVrb1jbg=="],
|
||||
|
||||
"@oxlint/binding-win32-x64-msvc": ["@oxlint/binding-win32-x64-msvc@1.54.0", "", { "os": "win32", "cpu": "x64" }, "sha512-DVxSELcI72lmcODuVpO8uXkwuYPiA0hKMhBwNa8fO4+sIVxFvxugf/z6qrL+4PM8RjGWjdl8O/QqzuRWj9b5bA=="],
|
||||
"@noble/hashes": ["@noble/hashes@1.4.0", "", {}, "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg=="],
|
||||
|
||||
"@rollup/rollup-android-arm-eabi": ["@rollup/rollup-android-arm-eabi@4.52.0", "", { "os": "android", "cpu": "arm" }, "sha512-VxDYCDqOaR7NXzAtvRx7G1u54d2kEHopb28YH/pKzY6y0qmogP3gG7CSiWsq9WvDFxOQMpNEyjVAHZFXfH3o/A=="],
|
||||
|
||||
@@ -190,64 +151,72 @@
|
||||
|
||||
"@rollup/rollup-win32-x64-msvc": ["@rollup/rollup-win32-x64-msvc@4.52.0", "", { "os": "win32", "cpu": "x64" }, "sha512-6iKDCVSIUQ8jPMoIV0OytRKniaYyy5EbY/RRydmLW8ZR3cEBhxbWl5ro0rkUNe0ef6sScvhbY79HrjRm8i3vDQ=="],
|
||||
|
||||
"@scure/base": ["@scure/base@1.2.6", "", {}, "sha512-g/nm5FgUa//MCj1gV09zTJTaM6KBAHqLN907YVQqf7zC49+DcO4B1so4ZX07Ef10Twr6nuqYEH9GEggFXA4Fmg=="],
|
||||
"@scure/base": ["@scure/base@1.1.9", "", {}, "sha512-8YKhl8GHiNI/pU2VMaofa2Tor7PJRAjwQLBBuilkJ9L5+13yVbC7JO/wS7piioAvPSwR3JKM1IJ/u4xQzbcXKg=="],
|
||||
|
||||
"@scure/bip32": ["@scure/bip32@1.7.0", "", { "dependencies": { "@noble/curves": "~1.9.0", "@noble/hashes": "~1.8.0", "@scure/base": "~1.2.5" } }, "sha512-E4FFX/N3f4B80AKWp5dP6ow+flD1LQZo/w8UnLGYZO674jS6YnYeepycOOksv+vLPSpgN35wgKgy+ybfTb2SMw=="],
|
||||
"@scure/bip32": ["@scure/bip32@1.4.0", "", { "dependencies": { "@noble/curves": "~1.4.0", "@noble/hashes": "~1.4.0", "@scure/base": "~1.1.6" } }, "sha512-sVUpc0Vq3tXCkDGYVWGIZTRfnvu8LoTDaev7vbwh0omSvVORONr960MQWdKqJDCReIEmTj3PAr73O3aoxz7OPg=="],
|
||||
|
||||
"@scure/bip39": ["@scure/bip39@1.6.0", "", { "dependencies": { "@noble/hashes": "~1.8.0", "@scure/base": "~1.2.5" } }, "sha512-+lF0BbLiJNwVlev4eKelw1WWLaiKXw7sSl8T6FvBlWkdX+94aGJ4o8XjUdlyhTCjd8c+B3KT3JfS8P0bLRNU6A=="],
|
||||
"@scure/bip39": ["@scure/bip39@1.3.0", "", { "dependencies": { "@noble/hashes": "~1.4.0", "@scure/base": "~1.1.6" } }, "sha512-disdg7gHuTDZtY+ZdkmLpPCk7fxZSu3gBiEGuoC1XYxv9cGx3Z6cpTggCgW6odSOOIXCiDjuGejW+aJKCY/pIQ=="],
|
||||
|
||||
"@standard-schema/spec": ["@standard-schema/spec@1.1.0", "", {}, "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w=="],
|
||||
|
||||
"@types/bun": ["@types/bun@1.3.9", "", { "dependencies": { "bun-types": "1.3.9" } }, "sha512-KQ571yULOdWJiMH+RIWIOZ7B2RXQGpL1YQrBtLIV3FqDcCu6FsbFUBwhdKUlCKUpS3PJDsHlJ1QKlpxoVR+xtw=="],
|
||||
"@types/bun": ["@types/bun@1.3.8", "", { "dependencies": { "bun-types": "1.3.8" } }, "sha512-3LvWJ2q5GerAXYxO2mffLTqOzEu5qnhEAlh48Vnu8WQfnmSwbgagjGZV6BoHKJztENYEDn6QmVd949W4uESRJA=="],
|
||||
|
||||
"@types/chai": ["@types/chai@5.2.2", "", { "dependencies": { "@types/deep-eql": "*" } }, "sha512-8kB30R7Hwqf40JPiKhVzodJs2Qc1ZJ5zuT3uzw5Hq/dhNCl3G3l83jfpdI1e20BP348+fV7VIL/+FxaXkqBmWg=="],
|
||||
|
||||
"@types/debug": ["@types/debug@4.1.12", "", { "dependencies": { "@types/ms": "*" } }, "sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ=="],
|
||||
|
||||
"@types/deep-eql": ["@types/deep-eql@4.0.2", "", {}, "sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw=="],
|
||||
|
||||
"@types/estree": ["@types/estree@1.0.8", "", {}, "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w=="],
|
||||
|
||||
"@types/ms": ["@types/ms@2.1.0", "", {}, "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA=="],
|
||||
|
||||
"@types/node": ["@types/node@24.5.2", "", { "dependencies": { "undici-types": "~7.12.0" } }, "sha512-FYxk1I7wPv3K2XBaoyH2cTnocQEu8AOZ60hPbsyukMPLv5/5qr7V1i8PLHdl6Zf87I+xZXFvPCXYjiTFq+YSDQ=="],
|
||||
|
||||
"@vitest/expect": ["@vitest/expect@4.0.18", "", { "dependencies": { "@standard-schema/spec": "^1.0.0", "@types/chai": "^5.2.2", "@vitest/spy": "4.0.18", "@vitest/utils": "4.0.18", "chai": "^6.2.1", "tinyrainbow": "^3.0.3" } }, "sha512-8sCWUyckXXYvx4opfzVY03EOiYVxyNrHS5QxX3DAIi5dpJAAkyJezHCP77VMX4HKA2LDT/Jpfo8i2r5BE3GnQQ=="],
|
||||
"@vitest/expect": ["@vitest/expect@3.2.4", "", { "dependencies": { "@types/chai": "^5.2.2", "@vitest/spy": "3.2.4", "@vitest/utils": "3.2.4", "chai": "^5.2.0", "tinyrainbow": "^2.0.0" } }, "sha512-Io0yyORnB6sikFlt8QW5K7slY4OjqNX9jmJQ02QDda8lyM6B5oNgVWoSoKPac8/kgnCUzuHQKrSLtu/uOqqrig=="],
|
||||
|
||||
"@vitest/mocker": ["@vitest/mocker@4.0.18", "", { "dependencies": { "@vitest/spy": "4.0.18", "estree-walker": "^3.0.3", "magic-string": "^0.30.21" }, "peerDependencies": { "msw": "^2.4.9", "vite": "^6.0.0 || ^7.0.0-0" }, "optionalPeers": ["msw", "vite"] }, "sha512-HhVd0MDnzzsgevnOWCBj5Otnzobjy5wLBe4EdeeFGv8luMsGcYqDuFRMcttKWZA5vVO8RFjexVovXvAM4JoJDQ=="],
|
||||
"@vitest/mocker": ["@vitest/mocker@3.2.4", "", { "dependencies": { "@vitest/spy": "3.2.4", "estree-walker": "^3.0.3", "magic-string": "^0.30.17" }, "peerDependencies": { "msw": "^2.4.9", "vite": "^5.0.0 || ^6.0.0 || ^7.0.0-0" }, "optionalPeers": ["msw", "vite"] }, "sha512-46ryTE9RZO/rfDd7pEqFl7etuyzekzEhUbTW3BvmeO/BcCMEgq59BKhek3dXDWgAj4oMK6OZi+vRr1wPW6qjEQ=="],
|
||||
|
||||
"@vitest/pretty-format": ["@vitest/pretty-format@4.0.18", "", { "dependencies": { "tinyrainbow": "^3.0.3" } }, "sha512-P24GK3GulZWC5tz87ux0m8OADrQIUVDPIjjj65vBXYG17ZeU3qD7r+MNZ1RNv4l8CGU2vtTRqixrOi9fYk/yKw=="],
|
||||
"@vitest/pretty-format": ["@vitest/pretty-format@3.2.4", "", { "dependencies": { "tinyrainbow": "^2.0.0" } }, "sha512-IVNZik8IVRJRTr9fxlitMKeJeXFFFN0JaB9PHPGQ8NKQbGpfjlTx9zO4RefN8gp7eqjNy8nyK3NZmBzOPeIxtA=="],
|
||||
|
||||
"@vitest/runner": ["@vitest/runner@4.0.18", "", { "dependencies": { "@vitest/utils": "4.0.18", "pathe": "^2.0.3" } }, "sha512-rpk9y12PGa22Jg6g5M3UVVnTS7+zycIGk9ZNGN+m6tZHKQb7jrP7/77WfZy13Y/EUDd52NDsLRQhYKtv7XfPQw=="],
|
||||
"@vitest/runner": ["@vitest/runner@3.2.4", "", { "dependencies": { "@vitest/utils": "3.2.4", "pathe": "^2.0.3", "strip-literal": "^3.0.0" } }, "sha512-oukfKT9Mk41LreEW09vt45f8wx7DordoWUZMYdY/cyAk7w5TWkTRCNZYF7sX7n2wB7jyGAl74OxgwhPgKaqDMQ=="],
|
||||
|
||||
"@vitest/snapshot": ["@vitest/snapshot@4.0.18", "", { "dependencies": { "@vitest/pretty-format": "4.0.18", "magic-string": "^0.30.21", "pathe": "^2.0.3" } }, "sha512-PCiV0rcl7jKQjbgYqjtakly6T1uwv/5BQ9SwBLekVg/EaYeQFPiXcgrC2Y7vDMA8dM1SUEAEV82kgSQIlXNMvA=="],
|
||||
"@vitest/snapshot": ["@vitest/snapshot@3.2.4", "", { "dependencies": { "@vitest/pretty-format": "3.2.4", "magic-string": "^0.30.17", "pathe": "^2.0.3" } }, "sha512-dEYtS7qQP2CjU27QBC5oUOxLE/v5eLkGqPE0ZKEIDGMs4vKWe7IjgLOeauHsR0D5YuuycGRO5oSRXnwnmA78fQ=="],
|
||||
|
||||
"@vitest/spy": ["@vitest/spy@4.0.18", "", {}, "sha512-cbQt3PTSD7P2OARdVW3qWER5EGq7PHlvE+QfzSC0lbwO+xnt7+XH06ZzFjFRgzUX//JmpxrCu92VdwvEPlWSNw=="],
|
||||
"@vitest/spy": ["@vitest/spy@3.2.4", "", { "dependencies": { "tinyspy": "^4.0.3" } }, "sha512-vAfasCOe6AIK70iP5UD11Ac4siNUNJ9i/9PZ3NKx07sG6sUxeag1LWdNrMWeKKYBLlzuK+Gn65Yd5nyL6ds+nw=="],
|
||||
|
||||
"@vitest/utils": ["@vitest/utils@4.0.18", "", { "dependencies": { "@vitest/pretty-format": "4.0.18", "tinyrainbow": "^3.0.3" } }, "sha512-msMRKLMVLWygpK3u2Hybgi4MNjcYJvwTb0Ru09+fOyCXIgT5raYP041DRRdiJiI3k/2U6SEbAETB3YtBrUkCFA=="],
|
||||
"@vitest/utils": ["@vitest/utils@3.2.4", "", { "dependencies": { "@vitest/pretty-format": "3.2.4", "loupe": "^3.1.4", "tinyrainbow": "^2.0.0" } }, "sha512-fB2V0JFrQSMsCo9HiSq3Ezpdv4iYaXRG1Sx8edX3MwxfyNn83mKiGzOcH+Fkxt4MHxr3y42fQi1oeAInqgX2QA=="],
|
||||
|
||||
"abitype": ["abitype@1.2.3", "", { "peerDependencies": { "typescript": ">=5.0.4", "zod": "^3.22.0 || ^4.0.0" }, "optionalPeers": ["typescript", "zod"] }, "sha512-Ofer5QUnuUdTFsBRwARMoWKOH1ND5ehwYhJ3OJ/BQO+StkwQjHw0XyVh4vDttzHB7QOFhPHa/o413PJ82gU/Tg=="],
|
||||
|
||||
"ansi-escapes": ["ansi-escapes@7.3.0", "", { "dependencies": { "environment": "^1.0.0" } }, "sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg=="],
|
||||
"ansi-escapes": ["ansi-escapes@7.2.0", "", { "dependencies": { "environment": "^1.0.0" } }, "sha512-g6LhBsl+GBPRWGWsBtutpzBYuIIdBkLEvad5C/va/74Db018+5TZiyA26cZJAr3Rft5lprVqOIPxf5Vid6tqAw=="],
|
||||
|
||||
"ansi-regex": ["ansi-regex@6.2.2", "", {}, "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg=="],
|
||||
|
||||
"ansi-styles": ["ansi-styles@6.2.3", "", {}, "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg=="],
|
||||
|
||||
"assertion-error": ["assertion-error@2.0.1", "", {}, "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA=="],
|
||||
|
||||
"asynckit": ["asynckit@0.4.0", "", {}, "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q=="],
|
||||
|
||||
"auto-bind": ["auto-bind@5.0.1", "", {}, "sha512-ooviqdwwgfIfNmDwo94wlshcdzfO64XV0Cg6oDsDYBJfITDz1EngD2z7DkbvCWn+XIMsIqW27sEVF6qcpJrRcg=="],
|
||||
|
||||
"axios": ["axios@1.13.6", "", { "dependencies": { "follow-redirects": "^1.15.11", "form-data": "^4.0.5", "proxy-from-env": "^1.1.0" } }, "sha512-ChTCHMouEe2kn713WHbQGcuYrr6fXTBiu460OTwWrWob16g1bXn4vtz07Ope7ewMozJAnEquLk5lWQWtBig9DQ=="],
|
||||
"axios": ["axios@1.13.4", "", { "dependencies": { "follow-redirects": "^1.15.6", "form-data": "^4.0.4", "proxy-from-env": "^1.1.0" } }, "sha512-1wVkUaAO6WyaYtCkcYCOx12ZgpGf9Zif+qXa4n+oYzK558YryKqiL6UWwd5DqiH3VRW0GYhTZQ/vlgJrCoNQlg=="],
|
||||
|
||||
"bignumber.js": ["bignumber.js@10.0.2", "", {}, "sha512-E8Wp9O06QA6lneJ4aRUXKYf/1GIomqUEmUMwtIOMtDxf1U52ffJY+y7JBk/8wRafA8qOIqLnXQGqonYXZdBnFQ=="],
|
||||
"bignumber.js": ["bignumber.js@9.3.1", "", {}, "sha512-Ko0uX15oIUS7wJ3Rb30Fs6SkVbLmPBAKdlm7q9+ak9bbIeFf0MwuBsQV6z7+X768/cHsfg+WlysDWJcmthjsjQ=="],
|
||||
|
||||
"bun-types": ["bun-types@1.3.9", "", { "dependencies": { "@types/node": "*" } }, "sha512-+UBWWOakIP4Tswh0Bt0QD0alpTY8cb5hvgiYeWCMet9YukHbzuruIEeXC2D7nMJPB12kbh8C7XJykSexEqGKJg=="],
|
||||
"bun-types": ["bun-types@1.3.8", "", { "dependencies": { "@types/node": "*" } }, "sha512-fL99nxdOWvV4LqjmC+8Q9kW3M4QTtTR1eePs94v5ctGqU8OeceWrSUaRw3JYb7tU3FkMIAjkueehrHPPPGKi5Q=="],
|
||||
|
||||
"cac": ["cac@6.7.14", "", {}, "sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ=="],
|
||||
|
||||
"call-bind-apply-helpers": ["call-bind-apply-helpers@1.0.2", "", { "dependencies": { "es-errors": "^1.3.0", "function-bind": "^1.1.2" } }, "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ=="],
|
||||
|
||||
"ccxt": ["ccxt@4.5.40", "", { "dependencies": { "ws": "^8.8.1" } }, "sha512-8nJhhNKft7+fELDNQuCV2AQZBxLJfYQaD2LpqxHrucSszosyVl0u6lCIFfcnDUbeUW925uhrsKevHf2fNbLjKw=="],
|
||||
"ccxt": ["ccxt@4.5.35", "", { "dependencies": { "ws": "^8.8.1" } }, "sha512-aFn1jq/vR9wD3Vxu/2UFoS8snqlvfYn/iYrNhyZZfzB3N+kAHhP5+sAgO6ZwNHkHiUT9IPPahC1ZSFdPtjpIYA=="],
|
||||
|
||||
"chai": ["chai@6.2.2", "", {}, "sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg=="],
|
||||
"chai": ["chai@5.3.3", "", { "dependencies": { "assertion-error": "^2.0.1", "check-error": "^2.1.1", "deep-eql": "^5.0.1", "loupe": "^3.1.0", "pathval": "^2.0.0" } }, "sha512-4zNhdJD/iOjSH0A05ea+Ke6MU5mmpQcbQsSOkgdaUMJ9zTlDTD/GYlwohmIE2u0gaxHYiVHEn1Fw9mZ/ktJWgw=="],
|
||||
|
||||
"chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
|
||||
|
||||
"check-error": ["check-error@2.1.1", "", {}, "sha512-OAlb+T7V4Op9OwdkjmguYRqncdlx5JiofwOAUkmTF+jNdHwzTaTs4sRAGpzLF3oOz5xAyDGrPgeIDFQmDOTiJw=="],
|
||||
|
||||
"cli-boxes": ["cli-boxes@3.0.0", "", {}, "sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g=="],
|
||||
|
||||
"cli-cursor": ["cli-cursor@4.0.0", "", { "dependencies": { "restore-cursor": "^4.0.0" } }, "sha512-VGtlMu3x/4DOtIUwEkRezxUZ2lBacNJCHash0N0WeZDBS+7Ux1dm3XWAgWYxLJFMMdOeXMHXorshEFhbMSGelg=="],
|
||||
@@ -260,9 +229,13 @@
|
||||
|
||||
"convert-to-spaces": ["convert-to-spaces@2.0.1", "", {}, "sha512-rcQ1bsQO9799wq24uE5AM2tAILy4gXGIK/njFWcVQkGNZ96edlpY+A7bjwvzjYvLDyzmG1MmMLZhpcsb+klNMQ=="],
|
||||
|
||||
"debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
|
||||
|
||||
"deep-eql": ["deep-eql@5.0.2", "", {}, "sha512-h5k/5U50IJJFpzfL6nO9jaaumfjO/f2NjK/oYB2Djzm4p9L+3T9qWpZqZ2hAbLPuuYq9wrU08WQyBTL5GbPk5Q=="],
|
||||
|
||||
"delayed-stream": ["delayed-stream@1.0.0", "", {}, "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ=="],
|
||||
|
||||
"dotenv": ["dotenv@17.3.1", "", {}, "sha512-IO8C/dzEb6O3F9/twg6ZLXz164a2fhTnEWb95H23Dm4OuN+92NmEAlTrupP9VW6Jm3sO26tQlqyvyi4CsnY9GA=="],
|
||||
"dotenv": ["dotenv@17.2.3", "", {}, "sha512-JVUnt+DUIzu87TABbhPmNfVdBDt18BLOWjMUFJMSi/Qqg7NTYtabbvSNJGOJ7afbRuv9D/lngizHtP7QyLQ+9w=="],
|
||||
|
||||
"dunder-proto": ["dunder-proto@1.0.1", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.1", "es-errors": "^1.3.0", "gopd": "^1.2.0" } }, "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A=="],
|
||||
|
||||
@@ -288,7 +261,7 @@
|
||||
|
||||
"estree-walker": ["estree-walker@3.0.3", "", { "dependencies": { "@types/estree": "^1.0.0" } }, "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g=="],
|
||||
|
||||
"ethereum-cryptography": ["ethereum-cryptography@3.2.0", "", { "dependencies": { "@noble/ciphers": "1.3.0", "@noble/curves": "1.9.0", "@noble/hashes": "1.8.0", "@scure/bip32": "1.7.0", "@scure/bip39": "1.6.0" } }, "sha512-Urr5YVsalH+Jo0sYkTkv1MyI9bLYZwW8BENZCeE1QYaTHETEYx0Nv/SVsWkSqpYrzweg6d8KMY1wTjH/1m/BIg=="],
|
||||
"ethereum-cryptography": ["ethereum-cryptography@2.2.1", "", { "dependencies": { "@noble/curves": "1.4.2", "@noble/hashes": "1.4.0", "@scure/bip32": "1.4.0", "@scure/bip39": "1.3.0" } }, "sha512-r/W8lkHSiTLxUxW8Rf3u4HGB0xQweG2RyETjywylKZSzLWoWAijRz8WCuOtJ6wah+avllXBqZuk29HCCvhEIRg=="],
|
||||
|
||||
"eventemitter3": ["eventemitter3@5.0.1", "", {}, "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA=="],
|
||||
|
||||
@@ -298,7 +271,7 @@
|
||||
|
||||
"follow-redirects": ["follow-redirects@1.15.11", "", {}, "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ=="],
|
||||
|
||||
"form-data": ["form-data@4.0.5", "", { "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", "es-set-tostringtag": "^2.1.0", "hasown": "^2.0.2", "mime-types": "^2.1.12" } }, "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w=="],
|
||||
"form-data": ["form-data@4.0.4", "", { "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", "es-set-tostringtag": "^2.1.0", "hasown": "^2.0.2", "mime-types": "^2.1.12" } }, "sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow=="],
|
||||
|
||||
"fsevents": ["fsevents@2.3.3", "", { "os": "darwin" }, "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw=="],
|
||||
|
||||
@@ -320,7 +293,7 @@
|
||||
|
||||
"indent-string": ["indent-string@5.0.0", "", {}, "sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg=="],
|
||||
|
||||
"ink": ["ink@6.8.0", "", { "dependencies": { "@alcalzone/ansi-tokenize": "^0.2.4", "ansi-escapes": "^7.3.0", "ansi-styles": "^6.2.1", "auto-bind": "^5.0.1", "chalk": "^5.6.0", "cli-boxes": "^3.0.0", "cli-cursor": "^4.0.0", "cli-truncate": "^5.1.1", "code-excerpt": "^4.0.0", "es-toolkit": "^1.39.10", "indent-string": "^5.0.0", "is-in-ci": "^2.0.0", "patch-console": "^2.0.0", "react-reconciler": "^0.33.0", "scheduler": "^0.27.0", "signal-exit": "^3.0.7", "slice-ansi": "^8.0.0", "stack-utils": "^2.0.6", "string-width": "^8.1.1", "terminal-size": "^4.0.1", "type-fest": "^5.4.1", "widest-line": "^6.0.0", "wrap-ansi": "^9.0.0", "ws": "^8.18.0", "yoga-layout": "~3.2.1" }, "peerDependencies": { "@types/react": ">=19.0.0", "react": ">=19.0.0", "react-devtools-core": ">=6.1.2" }, "optionalPeers": ["@types/react", "react-devtools-core"] }, "sha512-sbl1RdLOgkO9isK42WCZlJCFN9hb++sX9dsklOvfd1YQ3bQ2AiFu12Q6tFlr0HvEUvzraJntQCCpfEoUe9DSzA=="],
|
||||
"ink": ["ink@6.6.0", "", { "dependencies": { "@alcalzone/ansi-tokenize": "^0.2.1", "ansi-escapes": "^7.2.0", "ansi-styles": "^6.2.1", "auto-bind": "^5.0.1", "chalk": "^5.6.0", "cli-boxes": "^3.0.0", "cli-cursor": "^4.0.0", "cli-truncate": "^5.1.1", "code-excerpt": "^4.0.0", "es-toolkit": "^1.39.10", "indent-string": "^5.0.0", "is-in-ci": "^2.0.0", "patch-console": "^2.0.0", "react-reconciler": "^0.33.0", "signal-exit": "^3.0.7", "slice-ansi": "^7.1.0", "stack-utils": "^2.0.6", "string-width": "^8.1.0", "type-fest": "^4.27.0", "widest-line": "^5.0.0", "wrap-ansi": "^9.0.0", "ws": "^8.18.0", "yoga-layout": "~3.2.1" }, "peerDependencies": { "@types/react": ">=19.0.0", "react": ">=19.0.0", "react-devtools-core": "^6.1.2" }, "optionalPeers": ["@types/react", "react-devtools-core"] }, "sha512-QDt6FgJxgmSxAelcOvOHUvFxbIUjVpCH5bx+Slvc5m7IEcpGt3dYwbz/L+oRnqEGeRvwy1tineKK4ect3nW1vQ=="],
|
||||
|
||||
"is-fullwidth-code-point": ["is-fullwidth-code-point@5.1.0", "", { "dependencies": { "get-east-asian-width": "^1.3.1" } }, "sha512-5XHYaSyiqADb4RnZ1Bdad6cPp8Toise4TzEjcOYDHZkTCbKgiUl7WTUCpNWHuxmDt91wnsZBc9xinNzopv3JMQ=="],
|
||||
|
||||
@@ -328,7 +301,11 @@
|
||||
|
||||
"isows": ["isows@1.0.7", "", { "peerDependencies": { "ws": "*" } }, "sha512-I1fSfDCZL5P0v33sVqeTDSpcstAg/N+wF5HS033mogOVIp4B+oHC7oOCsA3axAbBSGTJ8QubbNmnIRN/h8U7hg=="],
|
||||
|
||||
"magic-string": ["magic-string@0.30.21", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.5" } }, "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ=="],
|
||||
"js-tokens": ["js-tokens@9.0.1", "", {}, "sha512-mxa9E9ITFOt0ban3j6L5MpjwegGz6lBQmM1IJkWeBZGcMxto50+eWdjC/52xDbS2vy0k7vIMK0Fe2wfL9OQSpQ=="],
|
||||
|
||||
"loupe": ["loupe@3.2.1", "", {}, "sha512-CdzqowRJCeLU72bHvWqwRBBlLcMEtIvGrlvef74kMnV2AolS9Y8xUv1I0U/MNAWMhBlKIoyuEgoJ0t/bbwHbLQ=="],
|
||||
|
||||
"magic-string": ["magic-string@0.30.19", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.5" } }, "sha512-2N21sPY9Ws53PZvsEpVtNuSW+ScYbQdp4b9qUaL+9QkHUrGFKo56Lg9Emg5s9V/qrtNBmiR01sYhUOwu3H+VOw=="],
|
||||
|
||||
"math-intrinsics": ["math-intrinsics@1.1.0", "", {}, "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g=="],
|
||||
|
||||
@@ -338,20 +315,20 @@
|
||||
|
||||
"mimic-fn": ["mimic-fn@2.1.0", "", {}, "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg=="],
|
||||
|
||||
"nanoid": ["nanoid@3.3.11", "", { "bin": { "nanoid": "bin/nanoid.cjs" } }, "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w=="],
|
||||
"ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
|
||||
|
||||
"obug": ["obug@2.1.1", "", {}, "sha512-uTqF9MuPraAQ+IsnPf366RG4cP9RtUi7MLO1N3KEc+wb0a6yKpeL0lmk2IB1jY5KHPAlTc6T/JRdC/YqxHNwkQ=="],
|
||||
"nanoid": ["nanoid@3.3.11", "", { "bin": { "nanoid": "bin/nanoid.cjs" } }, "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w=="],
|
||||
|
||||
"onetime": ["onetime@5.1.2", "", { "dependencies": { "mimic-fn": "^2.1.0" } }, "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg=="],
|
||||
|
||||
"ox": ["ox@0.12.4", "", { "dependencies": { "@adraffy/ens-normalize": "^1.11.0", "@noble/ciphers": "^1.3.0", "@noble/curves": "1.9.1", "@noble/hashes": "^1.8.0", "@scure/bip32": "^1.7.0", "@scure/bip39": "^1.6.0", "abitype": "^1.2.3", "eventemitter3": "5.0.1" }, "peerDependencies": { "typescript": ">=5.4.0" }, "optionalPeers": ["typescript"] }, "sha512-+P+C7QzuwPV8lu79dOwjBKfB2CbnbEXe/hfyyrff1drrO1nOOj3Hc87svHfcW1yneRr3WXaKr6nz11nq+/DF9Q=="],
|
||||
|
||||
"oxlint": ["oxlint@1.54.0", "", { "optionalDependencies": { "@oxlint/binding-android-arm-eabi": "1.54.0", "@oxlint/binding-android-arm64": "1.54.0", "@oxlint/binding-darwin-arm64": "1.54.0", "@oxlint/binding-darwin-x64": "1.54.0", "@oxlint/binding-freebsd-x64": "1.54.0", "@oxlint/binding-linux-arm-gnueabihf": "1.54.0", "@oxlint/binding-linux-arm-musleabihf": "1.54.0", "@oxlint/binding-linux-arm64-gnu": "1.54.0", "@oxlint/binding-linux-arm64-musl": "1.54.0", "@oxlint/binding-linux-ppc64-gnu": "1.54.0", "@oxlint/binding-linux-riscv64-gnu": "1.54.0", "@oxlint/binding-linux-riscv64-musl": "1.54.0", "@oxlint/binding-linux-s390x-gnu": "1.54.0", "@oxlint/binding-linux-x64-gnu": "1.54.0", "@oxlint/binding-linux-x64-musl": "1.54.0", "@oxlint/binding-openharmony-arm64": "1.54.0", "@oxlint/binding-win32-arm64-msvc": "1.54.0", "@oxlint/binding-win32-ia32-msvc": "1.54.0", "@oxlint/binding-win32-x64-msvc": "1.54.0" }, "peerDependencies": { "oxlint-tsgolint": ">=0.15.0" }, "optionalPeers": ["oxlint-tsgolint"], "bin": { "oxlint": "bin/oxlint" } }, "sha512-ObSjVwf0ZYA5U5Cmelj0PsCuqCJXsm2TxZ40tgUSAY7Wu0lKAsNjor6cgXHXSys8jOwv1ICjtzouoWHdKGHbZg=="],
|
||||
"ox": ["ox@0.11.3", "", { "dependencies": { "@adraffy/ens-normalize": "^1.11.0", "@noble/ciphers": "^1.3.0", "@noble/curves": "1.9.1", "@noble/hashes": "^1.8.0", "@scure/bip32": "^1.7.0", "@scure/bip39": "^1.6.0", "abitype": "^1.2.3", "eventemitter3": "5.0.1" }, "peerDependencies": { "typescript": ">=5.4.0" }, "optionalPeers": ["typescript"] }, "sha512-1bWYGk/xZel3xro3l8WGg6eq4YEKlaqvyMtVhfMFpbJzK2F6rj4EDRtqDCWVEJMkzcmEi9uW2QxsqELokOlarw=="],
|
||||
|
||||
"patch-console": ["patch-console@2.0.0", "", {}, "sha512-0YNdUceMdaQwoKce1gatDScmMo5pu/tfABfnzEqeG0gtTmd7mh/WcwgUjtAeOU7N8nFFlbQBnFK2gXW5fGvmMA=="],
|
||||
|
||||
"pathe": ["pathe@2.0.3", "", {}, "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w=="],
|
||||
|
||||
"pathval": ["pathval@2.0.1", "", {}, "sha512-//nshmD55c46FuFw26xV/xFAaB5HF9Xdap7HJBBnrKdAd6/GxDBaNA1870O79+9ueg61cZLSVc+OaFlfmObYVQ=="],
|
||||
|
||||
"picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
|
||||
|
||||
"picomatch": ["picomatch@4.0.3", "", {}, "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q=="],
|
||||
@@ -374,7 +351,7 @@
|
||||
|
||||
"signal-exit": ["signal-exit@3.0.7", "", {}, "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ=="],
|
||||
|
||||
"slice-ansi": ["slice-ansi@8.0.0", "", { "dependencies": { "ansi-styles": "^6.2.3", "is-fullwidth-code-point": "^5.1.0" } }, "sha512-stxByr12oeeOyY2BlviTNQlYV5xOj47GirPr4yA1hE9JCtxfQN0+tVbkxwCtYDQWhEKWFHsEK48ORg5jrouCAg=="],
|
||||
"slice-ansi": ["slice-ansi@7.1.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "is-fullwidth-code-point": "^5.0.0" } }, "sha512-iOBWFgUX7caIZiuutICxVgX1SdxwAVFFKwt1EvMYYec/NWO5meOJ6K5uQxhrYBdQJne4KxiqZc+KptFOWFSI9w=="],
|
||||
|
||||
"source-map-js": ["source-map-js@1.2.1", "", {}, "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA=="],
|
||||
|
||||
@@ -382,43 +359,47 @@
|
||||
|
||||
"stackback": ["stackback@0.0.2", "", {}, "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw=="],
|
||||
|
||||
"std-env": ["std-env@3.10.0", "", {}, "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg=="],
|
||||
"std-env": ["std-env@3.9.0", "", {}, "sha512-UGvjygr6F6tpH7o2qyqR6QYpwraIjKSdtzyBdyytFOHmPZY917kwdwLG0RbOjWOnKmnm3PeHjaoLLMie7kPLQw=="],
|
||||
|
||||
"string-width": ["string-width@8.1.1", "", { "dependencies": { "get-east-asian-width": "^1.3.0", "strip-ansi": "^7.1.0" } }, "sha512-KpqHIdDL9KwYk22wEOg/VIqYbrnLeSApsKT/bSj6Ez7pn3CftUiLAv2Lccpq1ALcpLV9UX1Ppn92npZWu2w/aw=="],
|
||||
|
||||
"strip-ansi": ["strip-ansi@7.1.2", "", { "dependencies": { "ansi-regex": "^6.0.1" } }, "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA=="],
|
||||
|
||||
"tagged-tag": ["tagged-tag@1.0.0", "", {}, "sha512-yEFYrVhod+hdNyx7g5Bnkkb0G6si8HJurOoOEgC8B/O0uXLHlaey/65KRv6cuWBNhBgHKAROVpc7QyYqE5gFng=="],
|
||||
|
||||
"terminal-size": ["terminal-size@4.0.1", "", {}, "sha512-avMLDQpUI9I5XFrklECw1ZEUPJhqzcwSWsyyI8blhRLT+8N1jLJWLWWYQpB2q2xthq8xDvjZPISVh53T/+CLYQ=="],
|
||||
"strip-literal": ["strip-literal@3.0.0", "", { "dependencies": { "js-tokens": "^9.0.1" } }, "sha512-TcccoMhJOM3OebGhSBEmp3UZ2SfDMZUEBdRA/9ynfLi8yYajyWX3JiXArcJt4Umh4vISpspkQIY8ZZoCqjbviA=="],
|
||||
|
||||
"tinybench": ["tinybench@2.9.0", "", {}, "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg=="],
|
||||
|
||||
"tinyexec": ["tinyexec@1.0.2", "", {}, "sha512-W/KYk+NFhkmsYpuHq5JykngiOCnxeVL8v8dFnqxSD8qEEdRfXk1SDM6JzNqcERbcGYj9tMrDQBYV9cjgnunFIg=="],
|
||||
"tinyexec": ["tinyexec@0.3.2", "", {}, "sha512-KQQR9yN7R5+OSwaK0XQoj22pwHoTlgYqmUscPYoknOoWCWfj/5/ABTMRi69FrKU5ffPVh5QcFikpWJI/P1ocHA=="],
|
||||
|
||||
"tinyglobby": ["tinyglobby@0.2.15", "", { "dependencies": { "fdir": "^6.5.0", "picomatch": "^4.0.3" } }, "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ=="],
|
||||
|
||||
"tinyrainbow": ["tinyrainbow@3.0.3", "", {}, "sha512-PSkbLUoxOFRzJYjjxHJt9xro7D+iilgMX/C9lawzVuYiIdcihh9DXmVibBe8lmcFrRi/VzlPjBxbN7rH24q8/Q=="],
|
||||
"tinypool": ["tinypool@1.1.1", "", {}, "sha512-Zba82s87IFq9A9XmjiX5uZA/ARWDrB03OHlq+Vw1fSdt0I+4/Kutwy8BP4Y/y/aORMo61FQ0vIb5j44vSo5Pkg=="],
|
||||
|
||||
"tinyrainbow": ["tinyrainbow@2.0.0", "", {}, "sha512-op4nsTR47R6p0vMUUoYl/a+ljLFVtlfaXkLQmqfLR1qHma1h/ysYk4hEXZ880bf2CYgTskvTa/e196Vd5dDQXw=="],
|
||||
|
||||
"tinyspy": ["tinyspy@4.0.4", "", {}, "sha512-azl+t0z7pw/z958Gy9svOTuzqIk6xq+NSheJzn5MMWtWTFywIacg2wUlzKFGtt3cthx0r2SxMK0yzJOR0IES7Q=="],
|
||||
|
||||
"trading-signals": ["trading-signals@7.4.3", "", {}, "sha512-kOyzd85qhuhU7yGkB5z74MVP6j30xBCfZy5+bgBnvfxY1ZdvaQsdD+C5j+CoIRtCAgSOuxB7jmPpBrqO6h17sQ=="],
|
||||
|
||||
"ts-mixer": ["ts-mixer@6.0.4", "", {}, "sha512-ufKpbmrugz5Aou4wcr5Wc1UUFWOLhq+Fm6qa6P0w0K5Qw2yhaUoiWszhCVuNQyNwrlGiscHOmqYoAox1PtvgjA=="],
|
||||
|
||||
"type-fest": ["type-fest@5.4.4", "", { "dependencies": { "tagged-tag": "^1.0.0" } }, "sha512-JnTrzGu+zPV3aXIUhnyWJj4z/wigMsdYajGLIYakqyOW1nPllzXEJee0QQbHj+CTIQtXGlAjuK0UY+2xTyjVAw=="],
|
||||
"type-fest": ["type-fest@4.41.0", "", {}, "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA=="],
|
||||
|
||||
"typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
|
||||
"typescript": ["typescript@5.9.2", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-CWBzXQrc/qOkhidw1OzBTQuYRbfyxDXJMVJ1XNwUHGROVmuaeiEm3OslpZ1RV96d7SKKjZKrSJu3+t/xlw3R9A=="],
|
||||
|
||||
"undici-types": ["undici-types@7.12.0", "", {}, "sha512-goOacqME2GYyOZZfb5Lgtu+1IDmAlAEu5xnD3+xTzS10hT0vzpf0SPjkXwAw9Jm+4n/mQGDP3LO8CPbYROeBfQ=="],
|
||||
|
||||
"viem": ["viem@2.46.3", "", { "dependencies": { "@noble/curves": "1.9.1", "@noble/hashes": "1.8.0", "@scure/bip32": "1.7.0", "@scure/bip39": "1.6.0", "abitype": "1.2.3", "isows": "1.0.7", "ox": "0.12.4", "ws": "8.18.3" }, "peerDependencies": { "typescript": ">=5.0.4" }, "optionalPeers": ["typescript"] }, "sha512-2LJS+Hyh2sYjHXQtzfv1kU9pZx9dxFzvoU/ZKIcn0FNtOU0HQuIICuYdWtUDFHaGXbAdVo8J1eCvmjkL9JVGwg=="],
|
||||
"viem": ["viem@2.45.1", "", { "dependencies": { "@noble/curves": "1.9.1", "@noble/hashes": "1.8.0", "@scure/bip32": "1.7.0", "@scure/bip39": "1.6.0", "abitype": "1.2.3", "isows": "1.0.7", "ox": "0.11.3", "ws": "8.18.3" }, "peerDependencies": { "typescript": ">=5.0.4" }, "optionalPeers": ["typescript"] }, "sha512-LN6Pp7vSfv50LgwhkfSbIXftAM5J89lP9x8TeDa8QM7o41IxlHrDh0F9X+FfnCWtsz11pEVV5sn+yBUoOHNqYA=="],
|
||||
|
||||
"vite": ["vite@7.1.7", "", { "dependencies": { "esbuild": "^0.25.0", "fdir": "^6.5.0", "picomatch": "^4.0.3", "postcss": "^8.5.6", "rollup": "^4.43.0", "tinyglobby": "^0.2.15" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^20.19.0 || >=22.12.0", "jiti": ">=1.21.0", "less": "^4.0.0", "lightningcss": "^1.21.0", "sass": "^1.70.0", "sass-embedded": "^1.70.0", "stylus": ">=0.54.8", "sugarss": "^5.0.0", "terser": "^5.16.0", "tsx": "^4.8.1", "yaml": "^2.4.2" }, "optionalPeers": ["@types/node", "jiti", "less", "lightningcss", "sass", "sass-embedded", "stylus", "sugarss", "terser", "tsx", "yaml"], "bin": { "vite": "bin/vite.js" } }, "sha512-VbA8ScMvAISJNJVbRDTJdCwqQoAareR/wutevKanhR2/1EkoXVZVkkORaYm/tNVCjP/UDTKtcw3bAkwOUdedmA=="],
|
||||
|
||||
"vitest": ["vitest@4.0.18", "", { "dependencies": { "@vitest/expect": "4.0.18", "@vitest/mocker": "4.0.18", "@vitest/pretty-format": "4.0.18", "@vitest/runner": "4.0.18", "@vitest/snapshot": "4.0.18", "@vitest/spy": "4.0.18", "@vitest/utils": "4.0.18", "es-module-lexer": "^1.7.0", "expect-type": "^1.2.2", "magic-string": "^0.30.21", "obug": "^2.1.1", "pathe": "^2.0.3", "picomatch": "^4.0.3", "std-env": "^3.10.0", "tinybench": "^2.9.0", "tinyexec": "^1.0.2", "tinyglobby": "^0.2.15", "tinyrainbow": "^3.0.3", "vite": "^6.0.0 || ^7.0.0", "why-is-node-running": "^2.3.0" }, "peerDependencies": { "@edge-runtime/vm": "*", "@opentelemetry/api": "^1.9.0", "@types/node": "^20.0.0 || ^22.0.0 || >=24.0.0", "@vitest/browser-playwright": "4.0.18", "@vitest/browser-preview": "4.0.18", "@vitest/browser-webdriverio": "4.0.18", "@vitest/ui": "4.0.18", "happy-dom": "*", "jsdom": "*" }, "optionalPeers": ["@edge-runtime/vm", "@opentelemetry/api", "@types/node", "@vitest/browser-playwright", "@vitest/browser-preview", "@vitest/browser-webdriverio", "@vitest/ui", "happy-dom", "jsdom"], "bin": { "vitest": "vitest.mjs" } }, "sha512-hOQuK7h0FGKgBAas7v0mSAsnvrIgAvWmRFjmzpJ7SwFHH3g1k2u37JtYwOwmEKhK6ZO3v9ggDBBm0La1LCK4uQ=="],
|
||||
"vite-node": ["vite-node@3.2.4", "", { "dependencies": { "cac": "^6.7.14", "debug": "^4.4.1", "es-module-lexer": "^1.7.0", "pathe": "^2.0.3", "vite": "^5.0.0 || ^6.0.0 || ^7.0.0-0" }, "bin": { "vite-node": "vite-node.mjs" } }, "sha512-EbKSKh+bh1E1IFxeO0pg1n4dvoOTt0UDiXMd/qn++r98+jPO1xtJilvXldeuQ8giIB5IkpjCgMleHMNEsGH6pg=="],
|
||||
|
||||
"vitest": ["vitest@3.2.4", "", { "dependencies": { "@types/chai": "^5.2.2", "@vitest/expect": "3.2.4", "@vitest/mocker": "3.2.4", "@vitest/pretty-format": "^3.2.4", "@vitest/runner": "3.2.4", "@vitest/snapshot": "3.2.4", "@vitest/spy": "3.2.4", "@vitest/utils": "3.2.4", "chai": "^5.2.0", "debug": "^4.4.1", "expect-type": "^1.2.1", "magic-string": "^0.30.17", "pathe": "^2.0.3", "picomatch": "^4.0.2", "std-env": "^3.9.0", "tinybench": "^2.9.0", "tinyexec": "^0.3.2", "tinyglobby": "^0.2.14", "tinypool": "^1.1.1", "tinyrainbow": "^2.0.0", "vite": "^5.0.0 || ^6.0.0 || ^7.0.0-0", "vite-node": "3.2.4", "why-is-node-running": "^2.3.0" }, "peerDependencies": { "@edge-runtime/vm": "*", "@types/debug": "^4.1.12", "@types/node": "^18.0.0 || ^20.0.0 || >=22.0.0", "@vitest/browser": "3.2.4", "@vitest/ui": "3.2.4", "happy-dom": "*", "jsdom": "*" }, "optionalPeers": ["@edge-runtime/vm", "@types/debug", "@types/node", "@vitest/browser", "@vitest/ui", "happy-dom", "jsdom"], "bin": { "vitest": "vitest.mjs" } }, "sha512-LUCP5ev3GURDysTWiP47wRRUpLKMOfPh+yKTx3kVIEiu5KOMeqzpnYNsKyOoVrULivR8tLcks4+lga33Whn90A=="],
|
||||
|
||||
"why-is-node-running": ["why-is-node-running@2.3.0", "", { "dependencies": { "siginfo": "^2.0.0", "stackback": "0.0.2" }, "bin": { "why-is-node-running": "cli.js" } }, "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w=="],
|
||||
|
||||
"widest-line": ["widest-line@6.0.0", "", { "dependencies": { "string-width": "^8.1.0" } }, "sha512-U89AsyEeAsyoF0zVJBkG9zBgekjgjK7yk9sje3F4IQpXBJ10TF6ByLlIfjMhcmHMJgHZI4KHt4rdNfktzxIAMA=="],
|
||||
"widest-line": ["widest-line@5.0.0", "", { "dependencies": { "string-width": "^7.0.0" } }, "sha512-c9bZp7b5YtRj2wOe6dlj32MK+Bx/M/d+9VB2SHM1OtsUHR0aV0tdP6DWh/iMt0kWi1t5g1Iudu6hQRNd1A4PVA=="],
|
||||
|
||||
"wrap-ansi": ["wrap-ansi@9.0.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "string-width": "^7.0.0", "strip-ansi": "^7.1.0" } }, "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww=="],
|
||||
|
||||
@@ -426,16 +407,34 @@
|
||||
|
||||
"yoga-layout": ["yoga-layout@3.2.1", "", {}, "sha512-0LPOt3AxKqMdFBZA3HBAt/t/8vIKq7VaQYbuA8WxCgung+p9TVyKRYdpvCb80HcdTN2NkbIKbhNwKUfm3tQywQ=="],
|
||||
|
||||
"@scure/bip32/@noble/curves": ["@noble/curves@1.9.1", "", { "dependencies": { "@noble/hashes": "1.8.0" } }, "sha512-k11yZxZg+t+gWvBbIswW0yoJlu8cHOC7dhunwOzoWH/mXGBiYyR4YY6hAEK/3EUs4UpB8la1RfdRpeGsFHkWsA=="],
|
||||
|
||||
"cli-truncate/slice-ansi": ["slice-ansi@7.1.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "is-fullwidth-code-point": "^5.0.0" } }, "sha512-iOBWFgUX7caIZiuutICxVgX1SdxwAVFFKwt1EvMYYec/NWO5meOJ6K5uQxhrYBdQJne4KxiqZc+KptFOWFSI9w=="],
|
||||
|
||||
"ox/@noble/curves": ["@noble/curves@1.9.1", "", { "dependencies": { "@noble/hashes": "1.8.0" } }, "sha512-k11yZxZg+t+gWvBbIswW0yoJlu8cHOC7dhunwOzoWH/mXGBiYyR4YY6hAEK/3EUs4UpB8la1RfdRpeGsFHkWsA=="],
|
||||
|
||||
"ox/@noble/hashes": ["@noble/hashes@1.8.0", "", {}, "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A=="],
|
||||
|
||||
"ox/@scure/bip32": ["@scure/bip32@1.7.0", "", { "dependencies": { "@noble/curves": "~1.9.0", "@noble/hashes": "~1.8.0", "@scure/base": "~1.2.5" } }, "sha512-E4FFX/N3f4B80AKWp5dP6ow+flD1LQZo/w8UnLGYZO674jS6YnYeepycOOksv+vLPSpgN35wgKgy+ybfTb2SMw=="],
|
||||
|
||||
"ox/@scure/bip39": ["@scure/bip39@1.6.0", "", { "dependencies": { "@noble/hashes": "~1.8.0", "@scure/base": "~1.2.5" } }, "sha512-+lF0BbLiJNwVlev4eKelw1WWLaiKXw7sSl8T6FvBlWkdX+94aGJ4o8XjUdlyhTCjd8c+B3KT3JfS8P0bLRNU6A=="],
|
||||
|
||||
"viem/@noble/curves": ["@noble/curves@1.9.1", "", { "dependencies": { "@noble/hashes": "1.8.0" } }, "sha512-k11yZxZg+t+gWvBbIswW0yoJlu8cHOC7dhunwOzoWH/mXGBiYyR4YY6hAEK/3EUs4UpB8la1RfdRpeGsFHkWsA=="],
|
||||
|
||||
"viem/@noble/hashes": ["@noble/hashes@1.8.0", "", {}, "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A=="],
|
||||
|
||||
"viem/@scure/bip32": ["@scure/bip32@1.7.0", "", { "dependencies": { "@noble/curves": "~1.9.0", "@noble/hashes": "~1.8.0", "@scure/base": "~1.2.5" } }, "sha512-E4FFX/N3f4B80AKWp5dP6ow+flD1LQZo/w8UnLGYZO674jS6YnYeepycOOksv+vLPSpgN35wgKgy+ybfTb2SMw=="],
|
||||
|
||||
"viem/@scure/bip39": ["@scure/bip39@1.6.0", "", { "dependencies": { "@noble/hashes": "~1.8.0", "@scure/base": "~1.2.5" } }, "sha512-+lF0BbLiJNwVlev4eKelw1WWLaiKXw7sSl8T6FvBlWkdX+94aGJ4o8XjUdlyhTCjd8c+B3KT3JfS8P0bLRNU6A=="],
|
||||
|
||||
"viem/ws": ["ws@8.18.3", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": ">=5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg=="],
|
||||
|
||||
"widest-line/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
|
||||
|
||||
"wrap-ansi/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
|
||||
|
||||
"ox/@scure/bip32/@scure/base": ["@scure/base@1.2.6", "", {}, "sha512-g/nm5FgUa//MCj1gV09zTJTaM6KBAHqLN907YVQqf7zC49+DcO4B1so4ZX07Ef10Twr6nuqYEH9GEggFXA4Fmg=="],
|
||||
|
||||
"ox/@scure/bip39/@scure/base": ["@scure/base@1.2.6", "", {}, "sha512-g/nm5FgUa//MCj1gV09zTJTaM6KBAHqLN907YVQqf7zC49+DcO4B1so4ZX07Ef10Twr6nuqYEH9GEggFXA4Fmg=="],
|
||||
|
||||
"viem/@scure/bip32/@scure/base": ["@scure/base@1.2.6", "", {}, "sha512-g/nm5FgUa//MCj1gV09zTJTaM6KBAHqLN907YVQqf7zC49+DcO4B1so4ZX07Ef10Twr6nuqYEH9GEggFXA4Fmg=="],
|
||||
|
||||
"viem/@scure/bip39/@scure/base": ["@scure/base@1.2.6", "", {}, "sha512-g/nm5FgUa//MCj1gV09zTJTaM6KBAHqLN907YVQqf7zC49+DcO4B1so4ZX07Ef10Twr6nuqYEH9GEggFXA4Fmg=="],
|
||||
}
|
||||
}
|
||||
|
||||
-389
@@ -1,389 +0,0 @@
|
||||
# ritmex-bot CLI User Guide (English)
|
||||
|
||||
This guide documents the `ritmex-bot` command mode (agent-friendly mode), which lets you run structured trading operations without entering the Ink interactive menu.
|
||||
|
||||
## 1. Scope
|
||||
|
||||
`ritmex-bot` CLI command mode covers:
|
||||
|
||||
- Exchange listing and capability checks
|
||||
- Market data (`ticker` / `depth` / `kline`)
|
||||
- Account and position queries
|
||||
- Open/create/cancel/cancel-all order operations
|
||||
- Strategy execution (including dry-run)
|
||||
|
||||
This mode is suitable for:
|
||||
|
||||
- Manual terminal usage
|
||||
- `npx` / `bunx` invocation
|
||||
- Programmatic AI-agent workflows (recommended with `--json`)
|
||||
|
||||
## 2. Installation and Run Modes
|
||||
|
||||
### 2.1 Global install (recommended)
|
||||
|
||||
```bash
|
||||
npm install -g ritmex-bot
|
||||
ritmex-bot doctor
|
||||
```
|
||||
|
||||
### 2.2 Quick run without install
|
||||
|
||||
```bash
|
||||
npx ritmex-bot doctor
|
||||
bunx ritmex-bot doctor
|
||||
```
|
||||
|
||||
### 2.3 Local dependency
|
||||
|
||||
```bash
|
||||
npm install ritmex-bot
|
||||
npx ritmex-bot doctor
|
||||
```
|
||||
|
||||
### 2.4 Run from repository source
|
||||
|
||||
```bash
|
||||
bun run index.ts doctor
|
||||
bun run index.ts market ticker --exchange binance --symbol BTCUSDT
|
||||
```
|
||||
|
||||
> Note: `bin/ritmex-bot` launches the entrypoint via `bun run`, so Bun must be available in the runtime environment.
|
||||
|
||||
## 3. Command Shape
|
||||
|
||||
```bash
|
||||
ritmex-bot <root-command> <action> [options]
|
||||
```
|
||||
|
||||
Supported root commands:
|
||||
|
||||
- `help`
|
||||
- `doctor`
|
||||
- `exchange`
|
||||
- `market`
|
||||
- `account`
|
||||
- `position`
|
||||
- `order`
|
||||
- `strategy`
|
||||
|
||||
Quick help:
|
||||
|
||||
```bash
|
||||
ritmex-bot help
|
||||
ritmex-bot market ticker --help
|
||||
```
|
||||
|
||||
## 4. Global Options
|
||||
|
||||
| Option | Short | Description | Default |
|
||||
| --- | --- | --- | --- |
|
||||
| `--exchange` | `-e` | Exchange ID override | Existing env resolution |
|
||||
| `--symbol` | - | Trading symbol (pass-through) | Existing env resolution |
|
||||
| `--json` | `-j` | JSON output | `false` |
|
||||
| `--dry-run` | `-d` | Simulate write operations | `false` |
|
||||
| `--timeout` | `-t` | Timeout in milliseconds | `25000` |
|
||||
| `--help` | `-h` | Show command help | `false` |
|
||||
|
||||
## 5. Environment Variables and Symbol Rules
|
||||
|
||||
Command mode follows these constraints:
|
||||
|
||||
- No new environment variables are introduced.
|
||||
- No existing environment-variable names are modified.
|
||||
- Runtime values are read directly from the current CLI environment.
|
||||
- If `--exchange` is not provided, exchange resolution follows the existing logic (for example `EXCHANGE` / `TRADE_EXCHANGE`).
|
||||
- If `--symbol` is not provided, symbol resolution follows the existing exchange-specific env logic.
|
||||
- Symbols are never normalized or rewritten by command mode.
|
||||
|
||||
That means symbol variants such as `BTCUSDT`, `BTCUSDC`, spot/perp pairs, and venue-specific naming are fully controlled by your existing environment configuration.
|
||||
|
||||
## 6. Command Reference
|
||||
|
||||
### 6.1 `doctor`
|
||||
|
||||
Checks effective exchange/symbol setup and runtime adapter capabilities.
|
||||
|
||||
```bash
|
||||
ritmex-bot doctor
|
||||
ritmex-bot doctor --exchange binance --symbol BTCUSDT --json
|
||||
```
|
||||
|
||||
### 6.2 `exchange`
|
||||
|
||||
### List supported exchanges
|
||||
|
||||
```bash
|
||||
ritmex-bot exchange list
|
||||
```
|
||||
|
||||
### Inspect exchange capabilities
|
||||
|
||||
```bash
|
||||
ritmex-bot exchange capabilities --exchange standx
|
||||
```
|
||||
|
||||
If runtime adapter initialization fails, CLI falls back to static capability metadata (`source: "static"`) and includes a warning.
|
||||
|
||||
### 6.3 `market`
|
||||
|
||||
### `market ticker`
|
||||
|
||||
```bash
|
||||
ritmex-bot market ticker --exchange binance --symbol BTCUSDT
|
||||
```
|
||||
|
||||
### `market depth`
|
||||
|
||||
```bash
|
||||
ritmex-bot market depth --exchange binance --symbol BTCUSDT --levels 10
|
||||
```
|
||||
|
||||
`--levels` is optional; when provided, depth levels are truncated to that value.
|
||||
|
||||
### `market kline`
|
||||
|
||||
```bash
|
||||
ritmex-bot market kline --exchange binance --symbol BTCUSDT --interval 1m --limit 50
|
||||
```
|
||||
|
||||
Arguments:
|
||||
|
||||
- `--interval` is required
|
||||
- `--limit` is optional (keeps the latest N candles)
|
||||
|
||||
### 6.4 `account` and `position`
|
||||
|
||||
### Account snapshot
|
||||
|
||||
```bash
|
||||
ritmex-bot account snapshot --exchange standx
|
||||
ritmex-bot account summary --exchange standx
|
||||
```
|
||||
|
||||
`summary` is an alias of `snapshot`.
|
||||
|
||||
### Position list
|
||||
|
||||
```bash
|
||||
ritmex-bot position list --exchange standx
|
||||
ritmex-bot position list --exchange standx --symbol BTC-USD
|
||||
```
|
||||
|
||||
If `--symbol` is provided, result positions are filtered by that symbol.
|
||||
|
||||
### 6.5 `order`
|
||||
|
||||
### Open orders
|
||||
|
||||
```bash
|
||||
ritmex-bot order open --exchange binance --symbol BTCUSDT
|
||||
```
|
||||
|
||||
### Create order
|
||||
|
||||
```bash
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side buy --type limit --quantity 0.01 --price 90000
|
||||
```
|
||||
|
||||
Create-order arguments:
|
||||
|
||||
| Option | Required | Description |
|
||||
| --- | --- | --- |
|
||||
| `--side` | Yes | `buy` / `sell` |
|
||||
| `--type` | Yes | `limit` / `market` / `stop` / `trailing-stop` / `close` |
|
||||
| `--quantity` or `--qty` | Yes | Order quantity |
|
||||
| `--price` | Required for `limit` | Limit price |
|
||||
| `--stop-price` | Required for `stop` | Stop trigger price |
|
||||
| `--activation-price` | Required for `trailing-stop` | Trailing-stop activation price |
|
||||
| `--callback-rate` | Required for `trailing-stop` | Trailing-stop callback rate |
|
||||
| `--time-in-force` | No | `GTC` / `IOC` / `FOK` / `GTX` |
|
||||
| `--reduce-only` | No | `true/false` |
|
||||
| `--close-position` | No | `true/false` |
|
||||
| `--trigger-type` | No | `UNSPECIFIED` / `TAKE_PROFIT` / `STOP_LOSS` |
|
||||
| `--sl-price` | No | Stop-loss price (router applies venue capability rules) |
|
||||
| `--tp-price` | No | Take-profit price (router applies venue capability rules) |
|
||||
|
||||
Examples:
|
||||
|
||||
```bash
|
||||
# Market order
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side buy --type market --qty 0.01
|
||||
|
||||
# Stop order
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side sell --type stop --qty 0.01 --stop-price 86000
|
||||
|
||||
# Trailing-stop order
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side sell --type trailing-stop --qty 0.01 --activation-price 91000 --callback-rate 0.2
|
||||
|
||||
# Close intent order (defaults reduceOnly/closePosition in route layer)
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side sell --type close --qty 0.01
|
||||
```
|
||||
|
||||
### Cancel order
|
||||
|
||||
```bash
|
||||
ritmex-bot order cancel --exchange binance --symbol BTCUSDT --order-id 123456
|
||||
```
|
||||
|
||||
### Cancel all orders
|
||||
|
||||
```bash
|
||||
ritmex-bot order cancel-all --exchange binance --symbol BTCUSDT
|
||||
```
|
||||
|
||||
If `forceCancelAllOrders` is available on the adapter, CLI uses it first; otherwise it falls back to standard cancel-all behavior.
|
||||
|
||||
### 6.6 `strategy`
|
||||
|
||||
### Run strategy
|
||||
|
||||
```bash
|
||||
ritmex-bot strategy run --strategy maker --exchange standx --silent
|
||||
```
|
||||
|
||||
Supported strategy IDs:
|
||||
|
||||
- `trend`
|
||||
- `swing`
|
||||
- `guardian`
|
||||
- `maker`
|
||||
- `maker-points`
|
||||
- `offset-maker`
|
||||
- `liquidity-maker`
|
||||
- `basis`
|
||||
- `grid`
|
||||
|
||||
Supported aliases:
|
||||
|
||||
- `offset` -> `offset-maker`
|
||||
- `makerpoints` / `maker_points` -> `maker-points`
|
||||
- `liquidity` / `liquiditymaker` / `liquidity_maker` -> `liquidity-maker`
|
||||
|
||||
Extra options:
|
||||
|
||||
- `--silent` (short form `-q`) for quieter strategy startup logs
|
||||
- `--dry-run` to propagate simulation mode into strategy execution
|
||||
|
||||
## 7. `--dry-run` Behavior
|
||||
|
||||
With `--dry-run` enabled:
|
||||
|
||||
- `order create` / `order cancel` / `order cancel-all` do not send real write operations.
|
||||
- Response includes `dryRunActions` so you can inspect the simulated intent.
|
||||
- `strategy run` receives dry-run mode in the strategy runner.
|
||||
- Read-only commands (market/account/position queries) keep normal behavior.
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side buy --type limit --quantity 0.01 --price 90000 --dry-run --json
|
||||
```
|
||||
|
||||
## 8. Unsupported Features
|
||||
|
||||
Exchange capabilities are intentionally not forced into a fake unified surface. If a venue does not support a feature, CLI returns `UNSUPPORTED` directly.
|
||||
|
||||
Typical cases:
|
||||
|
||||
- Exchange does not implement `queryOpenOrders`
|
||||
- Exchange does not implement `queryAccountSnapshot`
|
||||
- Exchange-specific order type limitations
|
||||
|
||||
Callers should handle `UNSUPPORTED` as a first-class outcome.
|
||||
|
||||
## 9. Output and Exit Codes
|
||||
|
||||
### 9.1 Human-readable output (default)
|
||||
|
||||
Success:
|
||||
|
||||
```text
|
||||
[OK] market-ticker
|
||||
time: 2026-02-27T12:00:00.000Z
|
||||
exchange: binance
|
||||
symbol: BTCUSDT
|
||||
dryRun: false
|
||||
...
|
||||
```
|
||||
|
||||
Failure:
|
||||
|
||||
```text
|
||||
[ERROR] order-open
|
||||
time: 2026-02-27T12:00:00.000Z
|
||||
code: UNSUPPORTED
|
||||
message: queryOpenOrders is not supported on exchange 'aster'
|
||||
retryable: false
|
||||
```
|
||||
|
||||
### 9.2 JSON output (`--json`)
|
||||
|
||||
Success payload:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"command": "market-ticker",
|
||||
"exchange": "binance",
|
||||
"symbol": "BTCUSDT",
|
||||
"dryRun": false,
|
||||
"ts": "2026-02-27T12:00:00.000Z",
|
||||
"data": {}
|
||||
}
|
||||
```
|
||||
|
||||
Failure payload:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": false,
|
||||
"command": "order-open",
|
||||
"exchange": "aster",
|
||||
"symbol": "BTCUSDT",
|
||||
"dryRun": false,
|
||||
"ts": "2026-02-27T12:00:00.000Z",
|
||||
"error": {
|
||||
"code": "UNSUPPORTED",
|
||||
"message": "queryOpenOrders is not supported on exchange 'aster'",
|
||||
"retryable": false
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 9.3 Exit codes
|
||||
|
||||
| Exit Code | Meaning |
|
||||
| --- | --- |
|
||||
| `0` | Success |
|
||||
| `2` | Invalid arguments (`INVALID_ARGS`) |
|
||||
| `3` | Missing environment setup (`MISSING_ENV`) |
|
||||
| `5` | Unsupported feature (`UNSUPPORTED`) |
|
||||
| `6` | Exchange execution error (`EXCHANGE_ERROR`) |
|
||||
| `7` | Timeout (`TIMEOUT`) |
|
||||
|
||||
## 10. Recommended AI-Agent Flow
|
||||
|
||||
```bash
|
||||
# 1) Check venue capabilities
|
||||
ritmex-bot exchange capabilities --exchange binance --json
|
||||
|
||||
# 2) Fetch market state
|
||||
ritmex-bot market ticker --exchange binance --symbol BTCUSDT --json
|
||||
|
||||
# 3) Validate order parameters with dry-run
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side buy --type limit --quantity 0.01 --price 90000 --dry-run --json
|
||||
|
||||
# 4) Submit live order after validation (remove --dry-run)
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side buy --type limit --quantity 0.01 --price 90000 --json
|
||||
```
|
||||
|
||||
## 11. Compatibility With Existing Features
|
||||
|
||||
Command mode does not break existing interactive or legacy startup flows:
|
||||
|
||||
- `bun run index.ts` still opens the Ink menu
|
||||
- `bun run index.ts --strategy trend --silent` still starts strategy directly
|
||||
- Command mode is used only when the first argument matches command roots (for example `market`, `order`, `strategy`)
|
||||
|
||||
If you already run the project with current env variables and strategy configs, command mode can be adopted incrementally with no env-key migration.
|
||||
-388
@@ -1,388 +0,0 @@
|
||||
# ritmex-bot CLI 使用手册（中文）
|
||||
|
||||
本文档介绍 `ritmex-bot` 的命令模式（Agent 友好模式），用于在不进入 Ink 菜单的情况下执行结构化交易操作。
|
||||
|
||||
## 1. 适用范围
|
||||
|
||||
`ritmex-bot` CLI 命令模式覆盖以下能力：
|
||||
|
||||
- 交易所列表与能力查询
|
||||
- 行情（ticker/depth/kline）
|
||||
- 账户与仓位查询
|
||||
- 订单查询、下单、撤单、全撤
|
||||
- 策略启动（支持 dry-run）
|
||||
|
||||
这套命令适合：
|
||||
|
||||
- 直接在终端手动执行
|
||||
- 通过 `npx` / `bunx` 调用
|
||||
- 被 AI Agent / 自动化系统程序化调用（推荐配合 `--json`）
|
||||
|
||||
## 2. 安装与运行方式
|
||||
|
||||
### 2.1 全局安装（推荐）
|
||||
|
||||
```bash
|
||||
npm install -g ritmex-bot
|
||||
ritmex-bot doctor
|
||||
```
|
||||
|
||||
### 2.2 无需安装直接运行
|
||||
|
||||
```bash
|
||||
npx ritmex-bot doctor
|
||||
bunx ritmex-bot doctor
|
||||
```
|
||||
|
||||
### 2.3 作为项目依赖
|
||||
|
||||
```bash
|
||||
npm install ritmex-bot
|
||||
npx ritmex-bot doctor
|
||||
```
|
||||
|
||||
### 2.4 在仓库源码中运行
|
||||
|
||||
```bash
|
||||
bun run index.ts doctor
|
||||
bun run index.ts market ticker --exchange binance --symbol BTCUSDT
|
||||
```
|
||||
|
||||
> 注意：`bin/ritmex-bot` 会调用 `bun run` 启动入口文件，因此运行环境需要可用的 Bun。
|
||||
|
||||
## 3. 命令结构
|
||||
|
||||
```bash
|
||||
ritmex-bot <root-command> <action> [options]
|
||||
```
|
||||
|
||||
支持的根命令：
|
||||
|
||||
- `help`
|
||||
- `doctor`
|
||||
- `exchange`
|
||||
- `market`
|
||||
- `account`
|
||||
- `position`
|
||||
- `order`
|
||||
- `strategy`
|
||||
|
||||
快速帮助：
|
||||
|
||||
```bash
|
||||
ritmex-bot help
|
||||
ritmex-bot market ticker --help
|
||||
```
|
||||
|
||||
## 4. 全局参数
|
||||
|
||||
| 参数 | 短参数 | 说明 | 默认值 |
|
||||
| --- | --- | --- | --- |
|
||||
| `--exchange` | `-e` | 指定交易所 ID | 走现有环境变量解析 |
|
||||
| `--symbol` | - | 指定交易对，原样透传 | 走现有环境变量解析 |
|
||||
| `--json` | `-j` | 以 JSON 输出结果 | `false` |
|
||||
| `--dry-run` | `-d` | 模拟执行（不发真实写操作） | `false` |
|
||||
| `--timeout` | `-t` | 超时毫秒数 | `25000` |
|
||||
| `--help` | `-h` | 显示命令帮助 | `false` |
|
||||
|
||||
## 5. 环境变量与 Symbol 规则
|
||||
|
||||
`ritmex-bot` 命令模式遵循以下约束：
|
||||
|
||||
- 不新增环境变量，不修改任何已有变量名称。
|
||||
- 从当前 CLI 执行环境读取已有配置（例如 `.env` 已加载到进程环境后）。
|
||||
- `--exchange` 未指定时，按现有逻辑解析交易所（例如 `EXCHANGE` / `TRADE_EXCHANGE`）。
|
||||
- `--symbol` 未指定时，按现有逻辑从对应交易所配置中解析符号。
|
||||
- 对 `symbol` 不做统一、不做改写、不做跨交易所映射。你传什么就用什么。
|
||||
|
||||
这意味着像 Binance 的 `BTCUSDT`、`BTCUSDC`、现货/永续等差异，全部由你通过现有配置自行决定。
|
||||
|
||||
## 6. 命令详解
|
||||
|
||||
### 6.1 `doctor`
|
||||
|
||||
用于检查当前交易所/交易对配置与适配器能力。
|
||||
|
||||
```bash
|
||||
ritmex-bot doctor
|
||||
ritmex-bot doctor --exchange binance --symbol BTCUSDT --json
|
||||
```
|
||||
|
||||
### 6.2 `exchange`
|
||||
|
||||
### 列出支持的交易所
|
||||
|
||||
```bash
|
||||
ritmex-bot exchange list
|
||||
```
|
||||
|
||||
### 查询交易所能力
|
||||
|
||||
```bash
|
||||
ritmex-bot exchange capabilities --exchange standx
|
||||
```
|
||||
|
||||
如果运行时无法构建适配器，会返回静态能力信息（`source: "static"`）及警告。
|
||||
|
||||
### 6.3 `market`
|
||||
|
||||
### `market ticker`
|
||||
|
||||
```bash
|
||||
ritmex-bot market ticker --exchange binance --symbol BTCUSDT
|
||||
```
|
||||
|
||||
### `market depth`
|
||||
|
||||
```bash
|
||||
ritmex-bot market depth --exchange binance --symbol BTCUSDT --levels 10
|
||||
```
|
||||
|
||||
`--levels` 为可选，指定后会截断返回档位数量。
|
||||
|
||||
### `market kline`
|
||||
|
||||
```bash
|
||||
ritmex-bot market kline --exchange binance --symbol BTCUSDT --interval 1m --limit 50
|
||||
```
|
||||
|
||||
参数说明：
|
||||
|
||||
- `--interval` 必填
|
||||
- `--limit` 可选（仅保留最后 N 条）
|
||||
|
||||
### 6.4 `account` 与 `position`
|
||||
|
||||
### 账户快照
|
||||
|
||||
```bash
|
||||
ritmex-bot account snapshot --exchange standx
|
||||
ritmex-bot account summary --exchange standx
|
||||
```
|
||||
|
||||
`summary` 是 `snapshot` 的别名。
|
||||
|
||||
### 仓位列表
|
||||
|
||||
```bash
|
||||
ritmex-bot position list --exchange standx
|
||||
ritmex-bot position list --exchange standx --symbol BTC-USD
|
||||
```
|
||||
|
||||
传 `--symbol` 时会在返回结果中做符号过滤。
|
||||
|
||||
### 6.5 `order`
|
||||
|
||||
### 查询当前挂单
|
||||
|
||||
```bash
|
||||
ritmex-bot order open --exchange binance --symbol BTCUSDT
|
||||
```
|
||||
|
||||
### 创建订单
|
||||
|
||||
```bash
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side buy --type limit --quantity 0.01 --price 90000
|
||||
```
|
||||
|
||||
创建订单参数：
|
||||
|
||||
| 参数 | 必填 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| `--side` | 是 | `buy` / `sell` |
|
||||
| `--type` | 是 | `limit` / `market` / `stop` / `trailing-stop` / `close` |
|
||||
| `--quantity` 或 `--qty` | 是 | 下单数量 |
|
||||
| `--price` | `limit` 必填 | 限价单价格 |
|
||||
| `--stop-price` | `stop` 必填 | 触发价 |
|
||||
| `--activation-price` | `trailing-stop` 必填 | 激活价 |
|
||||
| `--callback-rate` | `trailing-stop` 必填 | 回调比例 |
|
||||
| `--time-in-force` | 否 | `GTC` / `IOC` / `FOK` / `GTX` |
|
||||
| `--reduce-only` | 否 | `true/false` |
|
||||
| `--close-position` | 否 | `true/false` |
|
||||
| `--trigger-type` | 否 | `UNSPECIFIED` / `TAKE_PROFIT` / `STOP_LOSS` |
|
||||
| `--sl-price` | 否 | 止损价（路由层按交易所能力处理） |
|
||||
| `--tp-price` | 否 | 止盈价（路由层按交易所能力处理） |
|
||||
|
||||
示例：
|
||||
|
||||
```bash
|
||||
# 市价单
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side buy --type market --qty 0.01
|
||||
|
||||
# 止损单
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side sell --type stop --qty 0.01 --stop-price 86000
|
||||
|
||||
# 移动止损单
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side sell --type trailing-stop --qty 0.01 --activation-price 91000 --callback-rate 0.2
|
||||
|
||||
# close 语义单（默认会补全 reduceOnly/closePosition）
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side sell --type close --qty 0.01
|
||||
```
|
||||
|
||||
### 撤单
|
||||
|
||||
```bash
|
||||
ritmex-bot order cancel --exchange binance --symbol BTCUSDT --order-id 123456
|
||||
```
|
||||
|
||||
### 全撤
|
||||
|
||||
```bash
|
||||
ritmex-bot order cancel-all --exchange binance --symbol BTCUSDT
|
||||
```
|
||||
|
||||
若交易所支持 `forceCancelAllOrders`，会优先走该能力；否则回退普通批量撤单逻辑。
|
||||
|
||||
### 6.6 `strategy`
|
||||
|
||||
### 启动策略
|
||||
|
||||
```bash
|
||||
ritmex-bot strategy run --strategy maker --exchange standx --silent
|
||||
```
|
||||
|
||||
支持策略 ID：
|
||||
|
||||
- `trend`
|
||||
- `swing`
|
||||
- `guardian`
|
||||
- `maker`
|
||||
- `maker-points`
|
||||
- `offset-maker`
|
||||
- `liquidity-maker`
|
||||
- `basis`
|
||||
- `grid`
|
||||
|
||||
常用别名：
|
||||
|
||||
- `offset` -> `offset-maker`
|
||||
- `makerpoints` / `maker_points` -> `maker-points`
|
||||
- `liquidity` / `liquiditymaker` / `liquidity_maker` -> `liquidity-maker`
|
||||
|
||||
额外参数：
|
||||
|
||||
- `--silent`（短参数 `-q`）静默运行
|
||||
- `--dry-run` 传递到策略运行器，启用策略级模拟
|
||||
|
||||
## 7. `--dry-run` 模拟执行
|
||||
|
||||
当开启 `--dry-run`：
|
||||
|
||||
- `order create` / `order cancel` / `order cancel-all` 不会发送真实写操作。
|
||||
- 返回结果包含 `dryRunActions`，用于观察本次模拟会执行什么操作。
|
||||
- `strategy run` 会将 dry-run 模式传入策略执行链路。
|
||||
- 只读类命令（行情、查询）不会改变行为。
|
||||
|
||||
示例：
|
||||
|
||||
```bash
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side buy --type limit --quantity 0.01 --price 90000 --dry-run --json
|
||||
```
|
||||
|
||||
## 8. 不支持能力的处理
|
||||
|
||||
不同交易所能力不完全一致。对于未实现或不支持的功能，CLI 会直接返回 `UNSUPPORTED` 错误，而不是静默忽略。
|
||||
|
||||
常见场景：
|
||||
|
||||
- 某些交易所不支持 `queryOpenOrders`
|
||||
- 某些交易所不支持 `queryAccountSnapshot`
|
||||
- 某些交易所不支持特定委托类型
|
||||
|
||||
建议调用方按错误码降级处理。
|
||||
|
||||
## 9. 输出格式与退出码
|
||||
|
||||
### 9.1 文本输出（默认）
|
||||
|
||||
成功：
|
||||
|
||||
```text
|
||||
[OK] market-ticker
|
||||
time: 2026-02-27T12:00:00.000Z
|
||||
exchange: binance
|
||||
symbol: BTCUSDT
|
||||
dryRun: false
|
||||
...
|
||||
```
|
||||
|
||||
失败：
|
||||
|
||||
```text
|
||||
[ERROR] order-open
|
||||
time: 2026-02-27T12:00:00.000Z
|
||||
code: UNSUPPORTED
|
||||
message: queryOpenOrders is not supported on exchange 'aster'
|
||||
retryable: false
|
||||
```
|
||||
|
||||
### 9.2 JSON 输出（`--json`）
|
||||
|
||||
成功结构：
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"command": "market-ticker",
|
||||
"exchange": "binance",
|
||||
"symbol": "BTCUSDT",
|
||||
"dryRun": false,
|
||||
"ts": "2026-02-27T12:00:00.000Z",
|
||||
"data": {}
|
||||
}
|
||||
```
|
||||
|
||||
失败结构：
|
||||
|
||||
```json
|
||||
{
|
||||
"success": false,
|
||||
"command": "order-open",
|
||||
"exchange": "aster",
|
||||
"symbol": "BTCUSDT",
|
||||
"dryRun": false,
|
||||
"ts": "2026-02-27T12:00:00.000Z",
|
||||
"error": {
|
||||
"code": "UNSUPPORTED",
|
||||
"message": "queryOpenOrders is not supported on exchange 'aster'",
|
||||
"retryable": false
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 9.3 退出码
|
||||
|
||||
| 退出码 | 含义 |
|
||||
| --- | --- |
|
||||
| `0` | 成功 |
|
||||
| `2` | 参数错误（`INVALID_ARGS`） |
|
||||
| `3` | 缺少环境配置（`MISSING_ENV`） |
|
||||
| `5` | 功能不支持（`UNSUPPORTED`） |
|
||||
| `6` | 交易所执行错误（`EXCHANGE_ERROR`） |
|
||||
| `7` | 超时（`TIMEOUT`） |
|
||||
|
||||
## 10. AI Agent 推荐调用流程
|
||||
|
||||
```bash
|
||||
# 1) 确认交易所能力
|
||||
ritmex-bot exchange capabilities --exchange binance --json
|
||||
|
||||
# 2) 拉取行情
|
||||
ritmex-bot market ticker --exchange binance --symbol BTCUSDT --json
|
||||
|
||||
# 3) dry-run 验证下单参数
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side buy --type limit --quantity 0.01 --price 90000 --dry-run --json
|
||||
|
||||
# 4) 确认后执行真实下单（去掉 --dry-run）
|
||||
ritmex-bot order create --exchange binance --symbol BTCUSDT --side buy --type limit --quantity 0.01 --price 90000 --json
|
||||
```
|
||||
|
||||
## 11. 与现有功能兼容性
|
||||
|
||||
命令模式不会破坏现有 Ink 交互模式与原有参数入口：
|
||||
|
||||
- `bun run index.ts` 仍进入交互菜单
|
||||
- `bun run index.ts --strategy trend --silent` 仍可直接跑策略
|
||||
- 仅当首参数匹配命令模式根命令时，才进入 `ritmex-bot` 命令执行路径
|
||||
|
||||
如果你已在使用现有环境变量与策略配置，可直接增量接入命令模式，无需迁移变量名。
|
||||
+13
-24
@@ -1,21 +1,11 @@
|
||||
{
|
||||
"name": "ritmex-bot",
|
||||
"version": "0.1.0",
|
||||
"module": "index.ts",
|
||||
"type": "module",
|
||||
"private": false,
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/discountry/ritmex-bot.git"
|
||||
},
|
||||
"bin": {
|
||||
"ritmex-bot": "./bin/ritmex-bot"
|
||||
},
|
||||
"private": true,
|
||||
"scripts": {
|
||||
"dev": "bun run index.ts",
|
||||
"start": "bun run index.ts",
|
||||
"lint": "oxlint",
|
||||
"lint:fix": "oxlint --fix",
|
||||
"test": "bun x vitest run",
|
||||
"test:exchange-contract": "bun x vitest run tests/exchange-contract-suite.test.ts tests/exchange-factory.test.ts tests/config.test.ts",
|
||||
"test:watch": "bun x vitest",
|
||||
@@ -28,26 +18,25 @@
|
||||
"pm2:start:maker-points": "pm2 start bun --name ritmex-maker-points --cwd . --restart-delay 5000 -- run index.ts --strategy maker-points --exchange standx --silent"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/bun": "^1.3.9",
|
||||
"oxlint": "^1.54.0",
|
||||
"vitest": "^4.0.18"
|
||||
"@types/bun": "latest",
|
||||
"vitest": "^3.2.4"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"typescript": "^5.9.3"
|
||||
"typescript": "^5.9.2"
|
||||
},
|
||||
"dependencies": {
|
||||
"@grvt/client": "^1.6.27",
|
||||
"@nadohq/client": "^0.1.0-alpha.51",
|
||||
"@grvt/client": "^1.6.25",
|
||||
"@nadohq/client": "^0.1.0-alpha.45",
|
||||
"@noble/ed25519": "^3.0.0",
|
||||
"axios": "^1.13.6",
|
||||
"bignumber.js": "^10.0.2",
|
||||
"ccxt": "^4.5.40",
|
||||
"dotenv": "^17.3.1",
|
||||
"ethereum-cryptography": "^3.2.0",
|
||||
"ink": "^6.8.0",
|
||||
"axios": "^1.13.4",
|
||||
"bignumber.js": "^9.3.1",
|
||||
"ccxt": "^4.5.35",
|
||||
"dotenv": "^17.2.3",
|
||||
"ethereum-cryptography": "^2.2.1",
|
||||
"ink": "^6.6.0",
|
||||
"react": "^19.2.4",
|
||||
"trading-signals": "^7.4.3",
|
||||
"viem": "^2.46.3",
|
||||
"viem": "^2.45.1",
|
||||
"ws": "^8.19.0"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,306 +0,0 @@
|
||||
---
|
||||
name: use-ritmex-bot
|
||||
description: Use when the task requires operating exchanges with the ritmex-bot CLI, including capability checks, market/account/position queries, order operations, strategy run, dry-run simulation, and JSON output parsing.
|
||||
---
|
||||
|
||||
# Use ritmex-bot CLI
|
||||
|
||||
This skill is for running `ritmex-bot` in an agent-safe, exchange-compatible way.
|
||||
|
||||
## Use This Skill When
|
||||
|
||||
- The user asks to use `ritmex-bot` commands directly.
|
||||
- The user wants market data, account/position, or order operations from supported exchanges.
|
||||
- The user wants AI-agent-friendly CLI execution with `--json` output.
|
||||
- The user wants simulation with `--dry-run` before real writes.
|
||||
|
||||
## Hard Rules
|
||||
|
||||
1. Do not change environment-variable names and do not invent new env keys.
|
||||
2. Read config from the current shell environment as-is.
|
||||
3. Do not normalize or rewrite `--symbol`; pass it through exactly.
|
||||
4. If a feature is not supported by an exchange, return it as unsupported (`UNSUPPORTED`), do not fake behavior.
|
||||
5. For write actions (`order create`, `order cancel`, `order cancel-all`), prefer `--dry-run` first unless the user explicitly asks to skip simulation.
|
||||
6. Use `--json` whenever output must be consumed by another agent/tool.
|
||||
|
||||
## Command Entry Options
|
||||
|
||||
Use one of these:
|
||||
|
||||
```bash
|
||||
ritmex-bot <command>
|
||||
npx ritmex-bot <command>
|
||||
bunx ritmex-bot <command>
|
||||
bun run index.ts <command>
|
||||
```
|
||||
|
||||
If `ritmex-bot` is unavailable, use `bun run index.ts <command>` from repo root.
|
||||
|
||||
## Default Agent Workflow
|
||||
|
||||
1. Determine exchange and symbol from user request.
|
||||
2. If missing, rely on existing env resolution; do not create fallback env variables.
|
||||
3. Run capability precheck:
|
||||
- `exchange list`
|
||||
- `exchange capabilities --exchange <id>`
|
||||
4. For read operations, run command directly (prefer `--json`).
|
||||
5. For write operations:
|
||||
- Run the exact command with `--dry-run --json`.
|
||||
- Validate payload and dry-run actions.
|
||||
- Run live command only when user confirmed or explicitly requested live execution.
|
||||
6. Post-check with `order open`, `position list`, or `account snapshot` as needed.
|
||||
|
||||
## Global Flags
|
||||
|
||||
| Flag | Short | Meaning |
|
||||
| --- | --- | --- |
|
||||
| `--exchange` | `-e` | Exchange override |
|
||||
| `--symbol` | - | Trading symbol (pass-through) |
|
||||
| `--json` | `-j` | JSON output |
|
||||
| `--dry-run` | `-d` | Simulate write ops |
|
||||
| `--timeout` | `-t` | Timeout in ms (default 25000) |
|
||||
| `--help` | `-h` | Show help |
|
||||
|
||||
## Root Commands
|
||||
|
||||
- `help`
|
||||
- `doctor`
|
||||
- `exchange`
|
||||
- `market`
|
||||
- `account`
|
||||
- `position`
|
||||
- `order`
|
||||
- `strategy`
|
||||
|
||||
## Command Reference
|
||||
|
||||
### `doctor`
|
||||
|
||||
```bash
|
||||
ritmex-bot doctor
|
||||
ritmex-bot doctor --exchange binance --symbol BTCUSDT --json
|
||||
```
|
||||
|
||||
Returns effective setup and runtime capabilities.
|
||||
|
||||
### `exchange`
|
||||
|
||||
```bash
|
||||
ritmex-bot exchange list
|
||||
ritmex-bot exchange capabilities --exchange standx
|
||||
```
|
||||
|
||||
If runtime adapter cannot initialize, capabilities may fallback to static metadata.
|
||||
|
||||
### `market`
|
||||
|
||||
```bash
|
||||
ritmex-bot market ticker --exchange <id> --symbol <symbol>
|
||||
ritmex-bot market depth --exchange <id> --symbol <symbol> --levels 10
|
||||
ritmex-bot market kline --exchange <id> --symbol <symbol> --interval 1m --limit 100
|
||||
```
|
||||
|
||||
Rules:
|
||||
|
||||
- `kline` requires `--interval`.
|
||||
- `depth --levels` is optional.
|
||||
- `kline --limit` is optional.
|
||||
|
||||
### `account`
|
||||
|
||||
```bash
|
||||
ritmex-bot account snapshot --exchange <id>
|
||||
ritmex-bot account summary --exchange <id>
|
||||
```
|
||||
|
||||
`summary` is an alias of `snapshot`.
|
||||
|
||||
### `position`
|
||||
|
||||
```bash
|
||||
ritmex-bot position list --exchange <id>
|
||||
ritmex-bot position list --exchange <id> --symbol <symbol>
|
||||
```
|
||||
|
||||
### `order`
|
||||
|
||||
### Query open orders
|
||||
|
||||
```bash
|
||||
ritmex-bot order open --exchange <id> --symbol <symbol>
|
||||
```
|
||||
|
||||
### Create order
|
||||
|
||||
```bash
|
||||
ritmex-bot order create --exchange <id> --symbol <symbol> --side buy --type limit --quantity 0.01 --price 90000
|
||||
```
|
||||
|
||||
Required:
|
||||
|
||||
- `--side` = `buy|sell`
|
||||
- `--type` = `limit|market|stop|trailing-stop|close`
|
||||
- `--quantity` or `--qty`
|
||||
|
||||
Conditional required:
|
||||
|
||||
- `limit`: `--price`
|
||||
- `stop`: `--stop-price`
|
||||
- `trailing-stop`: `--activation-price` and `--callback-rate`
|
||||
|
||||
Optional:
|
||||
|
||||
- `--time-in-force` (`GTC|IOC|FOK|GTX`)
|
||||
- `--reduce-only` (`true|false`)
|
||||
- `--close-position` (`true|false`)
|
||||
- `--trigger-type` (`UNSPECIFIED|TAKE_PROFIT|STOP_LOSS`)
|
||||
- `--sl-price`
|
||||
- `--tp-price`
|
||||
|
||||
### Cancel one order
|
||||
|
||||
```bash
|
||||
ritmex-bot order cancel --exchange <id> --symbol <symbol> --order-id <id>
|
||||
```
|
||||
|
||||
### Cancel all
|
||||
|
||||
```bash
|
||||
ritmex-bot order cancel-all --exchange <id> --symbol <symbol>
|
||||
```
|
||||
|
||||
### `strategy`
|
||||
|
||||
```bash
|
||||
ritmex-bot strategy run --strategy maker --exchange standx --silent
|
||||
ritmex-bot strategy run --strategy offset --exchange binance --dry-run
|
||||
```
|
||||
|
||||
Supported strategy IDs:
|
||||
|
||||
- `trend`
|
||||
- `swing`
|
||||
- `guardian`
|
||||
- `maker`
|
||||
- `maker-points`
|
||||
- `offset-maker`
|
||||
- `liquidity-maker`
|
||||
- `basis`
|
||||
- `grid`
|
||||
|
||||
Aliases:
|
||||
|
||||
- `offset` -> `offset-maker`
|
||||
- `makerpoints` / `maker_points` -> `maker-points`
|
||||
- `liquidity` / `liquiditymaker` / `liquidity_maker` -> `liquidity-maker`
|
||||
|
||||
Extra flags:
|
||||
|
||||
- `--silent` (short alias `-q`)
|
||||
- `--dry-run`
|
||||
|
||||
## Dry-Run First Patterns
|
||||
|
||||
### Create order safely
|
||||
|
||||
```bash
|
||||
# 1) Simulate
|
||||
ritmex-bot order create --exchange <id> --symbol <symbol> --side buy --type limit --quantity 0.01 --price 90000 --dry-run --json
|
||||
|
||||
# 2) Execute live only after confirmation
|
||||
ritmex-bot order create --exchange <id> --symbol <symbol> --side buy --type limit --quantity 0.01 --price 90000 --json
|
||||
```
|
||||
|
||||
### Cancel safely
|
||||
|
||||
```bash
|
||||
# 1) Simulate
|
||||
ritmex-bot order cancel --exchange <id> --symbol <symbol> --order-id <id> --dry-run --json
|
||||
|
||||
# 2) Execute live
|
||||
ritmex-bot order cancel --exchange <id> --symbol <symbol> --order-id <id> --json
|
||||
```
|
||||
|
||||
## Agent Output Handling
|
||||
|
||||
Prefer `--json` and parse:
|
||||
|
||||
- `success` (boolean)
|
||||
- `command` (executed command kind)
|
||||
- `exchange`
|
||||
- `symbol`
|
||||
- `dryRun`
|
||||
- `data` (success payload)
|
||||
- `error.code`, `error.message`, `error.retryable` (failure payload)
|
||||
|
||||
Human-readable mode is fine for manual terminal use; `--json` is preferred for automation.
|
||||
|
||||
## Error Codes and Exit Codes
|
||||
|
||||
Map failures by code/exit code:
|
||||
|
||||
- `INVALID_ARGS` -> exit `2`
|
||||
- `MISSING_ENV` -> exit `3`
|
||||
- `UNSUPPORTED` -> exit `5`
|
||||
- `EXCHANGE_ERROR` -> exit `6`
|
||||
- `TIMEOUT` -> exit `7`
|
||||
|
||||
Handling policy:
|
||||
|
||||
1. `INVALID_ARGS`: fix command arguments and retry once.
|
||||
2. `MISSING_ENV`: report missing configuration; do not invent env keys.
|
||||
3. `UNSUPPORTED`: return clearly as unsupported for that exchange.
|
||||
4. `EXCHANGE_ERROR`: return details and retry only if user requests.
|
||||
5. `TIMEOUT`: optionally retry with larger `--timeout` once.
|
||||
|
||||
## Symbol and Exchange-Specific Behavior
|
||||
|
||||
- Never apply cross-exchange symbol mapping inside the skill.
|
||||
- Respect user-provided symbols exactly (examples: `BTCUSDT`, `BTCUSDC`, `BTC_USD_PERP`, `BTC-PERP`).
|
||||
- If no `--symbol` is provided, let existing exchange config resolve it.
|
||||
- If no `--exchange` is provided, let existing env resolution decide it.
|
||||
|
||||
## Ready-to-Use Recipes
|
||||
|
||||
### Preflight
|
||||
|
||||
```bash
|
||||
ritmex-bot exchange list --json
|
||||
ritmex-bot exchange capabilities --exchange <id> --json
|
||||
ritmex-bot doctor --exchange <id> --symbol <symbol> --json
|
||||
```
|
||||
|
||||
### Read-only market/account state
|
||||
|
||||
```bash
|
||||
ritmex-bot market ticker --exchange <id> --symbol <symbol> --json
|
||||
ritmex-bot market depth --exchange <id> --symbol <symbol> --levels 20 --json
|
||||
ritmex-bot market kline --exchange <id> --symbol <symbol> --interval 1m --limit 120 --json
|
||||
ritmex-bot account snapshot --exchange <id> --json
|
||||
ritmex-bot position list --exchange <id> --symbol <symbol> --json
|
||||
```
|
||||
|
||||
### Write flow (safe)
|
||||
|
||||
```bash
|
||||
ritmex-bot order create --exchange <id> --symbol <symbol> --side buy --type market --qty 0.01 --dry-run --json
|
||||
ritmex-bot order create --exchange <id> --symbol <symbol> --side buy --type market --qty 0.01 --json
|
||||
ritmex-bot order open --exchange <id> --symbol <symbol> --json
|
||||
```
|
||||
|
||||
### Strategy flow
|
||||
|
||||
```bash
|
||||
ritmex-bot strategy run --strategy trend --exchange <id> --dry-run
|
||||
ritmex-bot strategy run --strategy trend --exchange <id> --silent
|
||||
```
|
||||
|
||||
## Completion Checklist
|
||||
|
||||
Before returning results to user:
|
||||
|
||||
1. Confirm command and parameters used.
|
||||
2. Confirm whether run was `dryRun` or live.
|
||||
3. For live writes, provide immediate post-check output (`order open` / `position list`).
|
||||
4. If unsupported, explicitly name exchange + unsupported method.
|
||||
5. If failed, return error code/message and next corrective action.
|
||||
+1
-6
@@ -101,10 +101,5 @@ export function printCliHelp(): void {
|
||||
` Aliases: liquidity, liquidity-maker for the liquidity maker engine.\n` +
|
||||
` --exchange, -e Choose exchange. Overrides EXCHANGE/TRADE_EXCHANGE environment variables.\n` +
|
||||
` --silent, -q Reduce console output. When used with --strategy, runs in silent daemon mode.\n` +
|
||||
` --help, -h Show this help message.\n\n` +
|
||||
`Command mode:\n` +
|
||||
` ritmex-bot doctor\n` +
|
||||
` ritmex-bot exchange list\n` +
|
||||
` ritmex-bot market ticker --exchange <id> --symbol <symbol>\n` +
|
||||
` ritmex-bot order create --side buy --type limit --quantity 0.01 --price 100000 --dry-run\n`);
|
||||
` --help, -h Show this help message.\n`);
|
||||
}
|
||||
|
||||
@@ -1,670 +0,0 @@
|
||||
import { resolveSymbolFromEnv } from "../config";
|
||||
import { type ExchangeAdapter } from "../exchanges/adapter";
|
||||
import { DryRunExchangeAdapter } from "../exchanges/dry-run-adapter";
|
||||
import {
|
||||
SUPPORTED_EXCHANGE_IDS,
|
||||
getExchangeDisplayName,
|
||||
resolveExchangeId,
|
||||
type SupportedExchangeId,
|
||||
} from "../exchanges/create-adapter";
|
||||
import {
|
||||
routeCloseOrder,
|
||||
routeLimitOrder,
|
||||
routeMarketOrder,
|
||||
routeStopOrder,
|
||||
routeTrailingStopOrder,
|
||||
} from "../exchanges/order-router";
|
||||
import { buildAdapterFromEnv } from "../exchanges/resolve-from-env";
|
||||
import type { AsterDepth, AsterKline, AsterOrder, AsterTicker } from "../exchanges/types";
|
||||
import { startStrategy } from "./strategy-runner";
|
||||
import type {
|
||||
CommandErrorPayload,
|
||||
CommandExecutionResult,
|
||||
CommandFailurePayload,
|
||||
CommandPayload,
|
||||
CommandSuccessPayload,
|
||||
ParsedCliCommand,
|
||||
} from "./command-types";
|
||||
|
||||
const EXIT_CODE_SUCCESS = 0;
|
||||
const EXIT_CODE_INVALID_ARGS = 2;
|
||||
const EXIT_CODE_MISSING_ENV = 3;
|
||||
const EXIT_CODE_UNSUPPORTED = 5;
|
||||
const EXIT_CODE_EXCHANGE_ERROR = 6;
|
||||
const EXIT_CODE_TIMEOUT = 7;
|
||||
|
||||
const STATIC_CAPABILITIES: Record<
|
||||
SupportedExchangeId,
|
||||
{
|
||||
trailingStops: boolean | "conditional";
|
||||
fundingRate: boolean;
|
||||
precision: boolean;
|
||||
queryOpenOrders: boolean;
|
||||
queryAccountSnapshot: boolean;
|
||||
changeMarginMode: boolean;
|
||||
forceCancelAllOrders: boolean;
|
||||
}
|
||||
> = {
|
||||
aster: {
|
||||
trailingStops: true,
|
||||
fundingRate: false,
|
||||
precision: true,
|
||||
queryOpenOrders: false,
|
||||
queryAccountSnapshot: false,
|
||||
changeMarginMode: false,
|
||||
forceCancelAllOrders: false,
|
||||
},
|
||||
grvt: {
|
||||
trailingStops: false,
|
||||
fundingRate: false,
|
||||
precision: false,
|
||||
queryOpenOrders: false,
|
||||
queryAccountSnapshot: false,
|
||||
changeMarginMode: false,
|
||||
forceCancelAllOrders: false,
|
||||
},
|
||||
lighter: {
|
||||
trailingStops: false,
|
||||
fundingRate: false,
|
||||
precision: true,
|
||||
queryOpenOrders: false,
|
||||
queryAccountSnapshot: false,
|
||||
changeMarginMode: false,
|
||||
forceCancelAllOrders: false,
|
||||
},
|
||||
backpack: {
|
||||
trailingStops: false,
|
||||
fundingRate: false,
|
||||
precision: false,
|
||||
queryOpenOrders: false,
|
||||
queryAccountSnapshot: false,
|
||||
changeMarginMode: false,
|
||||
forceCancelAllOrders: false,
|
||||
},
|
||||
paradex: {
|
||||
trailingStops: false,
|
||||
fundingRate: false,
|
||||
precision: false,
|
||||
queryOpenOrders: false,
|
||||
queryAccountSnapshot: false,
|
||||
changeMarginMode: false,
|
||||
forceCancelAllOrders: false,
|
||||
},
|
||||
nado: {
|
||||
trailingStops: false,
|
||||
fundingRate: true,
|
||||
precision: true,
|
||||
queryOpenOrders: false,
|
||||
queryAccountSnapshot: false,
|
||||
changeMarginMode: false,
|
||||
forceCancelAllOrders: false,
|
||||
},
|
||||
standx: {
|
||||
trailingStops: false,
|
||||
fundingRate: true,
|
||||
precision: true,
|
||||
queryOpenOrders: true,
|
||||
queryAccountSnapshot: true,
|
||||
changeMarginMode: true,
|
||||
forceCancelAllOrders: true,
|
||||
},
|
||||
binance: {
|
||||
trailingStops: "conditional",
|
||||
fundingRate: true,
|
||||
precision: true,
|
||||
queryOpenOrders: true,
|
||||
queryAccountSnapshot: true,
|
||||
changeMarginMode: true,
|
||||
forceCancelAllOrders: true,
|
||||
},
|
||||
};
|
||||
|
||||
export interface CommandExecutorDependencies {
|
||||
buildAdapterFromEnvFn?: typeof buildAdapterFromEnv;
|
||||
startStrategyFn?: typeof startStrategy;
|
||||
now?: () => number;
|
||||
}
|
||||
|
||||
class CommandExecutionError extends Error {
|
||||
constructor(
|
||||
readonly code: CommandErrorPayload["code"],
|
||||
readonly exitCode: number,
|
||||
message: string,
|
||||
readonly retryable: boolean = false,
|
||||
readonly details?: unknown
|
||||
) {
|
||||
super(message);
|
||||
this.name = "CommandExecutionError";
|
||||
}
|
||||
}
|
||||
|
||||
export async function executeCliCommand(
|
||||
command: ParsedCliCommand,
|
||||
deps: CommandExecutorDependencies = {}
|
||||
): Promise<CommandExecutionResult> {
|
||||
const buildAdapterFromEnvFn = deps.buildAdapterFromEnvFn ?? buildAdapterFromEnv;
|
||||
const startStrategyFn = deps.startStrategyFn ?? startStrategy;
|
||||
const now = deps.now ?? (() => Date.now());
|
||||
|
||||
try {
|
||||
const data = await withExchangeOverride(command.exchange, async () => {
|
||||
switch (command.kind) {
|
||||
case "help":
|
||||
return { topic: command.topic ?? null };
|
||||
case "doctor":
|
||||
return handleDoctor(command, buildAdapterFromEnvFn);
|
||||
case "exchange-list":
|
||||
return {
|
||||
exchanges: SUPPORTED_EXCHANGE_IDS.map((id) => ({
|
||||
id,
|
||||
name: getExchangeDisplayName(id),
|
||||
})),
|
||||
};
|
||||
case "exchange-capabilities":
|
||||
return handleExchangeCapabilities(command, buildAdapterFromEnvFn);
|
||||
case "market-ticker":
|
||||
return handleMarketTicker(command, buildAdapterFromEnvFn);
|
||||
case "market-depth":
|
||||
return handleMarketDepth(command, buildAdapterFromEnvFn);
|
||||
case "market-kline":
|
||||
return handleMarketKline(command, buildAdapterFromEnvFn);
|
||||
case "account-snapshot":
|
||||
return handleAccountSnapshot(command, buildAdapterFromEnvFn);
|
||||
case "position-list":
|
||||
return handlePositionList(command, buildAdapterFromEnvFn);
|
||||
case "order-open":
|
||||
return handleOrderOpen(command, buildAdapterFromEnvFn);
|
||||
case "order-create":
|
||||
return handleOrderCreate(command, buildAdapterFromEnvFn);
|
||||
case "order-cancel":
|
||||
return handleOrderCancel(command, buildAdapterFromEnvFn);
|
||||
case "order-cancel-all":
|
||||
return handleOrderCancelAll(command, buildAdapterFromEnvFn);
|
||||
case "strategy-run":
|
||||
await startStrategyFn(command.strategy, { silent: command.silent, dryRun: command.dryRun });
|
||||
return {
|
||||
strategy: command.strategy,
|
||||
status: "stopped",
|
||||
};
|
||||
}
|
||||
});
|
||||
|
||||
const payload = successPayload(command, now(), data);
|
||||
return {
|
||||
exitCode: EXIT_CODE_SUCCESS,
|
||||
payload,
|
||||
forceExit: command.kind !== "strategy-run",
|
||||
};
|
||||
} catch (error) {
|
||||
const mapped = mapToCommandExecutionError(error);
|
||||
const payload = failurePayload(command, now(), mapped);
|
||||
return {
|
||||
exitCode: mapped.exitCode,
|
||||
payload,
|
||||
forceExit: true,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
export function renderCommandPayload(payload: CommandPayload, json: boolean): string {
|
||||
if (json) {
|
||||
return JSON.stringify(payload, null, 2);
|
||||
}
|
||||
if (payload.success) {
|
||||
return formatHumanSuccess(payload);
|
||||
}
|
||||
return formatHumanError(payload);
|
||||
}
|
||||
|
||||
async function handleDoctor(
|
||||
command: Extract<ParsedCliCommand, { kind: "doctor" }>,
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv
|
||||
): Promise<unknown> {
|
||||
const exchange = resolveEffectiveExchange(command.exchange);
|
||||
const symbol = resolveEffectiveSymbol(command.symbol, exchange);
|
||||
const adapter = createAdapter(buildAdapterFromEnvFn, exchange, symbol);
|
||||
return {
|
||||
exchange,
|
||||
exchangeName: getExchangeDisplayName(exchange),
|
||||
symbol,
|
||||
adapterId: adapter.id,
|
||||
capabilities: runtimeCapabilities(adapter),
|
||||
};
|
||||
}
|
||||
|
||||
async function handleExchangeCapabilities(
|
||||
command: Extract<ParsedCliCommand, { kind: "exchange-capabilities" }>,
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv
|
||||
): Promise<unknown> {
|
||||
const exchange = resolveEffectiveExchange(command.exchange);
|
||||
const symbol = resolveEffectiveSymbol(command.symbol, exchange);
|
||||
const staticCapabilities = STATIC_CAPABILITIES[exchange];
|
||||
|
||||
try {
|
||||
const adapter = createAdapter(buildAdapterFromEnvFn, exchange, symbol);
|
||||
return {
|
||||
exchange,
|
||||
exchangeName: getExchangeDisplayName(exchange),
|
||||
symbol,
|
||||
capabilities: runtimeCapabilities(adapter),
|
||||
source: "runtime",
|
||||
};
|
||||
} catch (error) {
|
||||
return {
|
||||
exchange,
|
||||
exchangeName: getExchangeDisplayName(exchange),
|
||||
symbol,
|
||||
capabilities: staticCapabilities,
|
||||
source: "static",
|
||||
warning: extractMessage(error),
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
async function handleMarketTicker(
|
||||
command: Extract<ParsedCliCommand, { kind: "market-ticker" }>,
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv
|
||||
): Promise<unknown> {
|
||||
const { adapter, exchange, symbol } = createAdapterContext(command, buildAdapterFromEnvFn);
|
||||
const ticker = await waitForFirst<AsterTicker>(
|
||||
(cb) => adapter.watchTicker(symbol, cb),
|
||||
command.timeoutMs,
|
||||
"market ticker"
|
||||
);
|
||||
return { exchange, symbol, ticker };
|
||||
}
|
||||
|
||||
async function handleMarketDepth(
|
||||
command: Extract<ParsedCliCommand, { kind: "market-depth" }>,
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv
|
||||
): Promise<unknown> {
|
||||
const { adapter, exchange, symbol } = createAdapterContext(command, buildAdapterFromEnvFn);
|
||||
const depth = await waitForFirst<AsterDepth>(
|
||||
(cb) => adapter.watchDepth(symbol, cb),
|
||||
command.timeoutMs,
|
||||
"market depth"
|
||||
);
|
||||
const levels = command.levels && command.levels > 0 ? Math.floor(command.levels) : undefined;
|
||||
const boundedDepth = levels
|
||||
? {
|
||||
...depth,
|
||||
bids: depth.bids.slice(0, levels),
|
||||
asks: depth.asks.slice(0, levels),
|
||||
}
|
||||
: depth;
|
||||
return { exchange, symbol, levels: levels ?? null, depth: boundedDepth };
|
||||
}
|
||||
|
||||
async function handleMarketKline(
|
||||
command: Extract<ParsedCliCommand, { kind: "market-kline" }>,
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv
|
||||
): Promise<unknown> {
|
||||
const { adapter, exchange, symbol } = createAdapterContext(command, buildAdapterFromEnvFn);
|
||||
const klines = await waitForFirst<AsterKline[]>(
|
||||
(cb) => adapter.watchKlines(symbol, command.interval, cb),
|
||||
command.timeoutMs,
|
||||
"market kline"
|
||||
);
|
||||
const limit = command.limit && command.limit > 0 ? Math.floor(command.limit) : undefined;
|
||||
const data = limit ? klines.slice(-limit) : klines;
|
||||
return { exchange, symbol, interval: command.interval, limit: limit ?? null, klines: data };
|
||||
}
|
||||
|
||||
async function handleAccountSnapshot(
|
||||
command: Extract<ParsedCliCommand, { kind: "account-snapshot" }>,
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv
|
||||
): Promise<unknown> {
|
||||
const { adapter, exchange, symbol } = createAdapterContext(command, buildAdapterFromEnvFn);
|
||||
if (!adapter.queryAccountSnapshot) {
|
||||
throw new CommandExecutionError(
|
||||
"UNSUPPORTED",
|
||||
EXIT_CODE_UNSUPPORTED,
|
||||
`queryAccountSnapshot is not supported on exchange '${exchange}'`
|
||||
);
|
||||
}
|
||||
const snapshot = await adapter.queryAccountSnapshot();
|
||||
return { exchange, symbol, snapshot };
|
||||
}
|
||||
|
||||
async function handlePositionList(
|
||||
command: Extract<ParsedCliCommand, { kind: "position-list" }>,
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv
|
||||
): Promise<unknown> {
|
||||
const { adapter, exchange, symbol } = createAdapterContext(command, buildAdapterFromEnvFn);
|
||||
if (!adapter.queryAccountSnapshot) {
|
||||
throw new CommandExecutionError(
|
||||
"UNSUPPORTED",
|
||||
EXIT_CODE_UNSUPPORTED,
|
||||
`queryAccountSnapshot is not supported on exchange '${exchange}'`
|
||||
);
|
||||
}
|
||||
const snapshot = await adapter.queryAccountSnapshot();
|
||||
const positions = snapshot?.positions ?? [];
|
||||
const filtered = symbol ? positions.filter((position) => position.symbol === symbol) : positions;
|
||||
return { exchange, symbol, positions: filtered };
|
||||
}
|
||||
|
||||
async function handleOrderOpen(
|
||||
command: Extract<ParsedCliCommand, { kind: "order-open" }>,
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv
|
||||
): Promise<unknown> {
|
||||
const { adapter, exchange, symbol } = createAdapterContext(command, buildAdapterFromEnvFn);
|
||||
if (!adapter.queryOpenOrders) {
|
||||
throw new CommandExecutionError(
|
||||
"UNSUPPORTED",
|
||||
EXIT_CODE_UNSUPPORTED,
|
||||
`queryOpenOrders is not supported on exchange '${exchange}'`
|
||||
);
|
||||
}
|
||||
const orders = await adapter.queryOpenOrders();
|
||||
const filtered = symbol ? orders.filter((order) => order.symbol === symbol) : orders;
|
||||
return { exchange, symbol, orders: filtered };
|
||||
}
|
||||
|
||||
async function handleOrderCreate(
|
||||
command: Extract<ParsedCliCommand, { kind: "order-create" }>,
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv
|
||||
): Promise<unknown> {
|
||||
const { adapter, exchange, symbol, dryRunAdapter } = createAdapterContext(command, buildAdapterFromEnvFn);
|
||||
const execAdapter = dryRunAdapter ?? adapter;
|
||||
const payload = command.payload;
|
||||
|
||||
const baseIntent = {
|
||||
adapter: execAdapter,
|
||||
symbol,
|
||||
side: payload.side,
|
||||
quantity: payload.quantity,
|
||||
reduceOnly: payload.reduceOnly,
|
||||
closePosition: payload.closePosition,
|
||||
timeInForce: payload.timeInForce,
|
||||
};
|
||||
|
||||
let order: AsterOrder;
|
||||
switch (payload.type) {
|
||||
case "limit":
|
||||
order = await routeLimitOrder({
|
||||
...baseIntent,
|
||||
price: payload.price!,
|
||||
slPrice: payload.slPrice,
|
||||
tpPrice: payload.tpPrice,
|
||||
});
|
||||
break;
|
||||
case "market":
|
||||
order = await routeMarketOrder(baseIntent);
|
||||
break;
|
||||
case "stop":
|
||||
order = await routeStopOrder({
|
||||
...baseIntent,
|
||||
stopPrice: payload.stopPrice!,
|
||||
triggerType: payload.triggerType,
|
||||
});
|
||||
break;
|
||||
case "trailing-stop":
|
||||
order = await routeTrailingStopOrder({
|
||||
...baseIntent,
|
||||
activationPrice: payload.activationPrice!,
|
||||
callbackRate: payload.callbackRate!,
|
||||
});
|
||||
break;
|
||||
case "close":
|
||||
order = await routeCloseOrder({
|
||||
...baseIntent,
|
||||
reduceOnly: payload.reduceOnly ?? true,
|
||||
closePosition: payload.closePosition ?? true,
|
||||
});
|
||||
break;
|
||||
default:
|
||||
throw new CommandExecutionError("INVALID_ARGS", EXIT_CODE_INVALID_ARGS, "Unsupported order type");
|
||||
}
|
||||
|
||||
return {
|
||||
exchange,
|
||||
symbol,
|
||||
payload,
|
||||
order,
|
||||
dryRunActions: dryRunAdapter?.actions ?? [],
|
||||
};
|
||||
}
|
||||
|
||||
async function handleOrderCancel(
|
||||
command: Extract<ParsedCliCommand, { kind: "order-cancel" }>,
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv
|
||||
): Promise<unknown> {
|
||||
const { adapter, exchange, symbol, dryRunAdapter } = createAdapterContext(command, buildAdapterFromEnvFn);
|
||||
const execAdapter = dryRunAdapter ?? adapter;
|
||||
await execAdapter.cancelOrder({ symbol, orderId: command.orderId });
|
||||
return {
|
||||
exchange,
|
||||
symbol,
|
||||
orderId: command.orderId,
|
||||
dryRunActions: dryRunAdapter?.actions ?? [],
|
||||
};
|
||||
}
|
||||
|
||||
async function handleOrderCancelAll(
|
||||
command: Extract<ParsedCliCommand, { kind: "order-cancel-all" }>,
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv
|
||||
): Promise<unknown> {
|
||||
const { adapter, exchange, symbol, dryRunAdapter } = createAdapterContext(command, buildAdapterFromEnvFn);
|
||||
const execAdapter = dryRunAdapter ?? adapter;
|
||||
let forced = false;
|
||||
let forceResult: boolean | null = null;
|
||||
|
||||
if (execAdapter.forceCancelAllOrders) {
|
||||
forced = true;
|
||||
forceResult = await execAdapter.forceCancelAllOrders();
|
||||
} else {
|
||||
await execAdapter.cancelAllOrders({ symbol });
|
||||
}
|
||||
|
||||
return {
|
||||
exchange,
|
||||
symbol,
|
||||
forced,
|
||||
forceResult,
|
||||
dryRunActions: dryRunAdapter?.actions ?? [],
|
||||
};
|
||||
}
|
||||
|
||||
function createAdapterContext(
|
||||
command: Extract<ParsedCliCommand, { kind: Exclude<ParsedCliCommand["kind"], "help" | "exchange-list"> }>,
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv
|
||||
): {
|
||||
exchange: SupportedExchangeId;
|
||||
symbol: string;
|
||||
adapter: ExchangeAdapter;
|
||||
dryRunAdapter?: DryRunExchangeAdapter;
|
||||
} {
|
||||
const exchange = resolveEffectiveExchange(command.exchange);
|
||||
const symbol = resolveEffectiveSymbol(command.symbol, exchange);
|
||||
const adapter = createAdapter(buildAdapterFromEnvFn, exchange, symbol);
|
||||
if (!command.dryRun) {
|
||||
return { exchange, symbol, adapter };
|
||||
}
|
||||
const dryRunAdapter = new DryRunExchangeAdapter(adapter);
|
||||
return { exchange, symbol, adapter, dryRunAdapter };
|
||||
}
|
||||
|
||||
function createAdapter(
|
||||
buildAdapterFromEnvFn: typeof buildAdapterFromEnv,
|
||||
exchange: SupportedExchangeId,
|
||||
symbol: string
|
||||
): ExchangeAdapter {
|
||||
return buildAdapterFromEnvFn({
|
||||
exchangeId: exchange,
|
||||
symbol,
|
||||
});
|
||||
}
|
||||
|
||||
function resolveEffectiveExchange(explicit?: SupportedExchangeId): SupportedExchangeId {
|
||||
if (explicit) return explicit;
|
||||
return resolveExchangeId();
|
||||
}
|
||||
|
||||
function resolveEffectiveSymbol(explicit: string | undefined, exchange: SupportedExchangeId): string {
|
||||
if (explicit && explicit.trim()) {
|
||||
return explicit.trim();
|
||||
}
|
||||
return resolveSymbolFromEnv(exchange);
|
||||
}
|
||||
|
||||
function runtimeCapabilities(adapter: ExchangeAdapter): unknown {
|
||||
return {
|
||||
trailingStops: adapter.supportsTrailingStops(),
|
||||
fundingRate: typeof adapter.watchFundingRate === "function",
|
||||
precision: typeof adapter.getPrecision === "function",
|
||||
queryOpenOrders: typeof adapter.queryOpenOrders === "function",
|
||||
queryAccountSnapshot: typeof adapter.queryAccountSnapshot === "function",
|
||||
changeMarginMode: typeof adapter.changeMarginMode === "function",
|
||||
forceCancelAllOrders: typeof adapter.forceCancelAllOrders === "function",
|
||||
};
|
||||
}
|
||||
|
||||
function successPayload(command: ParsedCliCommand, nowMs: number, data: unknown): CommandSuccessPayload {
|
||||
return {
|
||||
success: true,
|
||||
command: command.kind,
|
||||
exchange: command.exchange,
|
||||
symbol: command.symbol,
|
||||
dryRun: command.dryRun,
|
||||
ts: new Date(nowMs).toISOString(),
|
||||
data,
|
||||
};
|
||||
}
|
||||
|
||||
function failurePayload(
|
||||
command: ParsedCliCommand,
|
||||
nowMs: number,
|
||||
error: CommandExecutionError
|
||||
): CommandFailurePayload {
|
||||
return {
|
||||
success: false,
|
||||
command: command.kind,
|
||||
exchange: command.exchange,
|
||||
symbol: command.symbol,
|
||||
dryRun: command.dryRun,
|
||||
ts: new Date(nowMs).toISOString(),
|
||||
error: {
|
||||
code: error.code,
|
||||
message: error.message,
|
||||
retryable: error.retryable,
|
||||
details: error.details,
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
function mapToCommandExecutionError(error: unknown): CommandExecutionError {
|
||||
if (error instanceof CommandExecutionError) {
|
||||
return error;
|
||||
}
|
||||
const message = extractMessage(error);
|
||||
const lower = message.toLowerCase();
|
||||
|
||||
if (lower.includes("timeout")) {
|
||||
return new CommandExecutionError("TIMEOUT", EXIT_CODE_TIMEOUT, message, true);
|
||||
}
|
||||
if (lower.includes("unsupported") || lower.includes("not supported")) {
|
||||
return new CommandExecutionError("UNSUPPORTED", EXIT_CODE_UNSUPPORTED, message);
|
||||
}
|
||||
if (lower.includes("missing") && lower.includes("environment")) {
|
||||
return new CommandExecutionError("MISSING_ENV", EXIT_CODE_MISSING_ENV, message);
|
||||
}
|
||||
if (lower.includes("missing ") || lower.includes("required option")) {
|
||||
return new CommandExecutionError("INVALID_ARGS", EXIT_CODE_INVALID_ARGS, message);
|
||||
}
|
||||
return new CommandExecutionError("EXCHANGE_ERROR", EXIT_CODE_EXCHANGE_ERROR, message, true);
|
||||
}
|
||||
|
||||
function formatHumanSuccess(payload: CommandSuccessPayload): string {
|
||||
const lines = [
|
||||
`[OK] ${payload.command}`,
|
||||
`time: ${payload.ts}`,
|
||||
payload.exchange ? `exchange: ${payload.exchange}` : null,
|
||||
payload.symbol ? `symbol: ${payload.symbol}` : null,
|
||||
`dryRun: ${payload.dryRun ? "true" : "false"}`,
|
||||
"",
|
||||
safeJsonStringify(payload.data),
|
||||
].filter(Boolean) as string[];
|
||||
return lines.join("\n");
|
||||
}
|
||||
|
||||
function formatHumanError(payload: CommandFailurePayload): string {
|
||||
return [
|
||||
`[ERROR] ${payload.command}`,
|
||||
`time: ${payload.ts}`,
|
||||
`code: ${payload.error.code}`,
|
||||
`message: ${payload.error.message}`,
|
||||
payload.error.retryable != null ? `retryable: ${payload.error.retryable ? "true" : "false"}` : null,
|
||||
]
|
||||
.filter(Boolean)
|
||||
.join("\n");
|
||||
}
|
||||
|
||||
function safeJsonStringify(value: unknown): string {
|
||||
try {
|
||||
return JSON.stringify(value, null, 2);
|
||||
} catch {
|
||||
return String(value);
|
||||
}
|
||||
}
|
||||
|
||||
async function waitForFirst<T>(
|
||||
subscribe: (cb: (value: T) => void) => void,
|
||||
timeoutMs: number,
|
||||
context: string
|
||||
): Promise<T> {
|
||||
return new Promise<T>((resolve, reject) => {
|
||||
const timeout = setTimeout(() => {
|
||||
reject(
|
||||
new CommandExecutionError(
|
||||
"TIMEOUT",
|
||||
EXIT_CODE_TIMEOUT,
|
||||
`${context} timed out after ${timeoutMs}ms`,
|
||||
true
|
||||
)
|
||||
);
|
||||
}, timeoutMs);
|
||||
|
||||
try {
|
||||
subscribe((value) => {
|
||||
clearTimeout(timeout);
|
||||
resolve(value);
|
||||
});
|
||||
} catch (error) {
|
||||
clearTimeout(timeout);
|
||||
reject(error);
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
async function withExchangeOverride<T>(
|
||||
explicitExchange: SupportedExchangeId | undefined,
|
||||
task: () => Promise<T>
|
||||
): Promise<T> {
|
||||
if (!explicitExchange) {
|
||||
return task();
|
||||
}
|
||||
const prevExchange = process.env.EXCHANGE;
|
||||
const prevTradeExchange = process.env.TRADE_EXCHANGE;
|
||||
process.env.EXCHANGE = explicitExchange;
|
||||
process.env.TRADE_EXCHANGE = explicitExchange;
|
||||
try {
|
||||
return await task();
|
||||
} finally {
|
||||
if (prevExchange == null) {
|
||||
delete process.env.EXCHANGE;
|
||||
} else {
|
||||
process.env.EXCHANGE = prevExchange;
|
||||
}
|
||||
if (prevTradeExchange == null) {
|
||||
delete process.env.TRADE_EXCHANGE;
|
||||
} else {
|
||||
process.env.TRADE_EXCHANGE = prevTradeExchange;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function extractMessage(error: unknown): string {
|
||||
if (error instanceof Error) return error.message;
|
||||
return String(error);
|
||||
}
|
||||
@@ -1,527 +0,0 @@
|
||||
import { isSupportedExchangeId, type SupportedExchangeId } from "../exchanges/create-adapter";
|
||||
import type { StrategyId } from "./args";
|
||||
import type { CommandCommonOptions, OrderCreatePayload, OrderCreateType, ParsedCliCommand } from "./command-types";
|
||||
|
||||
const DEFAULT_TIMEOUT_MS = 25_000;
|
||||
const ROOT_COMMANDS = new Set([
|
||||
"help",
|
||||
"doctor",
|
||||
"exchange",
|
||||
"market",
|
||||
"account",
|
||||
"position",
|
||||
"order",
|
||||
"strategy",
|
||||
]);
|
||||
|
||||
const GLOBAL_OPTION_NAMES = new Set([
|
||||
"exchange",
|
||||
"symbol",
|
||||
"json",
|
||||
"dry-run",
|
||||
"timeout",
|
||||
"help",
|
||||
]);
|
||||
|
||||
const SHORT_OPTION_ALIAS: Record<string, string> = {
|
||||
d: "dry-run",
|
||||
e: "exchange",
|
||||
h: "help",
|
||||
j: "json",
|
||||
q: "silent",
|
||||
s: "strategy",
|
||||
t: "timeout",
|
||||
};
|
||||
|
||||
const STRATEGY_VALUES = new Set<StrategyId>([
|
||||
"trend",
|
||||
"swing",
|
||||
"guardian",
|
||||
"maker",
|
||||
"maker-points",
|
||||
"offset-maker",
|
||||
"liquidity-maker",
|
||||
"basis",
|
||||
"grid",
|
||||
]);
|
||||
|
||||
export class CommandParseError extends Error {
|
||||
constructor(message: string) {
|
||||
super(message);
|
||||
this.name = "CommandParseError";
|
||||
}
|
||||
}
|
||||
|
||||
interface ParsedOptionBag {
|
||||
options: Record<string, string | boolean>;
|
||||
positionals: string[];
|
||||
}
|
||||
|
||||
export function parseCommandArgv(argv: string[]): ParsedCliCommand | null {
|
||||
if (!argv.length) return null;
|
||||
const root = (argv[0] ?? "").trim().toLowerCase();
|
||||
if (!root || root.startsWith("-")) return null;
|
||||
if (!ROOT_COMMANDS.has(root)) return null;
|
||||
|
||||
if (root === "help") {
|
||||
return parseHelpCommand(argv.slice(1));
|
||||
}
|
||||
if (root === "doctor") {
|
||||
const bag = parseOptionBag(argv.slice(1));
|
||||
assertAllowedOptions(bag.options, GLOBAL_OPTION_NAMES);
|
||||
const common = parseCommonOptions(bag.options);
|
||||
return { kind: "doctor", ...common };
|
||||
}
|
||||
|
||||
if (argv.length < 2) {
|
||||
throw new CommandParseError(`Missing action for command '${root}'`);
|
||||
}
|
||||
const action = (argv[1] ?? "").trim().toLowerCase();
|
||||
const bag = parseOptionBag(argv.slice(2));
|
||||
const common = parseCommonOptions(bag.options);
|
||||
|
||||
if (common.help) {
|
||||
return {
|
||||
kind: "help",
|
||||
topic: `${root} ${action}`.trim(),
|
||||
...common,
|
||||
};
|
||||
}
|
||||
|
||||
switch (root) {
|
||||
case "exchange":
|
||||
return parseExchangeCommand(action, bag.options, common);
|
||||
case "market":
|
||||
return parseMarketCommand(action, bag.options, common);
|
||||
case "account":
|
||||
return parseAccountCommand(action, bag.options, common);
|
||||
case "position":
|
||||
return parsePositionCommand(action, bag.options, common);
|
||||
case "order":
|
||||
return parseOrderCommand(action, bag.options, common);
|
||||
case "strategy":
|
||||
return parseStrategyCommand(action, bag, common);
|
||||
default:
|
||||
throw new CommandParseError(`Unsupported root command '${root}'`);
|
||||
}
|
||||
}
|
||||
|
||||
export function printCommandHelp(topic?: string): void {
|
||||
if (!topic) {
|
||||
// eslint-disable-next-line no-console
|
||||
console.log([
|
||||
"ritmex-bot command mode:",
|
||||
" ritmex-bot doctor",
|
||||
" ritmex-bot exchange list",
|
||||
" ritmex-bot exchange capabilities [--exchange <id>]",
|
||||
" ritmex-bot market ticker [--exchange <id>] [--symbol <symbol>]",
|
||||
" ritmex-bot market depth [--exchange <id>] [--symbol <symbol>] [--levels <n>]",
|
||||
" ritmex-bot market kline --interval <interval> [--limit <n>] [--exchange <id>] [--symbol <symbol>]",
|
||||
" ritmex-bot account snapshot [--exchange <id>]",
|
||||
" ritmex-bot position list [--exchange <id>] [--symbol <symbol>]",
|
||||
" ritmex-bot order open [--exchange <id>] [--symbol <symbol>]",
|
||||
" ritmex-bot order create --side <buy|sell> --type <limit|market|stop|trailing-stop|close> --quantity <n> [options]",
|
||||
" ritmex-bot order cancel --order-id <id> [--exchange <id>] [--symbol <symbol>]",
|
||||
" ritmex-bot order cancel-all [--exchange <id>] [--symbol <symbol>]",
|
||||
" ritmex-bot strategy run --strategy <id> [--exchange <id>] [--silent] [--dry-run]",
|
||||
"",
|
||||
"Global options:",
|
||||
" --exchange, -e Exchange id",
|
||||
" --symbol Trading symbol (passed through without normalization)",
|
||||
" --json, -j JSON output",
|
||||
" --dry-run, -d Simulate write operations",
|
||||
" --timeout, -t Timeout in milliseconds (default 25000)",
|
||||
" --help, -h Show command help",
|
||||
"",
|
||||
"Legacy mode remains available: bun run index.ts [--strategy ...] [--exchange ...]",
|
||||
].join("\n"));
|
||||
return;
|
||||
}
|
||||
|
||||
// eslint-disable-next-line no-console
|
||||
console.log(`ritmex-bot help: ${topic}`);
|
||||
}
|
||||
|
||||
function parseHelpCommand(argv: string[]): ParsedCliCommand {
|
||||
const bag = parseOptionBag(argv);
|
||||
assertAllowedOptions(bag.options, GLOBAL_OPTION_NAMES);
|
||||
const common = parseCommonOptions(bag.options);
|
||||
const topic = bag.positionals.length > 0 ? bag.positionals.join(" ") : undefined;
|
||||
return { kind: "help", topic, ...common };
|
||||
}
|
||||
|
||||
function parseExchangeCommand(
|
||||
action: string,
|
||||
options: Record<string, string | boolean>,
|
||||
common: CommandCommonOptions & { help?: boolean }
|
||||
): ParsedCliCommand {
|
||||
assertAllowedOptions(options, new Set(GLOBAL_OPTION_NAMES));
|
||||
if (action === "list") return { kind: "exchange-list", ...common };
|
||||
if (action === "capabilities") return { kind: "exchange-capabilities", ...common };
|
||||
throw new CommandParseError(`Unsupported exchange action '${action}'`);
|
||||
}
|
||||
|
||||
function parseMarketCommand(
|
||||
action: string,
|
||||
options: Record<string, string | boolean>,
|
||||
common: CommandCommonOptions & { help?: boolean }
|
||||
): ParsedCliCommand {
|
||||
assertAllowedOptions(options, new Set([...GLOBAL_OPTION_NAMES, "levels", "interval", "limit"]));
|
||||
if (action === "ticker") return { kind: "market-ticker", ...common };
|
||||
if (action === "depth") {
|
||||
const levels = readNumberOption(options, ["levels"]);
|
||||
return { kind: "market-depth", levels, ...common };
|
||||
}
|
||||
if (action === "kline") {
|
||||
const interval = requireStringOption(options, ["interval"], "Missing required option --interval");
|
||||
const limit = readNumberOption(options, ["limit"]);
|
||||
return { kind: "market-kline", interval, limit, ...common };
|
||||
}
|
||||
throw new CommandParseError(`Unsupported market action '${action}'`);
|
||||
}
|
||||
|
||||
function parseAccountCommand(
|
||||
action: string,
|
||||
options: Record<string, string | boolean>,
|
||||
common: CommandCommonOptions & { help?: boolean }
|
||||
): ParsedCliCommand {
|
||||
assertAllowedOptions(options, GLOBAL_OPTION_NAMES);
|
||||
if (action === "snapshot" || action === "summary") {
|
||||
return { kind: "account-snapshot", ...common };
|
||||
}
|
||||
throw new CommandParseError(`Unsupported account action '${action}'`);
|
||||
}
|
||||
|
||||
function parsePositionCommand(
|
||||
action: string,
|
||||
options: Record<string, string | boolean>,
|
||||
common: CommandCommonOptions & { help?: boolean }
|
||||
): ParsedCliCommand {
|
||||
assertAllowedOptions(options, GLOBAL_OPTION_NAMES);
|
||||
if (action === "list") {
|
||||
return { kind: "position-list", ...common };
|
||||
}
|
||||
throw new CommandParseError(`Unsupported position action '${action}'`);
|
||||
}
|
||||
|
||||
function parseOrderCommand(
|
||||
action: string,
|
||||
options: Record<string, string | boolean>,
|
||||
common: CommandCommonOptions & { help?: boolean }
|
||||
): ParsedCliCommand {
|
||||
if (action === "open") {
|
||||
assertAllowedOptions(options, GLOBAL_OPTION_NAMES);
|
||||
return { kind: "order-open", ...common };
|
||||
}
|
||||
if (action === "cancel") {
|
||||
assertAllowedOptions(options, new Set([...GLOBAL_OPTION_NAMES, "order-id"]));
|
||||
const orderId = requireStringOption(options, ["order-id"], "Missing required option --order-id");
|
||||
return { kind: "order-cancel", orderId, ...common };
|
||||
}
|
||||
if (action === "cancel-all") {
|
||||
assertAllowedOptions(options, GLOBAL_OPTION_NAMES);
|
||||
return { kind: "order-cancel-all", ...common };
|
||||
}
|
||||
if (action === "create") {
|
||||
assertAllowedOptions(
|
||||
options,
|
||||
new Set([
|
||||
...GLOBAL_OPTION_NAMES,
|
||||
"side",
|
||||
"type",
|
||||
"quantity",
|
||||
"qty",
|
||||
"price",
|
||||
"stop-price",
|
||||
"activation-price",
|
||||
"callback-rate",
|
||||
"time-in-force",
|
||||
"reduce-only",
|
||||
"close-position",
|
||||
"trigger-type",
|
||||
"sl-price",
|
||||
"tp-price",
|
||||
])
|
||||
);
|
||||
|
||||
const payload = parseOrderCreatePayload(options);
|
||||
return { kind: "order-create", payload, ...common };
|
||||
}
|
||||
throw new CommandParseError(`Unsupported order action '${action}'`);
|
||||
}
|
||||
|
||||
function parseStrategyCommand(
|
||||
action: string,
|
||||
bag: ParsedOptionBag,
|
||||
common: CommandCommonOptions & { help?: boolean }
|
||||
): ParsedCliCommand {
|
||||
if (action !== "run") {
|
||||
throw new CommandParseError(`Unsupported strategy action '${action}'`);
|
||||
}
|
||||
assertAllowedOptions(bag.options, new Set([...GLOBAL_OPTION_NAMES, "strategy", "silent"]));
|
||||
const strategyInput = readStringOption(bag.options, ["strategy"]) ?? bag.positionals[0];
|
||||
if (!strategyInput) {
|
||||
throw new CommandParseError("Missing required option --strategy for strategy run");
|
||||
}
|
||||
const strategy = normalizeStrategy(strategyInput);
|
||||
const silent = readBooleanOption(bag.options, ["silent"], false);
|
||||
return { kind: "strategy-run", strategy, silent, ...common };
|
||||
}
|
||||
|
||||
function parseOrderCreatePayload(options: Record<string, string | boolean>): OrderCreatePayload {
|
||||
const side = normalizeSide(requireStringOption(options, ["side"], "Missing required option --side"));
|
||||
const type = normalizeOrderType(requireStringOption(options, ["type"], "Missing required option --type"));
|
||||
const quantity = requireNumberOption(options, ["quantity", "qty"], "Missing required option --quantity/--qty");
|
||||
const payload: OrderCreatePayload = { side, type, quantity };
|
||||
|
||||
if (type === "limit") {
|
||||
payload.price = requireNumberOption(options, ["price"], "Missing required option --price for limit orders");
|
||||
}
|
||||
if (type === "stop") {
|
||||
payload.stopPrice = requireNumberOption(options, ["stop-price"], "Missing required option --stop-price for stop orders");
|
||||
}
|
||||
if (type === "trailing-stop") {
|
||||
payload.activationPrice = requireNumberOption(
|
||||
options,
|
||||
["activation-price"],
|
||||
"Missing required option --activation-price for trailing-stop orders"
|
||||
);
|
||||
payload.callbackRate = requireNumberOption(
|
||||
options,
|
||||
["callback-rate"],
|
||||
"Missing required option --callback-rate for trailing-stop orders"
|
||||
);
|
||||
}
|
||||
|
||||
payload.timeInForce = normalizeTimeInForce(readStringOption(options, ["time-in-force"]));
|
||||
payload.reduceOnly = readOptionalBooleanOption(options, ["reduce-only"]);
|
||||
payload.closePosition = readOptionalBooleanOption(options, ["close-position"]);
|
||||
payload.triggerType = normalizeTriggerType(readStringOption(options, ["trigger-type"]));
|
||||
payload.slPrice = readNumberOption(options, ["sl-price"]);
|
||||
payload.tpPrice = readNumberOption(options, ["tp-price"]);
|
||||
payload.price = payload.price ?? readNumberOption(options, ["price"]);
|
||||
payload.stopPrice = payload.stopPrice ?? readNumberOption(options, ["stop-price"]);
|
||||
payload.activationPrice = payload.activationPrice ?? readNumberOption(options, ["activation-price"]);
|
||||
payload.callbackRate = payload.callbackRate ?? readNumberOption(options, ["callback-rate"]);
|
||||
return payload;
|
||||
}
|
||||
|
||||
function parseCommonOptions(options: Record<string, string | boolean>): CommandCommonOptions & { help?: boolean } {
|
||||
const exchangeRaw = readStringOption(options, ["exchange"]);
|
||||
const symbol = readStringOption(options, ["symbol"]);
|
||||
const json = readBooleanOption(options, ["json"], false);
|
||||
const dryRun = readBooleanOption(options, ["dry-run"], false);
|
||||
const timeoutMs = readNumberOption(options, ["timeout"]) ?? DEFAULT_TIMEOUT_MS;
|
||||
const help = readBooleanOption(options, ["help"], false);
|
||||
return {
|
||||
exchange: normalizeExchange(exchangeRaw),
|
||||
symbol: symbol?.trim() || undefined,
|
||||
json,
|
||||
dryRun,
|
||||
timeoutMs,
|
||||
help,
|
||||
};
|
||||
}
|
||||
|
||||
function parseOptionBag(args: string[]): ParsedOptionBag {
|
||||
const options: Record<string, string | boolean> = {};
|
||||
const positionals: string[] = [];
|
||||
|
||||
for (let i = 0; i < args.length; i += 1) {
|
||||
const token = args[i];
|
||||
if (!token) continue;
|
||||
if (token === "--") {
|
||||
positionals.push(...args.slice(i + 1));
|
||||
break;
|
||||
}
|
||||
if (token.startsWith("--")) {
|
||||
const withoutPrefix = token.slice(2);
|
||||
if (!withoutPrefix) throw new CommandParseError("Invalid option '--'");
|
||||
const eqIndex = withoutPrefix.indexOf("=");
|
||||
const rawKey = eqIndex === -1 ? withoutPrefix : withoutPrefix.slice(0, eqIndex);
|
||||
const key = rawKey.trim().toLowerCase();
|
||||
if (!key) throw new CommandParseError(`Invalid option '${token}'`);
|
||||
if (eqIndex !== -1) {
|
||||
options[key] = withoutPrefix.slice(eqIndex + 1);
|
||||
continue;
|
||||
}
|
||||
const next = args[i + 1];
|
||||
if (next && !next.startsWith("-")) {
|
||||
options[key] = next;
|
||||
i += 1;
|
||||
} else {
|
||||
options[key] = true;
|
||||
}
|
||||
continue;
|
||||
}
|
||||
if (token.startsWith("-")) {
|
||||
const short = token.slice(1);
|
||||
if (short.length !== 1) {
|
||||
throw new CommandParseError(`Unsupported short option '${token}'`);
|
||||
}
|
||||
const alias = SHORT_OPTION_ALIAS[short];
|
||||
if (!alias) {
|
||||
throw new CommandParseError(`Unsupported short option '${token}'`);
|
||||
}
|
||||
const next = args[i + 1];
|
||||
if (next && !next.startsWith("-") && expectsValue(alias)) {
|
||||
options[alias] = next;
|
||||
i += 1;
|
||||
} else {
|
||||
options[alias] = true;
|
||||
}
|
||||
continue;
|
||||
}
|
||||
positionals.push(token);
|
||||
}
|
||||
|
||||
return { options, positionals };
|
||||
}
|
||||
|
||||
function expectsValue(optionName: string): boolean {
|
||||
return optionName === "exchange" || optionName === "strategy" || optionName === "timeout";
|
||||
}
|
||||
|
||||
function assertAllowedOptions(
|
||||
options: Record<string, string | boolean>,
|
||||
allowed: ReadonlySet<string>
|
||||
): void {
|
||||
for (const key of Object.keys(options)) {
|
||||
if (!allowed.has(key)) {
|
||||
throw new CommandParseError(`Unsupported option '--${key}'`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function readStringOption(options: Record<string, string | boolean>, names: string[]): string | undefined {
|
||||
for (const name of names) {
|
||||
const raw = options[name];
|
||||
if (raw == null) continue;
|
||||
if (typeof raw !== "string") {
|
||||
throw new CommandParseError(`Option --${name} requires a value`);
|
||||
}
|
||||
const trimmed = raw.trim();
|
||||
if (!trimmed) {
|
||||
throw new CommandParseError(`Option --${name} cannot be empty`);
|
||||
}
|
||||
return trimmed;
|
||||
}
|
||||
return undefined;
|
||||
}
|
||||
|
||||
function requireStringOption(
|
||||
options: Record<string, string | boolean>,
|
||||
names: string[],
|
||||
errorMessage: string
|
||||
): string {
|
||||
const value = readStringOption(options, names);
|
||||
if (!value) {
|
||||
throw new CommandParseError(errorMessage);
|
||||
}
|
||||
return value;
|
||||
}
|
||||
|
||||
function readBooleanOption(options: Record<string, string | boolean>, names: string[], fallback: boolean): boolean {
|
||||
const value = readOptionalBooleanOption(options, names);
|
||||
return value == null ? fallback : value;
|
||||
}
|
||||
|
||||
function readOptionalBooleanOption(options: Record<string, string | boolean>, names: string[]): boolean | undefined {
|
||||
for (const name of names) {
|
||||
const raw = options[name];
|
||||
if (raw == null) continue;
|
||||
if (raw === true) return true;
|
||||
if (typeof raw !== "string") {
|
||||
throw new CommandParseError(`Option --${name} expects a boolean value`);
|
||||
}
|
||||
const normalized = raw.trim().toLowerCase();
|
||||
if (!normalized) return true;
|
||||
if (normalized === "1" || normalized === "true" || normalized === "yes" || normalized === "on") return true;
|
||||
if (normalized === "0" || normalized === "false" || normalized === "no" || normalized === "off") return false;
|
||||
throw new CommandParseError(`Option --${name} expects a boolean value`);
|
||||
}
|
||||
return undefined;
|
||||
}
|
||||
|
||||
function readNumberOption(options: Record<string, string | boolean>, names: string[]): number | undefined {
|
||||
const value = readStringOption(options, names);
|
||||
if (!value) return undefined;
|
||||
const number = Number(value);
|
||||
if (!Number.isFinite(number)) {
|
||||
throw new CommandParseError(`Option --${names[0]} expects a numeric value`);
|
||||
}
|
||||
return number;
|
||||
}
|
||||
|
||||
function requireNumberOption(
|
||||
options: Record<string, string | boolean>,
|
||||
names: string[],
|
||||
errorMessage: string
|
||||
): number {
|
||||
const number = readNumberOption(options, names);
|
||||
if (number == null) {
|
||||
throw new CommandParseError(errorMessage);
|
||||
}
|
||||
return number;
|
||||
}
|
||||
|
||||
function normalizeExchange(value: string | undefined): SupportedExchangeId | undefined {
|
||||
if (!value) return undefined;
|
||||
const normalized = value.trim().toLowerCase();
|
||||
if (normalized === "gravity" || normalized === "grav" || normalized === "grv") return "grvt";
|
||||
if (normalized === "bnb") return "binance";
|
||||
if (isSupportedExchangeId(normalized)) return normalized;
|
||||
throw new CommandParseError(`Unsupported exchange '${value}'`);
|
||||
}
|
||||
|
||||
function normalizeStrategy(value: string): StrategyId {
|
||||
const normalized = value.trim().toLowerCase();
|
||||
if (STRATEGY_VALUES.has(normalized as StrategyId)) {
|
||||
return normalized as StrategyId;
|
||||
}
|
||||
if (normalized === "offset" || normalized === "offsetmaker" || normalized === "offset-maker") return "offset-maker";
|
||||
if (normalized === "makerpoints" || normalized === "maker_points") return "maker-points";
|
||||
if (normalized === "liquidity" || normalized === "liquiditymaker" || normalized === "liquidity_maker") {
|
||||
return "liquidity-maker";
|
||||
}
|
||||
throw new CommandParseError(`Unsupported strategy '${value}'`);
|
||||
}
|
||||
|
||||
function normalizeSide(value: string): "BUY" | "SELL" {
|
||||
const normalized = value.trim().toUpperCase();
|
||||
if (normalized === "BUY" || normalized === "SELL") return normalized;
|
||||
throw new CommandParseError(`Unsupported side '${value}', expected BUY or SELL`);
|
||||
}
|
||||
|
||||
function normalizeOrderType(value: string): OrderCreateType {
|
||||
const normalized = value.trim().toLowerCase();
|
||||
if (normalized === "limit" || normalized === "market" || normalized === "stop" || normalized === "close") {
|
||||
return normalized;
|
||||
}
|
||||
if (normalized === "trailing-stop" || normalized === "trailing_stop" || normalized === "trailingstop") {
|
||||
return "trailing-stop";
|
||||
}
|
||||
throw new CommandParseError(
|
||||
`Unsupported order type '${value}', expected limit|market|stop|trailing-stop|close`
|
||||
);
|
||||
}
|
||||
|
||||
function normalizeTimeInForce(value: string | undefined): "GTC" | "IOC" | "FOK" | "GTX" | undefined {
|
||||
if (!value) return undefined;
|
||||
const normalized = value.trim().toUpperCase();
|
||||
if (normalized === "GTC" || normalized === "IOC" || normalized === "FOK" || normalized === "GTX") {
|
||||
return normalized;
|
||||
}
|
||||
throw new CommandParseError(`Unsupported time in force '${value}'`);
|
||||
}
|
||||
|
||||
function normalizeTriggerType(
|
||||
value: string | undefined
|
||||
): "UNSPECIFIED" | "TAKE_PROFIT" | "STOP_LOSS" | undefined {
|
||||
if (!value) return undefined;
|
||||
const normalized = value.trim().toUpperCase();
|
||||
if (normalized === "UNSPECIFIED" || normalized === "TAKE_PROFIT" || normalized === "STOP_LOSS") {
|
||||
return normalized;
|
||||
}
|
||||
throw new CommandParseError(`Unsupported trigger type '${value}'`);
|
||||
}
|
||||
@@ -1,86 +0,0 @@
|
||||
import type { SupportedExchangeId } from "../exchanges/create-adapter";
|
||||
import type { StrategyId } from "./args";
|
||||
|
||||
export interface CommandCommonOptions {
|
||||
exchange?: SupportedExchangeId;
|
||||
symbol?: string;
|
||||
json: boolean;
|
||||
dryRun: boolean;
|
||||
timeoutMs: number;
|
||||
}
|
||||
|
||||
export type OrderCreateType = "limit" | "market" | "stop" | "trailing-stop" | "close";
|
||||
|
||||
export interface OrderCreatePayload {
|
||||
side: "BUY" | "SELL";
|
||||
type: OrderCreateType;
|
||||
quantity: number;
|
||||
price?: number;
|
||||
stopPrice?: number;
|
||||
activationPrice?: number;
|
||||
callbackRate?: number;
|
||||
timeInForce?: "GTC" | "IOC" | "FOK" | "GTX";
|
||||
reduceOnly?: boolean;
|
||||
closePosition?: boolean;
|
||||
triggerType?: "UNSPECIFIED" | "TAKE_PROFIT" | "STOP_LOSS";
|
||||
slPrice?: number;
|
||||
tpPrice?: number;
|
||||
}
|
||||
|
||||
export type ParsedCliCommand =
|
||||
| ({ kind: "help"; topic?: string } & CommandCommonOptions)
|
||||
| ({ kind: "doctor" } & CommandCommonOptions)
|
||||
| ({ kind: "exchange-list" } & CommandCommonOptions)
|
||||
| ({ kind: "exchange-capabilities" } & CommandCommonOptions)
|
||||
| ({ kind: "market-ticker" } & CommandCommonOptions)
|
||||
| ({ kind: "market-depth"; levels?: number } & CommandCommonOptions)
|
||||
| ({ kind: "market-kline"; interval: string; limit?: number } & CommandCommonOptions)
|
||||
| ({ kind: "account-snapshot" } & CommandCommonOptions)
|
||||
| ({ kind: "position-list" } & CommandCommonOptions)
|
||||
| ({ kind: "order-open" } & CommandCommonOptions)
|
||||
| ({ kind: "order-create"; payload: OrderCreatePayload } & CommandCommonOptions)
|
||||
| ({ kind: "order-cancel"; orderId: string } & CommandCommonOptions)
|
||||
| ({ kind: "order-cancel-all" } & CommandCommonOptions)
|
||||
| ({ kind: "strategy-run"; strategy: StrategyId; silent: boolean } & CommandCommonOptions);
|
||||
|
||||
export interface CommandErrorPayload {
|
||||
code:
|
||||
| "INVALID_ARGS"
|
||||
| "MISSING_ENV"
|
||||
| "UNSUPPORTED"
|
||||
| "EXCHANGE_ERROR"
|
||||
| "TIMEOUT"
|
||||
| "RUNTIME_ERROR";
|
||||
message: string;
|
||||
retryable?: boolean;
|
||||
details?: unknown;
|
||||
}
|
||||
|
||||
export interface CommandSuccessPayload {
|
||||
success: true;
|
||||
command: ParsedCliCommand["kind"];
|
||||
exchange?: SupportedExchangeId;
|
||||
symbol?: string;
|
||||
dryRun: boolean;
|
||||
ts: string;
|
||||
data: unknown;
|
||||
warnings?: string[];
|
||||
}
|
||||
|
||||
export interface CommandFailurePayload {
|
||||
success: false;
|
||||
command: ParsedCliCommand["kind"] | "unknown";
|
||||
exchange?: SupportedExchangeId;
|
||||
symbol?: string;
|
||||
dryRun: boolean;
|
||||
ts: string;
|
||||
error: CommandErrorPayload;
|
||||
}
|
||||
|
||||
export type CommandPayload = CommandSuccessPayload | CommandFailurePayload;
|
||||
|
||||
export interface CommandExecutionResult {
|
||||
exitCode: number;
|
||||
payload: CommandPayload;
|
||||
forceExit: boolean;
|
||||
}
|
||||
+12
-29
@@ -2,7 +2,6 @@ import { basisConfig, gridConfig, isBasisStrategyEnabled, liquidityMakerConfig,
|
||||
import { getExchangeDisplayName, isBasisSupportedExchangeId, resolveExchangeId } from "../exchanges/create-adapter";
|
||||
import type { ExchangeAdapter } from "../exchanges/adapter";
|
||||
import { buildAdapterFromEnv } from "../exchanges/resolve-from-env";
|
||||
import { DryRunExchangeAdapter } from "../exchanges/dry-run-adapter";
|
||||
import { MakerEngine, type MakerEngineSnapshot } from "../strategy/maker-engine";
|
||||
import { OffsetMakerEngine, type OffsetMakerEngineSnapshot } from "../strategy/offset-maker-engine";
|
||||
import { LiquidityMakerEngine, type LiquidityMakerEngineSnapshot } from "../strategy/liquidity-maker-engine";
|
||||
@@ -17,7 +16,6 @@ import type { StrategyId } from "./args";
|
||||
|
||||
interface RunnerOptions {
|
||||
silent?: boolean;
|
||||
dryRun?: boolean;
|
||||
}
|
||||
|
||||
type StrategyRunner = (options: RunnerOptions) => Promise<void>;
|
||||
@@ -45,13 +43,12 @@ export async function startStrategy(strategyId: StrategyId, options: RunnerOptio
|
||||
const STRATEGY_FACTORIES: Record<StrategyId, StrategyRunner> = {
|
||||
trend: async (opts) => {
|
||||
const config = tradingConfig;
|
||||
const adapter = createAdapterOrThrow(config.symbol, opts.dryRun);
|
||||
const adapter = createAdapterOrThrow(config.symbol);
|
||||
const engine = new TrendEngine(config, adapter);
|
||||
await runEngine({
|
||||
engine,
|
||||
strategy: "trend",
|
||||
silent: opts.silent,
|
||||
dryRun: opts.dryRun,
|
||||
getSnapshot: () => engine.getSnapshot(),
|
||||
onUpdate: (emitter) => engine.on("update", emitter),
|
||||
offUpdate: (emitter) => engine.off("update", emitter),
|
||||
@@ -59,13 +56,12 @@ const STRATEGY_FACTORIES: Record<StrategyId, StrategyRunner> = {
|
||||
},
|
||||
swing: async (opts) => {
|
||||
const config = swingConfig;
|
||||
const adapter = createAdapterOrThrow(config.symbol, opts.dryRun);
|
||||
const adapter = createAdapterOrThrow(config.symbol);
|
||||
const engine = new SwingEngine(config, adapter);
|
||||
await runEngine({
|
||||
engine,
|
||||
strategy: "swing",
|
||||
silent: opts.silent,
|
||||
dryRun: opts.dryRun,
|
||||
getSnapshot: () => engine.getSnapshot(),
|
||||
onUpdate: (emitter) => engine.on("update", emitter),
|
||||
offUpdate: (emitter) => engine.off("update", emitter),
|
||||
@@ -73,13 +69,12 @@ const STRATEGY_FACTORIES: Record<StrategyId, StrategyRunner> = {
|
||||
},
|
||||
guardian: async (opts) => {
|
||||
const config = tradingConfig;
|
||||
const adapter = createAdapterOrThrow(config.symbol, opts.dryRun);
|
||||
const adapter = createAdapterOrThrow(config.symbol);
|
||||
const engine = new GuardianEngine(config, adapter);
|
||||
await runEngine({
|
||||
engine,
|
||||
strategy: "guardian",
|
||||
silent: opts.silent,
|
||||
dryRun: opts.dryRun,
|
||||
getSnapshot: () => engine.getSnapshot(),
|
||||
onUpdate: (emitter) => engine.on("update", emitter),
|
||||
offUpdate: (emitter) => engine.off("update", emitter),
|
||||
@@ -87,13 +82,12 @@ const STRATEGY_FACTORIES: Record<StrategyId, StrategyRunner> = {
|
||||
},
|
||||
maker: async (opts) => {
|
||||
const config = makerConfig;
|
||||
const adapter = createAdapterOrThrow(config.symbol, opts.dryRun);
|
||||
const adapter = createAdapterOrThrow(config.symbol);
|
||||
const engine = new MakerEngine(config, adapter);
|
||||
await runEngine({
|
||||
engine,
|
||||
strategy: "maker",
|
||||
silent: opts.silent,
|
||||
dryRun: opts.dryRun,
|
||||
getSnapshot: () => engine.getSnapshot(),
|
||||
onUpdate: (emitter) => engine.on("update", emitter),
|
||||
offUpdate: (emitter) => engine.off("update", emitter),
|
||||
@@ -105,13 +99,12 @@ const STRATEGY_FACTORIES: Record<StrategyId, StrategyRunner> = {
|
||||
throw new Error("Maker Points strategy only supports the StandX exchange.");
|
||||
}
|
||||
const config = makerPointsConfig;
|
||||
const adapter = createAdapterOrThrow(config.symbol, opts.dryRun);
|
||||
const adapter = createAdapterOrThrow(config.symbol);
|
||||
const engine = new MakerPointsEngine(config, adapter);
|
||||
await runEngine({
|
||||
engine,
|
||||
strategy: "maker-points",
|
||||
silent: opts.silent,
|
||||
dryRun: opts.dryRun,
|
||||
getSnapshot: () => engine.getSnapshot(),
|
||||
onUpdate: (emitter) => engine.on("update", emitter),
|
||||
offUpdate: (emitter) => engine.off("update", emitter),
|
||||
@@ -119,13 +112,12 @@ const STRATEGY_FACTORIES: Record<StrategyId, StrategyRunner> = {
|
||||
},
|
||||
"offset-maker": async (opts) => {
|
||||
const config = makerConfig;
|
||||
const adapter = createAdapterOrThrow(config.symbol, opts.dryRun);
|
||||
const adapter = createAdapterOrThrow(config.symbol);
|
||||
const engine = new OffsetMakerEngine(config, adapter);
|
||||
await runEngine({
|
||||
engine,
|
||||
strategy: "offset-maker",
|
||||
silent: opts.silent,
|
||||
dryRun: opts.dryRun,
|
||||
getSnapshot: () => engine.getSnapshot(),
|
||||
onUpdate: (emitter) => engine.on("update", emitter),
|
||||
offUpdate: (emitter) => engine.off("update", emitter),
|
||||
@@ -133,13 +125,12 @@ const STRATEGY_FACTORIES: Record<StrategyId, StrategyRunner> = {
|
||||
},
|
||||
"liquidity-maker": async (opts) => {
|
||||
const config = liquidityMakerConfig;
|
||||
const adapter = createAdapterOrThrow(config.symbol, opts.dryRun);
|
||||
const adapter = createAdapterOrThrow(config.symbol);
|
||||
const engine = new LiquidityMakerEngine(config, adapter);
|
||||
await runEngine({
|
||||
engine,
|
||||
strategy: "liquidity-maker",
|
||||
silent: opts.silent,
|
||||
dryRun: opts.dryRun,
|
||||
getSnapshot: () => engine.getSnapshot(),
|
||||
onUpdate: (emitter) => engine.on("update", emitter),
|
||||
offUpdate: (emitter) => engine.off("update", emitter),
|
||||
@@ -153,13 +144,12 @@ const STRATEGY_FACTORIES: Record<StrategyId, StrategyRunner> = {
|
||||
if (!isBasisSupportedExchangeId(exchangeId)) {
|
||||
throw new Error("Basis arbitrage strategy currently only supports the Aster, Nado, StandX, and Binance exchanges");
|
||||
}
|
||||
const adapter = createAdapterOrThrow(basisConfig.futuresSymbol, opts.dryRun);
|
||||
const adapter = createAdapterOrThrow(basisConfig.futuresSymbol);
|
||||
const engine = new BasisArbEngine(basisConfig, adapter);
|
||||
await runEngine({
|
||||
engine,
|
||||
strategy: "basis",
|
||||
silent: opts.silent,
|
||||
dryRun: opts.dryRun,
|
||||
getSnapshot: () => engine.getSnapshot(),
|
||||
onUpdate: (emitter) => engine.on("update", emitter),
|
||||
offUpdate: (emitter) => engine.off("update", emitter),
|
||||
@@ -167,13 +157,12 @@ const STRATEGY_FACTORIES: Record<StrategyId, StrategyRunner> = {
|
||||
},
|
||||
grid: async (opts) => {
|
||||
const config = gridConfig;
|
||||
const adapter = createAdapterOrThrow(config.symbol, opts.dryRun);
|
||||
const adapter = createAdapterOrThrow(config.symbol);
|
||||
const engine = new GridEngine(config, adapter);
|
||||
await runEngine({
|
||||
engine,
|
||||
strategy: "grid",
|
||||
silent: opts.silent,
|
||||
dryRun: opts.dryRun,
|
||||
getSnapshot: () => engine.getSnapshot(),
|
||||
onUpdate: (emitter) => engine.on("update", emitter),
|
||||
offUpdate: (emitter) => engine.off("update", emitter),
|
||||
@@ -185,7 +174,6 @@ interface EngineHarness<TSnapshot> {
|
||||
engine: { start(): void; stop(): void };
|
||||
strategy: StrategyId;
|
||||
silent?: boolean;
|
||||
dryRun?: boolean;
|
||||
getSnapshot: () => TSnapshot;
|
||||
onUpdate: (handler: (snapshot: TSnapshot) => void) => void;
|
||||
offUpdate: (handler: (snapshot: TSnapshot) => void) => void;
|
||||
@@ -238,8 +226,7 @@ async function runEngine<
|
||||
onUpdate(emitter);
|
||||
engine.start();
|
||||
|
||||
const modeLabel = `${silent ? "silent" : "interactive"}${harness.dryRun ? "+dry-run" : ""}`;
|
||||
console.info(`[${label}] Starting on ${exchangeName}. Mode: ${modeLabel}. Press Ctrl+C to exit.`);
|
||||
console.info(`[${label}] Starting on ${exchangeName}. Mode: ${silent ? "silent" : "interactive"}. Press Ctrl+C to exit.`);
|
||||
|
||||
const shutdown = (signal: NodeJS.Signals) => {
|
||||
try {
|
||||
@@ -264,12 +251,8 @@ async function runEngine<
|
||||
});
|
||||
}
|
||||
|
||||
function createAdapterOrThrow(symbol: string, dryRun?: boolean): ExchangeAdapter {
|
||||
const adapter = buildAdapterFromEnv({ exchangeId: resolveExchangeId(), symbol });
|
||||
if (dryRun) {
|
||||
return new DryRunExchangeAdapter(adapter);
|
||||
}
|
||||
return adapter;
|
||||
function createAdapterOrThrow(symbol: string): ExchangeAdapter {
|
||||
return buildAdapterFromEnv({ exchangeId: resolveExchangeId(), symbol });
|
||||
}
|
||||
|
||||
type TradeLogEntry = { time: string; type: string; detail: string };
|
||||
|
||||
@@ -543,7 +543,7 @@ export class AsterSpotRestClient {
|
||||
}
|
||||
try {
|
||||
return JSON.parse(text) as T;
|
||||
} catch {
|
||||
} catch (error) {
|
||||
throw new Error(`[AsterSpotRestClient] 无法解析响应: ${text.slice(0, 200)}`);
|
||||
}
|
||||
}
|
||||
@@ -795,7 +795,7 @@ export class AsterRestClient {
|
||||
}
|
||||
try {
|
||||
return JSON.parse(text) as AsterFuturesExchangeInfo;
|
||||
} catch {
|
||||
} catch (error) {
|
||||
throw new Error(`[AsterRestClient] 无法解析交易规则响应: ${text.slice(0, 200)}`);
|
||||
}
|
||||
}
|
||||
@@ -869,7 +869,7 @@ export class AsterRestClient {
|
||||
try {
|
||||
const payload = JSON.parse(text) as any[];
|
||||
return payload.map((entry) => fromRestKline(entry, interval, upper));
|
||||
} catch {
|
||||
} catch (error) {
|
||||
throw new Error(`[AsterRestClient] 无法解析K线响应: ${text.slice(0, 200)}`);
|
||||
}
|
||||
}
|
||||
@@ -899,7 +899,7 @@ export class AsterRestClient {
|
||||
const payload = JSON.parse(text) as any;
|
||||
// The response shape mirrors Binance: { symbol, markPrice, indexPrice, lastFundingRate, nextFundingTime, time }
|
||||
return payload;
|
||||
} catch {
|
||||
} catch (error) {
|
||||
throw new Error(`[AsterRestClient] 无法解析资金费率响应: ${text.slice(0, 200)}`);
|
||||
}
|
||||
}
|
||||
@@ -942,7 +942,7 @@ export class AsterRestClient {
|
||||
}
|
||||
try {
|
||||
return JSON.parse(text) as T;
|
||||
} catch {
|
||||
} catch (error) {
|
||||
throw new Error(`[AsterRestClient] 无法解析响应: ${text.slice(0, 200)}`);
|
||||
}
|
||||
}
|
||||
@@ -1366,7 +1366,7 @@ export class AsterGateway {
|
||||
});
|
||||
}
|
||||
|
||||
async ensureInitialized(_symbol: string): Promise<void> {
|
||||
async ensureInitialized(symbol: string): Promise<void> {
|
||||
if (this.initialized) return;
|
||||
if (this.initializing) return this.initializing;
|
||||
this.initializing = (async () => {
|
||||
|
||||
@@ -7,6 +7,7 @@ import ccxt, {
|
||||
import NodeWebSocket from "ws";
|
||||
import { sign, utils as edUtils, hashes as edHashes } from "@noble/ed25519";
|
||||
import { sha512 } from "@noble/hashes/sha512";
|
||||
import { randomBytes } from "crypto";
|
||||
import type {
|
||||
AsterAccountSnapshot,
|
||||
AsterAccountPosition,
|
||||
@@ -136,16 +137,17 @@ export class BackpackGateway {
|
||||
}
|
||||
|
||||
private async doInitialize(symbol?: string): Promise<void> {
|
||||
await this.exchange.loadMarkets();
|
||||
const requested = (symbol ?? this.symbol).toUpperCase();
|
||||
const market = this.findMarket(requested);
|
||||
if (!market) {
|
||||
throw new Error(`Symbol ${requested} not found in Backpack markets`);
|
||||
}
|
||||
this.market = market;
|
||||
this.marketSymbol = market.symbol;
|
||||
this.marketId = market.id;
|
||||
this.isContractMarket = Boolean(market.contract);
|
||||
try {
|
||||
await this.exchange.loadMarkets();
|
||||
const requested = (symbol ?? this.symbol).toUpperCase();
|
||||
const market = this.findMarket(requested);
|
||||
if (!market) {
|
||||
throw new Error(`Symbol ${requested} not found in Backpack markets`);
|
||||
}
|
||||
this.market = market;
|
||||
this.marketSymbol = market.symbol;
|
||||
this.marketId = market.id;
|
||||
this.isContractMarket = Boolean(market.contract);
|
||||
if (process.env.BACKPACK_DEBUG === "1") {
|
||||
console.debug("[BackpackGateway] marketInfo", {
|
||||
userSymbol: this.symbol,
|
||||
@@ -153,7 +155,10 @@ export class BackpackGateway {
|
||||
marketId: this.marketId,
|
||||
});
|
||||
}
|
||||
this.initialized = true;
|
||||
this.initialized = true;
|
||||
} catch (error) {
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
private findMarket(requested: string): any | null {
|
||||
@@ -469,20 +474,18 @@ export class BackpackGateway {
|
||||
if (!quantity) continue;
|
||||
const sideRaw = String(raw?.side ?? info.side ?? this.deriveSideFromExposure(info)).toLowerCase();
|
||||
const isShort = sideRaw.includes("short") || quantity < 0;
|
||||
const isLong = sideRaw.includes("long") || (!sideRaw.includes("short") && quantity > 0);
|
||||
const positionAmt = isShort ? -Math.abs(quantity) : Math.abs(quantity);
|
||||
const entryPrice = this.toStringAmount(raw?.entryPrice ?? info.entryPrice ?? "0");
|
||||
const unrealized = this.toStringAmount(raw?.unrealizedPnl ?? info.pnlUnrealized ?? "0");
|
||||
const markPrice = this.toOptionalString(raw?.markPrice ?? info.markPrice);
|
||||
const liquidationPrice = this.toOptionalString(raw?.liquidationPrice ?? info.estLiquidationPrice);
|
||||
const leverage = this.toOptionalString(raw?.leverage ?? info.leverage);
|
||||
const symbol = String(raw?.symbol ?? info.symbol ?? this.marketSymbol ?? this.symbol);
|
||||
positions.push({
|
||||
symbol,
|
||||
symbol: this.symbol,
|
||||
positionAmt: positionAmt.toString(),
|
||||
entryPrice,
|
||||
unrealizedProfit: unrealized,
|
||||
positionSide: isLong ? "LONG" : isShort ? "SHORT" : "BOTH",
|
||||
positionSide: "BOTH",
|
||||
updateTime: now,
|
||||
markPrice,
|
||||
liquidationPrice,
|
||||
@@ -769,7 +772,7 @@ export class BackpackGateway {
|
||||
void this.resubscribeAllTopics();
|
||||
};
|
||||
|
||||
private handleWsClose = (_event: any): void => {
|
||||
private handleWsClose = (event: any): void => {
|
||||
if (this.wsCleanup) {
|
||||
try {
|
||||
this.wsCleanup();
|
||||
|
||||
@@ -1,6 +1,9 @@
|
||||
import ccxt, {
|
||||
type Balances,
|
||||
type Order as CcxtOrder,
|
||||
type OrderBook as CcxtOrderBook,
|
||||
type OHLCV as CcxtOhlcv,
|
||||
type Ticker as CcxtTicker,
|
||||
} from "ccxt";
|
||||
import axios from "axios";
|
||||
import { createHash } from "crypto";
|
||||
|
||||
@@ -1,163 +0,0 @@
|
||||
import type {
|
||||
AccountListener,
|
||||
ConnectionEventListener,
|
||||
DepthListener,
|
||||
ExchangeAdapter,
|
||||
ExchangePrecision,
|
||||
FundingRateListener,
|
||||
KlineListener,
|
||||
OrderListener,
|
||||
RestHealthListener,
|
||||
TickerListener,
|
||||
} from "./adapter";
|
||||
import type {
|
||||
AsterAccountSnapshot,
|
||||
AsterOrder,
|
||||
CreateOrderParams,
|
||||
} from "./types";
|
||||
|
||||
export interface DryRunAction {
|
||||
method:
|
||||
| "createOrder"
|
||||
| "cancelOrder"
|
||||
| "cancelOrders"
|
||||
| "cancelAllOrders"
|
||||
| "changeMarginMode"
|
||||
| "forceCancelAllOrders";
|
||||
params: unknown;
|
||||
at: number;
|
||||
}
|
||||
|
||||
export class DryRunExchangeAdapter implements ExchangeAdapter {
|
||||
readonly id: string;
|
||||
readonly actions: DryRunAction[] = [];
|
||||
private syntheticCounter = 0;
|
||||
|
||||
constructor(private readonly inner: ExchangeAdapter) {
|
||||
this.id = inner.id;
|
||||
}
|
||||
|
||||
supportsTrailingStops(): boolean {
|
||||
return this.inner.supportsTrailingStops();
|
||||
}
|
||||
|
||||
watchAccount(cb: AccountListener): void {
|
||||
this.inner.watchAccount(cb);
|
||||
}
|
||||
|
||||
watchOrders(cb: OrderListener): void {
|
||||
this.inner.watchOrders(cb);
|
||||
}
|
||||
|
||||
watchDepth(symbol: string, cb: DepthListener): void {
|
||||
this.inner.watchDepth(symbol, cb);
|
||||
}
|
||||
|
||||
watchTicker(symbol: string, cb: TickerListener): void {
|
||||
this.inner.watchTicker(symbol, cb);
|
||||
}
|
||||
|
||||
watchKlines(symbol: string, interval: string, cb: KlineListener): void {
|
||||
this.inner.watchKlines(symbol, interval, cb);
|
||||
}
|
||||
|
||||
watchFundingRate(symbol: string, cb: FundingRateListener): void {
|
||||
if (!this.inner.watchFundingRate) return;
|
||||
this.inner.watchFundingRate(symbol, cb);
|
||||
}
|
||||
|
||||
async createOrder(params: CreateOrderParams): Promise<AsterOrder> {
|
||||
this.record("createOrder", params);
|
||||
return createSyntheticOrder(params, ++this.syntheticCounter);
|
||||
}
|
||||
|
||||
async cancelOrder(params: { symbol: string; orderId: number | string }): Promise<void> {
|
||||
this.record("cancelOrder", params);
|
||||
}
|
||||
|
||||
async cancelOrders(params: { symbol: string; orderIdList: Array<number | string> }): Promise<void> {
|
||||
this.record("cancelOrders", params);
|
||||
}
|
||||
|
||||
async cancelAllOrders(params: { symbol: string }): Promise<void> {
|
||||
this.record("cancelAllOrders", params);
|
||||
}
|
||||
|
||||
async getPrecision(): Promise<ExchangePrecision | null> {
|
||||
if (!this.inner.getPrecision) return null;
|
||||
return this.inner.getPrecision();
|
||||
}
|
||||
|
||||
onConnectionEvent(listener: ConnectionEventListener): void {
|
||||
this.inner.onConnectionEvent?.(listener);
|
||||
}
|
||||
|
||||
offConnectionEvent(listener: ConnectionEventListener): void {
|
||||
this.inner.offConnectionEvent?.(listener);
|
||||
}
|
||||
|
||||
onRestHealthEvent(listener: RestHealthListener): void {
|
||||
this.inner.onRestHealthEvent?.(listener);
|
||||
}
|
||||
|
||||
offRestHealthEvent(listener: RestHealthListener): void {
|
||||
this.inner.offRestHealthEvent?.(listener);
|
||||
}
|
||||
|
||||
async queryOpenOrders(): Promise<AsterOrder[]> {
|
||||
if (!this.inner.queryOpenOrders) return [];
|
||||
return this.inner.queryOpenOrders();
|
||||
}
|
||||
|
||||
async queryAccountSnapshot(): Promise<AsterAccountSnapshot | null> {
|
||||
if (!this.inner.queryAccountSnapshot) return null;
|
||||
return this.inner.queryAccountSnapshot();
|
||||
}
|
||||
|
||||
async changeMarginMode(params: { symbol: string; marginMode: "isolated" | "cross" }): Promise<void> {
|
||||
this.record("changeMarginMode", params);
|
||||
}
|
||||
|
||||
async forceCancelAllOrders(): Promise<boolean> {
|
||||
this.record("forceCancelAllOrders", {});
|
||||
return true;
|
||||
}
|
||||
|
||||
private record(method: DryRunAction["method"], params: unknown): void {
|
||||
this.actions.push({ method, params, at: Date.now() });
|
||||
}
|
||||
}
|
||||
|
||||
function createSyntheticOrder(params: CreateOrderParams, counter: number): AsterOrder {
|
||||
const now = Date.now();
|
||||
const orderId = `dry-run-${now}-${counter}`;
|
||||
return {
|
||||
orderId,
|
||||
clientOrderId: orderId,
|
||||
symbol: params.symbol,
|
||||
side: params.side,
|
||||
type: params.type,
|
||||
status: "NEW",
|
||||
price: toStringNumber(params.price),
|
||||
origQty: toStringNumber(params.quantity),
|
||||
executedQty: "0",
|
||||
stopPrice: toStringNumber(params.stopPrice),
|
||||
time: now,
|
||||
updateTime: now,
|
||||
reduceOnly: params.reduceOnly === "true",
|
||||
closePosition: params.closePosition === "true",
|
||||
activationPrice: toOptionalString(params.activationPrice),
|
||||
timeInForce: params.timeInForce,
|
||||
workingType: "MARK_PRICE",
|
||||
};
|
||||
}
|
||||
|
||||
function toStringNumber(value: number | undefined): string {
|
||||
if (value == null) return "0";
|
||||
return String(value);
|
||||
}
|
||||
|
||||
function toOptionalString(value: number | undefined): string | undefined {
|
||||
if (value == null) return undefined;
|
||||
return String(value);
|
||||
}
|
||||
@@ -1161,7 +1161,7 @@ function mapTicker(response: IApiTickerResponse, symbol: string): AsterTicker |
|
||||
};
|
||||
}
|
||||
|
||||
function mapKlines(response: IApiCandlestickResponse, _symbol: string): AsterKline[] {
|
||||
function mapKlines(response: IApiCandlestickResponse, symbol: string): AsterKline[] {
|
||||
return (response.result ?? []).reverse().map((entry) => ({
|
||||
openTime: nsToMs(entry.open_time ?? Date.now() * ONE_SECOND_IN_NANOSECONDS),
|
||||
closeTime: nsToMs(entry.close_time ?? Date.now() * ONE_SECOND_IN_NANOSECONDS),
|
||||
|
||||
@@ -16,10 +16,12 @@ import type {
|
||||
AsterTicker,
|
||||
CreateOrderParams,
|
||||
} from "../types";
|
||||
import { extractMessage } from "../../utils/errors";
|
||||
import type { OrderSide, OrderType } from "../types";
|
||||
import { LighterHttpClient } from "./http-client";
|
||||
import { HttpNonceManager } from "./nonce-manager";
|
||||
import { LighterSigner, type CreateOrderSignParams } from "./signer";
|
||||
import { bytesToHex } from "./bytes";
|
||||
import type {
|
||||
LighterAccountDetails,
|
||||
LighterAccountAsset,
|
||||
@@ -37,6 +39,7 @@ import {
|
||||
LIGHTER_HOSTS,
|
||||
LIGHTER_ORDER_TYPE,
|
||||
LIGHTER_TIME_IN_FORCE,
|
||||
DEFAULT_ORDER_EXPIRY_PLACEHOLDER,
|
||||
IMMEDIATE_OR_CANCEL_EXPIRY_PLACEHOLDER,
|
||||
type LighterEnvironment,
|
||||
} from "./constants";
|
||||
@@ -2207,7 +2210,7 @@ function extractJsonRequestId(message: any): string | null {
|
||||
function tryParseTxInfo(value: string): unknown {
|
||||
try {
|
||||
return JSON.parse(value);
|
||||
} catch {
|
||||
} catch (_) {
|
||||
return value;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -128,7 +128,7 @@ function computeExecutedQty(order: LighterOrder): string {
|
||||
if (Number.isFinite(initial) && Number.isFinite(remaining)) {
|
||||
return (initial - remaining).toString();
|
||||
}
|
||||
} catch {
|
||||
} catch (_) {
|
||||
// fall through
|
||||
}
|
||||
}
|
||||
|
||||
@@ -100,13 +100,6 @@ class PythonSignerBridge {
|
||||
pending.reject(new Error(String(error)));
|
||||
return;
|
||||
}
|
||||
if (
|
||||
Object.prototype.hasOwnProperty.call(payload, "txHash") ||
|
||||
Object.prototype.hasOwnProperty.call(payload, "messageToSign")
|
||||
) {
|
||||
pending.resolve(payload);
|
||||
return;
|
||||
}
|
||||
pending.resolve(payload.result ?? null);
|
||||
}
|
||||
|
||||
@@ -188,7 +181,7 @@ export class LighterSigner {
|
||||
await this.ensureReady();
|
||||
const apiKeyIndex = params.apiKeyIndex ?? this.defaultKeyIndex;
|
||||
|
||||
const bridgePayload = await this.bridge.call("sign_create_order", {
|
||||
const result = await this.bridge.call("sign_create_order", {
|
||||
apiKeyIndex,
|
||||
marketIndex: params.marketIndex,
|
||||
clientOrderIndex: params.clientOrderIndex.toString(),
|
||||
@@ -200,14 +193,13 @@ export class LighterSigner {
|
||||
reduceOnly: params.reduceOnly,
|
||||
triggerPrice: params.triggerPrice,
|
||||
orderExpiry: params.orderExpiry.toString(),
|
||||
expiredAt: params.expiredAt?.toString(),
|
||||
nonce: params.nonce.toString(),
|
||||
accountIndex: this.accountIndex.toString(),
|
||||
});
|
||||
|
||||
const txInfo = this.resolveTxInfo(bridgePayload);
|
||||
const txInfo = String(result);
|
||||
let signature: string | undefined;
|
||||
let txHash: string | undefined = this.resolveTxHash(bridgePayload);
|
||||
let txHash: string | undefined;
|
||||
try {
|
||||
const parsed = JSON.parse(txInfo);
|
||||
if (typeof parsed?.Sig === "string") signature = parsed.Sig;
|
||||
@@ -228,7 +220,7 @@ export class LighterSigner {
|
||||
await this.ensureReady();
|
||||
const apiKeyIndex = params.apiKeyIndex ?? this.defaultKeyIndex;
|
||||
|
||||
const bridgePayload = await this.bridge.call("sign_cancel_order", {
|
||||
const result = await this.bridge.call("sign_cancel_order", {
|
||||
apiKeyIndex,
|
||||
marketIndex: params.marketIndex,
|
||||
orderIndex: params.orderIndex.toString(),
|
||||
@@ -236,7 +228,7 @@ export class LighterSigner {
|
||||
accountIndex: this.accountIndex.toString(),
|
||||
});
|
||||
|
||||
const txInfo = this.resolveTxInfo(bridgePayload);
|
||||
const txInfo = String(result);
|
||||
let signature: string | undefined;
|
||||
try {
|
||||
const parsed = JSON.parse(txInfo);
|
||||
@@ -256,7 +248,7 @@ export class LighterSigner {
|
||||
await this.ensureReady();
|
||||
const apiKeyIndex = params.apiKeyIndex ?? this.defaultKeyIndex;
|
||||
|
||||
const bridgePayload = await this.bridge.call("sign_cancel_all", {
|
||||
const result = await this.bridge.call("sign_cancel_all", {
|
||||
apiKeyIndex,
|
||||
timeInForce: params.timeInForce,
|
||||
scheduledTime: params.scheduledTime.toString(),
|
||||
@@ -264,7 +256,7 @@ export class LighterSigner {
|
||||
accountIndex: this.accountIndex.toString(),
|
||||
});
|
||||
|
||||
const txInfo = this.resolveTxInfo(bridgePayload);
|
||||
const txInfo = String(result);
|
||||
let signature: string | undefined;
|
||||
try {
|
||||
const parsed = JSON.parse(txInfo);
|
||||
@@ -290,17 +282,4 @@ export class LighterSigner {
|
||||
});
|
||||
return String(result ?? "");
|
||||
}
|
||||
|
||||
private resolveTxInfo(payload: unknown): string {
|
||||
if (payload && typeof payload === "object" && "result" in payload) {
|
||||
return String((payload as { result?: unknown }).result ?? "");
|
||||
}
|
||||
return String(payload ?? "");
|
||||
}
|
||||
|
||||
private resolveTxHash(payload: unknown): string | undefined {
|
||||
if (!payload || typeof payload !== "object") return undefined;
|
||||
const hash = (payload as { txHash?: unknown }).txHash;
|
||||
return typeof hash === "string" && hash.length > 0 ? hash : undefined;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1684,7 +1684,7 @@ export class NadoGateway {
|
||||
try {
|
||||
const text = typeof data === "string" ? data : data.toString("utf8");
|
||||
message = JSON.parse(text);
|
||||
} catch {
|
||||
} catch (_error) {
|
||||
return;
|
||||
}
|
||||
if (!message || typeof message !== "object") return;
|
||||
|
||||
@@ -32,7 +32,7 @@ function loadCcxtPro(): any | null {
|
||||
// eslint-disable-next-line @typescript-eslint/no-var-requires
|
||||
const mod = require("ccxt.pro");
|
||||
return mod?.default ?? mod;
|
||||
} catch {
|
||||
} catch (_error) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
@@ -571,6 +571,7 @@ export class ParadexGateway {
|
||||
const market = typeof (this.exchange as any).market === "function"
|
||||
? (this.exchange as any).market(symbol)
|
||||
: (this.exchange.markets ?? {})[symbol];
|
||||
const precisionDigits = Number((market?.precision?.amount ?? market?.amountPrecision));
|
||||
const limitMin = Number(market?.limits?.amount?.min);
|
||||
// Only trust explicit exchange min limit; do NOT infer 1 from precision=0
|
||||
const minAmount = Number.isFinite(limitMin) && limitMin > 0 ? limitMin : undefined;
|
||||
@@ -592,7 +593,7 @@ export class ParadexGateway {
|
||||
if (typeof (this.exchange as any).amountToPrecision === "function" && Number.isFinite(Number(amount))) {
|
||||
amount = Number((this.exchange as any).amountToPrecision(symbol, amount));
|
||||
}
|
||||
} catch {
|
||||
} catch (_normalizeError) {
|
||||
// Swallow precision normalization errors and let exchange validation surface if any
|
||||
}
|
||||
|
||||
@@ -943,7 +944,7 @@ export class ParadexGateway {
|
||||
}
|
||||
}
|
||||
|
||||
private updateOrdersFromRemote(open: CcxtOrder[], _closed: CcxtOrder[]): void {
|
||||
private updateOrdersFromRemote(open: CcxtOrder[], closed: CcxtOrder[]): void {
|
||||
const nextOpen = new Map<string, AsterOrder>();
|
||||
|
||||
for (const order of open) {
|
||||
|
||||
+22
-56
@@ -4,64 +4,30 @@ import { App } from "./ui/App";
|
||||
import { setupGlobalErrorHandlers } from "./runtime-errors";
|
||||
import { parseCliArgs, printCliHelp } from "./cli/args";
|
||||
import { startStrategy } from "./cli/strategy-runner";
|
||||
import { CommandParseError, parseCommandArgv, printCommandHelp } from "./cli/command-parser";
|
||||
import { executeCliCommand, renderCommandPayload } from "./cli/command-executor";
|
||||
import { resolveExchangeId } from "./exchanges/create-adapter";
|
||||
|
||||
setupGlobalErrorHandlers();
|
||||
void run();
|
||||
const options = parseCliArgs();
|
||||
// If user specifies --exchange, override environment-based resolution for this process
|
||||
if (options.exchange) {
|
||||
// Ensure downstream calls to resolveExchangeId() pick the CLI value.
|
||||
// We set both common env keys respected by resolveExchangeId.
|
||||
process.env.EXCHANGE = options.exchange;
|
||||
process.env.TRADE_EXCHANGE = options.exchange;
|
||||
}
|
||||
|
||||
async function run(): Promise<void> {
|
||||
const rawArgv = process.argv.slice(2);
|
||||
if (options.help) {
|
||||
printCliHelp();
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
try {
|
||||
const parsedCommand = parseCommandArgv(rawArgv);
|
||||
if (parsedCommand) {
|
||||
if (parsedCommand.kind === "help") {
|
||||
printCommandHelp(parsedCommand.topic);
|
||||
process.exit(0);
|
||||
}
|
||||
const result = await executeCliCommand(parsedCommand);
|
||||
const output = renderCommandPayload(result.payload, parsedCommand.json);
|
||||
if (result.payload.success) {
|
||||
console.log(output);
|
||||
} else {
|
||||
console.error(output);
|
||||
}
|
||||
if (result.forceExit) {
|
||||
process.exit(result.exitCode);
|
||||
}
|
||||
return;
|
||||
}
|
||||
} catch (error) {
|
||||
if (error instanceof CommandParseError) {
|
||||
console.error(`[CLI] ${error.message}`);
|
||||
process.exit(2);
|
||||
}
|
||||
throw error;
|
||||
}
|
||||
|
||||
const options = parseCliArgs(rawArgv);
|
||||
// If user specifies --exchange, override environment-based resolution for this process
|
||||
if (options.exchange) {
|
||||
// Ensure downstream calls to resolveExchangeId() pick the CLI value.
|
||||
// We set both common env keys respected by resolveExchangeId.
|
||||
process.env.EXCHANGE = options.exchange;
|
||||
process.env.TRADE_EXCHANGE = options.exchange;
|
||||
}
|
||||
|
||||
if (options.help) {
|
||||
printCliHelp();
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
if (options.strategy) {
|
||||
startStrategy(options.strategy, { silent: options.silent })
|
||||
.catch((error) => {
|
||||
const message = error instanceof Error ? error.message : String(error);
|
||||
console.error(`[Strategy] Failed to start: ${message}`);
|
||||
process.exit(1);
|
||||
});
|
||||
} else {
|
||||
render(<App />);
|
||||
}
|
||||
if (options.strategy) {
|
||||
startStrategy(options.strategy, { silent: options.silent })
|
||||
.catch((error) => {
|
||||
const message = error instanceof Error ? error.message : String(error);
|
||||
console.error(`[Strategy] Failed to start: ${message}`);
|
||||
process.exit(1);
|
||||
});
|
||||
} else {
|
||||
render(<App />);
|
||||
}
|
||||
|
||||
@@ -409,7 +409,7 @@ export class BasisArbEngine {
|
||||
if (!Number.isFinite(wallet) || !Number.isFinite(available)) continue;
|
||||
if (Math.abs(wallet) === 0 && Math.abs(available) === 0) continue;
|
||||
|
||||
const isTaggedFuturesAsset = name.endsWith("0");
|
||||
const isTaggedFuturesAsset = /0$/.test(name);
|
||||
if (isTaggedFuturesAsset) {
|
||||
futuresBalances.push({ asset: name.replace(/0$/, ""), wallet, available });
|
||||
continue;
|
||||
|
||||
+5
-160
@@ -23,7 +23,6 @@ interface DesiredGridOrder {
|
||||
price: string;
|
||||
amount: number;
|
||||
intent?: "ENTRY" | "EXIT";
|
||||
reduceOnly?: boolean;
|
||||
}
|
||||
|
||||
interface LevelMeta {
|
||||
@@ -92,9 +91,6 @@ export class GridEngine {
|
||||
private readonly pendingLongLevels = new Set<number>();
|
||||
private readonly pendingShortLevels = new Set<number>();
|
||||
private readonly closeKeyBySourceLevel = new Map<number, string>();
|
||||
// Legacy compatibility maps kept for tests/debugging.
|
||||
private readonly longExposure = new Map<number, number>();
|
||||
private readonly shortExposure = new Map<number, number>();
|
||||
|
||||
private prevActiveIds: Set<string> = new Set<string>();
|
||||
private orderIntentById = new Map<string, { side: "BUY" | "SELL"; price: string; level: number; intent: "ENTRY" | "EXIT"; sourceLevel?: number }>();
|
||||
@@ -268,7 +264,7 @@ export class GridEngine {
|
||||
if (!Number.isFinite(this.config.maxPositionSize) || this.config.maxPositionSize <= 0) {
|
||||
return false;
|
||||
}
|
||||
if (!Number.isFinite(this.config.refreshIntervalMs) || this.config.refreshIntervalMs < 1) {
|
||||
if (!Number.isFinite(this.config.refreshIntervalMs) || this.config.refreshIntervalMs < 100) {
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
@@ -282,7 +278,6 @@ export class GridEngine {
|
||||
(snapshot) => {
|
||||
this.accountSnapshot = snapshot;
|
||||
this.position = getPosition(snapshot, this.config.symbol);
|
||||
this.syncLegacyExposureFromPosition();
|
||||
this.accountVersion += 1;
|
||||
this.lastAbsPositionAmt = Math.abs(this.position.positionAmt);
|
||||
if (!this.feedArrived.account) {
|
||||
@@ -461,7 +456,7 @@ export class GridEngine {
|
||||
return false;
|
||||
}
|
||||
|
||||
private async haltGrid(_price: number): Promise<void> {
|
||||
private async haltGrid(price: number): Promise<void> {
|
||||
if (!this.running) return;
|
||||
const reason = this.stopReason ?? "触发网格止损";
|
||||
this.log("warn", `${reason}，开始执行平仓与撤单`);
|
||||
@@ -772,14 +767,7 @@ export class GridEngine {
|
||||
}
|
||||
const count = plannedKeyCounts.get(key) ?? 0;
|
||||
if (count < 1 && !desiredKeySet.has(key)) {
|
||||
desired.push({
|
||||
level: item.targetLevel,
|
||||
side: item.side,
|
||||
price: item.price,
|
||||
amount: this.config.orderSize,
|
||||
intent: "EXIT",
|
||||
reduceOnly: true,
|
||||
});
|
||||
desired.push({ level: item.targetLevel, side: item.side, price: item.price, amount: this.config.orderSize, intent: "EXIT" });
|
||||
desiredKeySet.add(key);
|
||||
plannedKeyCounts.set(key, count + 1);
|
||||
}
|
||||
@@ -877,14 +865,7 @@ export class GridEngine {
|
||||
continue;
|
||||
}
|
||||
if ((plannedKeyCounts.get(closeKey) ?? 0) < 1 && !desiredKeySet.has(closeKey)) {
|
||||
desired.push({
|
||||
level: target,
|
||||
side: "SELL",
|
||||
price: priceStr,
|
||||
amount: this.config.orderSize,
|
||||
intent: "EXIT",
|
||||
reduceOnly: true,
|
||||
});
|
||||
desired.push({ level: target, side: "SELL", price: priceStr, amount: this.config.orderSize, intent: "EXIT" });
|
||||
desiredKeySet.add(closeKey);
|
||||
plannedKeyCounts.set(closeKey, (plannedKeyCounts.get(closeKey) ?? 0) + 1);
|
||||
}
|
||||
@@ -903,14 +884,7 @@ export class GridEngine {
|
||||
continue;
|
||||
}
|
||||
if ((plannedKeyCounts.get(closeKey) ?? 0) < 1 && !desiredKeySet.has(closeKey)) {
|
||||
desired.push({
|
||||
level: target,
|
||||
side: "BUY",
|
||||
price: priceStr,
|
||||
amount: this.config.orderSize,
|
||||
intent: "EXIT",
|
||||
reduceOnly: true,
|
||||
});
|
||||
desired.push({ level: target, side: "BUY", price: priceStr, amount: this.config.orderSize, intent: "EXIT" });
|
||||
desiredKeySet.add(closeKey);
|
||||
plannedKeyCounts.set(closeKey, (plannedKeyCounts.get(closeKey) ?? 0) + 1);
|
||||
}
|
||||
@@ -1404,133 +1378,4 @@ export class GridEngine {
|
||||
}
|
||||
return best;
|
||||
}
|
||||
|
||||
// Legacy helper retained for tests and debug tooling.
|
||||
private computeDesiredOrders(price: number): DesiredGridOrder[] {
|
||||
if (!Number.isFinite(price)) return [];
|
||||
|
||||
const desired: DesiredGridOrder[] = [];
|
||||
const halfTick = this.config.priceTick / 2;
|
||||
let remainingLong = Math.max(this.config.maxPositionSize - this.sumExposure(this.longExposure), 0);
|
||||
let remainingShort = Math.max(this.config.maxPositionSize - this.sumExposure(this.shortExposure), 0);
|
||||
|
||||
for (const level of this.buyLevelIndices.slice().reverse()) {
|
||||
if (this.config.direction === "short") break;
|
||||
if (this.longExposure.has(level)) continue;
|
||||
const levelPrice = this.gridLevels[level]!;
|
||||
if (levelPrice >= price - halfTick) continue;
|
||||
if (remainingLong <= EPSILON) continue;
|
||||
const amount = Math.min(this.config.orderSize, remainingLong);
|
||||
if (amount <= EPSILON) continue;
|
||||
desired.push({
|
||||
level,
|
||||
side: "BUY",
|
||||
price: this.formatPrice(levelPrice),
|
||||
amount,
|
||||
intent: "ENTRY",
|
||||
reduceOnly: false,
|
||||
});
|
||||
remainingLong -= amount;
|
||||
}
|
||||
|
||||
for (const level of this.sellLevelIndices) {
|
||||
if (this.config.direction === "long") break;
|
||||
if (this.shortExposure.has(level)) continue;
|
||||
const levelPrice = this.gridLevels[level]!;
|
||||
if (levelPrice <= price + halfTick) continue;
|
||||
if (remainingShort <= EPSILON) continue;
|
||||
const amount = Math.min(this.config.orderSize, remainingShort);
|
||||
if (amount <= EPSILON) continue;
|
||||
desired.push({
|
||||
level,
|
||||
side: "SELL",
|
||||
price: this.formatPrice(levelPrice),
|
||||
amount,
|
||||
intent: "ENTRY",
|
||||
reduceOnly: false,
|
||||
});
|
||||
remainingShort -= amount;
|
||||
}
|
||||
|
||||
const longByTarget = new Map<number, number>();
|
||||
for (const [sourceLevel, qty] of this.longExposure.entries()) {
|
||||
const target = this.levelMeta[sourceLevel]?.closeTarget;
|
||||
if (target == null) continue;
|
||||
longByTarget.set(target, (longByTarget.get(target) ?? 0) + qty);
|
||||
}
|
||||
for (const target of Array.from(longByTarget.keys()).sort((a, b) => a - b)) {
|
||||
desired.push({
|
||||
level: target,
|
||||
side: "SELL",
|
||||
price: this.formatPrice(this.gridLevels[target]!),
|
||||
amount: longByTarget.get(target)!,
|
||||
intent: "EXIT",
|
||||
reduceOnly: true,
|
||||
});
|
||||
}
|
||||
|
||||
const shortByTarget = new Map<number, number>();
|
||||
for (const [sourceLevel, qty] of this.shortExposure.entries()) {
|
||||
const target = this.levelMeta[sourceLevel]?.closeTarget;
|
||||
if (target == null) continue;
|
||||
shortByTarget.set(target, (shortByTarget.get(target) ?? 0) + qty);
|
||||
}
|
||||
for (const target of Array.from(shortByTarget.keys()).sort((a, b) => a - b)) {
|
||||
desired.push({
|
||||
level: target,
|
||||
side: "BUY",
|
||||
price: this.formatPrice(this.gridLevels[target]!),
|
||||
amount: shortByTarget.get(target)!,
|
||||
intent: "EXIT",
|
||||
reduceOnly: true,
|
||||
});
|
||||
}
|
||||
|
||||
return desired;
|
||||
}
|
||||
|
||||
// Legacy helper retained for tests and debug tooling.
|
||||
private async syncGrid(price: number): Promise<void> {
|
||||
this.syncLegacyExposureFromPosition();
|
||||
this.desiredOrders = this.computeDesiredOrders(price);
|
||||
this.lastUpdated = this.now();
|
||||
}
|
||||
|
||||
private syncLegacyExposureFromPosition(): void {
|
||||
const qty = this.position.positionAmt;
|
||||
if (!Number.isFinite(qty) || Math.abs(qty) <= EPSILON) {
|
||||
this.longExposure.clear();
|
||||
this.shortExposure.clear();
|
||||
return;
|
||||
}
|
||||
|
||||
if (qty > 0) {
|
||||
this.shortExposure.clear();
|
||||
this.longExposure.clear();
|
||||
let remaining = Math.abs(qty);
|
||||
for (const level of this.buyLevelIndices.slice().reverse()) {
|
||||
if (remaining <= EPSILON) break;
|
||||
const amount = Math.min(this.config.orderSize, remaining);
|
||||
this.longExposure.set(level, amount);
|
||||
remaining -= amount;
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
this.longExposure.clear();
|
||||
this.shortExposure.clear();
|
||||
let remaining = Math.abs(qty);
|
||||
for (const level of this.sellLevelIndices) {
|
||||
if (remaining <= EPSILON) break;
|
||||
const amount = Math.min(this.config.orderSize, remaining);
|
||||
this.shortExposure.set(level, amount);
|
||||
remaining -= amount;
|
||||
}
|
||||
}
|
||||
|
||||
private sumExposure(map: Map<number, number>): number {
|
||||
let total = 0;
|
||||
for (const qty of map.values()) total += qty;
|
||||
return total;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -3,6 +3,7 @@ import type { ExchangeAdapter } from "../exchanges/adapter";
|
||||
import type {
|
||||
AsterAccountSnapshot,
|
||||
AsterDepth,
|
||||
AsterKline,
|
||||
AsterOrder,
|
||||
AsterTicker,
|
||||
} from "../exchanges/types";
|
||||
|
||||
@@ -422,7 +422,7 @@ export class SwingEngine {
|
||||
: position.entryPrice * (1 + Math.max(0, this.config.stopLossPct));
|
||||
|
||||
const tick = Math.max(1e-9, this.config.priceTick);
|
||||
const lastPrice = referencePrice;
|
||||
const lastPrice = referencePrice ?? Number(this.tickerSnapshot?.lastPrice) ?? null;
|
||||
|
||||
// Kill-switch (always-on).
|
||||
const triggerKill =
|
||||
@@ -621,3 +621,4 @@ export class SwingEngine {
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -386,7 +386,7 @@ export class TrendEngine {
|
||||
private async enforceRateLimitStop(): Promise<void> {
|
||||
const position = getPosition(this.accountSnapshot, this.config.symbol);
|
||||
if (Math.abs(position.positionAmt) < 1e-5) return;
|
||||
const price = this.getReferencePrice();
|
||||
const price = this.getReferencePrice() ?? Number(this.tickerSnapshot?.lastPrice) ?? this.lastPrice;
|
||||
if (!Number.isFinite(price) || price == null) return;
|
||||
const result = await this.handlePositionManagement(position, Number(price));
|
||||
if (result.closed) {
|
||||
|
||||
@@ -1,254 +0,0 @@
|
||||
import { describe, expect, it, vi } from "vitest";
|
||||
import { executeCliCommand } from "../src/cli/command-executor";
|
||||
import type { ParsedCliCommand } from "../src/cli/command-types";
|
||||
import type { ExchangeAdapter } from "../src/exchanges/adapter";
|
||||
import type {
|
||||
AsterAccountSnapshot,
|
||||
AsterDepth,
|
||||
AsterKline,
|
||||
AsterOrder,
|
||||
AsterTicker,
|
||||
CreateOrderParams,
|
||||
} from "../src/exchanges/types";
|
||||
|
||||
class FakeAdapter implements ExchangeAdapter {
|
||||
readonly id = "aster";
|
||||
createOrderCalls = 0;
|
||||
cancelOrderCalls = 0;
|
||||
cancelOrdersCalls = 0;
|
||||
cancelAllOrdersCalls = 0;
|
||||
|
||||
supportsTrailingStops(): boolean {
|
||||
return true;
|
||||
}
|
||||
|
||||
watchAccount(cb: (snapshot: AsterAccountSnapshot) => void): void {
|
||||
cb({
|
||||
canTrade: true,
|
||||
canDeposit: true,
|
||||
canWithdraw: true,
|
||||
updateTime: Date.now(),
|
||||
totalWalletBalance: "100",
|
||||
totalUnrealizedProfit: "0",
|
||||
positions: [],
|
||||
assets: [],
|
||||
});
|
||||
}
|
||||
|
||||
watchOrders(cb: (orders: AsterOrder[]) => void): void {
|
||||
cb([]);
|
||||
}
|
||||
|
||||
watchDepth(_symbol: string, cb: (depth: AsterDepth) => void): void {
|
||||
cb({
|
||||
lastUpdateId: 1,
|
||||
bids: [["100", "1"]],
|
||||
asks: [["101", "1"]],
|
||||
});
|
||||
}
|
||||
|
||||
watchTicker(symbol: string, cb: (ticker: AsterTicker) => void): void {
|
||||
cb({
|
||||
symbol,
|
||||
lastPrice: "100",
|
||||
openPrice: "99",
|
||||
highPrice: "102",
|
||||
lowPrice: "98",
|
||||
volume: "10",
|
||||
quoteVolume: "1000",
|
||||
eventTime: Date.now(),
|
||||
} as AsterTicker);
|
||||
}
|
||||
|
||||
watchKlines(_symbol: string, _interval: string, cb: (klines: AsterKline[]) => void): void {
|
||||
cb([
|
||||
{
|
||||
openTime: 1,
|
||||
open: "100",
|
||||
high: "101",
|
||||
low: "99",
|
||||
close: "100",
|
||||
volume: "1",
|
||||
closeTime: 2,
|
||||
numberOfTrades: 1,
|
||||
},
|
||||
]);
|
||||
}
|
||||
|
||||
async createOrder(params: CreateOrderParams): Promise<AsterOrder> {
|
||||
this.createOrderCalls += 1;
|
||||
return {
|
||||
orderId: "1",
|
||||
clientOrderId: "1",
|
||||
symbol: params.symbol,
|
||||
side: params.side,
|
||||
type: params.type,
|
||||
status: "NEW",
|
||||
price: String(params.price ?? 0),
|
||||
origQty: String(params.quantity ?? 0),
|
||||
executedQty: "0",
|
||||
stopPrice: String(params.stopPrice ?? 0),
|
||||
time: Date.now(),
|
||||
updateTime: Date.now(),
|
||||
reduceOnly: params.reduceOnly === "true",
|
||||
closePosition: params.closePosition === "true",
|
||||
};
|
||||
}
|
||||
|
||||
async cancelOrder(): Promise<void> {
|
||||
this.cancelOrderCalls += 1;
|
||||
}
|
||||
|
||||
async cancelOrders(): Promise<void> {
|
||||
this.cancelOrdersCalls += 1;
|
||||
}
|
||||
|
||||
async cancelAllOrders(): Promise<void> {
|
||||
this.cancelAllOrdersCalls += 1;
|
||||
}
|
||||
}
|
||||
|
||||
function common(overrides: Partial<ParsedCliCommand> = {}): any {
|
||||
return {
|
||||
json: true,
|
||||
dryRun: false,
|
||||
timeoutMs: 1000,
|
||||
...overrides,
|
||||
};
|
||||
}
|
||||
|
||||
describe("command executor", () => {
|
||||
it("executes market ticker command", async () => {
|
||||
const adapter = new FakeAdapter();
|
||||
const command: ParsedCliCommand = {
|
||||
kind: "market-ticker",
|
||||
...common({
|
||||
exchange: "aster",
|
||||
symbol: "BTCUSDT",
|
||||
}),
|
||||
};
|
||||
|
||||
const result = await executeCliCommand(command, {
|
||||
buildAdapterFromEnvFn: () => adapter,
|
||||
});
|
||||
|
||||
expect(result.exitCode).toBe(0);
|
||||
expect(result.payload.success).toBe(true);
|
||||
if (result.payload.success) {
|
||||
expect((result.payload.data as any).ticker.symbol).toBe("BTCUSDT");
|
||||
}
|
||||
});
|
||||
|
||||
it("uses dry-run wrapper for order create", async () => {
|
||||
const adapter = new FakeAdapter();
|
||||
const command: ParsedCliCommand = {
|
||||
kind: "order-create",
|
||||
...common({
|
||||
exchange: "aster",
|
||||
symbol: "BTCUSDT",
|
||||
dryRun: true,
|
||||
}),
|
||||
payload: {
|
||||
side: "BUY",
|
||||
type: "limit",
|
||||
quantity: 0.01,
|
||||
price: 100000,
|
||||
},
|
||||
};
|
||||
|
||||
const result = await executeCliCommand(command, {
|
||||
buildAdapterFromEnvFn: () => adapter,
|
||||
});
|
||||
|
||||
expect(result.exitCode).toBe(0);
|
||||
expect(adapter.createOrderCalls).toBe(0);
|
||||
expect(result.payload.success).toBe(true);
|
||||
if (result.payload.success) {
|
||||
const data = result.payload.data as any;
|
||||
expect(Array.isArray(data.dryRunActions)).toBe(true);
|
||||
expect(data.dryRunActions.length).toBeGreaterThan(0);
|
||||
}
|
||||
});
|
||||
|
||||
it("uses dry-run wrapper for order cancel", async () => {
|
||||
const adapter = new FakeAdapter();
|
||||
const command: ParsedCliCommand = {
|
||||
kind: "order-cancel",
|
||||
...common({
|
||||
exchange: "aster",
|
||||
symbol: "BTCUSDT",
|
||||
dryRun: true,
|
||||
}),
|
||||
orderId: "abc",
|
||||
};
|
||||
|
||||
const result = await executeCliCommand(command, {
|
||||
buildAdapterFromEnvFn: () => adapter,
|
||||
});
|
||||
|
||||
expect(result.exitCode).toBe(0);
|
||||
expect(adapter.cancelOrderCalls).toBe(0);
|
||||
expect(result.payload.success).toBe(true);
|
||||
});
|
||||
|
||||
it("returns unsupported for order-open when queryOpenOrders is unavailable", async () => {
|
||||
const adapter = new FakeAdapter();
|
||||
const command: ParsedCliCommand = {
|
||||
kind: "order-open",
|
||||
...common({
|
||||
exchange: "aster",
|
||||
}),
|
||||
};
|
||||
|
||||
const result = await executeCliCommand(command, {
|
||||
buildAdapterFromEnvFn: () => adapter,
|
||||
});
|
||||
|
||||
expect(result.exitCode).toBe(5);
|
||||
expect(result.payload.success).toBe(false);
|
||||
if (!result.payload.success) {
|
||||
expect(result.payload.error.code).toBe("UNSUPPORTED");
|
||||
}
|
||||
});
|
||||
|
||||
it("passes dryRun to strategy runner", async () => {
|
||||
const startStrategyFn = vi.fn(async () => undefined);
|
||||
const command: ParsedCliCommand = {
|
||||
kind: "strategy-run",
|
||||
...common({
|
||||
exchange: "aster",
|
||||
dryRun: true,
|
||||
}),
|
||||
strategy: "trend",
|
||||
silent: true,
|
||||
};
|
||||
|
||||
const result = await executeCliCommand(command, {
|
||||
startStrategyFn,
|
||||
});
|
||||
|
||||
expect(result.exitCode).toBe(0);
|
||||
expect(startStrategyFn).toHaveBeenCalledWith("trend", { silent: true, dryRun: true });
|
||||
});
|
||||
|
||||
it("falls back to static capabilities when adapter creation fails", async () => {
|
||||
const command: ParsedCliCommand = {
|
||||
kind: "exchange-capabilities",
|
||||
...common({
|
||||
exchange: "binance",
|
||||
}),
|
||||
};
|
||||
|
||||
const result = await executeCliCommand(command, {
|
||||
buildAdapterFromEnvFn: () => {
|
||||
throw new Error("Missing BINANCE_API_KEY environment variable");
|
||||
},
|
||||
});
|
||||
|
||||
expect(result.exitCode).toBe(0);
|
||||
expect(result.payload.success).toBe(true);
|
||||
if (result.payload.success) {
|
||||
expect((result.payload.data as any).source).toBe("static");
|
||||
}
|
||||
});
|
||||
});
|
||||
@@ -1,87 +0,0 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
import { CommandParseError, parseCommandArgv } from "../src/cli/command-parser";
|
||||
|
||||
describe("command parser", () => {
|
||||
it("returns null for legacy flag-only argv", () => {
|
||||
expect(parseCommandArgv(["--strategy", "trend"])).toBeNull();
|
||||
});
|
||||
|
||||
it("parses doctor command with global options", () => {
|
||||
const command = parseCommandArgv(["doctor", "--json", "--dry-run", "--timeout", "1000"]);
|
||||
expect(command).toMatchObject({
|
||||
kind: "doctor",
|
||||
json: true,
|
||||
dryRun: true,
|
||||
timeoutMs: 1000,
|
||||
});
|
||||
});
|
||||
|
||||
it("parses market kline command", () => {
|
||||
const command = parseCommandArgv([
|
||||
"market",
|
||||
"kline",
|
||||
"--exchange",
|
||||
"binance",
|
||||
"--symbol",
|
||||
"BTCUSDT_PERP",
|
||||
"--interval",
|
||||
"1m",
|
||||
"--limit",
|
||||
"10",
|
||||
]);
|
||||
expect(command).toMatchObject({
|
||||
kind: "market-kline",
|
||||
exchange: "binance",
|
||||
symbol: "BTCUSDT_PERP",
|
||||
interval: "1m",
|
||||
limit: 10,
|
||||
});
|
||||
});
|
||||
|
||||
it("parses order create trailing-stop command", () => {
|
||||
const command = parseCommandArgv([
|
||||
"order",
|
||||
"create",
|
||||
"--exchange",
|
||||
"grv",
|
||||
"--symbol",
|
||||
"BTCUSDT",
|
||||
"--side",
|
||||
"sell",
|
||||
"--type",
|
||||
"trailing-stop",
|
||||
"--qty",
|
||||
"0.01",
|
||||
"--activation-price",
|
||||
"101000",
|
||||
"--callback-rate",
|
||||
"0.2",
|
||||
"--dry-run",
|
||||
]);
|
||||
expect(command).toMatchObject({
|
||||
kind: "order-create",
|
||||
exchange: "grvt",
|
||||
symbol: "BTCUSDT",
|
||||
dryRun: true,
|
||||
payload: {
|
||||
side: "SELL",
|
||||
type: "trailing-stop",
|
||||
quantity: 0.01,
|
||||
activationPrice: 101000,
|
||||
callbackRate: 0.2,
|
||||
},
|
||||
});
|
||||
});
|
||||
|
||||
it("parses strategy run command with alias strategy", () => {
|
||||
const command = parseCommandArgv(["strategy", "run", "--strategy", "offset"]);
|
||||
expect(command).toMatchObject({
|
||||
kind: "strategy-run",
|
||||
strategy: "offset-maker",
|
||||
});
|
||||
});
|
||||
|
||||
it("throws for unsupported option", () => {
|
||||
expect(() => parseCommandArgv(["doctor", "--unknown"])).toThrow(CommandParseError);
|
||||
});
|
||||
});
|
||||
@@ -1,55 +0,0 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
import { DryRunExchangeAdapter } from "../src/exchanges/dry-run-adapter";
|
||||
import type { ExchangeAdapter } from "../src/exchanges/adapter";
|
||||
import type {
|
||||
AsterAccountSnapshot,
|
||||
AsterDepth,
|
||||
AsterKline,
|
||||
AsterOrder,
|
||||
AsterTicker,
|
||||
CreateOrderParams,
|
||||
} from "../src/exchanges/types";
|
||||
|
||||
class BaseAdapter implements ExchangeAdapter {
|
||||
readonly id = "aster";
|
||||
createCalls = 0;
|
||||
|
||||
supportsTrailingStops(): boolean {
|
||||
return true;
|
||||
}
|
||||
|
||||
watchAccount(_cb: (snapshot: AsterAccountSnapshot) => void): void {}
|
||||
watchOrders(_cb: (orders: AsterOrder[]) => void): void {}
|
||||
watchDepth(_symbol: string, _cb: (depth: AsterDepth) => void): void {}
|
||||
watchTicker(_symbol: string, _cb: (ticker: AsterTicker) => void): void {}
|
||||
watchKlines(_symbol: string, _interval: string, _cb: (klines: AsterKline[]) => void): void {}
|
||||
|
||||
async createOrder(_params: CreateOrderParams): Promise<AsterOrder> {
|
||||
this.createCalls += 1;
|
||||
throw new Error("should not be called in dry-run");
|
||||
}
|
||||
|
||||
async cancelOrder(): Promise<void> {}
|
||||
async cancelOrders(): Promise<void> {}
|
||||
async cancelAllOrders(): Promise<void> {}
|
||||
}
|
||||
|
||||
describe("DryRunExchangeAdapter", () => {
|
||||
it("simulates create order and records actions", async () => {
|
||||
const base = new BaseAdapter();
|
||||
const dry = new DryRunExchangeAdapter(base);
|
||||
|
||||
const order = await dry.createOrder({
|
||||
symbol: "BTCUSDT",
|
||||
side: "BUY",
|
||||
type: "LIMIT",
|
||||
quantity: 0.01,
|
||||
price: 100000,
|
||||
});
|
||||
|
||||
expect(base.createCalls).toBe(0);
|
||||
expect(order.orderId).toMatch(/^dry-run-/);
|
||||
expect(dry.actions.length).toBe(1);
|
||||
expect(dry.actions[0]?.method).toBe("createOrder");
|
||||
});
|
||||
});
|
||||
@@ -1,4 +1,4 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
import { describe, expect, it, vi } from "vitest";
|
||||
import type { ExchangeAdapter } from "../src/exchanges/adapter";
|
||||
import type {
|
||||
AsterAccountSnapshot,
|
||||
@@ -365,7 +365,7 @@ describe("GridEngine", () => {
|
||||
(engine as any).stopReason = "test stop";
|
||||
await (engine as any).haltGrid(90);
|
||||
|
||||
expect(adapter.cancelAllCount).toBeGreaterThanOrEqual(1);
|
||||
expect(adapter.cancelAllCount).toBe(1);
|
||||
expect(adapter.marketOrders).toHaveLength(1);
|
||||
expect(engine.getSnapshot().running).toBe(false);
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@ import { LighterSigner } from "../../src/exchanges/lighter/signer";
|
||||
import { LIGHTER_ORDER_TYPE, LIGHTER_TIME_IN_FORCE } from "../../src/exchanges/lighter/constants";
|
||||
|
||||
describe("LighterSigner", () => {
|
||||
it("produces deterministic create order signature", async () => {
|
||||
it("produces deterministic create order signature", () => {
|
||||
const signer = new LighterSigner({
|
||||
accountIndex: 65,
|
||||
chainId: 300,
|
||||
@@ -12,7 +12,7 @@ describe("LighterSigner", () => {
|
||||
},
|
||||
});
|
||||
|
||||
const signed = await signer.signCreateOrder({
|
||||
const signed = signer.signCreateOrder({
|
||||
marketIndex: 0,
|
||||
clientOrderIndex: 123n,
|
||||
baseAmount: 1000n,
|
||||
@@ -31,7 +31,7 @@ describe("LighterSigner", () => {
|
||||
const payload = JSON.parse(signed.txInfo);
|
||||
expect(payload.AccountIndex).toBe(65);
|
||||
expect(payload.ApiKeyIndex).toBe(3);
|
||||
expect(payload).toMatchObject({
|
||||
expect(payload.OrderInfo).toMatchObject({
|
||||
MarketIndex: 0,
|
||||
ClientOrderIndex: 123,
|
||||
BaseAmount: 1000,
|
||||
@@ -45,10 +45,7 @@ describe("LighterSigner", () => {
|
||||
});
|
||||
expect(typeof payload.Sig).toBe("string");
|
||||
expect(payload.Sig.length).toBeGreaterThan(0);
|
||||
if (signed.txHash) {
|
||||
expect(typeof signed.txHash).toBe("string");
|
||||
expect(signed.txHash.length).toBeGreaterThan(0);
|
||||
}
|
||||
expect(signed.txHash).toBe("3ef41bc5fdb2e2146b5f5df046fb1ad801dc2aa5c47703665bfd3eb67a21e67048957f7187b12035");
|
||||
expect(typeof signed.signature).toBe("string");
|
||||
expect(signed.signature.length).toBeGreaterThan(0);
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user