hodlmm-signal-allocator

What it does

Reads three live data sources in sequence — the active HODLMM pool's 24h APR, approved signals from the aibtc.news bitcoin-macro beat, and the Bitcoin Developer Quantum Readiness Index — and computes a single risk-adjusted yield score. When that score exceeds the minimum threshold (≥60) and five safety gates pass, it executes a Bitflow swap (STX → sBTC) to align the wallet for optimal HODLMM deposit entry. Every execution is logged with signal IDs, readiness index snapshot, and the Hiro explorer link.

Why agents need it

Entering a HODLMM position requires two things most agents handle separately: knowing when macro conditions favor a yield allocation, and having the right token ratio at the active bin. Agents acting on stale or low-quality signals over-allocate to HODLMM during unfavorable windows and under-allocate during yield spikes. This skill closes that gap by gating the swap on verified signal quality and quantum risk — if the intelligence layer is silent or uncertain, the skill does nothing and says why.

No other skill in this registry combines news signal intelligence with Quantum Readiness risk adjustment as a DeFi execution gate.

Safety notes

Five hard-coded gates execute in order before any swap:

1. Signal quality gate — signal_score < 60 → status: "blocked". Derived from aibtc.news approved bitcoin-macro signals, 24h window, recency-weighted.
2. Quantum risk gate — (100 - readiness_index) / 100 × 0.2 > 0.15 → status: "blocked". Quantum Power Map must show Readiness Index ≥ 25 before long-duration HODLMM allocation proceeds.
3. Spend cap — --amount-stx hard-coded max: 500 STX. Amounts above this return status: "blocked".
4. STX reserve — wallet must retain ≥ 10 STX post-swap for gas. Refused if not satisfied.
5. Price impact — Bitflow quote must show ≤ 1.5% price impact. Wider spreads return status: "blocked".