mcpField
H
hodlmm-range-keeper

hodlmm-range-keeper

github.com/aibtcdev其他1144 次安装1 天前更新
代码仓库

关于 hodlmm-range-keeper

hodlmm-range-keeper 是用于管理 HODLMM 集中流动性仓位的技能，可检测活跃区间偏移、规划重新居中并估算费用。它支持先模拟再执行的流程，也可扫描多个池并按需处理。

主要功能

  1. 01分析仓位偏移、区间效率与预估费用
  2. 02模拟提取和重新存入计划
  3. 03按确认门槛重新居中流动性
  4. 04扫描多个池并运行管理周期
  5. 05记录并查看历史重新居中事件

适用场景

  1. 01价格偏离时将流动性移回活跃区间
  2. 02执行前查看预计区间、费用与 Gas
  3. 03检查多个池的仓位是否需要调整
  4. 04审查历史重新居中记录

MCP 相关

实际链上操作通过 MCP 工具 `bitflow_hodlmm_remove_liquidity` 和 `bitflow_hodlmm_add_liquidity` 执行；技能输出工具调用，由 Agent 运行时执行。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aibtcdev/skills --skill hodlmm-range-keeper

安装后在 Claude Code 中输入/hodlmm-range-keeper确认已加载。

附带文件AGENT.mdhodlmm-range-keeper.ts

详细介绍

HODLMM 区间守护工具

功能

主动管理 HODLMM 集中流动性头寸：监控活跃 bin 的偏移、估算手续费累积情况，并在市场偏离时重新调整 LP 区间。与仅提供信号分析的技能不同，它会完成整个管理闭环：检测偏移、规划区间调整、模拟结果、通过 MCP 工具执行并验证。支持自主 run 模式，可在单个周期内扫描所有资金池，并重新调整任何发生偏移的头寸。

Agent 为何需要它

HODLMM 集中流动性只有在活跃 bin 位于你的头寸区间内时才能赚取手续费。价格变动时，活跃 bin 会偏离，而你的流动性将闲置——无法赚取收益，同时还面临无常损失。手动监控多个资金池并不现实。此技能可将被动 LP 存款转变为主动管理的头寸：跟踪你的 bin 所在位置和市场位置，并移动流动性以保持在区间内、持续赚取收益。

安全须知

  • 会向链上写入：提取流动性并重新存入新的 bin。会转移真实资金。
  • 偏移阈值：只有当活跃 bin 与头寸中心偏离 >= 3 个 bin 时才会重新调整（可配置）。
  • 冷却时间：同一资金池两次重新调整之间设有 30 分钟冷却时间，以防止频繁操作。
  • Gas 上限：每个周期最多 50 STX。若 Gas 估算值超过上限，则不会执行。
  • 小额过滤：忽略低于 5,000 聪的头寸，以避免无利可图的小额调整。
  • --confirm 门槛：recenter 命令需要显式传入 --confirm 标志。否则不会执行任何操作。
  • 手续费保留：按 bin 跟踪存款基准值。重新调整时，会收取高于基准值的手续费（予以保留）；仅重新部署本金。
  • 仅限主网：HODLMM 不支持测试网。
  • MCP 执行：实际链上交易通过 MCP 工具调用发出（bitflow_hodlmm_remove_liquidity、bitflow_hodlmm_add_liquidity）。由 Agent 运行时执行。

命令

doctor

检查钱包、HODLMM API 访问权限、资金池可用性、现有头寸以及 MCP 工具要求。只读，可随时安全运行。

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

分析所有 LP 头寸：偏移幅度、区间效率（活跃区间内 bin 的百分比）、预估手续费，以及是否需要重新调整。首次观察时会在本地记录手续费基准值；除此之外为只读操作。

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

试运行区间调整：模拟提取和重新存入，显示预期 bin 布局、收取的手续费及 Gas 成本。不会转移资金。

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

执行区间调整：从发生偏移的 bin 提取资金、收取手续费，并围绕活跃 bin 重新存入本金。需要 --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，写入 stdout。日志写入 stderr。

成功：

{ "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 会将当前状态记录为基准（直到下次检查前，估算费用均为零）
  • 仓位重新居中会通过两次连续的 MCP 调用执行（先提取，再存入）— 如果提取成功后存入交易失败，可能会发生部分失败。在这种情况下，资金仍在钱包中，并未丢失。状态会在 MCP 执行前乐观地记录；发生部分失败时，基准会重置，下一次调用 status 时会根据当前链上状态重新建立基准。
  • 计划步骤与重新居中步骤之间，当前活跃 bin 可能会发生变化。该技能会在执行时使用最新的活跃 bin。
  • HODLMM API（bff.bitflowapis.finance）可能会比链上状态落后 1-2 个区块
  • Gas 估算较为保守（2 笔交易按 4 STX 估算）。实际 Gas 通常更低。

评论

支持 Markdown