扫二维码与项目经理沟通
我们在微信上24小时期待你的声音
解答本文疑问/技术咨询/运营咨询/技术建议/互联网交流
本篇文章为大家展示了Uniswap Python开发包的概述以及部署使用方法，内容简明扼要并且容易理解，绝对能使你眼前一亮，通过这篇文章的详细介绍希望你能有所收获。
为尼金平等地区用户提供了全套网页设计制作服务，及尼金平网站建设行业解决方案。主营业务为成都做网站、网站建设、外贸营销网站建设、尼金平网站设计，以传统方式定制建设网站，并提供域名空间备案等一条龙服务，秉承以专业、用心的态度为用户提供真诚的服务。我们深信只要达到每一位用户的要求，就会得到认可，从而选择与我们长期合作。这样，我们也可以走得更远！
Uniswap.py开发包适用于为Python应用快速增加对Uniswap协议的支持能力。即支持使用自有部署以太坊区块链节点的应用场景，也支持使用第三方节点的轻量级部署场景，官方下载地址：Uniswap.py开发包
Uniswap.py开发包主要包含以下特性：
一键部署Uniswap协议，便于快速开发与测试
支持Uniswap协议的全部接口，并提供开发人员友好的API
支持ERC20/ERC20、ETH/ERC20等各种交易对的流动性添加、移除与兑换交易
支持自动做市价格计算与滑点计算
支持以太坊交易gas用量与gas价格的自动估算与手动设定
支持EIP712签名授权，单一交易内完成流动性维护
Uniswap.py开发包运行在 Python 3.6+环境下，当前版本1.0.0，主要类/接口及关系如下图所示：
Uniswap.py开发包的主要代码文件清单见官方说明：http://sc.hubwiz.com/codebag/uniswap-py/
在终端进入项目目录，执行如下命令编译Uniswap及开发包提供的测试Token合约：
~$ cd ~/uniswap.py ~/uniswap.py$ bin/build-contracts
执行结果如下：
首先在另一个终端启动开发私链：
~$ ganache-cli -d
然后进入项目demo目录，执行如下命令部署合约：
~$ cd ~/uniswap.py/demo ~/uniswap.py/demo$ python deploy_contracts.py
执行结果如下：
注意：如果需要在以太坊测试链，例如Ropsten、Rinkeby等，或者在主链 部署上述合约，或者使用其他参数启动ganache-cli，需要修改demo/config.py 中的账号配置。
代码token_approve.py演示了如何授权Uniswap路由合约代理操作当前账号的HAPY token和USDT token。
在终端进入项目demo目录，执行如下命令：
~$ cd ~/uniswap.py/demo ~/uniswap.py/demo$ python token_approve.py
执行结果如下：
代码add_liquidity.py演示了如何为ERC20/ERC20交易对添加流动性。
在终端进入项目demo目录，执行如下命令：
~$ cd ~/uniswap.py/demo ~/uniswap.py/demo$ python add_liquidity.py
执行结果如下：
Uniswap协议约定，第一次添加流动性将自动创建交易对，之后再次添加流动性时，演示代码将首先显示当前的仓位信息。例如再次执行如下命令：
~/uniswap.py/demo$ python add_liquidity.py
执行结果如下：
代码remove_liquidity.py演示了如何移除指定的ERC20/ERC20交易对的流动性。
在终端进入项目demo目录，执行如下命令：
~$ cd ~/uniswap.py/demo ~/uniswap.py/demo$ python remove_liquidity.py
执行结果如下：
代码swap_exact_tokens_for_tokens.py演示了如何实现以输入token数量为基准的ERC20/ERC20兑换。
在终端进入项目demo目录，执行如下命令：
~$ cd ~/uniswap.py/demo ~/uniswap.py/demo$ python swap_exact_tokens_for_tokens.py
执行结果如下：
代码swap_tokens_for_exact_tokens.py演示了如何实现以输出token数量为基准的ERC20/ERC20兑换。
在终端进入项目demo目录，执行如下命令：
~$ cd ~/uniswap.py/demo ~/uniswap.py/demo$ python swap_tokens_for_exact_tokens.py
执行结果如下：
代码add_liquidty_eth.py演示了如何为ETH/ERC20或ERC20/ETH交易对添加流动性。
在终端进入项目demo目录，执行如下命令：
~$ cd ~/uniswap.py/demo ~/uniswap.py/demo$ python add_liquidity_eth.py
执行结果如下：
第一次添加流动性将自动创建交易对，之后再次添加将首先显示当前的持仓信息。例如再次执行如下命令：
~/uniswap.py/demo$ python add_liquidity_eth.py
执行结果如下：
代码remove_liquidity_eth.py演示了如何移除ETH/ERC20或ERC20/ETH交易对的流动性。
在终端进入项目demo目录，执行如下命令：
~$ cd ~/uniswap.py/demo ~/uniswap.py/demo$ python remove_liquidity_eth.py
执行结果如下：
代码swap_exact_eth_for_tokens.py演示和如何将指定数量的ETH兑换为ERC20 token。
在终端进入项目demo目录，执行如下命令：
~$ cd ~/uniswap.py/demo ~/uniswap.py/demo$ python swap_exact_eth_for_tokens.py
执行结果如下：
代码swap_eth_for_exact_tokens.py演示了如何将ETH兑换为指定数量的ERC20 token。
在终端进入项目demo目录，执行如下命令：
~$ cd ~/uniswap.py/demo ~/uniswap.py/demo$ python swap_eth_for_exact_tokens.py
执行结果如下：
代码swap_exact_tokens_for_eth.py演示了如何将指定数量的ERC20 token兑换为ETH。
在终端进入项目demo目录，执行如下命令：
~$ cd ~/uniswap.py/demo ~/uniswap.py/demo$ python swap_exact_tokens_for_eth.py
执行结果如下：
代码swap_tokens_for_exact_eth.py演示了如何将ERC20token兑换为指定数量的ETH。
在终端进入项目demo目录，执行如下命令：
~$ cd ~/uniswap.py/demo ~/uniswap.py/demo$ python swap_tokens_for_exact_eth.py
执行结果如下：
SwapKit是开发包的入口，使用这个类可以快速实现如下功能：
流动性添加与移除：支持ERC20/ERC20、ERC20/ETH、ETH/ERC20等各种交易对
兑换交易的创建与执行：支持ERC20/ERC20、ERC20/ETH、ETH/ERC20等各种交易对，支持以输入或输出价格为准
用户仓位查询：查询指定账号在指定交易对的持仓情况，例如持仓数量、占比等。
SwapKit实例化需要传入三个参数：
以太坊节点URL
Uniswap路由合约地址
用于执行合约交互的以太坊账号的私钥。
例如，下面的代码创建一个接入以太坊主网Uniswap协议的SwapKit实例：
from uniswap import SwapKit kit = SwapKit( 'http://localhost:8545', # 以太坊节点URL '0x7a250d5630B4...b4c659F2488D', # Uniswap路由合约地址 '0x4f3e...3b1d' # 默认执行账号，指定私钥 );
为了避免混淆各网络的Uniswap路由地址，uniswap.py提供了ProtocolMeta类的静态方法getPresetAddress()来获取Uniswap官方在以太坊主网和测试网部署的Uniswap协议合约地址。例如获取主网的路由合约：
from uniswap import ProtocolMeta
routerAddr = ProtocolMeta.getPresetAddress(
SwapKit.MAINNET, # 以太坊主网
SwapKit.ROUTER # Uniswap路由合约
);
print('router address: %s' % routerAddr) # 0x7a250d5630B4...ProtocolMeta目前支持的以太坊网络及标识见官网说明：http://sc.hubwiz.com/codebag/uniswap-py/
由于Uniswap协议中涉及到交易滑点处理以及价格预计算，因此uniswap.py提供了一个专门的类 OrderBuilder用于生成流动性添加/移除委托单。OrderBuilder的实现内置了自动价格计算与滑点计算，因此调用者只需要指定基本的数据即可生成可提交给Uniswap合约的流动性添加/移除委托单。
使用SwapKit对象的orderBuilder睡醒获取预创建的OrderBuilder对象，并调用OrderBuilder的build() 方法生成委托单。例如：
order = ( kit.orderBuilder() # 返回OrderBuilder对象 .... # 参数设置 .build() # 生成并返回委托单 )
OrderBuilder对象提供了以下方法用于调整生成器的行为：
orderType(type)：设置委托单类型，目前支持两种：
Order.LIQUIDITY_ADD - 流动性添加委托单
Order.LIQUIDITY_REMOVE - 流动性移除委托单
tokenA(addr)/ tokenB(addr)：交易对的两个Token地址 用SwapKit.ETH_TOKEN表示以太币的地址
amountA(bn)/ amountB(bn)：两个token的添加数量，仅在添加流动时需要设置
liquidity(bn)：LP token数量，仅在移除流动性时需要设置
slippage(bn)：交易滑点设置，默认值为5， 表示0.5%的滑点容忍区间
to(addr)：委托单执行结果接收地址
例如，下面的代码生成一个流动性添加委托单：
from uniswap import SwapKit, Order
order = (
kit.orderBuilder # 获取委托单生成器对象
.orderType(Order.LIQUIDITY_ADD) # 添加流动性
.tokenA('0x...') # 交易对TokenA地址
.tokenB('0x...') # 交易对TokenB地址
.amountA(100000000000000000000) # 以TokenA数量为基准按市价自动计算TokenB数量
.slippage(10) # 滑点容忍范围1%
.to(kit.credential.address) # 设置LP Token的接收地址
.build() # 生成委托单
)
print('amountA => %d' % order.amountA) # TokenA设置数量
print('amountB => %d' % order.amountB) # TokenB计算数量
print('amountAMin => %d' % order.amountAMin) # 滑点处理后的TokenA最小可接受数量
print('amountBMin => %d' % order.amountAMin) # 滑点处理后的TokenB最小可接受数量注意：
使用特殊的 SwapKit.ETH_TOKEN表示交易对中的ETH，值为：0x00000000000000000000000000000000000eEEEE
token数量均按最小单位指定
类似的，下面的代码生成一个流动性移除委托单：
order = (
kit.orderBuilder # 获取委托单生成器对象
.orderType(Order.LIQUIDITY_REMOVE) # 移除流动性
.tokenA('0x...') # 交易对TokenA地址
.tokenB('0x...') # 交易对TokenB地址
.liquidity(10000000000000000000) # 要移除的流动性数量
.slippage(10) # 滑点容忍范围1%
.to(kit.credential.address) # token接收地址
.build() # 生成委托单
)
print('amountAMin => %d' % order.amountAMin) # 滑点处理后最少应收到的TokenA数量
print('amountBMin => %d' % order.amountAMin) # 滑点处理后最少应收到的TokenB数量Order对象提供的以下值，有助于在执行委托单之前向用户提供更好的反馈信息：
amountA/amountB：市价计算的tokenA或tokenB理想值
amountAMin/amountAMax：滑点处理后的tokenA最小值/最大值
amountBMin/amountBMax：滑点处理后的tokenB最小值/最大值
使用SwapKit的 executeOrder()方法即可执行生成的流动性委托单，最终完成流动性添加/移除交易。例如：
from uniswap import to_hex
txid = kit.executeOrder(trade) # 执行委托单
print('txid => %s' % to_hex(txid)) # 显示交易ID默认情况下，executeOrder()方法自动估算交易所需的gas限额与gas价格，但可以传入额外的参数手动设置这两个值。
例如，下面的代码以指定的gas参数执行流动性维护单：
from uniswap import to_hex
opts = {
'gas': 4000000, # 4 million
'gasPrice': 200000000000 # 200 gwei
}
txid = kit.executeOrder(order, opts) # 执行委托单
print('txid => %s' % to_hex(txid)) # 显示交易ID使用SwapKit的 getLiquidityInfo()方法可以查询指定账号在指定交易对的仓位信息。例如查询某地址的持仓情况：
info = kit.getLiquidityInfo( # 查询持仓信息
'0x90F8...c9C1', # 要查询的地址
'0x9956...F4B8', # 交易对tokenA地址
'0x94dF...2Df7' # 交易对tokenB地址
)
print('total => %d' % info['totalSupply']) # LP Token总量
print('balance => %d' % info['balance']) # 持仓数量
print('share => %.4f' % info['share']) # 持仓比例类似于流动性的添加与移除，在Uniswap中的交易对兑换也存在价格自动计算与滑点处理问题。为此，uniswap.py开发包提供了一个专门的类 TradeBuilder用来简化这一操作。TradeBuilder内置了价格自动计算与滑点处理，因此调用者只需要设置基本的参数即可。
使用SwapKit对象的tradeBuilder属性获取预创建的TradeBuilder对象，例如：
trade = ( kit.tradeBuilder # 获取预创建的兑换交易生成器 ... # 参数设置 .build() # 生成兑换交易对象 )
TradeBuilder提供了以下方法用于调整生成器的行为：
tradeType(type)：兑换类型，可选值为：
Trade.EXACT_INPUT - 以tokenIn的数量为基准
Trade.EXACT_OUTPUT - 以tokenOut的数量为基准
tokenIn(addr)- 输入Token的地址
tokenOut(addr)- 输出Token的地址
amountIn(bn)- 输入数量，仅在兑换类型为EXACT_INPUT时需要设置
amountOut(bn)- 输出数量，仅在兑换类型为EXACT_OUTPUT时需要设置
slippage(bn)- 交易滑点设置，默认值5， 表示允许0.5%的滑点
to(addr)- 输出token接收地址
例如，下面的代码以输入token数量为基准生成一个兑换交易对象：
from uniswap import Trade
trade = (
kit.tradeBuilder # 获取兑换交易生成器
.tradeType(Trade.EXACT_INPUT) # 以输入token数量为基准
.tokenIn('0x...') # 输入token地址
.tokenOut('0x...') # 输出token地址
.amountIn(10000000000000000000) # 输入token的数量
.slippage(10) # 滑点容忍范围1%
.to(kit.credential.address) # 输出token的接收地址
.build() # 生成兑换交易对象
)
print('amountIn => %d' % trade.amountIn) # 输入token的设置数量
print('amountOut => %d' % trade.amountOut) # 自动做市算法得到的输出token的数量
print('amountOutMin => %d' % trade.amountOutMin) # 滑点处理后的应收到的输出token最少数量使用SwapKit对象的 executeTrade()方法执行指定的兑换交易对象。例如：
from uniswap import to_hex
txid = kit.executeTrade(trade) # 执行兑换交易
print('txid => %s' % to_hex(txid)) # 显示交易ID默认情况下，executeTrade()方法自动估算交易所需的gas限额与gas价格，但可以传入额外的参数手动设置这两个值。
例如，下面的代码使用设定的gas参数执行兑换交易：
opts = {
'gas': 4000000, # 4 million
'gasPrice': 200000000000 # 200 gwei
}
txid = kit.executeTrade(trade, opts) # 执行交易上述内容就是Uniswap Python开发包的概述以及部署使用方法，你们学到知识或技能了吗？如果还想学到更多技能或者丰富自己的知识储备，欢迎关注创新互联行业资讯频道。
我们在微信上24小时期待你的声音
解答本文疑问/技术咨询/运营咨询/技术建议/互联网交流
微信二维码
移动版官网