
剖析DeFi交易产品之UniswapV3:工厂合约
文章内容:
UniswapV3Factory 合约主要用来创建不同代币对的流动性池子合约,其代码实现并不复杂,以下就是代码实现:
contract UniswapV3Factory is IUniswapV3Factory, UniswapV3PoolDeployer, NoDelegateCall {
address public override owner;
mapping(uint24 => int24) public override feeAmountTickSpacing;
mapping(address => mapping(address => mapping(uint24 => address))) public override getPool;
constructor() {
owner = msg.sender;
emit OwnerChanged(address(0), msg.sender);
// 初始化支持的费率以及对应的tickSpacing
feeAmountTickSpacing[500] = 10;
emit FeeAmountEnabled(500, 10);
feeAmountTickSpacing[3000] = 60;
emit FeeAmountEnabled(3000, 60);
feeAmountTickSpacing[10000] = 200;
emit FeeAmountEnabled(10000, 200);
}
function createPool(
address tokenA,
address tokenB,
uint24 fee
) external override noDelegateCall returns (address pool) {
require(tokenA != tokenB);
// 对两个token进行排序,小的排前面
(address token0, address token1) = tokenA < tokenB ? (tokenA, tokenB) : (tokenB, tokenA);
require(token0 != address(0));
int24 tickSpacing = feeAmountTickSpacing[fee];
require(tickSpacing != 0); //为0则说明该费率并不支持
require(getPool[token0][token1][fee] == address(0));
// 实际的部署新池子函数
pool = deploy(address(this), token0, token1, fee, tickSpacing);
// 两个方向的token都存储,方便查询
getPool[token0][token1][fee] = pool;
getPool[token1][token0][fee] = pool;
emit PoolCreated(token0, token1, fee, tickSpacing, pool);
}
function setOwner(address _owner) external override {
require(msg.sender == owner);
emit OwnerChanged(owner, _owner);
owner = _owner;
}
function enableFeeAmount(uint24 fee, int24 tickSpacing) public override {
require(msg.sender == owner);
require(fee < 1000000);
// tick spacing is capped at 16384 to prevent the situation where tickSpacing is so large that
// TickBitmap#nextInitializedTickWithinOneWord overflows int24 container from a valid tick
// 16384 ticks represents a >5x price change with ticks of 1 bips
require(tickSpacing > 0 && tickSpacing < 16384);
require(feeAmountTickSpacing[fee] == 0);
feeAmountTickSpacing[fee] = tickSpacing;
emit FeeAmountEnabled(fee, tickSpacing);
}
}
UniswapV3Factory 除了继承其 interface IUniswapV3Factory 之外,还继承了另外两个合约 UniswapV3PoolDeployer 和 NoDelegateCall。这两个合约后面再讲,先来看看构造函数。构造函数除了初始化 owner
之外,最主要就是初始化 feeAmountTickSpacing
状态变量。这个变量是用来存储支持的交易手续费率的配置的,key 代表费率,value 代表 tickSpacing。初始的费率值分别设为了 500、3000、10000,分别代表了 0.05%、0.3%、1%。tickSpacing 的概念需要解释一下。
当添加流动性时,虽然 UI 交互上选择的是一个价格区间,但实际调用合约时,传入的参数其实是一个 tick 区间。而如果低价或/和高价的 tick 还没有被已存在的头寸用作边界点时,该 tick 将被初始化。tickSpacing 就是用来限制哪些 tick 可以被初始化的。只有那些序号能够被 tickSpacing 整除的 tick 才能被初始化。当 tickSpacing = 10 的时候,则只有可以被 10 整除的 tick (…, -30, -20, -10, 0, 10, 20, 30, …) 才可以被初始化;当 tickSpacing = 200 时,则只有可以被 200 整除的 tick (…, -600, -400, -200, 0, 200, 400, 600, …) 才可被初始化。tickSpacing 越小,则说明可设置的价格区间精度越高,但可能会使得每次交易时损耗的 gas 也越高,因为每次交易穿越一个初始化的 tick 时,都会给交易者带来 gas 消耗。
为了更直观地理解 tickSpacing,我再用更具体的示例进行说明。我们知道,在 UniswapV2 中,在智能合约层面,价格精度其实可以达到 18 位小数,交易精度是可以非常小的。但是,在中心化交易所,不同代币的价格精度则是不一样的,比如 BTC 和 ETH 的价格精度大多为两个小数,MEME 的精度为 6 位小数,SHIB 的精度则为 8 位小数,这个价格精度也就是价格的最小变动单位,BTC 和 ETH 的最小变动单位为 0.01,SHIB 的最小变动单位为 0.00000001。类似地,tickSpacing 可以理解为就是 tick 变动的最小单位。而我们知道,每一个 tick 其实也对应了每一个价格点,因此 tickSpacing 其实和中心化交易所的价格精度类似,是用于限制每个池子的最小价格变动范围的。也因此,当你在 Uniswap 官网上添加流动性时,当你输入的区间价格为整数时,比如 1700,最终会变成 1699.4004,就是因为 1699.4004 才是符合 tickSpacing 限制的有效价格点。
从构造函数中可看出,三个不同费率对应的 tickSpacing 分别为 10、60 和 200。费率越高,tickSpacing 越高,即是说,费率越高,价格变动的最小单位也越高。
在 2021 年 11 月通过 DAO 治理增加了另一个手续费率配置,费率为 0.01%,tickSpacing 为 1,是通过调用了 enableFeeAmount
函数添加的。该函数只有 owner
才有权限调用,而 owner 其实是个 Timelock 合约。
createPool
是最核心的创建新池子的函数,其三个入参就是组成一个池子唯一性的 tokenA、tokenB 和 fee。代码实现里,各种 require 的检验都非常好理解,而实际的创建池子逻辑其实封装在了 deploy
内部函数里,而这个函数是在 UniswapV3PoolDeployer 合约中实现的。deploy
函数返回 pool
后,会存储到 getPool
状态变量里。
下面,来看看 UniswapV3PoolDeployer 合约实现,其代码如下:
contract UniswapV3PoolDeployer is IUniswapV3PoolDeployer {
struct Parameters {
address factory;
address token0;
address token1;
uint24 fee;
int24 tickSpacing;
}
Parameters public override parameters;
function deploy(
address factory,
address token0,
address token1,
uint24 fee,
int24 tickSpacing
) internal returns (address pool) {
parameters = Parameters({factory: factory, token0: token0, token1: token1, fee: fee, tickSpacing: tickSpacing});
pool = address(new UniswapV3Pool{salt: keccak256(abi.encode(token0, token1, fee))}());
delete parameters;
}
}
这套代码还是比较有意思的。首先,其定义了结构体 Parameters
和该结构体类型的状态变量 parameters
。然后,在 deploy
函数里,先对 parameters
进行赋值,接着通过 new UniswapV3Pool
部署了新池子合约,使用 token0、token1 和 fee 三个字段拼接的哈希值作为盐值。最后再将 parameters
删除。总共就三行代码。但其中有两个用法,是在以前的项目中还没出现过的。
第一,使用 new UniswapV3Pool
部署新合约时,还可以指定 salt
。这其实也是 create2
的一种新写法,相比于 UniswapV2Factory 中使用内联汇编的方式,明显简化了很多。
第二,parameters
其实是传给 UniswapV3Pool
的参数,在 UniswapV3Pool 的构造函数里,是如下所示来接收这些参数的:
constructor() {
int24 _tickSpacing;
(factory, token0, token1, fee, _tickSpacing) = IUniswapV3PoolDeployer(msg.sender).parameters();
tickSpacing = _tickSpacing;
maxLiquidityPerTick = Tick.tickSpacingToMaxLiquidityPerTick(_tickSpacing);
}
可见,其实就是通过调用了 IUniswapV3PoolDeployer(msg.sender).parameters()
来获取到几个参数。其中,msg.sender
其实就是工厂合约。
看了这段代码才明白,原来合约间传递参数还可以这么用。
回到 UniswapV3Factory 合约的 createPool
函数,函数体里还有加了 noDelegateCall
的函数修饰器,这是在 NoDelegateCall 抽象合约中定义的。以下是 NoDelegateCall 的代码实现:
abstract contract NoDelegateCall {
/// @dev The original address of this contract
address private immutable original;
constructor() {
// Immutables are computed in the init code of the contract, and then inlined into the deployed bytecode.
// In other words, this variable won't change when it's checked at runtime.
original = address(this);
}
/// @dev Private method is used instead of inlining into modifier because modifiers are copied into each method,
/// and the use of immutable means the address bytes are copied in every place the modifier is used.
function checkNotDelegateCall() private view {
require(address(this) == original);
}
/// @notice Prevents delegatecall into the modified method
modifier noDelegateCall() {
checkNotDelegateCall();
_;
}
}
这其实就是为了阻止用 delegatecall 来调用所修饰的函数。当使用 delegatecall 调用 createPool
函数的时候,那 address(this)
将是发起 delegatecall 的地址,而不是当前的工厂合约地址。
至此,我们就讲解完了 UniswapV3 的工厂合约。
比推快讯
更多 >>- 数据:交易所的比特币供应量占比降至 14.5%,创近七年来新低
- Binance Alpha 日交易量昨日报 4.396 亿美元,BR、KOGE、BULLA 分列前三
- 慢雾:Chrome V8 漏洞已被利用,用户需尽快升级防范钓鱼攻击
- Kalshi 上马斯克今年内创建新政党概率现报 40%
- 某鲸鱼向 Binance 存入 1595 枚 BTC,价值约合 1.6855 亿美元
- 数据:6 月 CEX 现货交易量创近 9 个月新低
- 加密矿企 Cango 6 月挖出 450 枚比特币,持有总量达 3879.2 枚
- 比特币收藏家以 500 美元购买稀有 Casascius 金条,现获利逾 1,000 万美元
- RootData:MOVE 将于一周后解锁价值约 828 万美元的代币
- Project Hunt:衍生品交易市场 Euphoria Finance 为过去 7 天新增 Top 人物关注者最多的项目
- Jump Crypto 休眠 1 年地址 8 小时前收到 3310 万枚 W,或为投资人归属
- 币安将于 7 月 4 日移除 ACT/EUR 等 4 个现货交易对
- Bit Digital 承销商全额行使增购选项,筹资 1.629 亿美元或用于购买 ETH
- Cyber 推出的加密 AI 指挥枢纽 Surf 上线 Yapper Leaderboard
- 1RT Acquisition Corp.拟通过 IPO 募资 1.5 亿美元拓展数字资产、金融科技业务
- 领航医药生物科技盘中一度飙升近 240%,曾宣布计划收购 Conflux 全部股权
- 分析:应加强港沪合作,形成在岸数字人民币与离岸人民币稳定币良性发展格局
- Robinhood 已在 Arbitrum 上部署了 213 枚股票代币或正在进行相关测试
- Bitfinex Alpha:比特币价格或将持续横盘整理,除非有重大宏观经济事件等利好
- Sonic 积分空投第二季现已上线,仅真实 DeFi 活动计入积分
- 大摩:香港拟先推美元和港元挂钩稳定币,CNH 稳定币或有万亿离岸人民币资金池支持
- 加密恐慌指数回落至 63,市场仍处于贪婪状态
- 过去 24 小时 CEX 净流入 2184.81 枚 BTC
- 沉寂 7 个月巨鲸从 CEX 提取 8033 枚 AAVE,价值 209 万美元
- 特朗普税改法案引发美国赤字担忧,美元持续疲软
- 港股上市公司德林控股将设立多资产策略基金并拟申请香港稳定币牌照
- 角色扮演游戏 Crystalfall 完成 200 万美元融资,Avalanche 等参投
- 亚利桑那州州长否决“比特币储备”法案 HB2324
- 特朗普之子支持的 American Bitcoin 向美 SEC 提交 S-4 表格修订注册声明
- 欧洲央行推进 DLT 交易结算,计划 2026 年启动试点
- Kaito 已上线 Surf,奖励包括 10 万枚 CYBER 代币、Surf Waitlist 积分
- 尽管受到新加坡法规的约束,币安仍继续运营
- 上市公司上半年共买入 245,510 枚 BTC,是同期 ETF 买入量的两倍多
- Certik:2025 年上半年加密黑客攻击与诈骗致损失逾 25 亿美元
- Cookie Snaps 已上线 vooi,代币总供应量的 1.25%将分配给平台用户
- 沉寂近 3 年巨鲸向 Kraken 存入 2450 枚 ETH,获利 280 万美元
- 特朗普称 7 月 3 日去艾奥瓦期间将公布贸易和农业政绩
- 美联储 7 月维持利率不变的概率降至 78.8%
- 上市大麻公司 Dogecoin Cash Inc.成立子公司以建立 DOGE 金库及相关业务
- James Wynn 连遭四次清算,账户余额仅剩 1.06 万美元
- 昨日 FBTC 净流出 1.727 亿美元,GBTC 净流出 1.195 亿美元
- 美国 SEC 发布新的加密货币 ETF 指南
- 以太坊社区基金会成立,通过资助“不可篡改且无代币”项目来提升 ETH 价值
- 瑞士金融监管机构加强对 Swissquote 监管,要求减少可疑交易报告数量
- 美国参议院通过“大而美”法案,现已提交众议院审议
- DeFi Development 将通过可转债融资 1 亿美元,用于增持 Solana 与回购股份
- 美财长:若马斯克专注搞火箭,那我就专注搞金融
- 美财长:美联储最迟肯定会在 9 月降息
- 摩根大通批准 500 亿美元股票回购计划
- 以太坊基金会在旧金山开设 Ethereum House
比推专栏
更多 >>观点
比推热门文章
- 加密矿企 Cango 6 月挖出 450 枚比特币,持有总量达 3879.2 枚
- 比特币收藏家以 500 美元购买稀有 Casascius 金条,现获利逾 1,000 万美元
- RootData:MOVE 将于一周后解锁价值约 828 万美元的代币
- Project Hunt:衍生品交易市场 Euphoria Finance 为过去 7 天新增 Top 人物关注者最多的项目
- Jump Crypto 休眠 1 年地址 8 小时前收到 3310 万枚 W,或为投资人归属
- 币安将于 7 月 4 日移除 ACT/EUR 等 4 个现货交易对
- Bit Digital 承销商全额行使增购选项,筹资 1.629 亿美元或用于购买 ETH
- Cyber 推出的加密 AI 指挥枢纽 Surf 上线 Yapper Leaderboard
- 1RT Acquisition Corp.拟通过 IPO 募资 1.5 亿美元拓展数字资产、金融科技业务
- 领航医药生物科技盘中一度飙升近 240%,曾宣布计划收购 Conflux 全部股权