调用合约进行Swap交易（以SCGT为例）

platon

合约地址

Swap接口

授权

当输入代币为SCGT时，需要调用SCGT合约的approve方法，向DipoleRouter合约授权一定数量的SCGT，使DipoleRouter合约有权限从钱包地址中转出SCGT进行后续操作

swap

输入指定数量LAT，输出SCGT（swapExactETHForTokens）

输入LAT，输出指定数量SCGT（swapETHForExactTokens）

输入指定数量SCGT，输出LAT（swapExactTokensForETH）

输入SCGT，输出指定数量LAT（swapTokensForExactETH）

预估兑换数量接口

计算原理

假设交易前交易对中LAT和SCGT的数量分别为a、b，手续费为0.0025x（不考虑多跳）

• 交易中输入代币和输出代币的数量分别为x和y，根据乘积恒定公式：

  $${{ \left( {a+0.9975x} \right) }{ \left( {b-y} \right) }=ab}$$
  得到
  $$固定输入时：{输出y=\frac{{0.9975bx}}{{a+0.9975x}}}$$
  $$固定输出时：{输入x=\frac{{ay}}{{0.9975(b-y)}}+1}$$

接口

需要注意一下，DipolePair合约中有两对属性，token0/token1和reserve0/reserve1分别表示两个token地址和对应的reserve，并且token0和reserve0 、 token1和reserve1是一一对应的。

token0和token1是根据两个token地址对应的十六进制的大小确定的，token0 < token1

获取交易对地址

通过调用DipoleFactory合约的getPair方法获取

这里两个token address参数没有顺序要求

返回值：address类型的pair合约地址

获取Pair中两个token的Reserves

通过调用DipolePair合约的getReserves方法获取（无参数）

返回值

_reserve0 对应token0的reserve，_reserve1对应token1的reserve

指定输入计算输出数量

通过调用DipoleRouter合约的getAmountOut接口获取

上一步得到的reserves需要判断一下哪个是wlat，哪个是scgt

指定输出计算输入数量

通过调用DipoleRouter合约的getAmountIn接口获取

上一步得到的reserves需要判断一下哪个是wlat，哪个是scgt

Swap 价格影响计算逻辑

假设交易前输入代币t和输出代币的数量分别为a、b，手续费为0.0025x（不考虑多跳）

• 交易中输入代币和输出代币的数量分别为x和y，根据乘积恒定公式：

  $${{ \left( {a+0.9975x} \right) }{ \left( {b-y} \right) }=ab}$$
  得到
  $${y=\frac{{0.9975bx}}{{a+0.9975x}}}$$

• lat对另一代币在交易前的市场价和预估的交易价格分别是
  

  $$p1: {\frac{{b}}{{a}}}和 p2: {\frac{{y}}{{x}}}$$
  最终价格影响的计算方式是：
  $${\frac{{p1-p2}}{{p1}}-0.0025}={0.9975-\frac{{ay}}{{bx}}}={\frac{{0.9975^{2}x}}{{0.9975x+a}}}$$

调用示例

以指定输入为例，指定输出同理

数据准备

    const routerAddr = '0x714377e2443aAaF9e1Fcdf77358639c9E01f68E6'
    const factoryAddr = '0xF386b1DCc39cC40aa8f22c03FD6929F17021f6eE'
    const wlatAddr = '0xa0C63FAC4e5425F4721FF3258c3FA5B381152F73'
    const scgtAddr = '0x01cE844128ECa5e94fA9763f829f5A8ed8D3C956'
    const amount = '1000000000000000000'    // 1个（decimals为18）
    const deadline = '1652976000000'
    const to = '0x324b790ABbC496fFba372d7FBe6FA6eE68c5c675'
    const router = await DipoleRouter.at(routerAddr)
    const factory = await DipoleFactory.at(factoryAddr)
    const scgt = await MockBEP20.at(scgtAddr)

预估兑换数量

以输入LAT输出SCGT为例，反向同理

    async function getAmountOut() {
      // 获取交易对地址
      const pairAddress = await factory.getPair(wlatAddr, scgtAddr)
      const pair = await DipolePair.at(pairAddress)
      // 获取reserves
      const { _reserve0, _reserve1 } = await pair.getReserves()
      // 根据token地址排序确定哪个是wlat，哪个是scgt
      const [ wlatReserve, scgtReserve ] =              
        web3.utils.toBN(wlatAddr).lt(scgtAddr)
        ? [ _reserve0, _reserve1 ]
        : [ _reserve1, _reserve0 ]
      console.log('wlat reserve:', web3.utils.fromWei(wlatReserve).toString())
      console.log('scgt reserve:', web3.utils.fromWei(scgtReserve).toString())
      // 获取输出token数量
      const outputAmount = await router.getAmountOut(amount, wlatReserve, scgtReserve)
      console.log('output', web3.utils.fromWei(outputAmount).toString())
    }

输出

wlat reserve: 200
scgt reserve: 1500
output 7.444122439333822559

1个LAT转SCGT

    async function swaExactLATForSCGT() {
      const params = [
        0,
        [ wlatAddr, scgtAddr ],
        to,
        deadline
      ]
      // 估算调用swapExactETHForTokens接口所需gas
      const gas = await router.swapExactETHForTokens.estimateGas(...params, { value: amount }) 
      console.log('gas:', gas)
      params.push({
        value: amount,
        gas,
        gasPrice: '100000000000'
      })
      // 执行交易
      const result = await router.swapExactETHForTokens(...params)
      console.log(result)
    }

1个SCGT转LAT

输入token不是LAT时，需要先对输入token进行授权

    async function swapExactSCGTForLAT() {
      const params = [
        amount,
        0,
        [ scgtAddr, wlatAddr ],
        to,
        deadline
      ]
      // 授权
      await scgt.approve(router.address, amount)
      // 估算调用swapExactTokensForETH接口所需gas
      const gas = await router.swapExactTokensForETH.estimateGas(...params)
      console.log('gas:', gas)
      params.push({
        gas,
        gasPrice: '100000000000'
      })
      // 执行交易
      const result = await router.swapExactTokensForETH(...params)
      console.log(result)
    }

输出

gas: 147653
{
  tx: '0x2631b267686f501a38b8a45e20c7eb5e7f7477fa727dcd1ea30053bd0755e5a7',
  receipt: {
    blockHash: '0xd2f64dfc5e553a76c8ae724074b45d80ab896727c878254d4169d5d0c3c8ade3',
    blockNumber: 19997437,
    contractAddress: null,
    cumulativeGasUsed: 107389,
    from: '0x324b790ABbC496fFba372d7FBe6FA6eE68c5c675',
    gasUsed: 107389,
    logs: [],
    logsBloom: '0x00200000000000000000000080080000000000000000000000080000400800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000008000010200000000100400000000000000000000040000000000000000000000000000000000000000000040000000010000000000000000000000000000020000000000000000000000000080000004000000000020000000000000000000000000000000000200200000000000000000000000000000002000000000000000000000000000000200000001020000002000000001030000200000000000000000000000040000040000000800000000000000000',
    status: true,
    to: '0x4378dAF745E9053f6048c4f78c803f3bC8829703',
    transactionHash: '0x2631b267686f501a38b8a45e20c7eb5e7f7477fa727dcd1ea30053bd0755e5a7',
    transactionIndex: 0,
    rawLogs: [ [Object], [Object], [Object], [Object], [Object], [Object] ]
  },
  logs: []
}

其他注意事项

1. 为防止用户资金损失，根据滑点计算最小输出/最大输入，替换示例代码中swap方法参数里的0