王侯将相宁有种乎

王侯将相宁有种乎 是一种无许可的联合曲线代币发行协议, 由若干彼此独立的「朝代」组成一条开放、无终点的序列. 每个朝代为独立的 ERC-20 代币, 配以独立的指数型联合曲线及参数对 (K, S_N), N >= 1. 本协议的核心机制为时间衰减型供应阈值: 第 N 代允许新增铸造, 直至累计公允供应达到 K 的 threshold(N, t) 比例; 该阈值自启动时的 99% 在 24 小时内线性衰减至 80%, 其后永久锁定. 当阈值被跨越时, 当前朝代立即终结, 下一朝代在同一交易内启动. 终结时刻协议金库的 30% 被快照分配至对应朝代的分红池, 持有者可经跨代焚毁函数赎回新代币与按 fair-share 比例的分红 —— 因终结后该代 sell 关闭, 唯一减少 totalMintedFair 的路径就是 burn 自身, 故每 fair-unit 在终结瞬间锁定 D / s₀ ETH, 焚毁次序无关; 永不焚毁的份额永久锁在合约中, 不被他人瓜分. 协议无管理员, 无升级路径, 无暂停开关, 所有经济常量于部署时固化于字节码. 本协议作为 Uniswap V4 hook 部署于 Ethereum 主网.

本协议把传统 launchpad 的「单代币 + 单条曲线」改写为「多代独立代币 + 多条独立曲线 + 一条朝代演替规则」. 每一代供应上限 K = 21M 固定 (等同的 token 席位), 曲线尺度 S_N = S_BASE × 2^(N-1) 每代翻倍 (trigger 所需 ETH 翻倍 + 入场单价 P(0) = S_N / K 翻倍). 「王侯将相宁有种乎」即在朝代层面成立: 每代受同一套规则约束 (相同的 K, 相同的 99→80% 阈值时间表, 相同的 1% 税, 相同的 burn 机制), 但晚到的代须以更多 ETH 推过 trigger, 开盘价亦随之翻倍 —— 是「流程平等而非起点平等」, 用「中兴之代门槛递增」narrative 承接.

你可以做的事有三件: (i) 在当前活跃朝代买入其代币, 跨过其当前阈值的那笔买入直接推动朝代切换并领取 protocolFund 的 5% 触发奖励; (ii) 在当前活跃代沿曲线卖出其代币 (终结后该代不再接受卖出); (iii) 持有夕阳代时调用 burnOldForLatest, 按其曲线等价值兑换为最新代代币, 并领取按比例的分红.

收益来源有三: 曲线本身的价格上涨 (鼎盛朝代约 100x, 衰世朝代约 5x, 详见 §5); 跨代焚毁的分红 (夕阳代被销毁瞬间从该代分红池按 fair-share 领取 ETH, 详见 §7); 以及推进朝代切换的 5% 触发奖励. 损失来源亦透明: 买入价高于当前曲线价, 卖出按 1% 税扣除, 持有夕阳代但永不焚毁则那份分红永久锁在合约里 (协议沉淀, 不被他人瓜分).

本文规范 王侯将相宁有种乎 协议 (以下称「协议」) 的设计与运行规则. 协议由开放, 无终点的朝代序列构成, N >= 1: 第 1–12 代以中国历史朝代命名 (夏 -> 现代), 第 13 代起以 50 年步进的未来年份命名 (1950, 2000, 2050, ...). 每一朝代构成一个自治市场, 其定价由确定性的指数型联合曲线生成, 并由唯一的, 依赖时间的触发条件决定其终结时点.

本协议的设计贡献.

1.1 时间衰减阈值. 将朝代终结条件与单一固定上限解耦. 同一朝代在「早期需求充裕, 阈值尚高时被推过」与「衰减结束后缓慢逼近 80% 下限」两种情形下呈现性质迥异的均衡 (详见 §5).

1.2 跨代实时分红. 跨代焚毁函数与实时分红分母配合, 对夕阳代币持有者提供延迟赎回的显式经济激励, 从结构上抑制朝代切换瞬时的抛压 (详见 §7).

1.3 完全不可变. 所有经济常量于部署时固化于字节码, 无 owner / pauser / proxy; 协议演替仅为公开市场行为与时间的纯函数 (详见 §10).

设 N 为朝代序号, N >= 1. 设 K 为供应上限, K := 21,000,000 (单位 10^18 wei 代币), 在所有朝代上恒等. 设 S_N 为第 N 代曲线尺度, S_N := S_BASE * 2^(N-1). 设 t 为自第 N 代启动以来的经过时间. 设 supply_N(τ) 为协议时间 τ 时第 N 代的累计公允铸造供应, cumulativeEth_N(τ) 为同时刻投入第 N 代曲线的累计计价代币.

设 protocolFund 为协议金库的全局会计变量, distributionPool_N 为第 N 代终结时所快照的分红池 (按代独立). 常量 S_BASE 于部署时固定为 60 ETH. K 为部署时固化的 21M 常量, 不随 N 变化; 比值 P(0)_N = S_N / K = (S_BASE / K) * 2^(N-1) 每代翻倍, 即晚到的代开盘价更贵. 这是「K 固定 + S 翻倍」组合的数学必然: K 不变以保证每代 token 上限同等 (流程平等), S 翻倍以让 trigger ETH 翻倍 (承载力门槛递增), 两者协调后 P(0) = S/K 必随之翻倍.

在第 N 代内部, 公允供应与边际价格皆为投入该朝代曲线的累计计价代币的确定性函数:

mint(eth) = K * (1 - exp(-eth / S_N))
price(eth) = (S_N / K) * exp(eth / S_N)

供应函数严格单调递增且以 K 为上界; 价格函数严格单调递增且无上界. 对 mint(·) 求逆即得卖出路径所用的反曲线. 该曲线在 Curve.sol 中以 prb-math 的 UD60x18 定点数库实现.

由直接代换可得, 达到供应比例 θ := supply / K 所需的累计计价代币与对应的边际价格分别为:

eth(θ) = -S_N * ln(1 - θ)
price(θ) / price(0) = 1 / (1 - θ)

故价格相对入场单价的倍数仅为 1 / (1 - θ), 与 N 无关. 这是本协议在所有代上行为一致的根因.

Gen 1 数值演算 (S_1 = 60 ETH, K_1 = 21,000,000 token)

• 入场单价. S_1 / K_1 ~= 2.857 * 10^-6 ETH/token.
• 50% 供应. eth(0.50) = 60 * ln(2) ~= 41.59 ETH 累计投入; 边际价 = 2 * 入场价.
• 80% 供应 (衰世触发线). eth(0.80) = 60 * ln(5) ~= 96.57 ETH; 边际价 = 5 * 入场价.
• 99% 供应 (鼎盛触发线). eth(0.99) = 60 * ln(100) ~= 276.31 ETH; 边际价 = 100 * 入场价.
• 结构性比值. eth(0.99) / eth(0.80) ~= 2.86, 即将一朝代推至鼎盛比之停留于下限多花约 2.86 倍累计 ETH.

第 N 代在年龄 t 时的触发阈值定义为:

threshold(N, t) = 0.80 + 0.19 * max(0, 1 - t / 24h)

t = 0 时阈值为 0.99, t >= 24h 时阈值恒为 0.80; 该函数关于 t 连续且单调非增.

协议在所有可能增加供应的操作上验证 supply_N >= threshold(N, t) * K: 买入函数 buy(), 以及焚向当前活跃朝代的 burnOldForLatest(). 卖出函数 sell() 永远不推进触发. 任何使供应跨越阈值的买入或跨代焚毁将在同一交易内将第 N 代终结并启动第 N+1 代; 该交易的发送者将获得 protocolFund 的 5% 作为触发奖励. 协议不提供任何无需买家或焚毁者即可推进朝代演替的外部入口.

任何使供应跨越阈值的买入或跨代焚毁都会原子地完成朝代演替, 并向发送者支付 5% 奖励. 协议不提供任何无需买家或焚毁者即可推进朝代的入口.

由于阈值随时间衰减而供应单调非减, 每一朝代必终结于以下两种状态之一. 设 θ* 为终结时刻供应比例, 则该代终态市值 (按边际价计) 与单代纸面收益分别为:

marketCap*(N) = K * price(θ*) = S_N * θ* / (1 - θ*)
paperGain(θ*) = price(θ*) / price(0) = 1 / (1 - θ*)

• 5.1 · 鼎盛朝代 · 触发发生在 threshold(N, t) 仍接近 99% 时; θ* ~= 0.99 -> 终态市值约 99 * S_N, 单代纸面收益约 100 倍.
• 5.2 · 衰世朝代 · 触发发生在阈值已衰减至 80% 下限或其附近, 且增量买入逐步将供应顶上下限之时; θ* ~= 0.80 -> 终态市值约 4 * S_N, 单代纸面收益约 5 倍.

协议本身对两种结局不作偏好. 指数型曲线设定了乘性差距, 市场参与者共同决定每一朝代实际落入哪一均衡.

第 N 代触发条件成立时, 合约在同一交易中执行:

1. 将第 N 代标记为 sunset; 后续对该代的买入与卖出均被拒, 持有者唯一退出路径为 burnOldForLatest 跨代焚毁;
2. 将活跃 protocolFund 的 30% 快照至 distributionPool_N;
3. 从 protocolFund 中支付 5% 触发奖励予交易发送者 (若发送者为合约且无 receive, 奖励将 escrow 至 bonusEscrowed[triggerer] 并 emit TriggerBonusEscrowed, 永不阻断切换; triggerer 后续可经 claimBonus(address payable to) 取走);
4. 部署第 N+1 代 ERC-20 合约并初始化其链上状态; 铸造 EmperorBadge SBT (tokenId = N+1) 给触发者;
5. (仅 V4 部署) 延后第 N+1 代在 PoolManager 上的池初始化; 任何地址可在切换完成后于 V4 PoolManager 上调用 initialize(poolKey).

若某夕阳朝代的供应在后续过程中归零, 其残余 distributionPool 将于下一次触发时被 sweep 入 protocolFund. 任何人可对更早期的夕阳代主动调用 sweepStaleDistributionPool 完成同样的回流.

夕阳代币保持可转让, 但不再支持反曲线卖出 (sell 在 sunset 时关闭); 持有者唯一退出路径为 burnOldForLatest(N, amount):

1. 调用者从夕阳第 N 代销毁 amount 数量的代币;
2. 合约依两条曲线推得的等值计价成本 nativeEq, 向调用者铸造对应数量的当前活跃代 L;
3. 调用者另获一笔计价代币分红, 其计算为:

// trigger 时一次性写入 storage, sunset 后 immutable:
dividendPerFairUnit_N = distributionPool_N / totalMintedFair_N

// burn 时直接乘:
dividend = fairBurn * dividendPerFairUnit_N

其中 fairBurn 为第 N 代以公允曲线单位表达的销毁量, dividendPerFairUnit_N 为第 N 代每 fair-unit 锁定的 ETH 量 —— 在 sunset 那一笔 trigger 中一次性算出并写入 storage 字段 dividendPerFairUnitScaled (uint128, 1e18 scale 形式), 之后任何 burn 都不再变动该字段. 链上以 view fn dividendPerToken(N) 暴露 「每 1 整代币锁定多少 wei」, 前端可单次 RPC 拿到 「每币 X ETH」 显示值, 无需两次读 + 客户端除法.

7.1 · 公允份额与死币锁仓

分母 s₀ 与每 fair-unit 锁定值 dpfu = D / s₀ 在 sunset 那笔交易内一次性写入 storage 字段 dividendPerFairUnitScaled (uint128, 1e18 scale), 其后受 immutability 保护 (合约无任何 setter, 也无路径再写). 因合约层 sell 在 sunset 时关闭, sunset 之后任何对 totalMintedFair_N 的变动都源自 burnOldForLatest 自身; 但此时 dpfu 已固化, 后续每笔 burn 仅以 fairBurn × dpfu 取出自己的份额 —— 焚毁次序与他人焚毁数量均不改变任一笔的分红. 形式化如下.

协议在所有面向用户的入口处强制以下不变量:

8.1 · 单笔上限.

单笔买入上限为 5 ETH; 一次性掏空供应在结构上不可能.

8.2 · 同区块抗夹击.

若卖出地址在第 N 代上最近一次买入与本次卖出位于同一区块, sell() 将回滚; 以闪电贷构造的原子三明治攻击在交换路径上不可达.

8.3 · 供应硬上限 (defense-in-depth).

每个朝代的 ERC-20 合约 (GenToken) 自带 hardcoded MAX_SUPPLY = 21_000_000e18. mint(to, amount) 入口在 totalSupply() + amount > MAX_SUPPLY 时立即 SupplyCapExceeded 回滚. 即便 hook 因升级 / bug / EIP-7702 reentrancy 试图越线 mint, ERC-20 自身亦回滚, 不可绕过. K 在所有代均为同一常量 21M (Parameters.K(N) 返回 K_BASE, 与 N 无关); 流程平等于此结晶.

8.4 · EOA 强制.

每个入口要求 msg.sender == tx.origin. 协议以 raw call 配合失败回滚转出计价代币, 无 receive() 的合约调用者 (含 ERC-4337 智能合约钱包) 将令 trigger / sell / burn 对其自身永久失效. 该约束在所有入口上一致且严格.

每笔买入与卖出对其总计价代币金额征收 1% 税 (跨代焚毁不收税). 卖出税永远 50/50 拆给 dev / protocolFund; 仅买入税分流 10% 给举主.

• 9.1 · 无举主: 50% 归开发者钱包 (经 withdrawDev() 提取, 实现上为 balance − nonDevReserved 派生), 50% 进入 protocolFund.
• 9.2 · 有举主: 开发者 40% / protocolFund 50% / 举主 10%; 举主累积经 claimReferral(address payable to) 提取 —— 与 claimBonus(to) 完全对称, to 字段允许合约形式的举主把酬劳转到一个能收 ETH 的钱包.

举主永久绑定 (first-touch lock). 合约维护 mapping(address buyer => address inviter) public inviter. 一笔买入若以形如 ?ref=0x... 的 URL 注入有效非零举主地址, 且该买家此前从未绑定, 则该次交易在链上写入 inviter[buyer] = referrer 并 emit InviterBound; 其后该地址每一笔买入皆向已记录举主派发 10%, 与 hookData 中携带何种地址无关. 不带举主 (address(0)) 的首笔买入不触发绑定, 故首单未走荐链的买家仍可在嗣后通过带举主买入补绑. 一旦写入终身不变, 协议无 setInviter / unbindInviter / 多签覆盖入口. 路由器 buyWithReferrer 与 hook 的绑定路径双重拒绝 referrer == msg.sender; 已绑定地址若误传自指 referrer 则被静默忽略, 不致 brick 该地址的买入.

protocolFund 仅经两条路径流出: 每次朝代切换支付的 5% 触发奖励, 与每次切换分配至 distributionPool 的 30% 快照. protocolFund 不存在任何提取函数. 开发者钱包于部署时绑定且不可修改; 其后的具体形态 (EOA 或多签) 对协议本身不可见.

10.1 · 信任假设

协议在所有面向用户的合约上不存在任何管理员角色:

• 无 owner, governor 或 pauser;
• 无升级代理, 信标或实现指针;
• 所有经济常量 (曲线公式, 阈值时间表, 衰减时长, 费用分配, 防操纵上限, 朝代命名) 均于部署时固化于字节码.

唯一保留的有特权动作有二: (i) 开发者钱包对其累积份额的 withdrawDev(); (ii) 部署后一次性的 setBadge() (绑定 EmperorBadge 合约, 绑定后 immutable). 两者均不能影响曲线, 阈值, 费率或既有持有者状态.

10.2 · 协议不变量

10.3 · 攻击面分析

• 重入. OZ ReentrancyGuardTransient 守护所有外部入口 (burnOld / sweep / withdraw / claim 等); swap 路径由 PoolManager 的 lock 自身保护.
• 三明治. 由 §8 同区块 cooldown 排除原子化夹击; 非原子 (跨区块) 夹击降级为常规价格风险, 不对协议本身构成威胁.
• 抢跑触发奖励. 使供应跨阈值的那一笔买入或跨代焚毁即获得 5% 奖励, 存在 mempool 抢跑动机. 该行为反而推动协议演替, 与设计目标一致; 不视为攻击.
• 预言机操纵. 协议无外部价格依赖; 价格完全由内部曲线状态决定.
• 闪电贷. 5 ETH 单笔上限将单交易最大投入限定, 闪电贷不能突破; 卖出走反曲线本就以该代 cumulativeEth 为上界, 无法跨代抽水.
• Griefing. 触发奖励 send 失败时 escrow 至 bonusEscrowed[triggerer] 并 emit TriggerBonusEscrowed (triggerer 事后调 claimBonus(to) 取走), 跨代焚毁分红 send 失败的回滚 (非 escrow), 分别对应「不让恶意 triggerer 卡住切换」与「不让恶意 burner 自带损失」两种威胁模型.

10.4 · 外部依赖

• Uniswap V4 PoolManager. 协议依赖其 lock-and-callback 模型完成 ETH 与各代代币的结算; PoolManager 本身已审计且不可升级.
• PRB Math UD60x18. 提供定点数 ln / exp. 协议每个状态写入都从 cumulativeEth 单一真相源 rebind totalMintedFair, ln/exp 舍入误差不会在两个独立累加器之间漂移, 不变量恒定闭合.
• OpenZeppelin Contracts 5.x. 提供 ERC-20 / ERC-721 / Strings / Base64 / ReentrancyGuardTransient.

本协议位于 launchpad / bonding curve 设计空间的特定位置, 下表对比若干代表性设计的关键差异:

11.1 · 经典 Bancor 联合曲线 (单池, CW = 50%).

单一代币, 单一曲线, 无终结条件; 价格随供应单调上升但无激励切换. 本协议的多朝代结构使每一代有明确的有限生命与退出入口.

11.2 · pump.fun (Solana meme launchpad).

单代币毕业 -> 迁移至 AMM; 毕业为不可逆的二元事件, 毕业后不再有协议层激励. 本协议每代终结后该代币仍可经反曲线卖出且其持有者保留跨代焚毁权, 提供了 pump.fun 没有的「软退出」路径.

11.3 · SatoHook (Uniswap V4 launchpad, 本协议直接前身).

单代币, 单 K/S, 固定 80% 触发后毕业并完成单次 distribution. 本协议在其基础上引入: (i) 多代级联 (K 固定 21M, S 每代翻倍, 入场单价 P(0) = S/K 随之翻倍), (ii) 时间衰减阈值 (替代固定 80%), (iii) 跨代焚毁与公允分红 (替代单次 distribution), (iv) EmperorBadge SBT 与全链上列传.

本协议未引入而曾考察的机制 (jackpot 持续小池, 抵押 / floor price 借贷, 动态 doc burn, 单笔卖出 TVL 上限) 于 DESIGN.md §10.7 详记; 该等机制对当前主线带来的边际收益与复杂性不成正比, 留作可选升级路径.

12.1 · 代际上限 (天然 EVM 天花板).

合约不设显式 MAX_GEN. 命名彻底开放: Gen 1–12 查中国朝代表, Gen 13+ 由公式 1950 + (N-13) x 50 无限延展. 方案 B 后 K 已固定为 21M 常量, 永不溢出; 唯一天花板转移到 S_N = S_BASE << (N-1), 主网 S_BASE = 60 ether 时 N ≈ 246 溢出 uint256, 届时 trigger 交易回滚, 该代永久 active 但买不进; 跨代 burn 仍可执行 (sell 已被 sunset 守护关闭). 视野极长——即便以 24 小时最快衰减节奏, Gen 246 也在 246 天以外.

12.2 · 晚到的代开盘价更贵 (P(0) 翻倍).

P(0)_N = S_N / K = (S_BASE / 21M) × 2^(N-1) 每代翻倍. 这是「K 固定 + S 翻倍」组合的数学必然: K 不变才能保证每代 token 上限同等 (流程平等), S 翻倍才能让 trigger ETH 翻倍 (体现承载力门槛递增), 两者协调后 P(0) = S/K 必随之翻倍. 接受「晚到的代起点更贵」, 用「中兴之代门槛递增」的 narrative 承接, 不视为缺陷.

12.3 · V4 PoolManager 升级风险.

V4 PoolManager 不可升级. 但若未来 Uniswap 部署一个分叉版本而本 hook 依赖原版的常量地址, 需用户自行选择路由器. 本协议不主动迁移.

12.4 · 启动期阈值衰减的策略博弈.

在 [0, 24h] 阈值线性衰减区间内, 存在「等阈值降到 supply 之下再以小笔买入跨过阈值锁定 trigger 奖励」的等待策略与「自己买穿当前阈值锁定 trigger 奖励」的进取策略之博弈. 两者皆为协议内合法行为, 本协议设计上接受由市场参与者权衡.

12.5 · 死币锁仓与协议沉淀.

由引理 7.1 / 推论 7.2, 公允分红与焚毁次序无关; 但若某地址持有的旧代代币永不焚毁 (钱包丢失、忽视入口、或主动放弃), 其对应的 D/s₀ × q ETH 将永久锁在 distributionPool_N 中, 不被其他焚毁者瓜分. 仅当该代 supply 归零时由 sweepStaleDistributionPool 回流至 protocolFund. 协议接受此沉淀, 不提供任何「他人代领」入口.

12.6 · 单一开发者钱包的费用承受.

1% swap tax 的 40–50% 流入单一开发者钱包, 部署后不可更改. 若该钱包私钥丢失, 协议仍正常运行 (开发者份额累积但无法提取), 但无法重新指向新钱包.

协议主标语「王侯将相宁有种乎」出自《史记·陈涉世家》, 由陈胜于公元前 209 年反抗秦廷的首次有记载的农民起义中作此发问. 其义在于质询王, 侯, 将, 相是否构成一独立的世袭阶层; 陈胜自答以否.

协议在朝代层面提出与之同构的主张: 任何朝代均受同一套规则约束 —— 相同的供应上限 (K = 21M 固定), 相同的阈值时间表 (99% → 80% in 24h), 相同的防操纵规则, 相同的费用结构, 相同的 burn 机制. 「宁有种乎」在「人人受同一套规则约束」上成立, 而非「人人起点价相同」: 晚到的代须以更多 ETH 推过 trigger (S_N 翻倍), 开盘价亦随之翻倍 (P(0) = S_N / K), 这是「中兴之代门槛递增」的代价. 任何具体朝代是落入鼎盛均衡还是衰世均衡, 皆由公开市场之参与者逐代决定.

协议部署于 Ethereum 主网, 并在 Sepolia 上提供 staging 与集成测试环境. Hook 合约经 BeforeSwapDelta 接口在 Uniswap V4 PoolManager 上拦截 swap, addLiquidity 与 initialize; 其地址通过 salt 网格搜索使最低 14 位满足 V4 钩子权限位掩码 0x2888 (beforeInitialize | beforeAddLiquidity | beforeSwap | beforeSwapReturnDelta). 用户交易经配套 router 合约进入, 由其完成 V4 架构所需的 unlock 回调; 原生 ETH 与各代 ERC-20 代币的结算交由 PoolManager 处理.

部署参数

各代代币地址由 _launchGen 确定性派生; 可经 getGen(N).token 查询.

协议所有状态均存于链上. 常用视图函数:

• currentTriggerSupply(N): 第 N 代当前触发供应阈值 (以代币单位表达);
• currentThresholdBps(N): 同一阈值以基点 (8000–9900) 表达;
• getGen(N): 第 N 代完整状态结构;
• previewBuy / previewSell / previewBurn: 用于客户端模拟的只读报价函数;
• getChronicle(N): 第 N 代列传 (首义功臣 / 巨贾 / 弃暗投明 / 末代忠臣).

合约字节码即权威规范; 本文乃其非正式说明.