aibtcdev/jingswap-v2
jingswap-v2/SKILL.md
Jingswap V2 limit-price auction — sbtc-stx markets with mandatory limit prices, 2-phase (no buffer), bundled close+settle. Markets: sbtc-stx-market (0% premium) and sbtc-stx-20bp-stx-premium (0.20% STX bonus).
$ install --global
skillsauthnpx skillsauth add aibtcdev/skills jingswap-v2Install 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: May 1, 2026, 5:13 AM123.2s3 files scanned
SKILL.md
- name:
- jingswap-v2
- description:
- Jingswap V2 limit-price auction — sbtc-stx markets with mandatory limit prices, 2-phase (no buffer), bundled close+settle. Markets: sbtc-stx-market (0% premium) and sbtc-stx-20bp-stx-premium (0.20% STX bonus).
- author:
- Rapha-btc
- author-agent:
- Claude Code
- user-invocable:
- false
- arguments:
- cycle-state | user-deposit | clearing-preview | prices | deposit-stx | deposit-sbtc | set-stx-limit | set-sbtc-limit | cancel-stx | cancel-sbtc | close-and-settle | cancel-cycle
- entry:
- jingswap-v2/jingswap-v2.ts
- mcp-tools:
- jingswap_v2_get_cycle_state, jingswap_v2_get_user_deposit, jingswap_v2_get_clearing_preview, jingswap_v2_get_prices, jingswap_v2_deposit_stx, jingswap_v2_deposit_sbtc, jingswap_v2_set_stx_limit, jingswap_v2_set_sbtc_limit, jingswap_v2_cancel_stx, jingswap_v2_cancel_sbtc, jingswap_v2_close_and_settle_with_refresh, jingswap_v2_cancel_cycle
- requires:
- wallet
- tags:
- l2, write, requires-funds, defi
Jingswap V2 Skill
Limit-price auction for swapping sBTC against STX on Stacks. Two markets:
| Market | Contract | Premium |
|--------|----------|---------|
| sbtc-stx-market (default) | SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-stx-0-jing-v2 | 0% (oracle price) |
| sbtc-stx-20bp-stx-premium | SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-stx-20-jing-v2 | 0.20% STX bonus |
Key Differences from V1
- Limit prices required on all deposits (in sats/STX)
- 2 phases only: deposit (10 blocks ~20s) then settle (no buffer)
- Bundled settlement:
close-and-settlein a single atomic tx (reverts entirely if fails) - No separate close-deposits — avoids stuck cycles
- Limit updates without re-depositing via
set-stx-limit/set-sbtc-limit
Usage
bun run jingswap-v2/jingswap-v2.ts <subcommand> [--market <pair>] [options]
Default market is sbtc-stx-market. All limit prices are in sats/STX.
Subcommands
cycle-state
Get current V2 cycle state (phase, blocks, totals).
bun run jingswap-v2/jingswap-v2.ts cycle-state --market sbtc-stx-20bp-stx-premium
user-deposit
Get deposit amounts and limit prices for a user.
bun run jingswap-v2/jingswap-v2.ts user-deposit --cycle 0 --address SP...
clearing-preview
Simulate settlement at current oracle — shows what will clear vs roll.
bun run jingswap-v2/jingswap-v2.ts clearing-preview
prices
Get oracle prices with default limit suggestions.
bun run jingswap-v2/jingswap-v2.ts prices
deposit-stx
Deposit STX with limit price (sats/STX floor). Omit --limit for 20% in-the-money default.
bun run jingswap-v2/jingswap-v2.ts deposit-stx --amount 10 --limit 240
deposit-sbtc
Deposit sBTC (satoshis) with limit price (sats/STX ceiling). Omit --limit for 20% in-the-money default.
bun run jingswap-v2/jingswap-v2.ts deposit-sbtc --amount 10000 --limit 360
set-stx-limit
Update STX-side limit price without re-depositing. Deposit phase only.
bun run jingswap-v2/jingswap-v2.ts set-stx-limit --limit 250
set-sbtc-limit
Update sBTC-side limit price without re-depositing. Deposit phase only.
bun run jingswap-v2/jingswap-v2.ts set-sbtc-limit --limit 350
cancel-stx
Cancel STX deposit for full refund. Deposit phase only.
bun run jingswap-v2/jingswap-v2.ts cancel-stx
cancel-sbtc
Cancel sBTC deposit for full refund. Deposit phase only.
bun run jingswap-v2/jingswap-v2.ts cancel-sbtc
close-and-settle
Close deposits and settle atomically with fresh Pyth prices. Single tx, reverts entirely if settlement fails.
bun run jingswap-v2/jingswap-v2.ts close-and-settle --market sbtc-stx-20bp-stx-premium
cancel-cycle
Cancel cycle if settlement failed. Callable 42 blocks (~84s) after close. Rolls all deposits forward.
bun run jingswap-v2/jingswap-v2.ts cancel-cycle
Notes
- Limit prices in sats/STX: STX depositors set a floor (min sats/STX they'll accept), sBTC depositors set a ceiling (max sats/STX they'll pay)
- Default limits are 20% in-the-money vs oracle (virtually guaranteed fill)
- Stacks blocks average ~2 seconds (Nakamoto)
- Deposit phase: 10 blocks (~20s) before close-and-settle is callable
- Cancel threshold: 42 blocks (~84s) after close
- If limits wipe a side below minimum, bundled tx reverts — no stuck cycle
- Post conditions: deposits use Deny mode; cancel/settle/cancel-cycle use Allow mode
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