内容接（上篇），接下来我们来一起继续剖析「Uniswap V3 交易类库」的代码。

Part3：Uniswap V3操作对象的构造函数

这个模板类库的核心就是Uniswap V3操作对象，这个对象实现了在Uniswap V3上的基本操作。后续可能还会升级更多的功能。通过剖析这个代码例子，即使不使用FMZ平台，也会增加对Uniswap这个DEX的各个环节流程、细节的认识和理解，目前我们就来学习下这些基本的功能是如何在FMZ上设计实现的。

Uniswap V3操作对象的构造函数代码：

可能不熟悉FMZ的同学看到这个函数$.NewUniswapV3命名有些奇怪，带有$.开头的函数，表示这个函数是FMZ上模板类库的接口函数（何为模板类库可以查阅），简单说就是$.NewUniswapV3函数可以让其它引用了该模板类库的策略直接调用。策略就直接拥有了Uniswap V3的功能。

这个$.NewUniswapV3函数直接构造、创建一个对象，使用这个对象就可以进行一些操作：

• token兑换：由该对象的swapToken方法实现。

• ETH余额查询：由该对象的getETHBalance方法实现。

• token余额查询：由该对象的balanceOf方法实现。

• 交易对价格查询：由该对象的getPrice方法实现。

• 发送ETH进行转账：由该对象的sendETH方法实现。

这个类库可能后续不局限于这些功能，甚至可以升级增加「添加流动性」等功能。我们来继续剖析代码：

构造函数$.NewUniswapV3只有一个参数e，这个e表示交易所对象（在FMZ上的交易所配置）。因为在FMZ上策略可以设计成多exchange的，所以这里如果传入某个具体的exchange就表示创建出来的Uniswap V3对象是操作该交易所对象的。如果不传参数e，默认操作第一个添加的交易所对象。

配置节点服务地址、私钥（可以本地部署私钥，本地部署只用配置路径），就创建了一个交易所对象。在实盘的时候就可以添加在策略上，这个对象体现在策略代码中就是exchange也即exchanges[0]，如果添加第二个就是exchanges[1]，添加第三个为exchanges[2]，...

截图中我配置的节点地址：https://mainnet.infura.io/v3/xxx 是用的infura的节点，这个可以个人申请，每个账号都有各自的具体地址，xxx这里是掩码，每个账户的xxx部分各不相同。

继续说代码，该构造函数开始判断交易所对象是不是Web3的，不是Web3就报错。然后创建了一个变量self，这个self就是构造函数最终返回的对象，后续构造函数给这个对象增加了各种函数，并且实现具体功能。self变量有3个属性：

• tokenInfo ：记录注册在该对象的token代币信息，代币信息包括代币地址、代币精度、代币名称。

• walletAddress：当前交易所对象的钱包地址。

• pool：注册在该对象的兑换池信息，主要是兑换池名称和兑换池地址。

紧接着用到了我们上篇学习到的概念：

为什么要注册这些接口信息呢？

因为后续要实现的一些功能需要调用这些智能合约的接口。接下来就是该构造函数给self对象增加各种方法了，self对象的方法除了上述提到的：兑换token、查询余额等，还有一些属于这个self对象的工具函数，我们这里先剖析这些工具函数。

self对象的工具函数

1、self.addToken = function(name, address)

观察这个函数的具体代码可知，这个函数功能是给当前对象self中记录token信息的成员tokenInfo增加（换种说法就是：注册）一个token（代币）信息。因为token（代币）的精度数据在后续计算时要经常用到，所以在这个函数增加（注册）token信息的时候，调用了let ret = e.IO("api", address, "decimals")函数，通过FMZ封装的exchange.IO函数（前边我们提过了e就是传入的exchange对象），调用token代币合约的"decimals"方法，从而获取token的精度。

所以self.tokenInfo是一个字典结构，每个键名是token名字，键值是这个token的信息，包括：地址、名称、精度。大概是这个样子：

2、self.waitMined = function(tx)

该函数用于等待以太坊上智能合约的执行结果，从这个函数的实现代码上可以看到，这个函数一直在循环调用let info = e.IO("api", "eth", "eth_getTransactionReceipt", tx)，通过调用以太坊的RPC方法eth_getTransactionReceipt，来查询交易哈希返回交易的收据，参数tx即为交易哈希。

eth_getTransactionReceipt等相关资料可以查看：https://ethereum.org/zh/developers/docs/apis/json-rpc/#eth_gettransactionreceipt

可能有同学会问：为什么要用这个函数？

答：在执行一些操作时，例如token兑换，是需要等待结果的。

接下来我们再来看$.NewUniswapV3函数创建的对象self的其它主要功能实现，我们从最简单的讲起。

主要功能函数

1、self.getETHBalance = function(address)

查询token（代币）余额是有区分的，分为查询ETH（以太坊）余额，查询其它ERC20的token余额。self对象的getETHBalance函数是用来查询ETH余额的，当传入了具体钱包地址参数address时，查询这个地址的ETH余额。如果没有传address参数则查询self.walletAddress地址的ETH余额（即当前exchange上配置的钱包）。

这些通过调用以太坊的RPC方法eth_getBalance实现。

2、self.balanceOf = function(token, address)

查询除了ETH以外的token余额，需要传入参数token即代币名称，例如USDT。传入所要查询的钱包地址address，没有传入address则查询self.walletAddress地址的余额。观察这个函数实现的代码可知，需要事先通过self.addToken函数注册过的token才可以查询，因为调用token的合约的balanceOf方法时，需要用到token（代币）的精度信息和地址。

3、self.sendETH = function(to, amount, options)

该函数的功能为ETH转账，向某个钱包地址（使用to参数设置）转账一定数量的ETH（使用amount参数设置），可以再设置一个options参数（数据结构：{gasPrice: 111, gasLimit: 111, nonce: 111}）用来指定gasLimit/gasPrice/nonce，不传入options参数即使用系统默认的设置。

gasLimit/gasPrice影响在以太坊上执行操作时消耗的ETH（以太坊上的一些操作是消耗gas的，即消耗一定ETH代币）。

4、self.getPrice = function(pair, fee)

该函数用来获取在Uniswap上某个交易对的价格，通过函数实现代码可以看到，在函数开始执行时会首先将交易对pair解析，得到baseCurrency和quoteCurrency。例如交易对是ETH_USDT，则会拆分为ETH和USDT。然后查询self.tokenInfo中是否有这两种token（代币）的信息，没有则报错。

在Uniswap上的兑换池地址是由参与的两种token（代币）地址、Fee（费率标准）计算构成的，所以在查询self.pool（self.pool之前我们提过，可以看下）中记录的池地址时，如果没有查询到就使用两种token的地址、Fee去计算池地址。所以一个交易对可能有多个池，因为Fee可能不同。

查询、计算兑换池的地址通过调用Uniswap V3的工厂合约的getPool方法获得（所以要在开始注册工厂合约的ABI）。
拿到这个交易对的池地址，就可以注册池合约的ABI。这样才能调用这个池（智能合约）的slot0方法，从而拿到价格数据。当然这个方法返回的数据并不是人类可读的价格，而是一个和价格相关的数据结构，需要进一步处理获取可读的价格，这个时候就使用到我们上篇中提到的computePoolPrice函数。

5、self.swapToken = function(tokenIn, amountInDecimal, tokenOut, options)

该函数的功能是token兑换，参数tokenIn是兑换时支付的代币名称，参数tokenOut是兑换时获得的代币名称，参数amountInDecimal是兑换数量（人类可读的数量），参数options和我们之前提到的一样，可以设置兑换时的gas消耗、nonce等。

函数执行时首先还是先通过self.tokenInfo变量中拿到token（代币）的信息，兑换也是很多细节的，首先如果参与兑换的token中，支付的token不是ETH则需要先给路由（负责兑换的智能合约）授权。授权之前要先查询是否已经有足够的授权额度。

使用token合约allowance方法查询已经授权的额度。通过比较已经授权的额度和当前兑换的数量，如果授权的额度足够兑换，则不用再授权。如果额度不够则执行授权处理。

这里授权也有一个细节，如果授权的token是USDT，则需要先重置授权数量为0，再进行授权。授权使用token合约的approve方法。注意approve授权方法是一个消耗gas的方法，会消耗一定量的ETH。所以需要使用self.waitMined函数等待处理结果。

为了避免频繁授权，支付不必要的ETH，这个授权操作一次性授权最大值。

有足够的兑换额度，就可以进行兑换了。但是这里也有细节，如果参与兑换的token中，兑换后获取的token是ETH则需要修改接收地址：

具体原因比较复杂，这里不在赘述，可以参看：

ADDRESS_THIS https://degencode.substack.com/p/uniswapv3-multicall
https://etherscan.io/address/0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45#code

接着使用FMZ平台封装的打包函数e.IO("pack", ...，打包对于路由（智能合约）的swapExactTokensForTokens方法调用，如果兑换后获取的token是ETH则还需要增加一步WETH9的解包操作：

因为参与兑换的是WETH，这个是ETH的一个包装后的代币。换成真正的ETH需要解包操作，把这个解包操作也打包之后就可以调用路由（智能合约）的multicall方法执行这一系列操作了。这里还有一个细节要额外注意，如果参与兑换的交易对，支付的token是ETH时是需要在如下步骤设置转账的ETH数量，如果不是ETH则设置0。

这个设定体现在这里：(tokenInInfo.name == 'ETH' ? amountIn : 0)。小编就因为之前没弄清楚，没有在tokenIn不等于ETH代币时设置0，导致误转了ETH。所以编写转账代码时要格外小心。

Part4：Uniswap V3操作对象如何使用

这个模板中的代码在功能实现上实际不到200行，以下这一段实际是使用演示。

$.testUniswap = function()这个函数仅仅只是一个演示，没有实际用途请勿调用。我们通过这个函数来看如何使用这个模板类库操作Uniswap V3的功能。

代码中首先执行let ex = $.NewUniswapV3()构造了一个Uniswap V3操作对象，如果想拿到当前exchange绑定的钱包地址，可以使用ex.walletAddress获取。接着代码中使用ex.addToken注册了三种token，分别是ETH、USDT、1INCH。

打印某个交易对的价格（token需要先注册）：

getPrice函数如果没有设置Fee，则使用的是默认3000这个费率，转换为可读数值是0.3%。

如果要把0.01个ETH兑换成USDT，然后查询余额，接着再兑换回来，则使用代码：

使用测试网 Goerli 测试

1、配置测试网交易所对象

注意设置节点就需要设置为测试网Goerli的节点。

2、编写一个策略，在测试网Goerli上测试。

测试代码中我们测试了打印钱包地址、注册token信息、打印资产余额、进行了一次连续兑换ETH -> UNI -> LINK。需要注意这里注册的代币地址是以太坊测试网Goerli上的，所以同样名称的代币地址是不同的，至于测试币可以用这个测试网的水龙头申请测试代币，具体可以谷歌查询。

注意要勾选「Uniswap V3 交易类库」模板才能使用$.NewUniswapV3()函数，如果你的FMZ账号还没有这个模板，可以点击这里获取。

策略运行日志：

Uniswap页面上显示的资产数值

https://app.uniswap.org/

在链上对应也能查询到这些操作：

https://goerli.etherscan.io/

ETH兑换为UNI执行了一次，对UNI授权执行一次，把UNI兑换为LINK执行了一次。

END

这个类库还有很多功能可以扩展，甚至可以扩展打包多次兑换实现tokenA -> tokenB -> tokenC路径兑换。具体可以根据需求优化、扩展，此类库代码主要提供教学为主。