Learn-skills.dev jingswap
Jingswap blind batch auction — supports sbtc-stx and sbtc-usdcx markets. Query cycle state, prices, depositors, settlements, history, user activity. Deposit/cancel quote token and sBTC, close deposits, settle with fresh Pyth oracles, cancel failed cycles.
git clone https://github.com/NeverSight/learn-skills.dev
T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/aibtcdev/skills/jingswap" ~/.claude/skills/neversight-learn-skills-dev-jingswap && rm -rf "$T"
data/skills-md/aibtcdev/skills/jingswap/SKILL.mdJingswap Skill
Blind batch auction for swapping sBTC against a quote token on Stacks. Two markets are available:
| Market | Contract | Quote Token |
|---|---|---|
| | STX |
| | 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.
Usage
bun run jingswap/jingswap.ts <subcommand> [--market <pair>] [options]
All commands accept
--market sbtc-stx--market sbtc-usdcxSubcommands
cycle-state
Get current auction cycle state (phase, blocks elapsed, totals, minimums).
bun run jingswap/jingswap.ts cycle-state --market sbtc-usdcx
depositors
Get quote-token and sBTC depositors for a cycle.
bun run jingswap/jingswap.ts depositors --cycle <number> --market sbtc-stx
user-deposit
Get a user's deposit amounts for a cycle.
bun run jingswap/jingswap.ts user-deposit --cycle <number> --address <stx_address>
settlement
Get settlement details for a completed cycle.
bun run jingswap/jingswap.ts settlement --cycle <number>
cycles-history
Get full history of all auction cycles.
bun run jingswap/jingswap.ts cycles-history --market sbtc-usdcx
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
prices
Get oracle and DEX prices (Pyth, XYK pool, DLMM).
bun run jingswap/jingswap.ts prices
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
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
cancel-stx
Cancel your quote-token deposit and get a refund. Deposit phase only.
bun run jingswap/jingswap.ts cancel-stx --market sbtc-usdcx
cancel-sbtc
Cancel your sBTC deposit and get a refund. Deposit phase only.
bun run jingswap/jingswap.ts cancel-sbtc
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
settle
Settle using stored Pyth prices (free). Usually fails due to stale prices — prefer settle-with-refresh.
bun run jingswap/jingswap.ts settle
settle-with-refresh
Settle with fresh Pyth VAAs (~2 uSTX). Recommended settlement method.
bun run jingswap/jingswap.ts settle-with-refresh --market sbtc-usdcx
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
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
events show swap proceeds + unswapped remainder (rolled to next cycle, not refunded)distribute- Post conditions: deposits use Deny mode; cancel/settle/cancel-cycle use Allow mode
- USDCx is a stablecoin (~$1) —
, assetSP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx
, 6 decimalsusdcx-token