mcpField
J
jingswap-cycle-agent

jingswap-cycle-agent

github.com/aibtcdev其他1146 次安装1 天前更新
代码仓库

关于 jingswap-cycle-agent

jingswap-cycle-agent 是监控和分析 JingSwap 当前周期的只读技能。它比较 Pyth 结算率与实时 DEX 价格，并可在满足阈值时准备存款参数；执行前须由上级 Agent 确认。

主要功能

  1. 01读取实时 JingSwap 周期状态
  2. 02比较 Pyth 汇率与 DLMM、XYK 价格
  3. 03按阈值评估入场机会
  4. 04准备供上级 Agent 审核的存款参数
  5. 05以 JSON 返回状态和操作结果

适用场景

  1. 01监控周期是否开放存款
  2. 02评估预言机汇率相对 DEX 价格的折让
  3. 03准备待人工批准执行的 STX 存款

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aibtcdev/skills --skill jingswap-cycle-agent

安装后在 Claude Code 中输入/jingswap-cycle-agent确认已加载。

附带文件AGENT.mdjingswap-cycle-agent.ts

详细介绍

jingswap-cycle-agent

功能

监控当前 JingSwap 周期，并评估 Pyth 预言机结算汇率相较于 DEX 实时价格，是否提供了有利的 sBTC 买入机会。

数据源读取内容重要性
sbtc-stx-jing-v2 合约（Hiro 只读 API）周期 ID、阶段、已过区块数、存款、最低要求当前是否处于存款阶段？是否有 sBTC 可用？
Pyth Hermes 预言机BTC/USD 和 STX/USD 实时价格计算预言机 STX/sBTC 结算汇率
get-dlmm-price（合约）DLMM 池价格（1e10 / 原始值）用于比较的最佳 DEX 汇率
get-xyk-price（合约）XYK 池价格（原始值 / 1e8）用于交叉验证的次级 DEX 汇率

JingSwap 按 Pyth 预言机汇率结算，而非 DEX 汇率。预言机汇率低于 DEX 汇率时，存入 STX 获取 sBTC 会比在市场上买入更便宜——这就是套利窗口。此技能可实时量化这一价差。

Agent 为何需要它

JingSwap 的 API（faktory-dao-backend.vercel.app）需要 x-api-key。此技能完全绕过该 API，直接通过公开的 Hiro 只读端点读取 Stacks 合约。无需凭据。

analyze 命令会将周期状态和两个价格来源汇总为一个 action 字段——Agent 无需了解合约编码或 Pyth 喂价 ID。

安全说明

  • doctor、status、analyze 为只读操作——无需钱包。
  • participate（不带 --dry-run）会输出 DEPOSIT_READY JSON 负载——父级 Agent 必须先确认，才能调用 jingswap_deposit_stx。
  • 仅限主网——JingSwap v2 合约仅部署在主网上。
  • 始终读取实时合约数据——绝不缓存周期状态。

命令

doctor

检查 Hiro 合约 API 和 Pyth Hermes 的连接情况。

bun run jingswap-cycle-agent/jingswap-cycle-agent.ts doctor

输出：

{
  "result": "ready",
  "checks": {
    "hiro_contract_api": "ok",
    "pyth_hermes_api": "ok"
  },
  "contract": "SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-stx-jing-v2"
}
status

获取完整周期状态和价格快照。

bun run jingswap-cycle-agent/jingswap-cycle-agent.ts status

输出：

{
  "skill": "jingswap-cycle-agent",
  "timestamp": "2026-03-29T15:22:18.792Z",
  "contract": "SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-stx-jing-v2",
  "cycle": {
    "id": 9,
    "phase": "deposit",
    "blocks_elapsed": 191,
    "sbtc_deposited": "0.01929494 sBTC",
    "stx_deposited": "0.00 STX",
    "min_stx_deposit": "1.00 STX",
    "min_sbtc_deposit": "0.00001000 sBTC"
  },
  "prices": {
    "btc_usd": "66488.42",
    "stx_usd": "0.216440",
    "oracle_stx_per_sbtc": "307191.64",
    "dex_stx_per_sbtc_dlmm": "305922.66",
    "dex_stx_per_sbtc_xyk": "305306.01",
    "oracle_vs_dex_discount_pct": "-0.394"
  },
  "summary": "Cycle 9 in deposit phase. Oracle 0.39% MORE EXPENSIVE than DEX."
}
analyze

评估当前周期是否提供有利的入场机会。

bun run jingswap-cycle-agent/jingswap-cycle-agent.ts analyze
bun run jingswap-cycle-agent/jingswap-cycle-agent.ts analyze --min-discount 2.0

选项：

  • --min-discount <pct>（默认值：1.0）——触发 PARTICIPATE 所需的最低预言机折价幅度（相对于 DEX）

输出：

{
  "skill": "jingswap-cycle-agent",
  "timestamp": "2026-03-29T15:22:27.573Z",
  "contract": "SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-stx-jing-v2",
  "input": { "min_discount_pct": 1 },
  "cycle": {
    "id": 9,
    "phase": "deposit",
    "sbtc_available": "0.01929494 sBTC",
    "stx_deposited": "0.00 STX"
  },
  "pricing": {
    "oracle_stx_per_sbtc": "307148.46",
    "dex_stx_per_sbtc": "305922.66",
    "discount_pct": "-0.401"
  },
  "action": "MONITOR",
  "confidence": "high",
  "is_favourable": false,
  "rationale": "Oracle rate (307148 STX/sBTC) is 0.40% MORE expensive than DEX (305923 STX/sBTC). Spread does not meet minimum discount threshold of 1%.",
  "summary": "MONITOR (high confidence) — cycle 9 (deposit), oracle 0.40% premium vs DEX."
}
participate

评估机会，并在条件有利时为父级 Agent 准备存款参数以供执行。

bun run jingswap-cycle-agent/jingswap-cycle-agent.ts participate --amount-stx 100
bun run jingswap-cycle-agent/jingswap-cycle-agent.ts participate --amount-stx 100 --min-discount 2.0 --dry-run

选项：

  • --amount-stx <amount>（必填）——要存入的 STX 数量
  • --min-discount <pct>（默认值：1.0）——继续操作所需的最低折价幅度
  • --dry-run——仅进行分析，不输出执行负载

条件有利时，输出：

{
  "skill": "jingswap-cycle-agent",
  "action": "DEPOSIT_READY",
  "deposit_params": {
    "amount_stx": 100,
    "amount_micro_stx": 100000000,
    "market": "sbtc-stx",
    "cycle": 9
  },
  "instruction": "Parent agent: call jingswap_deposit_stx with amount=100000000 and market=sbtc-stx to execute this deposit. Confirm before proceeding."
}

Action 值

Action含义
PARTICIPATE预言机汇率比 DEX 汇率低至少 min-discount——存入 STX，以低于市场价的价格获取 sBTC
MONITOR存在价差，但低于阈值——继续观察并重试
WAIT_FOR_DEPOSIT_PHASE周期处于缓冲或结算阶段——已停止接受存款
NO_SBTC_AVAILABLE当前周期没有存入 sBTC——没有可获取的 sBTC

置信度：

  • high——折价幅度 ≥ 2%，或情况明显不利
  • medium——折价幅度为 1–2%
  • low——处于临界范围

技术说明

  • 合约：SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-stx-jing-v2（v2，当前版本；v1 曾用于第 5 个周期）
  • DLMM 价格公式：STX/sBTC = 1e10 / dlmmRaw（合约存储的是反向比率）
  • XYK 价格公式：STX/sBTC = xykRaw / 1e8（合约存储的是带有 1e8 精度的正向比率）
  • 预言机价格：Pyth Hermes BTC/USD ÷ STX/USD = STX/sBTC
  • 所有数据源均无需 API 密钥
  • 所有 Hiro 读取请求均使用发送方 SP000000000000000000002Q6VF78（销毁地址，可用于只读调用）

输出约定

所有输出均为 JSON，写入 stdout。

错误：

{ "error": "descriptive message" }

来源

AIBTC x Bitflow Skills Pay the Bills 竞赛获奖作品。 原作者：@teflonmusk 竞赛 PR：https://github.com/BitflowFinance/bff-skills/pull/78

评论

支持 Markdown