dual-stacking

デュアルスタッキングスキル

デュアルスタッキングでは、sBTC を保有するだけで、エージェントは BTC 建ての利回り（sBTC で支払い）を獲得できます。ロックアップ期間は必要ありません。オプションで、sBTC とともにスタック済み STX を保有すると、APR が最大 10 倍になります。

• check-status — 読み取り専用です。登録状況、APR の範囲、最低額、サイクルの概要を返します。
• get-rewards — 読み取り専用です。指定したサイクルで獲得した報酬を返します。
• enroll と opt-out — 書き込み操作です。ロック解除済みのウォレットが必要です。

コントラクト： SP1HFCRKEJ8BYW4D0E3FAWHFDX8A25PPAA83HWWZ9.dual-stacking-v2_0_4

APR：

• sBTC のみ：約 0.5% APY（sBTC）
• sBTC ＋ スタック済み STX：約 5% APY（最大 10 倍の倍率）

最低登録額： 10,000 sats の sBTC（0.0001 sBTC）

使用方法

bun run dual-stacking/dual-stacking.ts <subcommand> [options]

サブコマンド

check-status

アドレスの登録状況、APR データ、最低登録額、現在のサイクルの概要を確認します。

bun run dual-stacking/dual-stacking.ts check-status [--address <STX_ADDRESS>]

オプション：

• --address（省略可能）— 確認する Stacks アドレス（省略した場合はアクティブなウォレットを使用します）

出力：

{
  "address": "SP2...",
  "network": "mainnet",
  "enrolledThisCycle": true,
  "enrolledNextCycle": true,
  "minimumEnrollmentSats": 10000,
  "apr": {
    "minApr": 0.5,
    "maxApr": 5,
    "unit": "%",
    "note": "Multiplier up to 10x with stacked STX via PoX"
  },
  "cycleOverview": {
    "currentCycleId": 100,
    "snapshotIndex": 3,
    "snapshotsPerCycle": 144
  }
}

enroll

デュアルスタッキングに登録します。報酬の計算には呼び出し元の sBTC 残高が使用されます。オプションで、別のアドレスを報酬の受け取り先に指定できます。

bun run dual-stacking/dual-stacking.ts enroll [--reward-address <STX_ADDRESS>]

オプション：

• --reward-address（省略可能）— 報酬を受け取る Stacks アドレス（デフォルトは呼び出し元のアドレス）

出力：

{
  "success": true,
  "txid": "abc123...",
  "enrolledAddress": "SP2...",
  "rewardAddress": "SP2...",
  "network": "mainnet",
  "explorerUrl": "https://explorer.hiro.so/txid/abc123...?chain=mainnet"
}

opt-out

デュアルスタッキングの登録を解除します。次のサイクルから適用されます。

bun run dual-stacking/dual-stacking.ts opt-out

出力：

{
  "success": true,
  "txid": "abc123...",
  "address": "SP2...",
  "network": "mainnet",
  "explorerUrl": "https://explorer.hiro.so/txid/abc123...?chain=mainnet"
}

get-rewards

指定したサイクルとアドレスの獲得報酬を取得します。

bun run dual-stacking/dual-stacking.ts get-rewards --cycle <N> [--address <STX_ADDRESS>] [--rollback <N>]

オプション：

• --cycle（必須）— 照会するサイクル番号
• --address（省略可能）— 確認する Stacks アドレス（省略した場合はアクティブなウォレットを使用します）
• --rollback（省略可能）— ロールバックのオフセット（デフォルト：0）

出力：

{
  "address": "SP2...",
  "cycle": 99,
  "rollback": 0,
  "rewardSats": 500,
  "rewardBtc": "0.000005",
  "network": "mainnet"
}

注意事項

• 登録はサイクルごとに行われます。サイクルの途中で登録した場合、報酬は次のサイクルから発生します。
• 報酬の倍率は、PoX 経由でスタックした STX の量に基づいて自動的に決まります。
• stacking スキルを使って STX をスタックすると、デュアルスタッキングの APR を最大 5% APY まで高められます。
• ウォレット操作にはロック解除済みのウォレットが必要です（先に bun run wallet/wallet.ts unlock を実行するか、CLIENT_MNEMONIC 環境変数を設定してください）。