| name | defi-protocol |
| description | DeFi协议分析工具，基于简化恒定乘积公式(CPMM)计算TVL、滑点曲线与无常损失。适用于AMM机制学习与。基于简化恒定乘积公式，不考虑协议费用或多池路由，不适用于实盘交易或生产级协议审计。 |
| version | 1.0.0 |
| author | wangyi |
defi-protocol
DeFi 协议分析工具，实现 TVL 计算、流动性池状态分析、无常损失（Impermanent Loss）评估与收益率计算。仅使用 Python 标准库。
📌 说明：本工具基于简化模型实现和启发式方法。结果仅供学习参考，不构成投资建议或交易依据。
脚本API
calculate_tvl(locked_assets, token_prices)
计算总锁仓价值（TVL）。
必填: locked_assets, token_prices
calculate_tvl_ratios(market_cap, tvm, volume_24h, revenue_24h)
计算 TVL 相关比率指标。
必填: market_cap, tvm, volume_24h, revenue_24h
get_pool_price(reserve_a, reserve_b)
获取池中代币价格（A 相对 B 的价格）。
必填: reserve_a, reserve_b
calculate_trade_output(input_amount, input_reserve, output_reserve, fee_rate=0.003)
计算 CPMM 模型下的交易输出量。
必填: input_amount, input_reserve, output_reserve
calculate_slippage_curve(input_reserve, output_reserve, trade_sizes, fee_rate=0.003)
计算不同交易规模下的滑点曲线。
必填: input_reserve, output_reserve, trade_sizes
calculate_impermanent_loss(price_ratio)
计算无常损失。
必填: price_ratio
il_vs_hold(pool_reserves, initial_prices, current_prices)
对比流动性提供 vs 持币的价值。
必填: pool_reserves, initial_prices, current_prices
analyze_defi_protocol(locked_assets, token_prices, pool_reserves=None, price_ratio=None)
DeFi 协议综合分析。
必填: locked_assets, token_prices
调用示例
python scripts/main.py \
--price-ratio <price_ratio> \
