venus-protocol-ops

# Venus Protocol Ops ## Overview Use this skill to provide **read-only**, risk-aware analysis for Venus Protocol. Prioritize liquidation safety, clarity, and explicit uncertainty over aggressive yield-chasing. ## Workflow ### 1) Classify user intent Map request into one of these modes: - **Market scan**: compare assets/pools (supply APY, borrow APY, utilization, caps) - **Position check**: assess a wallet's current collateral/borrow health - **What-if simulation**: estimate risk after a proposed borrow/supply/repay - **Execution planning**: prepare step-by-step actions without broadcasting tx If user asks for onchain execution, pause and request explicit confirmation + exact parameters. Use simulation first, then broadcast only after user confirms. ### 2) Collect data Use scripts first: - `scripts/fetch_markets.py` for market snapshot (official API base: `https://api.venus.io`, default scope: Core Pool only via `references/pool-filter.json`) - `scripts/wallet_onchain_exposure.py` for real wallet onchain exposure - `scripts/check_wallet_exposure.py` for manual/API fallback wallet summary - `scripts/simulate_borrow.py` for hypothetical borrow impact - `scripts/venus_deposit.js` for deposit preview/broadcast flow (approve + mint) - `scripts/venus_withdraw.js` for withdraw preview/broadcast flow (redeem / redeemUnderlying) with post-withdraw HF prediction and safety line checks (default 1.2, user customizable) - `scripts/venus_borrow.js` for borrow preview/broadcast flow - `scripts/venus_repay.js` for repay preview/broadcast flow (approve + repayBorrow) - `scripts/venus_collateral.js` for collateral enable/disable (enterMarkets / exitMarket) - `scripts/hf_monitor.py` for threshold-based HF monitoring and advisory actions (includes ACCOUNT_UNHEALTHY alert when HF < safety line, default 1.2) Example market query: - `python scripts/fetch_markets.py --chain-id 56 --limit 200` (Core Pool default) - `python scripts/fetch_markets.py --chain-id 56 --limit 200 --pool-scope all` (all pools) If API is unavailable, continue with transparent assumptions and mark output as estimate. ### 3) Run risk rules Apply rules from `references/risk-rules.md`: - Compute health and safety buffer - Flag borrow-cap / liquidity constraints - Detect concentration risk (single volatile collateral) - Classify risk: Low / Medium / High ### 4) Produce actionable output Always include: 1. **Current state** (key numbers) 2. **Risk status** (Low/Medium/High + why) 3. **Safe range** (max suggested extra borrow or required extra collateral) 4. **Next best actions** (2-4 concrete steps) Prefer concise bullets and exact numbers. ## Output format Use this structure: - **Summary**: one-line verdict - **Metrics**: collateral, debt, health, utilization, APYs - **Risk findings**: top 2-4 risks - **Recommended plan**: concrete steps and limits - **Assumptions**: data freshness, missing fields, estimate flags ## Guardrails - Never claim guaranteed safety or returns. - Never hide data gaps; explicitly note stale/missing data. - Default to conservative thresholds when uncertain. - Treat this as educational/risk tooling, not financial advice. - For real transactions: run simulate mode first; require explicit confirmation for broadcast. - For withdrawals: always predict post-withdraw HF; warn/block when predicted HF falls below safety line (default 1.2 unless user customizes). ## Quick usage - One-command market check: `python scripts/venus_check.py --symbol vUSDT` - Market + auto wallet risk check: `python scripts/venus_check.py --symbol vUSDT --wallet 0x...` - What-if borrow (auto wallet): `python scripts/venus_check.py --symbol vUSDT --wallet 0x... --extra-borrow 120` - Manual fallback: `python scripts/venus_check.py --symbol vUSDT --wallet 0x... --weighted-collateral 1500 --debt 1000` - English brief mode: `python scripts/venus_check.py --symbol vUSDT --wallet 0x... --output brief --lang en` ## Protocol separation - Venus Core scripts: `scripts/` root (e.g. `venus_*.js`, `fetch_markets.py`, `wallet_onchain_exposure.py`). - Flux (Power by Fluid) scripts: `scripts/flux/`. - Choose protocol-specific scripts directly so other agents can route quickly without mixing workflows. ## References - Protocol overview: `references/protocol-overview.md` - Risk thresholds and formulas: `references/risk-rules.md` - Contract/address notes: `references/bnbchain-contracts.md` - Terminology: `references/glossary.md` - Venus CLI cookbook: `references/quick-commands.md` - Flux CLI cookbook: `references/flux-quick-commands.md` - Flux BNB addresses: `references/flux-bnb-addresses.json`