sbtc

sBTC スキル

sBTC（Stacks L2 上のラップドビットコイン）操作を提供します。sBTC は Bitcoin と同じ 8 桁の小数を使用します。送金と入金の操作には、ロック解除済みのウォレットが必要です（まず bun run wallet/wallet.ts unlock を実行してください）。残高と情報の照会は、ウォレットがなくても実行できます。

使用方法

bun run sbtc/sbtc.ts <subcommand> [options]

サブコマンド

get-balance

Stacks アドレスの sBTC 残高を取得します。

bun run sbtc/sbtc.ts get-balance [--address <addr>]

オプション：

• --address（任意） — 確認する Stacks アドレス（省略時はアクティブなウォレットを使用）

出力：

{
  "address": "SP2...",
  "network": "mainnet",
  "balance": {
    "sats": "100000",
    "btc": "0.001 sBTC"
  }
}

transfer

受取人に sBTC を送金します。ロック解除済みのウォレットが必要です。

sBTC は 8 桁の小数を使用します。--amount はサトシ単位で指定してください（1 sBTC = 100,000,000 サトシ）。

bun run sbtc/sbtc.ts transfer --recipient <addr> --amount <sats> [--memo <text>] [--fee low|medium|high|<microStx>] [--sponsored]

オプション：

• --recipient（必須） — 送金先の Stacks アドレス
• --amount（必須） — サトシ単位の金額（例：「100000」は 0.001 sBTC）
• --memo（任意） — 含めるメモメッセージ
• --fee（任意） — 手数料のプリセット（low|medium|high）または micro-STX 単位の金額。省略時は自動推定されます
• --sponsored（フラグ） — 利用可能な場合、手数料のスポンサー機能を使用します

出力：

{
  "success": true,
  "txid": "abc123...",
  "from": "SP2...",
  "recipient": "SP3...",
  "amount": "0 sBTC",
  "amountSats": "100000",
  "network": "mainnet",
  "explorerUrl": "https://explorer.hiro.so/txid/abc123...?chain=mainnet"
}

get-deposit-info

sBTC を受け取るための BTC 入金方法に関する情報を取得します。Taproot キーを持つウォレットがロック解除されている場合は、個別の入金アドレスを返します。それ以外の場合は、一般的な手順を返します。

bun run sbtc/sbtc.ts get-deposit-info

出力（ウォレットのロック解除時）：

{
  "network": "mainnet",
  "depositAddress": "bc1p...",
  "maxSignerFee": "80000 satoshis",
  "reclaimLockTime": "950 blocks",
  "stacksAddress": "SP2...",
  "instructions": [...]
}

出力（ウォレットがない場合）：

{
  "network": "mainnet",
  "depositAddress": "bc1p...",
  "minDeposit": "...",
  "maxDeposit": "...",
  "instructions": [...]
}

get-peg-info

総供給量やペッグ比率など、sBTC のペッグ情報を取得します。

bun run sbtc/sbtc.ts get-peg-info

出力：

{
  "network": "mainnet",
  "totalSupply": {
    "sats": "1000000000",
    "btc": "10 sBTC"
  },
  "pegRatio": "1.000000"
}

deposit

Stacks L2 で sBTC を受け取るために BTC を入金します。sBTC 入金アドレス宛ての Bitcoin トランザクションを作成し、署名してブロードキャストします。Bitcoin の承認後、Stacks アドレスに sBTC トークンが発行されます。Bitcoin キーと Taproot キーを持つ、ロック解除済みのウォレットが必要です。

デフォルトでは、カーディナル UTXO（安全に使用でき、インスクリプションを含まないもの）のみを使用します。

bun run sbtc/sbtc.ts deposit --amount <sats> [--fee-rate fast|medium|slow|<number>] [--max-signer-fee <sats>] [--reclaim-lock-time <blocks>] [--include-ordinals]

オプション：

• --amount（必須） — 入金額（サトシ単位。1 BTC = 100,000,000 サトシ）
• --fee-rate（任意） — fast（約10分）、medium（約30分）、slow（約1時間）、または sat/vB 単位の数値（デフォルト：medium）
• --max-signer-fee（任意） — sBTC システムが請求できる最大手数料（サトシ単位。デフォルト：80000）
• --reclaim-lock-time（任意） — 入金失敗時に払い戻しが可能になるまでのブロック数（デフォルト：950）
• --include-ordinals（フラグ） — Ordinal UTXO を含めます（警告：価値のあるインスクリプションが破壊される可能性があります！）

出力：

{
  "success": true,
  "txid": "btcTxid123...",
  "explorerUrl": "https://mempool.space/tx/btcTxid123...",
  "deposit": {
    "amount": "0.001 BTC",
    "amountSats": 100000,
    "recipient": "SP2...",
    "bitcoinAddress": "bc1q...",
    "taprootAddress": "bc1p...",
    "maxSignerFee": "80000 sats",
    "reclaimLockTime": "950 blocks",
    "feeRate": "5 sat/vB"
  },
  "network": "mainnet",
  "note": "sBTC tokens will be minted to your Stacks address after Bitcoin transaction confirms."
}

deposit-status

Emily API を使用して、sBTC 入金トランザクションのステータスを確認します。

bun run sbtc/sbtc.ts deposit-status --txid <btcTxid> [--vout <index>]

オプション：

• --txid（必須） — 入金に使用した Bitcoin トランザクション ID
• --vout（任意） — 入金の出力インデックス（デフォルト：0）

出力：

{
  "txid": "btcTxid123...",
  "vout": 0,
  "status": "pending",
  "explorerUrl": "https://mempool.space/tx/btcTxid123...",
  "network": "mainnet"
}

注意事項

• 残高と情報の照会には Hiro API を使用します（認証は不要です）
• 送金と入金の操作には、ロック解除済みのウォレットが必要です
• sBTC は Bitcoin のサトシと同じく、小数点以下 8 桁を使用します
• deposit コマンドは Bitcoin L1 を使用します。ウォレットの Bitcoin アドレスに BTC があることを確認してください
• 入金後、Bitcoin の承認を経て sBTC トークンが Stacks アドレスに表示されます