ERC20 代币经济模型构建器

端到端代币上线就绪流程：分配设计 → 锁仓合约 → 流动性建模 → 投资人文档。

工作流

1. 收集输入参数 — 总供应量、各分配比例、解锁时间表、融资目标、上市价格
2. 构建分配表 — 分类、数量、百分比、解锁逻辑
3. 生成锁仓时间表 — 使用 OpenZeppelin VestingWallet 实现 Cliff + 线性释放
4. 建模 Uniswap 流动性 — 初始价格、资金池深度、滑点目标
5. 起草投资人文档 — 代币销售摘要、SAFT 背景说明、锁仓证明

1. 分配表

标准分配类别（请根据项目实际情况调整）：

输出格式： Markdown 表格 + 适用于投资人演示材料的 CSV 文件。

2. OpenZeppelin VestingWallet

OZ VestingWallet 原生支持 Cliff + 线性释放机制。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import "@openzeppelin/contracts/finance/VestingWallet.sol";

// 每个受益人部署一个实例（或使用工厂合约）
// constructor(address beneficiary, uint64 startTimestamp, uint64 durationSeconds)

// 示例：团队成员适用 12 个月 Cliff + 24 个月线性释放
// start = TGE 时间戳 + 12 个月（通过将 start 设为 Cliff 结束时间，隐式实现 Cliff）
// duration = 24 个月（从 start 开始线性释放）

VestingWallet teamVest = new VestingWallet(
    teamMemberAddress,
    uint64(tgeTimestamp + 365 days),   // 在 12 个月 Cliff 后开始释放
    uint64(730 days)                    // 24 个月线性锁仓期
);

关键方法：

• release(token) — 受益人调用以申领已归属代币
• vestedAmount(token, timestamp) — 查询指定时间点可解锁代币数量
• releasable(token) — 当前可申领余额

Cliff 实现方式： 设置 startTimestamp = TGE + cliffDuration。Cliff 结束后自动进入线性释放阶段，无需额外编码。

多受益人工厂模式：参见 references/vesting-factory.md

3. 锁仓时间表建模

计算每个类别的月度解锁数量：

Cliff 后每月解锁量 = （分配代币数 / 锁仓月数）
TGE 解锁量 = 分配代币数 × TGE 解锁比例
剩余待释放量 = 分配代币数 × (1 − TGE 解锁比例)
Cliff 后每月线性释放量 = 剩余待释放量 / Cliff 后锁仓月数

流通供应量预测公式：

CS(t) = Σ [tge_i + max(0, (t - cliff_i) / vest_i) × (1 - tge_pct_i)] × supply_i

其中 t 表示自 TGE 起经过的月份数，i 表示各分配类别。

在表格中逐月建模至第 48 个月。若某月解锁量 > 当前流通供应量的 5%，则标记为高抛压风险月份。

4. Uniswap 流动性建模

v2 资金池设置（恒定乘积公式：x * y = k）

初始价格 = ETH 数量 / TOKEN 数量  
k = ETH 数量 × TOKEN 数量

交易规模为 S 时的滑点：
  价格影响 = S / (ETH 储备量 + S)
  可获得代币数 = TOKEN 储备量 × S / (ETH 储备量 + S)

建议：典型散户交易规模下的价格影响 < 1%
→ 所需资金池深度 = 交易规模 / 0.01

示例： 目标支持 $10,000 散户交易且滑点 < 1% → 需资金池 TVL 达 $1M

v3 集中流动性

• 定义价格区间：[P_low, P_high]，其中 P 表示代币以 ETH/USDC 计价的价格
• 推荐初始区间：围绕上市价格上下浮动 ±20–30%
• 集中流动性资本效率约为 v2 的 10 倍（仅在区间内）
• 使用 tickLower / tickUpper = log(price) / log(1.0001)

上市价格发现：

FDV_target = 总供应量 × 上市价格
Implied_MC = 流通供应量 × 上市价格
流动性比率 = 资金池 TVL / MC → 健康启动目标为 5–15%

更深入的 tick/区间计算请参阅 references/uniswap-math.md。

5. 投资人文档模板

代币销售摘要（含 SAFT 背景）

## 代币：[NAME] ($TICKER)
- 总供应量：X,000,000,000
- TGE 日期：[DATE]
- 网络：Ethereum / [L2]
- 合约地址：[0x...]

## 本轮详情
- 轮次：种子轮 / 私募轮 / 战略轮
- 融资额：$X，单价 $Y/token → $Z FDV
- 分配比例：总供应量的 X%
- 锁仓安排：X 个月 Cliff，X 个月线性释放，TGE 解锁 X%
- VestingWallet：[合约地址 或 “待部署”]

## 代币释放时间表
[本批次按月解锁表格]

## 资金用途
[明细拆分]

面向投资人的锁仓证明

部署 VestingWallet 后，应提供以下信息：

• 合约地址
• Etherscan 链接
• vestedAmount(tokenAddress, block.timestamp) 调用结果
• 下一次释放里程碑日期

6. 常见陷阱

• 团队在 TGE 解锁比例过高 → 释放抛售信号；建议 Cliff 前保持 0%
• 流动性不足 MC 的 5% → 易受价格操控
• 顾问无 Cliff 锁定期 → 导致廉价“纸手”行为
• 上市时 FDV 过高 → 长期压制代币价格
• 缺少 release() 自动化机制 → 受益人易遗忘申领；建议使用 keeper 脚本
• 为整个团队共用单个 VestingWallet → 应为每位成员单独部署钱包，确保股权结构清晰

参考资料

• references/vesting-factory.md — Solidity VestingWallet 工厂合约 + 批量部署方案
• references/uniswap-math.md — Uniswap v2/v3 Tick 数学与流动性公式详解
• references/allocation-templates.md — 针对 DeFi、GameFi、DAO、基础设施等场景预置的分配表模板

本技能不涵盖范围

• 已部署合约审计 → 请使用 solidity-audit-precheck
• LP 头寸监控 / 无常损失追踪 → 请使用 defi-position-tracker
• Safe/多签金库管理 → 请使用 multi-sig-treasury
• 通用 ERC20 合约升级 → 请使用 upgrade-solidity-contracts