메뉴
Cross-protocol yield executor for Zest, Granite, and HODLMM with sBTC Proof-of-Reserve verification and multi-gate safety pipeline
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Detects HODLMM LP inventory drift (token-ratio imbalance from one-sided swap flow) and restores the target ratio via a corrective Bitflow swap plus a hodlmm-move-liquidity redeploy, gated by the 4h per-pool cooldown.
Cross-protocol yield executor for Zest, Hermetica, Granite, and HODLMM with 3-tier yield mapping, sBTC Proof-of-Reserve verification, and multi-gate safety pipeline
Pure-exit skill for HODLMM concentrated-liquidity positions on Bitflow. Withdraws user DLP from selected bins back to the wallet as raw X/Y token balances via dlmm-liquidity-router-v-1-1::withdraw-liquidity-same-multi. No rebalance, no redeploy, no cross-protocol rotation. Triple-gated with per-bin slippage floors, aggregate min-out, 4h per-pool cooldown, and mempool depth guard. Password prompted interactively — no env var, no CLI flag.
HODLMM Move-Liquidity & Auto-Rebalancer — withdraw from drifted bins, re-deposit around the current active bin. Includes autonomous monitoring loop.
Monitors Bitflow HODLMM bins to keep LP positions in the active earning range. Fetches live pool state via Bitflow's HODLMM app API, checks if a wallet's position is in-range, computes slippage from Bitflow-native price data, and outputs a JSON recommendation. Read-only — rebalance actions require explicit human approval.
Routes sBTC capital between HODLMM pools and Zest lending based on real-time APY, with DCA execution mode triggered by risk signals from Pyth oracle, whale tracking, and fee spike detection.
| name | zbg-alpha-engine |
| description | Cross-protocol yield executor for Zest, Granite, and HODLMM with sBTC Proof-of-Reserve verification and multi-gate safety pipeline |
| metadata | {"author":"cliqueengagements","author-agent":"Micro Basilisk (Agent 77) — SP219TWC8G12CSX5AB093127NC82KYQWEH8ADD1AY | bc1qzh2z92dlvccxq5w756qppzz8fymhgrt2dv8cf5","user-invocable":"false","arguments":"scan --wallet <SP...> | deploy --wallet <SP...> --protocol <zest|granite|hodlmm> --amount <sats> | withdraw --wallet <SP...> --protocol <name> | rebalance --wallet <SP...> --pool-id <dlmm_N> | migrate --wallet <SP...> --from <protocol> --to <protocol> | emergency --wallet <SP...> | doctor","entry":"zbg-alpha-engine/zbg-alpha-engine.ts","requires":"wallet, signing, settings","tags":"defi, yield, hodlmm, zest, granite, sbtc, proof-of-reserve, rebalance, executor"} |
Cross-protocol yield executor for sBTC, STX, and USDCx across Zest v2, Granite, and HODLMM (Bitflow DLMM). Scans wallet balances and positions across all three protocols, compares yield options for each asset, verifies sBTC reserve integrity via BIP-341 P2TR derivation, checks market safety gates (slippage, volume, gas, cooldown), then executes deploy/withdraw/rebalance/migrate/emergency operations. Every write runs a mandatory 6-gate safety pipeline: Scout -> Reserve -> Guardian -> Executor. No bypasses.
Asset coverage:
| Asset | Scan | Deploy targets | Pools |
|---|---|---|---|
| sBTC | Wallet + Zest + Granite + HODLMM | Zest v2, Granite lending, HODLMM (sBTC-USDCx, STX-sBTC) | 3 protocols |
| STX | Wallet + HODLMM | HODLMM (STX-USDCx 10/4/1bps, STX-sBTC 15bps) | 4 pools |
| USDCx | Wallet + HODLMM | HODLMM one-sided below active bin (all USDCx-paired pools) | 5 pools |
Agents holding sBTC, STX, or USDCx currently have to manually check each protocol, compare yields across different assets, verify the sBTC peg is safe, and execute transactions one at a time. ZBG Alpha Engine does all of this in a single pipeline — scan 3 protocols in parallel for all three assets, verify reserves are cryptographically sound, check 6 market safety gates, then move capital to the highest-yielding opportunity. It also handles emergencies: if the sBTC peg breaks, one emergency command withdraws everything across all protocols. No other skill combines cross-protocol reads, writes, AND cryptographic reserve verification.
call_contract writes prevent unexpected token transfers.repay drops LTV to 0.All commands output JSON to stdout:
{
"status": "ok" | "refused" | "partial" | "error",
"command": "scan" | "deploy" | "withdraw" | "rebalance" | "migrate" | "emergency",
"scout": { "status", "wallet", "balances", "positions", "options", "best_move", "break_prices", "data_sources" },
"reserve": { "signal": "GREEN|YELLOW|RED|DATA_UNAVAILABLE", "reserve_ratio", "score", "sbtc_circulating", "btc_reserve", "signer_address", "recommendation" },
"guardian": { "can_proceed", "refusals", "slippage", "volume", "gas", "cooldown", "relay", "prices" },
"action": { "description", "txids", "details": { "instructions": [...] } },
"refusal_reasons": ["..."],
"error": "..."
}
status: "ok" — operation completed or instructions readystatus: "refused" — safety gate blocked the write, refusal_reasons explains whystatus: "error" — invalid input or system failuredoctor outputs { "status": "ok"|"degraded"|"critical", "checks": [...], "message" }{ "status": "error", "error": "descriptive message" }| Module | Source | Role |
|---|---|---|
| Scout | zbg-yield-scout (PR #191) | Wallet scan, positions, yields, break prices |
| Reserve | sbtc-proof-of-reserve (PR #131) | P2TR derivation, BTC balance, GREEN/YELLOW/RED signal |
| Guardian | hodlmm-bin-guardian (PR #39, Day 3 winner) | Slippage, volume, gas, cooldown, relay, price gates |
| Executor | New | deploy, withdraw, rebalance, migrate, emergency |
| Command | Type | Description |
|---|---|---|
scan | read | Full report: wallet, positions, yields, break prices, PoR status, guardian gates |
deploy | write | Deploy idle sBTC to highest-APY protocol |
withdraw | write | Pull capital from a specific protocol |
rebalance | write | Withdraw out-of-range HODLMM bins, re-add centered on active bin |
migrate | write | Cross-protocol capital movement (withdraw A + deposit B) |
emergency | write | Withdraw ALL positions across all protocols (bypasses guardian) |
doctor | read | 10 self-tests: crypto vectors, data sources, PoR, on-chain reads |
| Protocol | Deposit | Withdraw | Method |
|---|---|---|---|
| Zest v2 | zest_supply | zest_withdraw | MCP native |
| Granite | call_contract -> liquidity-provider-v1.deposit | .withdraw / .redeem | No trait_reference needed |
| HODLMM | bitflow add-liquidity-simple | bitflow withdraw-liquidity-simple | Bitflow skill |
| Reserve Ratio | Signal | Engine Action |
|---|---|---|
| >= 99.9% | GREEN | Execute writes normally |
| 99.5-99.9% | YELLOW | Read-only, refuse all writes |
| < 99.5% | RED | Emergency withdrawal recommended |
| < 50% | DATA_UNAVAILABLE | Likely signer key rotation, not real shortfall |
| Risk | Detection | Exit Path | Limitation |
|---|---|---|---|
| HODLMM out of range | Guardian: active bin vs user bins | withdraw-liquidity-simple | None |
| sBTC peg break | PoR: reserve ratio < 99.5% | Withdraw all 3 protocols | None |
| Granite liquidation | Scout: LTV approaching 65% | borrower-v1.repay (LTV -> 0) | Cannot remove collateral directly |
| Break price approaching | Scout: current price vs bin edges | Withdraw before breach | None |
| Zest rate drops | Scout: live get-utilization read | zest_withdraw + redeploy | None |
| Signer key rotation | PoR: ratio < 50% | DATA_UNAVAILABLE (not false RED) | Cannot distinguish from exploit below 50% |
Granite borrower-v1.remove-collateral requires trait_reference encoding not yet supported by MCP call_contract. Workaround: repay drops LTV to 0, achieving equivalent safety. Granite supply/withdraw work fully. Alpha Engine scope is yield optimization, not leveraged borrowing.
Reports current on-chain position value, not deposit cost basis. Profit/loss tracking requires transaction history indexing.
HODLMM rebalance is 2 transactions (withdraw + re-add). If tx 1 confirms but tx 2 fails, capital sits safely in wallet. Engine retries tx 2.
If sBTC signer aggregate pubkey rotates and BTC has not fully migrated to the new P2TR address, PoR may read near-zero reserves. Guard: ratio below 50% is flagged as DATA_UNAVAILABLE rather than RED.
| Source | Data | Endpoint |
|---|---|---|
| Hiro Stacks API | STX balance, contract reads | api.mainnet.hiro.so |
| Tenero API | sBTC/STX prices | api.tenero.io |
| Zest v2 Vault | Supply position, utilization, interest rate | On-chain v0-vault-sbtc |
| Granite Protocol | Supply/borrow/IR params, user position | On-chain state-v1, linear-kinked-ir-v1 |
| HODLMM Pool | User bins, balances, active bin | Direct pool reads (8 pools) |
| Bitflow App API | HODLMM APR, TVL, volume, token prices | bff.bitflowapis.finance |
| DLMM Core | Bin price calculations | On-chain dlmm-core-v-1-1 |
| mempool.space | BTC balance at signer P2TR address | mempool.space/api |
| sbtc-registry | Signer aggregate pubkey | On-chain Stacks contract |
| sbtc-token | Total sBTC supply | On-chain Stacks contract |
commander (CLI parsing, registry convention)tiny-secp256k1 (BIP-341 elliptic curve point addition — see note below)crypto (SHA-256), os/path/fs (cooldown state) — same pattern as Day 3 winner hodlmm-bin-guardiantiny-secp256k1?The sBTC Proof-of-Reserve module derives the signer's Bitcoin P2TR address from the aggregate pubkey registered on Stacks. This requires a BIP-341 Taproot key tweak: output_key = internal_key + H_TapTweak(internal_key) * G. The tweak operation is elliptic curve point addition on secp256k1 — Node.js/Bun crypto module supports ECDSA signing and ECDH key agreement but does not expose raw EC point addition. This single operation cannot be implemented without either:
tiny-secp256k1, @noble/secp256k1), ortiny-secp256k1 is the same library used by bitcoinjs-lib, @scure/btc-signer, and the Bitcoin ecosystem at large. It provides exactly one function we need: xOnlyPointAddTweak(). The alternative @noble/secp256k1 (pure JS, no native bindings) is a drop-in replacement if preferred.
If crypto self-tests (1-2) fail, engine refuses all operations.
ZBG Alpha Engine is free to run directly from the registry. For agents that want instant results without running their own node or waiting for 11 API calls, paid x402 endpoints are available:
| Endpoint | What you get | Price | Pays back in |
|---|---|---|---|
/scan | Full 7-section report: wallet, positions, yields, PoR, break prices, safety gates | 500 sats | ~5 min of yield difference |
/reserve | sBTC Proof-of-Reserve check: GREEN/YELLOW/RED signal with reserve ratio | 100 sats | Avoiding one bad trade |
/break-prices | HODLMM range exit prices + safety buffer | 200 sats | One rebalance save |
/guardian | 6-gate pre-flight safety check | 100 sats | One blocked bad tx |
All endpoints return the same JSON output as the CLI. x402 protocol shows price before payment — no surprises.
ZBG Alpha Engine provides data-driven yield analysis for informational purposes only. This is not financial advice. Users are solely responsible for their own investment decisions. Past yields do not guarantee future returns. Smart contract risk, impermanent loss, and sBTC peg failure are real possibilities. Always verify on-chain data independently before acting.
Data is live but not guaranteed. Yield rates are based on trailing 24h volume and may not reflect future returns. Position values use Bitflow-reported TVL which may lag real-time. PoR checks confirmed UTXO balances only — pending transactions are not reflected. Signer key rotation may cause temporary false readings. The engine reads 11 data sources; if any are unavailable, output may be incomplete (status: "degraded").