关于 jingswap
jingswap 是用于 Stacks 上 sBTC 与报价代币盲批量拍卖的命令行技能，支持 STX 和 USDCx 市场。它提供周期状态、用户活动、价格查询及存款、撤销和结算操作。
主要功能
- 01查询拍卖周期状态与历史
- 02查看存款方及用户存款
- 03查看结算详情和用户活动
- 04查询 Pyth 与 DEX 价格
- 05提交或撤销代币存款
- 06关闭、结算或取消周期
适用场景
- 01检查当前拍卖阶段和最低额度
- 02核对用户在某周期的存款
- 03参与 sBTC 与 STX 或 USDCx 交换
- 04查询价格并执行周期结算
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/jingswap确认已加载。
附带文件AGENT.mdjingswap.ts
详细介绍
Jingswap 技能
在 Stacks 上通过盲批次拍卖，将 sBTC 兑换为报价代币。提供两个市场：
| 市场 | 合约 | 报价代币 |
|---|---|---|
sbtc-stx（默认） | SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-stx-jing | STX |
sbtc-usdcx | SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-usdcx-jing | USDCx |
每个拍卖周期分为三个阶段：存入、缓冲、结算。任何人都可以存入任一侧参与，任何人都可以触发关闭、结算或取消状态转换。
用法
bun run jingswap/jingswap.ts <subcommand> [--market <pair>] [options]
所有命令都接受 --market sbtc-stx（默认）或 --market sbtc-usdcx。
子命令
cycle-state
获取当前拍卖周期的状态（阶段、已过区块数、总额、最低金额）。
bun run jingswap/jingswap.ts cycle-state --market sbtc-usdcx
depositors
获取某个周期的报价代币和 sBTC 存入者。
bun run jingswap/jingswap.ts depositors --cycle <number> --market sbtc-stx
user-deposit
获取某个用户在某个周期的存入金额。
bun run jingswap/jingswap.ts user-deposit --cycle <number> --address <stx_address>
settlement
获取已完成周期的结算详情。
bun run jingswap/jingswap.ts settlement --cycle <number>
cycles-history
获取所有拍卖周期的完整历史记录。
bun run jingswap/jingswap.ts cycles-history --market sbtc-usdcx
user-activity
获取某个用户的拍卖活动（存入、取消、成交、转入下一周期）。
bun run jingswap/jingswap.ts user-activity --address <stx_address> --market sbtc-usdcx
prices
获取预言机和 DEX 价格（Pyth、XYK 池、DLMM）。
bun run jingswap/jingswap.ts prices
deposit-stx
将报价代币（取决于市场，为 STX 或 USDCx）存入当前拍卖周期。仅限存入阶段。
bun run jingswap/jingswap.ts deposit-stx --amount 10 --market sbtc-usdcx
deposit-sbtc
将 sBTC（以聪为单位）存入当前拍卖周期。仅限存入阶段。
bun run jingswap/jingswap.ts deposit-sbtc --amount 10000 --market sbtc-usdcx
cancel-stx
取消你的报价代币存入并获得退款。仅限存入阶段。
bun run jingswap/jingswap.ts cancel-stx --market sbtc-usdcx
cancel-sbtc
取消你的 sBTC 存入并获得退款。仅限存入阶段。
bun run jingswap/jingswap.ts cancel-sbtc
close-deposits
关闭存入阶段（要求至少经过 150 个区块，且两侧金额均高于最低要求）。
bun run jingswap/jingswap.ts close-deposits --market sbtc-usdcx
settle
使用已存储的 Pyth 价格进行结算（免费）。通常会因价格过期而失败，建议使用 settle-with-refresh。
bun run jingswap/jingswap.ts settle
settle-with-refresh
使用最新的 Pyth VAA 进行结算（约 2 uSTX）。推荐的结算方式。
bun run jingswap/jingswap.ts settle-with-refresh --market sbtc-usdcx
cancel-cycle
若 530 个区块（约 17.5 分钟）后结算仍失败，则取消该周期。存入金额将转入下一周期。
bun run jingswap/jingswap.ts cancel-cycle
备注
- Stacks 区块平均约 2 秒（Nakamoto）
- 存入阶段：至少经过 150 个区块（约 5 分钟）后才能关闭
- 缓冲阶段：关闭后持续 30 个区块（约 1 分钟）
- 取消阈值：关闭后经过 530 个区块（约 17.5 分钟）
distribute事件会显示兑换所得和未兑换余额（转入下一周期，不予退款）- 后置条件：存入使用 Deny 模式；取消、结算和取消周期使用 Allow 模式
- USDCx 是稳定币（约 $1）—
SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx，资产usdcx-token，精度为 6 位小数