为JavaScript应用快速增加Uniswap协议对接能力。
Uniswap.js 开发包适用于为Web前端或Node.js应用快速增加对Uniswap协议的支持能力。 即支持使用自有部署以太坊区块链节点的应用场景,也支持使用第三方节点的 轻量级部署场景。
Uniswap.js开发包主要包含以下特性:
Uniswap.js开发包运行在 JavaScript 环境下,当前版本1.0.0,主要类/接口及关系如下图所示:
Uniswap.js开发包的主要代码文件清单如下:
代码文件 | 说明 |
---|---|
lib/SwapKit.js | Uniswap.js开发包入口类 |
lib/OrderBuilder.js | 流动性维护订单构造器 |
lib/Order.js | 流动性维护订单类 |
lib/TradeBuilder.js | 兑换交易构造器 |
lib/Trade.js | 兑换交易类 |
lib/Deployer.js | 合约部署器 |
lib/ProtoclMeta.js | Uniswap协议元数据 |
demo/deploy-contracts.js | Uniswap及测试Token合约部署工具,可用于快速开发与测试 |
demo/add-liquidity.js | ERC20/ERC20交易对流动性添加演示 |
demo/add-liquidity.js | ERC20/ERC20交易对流动性添加演示 |
demo/add-liquidity-eth.js | ERC20/ETH交易对流动性添加演示 |
demo/remove-liquidity.js | ERC20/ERC20交易对流动性移除演示 |
demo/remove-liquidity-eth.js | ERC20/ETH交易对流动性移除演示 |
demo/swap-exact-tokens-for-tokens.js | ERC20/ERC20兑换演示,以输入token数量为基准 |
demo/swap-tokens-for-exact-tokens.js | ERC20/ERC20兑换演示,以输出token数量为基准 |
demo/swap-exact-eth-for-tokens.js | ETH/ERC20兑换演示,以输入eth数量为基准 |
demo/swap-eth-for-exact-tokens.js | ETH/ERC20兑换演示,以输出token数量为基准 |
demo/swap-exact-tokens-for-eth.js | ERC20/ETH兑换演示,以输入token数量为基准 |
demo/swap-tokens-for-exact-eth.js | ERC20/ETH兑换演示,以输出eth数量为基准 |
contracts/HappyToken.sol | 标准ERC20 token实现,开发测试用 |
contracts/TetherToken.sol | Tether/USDT实现,开发测试用 |
contracts/UniswapV2Factory.sol | Uniswap V2工厂合约实现 |
contracts/UniswapV2Router02.sol | Uniswap V2路由合约实现 |
contracts/WETH9.sol | WETH9合约实现 |
bin/ | 合约编译工具目录 |
bin/build-contracts | 合约编译脚本 |
config.js | 演示程序参数配置文件 |
package.json | uniswap.js npm描述文件 |
在终端进入项目目录,执行如下命令编译Uniswap及开发包提供的测试Token合约:
~$ cd ~/uniswap.js
~/uniswap.js$ bin/build-contracts
执行结果如下:
首先在另一个终端启动开发私链:
~$ ganache-cli -d
然后进入项目demo目录,执行如下命令部署合约:
~$ cd ~/uniswap.js/demo
~/uniswap.js/demo$ node deploy-contracts.js
执行结果如下:
注意 :如果需要在以太坊测试链,例如Ropsten、Rinkeby等,或者在主链 部署上述合约,或者使用其他参数启动ganache-cli,需要修改config.js 中的账号配置。
代码demo/token-approve.js
演示了如何授权Uniswap路由合约代理操作
当前账号的HAPY token和USDT token。
在终端进入项目demo目录,执行如下命令:
~$ cd ~/uniswap.js/demo
~/uniswap.js/demo$ node token-approve.js
执行结果如下:
代码demo/add-liquidity.js
演示了如何为ERC20/ERC20交易对添加流动性。
在终端进入项目demo目录,执行如下命令:
~$ cd ~/uniswap.js/demo
~/uniswap.js/demo$ node add-liquidity.js
执行结果如下:
Uniswap协议约定,第一次添加流动性将自动创建交易对 ,之后再次添加 流动性时,演示代码将首先显示当前的仓位信息。例如再次执行如下命令:
~/uniswap.js/demo$ node add-liquidity.js
执行结果如下:
代码demo/remove-liquidity.js
演示了如何移除指定的ERC20/ERC20
交易对的流动性。
在终端进入项目demo目录,执行如下命令:
~$ cd ~/uniswap.js/demo
~/uniswap.js/demo$ node remove-liquidity.js
执行结果如下:
代码demo/swap-exact-tokens-for-tokens.js
演示了如何实现以输入
token数量为基准的ERC20/ERC20兑换。
在终端进入项目demo目录,执行如下命令:
~$ cd ~/uniswap.js/demo
~/uniswap.js/demo$ node swap-exact-tokens-for-tokens.js
执行结果如下:
代码demo/swap-tokens-for-exact-tokens.js
演示了如何实现以输出
token数量为基准的ERC20/ERC20兑换。
在终端进入项目demo目录,执行如下命令:
~$ cd ~/uniswap.js/demo
~/uniswap.js/demo$ node swap-tokens-for-exact-tokens.js
执行结果如下:
代码demo/add-liquidty-eth.js
演示了如何为ETH/ERC20或ERC20/ETH交易对添加流动性。
在终端进入项目demo目录,执行如下命令:
~$ cd ~/uniswap.js/demo
~/uniswap.js/demo$ node add-liquidity-eth.js
执行结果如下:
第一次添加流动性将自动创建交易对,之后再次添加将首先显示 当前的持仓信息。例如再次执行如下命令:
~/uniswap.js/demo$ node add-liquidity-eth.js
执行结果如下:
代码demo/remove-liquidity-eth.js
演示了如何移除ETH/ERC20或ERC20/ETH
交易对的流动性。
在终端进入项目demo目录,执行如下命令:
~$ cd ~/uniswap.js/demo
~/uniswap.js/demo$ node remove-liquidity-eth.js
执行结果如下:
代码demo/swap-exact-eth-for-tokens.js
演示了如何将指定数量的ETH
兑换为ERC20 token。
在终端进入项目demo目录,执行如下命令:
~$ cd ~/uniswap.js/demo
~/uniswap.js/demo$ node swap-exact-eth-for-tokens.js
执行结果如下:
代码demo/swap-eth-for-exact-tokens.js
演示了如何将ETH兑换为指定
数量的ERC20 token。
在终端进入项目demo目录,执行如下命令:
~$ cd ~/uniswap.js/demo
~/uniswap.js/demo$ node swap-eth-for-exact-tokens.js
执行结果如下:
代码demo/swap-exact-tokens-for-eth.js
演示了如何将指定数量的
ERC20 token兑换为ETH。
在终端进入项目demo目录,执行如下命令:
~$ cd ~/uniswap.js/demo
~/uniswap.js/demo$ node swap-exact-tokens-for-eth.js
执行结果如下:
代码demo/swap-tokens-for-exact-eth.js
演示了如何将ERC20
token兑换为指定数量的ETH。
在终端进入项目demo目录,执行如下命令:
~$ cd ~/uniswap.js/demo
~/uniswap.js/demo$ node swap-tokens-for-exact-eth.js
执行结果如下:
SwapKit 是开发包的入口,使用这个类可以快速实现如下功能:
SwapKit实例化需要传入三个参数:
例如,下面的代码创建一个接入以太坊主网Uniswap协议的SwapKit实例:
const { SwapKit } = require('uniswap.js')
const kit = new SwapKit(
'http://localhost:8545', //以太坊节点URL
'0x7a250d5630B4...b4c659F2488D', //Uniswap路由合约地址
'0x4f3e...3b1d' //默认执行账号的私钥
)
为了避免混淆各网络的Uniswap路由地址,Uniswap.js 提供了
ProtocolMeta
类的静态方法getPresetAddress()
来获取Uniswap
官方在以太坊主网和测试网部署的Uniswap协议合约地址。例如
获取主网的路由合约:
const { SwapKit, ProtocolMeta } = require('uniswap.js')
const routerAddr = ProtocolMeta.getPresetAddress(
SwapKit.MAINNET, //以太坊网络
SwapKit.ROUTER //Uniswap路由合约
)
console.log(`router address: ${routerAddr}`) //0x7a250d5630B4...
ProtocolMeta 目前支持的以太坊网络及标识如下:
网络标识(SwapKit.) | 合约标识(SwapKit.) | 地址 | 说明 |
---|---|---|---|
MAINNET | FACTORY | 0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f | 以太坊主网工厂合约 |
ROUTER | 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D | 以太坊主网路由合约 | |
WETH | 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 | 以太坊主网WETH9合约 | |
ROPSTEN | FACTORY | 0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f | Ropsten测试网工厂合约 |
ROUTER | 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D | Ropsten测试网路由合约 | |
WETH | 0xc778417E063141139Fce010982780140Aa0cD5Ab | Ropsten测试网WETH9合约 | |
RINKEBY | FACTORY | 0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f | Rinkeby测试网工厂合约 |
ROUTER | 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D | Rinkeby测试网路由合约 | |
WETH | 0xc778417E063141139Fce010982780140Aa0cD5Ab | Rinkeby测试网WETH9合约 | |
GORLI | FACTORY | 0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f | Gorli测试网工厂合约 |
ROUTER | 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D | Gorli测试网路由合约 | |
WETH | 0xB4FBF271143F4FBf7B91A5ded31805e42b2208d6 | Gorli测试网WETH9合约 | |
KOVAN | FACTORY | 0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f | Kovan测试网工厂合约 |
ROUTER | 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D | Kovan测试网路由合约 | |
WETH | 0xd0A1E359811322d97991E03f863a0C30C2cF029C | Kovan测试网WETH9合约 |
由于Uniswap协议中涉及到交易滑点处理以及价格预计算,因此 Uniswap.js提供了一个专门的类 OrderBuilder 用于生成 流动性添加/移除委托单。OrderBuilder的实现内置了自动价格计算与 滑点计算,因此调用者只需要指定基本的数据即可生成可提交给 Uniswap合约的流动性添加/移除委托单。
使用SwapKit对象的orderBuilder
属性获取预创建
的OrderBuilder对象,并调用OrderBuilder的异步方法build()
生成委托单。例如:
const order = await kit.orderBuilder //返回OrderBuilder对象
...... //参数设置
.build() //生成并返回委托单
OrderBuilder对象提供了以下方法用于调整生成器的行为:
Order.LIQUIDITY_ADD
- 流动性添加委托单Order.LIQUIDITY_REMOVE
- 流动性移除委托单例如,下面的代码生成一个流动性添加委托单:
// const { SwapKit, Order, bn } = require('uniswap.js')
const order = await kit.orderBuilder //获取委托单生成器对象
.orderType(Order.LIQUIDITY_ADD) //添加流动性
.tokenA('0x...') //交易对TokenA
.tokenB('0x...') //交易对TokenB
.amountA(bn('100000000000000000000')) //以TokenA数量为基准按市价自动计算TokenB数量
.slippage(bn('10')) //滑点容忍范围1%
.to(kit.ownerAddress) //设置LP Token的接收地址
.build() //生成委托单
console.log(`amountA => ${order.amountA}`) //TokenA设置数量
console.log(`amountB => ${order.amountB}`) //TokenB计算数量
console.log(`amountAMin => ${order.amountAMin}`) //滑点处理后的TokenA最小可接受数量
console.log(`amountBMin => ${order.amountBMin}`) //滑点处理后的TokenB最小可接受数量
注意:
0x00000000000000000000000000000000000eeeee
bn(numstr)
是Uniswap.js提供的一个创建 BigNumber 对象
的快捷函数,其参数为10进制字符串。类似的,下面的代码生成一个流动性移除委托单:
// const { SwapKit, Order, bn } = require('uniswap.js')
const order = await kit.orderBuilder //获取委托单生成器对象
.orderType(Order.LIQUIDITY_REMOVE) //移除流动性
.tokenA('0x...') //交易对TokenA地址
.tokenB('0x...') //交易对TokenB地址
.liquidity(bn('10000000000000000000')) //要移除的流动性数量
.slippage(bn('10')) //滑点容忍范围1%
.to(kit.ownerAddress) //token接收地址
.build() //生成委托单
console.log(`amountAMin => ${order.amountAMin}`) //滑点处理后最少应收到的TokenA数量
console.log(`amountBMin => ${order.amountAMin}`) //滑点处理后最少应收到的TokenB数量
Order对象提供的以下值,有助于在执行委托单之前向用户提供更好的 反馈信息:
使用SwapKit的 executeOrder() 方法即可执行生成的流动性委托单,最终 完成流动性添加/移除交易。例如:
const tx = await kit->executeOrder($trade); //执行委托单
console.log(`txid => ${tx.hash}`) //显示交易ID
默认情况下,executeOrder()
方法自动估算交易所需的gas限额与gas价格,
但可以传入额外的参数手动设置这两个值。
例如,下面的代码以指定的gas参数执行流动性维护单:
// const { bn } = require('uniswap.js')
const opts = {
gasLimit: bn('4000000'), //4 million
gasPrice: bn('200000000000') //200 gwei
}
const tx = await kit.executeOrder(order, opts) //执行委托单
使用SwapKit的 getLiquidityInfo() 方法可以查询指定账号在指定交易对 的仓位信息。例如查询某地址的持仓情况:
const info = await kit.getLiquidityInfo('0x90F8...c9C1'); //查询持仓信息
console.log(`total => ${info.totalSupply}`) //LP总量
console.log(`balance => ${info.balance}`) //持仓数量
console.log(`share % => ${info.share}`) //持仓比例
类似于流动性的添加与移除,在Uniswap中的交易对兑换也存在价格自动计算与滑点 处理问题。为此,Uniswap.js开发包提供了一个专门的类 TradeBuilder 用来简化这一操作。TradeBuilder内置了价格自动计算与滑点处理,因此 调用者只需要设置基本的参数即可。
使用SwapKit对象的tradeBuilder
属性获取预创建的TradeBuilder
对象,例如:
const tb = await kit.tradeBuilder //获取预创建的兑换交易生成器
...... //参数设置
.build() //生成兑换交易对象
TradeBuilder提供了以下方法用于调整生成器的行为:
Trade.EXACT_INPUT
- 以tokenIn的数量为基准Trade.EXACT_OUTPUT
- 以tokenOut的数量为基准EXACT_INPUT
时需要设置EXACT_OUTPUT
时需要设置 例如,下面的代码以输入token数量为基准生成一个兑换交易对象:
// const { SwapKit, Trade, bn } = require('uniswap.js')
const trade = await kit.tradeBuilder //获取兑换交易生成器
.tradeType(Trade.EXACT_INPUT) //以输入token数量为基准
.tokenIn('0x...') //输入token
.tokenOut('0x...') //输出token
.amountIn(bn('10000000000000000000')) //输入token的数量
.slippage(bn('10')) //滑点容忍范围1%
.to(kit.ownerAddress) //输出token的接收地址
.build() //生成兑换交易对象
console.log(`amountIn => ${trade.amountIn}`) //输入token的设置数量
console.log(`amountOut => ${trade.amountOut}`) //自动做市算法得到的输出token的数量
console.log(`amountOutMin => ${trade.amountOutMin}`) //滑点处理后的应收到的输出token最少数量
使用SwapKit对象的 executeTrade() 方法执行指定的兑换交易对象。 例如:
const tx = await kit.executeTrade(trade) //执行兑换交易
console.log(`txid => ${tx.hash}`) //显示交易ID
默认情况下,executeTrade()
方法自动估算交易所需的gas限额
与gas价格,但可以传入额外的参数手动设置这两个值。
例如,下面的代码使用设定的gas参数执行兑换交易:
// const { bn } = require('uniswap.js')
const opts = {
gasLimit: bn('4000000'), //4 million
gasPrice: bn('200000000000') //200 gwei
}
const tx = await kit.executeTrade(trade, opts) //执行交易
本站所提供软件包仅用于学习和研究,请依法合规使用。
本站所提供软件包均提供完整源码,使用前请认真阅读源代码和文档以确保充分理解软件包的设计与功能实现,本站不承担 因不当使用本站所提供软件包而造成的任何法律风险或财产损失责任。