一、SunSwap V3简介
SunSwap V3通过聚合流动性技术提升了资金利用率，用户通过代币对+手续费级别+价格范围来添加流动性, 兑换手续费将按照所有用户在该范围内的仓位占比进行分配，投资者需要合理地设置添加流动性的价格范围，以达到较高的手续费分成。
1.1 SunSwap V2的不足
SunSwap V2采用经典的恒定乘积模型: x * y = k。x 和y分别代表两个token的资产数量，两者的乘积需要保持一个恒定的值k。当你用tokenA交易tokenB时，将你的tokenA存入合约并获得一定数量的 tokenB 作为交换，在每次交易后，tokenA数量和tokenB数量的乘积保持不变。其价格曲线如下:
横坐标是tokenA的数量，纵坐标是tokenB的数量，绿色曲线为当前池子的价格变化。由上面曲线可以知，绿色区域是当前tokenA/tokenB的乘积，红线为当前tokenA的价格。当tokenA/tokenB的价格波动不大时，tokenA/tokenB的交易会集中在橙色区域，而绿色区域的资金，没有很好的被利用起来。
为了提升池子的资金利用率，我们在SunSwap V2基础上，设计开发了集中流动性模型SunSwap V3。
1.2 集中流动性模型
SunSwap V3使用基于恒定乘积的集中流动性的模型，在SunSwap V2的基础上引入了虚拟流动性的概念，那么做市公式为：
（x + x_virtual）*（y + y_virtual）= L^2 公式1
由集中流动性的原理可知，x_virtual 和y_virtual 是与 p_upper、p_lower相关联的; 可推导集中流动性的公式为:
（x + L / √p_upper ）*(y +L*√p_lower) = L^2 公式2
1.3 价格范围和手续费
SunSwap V3在用户注入流动性的过程中，给予用户选择仓位价格区间的权利，即公式2中的p_lower和p_upper。由公式2可知，价格区间的范围应包含当前的价格，并且价格范围越接近当前价格（区间长度越短），用户的资金使用率越高，获得的收益也越高；用户资金的价格区间长度越长，资金的利用率越低。我们建议SunSwap V3的用户选择合适的价格区间，以权衡收益和风险。
SunSwap V3为用户提供了四个不同费率的池子选项，以支持不同风险的token构建对应的交易池。不同费率池的特性如下表，我们建议用户按照所持token的特性选择合适的交易池提供流动性。
| 费率 | 适用场景 |
| 0.01% | 稳定币，且资金量较大 |
| 0.05% | 相对稳定的币对，币价波动不是很大 |
| 0.3% | 多数token的最优目标 |
| 1% | 币价波动较大token的选择 |
二、操作说明
2.1 添加流动性
- 需要在SunSwap页面右上角点击「连接钱包」。
- 点击SunSwap→V3→资金池进入添加流动性页面。
- 点击「添加流动性」按钮，进入添加流动性的页面。
- 选择想要添加的代币对+手续费级别+设置起始兑换率+设置兑换率范围（池子未创建需要设置起始兑换率，池子已创建则不需要设置起始兑换率）。
- 在代币输入框输入要添加的代币数量，在其中一个代币输入框输入数据时，另外一个输入框会按照比例自动填充数据。
- 点击「提供」按钮，如果存在第一次添加流动性的代币，会弹出授权弹窗，优先对未授权的代币进行授权操作
- 授权完成后会弹出「确认提供」弹框，显示本次添加流动性的相关信息，点击「确认提供」按钮后会调起签名弹窗，确认签名后会弹出「增加流动性已完成」弹框，点击「关闭」按钮会回到已添加流动性的列表页。
2.2 追加流动性
- 点击已添加的流动性信息会跳转到已添加流动性的详情页，在详情页可以操作追加「添加流动性」。
- 点击流动性详情页的「添加」按钮会跳转到追加流动性页面，追加流动性页面手续费级别和设置兑换率范围都不可操作，只能输入要追加的代币数量，输入代币数量后点击「提供」按钮。
- 确认提供且签名后可以完成追加流动性，确认签名后会弹出「增加流动性已完成」弹框。追加流动性成功后在该流动性对应的详情页可以看到已添加的流动性价值和代币数量会更新。
2.3 移除流动性
1. 在流动性详情页点击「移除」按钮会跳转到移除流动性页面，在移除流动性页面可以按照比例移除已添加的流动性，选择比例后点击「移除」按钮进行签名可以移除成功。移除流动性成功后在对应的流动性详情页可以看到已添加的流动性价值和代币数量会更新。
2. 点击「移除」会弹出「您将移除」的弹框
3. 点击「确认移除」后弹出移除的签名弹窗，点击「签名」后会弹出「移除流动性已完成」弹框，同时自动领取全部奖励。
2.4 收取奖励
- 在流动性详情页可以收取奖励，有奖励时会显示「收取按钮」，没有奖励时不显示「收取按钮」。
- 点击「收取」按钮会弹出「确认收取」弹框，显示将要领取的奖励数量。
- 点击「确认收取」按钮会调起钱包签名弹窗，确认签名后会弹出「收取奖励已完成」弹框，收取的奖励会进入个人钱包，同时流动性详情页奖励的价值和代币数量会更新为最新值。
2.5 兑换
- 在兑换页面点击代币选择入口，即可选择需要交易的币种。
- 选择两种代币后，输入From Token的数量进行兑换。
- 点击「兑换」按钮开始进行交易，如果您是第一次对From Token进行交易，在点击兑换按钮后会同时弹出授权From Token的提示弹框以及钱包中的签名弹窗。
- 点击「签名授权」，成功对From Token授权后，弹出「确认兑换」的弹框。
5. 点击「确认兑换」，钱包弹出交易的签名弹窗。点击「签名」确认交易，交易发出后需要等待几秒处理。交易成功后，钱包中From Token和To Token的资产数量发生变化。