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) - INLINECODE3 for real wallet onchain exposure
- INLINECODE4 for manual/API fallback wallet summary
- INLINECODE5 for hypothetical borrow impact
- INLINECODE6 for deposit preview/broadcast flow (approve + mint)
- INLINECODE7 for withdraw preview/broadcast flow (redeem / redeemUnderlying) with post-withdraw HF prediction and safety line checks (default 1.2, user customizable)
- INLINECODE8 for borrow preview/broadcast flow
- INLINECODE9 for repay preview/broadcast flow (approve + repayBorrow)
- INLINECODE10 for collateral enable/disable (enterMarkets / exitMarket)
- INLINECODE11 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) - INLINECODE13 (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)
- Risk status (Low/Medium/High + why)
- Safe range (max suggested extra borrow or required extra collateral)
- 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: INLINECODE15
- Market + auto wallet risk check: INLINECODE16
- What-if borrow (auto wallet): INLINECODE17
- Manual fallback: INLINECODE18
- English brief mode: INLINECODE19
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: INLINECODE25
- Risk thresholds and formulas: INLINECODE26
- Contract/address notes: INLINECODE27
- Terminology: INLINECODE28
- Venus CLI cookbook: INLINECODE29
- Flux CLI cookbook: INLINECODE30
- Flux BNB addresses: INLINECODE31
Venus Protocol 操作
概述
使用此技能提供
只读、风险感知的Venus Protocol分析。优先考虑清算安全、清晰度和明确的不确定性,而非激进的收益追求。
工作流程
1) 分类用户意图
将请求映射为以下模式之一:
- - 市场扫描:比较资产/池(供应APY、借款APY、利用率、限额)
- 仓位检查:评估钱包当前的抵押品/借款健康度
- 假设模拟:估算提议的借款/供应/还款后的风险
- 执行规划:准备分步操作,不广播交易
如果用户要求链上执行,暂停并请求明确确认+精确参数。先使用模拟,仅在用户确认后广播。
2) 收集数据
优先使用脚本:
- - scripts/fetchmarkets.py 用于市场快照(官方API基础地址:https://api.venus.io,默认范围:仅核心池,通过 references/pool-filter.json)
- scripts/walletonchainexposure.py 用于真实钱包链上敞口
- scripts/checkwalletexposure.py 用于手动/API回退钱包摘要
- scripts/simulateborrow.py 用于假设借款影响
- scripts/venusdeposit.js 用于存款预览/广播流程(授权+铸造)
- scripts/venuswithdraw.js 用于提现预览/广播流程(赎回/redeemUnderlying),包含提现后HF预测和安全线检查(默认1.2,用户可自定义)
- scripts/venusborrow.js 用于借款预览/广播流程
- scripts/venusrepay.js 用于还款预览/广播流程(授权+repayBorrow)
- scripts/venuscollateral.js 用于启用/禁用抵押品(enterMarkets / exitMarket)
- scripts/hfmonitor.py 用于基于阈值的HF监控和咨询操作(当HF低于安全线时包含ACCOUNT_UNHEALTHY警报,默认1.2)
市场查询示例:
- - python scripts/fetchmarkets.py --chain-id 56 --limit 200(核心池默认)
- python scripts/fetchmarkets.py --chain-id 56 --limit 200 --pool-scope all(所有池)
如果API不可用,继续使用透明假设,并将输出标记为估算值。
3) 运行风险规则
应用 references/risk-rules.md 中的规则:
- - 计算健康度和安全缓冲
- 标记借款限额/流动性限制
- 检测集中度风险(单一波动性抵押品)
- 风险分类:低 / 中 / 高
4) 生成可操作输出
始终包含:
- 1. 当前状态(关键数字)
- 风险状态(低/中/高 + 原因)
- 安全范围(建议的最大额外借款或所需额外抵押品)
- 下一步最佳操作(2-4个具体步骤)
优先使用简洁的要点和精确数字。
输出格式
使用以下结构:
- - 摘要:一行结论
- 指标:抵押品、债务、健康度、利用率、APY
- 风险发现:前2-4个风险
- 推荐计划:具体步骤和限制
- 假设:数据新鲜度、缺失字段、估算标记
护栏
- - 绝不声称保证安全或回报。
- 绝不隐藏数据缺口;明确标注过时/缺失数据。
- 不确定时默认采用保守阈值。
- 将其视为教育/风险工具,而非财务建议。
- 对于真实交易:先运行模拟模式;广播需明确确认。
- 对于提现:始终预测提现后HF;当预测HF低于安全线时警告/阻止(默认1.2,除非用户自定义)。
快速使用
- - 单命令市场检查:python scripts/venuscheck.py --symbol vUSDT
- 市场+自动钱包风险检查:python scripts/venuscheck.py --symbol vUSDT --wallet 0x...
- 假设借款(自动钱包):python scripts/venuscheck.py --symbol vUSDT --wallet 0x... --extra-borrow 120
- 手动回退:python scripts/venuscheck.py --symbol vUSDT --wallet 0x... --weighted-collateral 1500 --debt 1000
- 英文简洁模式:python scripts/venus_check.py --symbol vUSDT --wallet 0x... --output brief --lang en
协议分离
- - Venus核心脚本:scripts/ 根目录(例如 venus*.js、fetchmarkets.py、walletonchainexposure.py)。
- Flux(由Fluid驱动)脚本:scripts/flux/。
- 直接选择协议特定脚本,以便其他代理快速路由,避免工作流混淆。
参考资料
- - 协议概述:references/protocol-overview.md
- 风险阈值和公式:references/risk-rules.md
- 合约/地址说明:references/bnbchain-contracts.md
- 术语表:references/glossary.md
- Venus CLI手册:references/quick-commands.md
- Flux CLI手册:references/flux-quick-commands.md
- Flux BNB地址:references/flux-bnb-addresses.json