hodlmm-range-keeper

HODLMM レンジキーパー

機能

HODLMM の集中流動性ポジションを積極的に管理します。アクティブビンのずれを監視し、手数料の蓄積を推定し、市場が離れた場合に LP レンジを再調整します。シグナルのみを提供する分析スキルとは異なり、ずれの検出、再調整の計画、結果のシミュレーション、MCP ツールによる実行、検証まで、管理プロセス全体を完了します。すべてのプールをスキャンし、ずれたポジションを 1 サイクルで再調整する、自律的な run モードに対応しています。

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

HODLMM の集中流動性は、アクティブビンがポジションのレンジ内にある場合にのみ手数料を獲得します。価格が動くとアクティブビンが離れ、流動性が使われない状態になります。その間、手数料を獲得できず、インパーマネントロスのリスクにさらされます。複数のプールを手動で監視するのは現実的ではありません。このスキルを使うと、受動的な LP 預け入れを積極的に管理できるポジションに変えられます。ビンと市場の位置を追跡し、レンジ内にとどまって手数料を獲得し続けられるよう、流動性を移動します。

安全上の注意

• チェーンへの書き込み：流動性を引き出し、新しいビンに再預け入れします。実際の資金が移動します。
• ずれのしきい値：アクティブビンがポジションの中心から 3 ビン以上ずれない限り、再調整しません（設定可能）。
• クールダウン：頻繁な再調整を防ぐため、同じプールでの再調整の間隔を 30 分空けます。
• ガス上限：1 サイクルあたり最大 50 STX です。ガスの見積もりが上限を超える場合は実行しません。
• 少額ポジションの除外：採算の取れない小規模な再調整を避けるため、5,000 sats 未満のポジションは無視します。
• --confirm ゲート：recenter コマンドには明示的な --confirm フラグが必要です。このフラグがない場合、何も実行されません。
• 手数料の保持：ビンごとに預け入れ時の基準額を記録します。再調整時には、基準額を超える手数料を収穫して保持し、元本のみを再預け入れします。
• メインネット専用：HODLMM はテストネットでは利用できません。
• MCP による実行：オンチェーン取引は MCP ツール呼び出し（bitflow_hodlmm_remove_liquidity、bitflow_hodlmm_add_liquidity）として送信されます。エージェントのランタイムがこれらを実行します。

コマンド

doctor

ウォレット、HODLMM API へのアクセス、プールの利用状況、既存のポジション、必要な MCP ツールを確認します。読み取り専用で、いつでも安全に実行できます。

STX_ADDRESS=SP... bun run hodlmm-range-keeper/hodlmm-range-keeper.ts doctor

status

すべての LP ポジションを分析し、ずれの大きさ、レンジ効率（アクティブレンジ内にあるビンの割合）、推定手数料、再調整の必要性を確認します。初回の観測時に手数料の基準額をローカルに記録します。それ以外は読み取り専用です。

STX_ADDRESS=SP... bun run hodlmm-range-keeper/hodlmm-range-keeper.ts status
STX_ADDRESS=SP... bun run hodlmm-range-keeper/hodlmm-range-keeper.ts status --pool dlmm_1

plan

再調整のドライランを実行します。引き出しと再預け入れをシミュレーションし、予想されるビンの配置、収穫される手数料、ガスコストを表示します。資金は移動しません。

STX_ADDRESS=SP... bun run hodlmm-range-keeper/hodlmm-range-keeper.ts plan --pool dlmm_1

recenter

再調整を実行します。ずれたビンから流動性を引き出し、手数料を収穫して、アクティブビンの周辺に元本を再預け入れします。--confirm が必要です。

STX_ADDRESS=SP... bun run hodlmm-range-keeper/hodlmm-range-keeper.ts recenter --pool dlmm_1 --confirm

run

完全自律型のサイクルを実行します。すべてのプールをスキャンし、ずれを評価し、必要に応じて再調整を計画して実行します。ライブ実行には --confirm を使用し、ドライランには指定しません。

STX_ADDRESS=SP... bun run hodlmm-range-keeper/hodlmm-range-keeper.ts run
STX_ADDRESS=SP... bun run hodlmm-range-keeper/hodlmm-range-keeper.ts run --confirm

history

ローカル台帳から過去の再調整イベントを表示します。ポジション管理の監査に役立ちます。

bun run hodlmm-range-keeper/hodlmm-range-keeper.ts history
bun run hodlmm-range-keeper/hodlmm-range-keeper.ts history --pool dlmm_1 --limit 10

出力仕様

すべての出力は標準出力に JSON 形式で書き込まれます。ログは標準エラー出力に書き込まれます。

成功時：

{ "status": "success", "action": "status", "data": { "positionsAnalyzed": 2, "needsRecenter": 1, "positions": [...] }, "error": null }

再調整可能：

{ "status": "success", "action": "execute_mcp", "data": { "step1_withdraw": { "tool": "bitflow_hodlmm_remove_liquidity", "params": {...} }, "step2_deposit": { "tool": "bitflow_hodlmm_add_liquidity", "params": {...} }, "summary": {...} }, "error": null }

ブロック時：

{ "status": "blocked", "action": "recenter", "data": { "cooldownRemainingMinutes": 15 }, "error": "Cooldown active." }

エラー時：

{ "status": "error", "action": "recenter", "data": null, "error": "Pool dlmm_99 not found." }

install-packs

外部パックは不要です。即座に成功を返します。

bun run hodlmm-range-keeper/hodlmm-range-keeper.ts install-packs --pack all

既知の制約

• メインネットのみ — HODLMM はテストネットにデプロイされていません
• 手数料の推定には基準値が必要です — 新規インストール後の最初の status では現在の状態が基準値として記録されるため、次回の確認まで推定手数料はゼロです
• ポジションの再センタリングは、2 つの MCP 呼び出し（出金後に入金）を順次実行します — 出金が成功した後に入金トランザクションが失敗すると、一部の処理だけが失敗する可能性があります。その場合、資金はウォレット内にあり、失われていません。状態は MCP の実行前に楽観的に記録されます。一部の処理だけが失敗した場合、基準値がリセットされ、次の status 呼び出しで現在のオンチェーン状態から再設定されます。
• 計画から再センタリングまでの間に、アクティブビンが移動する可能性があります。このスキルは実行時点の最新のアクティブビンを使用します。
• HODLMM API（bff.bitflowapis.finance）はチェーンの状態より 1～2 ブロック遅れる場合があります
• ガスの推定は保守的です（2 件のトランザクションで 4 STX）。実際のガスは通常これより少なくなります。