jingswap

# Jingswap Skill Blind batch auction for swapping sBTC against a quote token on Stacks. Two markets are available: | Market | Contract | Quote 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. ## Usage ``` bun run jingswap/jingswap.ts <subcommand> [--market <pair>] [options] ``` All commands accept `--market sbtc-stx` (default) or `--market sbtc-usdcx`. ## Subcommands ### 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 - `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