aibtcdev/jingswap
jingswap/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add aibtcdev/skills jingswapInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 30, 2026, 8:49 PM61.6s3 files scanned
SKILL.md
- name:
- jingswap
- description:
- 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.
- author:
- Rapha-btc
- author-agent:
- Claude Code
- user-invocable:
- false
- arguments:
- cycle-state | depositors | user-deposit | settlement | cycles-history | user-activity | prices | deposit-stx | deposit-sbtc | cancel-stx | cancel-sbtc | close-deposits | settle | settle-with-refresh | cancel-cycle
- entry:
- jingswap/jingswap.ts
- mcp-tools:
- jingswap_get_cycle_state, jingswap_get_depositors, jingswap_get_user_deposit, jingswap_get_settlement, jingswap_get_cycles_history, jingswap_get_user_activity, jingswap_get_prices, jingswap_deposit_stx, jingswap_deposit_sbtc, jingswap_cancel_stx, jingswap_cancel_sbtc, jingswap_close_deposits, jingswap_settle, jingswap_settle_with_refresh, jingswap_cancel_cycle
- requires:
- wallet
- tags:
- l2, write, requires-funds, defi
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
distributeevents 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, assetusdcx-token, 6 decimals
Related Skills
aibtcdev/wot
development
VerifiedTrustedCommunity
Web of Trust operations for Nostr pubkeys — trust scoring, sybil detection, trust path analysis, neighbor discovery, follow recommendations, and network health. Free tier (wot.klabo.world, 50 req/day) with paid fallback (maximumsats.com, 100 sats via L402). Covers 52K+ pubkeys and 2.4M+ zap-weighted trust edges. Use --key-source to select nip06 (default), taproot, or stacks derivation path.
6SKILL.mdUpdated May 27, 2026
aibtcdev/ordinals-marketplace
data-ai
VerifiedTrustedCommunity
BTC ordinals marketplace operations via Magic Eden — browse active listings, list inscriptions for sale via PSBT flow, submit signed listings, buy inscriptions, and cancel active listings. BTC ordinals only (not Solana). Mainnet-only.
6SKILL.mdUpdated May 27, 2026
aibtcdev/lunarcrush
testing
VerifiedTrustedCommunity
Pay-per-call access to LunarCrush social and market intelligence (Galaxy Score, AltRank, market cap rank, price, 24h change) via x402 on Stacks. USD-pegged pricing recomputed hourly from live STX/USD. Mainnet endpoint live; testnet supported.
6SKILL.mdUpdated May 27, 2026
aibtcdev/hodlmm-inventory-balancer
devops
VerifiedTrustedCommunity
Detects HODLMM LP inventory drift (token-ratio imbalance from one-sided swap flow) and restores the target ratio via a corrective Bitflow swap plus a hodlmm-move-liquidity redeploy, gated by the 4h per-pool cooldown.
6SKILL.mdUpdated May 27, 2026