forgex-cli 1.0.34 → 1.0.35

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +17 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -243,6 +243,12 @@ forgex transfer in --to <目标地址> --from-group 1 --amount all
243
243
  - `--bundle-time`: `T0`(同区块) / `T1_T5`
244
244
  - `--use-suffix`: 使用自定义后缀地址
245
245
 
246
+ **T0 同区块狙击规则:**
247
+ - 当 `--bundle-time T0` 时,sniper 买入**必须**通过 Jito Bundle 在同一区块完成,**不允许**使用普通 `trade buy` 补单(那样会落在后续区块,失去 T0 意义)
248
+ - Jito tip(`--priority-fee`)默认 0.0001 SOL。如果 Bundle 落地失败,应逐步上调 tip:0.0001 → 0.0003 → 0.0005 → 0.001
249
+ - **Jito tip 上限为 0.001 SOL**,除非用户明确要求设置更高值
250
+ - T1_T5 模式允许跨区块买入,对 Jito tip 要求较低
251
+
246
252
  ---
247
253
 
248
254
  ### query -- 查询操作
@@ -485,6 +491,17 @@ ForgeX CLI 支持 AI Agent(如 OpenClaw)无交互式调用。
485
491
  - Agent 应始终使用 `--format json`(默认值),以便解析结构化输出
486
492
  - 首次执行高风险操作前应使用 `--dry-run` 模拟验证
487
493
 
494
+ ### T0 同区块发币规则(Agent 必须遵守)
495
+
496
+ 1. **T0 模式下 sniper 必须通过 Jito Bundle 买入**,禁止使用 `trade buy` 补单(会落在后续区块,失去同区块狙击的意义)
497
+ 2. **Jito tip 递增策略**:默认 `--priority-fee 0.0001`,Bundle 落地失败时逐步上调:
498
+ - 第1次:0.0001 SOL
499
+ - 第2次:0.0003 SOL
500
+ - 第3次:0.0005 SOL
501
+ - 第4次:0.001 SOL(上限)
502
+ 3. **Jito tip 硬上限为 0.001 SOL**,除非用户明确要求更高值
503
+ 4. 如果达到上限仍失败,应停止重试并告知用户,而非自动切换到普通交易
504
+
488
505
  ### 示例工作流
489
506
 
490
507
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "forgex-cli",
3
- "version": "1.0.34",
3
+ "version": "1.0.35",
4
4
  "description": "ForgeX CLI - Solana on-chain market making system command-line tool",
5
5
  "type": "module",
6
6
  "author": "cat",