Back to Details

jingswap

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Jingswap Skill

Jingswap Skill

Blind batch auction for swapping sBTC against a quote token on Stacks. Two markets are available:
MarketContractQuote Token
sbtc-stx
(default)
SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-stx-jing
STX
sbtc-usdcx
SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-usdcx-jing
USDCx
Each auction cycle has three phases: deposit, buffer, settle. Anyone can participate by depositing on either side, and anyone can trigger close/settle/cancel transitions.
在Stacks链上进行sBTC与报价代币兑换的盲批拍卖。目前支持两个交易对：
交易对合约地址报价代币
sbtc-stx
（默认）
SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-stx-jing
STX
sbtc-usdcx
SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-usdcx-jing
USDCx
每个拍卖周期分为三个阶段：存款阶段、缓冲阶段、结算阶段。任何人都可以通过在任意一端存入资产参与拍卖，也可以触发结束/结算/取消等状态转换。

Usage

使用方法

bun run jingswap/jingswap.ts <subcommand> [--market <pair>] [options]
All commands accept 
--market sbtc-stx
(default) or 
--market sbtc-usdcx
.
bun run jingswap/jingswap.ts <子命令> [--market <交易对>] [选项]
所有命令均支持
--market sbtc-stx
（默认）或
--market sbtc-usdcx
参数。

Subcommands

子命令

cycle-state

cycle-state

Get current auction cycle state (phase, blocks elapsed, totals, minimums).
bun run jingswap/jingswap.ts cycle-state --market sbtc-usdcx
获取当前拍卖周期的状态（阶段、已过区块数、总存款额、最低要求）。
bun run jingswap/jingswap.ts cycle-state --market sbtc-usdcx

depositors

depositors

Get quote-token and sBTC depositors for a cycle.
bun run jingswap/jingswap.ts depositors --cycle <number> --market sbtc-stx
获取某一周期内的报价代币和sBTC存款方信息。
bun run jingswap/jingswap.ts depositors --cycle <周期编号> --market sbtc-stx

user-deposit

user-deposit

Get a user's deposit amounts for a cycle.
bun run jingswap/jingswap.ts user-deposit --cycle <number> --address <stx_address>
获取某一用户在指定周期内的存款金额。
bun run jingswap/jingswap.ts user-deposit --cycle <周期编号> --address <stx地址>

settlement

settlement

Get settlement details for a completed cycle.
bun run jingswap/jingswap.ts settlement --cycle <number>
获取已完成周期的结算详情。
bun run jingswap/jingswap.ts settlement --cycle <周期编号>

cycles-history

cycles-history

Get full history of all auction cycles.
bun run jingswap/jingswap.ts cycles-history --market sbtc-usdcx
获取所有拍卖周期的完整历史记录。
bun run jingswap/jingswap.ts cycles-history --market sbtc-usdcx

user-activity

user-activity

Get a user's auction activity (deposits, cancellations, fills, rollovers).
bun run jingswap/jingswap.ts user-activity --address <stx_address> --market sbtc-usdcx
获取某一用户的拍卖活动记录（存款、取消、成交、结转）。
bun run jingswap/jingswap.ts user-activity --address <stx地址> --market sbtc-usdcx

prices

prices

Get oracle and DEX prices (Pyth, XYK pool, DLMM).
bun run jingswap/jingswap.ts prices
获取预言机和去中心化交易所的价格（Pyth、XYK池、DLMM）。
bun run jingswap/jingswap.ts prices

deposit-stx

deposit-stx

Deposit quote token (STX or USDCx depending on market) into the current auction cycle. Deposit phase only.
bun run jingswap/jingswap.ts deposit-stx --amount 10 --market sbtc-usdcx
在当前拍卖周期存入报价代币（根据交易对不同为STX或USDCx）。仅可在存款阶段执行。
bun run jingswap/jingswap.ts deposit-stx --amount 10 --market sbtc-usdcx

deposit-sbtc

deposit-sbtc

Deposit sBTC (in satoshis) into the current auction cycle. Deposit phase only.
bun run jingswap/jingswap.ts deposit-sbtc --amount 10000 --market sbtc-usdcx
在当前拍卖周期存入sBTC（单位为聪）。仅可在存款阶段执行。
bun run jingswap/jingswap.ts deposit-sbtc --amount 10000 --market sbtc-usdcx

cancel-stx

cancel-stx

Cancel your quote-token deposit and get a refund. Deposit phase only.
bun run jingswap/jingswap.ts cancel-stx --market sbtc-usdcx
取消你的报价代币存款并获得退款。仅可在存款阶段执行。
bun run jingswap/jingswap.ts cancel-stx --market sbtc-usdcx

cancel-sbtc

cancel-sbtc

Cancel your sBTC deposit and get a refund. Deposit phase only.
bun run jingswap/jingswap.ts cancel-sbtc
取消你的sBTC存款并获得退款。仅可在存款阶段执行。
bun run jingswap/jingswap.ts cancel-sbtc

close-deposits

close-deposits

Close the deposit phase (requires min 150 blocks elapsed, both sides above minimum).
bun run jingswap/jingswap.ts close-deposits --market sbtc-usdcx
结束存款阶段（要求至少经过150个区块，且双方存款均满足最低要求）。
bun run jingswap/jingswap.ts close-deposits --market sbtc-usdcx

settle

settle

Settle using stored Pyth prices (free). Usually fails due to stale prices — prefer settle-with-refresh.
bun run jingswap/jingswap.ts settle
使用已存储的Pyth价格进行结算（免费）。通常会因价格过期失败——推荐使用settle-with-refresh命令。
bun run jingswap/jingswap.ts settle

settle-with-refresh

settle-with-refresh

Settle with fresh Pyth VAAs (~2 uSTX). Recommended settlement method.
bun run jingswap/jingswap.ts settle-with-refresh --market sbtc-usdcx
使用最新的Pyth VAAs进行结算（约2 uSTX手续费）。推荐的结算方式。
bun run jingswap/jingswap.ts settle-with-refresh --market sbtc-usdcx

cancel-cycle

cancel-cycle

Cancel cycle if settlement failed after 530 blocks (~17.5 min). Rolls deposits to next cycle.
bun run jingswap/jingswap.ts cancel-cycle
若结算在结束后530个区块（约17.5分钟）仍未完成，则取消该周期。存款将结转至下一周期。
bun run jingswap/jingswap.ts cancel-cycle

Notes

注意事项

  • Stacks blocks average ~2 seconds (Nakamoto)
  • Deposit phase: min 150 blocks (~5 min) before close
  • Buffer phase: 30 blocks (~1 min) after close
  • Cancel threshold: 530 blocks (~17.5 min) from close
  • distribute
    events show swap proceeds + unswapped remainder (rolled to next cycle, not refunded)
  • Post conditions: deposits use Deny mode; cancel/settle/cancel-cycle use Allow mode
  • USDCx is a stablecoin (~$1) — 
    SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx
    , asset 
    usdcx-token
    , 6 decimals
  • Stacks区块平均约2秒（Nakamoto共识）
  • 存款阶段：结束前至少需经过150个区块（约5分钟）
  • 缓冲阶段：结束存款后持续30个区块（约1分钟）
  • 取消阈值：自存款结束后530个区块（约17.5分钟）
  • distribute
    事件会显示兑换收益+未兑换剩余资产（将结转至下一周期，不予退款）
  • 后置条件：存款操作使用Deny模式；取消/结算/取消周期操作使用Allow模式
  • USDCx是一种稳定币（约合1美元）——合约地址
    SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx
    ，资产标识
    usdcx-token
    ，精度为6位小数