mcpField
H
hodlmm-signal-allocator

hodlmm-signal-allocator

github.com/aibtcdevその他1145 回インストール1 日前に更新
リポジトリ

hodlmm-signal-allocator について

HODLMMへの配分時期を評価し、条件を満たす場合にBitflowスワップを行うDeFiスキルです。Agent向けにマクロシグナルと量子リスクを組み合わせ、実行前に5つの安全条件を確認します。

主な機能

  1. 01HODLMMの24時間APR取得
  2. 02承認済みマクロシグナルと量子リスクの評価
  3. 035つの安全条件によるスワップ制御
  4. 04シミュレーションと確認後の実行
  5. 05JSON結果とトランザクションリンクの出力

活用シーン

  1. 01HODLMMへの参入条件の評価
  2. 02APRとシグナルに基づくSTX/sBTC調整
  3. 03スワップのシミュレーションと安全条件の確認
  4. 04実行結果とエクスプローラーリンクの記録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aibtcdev/skills --skill hodlmm-signal-allocator

インストール後、Claude Code で/hodlmm-signal-allocatorを入力して読み込まれたか確認します。

同梱ファイルAGENT.mdhodlmm-signal-allocator.ts

詳細

概要

3つのライブデータソース（アクティブな HODLMM プールの24時間 APR、aibtc.news の Bitcoin マクロ関連の承認済みシグナル、Bitcoin Developer Quantum Readiness Index）を順に読み込み、リスク調整済みの単一の利回りスコアを算出します。そのスコアが最低しきい値（≥60）を超え、5つの安全ゲートすべてを通過すると、Bitflow スワップ（STX → sBTC）を実行し、最適な HODLMM 預け入れを開始できるようウォレットを調整します。実行ごとに、シグナル ID、Readiness Index のスナップショット、Hiro エクスプローラーへのリンクが記録されます。

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

HODLMM ポジションに入るには、多くのエージェントが個別に扱っている2つの要素が必要です。つまり、マクロ環境が利回り配分に適したタイミングかを見極めることと、アクティブなビンで適切なトークン比率にすることです。古いシグナルや品質の低いシグナルに基づいて行動するエージェントは、不利な状況で HODLMM への配分を過剰にし、利回りが急上昇しているときには配分が不足します。このスキルは、検証済みのシグナル品質と量子リスクに基づいてスワップを制御することで、この隔たりを埋めます。インテリジェンスレイヤーの情報がない、または不確かな場合、スキルは何も実行せず、その理由を示します。

このレジストリで、ニュースのシグナルインテリジェンスと Quantum Readiness のリスク調整を DeFi 実行ゲートとして組み合わせているスキルは、ほかにありません。

安全性に関する注意事項

スワップの前に、ハードコードされた5つのゲートが順番に実行されます。

  1. シグナル品質ゲート — signal_score < 60 → status: "blocked"。aibtc.news の承認済み Bitcoin マクロ関連シグナルから算出されます。対象期間は24時間で、シグナルの新しさを重み付けします。
  2. 量子リスクゲート — (100 - readiness_index) / 100 × 0.2 > 0.15 → status: "blocked"。長期間の HODLMM 配分を進めるには、Quantum Power Map の Readiness Index が25以上である必要があります。
  3. 支出上限 — --amount-stx のハードコードされた上限は500 STXです。これを超える金額では status: "blocked" が返されます。
  4. STX 残高の確保 — スワップ後もガス代としてウォレットに10 STX 以上を残す必要があります。満たされない場合は拒否されます。
  5. 価格への影響 — Bitflow の見積もりで価格への影響が1.5％以下である必要があります。これを上回るスプレッドでは status: "blocked" が返されます。

ライブ実行には --confirm が必要です。指定しない場合、run は完全なシミュレーション出力とともに status: "blocked"、理由 CONFIRM_REQUIRED を返します。クールダウンは実行間で6時間です。~/.hodlmm-signal-allocator-state.json に基づいて適用されます。

コマンド

コマンド説明
doctorヘルスチェック：Bitflow API、aibtc.news シグナル API、Quantum Power Map、BitflowSDK のインポート
scan --pool <id> --wallet <addr>HODLMM APR の読み取り、シグナルスコアの取得、量子リスク係数の算出、すべてのゲートの評価
run --pool <id> --wallet <addr> --amount-stx <n> [--confirm] [--dry-run]5つのゲートをすべて通過した後、Bitflow スワップを実行します。--dry-run はブロードキャストせずにシミュレーションします。

プール ID（bff.bitflowapis.finance/api/quotes/v1/pools から）：dlmm_1（STX-sBTC）、dlmm_3（STX-xBTC）。デフォルト：dlmm_1。

出力仕様

すべてのコマンドは、単一の JSON オブジェクトを stdout に出力します。

{
  "status": "success | error | blocked",
  "action": "Human-readable summary of outcome",
  "data": {},
  "error": { "code": "ERROR_CODE", "message": "...", "next": "How to resolve" }
}

doctor のデータフィールド： { checks: { bitflow_quotes, bitflow_app, aibtc_signals, quantum_map, bitflow_sdk }, degraded: string[] }

scan のデータフィールド： { pool_id, pool_apr_24h, adjusted_apr, signal_score, quantum_risk_factor, readiness_index, signals_used: [...], gates: { signal_ok, quantum_ok, cooldown_ok }, recommendation, wallet_stx_balance, wallet_sbtc_balance }

run 成功時のデータフィールド： { txId, explorerUrl, amount_in_stx, amount_out_sbtc_estimated, price_impact_pct, signal_score, readiness_index, signal_basis: [...], quantum_risk_factor, adjusted_apr, next_eligible_at }

既知の制約

  • @bitflowlabs/core-sdk のインストールが必要です（スキルのディレクトリで bun install を実行）。
  • ライブ実行には、ウォレットに（数量 + ガス代の予備10 STX）以上の資金が必要です。
  • HODLMM API（bff.bitflowapis.finance）の公開レート制限は毎分500リクエストです。
  • Quantum Power Map の data.json は、開発者スコアの変更時に更新されます。データが古い（7日超）場合、doctor は警告を表示しますが、scan はブロックされません。
  • シグナルスコアが0（24時間以内に承認済みシグナルがない）の場合、実行は常にブロックされます。

起源

AIBTC x Bitflow Skills Pay the Bills コンペティションの優勝作品です。 原作者：@IamHarrie-Labs コンペティションの PR：https://github.com/BitflowFinance/bff-skills/pull/203

コメント

Markdown 対応