Claude
Skills
Sign in
Back

styx

Included with Lifetime
$97 forever

BTC→sBTC conversion via Styx protocol (btc2sbtc.com) — pool status, fee estimates, deposit creation, PSBT signing, broadcast, and deposit tracking.

Ads & Marketing

What this skill does


# 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

1. **Check pool liquidity** — `pool-status` shows available sBTC in the pool
2. **Create deposit reservation** — `deposit` reserves pool liquidity and returns a deposit ID
3. **Build & sign transaction** — The SDK provides UTXOs and deposit address; the agent builds and signs locally with `@scure/btc-signer`
4. **Broadcast** — Signed transaction is broadcast to mempool.space
5. **Track status** — `status` monitors 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 reserved
- `broadcast` — Bitcoin tx broadcast to mempool
- `processing` — At least 1 BTC confirmation
- `confirmed` — Required confirmations reached, sBTC minted
- `refund-requested` — User requested refund
- `canceled` — Deposit canceled, liquidity released

## Notes

- Always check `pool-status` before 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
Files: 3
Size: 23.5 KB
Complexity: 34/100
Category: Ads & Marketing

Related in Ads & Marketing