sbtc-yield-maximizer

sBTC 利回り最大化ツール

機能

Zest の sBTC 利回りの最新値と、Bitflow の現在の sBTC HODLMM の機会を比較し、運用されていない sBTC を最も安全な運用先に振り分けます。このバージョンでは、Zest が最適な運用先の場合は実際の Zest sBTC 供給トランザクションを実行し、HODLMM が実行可能な安全な運用先として最適な場合は、CLI 経由で hodlmm-move-liquidity を実行して HODLMM の処理をオーケストレーションします。

エージェントに必要な理由

エージェントは、固定的な想定に基づいて sBTC を運用すべきではありません。資金を動かす前に、現在の利回り、価格情報の古さによるリスク、HODLMM の流動性の質、ウォレットの準備金を確認する実際の判断レイヤーが必要です。このスキルは、その判断を繰り返し実行できる安全対策付きの書き込みフローにします。

安全に関する注意事項

• チェーンに書き込みます。run は、Zest が最適な運用先の場合は実際の Zest sBTC 供給トランザクションに署名してブロードキャストし、HODLMM が最適な場合は実際の HODLMM リバランスを実行します。
• メインネット専用です。ルーティングデータと書き込み実行の対象は、稼働中のメインネットプロトコルです。
• ウォレットのパスワードが必要です。実行時に AIBTC_WALLET_PASSWORD を使用してローカルの AIBTC ウォレットのロックを解除します。
• 準備金を強制します。書き込み経路の実行後も、ウォレットには少なくとも --reserve-sats が保持されます。
• 運用上限を強制します。振り分ける金額は --max-deploy-sats を上限とします。
• ガス準備金を強制します。ウォレットには少なくとも --min-gas-reserve-ustx を残す必要があります。
• 事後条件を強制します。Zest のサービスレイヤーの書き込み経路では PostConditionMode.Deny を使用します。
• HODLMM の価格情報の古さに対するゲートを強制します。--max-data-age-seconds より古い HODLMM の読み取り結果、または価格乖離が --max-price-divergence-pct を超えるプールは対象外となります。
• HODLMM の流動性ゲートを強制します。設定された TVL または 24 時間の出来高の下限を下回るプールは対象外となります。
• APY 差のゲートを強制します。最適な運用先が --min-apy-diff-bps 以上優位な場合に限り、運用先を切り替えます。
• メタクールダウンを強制します。--cooldown-hours が経過するまでは、同じ運用先の実行をブロックします。
• メンプールの深さに対するガードを強制します。保留中の送信者の深さが --mempool-depth-limit を超えると、実行はブロックされます。
• HODLMM の実行は、CLI 経由で hodlmm-move-liquidity に委譲されます。ウォレットのパスワードはサブプロセスの CLI 引数ではなく環境スコープ内に保持し、上流のプール単位のクールダウン／状態に従います。
• 明示的な確認が必要です。--confirm=MAXIMIZE が指定されていない場合、run は実行を拒否します。
• 書き込み経路の実行を試みた後、ウォレットを再ロックします。

コマンド

doctor

ウォレットの解決、STX と sBTC の残高、Zest のボールト読み取り、Bitflow のプール読み取り、メンプールの深さ、および現在の設定で最適な運用先を安全に実行できるかどうかを確認します。

bun run sbtc-yield-maximizer/sbtc-yield-maximizer.ts doctor

install-packs

このスキルで使用する必要なランタイムパッケージを一覧表示します。

bun run sbtc-yield-maximizer/sbtc-yield-maximizer.ts install-packs

status

最新の残高、運用先の候補、運用先のスコア、Zest のレート読み取り、HODLMM の最有力候補、および現在最適な運用先を表示します。

bun run sbtc-yield-maximizer/sbtc-yield-maximizer.ts status

run

ウォレットのロックを解除し、運用先の判断を再確認して、最適な安全な運用先を実行します。

• Zest が最適な場合は、Zest に sBTC を供給します
• HODLMM が最適で、現在のポジションがレンジ外の場合は、hodlmm-move-liquidity 経由で HODLMM をリバランスします

AIBTC_WALLET_PASSWORD='your-password' bun run sbtc-yield-maximizer/sbtc-yield-maximizer.ts run --confirm=MAXIMIZE

調整済みの実行例：

AIBTC_WALLET_PASSWORD='your-password' HODLMM_MOVE_LIQUIDITY_CMD='bun run /path/to/hodlmm-move-liquidity.ts' bun run sbtc-yield-maximizer/sbtc-yield-maximizer.ts run --wallet-id=b4d575f8-0865-4d6f-b1d6-5627b645a03c --max-deploy-sats=10000 --reserve-sats=100 --min-gas-reserve-ustx=100000 --min-hodlmm-volume-usd=1000 --min-hodlmm-tvl-usd=1000 --max-price-divergence-pct=0.5 --min-apy-diff-bps=50 --max-data-age-seconds=30 --mempool-depth-limit=0 --confirm=MAXIMIZE

出力仕様

すべての出力は stdout への JSON です。

成功：

{
  "status": "success",
  "action": "Executed the highest safe yield route",
  "data": {
    "operation": "maximize-yield",
    "txid": "0x...",
    "explorerUrl": "https://explorer.hiro.so/txid/0x...?chain=mainnet"
  },
  "error": null
}

ブロック：

{
  "status": "blocked",
  "action": "Hold idle sBTC until a safe executable route is available",
  "data": {},
  "error": {
    "code": "PREFLIGHT_BLOCKED",
    "message": "No executable route passed the configured safety gates",
    "next": "Re-run later or adjust thresholds with explicit operator approval"
  }
}

エラー：

{ "error": "descriptive message" }

既知の制約

• このバージョンでは、ソースをインポートするのではなく、CLI を介して hodlmm-move-liquidity と連携します。この上流のプリミティブが、引き続き HODLMM の書き込みパスの信頼できる情報源です。
• HODLMM の事前チェックパスでは、ブロードキャストを行わないコマンド hodlmm-move-liquidity scan を使用します。実際の HODLMM 実行は、委任された run --confirm パスでのみ行われます。
• Zest の sBTC 利回りは、オンチェーンの Zest vault からライブで読み取ったデータに基づき、ベーシスポイント形式の供給シグナルとして解釈されます。これは、BPS u10000 を定義し、ベーシスポイントでレート計算を行うライブの v0-vault-sbtc ソースと照合して確認済みです。
• HODLMM の機会は、APR、手数料の実行レート、出来高、TVL、価格の古さのチェック、およびウォレットにリバランス可能なレンジ外の LP ポジションがすでにあるかどうかを用いて、Bitflow のアプリと見積もり API からライブで取得したデータに基づいて判定されます。
• 予備分を超える十分な sBTC と、ガス予備分を確保できるだけの STX が必要です。
• ウォレットごとの状態は現在、~/.aibtc/ に保存されます。これは、以前の共有クールダウンファイル ~/.sbtc-yield-maximizer-state.json を移行せず、アップグレード時に意図的に新しい状態から開始するためのものです。