DEX聚合器1inch对接教程【含源码】

1inch是一个链上去中心化交易所（DEX）聚合器，它可以在单一交易内按最优策略将兑换拆分到多个DEX上执行，从而获得最佳的兑换比率。1inch智能合约已经在Gihub开源，在这个教程中我们将学习如何通过1inch智能合约利用Uniswap/Banchor等多个交易实现ERC20代币的最佳兑换方案。

在这里插入图片描述

用自己熟悉的语言学习 以太坊DApp开发 ： Java | Php | Python | .Net / C# | Golang | Node.JS | Flutter / Dart

1、用1inch实现代币兑换的主要步骤

要利用1inch智能合约进行代币兑换很简单，主要步骤如下：

估算如何利用多DEX获得最大收益的兑换方案
授权1inch合约操作你的代币
利用第一步获得的兑换方案进行交易

首先让我们看一下1inch的智能合约，其中最重要的两个方法是：

getExpectedReturn() - 估算最优兑换方案
swap() - 执行多DEX兑换方案

2、getExpectedReturn - 估算最佳兑换方案

getExpectedReturn函数不会影响链上状态，不需要手续费，因此你可以根据自己的需要随意调用，只要节点在线就可以。

这个函数需要传入兑换参数，然后返回兑换的期望结果数据，其中包含了1inch将总的兑换数量如何分配到多个DEX上的分布描述。

1function getExpectedReturn(
2        IERC20 fromToken,
3        IERC20 toToken,
4        uint256 amount,
5        uint256 parts,
6        uint256 disableFlags
7) public view
8returns(
9         uint256 returnAmount,
10         uint256[] memory distribution
11);

getExpectedReturn()函数的5个参数说明如下：

fromToken：要卖出代币的地址
toToken：要买入代币的地址
amount：要卖出代币的数量
parts：卖出数量拆分成多少份进行最优分布的估算。默认值为100
disableFlags：标志位，用于调整1inch的算法，例如可设置是否禁用某个特定的DEX

getExpectedReturn()函数返回2个值：

returnAmount：执行兑换交易后将得到的买入代币的数量
distribution：兑换交易在各DEX上的分布数组，各成员和为parts参数指定的值。例如假设parts设置为100并且设置只使用Kyber和Uniswap，那么distribution可能看起来就是这样：[75, 25, 0, 0, …]。

目前1inch支持的交易所和排序（与distribution对应）如下：

1[
2    "Uniswap",
3    "Kyber",
4    "Bancor",
5    "Oasis",
6    "CurveCompound",
7    "CurveUsdt",
8    "CurveY",
9    "Binance",
10    "Synthetix",
11    "UniswapCompound",
12    "UniswapChai",
13    "UniswapAave"
14]

需要指出的是，如果你希望卖出ETH而不是ERC20代币，那么应当将fromToken参数设置为特殊的值：0x0 或 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE。

getExpectedReturn函数的返回值非常重要，因为接下来需要利用它来执行实际的链上兑换操作。

3、swap - 执行多DEX兑换交易

要执行链上代币兑换交易，就需要使用1inch合约提供的另一个函数swap。调用swap时，需要传入我们之前从getExpectedReturn返回的数据，并且承担必要的gas开销。如果要卖出的是ERC20代币，那么还需要先授权1inch合约可以操作你持有的待卖出代币。swap函数的定义如下：

1function swap(
2        IERC20 fromToken,
3        IERC20 toToken,
4        uint256 amount,
5        uint256 minReturn,
6        uint256[] memory distribution,
7        uint256 disableFlags
8 ) public payable;

swap函数的6个参数说明如下：

fromToken：待卖出代币的地址
toToken：待买入代币的地址
amount：待卖出代币的数量
minReturn：期望得到的待买入代币的最少数量，当实际交易结果低于该值时将回滚交易
distribution：兑换交易拆分分布数组，取自getExpectedReturn返回值
parts：执行估算时的拆分数量，同getExpectedReturn的参数
disableFlags：估算算法参数，同getExpectedReturn的参数

4、1inch实战开发环境搭建

为了进行下面的实战，我们需要一个方便的开发环境 —— 直接在主网进行操作需要花费真金白银，成本太高了。因此我们使用ganache-cli来分叉主链并解锁某个已经持有DAI代币的账号，例如 0x78bc49be7bae5e0eec08780c86f0e8278b8b035b。出于简化，我们也可以在开发过程中把gas上限设置的高一些，而不是在每个交易前估算gas成本。

下面的命令加载本地分叉链：

1ganache-cli  -f https://mainnet.infura.io/v3/[YOUR INFURA KEY] \
2             -d -i 66 \
3             --unlock 0x78bc49be7bae5e0eec08780c86f0e8278b8b035b \
4             -l 8000000

5、实战1inch - 估算最佳兑换方案

首先我们用web3.js来通过1inch估算1 ETH兑换为DAI的最佳方案。代码如下：

1var Web3 = require('web3');
2const BigNumber = require('bignumber.js');
3
4const oneSplitABI = require('./abis/onesplit.json');
5const onesplitAddress = "0xC586BeF4a0992C495Cf22e1aeEE4E446CECDee0E"; // 1plit contract address on Main net
6
7const fromToken = '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE'; // ETHEREUM
8const fromTokenDecimals = 18;
9
10const toToken = '0x6b175474e89094c44da98b954eedeac495271d0f'; // DAI Token
11const toTokenDecimals = 18;
12
13const amountToExchange = 1
14
15const web3 = new Web3('http://127.0.0.1:8545');
16
17const onesplitContract = new web3.eth.Contract(oneSplitABI, onesplitAddress);
18
19const oneSplitDexes = [
20    "Uniswap",
21    "Kyber",
22    "Bancor",
23    "Oasis",
24    "CurveCompound",
25    "CurveUsdt",
26    "CurveY",
27    "Binance",
28    "Synthetix",
29    "UniswapCompound",
30    "UniswapChai",
31    "UniswapAave"
32]
33
34
35onesplitContract.methods.getExpectedReturn(fromToken, toToken, new BigNumber(amountToExchange).shiftedBy(fromTokenDecimals).toString(), 100, 0).call({ from: '0x9759A6Ac90977b93B58547b4A71c78317f391A28' }, function (error, result) {
36    if (error) {
37        console.log(error)
38        return;
39    }
40    console.log("Trade From: " + fromToken)
41    console.log("Trade To: " + toToken);
42    console.log("Trade Amount: " + amountToExchange);
43    console.log(new BigNumber(result.returnAmount).shiftedBy(-fromTokenDecimals).toString());
44    console.log("Using Dexes:");
45    for (let index = 0; index < result.distribution.length; index++) {
46        console.log(oneSplitDexes[index] + ": " + result.distribution[index] + "%");
47    }
48});

第4行：加载ABI以便实例化web3.js和1inch合约实例

第19行：该数组指定要使用的DEX

第35行：调用getExpectedReturn函数获取兑换方案

如果你之前不太熟悉BigNumber.js这个库，可以查阅这篇文章。

上述代码执行后返回的结果类似下面这样：

在这里插入图片描述

也就是说，这时1inch给出的最佳兑换方案是通过Uniswap兑换96%，通过Bancor兑换4%，这样可以得到148.47 DAI，这样比单独通过Uniswap或Bancor进行兑换都划算。

6、实战1inch - 执行多DEX兑换方案

下面我们使用1inch聚合器将1000 DAI兑换为ETH。首先定义一些变量，例如合约地址、ABI等等。

1var Web3 = require('web3');
2const BigNumber = require('bignumber.js');
3
4const oneSplitABI = require('./abis/onesplit.json');
5const onesplitAddress = "0xC586BeF4a0992C495Cf22e1aeEE4E446CECDee0E"; // 1plit contract address on Main net
6
7const erc20ABI = require('./abis/erc20.json');
8const daiAddress = "0x6b175474e89094c44da98b954eedeac495271d0f"; // DAI ERC20 contract address on Main net
9
10const fromAddress = "0x4d10ae710Bd8D1C31bd7465c8CBC3add6F279E81";
11
12const fromToken = daiAddress;
13const fromTokenDecimals = 18;
14
15const toToken = '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE'; // ETH
16const toTokenDecimals = 18;
17
18const amountToExchange = new BigNumber(1000);
19
20const web3 = new Web3(new Web3.providers.HttpProvider('http://127.0.0.1:8545'));
21
22const onesplitContract = new web3.eth.Contract(oneSplitABI, onesplitAddress);
23const daiToken = new web3.eth.Contract(erc20ABI, fromToken);

同时写一个辅助函数来等待交易确认：

1function sleep(ms) {
2    return new Promise(resolve => setTimeout(resolve, ms));
3}
4
5async function waitTransaction(txHash) {
6    let tx = null;
7    while (tx == null) {
8        tx = await web3.eth.getTransactionReceipt(txHash);
9        await sleep(2000);
10    }
11    console.log("Transaction " + txHash + " was mined.");
12    return (tx.status);
13}

和前面类似，我们使用getExpectedReturn先估算兑换方案：

1async function getQuote(fromToken, toToken, amount, callback) {
2    let quote = null;
3    try {
4        quote = await onesplitContract.methods.getExpectedReturn(fromToken, toToken, amount, 100, 0).call();
5    } catch (error) {
6        console.log('Impossible to get the quote', error)
7    }
8    console.log("Trade From: " + fromToken)
9    console.log("Trade To: " + toToken);
10    console.log("Trade Amount: " + amountToExchange);
11    console.log(new BigNumber(quote.returnAmount).shiftedBy(-fromTokenDecimals).toString());
12    console.log("Using Dexes:");
13    for (let index = 0; index < quote.distribution.length; index++) {
14        console.log(oneSplitDexes[index] + ": " + quote.distribution[index] + "%");
15    }
16    callback(quote);
17}

接下来需要授权1inch可以操作我们持有的代币：

1function approveToken(tokenInstance, receiver, amount, callback) {
2    tokenInstance.methods.approve(receiver, amount).send({ from: fromAddress }, async function(error, txHash) {
3        if (error) {
4            console.log("ERC20 could not be approved", error);
5            return;
6        }
7        console.log("ERC20 token approved to " + receiver);
8        const status = await waitTransaction(txHash);
9        if (!status) {
10            console.log("Approval transaction failed.");
11            return;
12        }
13        callback();
14    })
15}

注意，授权额度可以远远高于当前实际需要的数量，这样后续就不再需要执行这个环节的操作了。

接下来就可以调用1inch聚合器的swap函数了。在下面的代码中，我们在调用swap函数执行交易后，使用前面编写的辅助函数waitTransaction来等待交易确认，并在交易确认后，显示转出账户的eth余额和dai余额：

1let amountWithDecimals = new BigNumber(amountToExchange).shiftedBy(fromTokenDecimals).toFixed()
2
3getQuote(fromToken, toToken, amountWithDecimals, function(quote) {
4    approveToken(daiToken, onesplitAddress, amountWithDecimals, async function() {
5        // We get the balance before the swap just for logging purpose
6        let ethBalanceBefore = await web3.eth.getBalance(fromAddress);
7        let daiBalanceBefore = await daiToken.methods.balanceOf(fromAddress).call();
8        onesplitContract.methods.swap(fromToken, toToken, amountWithDecimals, quote.returnAmount, quote.distribution, 0).send({ from: fromAddress, gas: 8000000 }, async function(error, txHash) {
9            if (error) {
10                console.log("Could not complete the swap", error);
11                return;
12            }
13            const status = await waitTransaction(txHash);
14            // We check the final balances after the swap for logging purpose
15            let ethBalanceAfter = await web3.eth.getBalance(fromAddress);
16            let daiBalanceAfter = await daiToken.methods.balanceOf(fromAddress).call();
17            console.log("Final balances:")
18            console.log("Change in ETH balance", new BigNumber(ethBalanceAfter).minus(ethBalanceBefore).shiftedBy(-fromTokenDecimals).toFixed(2));
19            console.log("Change in DAI balance", new BigNumber(daiBalanceAfter).minus(daiBalanceBefore).shiftedBy(-fromTokenDecimals).toFixed(2));
20        });
21    });
22});

最后的执行结果看起来类似下面这样：

在这里插入图片描述

正如你看到的，我们用1000 DAI换回来5.85 ETH。

7、1inch Dex聚合器使用小结

1inch提供了出色的链上DEX聚合实现，可以在一个交易内利用多个DEX实现最优的兑换策略。1inch的API使用也很简单，只需要用getExpectedReturn估算兑换方案，然后使用swap执行兑换方案，就可以得到最好的兑换结果。无论是钱包、套利机器人还是其他DApp，都可以利用1inch来快速实现ETH/ERC20的兑换并且得到最佳的收益。

原文链接：基于1inch的ERC20最优兑换实现 — 汇智网

DEX聚合器1inch对接教程【含源码】

1、用1inch实现代币兑换的主要步骤

2、getExpectedReturn - 估算最佳兑换方案

3、swap - 执行多DEX兑换交易

4、1inch实战开发环境搭建

5、实战1inch - 估算最佳兑换方案

6、实战1inch - 执行多DEX兑换方案

7、1inch Dex聚合器使用小结

评论区

相关推荐