aibtcdev/styx
styx/SKILL.md
BTC→sBTC conversion via Styx protocol (btc2sbtc.com) — pool status, fee estimates, deposit creation, PSBT signing, broadcast, and deposit tracking.
$ install --global
skillsauthnpx skillsauth add aibtcdev/skills styxInstall 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, 9:04 PM56.2s3 files scanned
SKILL.md
- name:
- styx
- description:
- BTC→sBTC conversion via Styx protocol (btc2sbtc.com) — pool status, fee estimates, deposit creation, PSBT signing, broadcast, and deposit tracking.
- author:
- arc0btc
- author-agent:
- Trustless Indra
- user-invocable:
- false
- arguments:
- pool-status | pools | fees | price | deposit | status | history
- entry:
- styx/styx.ts
- mcp-tools:
- styx_pool_status, styx_pools, styx_fees, styx_price, styx_deposit, styx_status, styx_history
- requires:
- wallet
- tags:
- l1, l2, write, requires-funds, defi
Styx Skill
Trustless BTC→sBTC conversion via the Styx protocol by FaktoryFun. Agents deposit BTC on L1 and receive sBTC on Stacks L2 through managed liquidity pools. Uses @faktoryfun/styx-sdk.
How It Works
- Check pool liquidity —
pool-statusshows available sBTC in the pool - Create deposit reservation —
depositreserves pool liquidity and returns a deposit ID - Build & sign transaction — The SDK provides UTXOs and deposit address; the agent builds and signs locally with
@scure/btc-signer - Broadcast — Signed transaction is broadcast to mempool.space
- Track status —
statusmonitors the deposit through confirmation
Pools
| Pool ID | Type | Min Deposit | Max Deposit | Swap Types |
|---------|------|-------------|-------------|------------|
| main | Legacy | 10,000 sats | 300,000 sats | sbtc, usda, pepe |
| aibtc | AI BTC | 10,000 sats | 1,000,000 sats | sbtc, aibtc |
Subcommands
pool-status
bun run styx/styx.ts pool-status [--pool main|aibtc]
Returns realAvailable, estimatedAvailable (BTC), and lastUpdated.
pools
bun run styx/styx.ts pools
Lists all available pools with configs and active status.
fees
bun run styx/styx.ts fees
Returns current Bitcoin network fee estimates (low/medium/high in sat/vB).
price
bun run styx/styx.ts price
Returns current BTC price in USD.
deposit
bun run styx/styx.ts deposit --amount <sats> --stx-receiver <addr> --btc-sender <addr> [--pool main|aibtc] [--fee low|medium|high]
Full headless deposit flow: creates reservation, prepares PSBT, signs with wallet key, broadcasts to mempool.space, and updates deposit status. Requires an unlocked wallet.
status
bun run styx/styx.ts status --id <deposit-id>
bun run styx/styx.ts status --txid <btc-txid>
Check deposit status by deposit ID or Bitcoin transaction ID.
history
bun run styx/styx.ts history --address <stx-addr>
Get deposit history for a Stacks address.
Deposit Statuses
initiated— Deposit record created, liquidity reservedbroadcast— Bitcoin tx broadcast to mempoolprocessing— At least 1 BTC confirmationconfirmed— Required confirmations reached, sBTC mintedrefund-requested— User requested refundcanceled— Deposit canceled, liquidity released
Notes
- Always check
pool-statusbefore depositing to verify sufficient liquidity - Update deposit status after broadcast — this is critical for accurate pool accounting
- Min deposit: 10,000 sats (0.0001 BTC). Max varies by pool.
- The SDK uses a pre-configured API key for the Styx backend
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