📖TTSWAP 技术白皮书
TTSWAP 是一个去中心化的代币交易平台,支持用户快速、安全地进行代币兑换,无需依赖中心化交易所。
1 概要
TTSWAP (Token-Token Swap) 是建立在支持 EVM 的区块链上的自动做市协议 (Automated Market Maker, AMM)。该协议通过智能合约自动执行,无需依赖中心化机构或个人参与交易撮合。其核心机制基于用户交易行为,自动触发市场价值转移,实现价格发现功能。
TTSWAP 创新性地构建了基于恒定价值的交易协议 (Constant Value AMM)。相比传统 AMM,TTSWAP 深度贴近用户核心诉求:
- 人人皆可获利:为代币创建者、投资者(LP)、门户运营方、推荐人及普通用户提供多维度的生态角色与分润机会。
- 极致降低损耗:通过直达交易、集中流动性与流动性放大技术,大幅削减中转手续费、交易滑点及 Gas 开支。
- 本金安全至上:建立协议级、资金级、治理级的三重防御体系,全方位严守用户本金安全。
- 驱动收益倍增:利用流动性放大效应结合 TTS 挖矿奖励,为参与者开启财富增长新引擎。
- 公平透明社区:采用创新的价格导向型解锁机制与透明公售,确保生态在公正、开放的环境中长效发展。
本白皮书将详细阐述 TTSWAP 的设计逻辑:
- Token 交易:用户可直接进行任意 Token 间的兑换,支持原生 ETH 直接交易,无需 WETH 中转。
- 价值 Token 与普通 Token:区分主流价值资产与长尾资产,构建分层流动性市场。
- 流动性管理:用户可投资(提供流动性)并随时撤资,系统自动处理费率与收益。
- 手续费产生与分配:精细化的手续费分配机制,激励流动性提供者、推广者、社区建设者等多方角色。
- 公平启动:代币经济模型旨在维护所有持有者的权益,通过价格导向的解锁机制确保项目长期发展。
综上所述,TTSWAP 致力于构建一个高效、安全、低 Gas 成本的去中心化交易与支付协议,为 DeFi 和 PayFi 用户提供简洁、透明、高效的交易体验。
2 特点
-
恒定价值交易协议 (Constant Value AMM) 协议的核心思想是确保交易过程中的"价值守恒"。该模型在数学上兼容主流的 CPMM (Constant Product Market Maker, Uniswap ) 模型,同时支持类似 Balancer 的非对称权重流动性,但通过优化的代数算法避免了高昂的 Gas 消耗。
-
集中流动性与直接交易 用户向协议添加代币流动性后,该流动性可与协议内其他任意代币共享。用户可实现代币间的直接兑换,有效避免传统 DEX 中因多跳路由导致的流动性碎片化问题,显著提升交易深度。
-
流动性放大机制 (Liquidity Amplification) 协议根据代币的稳定性特征,动态配置流动性放大系数。用户提供的单位资金可产生多倍有效流动性深度,显著提升资金利用效率和收益水平(该机制类似 Curve 的流动性放大原理,但适用范围扩展至通用代币)。
-
低滑点交易 通过流动性放大机制和集中流动性设计,TTSWAP 能够显著降低交易滑点。即使是大额交易,也能获得优异的价格执行效果。
-
无常损失防护 协议通过特定的价值锚定算法和三重防御机制,在架构层面保护流动性提供者 (LP, Liquidity Provider) 免受无常损失影响,使 LP 在撤出流动性时能够更好地保持原有资产价值。
-
极致低 Gas 费用 得益于精简的代数运算逻辑和位压缩存储技术,合约执行效率极高。相比于同类复杂协议,TTSWAP 可节省 50% 至 90% 的 Gas 费用,使链上交易更加经济。
-
精细化手续费分配 手续费根据参与者的不同角色进行自动分配,涵盖代币管理员 (Token 创建者)、Token 投资者 (LP)、门户运营者、推荐人和普通用户。这构建了一个多方共赢的生态系统。
-
原生 ETH 支持 协议在底层架构上原生支持 ETH 直接参与交易和流动性提供,用户无需手动封装为 WETH,简化交互流程并优化用户体验。
-
投资证明与流动性挖矿 当用户提供流动性后,协议自动生成投资证明 (Proof of Investment),用户可凭此进行流动性挖矿,获得额外的 TTS 代币奖励。
-
价格导向型代币经济模型 TTS 代币采用创新的解锁模型:代币解锁与币价表现挂钩(价格翻倍解锁机制),并结合社区盈利销毁机制,确保代币流通量与项目价值增长相匹配。
-
支持 X402 支付协议 协议内置对 X402 标准的支持。这是一种将"签名者"与"支付执行者"分离的机制(类似账户抽象/PayFi),极大地扩展了支付应用场景,提升用户支付体验。
3 价值守恒交易模型原理
3.1 核心公式
当用户用 数量的 Token A 兑换 Token B 时,协议遵循以下两步计算:
(价值守恒交易模型核心公 式详细推导过程参见附录 A)
参数说明:
| 符号 | 含义 | 备注 |
|---|---|---|
| 协议中 Token A 的总市场价值 | 该价值可理解为代币在协议中的"权重" | |
| 协议中 Token A 的当前数量 | 包含累积手续费 | |
| 用户输入的 Token A 数量 | 扣除手续费后的总量 | |
| 协议中 Token B 的总市场价值 | ||
| 协议中 Token B 的当前数量 | 包含累积手续费 | |
| 用户获得的 Token B 数量 | 扣除手续费前的总量 |
设计哲学: 交换的本质是数量与价值的不匹配,协议通过市场手段(价格滑点)自动平衡供需。
3.2 模型的数学特性与对比
3.2.1 与 Uniswap (CPMM) 的关系
当两个代币的配置价值相等 () 时,上述公式在数学上等价于 Uniswap 的恒定乘积公式 ()。
推导简述: 在 的情况下,代入公式可推导出:
(价值相同情况下的 TTSWAP 化简过程参见附录 B)
这正是标准 CPMM 模型的输出公式,这意味着 TTSWAP 在处理常规代币对时,拥有与 Uniswap 相同的市场深度和定价特性。
3.2.2 与 Balancer (加权池) 的关系
当 时,模型表现出加权池的特性。
- Balancer 使用指数运算 来实现不同权重,计算复杂且 Gas 开销较大。
- TTSWAP 使用上述代数公式,无需指数运算即可模拟非对称流动性池。这使得 TTSWAP 能够在极低的 Gas 成本下,支持稳定币(高权重)或新兴代币(低权重)的定制化流动性管理。
(价值不相同情况下与 Balancer 的等价性证明参见附录 C)
3.3 交易后的状态更新
交易完成后,代币的状态会更新,形成新的兑换比例:
| (输入侧) | (输出侧) | |
|---|---|---|
| 价值 (权重) | (不变) | (不变) |
| 数量 | (增加) | (减少) |
-
新边际价格 (记账价格):
-
新兑换比例 (Spot Price):
注:这里的 和 是协议内部用于记录代币相对于其权重的"稀缺度"指标,并非直接的法币价格。
4 Token
4.1 Token 介绍
在 TTSWAP 协议中,每个 Token 拥有四个核心属性:
- 市场价值 (V):衡量代币在协议中的权重(资金池的总权重价值)。
- 当前数量 (Q):协议当前持有的代币余额(包含累积的手续费)。
- 投资数量 (I):LP 存入的代币总数(包含累积的手续费)。
- 投资份额 (S):LP 持有的代币总份额。
交易机制:当用户认为代币的市场价格低于协议价格(即 偏高)时,会倾向于出售该代币;反之则买入。
4.2 Token 分类
| Token 分类 | 说明 | 产生手续费 | 单独投资 | 组合投资 |
|---|---|---|---|---|
| 元 Token | 协议部署时的首个 Token(如 USDT),作为价值锚定基准 | 是 | 是 | 否 |
| 价值 Token | 市场认可度高、生态成熟的代币(如 ETH、WBTC) | 是 | 是 | 否 |
| 普通 Token | 新增的长尾资产,需与价值 Token 配对添加 | 是 | 否 | 是 |
4.3 Token 配置与 Gas 优化
为了实现极致的 Gas 效率,TTSWAP 采用了位压缩 (Bit-packing) 技术,将代币的所有关键配置参数压缩存储在一个 256 位的存储槽 (Slot) 中。
这意味着读取或更新代币配置只需一次链上存储操作 (SSTORE/SLOAD),大幅降低了交互成本。
(详细 的 256 位存储布局图请参见附录 D)
用户可配置的参数包括:
- 费率设置:投资费率、撤资费率、买入/卖出费率。
- 流动性加强倍数:设置代币的流动性放大因子(1 ~ 市场设置的最大倍数)。
- 撤资切片数:用于平滑大额撤资影响的安全参数。
注:市场设置的最大倍数根据代币项目质量和运营质量进行评估,默认值为 1。
5 元 Token 的添加
元 Token (Meta Token) 指协议部署后添加的首个代币,通常作为协议的价值锚定基准(如 USDT)。元 Token 本身也是一种价值 Token。

例如,协议创建者初始化 USDT 为元 Token,并注入 2,000 USDT 作为初始流动性。
- 此时状态:
- 市场价值 (V) = 2,000
- 代币数量 (Q) = 2,000
- 投资数量 (I) = 2,000
- 投资份额 (S) = 2,000
6 普通 Token 的添加

用户添加普通 Token(如 Token A)时,必须锚定一种已存在的价值 Token(如 USDT)以确定其初始定价。
假设用户添加 Token A,并锚定 USDT:
- USDT 状态更新:
- 市场价值(V) = 4,000
- 代币数量(Q) = 4,000
- 投资数量(I) = 4,000
- 投资份额(S) = 4,000
- Token A 初始状态:
- 市场价值(V) = 2,000
- 代币数量(Q) = 2,000
- 投资数量(I) = 2,000
- 投资份额(S) = 2,000
注:广泛认可的普通代币在满足一定条件后,也可以升级为价值代币。
7 Token 投资与撤资
在 TTSWAP 中,提供流动性称为"投资",移除流动性称为"撤资"。
7.1 核心概念

-
Token 属性
- 市场价值 (V):衡量代币在协议中的权重或总市场价值。
- 当前数量 (Q):协议当前持有的代币余额(包含累积的手续费)。
- 投资数量 (I):LP 存入的代币总数(包含累积的手续费)。
- 投资份额 (S):LP 持有的权益份额。公式:。
- 加强数量 (P):由流动性放大机制产生的虚拟流动性。
-
投资证明 (User Proof) 属性
- 投资价值 (IV):用户投资时刻该代币的市场价值。
- 持有份额 (IS):用户持有的投资份额。
- 投资数量 (IQ):用户投资时放大后的数量。
- 实际数量 (IC):用户实际的放大前的数量。
7.2 Token 投资与撤资计算流程

7.2.1 投资 (提供流动性)
当用户投资代币时:
- 计算放大:根据配置的"流动性加强倍数",协议虚拟增加投入数量,从而在不增加实际资金占用的情况下加深市场深度。
- 计算份额:根据当前资金池的净值,计算用户应得的 LP 份额。
- 更新状态:增加资金池的市场价值、代币数量和总投资份额。
7.2.2 撤资 (移除流动性)
当用户撤资时:
- 计算应还数量:根据用户持有的份额占比,计算应赎回的代币数量。
- 计算收益:。
- 撤资切片 (Divestment Slicing): 为了防止巨鲸大额撤资导致资金池瞬间枯竭或价格剧烈波动,协议引入了"撤资切片"机制,限制单次撤资的最大比例(例如不超过总池的 1/N)。如果撤资量过大,用户需分批操作或承担更高的滑点成本。
(Token 投资与撤资详细计算流程参见附录 E)
7.3 抵御无常损失的三重防御机制
为了最大程度保护普通流动性提供者 (LP) 的本金安全,TTSWAP 设计了独特的三重防御体系来应对无常损失 (Impermanent Loss):
-
第一道防线:协议级价值锚定 (协议级) 通过智能合约内置的价值守恒算法,优先保障 LP 在撤资时的本位价值,从底层逻辑上减少因价格波动带来的被动损失。
-
第二道防线:项目方劣后缓冲 (资金级) 在极端行情导致价值缺口时,代币发行方(创建者)注入的初始流动性将作为"劣后级资金",优先承担价值波动带来的亏损,从而保护普通用户的资金安全。
-
第三道防线:协议代币补偿基金 (治理级) 作为最后的保障手段,如果上述措施仍无法覆盖全部损失,协议将启动"风险补偿机制",通过拍卖或释放部分 TTS 治理代币筹集资金,对受损用户进行补偿。
8 Token 交换实例
本章演示用户用 兑换 的全过程。

8.1 初始状态
- Token A:价值 40,000,数量 20,000(单价 2.0)
- Token B:价值 20,000,数量 40,000(单价 0.5)
- 初始汇率:1 Token A = 4 Token B
8.2 交易计算
用户输入 2,500 个 Token A:
- 扣除手续费:假设费率 0.01%,扣除 0.25 A,实际入池 。
- 计算转移价值:根据公式算出 。
- 计算输出数量:根据 算出 Token B 的流出量 。
- 扣除输出手续费:扣除 0.84 B,用户实际收到 8,419.46 个 Token B。
(Token 兑换详细计算流程参见附录 F)
8.3 结果分析

交易后,Token A 数量增加(价格下跌),Token B 数量减少(价格上涨)。协议自动完成价格发现。
8.4 合约安全性验证
协议已通过多项数学一致性测试:
- 公平性:A 换 B,立即用 B 换回 A,除手续费外损失极小(路径无关性)。
(TTSWAP 模型反向兑换(闭环性)推导证明附录 H) - 合理性:单笔大额交易与拆分为多笔小额交易的结果一致(无套利空间)。
(TTSWAP 通用模型下拆分交易的误差分析证明参见附录 I) - 闭环性:A->B->C->A 的循环交易逻辑自洽。
(TTSWAP 循环兑换一致性证明附录 J)
参见 modified_swap_without_fee 测试合约地址
9 手续费
9.1 手续费来源

手续费在交易发生时实时扣除,并直接累积到代币的"当前数量"和"投资数量"中。这意味着 LP 份额的净值 (Net Value) 会随着交易量的增加而单调递增,在 LP 撤资时进行按角色分配。
9.2 分配机制
TTSWAP 采用多角色分润机制,促进生态繁荣:

| 角色 | 分成比例 (示例) | 说明 |
|---|---|---|
| 代币管理员 | 1% - 3% | 代币的初始创建者或运营方 |
| 流动性提供者 (LP) | 50% - 80% | 核心收益者,按份额自动复利 |
| 服务提供商 | 5% - 25% | 提供前端服务、聚合交易、集成服务的第三方 |
| 推荐人 | 5% - 10% | 邀请新用户的推广大使 |
| 社区金库 | 2% - 8% | 用于回购销毁 TTS 代币或技术研发 |
若无明确推荐人,相关比例将划归服务提供商或社区金库。
(Token 手续费与分配计算流程参见附录 G)
10 Token 福利

项目方可主动向资金池注入代币作为"福利",这将直接提升 LP 份额的净值,从而提高年化收益率 (APR),吸引更多流动性。
11 流动性挖矿
协议支持"投资即挖矿"机制。用户的 LP 份额会自动折算为算力,挖掘平台治理代币 TTS。这实现了双重收益:交易手续费 + TTS 代币奖励。
12 X402 支付协议支持
TTSWAP 实现了对 X402 协议的支持。这是一个先进的意图导向支付标准 (Intent-Centric Payment),类似于账户抽象 (Account Abstraction) 或 PayFi 的理念。
核心优势:
- 签名与执行分离:用户只需对支付意图进行签名(离线操作,无 Gas),而具体的上链执行、Gas 支付可由第三方"执行者" (Executor) 完成。
- 全币种支付:应用端无需关心用户持有何种代币,X402 协议会在链上自动完成兑换并支付目标货币。

流程:
- 用户访问应用,应用请求支付。
- 用户签署离线消息 (Permit)。
- 执行者将签名提交至链上。
- TTSWAP 合约验证签名,自动兑换代币并完成支付。
13 主要代码实现 (参见代码)
13.1 合约部署 GAS
| Deployment Cost | Deployment Size |
|---|---|
| 5,644,297 | 26,543 |
13.2 合约函数(部份主要函数)GAS
| Function Name | avg | 备注 |
|---|---|---|
| buyGood(NativeETH) | 81,190 | 购买 Token |
| buyGood(ERC20) | 89,761 | 购买 Token |
| disinvestProof | 164,402 | 撤资 |
| initGood | 376,985 | 初始化 Token |
| investGood | 153,945 | 投资 Token |
| goodWelfare | 52,396 | 增加手续费发福利 |
14 协议中角色说明
协议中提供对于5种角色的支持,包含:代币管理员、代币流动性提供者、门户运营者、推荐者、用户、社区。
| 角色 | 收益来源 | 说明 |
|---|---|---|
| 流动性提供者 (LP) | 50% - 80% | 资金池的核心 贡献者,收益占比最高。 |
| 代币管理员 | 1% - 3% | 负责代币上币和参数配置的运营者。 |
| 推荐人 | 5% - 10% | 邀请新用户的推广大使。 |
| 门户运营者 | 5% - 25% | 提供前端界面、聚合交易服务的第三方。 |
| 社区金库 | 2% - 8% | 用于技术开发和回购销毁。 |
| 用户折扣 | -10% | 填写推荐码的用户可享受手续费减免。 |
15 代币经济方案
TTS Token 是协议的治理与激励代币,采用了创新的"价格导向型"解锁机制。
15.1 基本信息
- 名称:TTSWAP Token (TTS)
- 初始发行:5,000 万枚(全部锁定)
- 通胀机制:每年增发 (2 亿 - 已解锁数量) × 2% 用于奖励 LP。
- 通缩机制:社区收益 100% 用于二级市场回购并销毁 TTS。
15.2 核心创新:价格导向型解锁 (Price-Driven Unlocking)
为了防止团队砸盘和早期巨鲸抛售,TTS 的解锁与币价直接挂钩:
- 原则:只有币价上涨,代币才会解锁。
- 机制:
- 分配时全部锁定(公售和流动性挖矿部分除外)。
- 设定初始价格和解锁比例(例如 10%)。
- 当币价翻倍时,解锁剩余锁定量的 10%。
- 如果币价再次翻倍,再解锁剩余的 10%。
- 结果:团队和早期投资者的利益与币价长期表现强制绑定。
15.3 4C 社区分配模型
代币分配遵循 4C 角色模型,确保贡献者获得回报:
| 角色 | 描述 | 占比 | 解锁限制 (最大) | 触发条件 |
|---|---|---|---|---|
| 创始人 (Founder) | 项目发起人、承担最大风险 | 20% | < 1/20 (5%) | 需涨 1,000 倍才能解锁约 37% |
| 合伙人 (Partner) | 核心执行团队 | 12% | < 1/14 (7.1%) | 需涨 400 倍才能解锁约 45% |
| 价值贡献 (Value) | 社区运营、技术开发 | 44% | < 1/12 (8.3%) | 需涨 200 倍解锁约 50% |
| 资本贡献 (Capital) | 早期投资、公售、空投 | 24% | < 1/8 (12.5%) | 需涨 100 倍解锁约 60% |
15.4 动态销毁 (Buyback & Burn)
- 协议产生的手续费收益中,划拨给"社区金库"的部分将全部用于二级市场回购 TTS 并销毁。
- 这构成了 TTS 的通缩引擎。随着交易量的增长,流通盘将持续减少,从而推升代币价值。
16 法律许可
16.1 说明
为 了维护项目合法权益,同时方便用户了解协议,不同文件采用不同的开源协议。违反协议将承担相应的法律责任。
16.2 协议说明
为了保护知识产权并促进技术交流:
- 核心逻辑:采用 BUSL-1.1(商业源使用许可)。允许学习研究,但在特定期限内限制商业分叉。
- 外围组件:采用 MIT 许可,鼓励社区开发周边工具和集成应用。
详细版权信息请查阅 GitHub 仓库中的 LICENSE 文件。
16.3 文件开源协议信息
src
├── TTSwap_Market.sol(BUSL-1.1)
├── TTSwap_Market_Proxy.sol(BUSL-1.1)
├── TTSwap_Token.sol(BUSL-1.1)
├── TTSwap_Token_Proxy.sol(BUSL-1.1)
├── interfaces
│ ├── I_TTSwap_Market.sol(MIT)
│ └── I_TTSwap_Token.sol(MIT)
└── libraries
├── L_Currency.sol (MIT)
├── L_Error.sol (MIT)
├── L_Good.sol(BUSL-1.1)
├── L_GoodConfig.sol(MIT)
├── L_Proof.sol(BUSL-1.1)
├── L_SignatureVerification.sol(MIT)
├── L_Transient.sol (MIT)
├── L_TTSTokenConfig.sol (MIT)
├── L_TTSwapUINT256.sol (MIT)
└── L_UserConfig.sol(MIT)
docs
├── ebook
tests
17 联系方式
- Twitter: ttswapfinance
- Telegram: @ttswapfinance
- Email: bussiness@ttswap.io
- Discord: ttswap
- Website: ttswap.io
附录 A: 价值守恒交易模型核心公式详细推导过程
本附录将详细展示如何从"调和平均价格"原理推导出 TTSWAP 的核心交易公式。
TTSWAP 的交易过程分为两个独立的步骤:
- 输入侧:将输入的 Token A 转换为标准价值 ()。
- 输出侧:将标准价值 () 转换为输出的 Token B。
第一步:计算输入 Token A 对应的价值
我们采用调和平均数 (Harmonic Mean) 来确定交易的执行价格。相比算术平均,调和平均更能平滑价格波动,确保交易的公平性。
1. 定义瞬时价值密度 (价格)
- 交易前状态: 协议持有 个 Token A,总价值为 。
- 交易后状态 (假设): 协议持有 个 Token A,总价值仍记为 (以此计算边际贡献)。
2. 计算执行价格 (调和平均) 对交易前后的价格取调和平均,得到本次交易的有效执行价格 :
代入 和 :
3. 计算转移价值
第二步:根据价值 计算输出数量
在输出侧,我们关注的是"单位价值对应的代币数量"(即价格的倒数,记为 )。
1. 定义瞬时数量密度
- 交易前状态: 协议持有 个 Token B,总价值为 。
- 交易后状态 (假设): 总价值增加了 ,变成 。
2. 计算执行密度 (调和平均)
代入 和 :
3. 计算输出数量
至此,核心公式推导完毕。
附录 B: 价值相同情况下的公式化简 (Uniswap 等价性证明)
本附录将证明:当两个代币的权重( 价值)相等时,TTSWAP 的交易模型在数学上完全等价于 Uniswap 的恒定乘积公式 (CPMM)。
1. 设定条件
假设 和 的配置价值相等,即:
2. 联立公式
将附录 A 中的两步公式联立。
输入侧:
输出侧:
3. 代入与化简
将 的表达式代入 的公式中:
分子分母同时除以 :
整理分母:
将分母代回原式:
消去公共项 :
4. 结论
上式即为 Uniswap 的标准输出公式 (忽略手续费):
证毕。这表明 TTSWAP 是对 CPMM 模型的通用化扩展:在 时退化为 CPMM,在 时具备加权池特性。
附录 C: 价值不相同情况下的公式推导 与 Balancer 等价性证明
本附录将深入分析当 时,TTSWAP 交易模型的数学特性,并证明其在微小增量下(Spot Price)与 Balancer 加权公式的完全等价性,以及在大额交易下的高度拟合性。
1. Balancer 模型回顾
Balancer 采用加权恒定乘积公式 (Weighted Product Formula): 其兑换价格 (Spot Price) 取决于储备量比率与权重比率: (忽略手续费后,且以 A 计价 B)
2. TTSWAP 模型的边际价格推导
我们通过对 TTSWAP 的核心公式求导来计算边际价格。
输入侧 (Token A -> Value): 当 时 (微分视角):
输出侧 (Value -> Token B): 当 时:
综合兑换率 (Spot Price): 联立上述两式: 即瞬时兑换率:
因此,TTSWAP 的瞬时价格 (Spot Price) 为:
3. 等价性对比
| 参数 | Balancer (加权池) | TTSWAP (恒定价值) |
|---|---|---|
| 权重定义 | 权重 | 市场价值 |
| 现货价格 |
结论 1 (Spot Price 等价性): 只要我们将 TTSWAP 中的市场价值 视为 Balancer 中的权重 ,两者的现货价格逻辑是完全等价的。 即:
4. 大额交易的曲线拟合
Balancer 的指数曲线具有恒定的弹性,而 TTSWAP 使用的是调和平均曲线 (双曲线的一种形式)。
虽然在大额交易 ( 较大) 时,两者的滑点曲线会有微小差异,但数学性质高度一致:
- 凸性 (Convexity):两者都是凸函数,确保价格随着购买量的增加而增加 (滑点)。
- 渐近线:两者都存在渐近线,即无法买空池子。