mcpField
H
hodlmm-signal-allocator

hodlmm-signal-allocator

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

关于 hodlmm-signal-allocator

一个用于评估 HODLMM 配置时机并在满足条件后执行 Bitflow 兑换的 DeFi skill，面向需要按信号调整钱包代币比例的 Agent。它结合宏观信号与量子风险评分，并在每次兑换前执行五项安全检查。

主要功能

  1. 01读取 HODLMM 24 小时 APR
  2. 02评估获批宏观信号与量子风险
  3. 03五项安全门控兑换
  4. 04支持模拟与确认后执行
  5. 05以 JSON 输出结果和交易链接

适用场景

  1. 01筛选是否适合进入 HODLMM
  2. 02根据 APR 与信号调整 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

详细介绍

功能

依次读取三个实时数据源——当前 HODLMM 池的 24 小时 APR、aibtc.news bitcoin-macro 节拍中的已批准信号，以及 Bitcoin Developer Quantum Readiness Index——并计算一个风险调整后收益评分。当该评分超过最低阈值（≥60）且五项安全检查全部通过时，执行 Bitflow 兑换（STX → sBTC），使钱包配置符合最佳 HODLMM 入场存款要求。每次执行都会记录信号 ID、准备度指数快照和 Hiro 浏览器链接。

Agent 为什么需要它

进入 HODLMM 仓位需要满足两项要求，而大多数 Agent 会分别处理：判断宏观条件何时适合配置收益资产，以及在当前区间拥有合适的代币比例。依据过时或低质量信号操作的 Agent，往往会在不利时期过度配置 HODLMM，并在收益激增时配置不足。此技能通过根据信号质量和量子风险控制兑换，弥补这一缺口——如果情报层没有信号或无法确定，此技能就不会采取任何操作，并说明原因。

此目录中的其他技能都不会将新闻信号情报与量子准备度风险调整结合起来，作为 DeFi 执行门槛。

安全说明

任何兑换开始前，都会依次执行五项硬编码检查：

  1. 信号质量检查——signal_score < 60 → status: "blocked"。根据 aibtc.news 已批准的 bitcoin-macro 信号得出，时间窗口为 24 小时，并按时效加权。
  2. 量子风险检查——(100 - readiness_index) / 100 × 0.2 > 0.15 → status: "blocked"。Quantum Power Map 必须显示准备度指数 ≥ 25，才会继续进行长期 HODLMM 配置。
  3. 支出上限——--amount-stx 的硬编码上限为 500 STX。超过此金额会返回 status: "blocked"。
  4. STX 储备——兑换后钱包必须保留 ≥ 10 STX 用于 Gas。不满足时将拒绝执行。
  5. 价格影响——Bitflow 报价必须显示价格影响 ≤ 1.5%。价差更大时会返回 status: "blocked"。

实时执行必须使用 --confirm。如果未提供该参数，run 会返回完整的模拟输出，状态为 status: "blocked"，原因是 CONFIRM_REQUIRED。冷却时间：两次执行间隔 6 小时，通过 ~/.hodlmm-signal-allocator-state.json 强制执行。

命令

命令描述
doctor健康检查：Bitflow API、aibtc.news signals 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。

输出约定

所有命令都会向 stdout 输出单个 JSON 对象：

{
  "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 的 Gas 储备）
  • 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