styx

Styx スキル

FaktoryFun の Styx プロトコルを介した、信頼不要の BTC→sBTC 変換です。エージェントは L1 で BTC を入金し、管理された流動性プールを通じて Stacks L2 で sBTC を受け取ります。@faktoryfun/styx-sdk を使用します。

仕組み

1. プールの流動性を確認する — pool-status でプール内の利用可能な sBTC を確認します
2. 入金予約を作成する — deposit でプールの流動性を予約し、入金 ID を取得します
3. トランザクションを作成して署名する — SDK が UTXO と入金アドレスを提供します。エージェントは @scure/btc-signer を使ってローカルで作成、署名します
4. ブロードキャストする — 署名済みトランザクションを mempool.space にブロードキャストします
5. ステータスを追跡する — status で入金の承認状況を監視します

プール

プール ID	種類	最小入金額	最大入金額	スワップの種類
main	レガシー	10,000 sats	300,000 sats	sbtc, usda, pepe
aibtc	AI BTC	10,000 sats	1,000,000 sats	sbtc, aibtc

サブコマンド

pool-status

bun run styx/styx.ts pool-status [--pool main|aibtc]

realAvailable、estimatedAvailable（BTC）、および lastUpdated を返します。

pools

bun run styx/styx.ts pools

設定とアクティブ状態を含む、利用可能なすべてのプールを一覧表示します。

fees

bun run styx/styx.ts fees

現在の Bitcoin ネットワーク手数料の見積もり（低・中・高、sat/vB）を返します。

price

bun run styx/styx.ts price

現在の BTC 価格を米ドルで返します。

deposit

bun run styx/styx.ts deposit --amount <sats> --stx-receiver <addr> --btc-sender <addr> [--pool main|aibtc] [--fee low|medium|high]

ヘッドレスで入金処理を一括実行します。予約を作成し、PSBT を準備し、ウォレットキーで署名して、mempool.space にブロードキャストし、入金ステータスを更新します。ロック解除済みのウォレットが必要です。

status

bun run styx/styx.ts status --id <deposit-id>
bun run styx/styx.ts status --txid <btc-txid>

入金 ID または Bitcoin トランザクション ID で入金ステータスを確認します。

history

bun run styx/styx.ts history --address <stx-addr>

Stacks アドレスの入金履歴を取得します。

入金ステータス

• initiated — 入金レコードが作成され、流動性が予約されています
• broadcast — Bitcoin トランザクションがメンプールにブロードキャストされました
• processing — Bitcoin の承認が 1 回以上完了しています
• confirmed — 必要な承認数に達し、sBTC がミントされました
• refund-requested — ユーザーが返金をリクエストしました
• canceled — 入金がキャンセルされ、流動性が解放されました

注意事項

• 入金前に必ず pool-status を確認し、十分な流動性があることを確かめてください
• ブロードキャスト後に入金ステータスを更新してください。プールの会計を正確に保つために重要です
• 最小入金額：10,000 sats（0.0001 BTC）。最大入金額はプールによって異なります
• SDK は Styx バックエンド用に事前設定された API キーを使用します