@curvefi/api 1.22.0 → 1.23.0

package/README.md

@@ -494,7 +494,66 @@ import curve from "@curvefi/api";
 })()
 ```
 
-## Exchange using all pools
+## Exchange
+
+### Router exchange
+
+```ts
+import curve from "@curvefi/api";
+
+(async () => {
+    await curve.init('JsonRpc', {}, { gasPrice: 0, chainId: 1 });
+
+    console.log(await curve.getBalances(['DAI', 'CRV']));
+    // [ '9900.0', '100049.744832225238317557' ]
+
+    const { route, output } = await curve.getBestRouteAndOutput('DAI', 'CRV', '1000');
+    // OR await curve.getBestPoolAndOutput('0x6B175474E89094C44Da98b954EedeAC495271d0F', '0xD533a949740bb3306d119CC777fa900bA034cd52', '10000');
+    const expected = await curve.routerExchangeExpected('DAI', 'CRV', '1000');
+    // OR await curve.exchangeExpected('0x6B175474E89094C44Da98b954EedeAC495271d0F', '0xD533a949740bb3306d119CC777fa900bA034cd52', '10000');
+
+    console.log(route, output, expected);
+    // route = [
+    //     {
+    //         poolId: '3pool',
+    //         poolAddress: '0xbEbc44782C7dB0a1A60Cb6fe97d0b483032FF1C7',
+    //         outputCoinAddress: '0xdac17f958d2ee523a2206206994597c13d831ec7',
+    //         i: 0,
+    //         j: 2,
+    //         swapType: 1,
+    //         swapAddress: '0x0000000000000000000000000000000000000000'
+    //     },
+    //     {
+    //         poolId: 'tricrypto2',
+    //         poolAddress: '0xD51a44d3FaE010294C616388b506AcdA1bfAAE46',
+    //         outputCoinAddress: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
+    //         i: 0,
+    //         j: 2,
+    //         swapType: 3,
+    //         swapAddress: '0x0000000000000000000000000000000000000000'
+    //     },
+    //     {
+    //         poolId: 'crveth',
+    //         poolAddress: '0x8301AE4fc9c624d1D396cbDAa1ed877821D7C511',
+    //         outputCoinAddress: '0xd533a949740bb3306d119cc777fa900ba034cd52',
+    //         i: 0,
+    //         j: 1,
+    //         swapType: 3,
+    //         swapAddress: '0x0000000000000000000000000000000000000000'
+    //     }
+    // ]
+    // 
+    // output = expected = 378.881631202862354937
+
+    await curve.routerExchange('DAI', 'CRV', '1000')
+    // OR await curve.exchange('0x6B175474E89094C44Da98b954EedeAC495271d0F', '0xD533a949740bb3306d119CC777fa900bA034cd52', '10000');
+
+    console.log(await curve.getBalances(['DAI', 'CRV']));
+    // [ '8900.0', '100428.626463428100672494' ]
+})()
+```
+
+### Single-pool exchange
 
 ```ts
 import curve from "@curvefi/api";
@@ -521,7 +580,7 @@ import curve from "@curvefi/api";
 })()
 ```
 
-## Cross-Asset Exchange
+### Cross-Asset Exchange
 
 ```ts
 import curve from "@curvefi/api";

package/lib/index.d.ts

@@ -58,12 +58,22 @@ declare const curve: {
     crossAssetExchangeApprove: (inputCoin: string, amount: string) => Promise<string[]>;
     crossAssetExchange: (inputCoin: string, outputCoin: string, amount: string, maxSlippage?: number) => Promise<string>;
     getUserPoolList: (address?: string | undefined) => Promise<string[]>;
+    getBestRouteAndOutput: (inputCoin: string, outputCoin: string, amount: string) => Promise<{
+        route: import("./interfaces").IRouteStep[];
+        output: string;
+    }>;
+    routerExchangeExpected: (inputCoin: string, outputCoin: string, amount: string) => Promise<string>;
+    routerExchangeIsApproved: (inputCoin: string, amount: string) => Promise<boolean>;
+    routerExchangeApprove: (inputCoin: string, amount: string) => Promise<string[]>;
+    routerExchange: (inputCoin: string, outputCoin: string, amount: string, maxSlippage?: number) => Promise<string>;
     estimateGas: {
         ensureAllowance: (coins: string[], amounts: string[], spender: string) => Promise<number>;
         exchangeApprove: (inputCoin: string, outputCoin: string, amount: string) => Promise<number>;
         exchange: (inputCoin: string, outputCoin: string, amount: string, maxSlippage?: number) => Promise<number>;
         crossAssetExchangeApprove: (inputCoin: string, amount: string) => Promise<number>;
         crossAssetExchange: (inputCoin: string, outputCoin: string, amount: string, maxSlippage?: number) => Promise<number>;
+        routerExchangeApprove: (inputCoin: string, amount: string) => Promise<number>;
+        routerExchange: (inputCoin: string, outputCoin: string, amount: string, maxSlippage?: number) => Promise<number>;
     };
     boosting: {
         getCrv: (...addresses: string[] | string[][]) => Promise<string | import("./interfaces").DictInterface<string>>;

package/lib/index.js

@@ -115,12 +115,19 @@ var curve = {
     crossAssetExchangeApprove: pools_1.crossAssetExchangeApprove,
     crossAssetExchange: pools_1.crossAssetExchange,
     getUserPoolList: pools_1.getUserPoolList,
+    getBestRouteAndOutput: pools_1.getBestRouteAndOutput,
+    routerExchangeExpected: pools_1.routerExchangeExpected,
+    routerExchangeIsApproved: pools_1.routerExchangeIsApproved,
+    routerExchangeApprove: pools_1.routerExchangeApprove,
+    routerExchange: pools_1.routerExchange,
     estimateGas: {
         ensureAllowance: utils_1.ensureAllowanceEstimateGas,
         exchangeApprove: pools_1.exchangeApproveEstimateGas,
         exchange: pools_1.exchangeEstimateGas,
         crossAssetExchangeApprove: pools_1.crossAssetExchangeApproveEstimateGas,
         crossAssetExchange: pools_1.crossAssetExchangeEstimateGas,
+        routerExchangeApprove: pools_1.routerExchangeApproveEstimateGas,
+        routerExchange: pools_1.routerExchangeEstimateGas,
     },
     boosting: {
         getCrv: boosting_1.getCrv,

package/lib/interfaces.d.ts

@@ -134,9 +134,24 @@ export interface ISinglePoolSwapData {
     poolAddress: string;
     i: number;
     j: number;
-    swapType: 1 | 2 | 3 | 4;
+    swapType: 1 | 2 | 3 | 4 | 5;
     swapAddress: string;
 }
 export interface ISinglePoolSwapDataAndOutput extends ISinglePoolSwapData {
     _output: ethers.BigNumber;
 }
+export interface IRouteStep {
+    poolId: string;
+    poolAddress: string;
+    outputCoinAddress: string;
+    i: number;
+    j: number;
+    swapType: 1 | 2 | 3 | 4 | 5;
+    swapAddress: string;
+}
+export interface IRoute {
+    steps: IRouteStep[];
+    _output: ethers.BigNumber;
+    outputUsd: number;
+    txCostUsd: number;
+}

package/lib/pools.d.ts

@@ -1,6 +1,6 @@
 import { ethers } from "ethers";
 import BigNumber from 'bignumber.js';
-import { DictInterface, RewardsApyInterface } from './interfaces';
+import { DictInterface, IRouteStep, RewardsApyInterface } from './interfaces';
 export declare class Pool {
     id: string;
     name: string;
@@ -254,3 +254,14 @@ export declare const crossAssetExchangeApprove: (inputCoin: string, amount: stri
 export declare const crossAssetExchangeEstimateGas: (inputCoin: string, outputCoin: string, amount: string, maxSlippage?: number) => Promise<number>;
 export declare const crossAssetExchange: (inputCoin: string, outputCoin: string, amount: string, maxSlippage?: number) => Promise<string>;
 export declare const getUserPoolList: (address?: string | undefined) => Promise<string[]>;
+export declare const _findAllRoutes: (inputCoinAddress: string, outputCoinAddress: string) => Promise<IRouteStep[][]>;
+export declare const getBestRouteAndOutput: (inputCoin: string, outputCoin: string, amount: string) => Promise<{
+    route: IRouteStep[];
+    output: string;
+}>;
+export declare const routerExchangeExpected: (inputCoin: string, outputCoin: string, amount: string) => Promise<string>;
+export declare const routerExchangeIsApproved: (inputCoin: string, amount: string) => Promise<boolean>;
+export declare const routerExchangeApproveEstimateGas: (inputCoin: string, amount: string) => Promise<number>;
+export declare const routerExchangeApprove: (inputCoin: string, amount: string) => Promise<string[]>;
+export declare const routerExchangeEstimateGas: (inputCoin: string, outputCoin: string, amount: string, maxSlippage?: number) => Promise<number>;
+export declare const routerExchange: (inputCoin: string, outputCoin: string, amount: string, maxSlippage?: number) => Promise<string>;

package/lib/pools.js

@@ -59,9 +59,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getUserPoolList = exports.crossAssetExchange = exports.crossAssetExchangeEstimateGas = exports.crossAssetExchangeApprove = exports.crossAssetExchangeApproveEstimateGas = exports.crossAssetExchangeIsApproved = exports.crossAssetExchangeExpected = exports.crossAssetExchangeOutputAndSlippage = exports._crossAssetExchangeInfo = exports._getSmallAmountForCoin = exports.crossAssetExchangeAvailable = exports.exchange = exports.exchangeEstimateGas = exports.exchangeApprove = exports.exchangeApproveEstimateGas = exports.exchangeIsApproved = exports.exchangeExpected = exports.getBestPoolAndOutput = exports.Pool = void 0;
+exports.routerExchange = exports.routerExchangeEstimateGas = exports.routerExchangeApprove = exports.routerExchangeApproveEstimateGas = exports.routerExchangeIsApproved = exports.routerExchangeExpected = exports.getBestRouteAndOutput = exports._findAllRoutes = exports.getUserPoolList = exports.crossAssetExchange = exports.crossAssetExchangeEstimateGas = exports.crossAssetExchangeApprove = exports.crossAssetExchangeApproveEstimateGas = exports.crossAssetExchangeIsApproved = exports.crossAssetExchangeExpected = exports.crossAssetExchangeOutputAndSlippage = exports._crossAssetExchangeInfo = exports._getSmallAmountForCoin = exports.crossAssetExchangeAvailable = exports.exchange = exports.exchangeEstimateGas = exports.exchangeApprove = exports.exchangeApproveEstimateGas = exports.exchangeIsApproved = exports.exchangeExpected = exports.getBestPoolAndOutput = exports.Pool = void 0;
 var axios_1 = __importDefault(require("axios"));
 var ethers_1 = require("ethers");
+var memoizee_1 = __importDefault(require("memoizee"));
 var external_api_1 = require("./external-api");
 var utils_1 = require("./utils");
 var curve_1 = require("./curve");
@@ -4180,3 +4181,506 @@ var getUserPoolList = function (address) { return __awaiter(void 0, void 0, void
     });
 }); };
 exports.getUserPoolList = getUserPoolList;
+// --------- Multi-Pool Exchange ---------
+var IMBALANCED_POOLS = [];
+// Inspired by Dijkstra's algorithm
+var _findAllRoutes = function (inputCoinAddress, outputCoinAddress) { return __awaiter(void 0, void 0, void 0, function () {
+    var ALL_POOLS, markedCoins, curCoins, nextCoins, routes, step, _i, curCoins_1, inCoin, _a, ALL_POOLS_1, _c, poolId, poolData, coin_addresses, underlying_coin_addresses, meta_coin_addresses, inCoinIndexes, j, tvl, _d, swapType, _e, _f, inCoinRoute, poolAddress, j, tvl, _h, swapType, _j, _k, inCoinRoute, j, tvl, _l, swapType, _m, _o, inCoinRoute, tvl, _p, swapType, _q, _r, inCoinRoute;
+    var _s;
+    var _t, _u, _v, _w, _x, _y;
+    return __generator(this, function (_z) {
+        switch (_z.label) {
+            case 0:
+                inputCoinAddress = inputCoinAddress.toLowerCase();
+                outputCoinAddress = outputCoinAddress.toLowerCase();
+                ALL_POOLS = Object.entries(__assign(__assign(__assign({}, curve_1.POOLS_DATA), curve_1.curve.constants.FACTORY_POOLS_DATA), curve_1.curve.constants.CRYPTO_FACTORY_POOLS_DATA));
+                markedCoins = [];
+                curCoins = [inputCoinAddress];
+                nextCoins = new Set();
+                routes = (_s = {},
+                    _s[inputCoinAddress] = [[]],
+                    _s);
+                step = 0;
+                _z.label = 1;
+            case 1:
+                if (!(step < 4)) return [3 /*break*/, 21];
+                _i = 0, curCoins_1 = curCoins;
+                _z.label = 2;
+            case 2:
+                if (!(_i < curCoins_1.length)) return [3 /*break*/, 19];
+                inCoin = curCoins_1[_i];
+                _a = 0, ALL_POOLS_1 = ALL_POOLS;
+                _z.label = 3;
+            case 3:
+                if (!(_a < ALL_POOLS_1.length)) return [3 /*break*/, 18];
+                _c = ALL_POOLS_1[_a], poolId = _c[0], poolData = _c[1];
+                coin_addresses = poolData.coin_addresses.map(function (a) { return a.toLowerCase(); });
+                underlying_coin_addresses = poolData.underlying_coin_addresses.map(function (a) { return a.toLowerCase(); });
+                meta_coin_addresses = ((_t = poolData.meta_coin_addresses) === null || _t === void 0 ? void 0 : _t.map(function (a) { return a.toLowerCase(); })) || [];
+                inCoinIndexes = {
+                    coin: coin_addresses.indexOf(inCoin),
+                    underlying_coin: underlying_coin_addresses.indexOf(inCoin),
+                    meta_coin: meta_coin_addresses ? meta_coin_addresses.indexOf(inCoin) : -1,
+                };
+                // No input coin in this pool --> slip
+                if (inCoinIndexes.coin === -1 && inCoinIndexes.underlying_coin === -1 && inCoinIndexes.meta_coin === -1)
+                    return [3 /*break*/, 17];
+                if (!(inCoinIndexes.coin >= 0 && poolId !== "atricrypto3")) return [3 /*break*/, 7];
+                j = 0;
+                _z.label = 4;
+            case 4:
+                if (!(j < coin_addresses.length)) return [3 /*break*/, 7];
+                // If this coin already marked or will be marked on the current step, no need to consider it on the next step
+                if (markedCoins.includes(coin_addresses[j]) || curCoins.includes(coin_addresses[j]))
+                    return [3 /*break*/, 6];
+                // Looking for outputCoinAddress only on the final step
+                if (step === 3 && coin_addresses[j] !== outputCoinAddress)
+                    return [3 /*break*/, 6];
+                _d = Number;
+                return [4 /*yield*/, (new Pool(poolId)).stats.getTotalLiquidity()];
+            case 5:
+                tvl = _d.apply(void 0, [_z.sent()]);
+                if (tvl === 0)
+                    return [3 /*break*/, 6];
+                // Skip imbalanced pools
+                if (IMBALANCED_POOLS.includes(poolId))
+                    return [3 /*break*/, 6];
+                swapType = poolData.is_crypto ? 3 : 1;
+                for (_e = 0, _f = routes[inCoin]; _e < _f.length; _e++) {
+                    inCoinRoute = _f[_e];
+                    routes[coin_addresses[j]] = ((_u = routes[coin_addresses[j]]) !== null && _u !== void 0 ? _u : []).concat([__spreadArray(__spreadArray([], inCoinRoute, true), [
+                            {
+                                poolId: poolId,
+                                poolAddress: poolData.swap_address,
+                                outputCoinAddress: coin_addresses[j],
+                                i: inCoinIndexes.coin,
+                                j: j,
+                                swapType: swapType,
+                                swapAddress: ethers_1.ethers.constants.AddressZero,
+                            },
+                        ], false)]);
+                }
+                nextCoins.add(coin_addresses[j]);
+                _z.label = 6;
+            case 6:
+                j++;
+                return [3 /*break*/, 4];
+            case 7:
+                poolAddress = ["eurtusd", "xautusd", "atricrypto3"].includes(poolId) ||
+                    (curve_1.curve.chainId === 137 && poolData.is_factory) ? poolData.deposit_address : poolData.swap_address;
+                if (!(coin_addresses.join("|") !== underlying_coin_addresses.join("|") && inCoinIndexes.underlying_coin >= 0)) return [3 /*break*/, 11];
+                j = 0;
+                _z.label = 8;
+            case 8:
+                if (!(j < underlying_coin_addresses.length)) return [3 /*break*/, 11];
+                if (poolId === "atricrypto3" && inCoinIndexes.meta_coin >= 0 && meta_coin_addresses.includes(underlying_coin_addresses[j]))
+                    return [3 /*break*/, 10];
+                // If this coin already marked or will be marked on the current step, no need to consider it on the next step
+                if (markedCoins.includes(underlying_coin_addresses[j]) || curCoins.includes(underlying_coin_addresses[j]))
+                    return [3 /*break*/, 10];
+                // Looking for outputCoinAddress only on the final step
+                if (step === 3 && underlying_coin_addresses[j] !== outputCoinAddress)
+                    return [3 /*break*/, 10];
+                _h = Number;
+                return [4 /*yield*/, (new Pool(poolId)).stats.getTotalLiquidity()];
+            case 9:
+                tvl = _h.apply(void 0, [_z.sent()]);
+                if (tvl === 0)
+                    return [3 /*break*/, 10];
+                // Skip imbalanced pools
+                if (IMBALANCED_POOLS.includes(poolId))
+                    return [3 /*break*/, 10];
+                swapType = poolData.is_crypto && (poolData.is_fake || poolData.is_meta) ? 4 : poolData.is_crypto ? 3 : 2;
+                for (_j = 0, _k = routes[inCoin]; _j < _k.length; _j++) {
+                    inCoinRoute = _k[_j];
+                    routes[underlying_coin_addresses[j]] = ((_v = routes[underlying_coin_addresses[j]]) !== null && _v !== void 0 ? _v : []).concat([__spreadArray(__spreadArray([], inCoinRoute, true), [
+                            {
+                                poolId: poolId,
+                                poolAddress: poolAddress,
+                                outputCoinAddress: underlying_coin_addresses[j],
+                                i: inCoinIndexes.underlying_coin,
+                                j: j,
+                                swapType: swapType,
+                                swapAddress: ethers_1.ethers.constants.AddressZero,
+                            },
+                        ], false)]);
+                }
+                nextCoins.add(underlying_coin_addresses[j]);
+                _z.label = 10;
+            case 10:
+                j++;
+                return [3 /*break*/, 8];
+            case 11:
+                if (!(inCoinIndexes.coin === 0 && meta_coin_addresses.length > 0 && poolId !== "atricrypto3")) return [3 /*break*/, 15];
+                j = 0;
+                _z.label = 12;
+            case 12:
+                if (!(j < meta_coin_addresses.length)) return [3 /*break*/, 15];
+                // If this coin already marked or will be marked on the current step, no need to consider it on the next step
+                if (markedCoins.includes(meta_coin_addresses[j]) || curCoins.includes(meta_coin_addresses[j]))
+                    return [3 /*break*/, 14];
+                // Looking for outputCoinAddress only on the final step
+                if (step === 3 && meta_coin_addresses[j] !== outputCoinAddress)
+                    return [3 /*break*/, 14];
+                _l = Number;
+                return [4 /*yield*/, (new Pool(poolId)).stats.getTotalLiquidity()];
+            case 13:
+                tvl = _l.apply(void 0, [_z.sent()]);
+                if (tvl === 0)
+                    return [3 /*break*/, 14];
+                // Skip imbalanced pools
+                if (IMBALANCED_POOLS.includes(poolId))
+                    return [3 /*break*/, 14];
+                swapType = (curve_1.curve.chainId === 137 && poolData.is_factory) ? 5 : poolData.is_crypto ? 4 : 2;
+                for (_m = 0, _o = routes[inCoin]; _m < _o.length; _m++) {
+                    inCoinRoute = _o[_m];
+                    routes[meta_coin_addresses[j]] = ((_w = routes[meta_coin_addresses[j]]) !== null && _w !== void 0 ? _w : []).concat([__spreadArray(__spreadArray([], inCoinRoute, true), [
+                            {
+                                poolId: poolId,
+                                poolAddress: poolAddress,
+                                outputCoinAddress: meta_coin_addresses[j],
+                                i: inCoinIndexes.coin,
+                                j: j + 1,
+                                swapType: swapType,
+                                swapAddress: swapType === 5 ? poolData.swap_address : ethers_1.ethers.constants.AddressZero,
+                            },
+                        ], false)]);
+                }
+                nextCoins.add(meta_coin_addresses[j]);
+                _z.label = 14;
+            case 14:
+                j++;
+                return [3 /*break*/, 12];
+            case 15:
+                if (!(inCoinIndexes.meta_coin >= 0 && poolId !== "atricrypto3")) return [3 /*break*/, 17];
+                // If this coin already marked or will be marked on the current step, no need to consider it on the next step
+                if (markedCoins.includes(coin_addresses[0]) || curCoins.includes(coin_addresses[0]))
+                    return [3 /*break*/, 17];
+                // Looking for outputCoinAddress only on the final step
+                if (step === 3 && coin_addresses[0] !== outputCoinAddress)
+                    return [3 /*break*/, 17];
+                _p = Number;
+                return [4 /*yield*/, (new Pool(poolId)).stats.getTotalLiquidity()];
+            case 16:
+                tvl = _p.apply(void 0, [_z.sent()]);
+                if (tvl === 0)
+                    return [3 /*break*/, 17];
+                // Skip imbalanced pools
+                if (IMBALANCED_POOLS.includes(poolId))
+                    return [3 /*break*/, 17];
+                swapType = (curve_1.curve.chainId === 137 && poolData.is_factory) ? 5 : poolData.is_crypto ? 4 : 2;
+                for (_q = 0, _r = routes[inCoin]; _q < _r.length; _q++) {
+                    inCoinRoute = _r[_q];
+                    routes[coin_addresses[0]] = ((_x = routes[coin_addresses[0]]) !== null && _x !== void 0 ? _x : []).concat([__spreadArray(__spreadArray([], inCoinRoute, true), [
+                            {
+                                poolId: poolId,
+                                poolAddress: poolAddress,
+                                outputCoinAddress: coin_addresses[0],
+                                i: inCoinIndexes.meta_coin + 1,
+                                j: 0,
+                                swapType: swapType,
+                                swapAddress: swapType === 5 ? poolData.swap_address : ethers_1.ethers.constants.AddressZero,
+                            },
+                        ], false)]);
+                    nextCoins.add(coin_addresses[0]);
+                }
+                _z.label = 17;
+            case 17:
+                _a++;
+                return [3 /*break*/, 3];
+            case 18:
+                _i++;
+                return [3 /*break*/, 2];
+            case 19:
+                // If target output coin is reached, search is finished. Assumption: the shorter route, the better.
+                if (outputCoinAddress in routes)
+                    return [3 /*break*/, 21];
+                markedCoins.push.apply(markedCoins, curCoins);
+                curCoins = Array.from(nextCoins);
+                nextCoins = new Set();
+                _z.label = 20;
+            case 20:
+                step++;
+                return [3 /*break*/, 1];
+            case 21: return [2 /*return*/, (_y = routes[outputCoinAddress]) !== null && _y !== void 0 ? _y : []];
+        }
+    });
+}); };
+exports._findAllRoutes = _findAllRoutes;
+var _getRouteKey = function (route, inputCoinAddress, outputCoinAddress) {
+    var sortedCoins = [inputCoinAddress, outputCoinAddress].sort();
+    var key = "".concat(sortedCoins[0], "-->");
+    for (var _i = 0, _a = route.steps; _i < _a.length; _i++) {
+        var routeStep = _a[_i];
+        key += "".concat(routeStep.poolId, "-->");
+    }
+    key += sortedCoins[1];
+    return key;
+};
+var _getExchangeMultipleArgs = function (inputCoinAddress, route) {
+    var _route = [inputCoinAddress];
+    var _swapParams = [];
+    var _factorySwapAddresses = [];
+    for (var _i = 0, _a = route.steps; _i < _a.length; _i++) {
+        var routeStep = _a[_i];
+        _route.push(routeStep.poolAddress, routeStep.outputCoinAddress);
+        _swapParams.push([routeStep.i, routeStep.j, routeStep.swapType]);
+        _factorySwapAddresses.push(routeStep.swapAddress);
+    }
+    _route = _route.concat(Array(9 - _route.length).fill(ethers_1.ethers.constants.AddressZero));
+    _swapParams = _swapParams.concat(Array(4 - _swapParams.length).fill([0, 0, 0]));
+    _factorySwapAddresses = _factorySwapAddresses.concat(Array(4 - _factorySwapAddresses.length).fill(ethers_1.ethers.constants.AddressZero));
+    return { _route: _route, _swapParams: _swapParams, _factorySwapAddresses: _factorySwapAddresses };
+};
+var _estimatedGasForDifferentRoutesCache = {};
+var _estimateGasForDifferentRoutes = function (routes, inputCoinAddress, outputCoinAddress, _amount) { return __awaiter(void 0, void 0, void 0, function () {
+    var registryExchangeContract, gasPromises, _i, routes_1, route, routeKey, gasPromise, _a, _route, _swapParams, _factorySwapAddresses, _gasAmounts_2, err_3;
+    var _c;
+    return __generator(this, function (_d) {
+        switch (_d.label) {
+            case 0:
+                inputCoinAddress = inputCoinAddress.toLowerCase();
+                outputCoinAddress = outputCoinAddress.toLowerCase();
+                registryExchangeContract = curve_1.curve.contracts[curve_1.ALIASES.registry_exchange].contract;
+                gasPromises = [];
+                for (_i = 0, routes_1 = routes; _i < routes_1.length; _i++) {
+                    route = routes_1[_i];
+                    routeKey = _getRouteKey(route, inputCoinAddress, outputCoinAddress);
+                    gasPromise = void 0;
+                    _a = _getExchangeMultipleArgs(inputCoinAddress, route), _route = _a._route, _swapParams = _a._swapParams, _factorySwapAddresses = _a._factorySwapAddresses;
+                    if ((((_c = _estimatedGasForDifferentRoutesCache[routeKey]) === null || _c === void 0 ? void 0 : _c.time) || 0) + 3600000 < Date.now()) {
+                        gasPromise = registryExchangeContract.estimateGas.exchange_multiple(_route, _swapParams, _amount, 0, _factorySwapAddresses, curve_1.curve.constantOptions);
+                    }
+                    else {
+                        gasPromise = Promise.resolve(_estimatedGasForDifferentRoutesCache[routeKey].gas);
+                    }
+                    gasPromises.push(gasPromise);
+                }
+                _d.label = 1;
+            case 1:
+                _d.trys.push([1, 3, , 4]);
+                return [4 /*yield*/, Promise.all(gasPromises)];
+            case 2:
+                _gasAmounts_2 = _d.sent();
+                routes.forEach(function (route, i) {
+                    var routeKey = _getRouteKey(route, inputCoinAddress, outputCoinAddress);
+                    _estimatedGasForDifferentRoutesCache[routeKey] = { 'gas': _gasAmounts_2[i], 'time': Date.now() };
+                });
+                return [2 /*return*/, _gasAmounts_2.map(function (_g) { return Number(ethers_1.ethers.utils.formatUnits(_g, 0)); })];
+            case 3:
+                err_3 = _d.sent();
+                return [2 /*return*/, routes.map(function () { return 0; })];
+            case 4: return [2 /*return*/];
+        }
+    });
+}); };
+var _getBestRouteAndOutput = (0, memoizee_1.default)(function (inputCoinAddress, outputCoinAddress, amount) { return __awaiter(void 0, void 0, void 0, function () {
+    var _a, inputCoinDecimals, outputCoinDecimals, _amount, routesRaw, routes, _i, routesRaw_1, route, _outputAmount, _c, _d, routeStep, poolId, poolAddress, i, j, swapType, swapAddress, contract, _e, err_4, _f, gasAmounts, outputCoinUsdRate, gasData, ethUsdRate, gasPrice, expectedAmounts, expectedAmountsUsd, txCostsUsd;
+    return __generator(this, function (_h) {
+        switch (_h.label) {
+            case 0:
+                _a = (0, utils_1._getCoinDecimals)(inputCoinAddress, outputCoinAddress), inputCoinDecimals = _a[0], outputCoinDecimals = _a[1];
+                _amount = ethers_1.ethers.utils.parseUnits(amount.toString(), inputCoinDecimals);
+                return [4 /*yield*/, (0, exports._findAllRoutes)(inputCoinAddress, outputCoinAddress)];
+            case 1:
+                routesRaw = (_h.sent()).map(function (steps) { return ({ steps: steps, _output: ethers_1.ethers.BigNumber.from(0), outputUsd: 0, txCostUsd: 0 }); });
+                routes = [];
+                _i = 0, routesRaw_1 = routesRaw;
+                _h.label = 2;
+            case 2:
+                if (!(_i < routesRaw_1.length)) return [3 /*break*/, 13];
+                route = routesRaw_1[_i];
+                // If one of pools in the route is imbalanced
+                if (route.steps.reduce(function (acc, step) { return acc || IMBALANCED_POOLS.includes(step.poolId); }, false))
+                    return [3 /*break*/, 12];
+                _outputAmount = _amount;
+                _c = 0, _d = route.steps;
+                _h.label = 3;
+            case 3:
+                if (!(_c < _d.length)) return [3 /*break*/, 11];
+                routeStep = _d[_c];
+                poolId = routeStep.poolId, poolAddress = routeStep.poolAddress, i = routeStep.i, j = routeStep.j, swapType = routeStep.swapType, swapAddress = routeStep.swapAddress;
+                contract = curve_1.curve.contracts[swapAddress === ethers_1.ethers.constants.AddressZero ? poolAddress : swapAddress].contract;
+                _h.label = 4;
+            case 4:
+                _h.trys.push([4, 9, , 10]);
+                if (![2, 4, 5].includes(swapType)) return [3 /*break*/, 6];
+                return [4 /*yield*/, contract.get_dy_underlying(i, j, _outputAmount, curve_1.curve.constantOptions)];
+            case 5:
+                _e = _h.sent();
+                return [3 /*break*/, 8];
+            case 6: return [4 /*yield*/, contract.get_dy(i, j, _outputAmount, curve_1.curve.constantOptions)];
+            case 7:
+                _e = _h.sent();
+                _h.label = 8;
+            case 8:
+                _outputAmount = _e;
+                return [3 /*break*/, 10];
+            case 9:
+                err_4 = _h.sent();
+                console.log("Pool ".concat(poolId, " is empty or very imbalanced"));
+                IMBALANCED_POOLS.push(poolId);
+                return [3 /*break*/, 12];
+            case 10:
+                _c++;
+                return [3 /*break*/, 3];
+            case 11:
+                route._output = _outputAmount;
+                routes.push(route);
+                _h.label = 12;
+            case 12:
+                _i++;
+                return [3 /*break*/, 2];
+            case 13:
+                if (routes.length === 0) {
+                    return [2 /*return*/, {
+                            steps: [],
+                            _output: ethers_1.ethers.BigNumber.from(0),
+                            outputUsd: 0,
+                            txCostUsd: 0,
+                        }];
+                }
+                if (routes.length === 1)
+                    return [2 /*return*/, routes[0]];
+                return [4 /*yield*/, Promise.all([
+                        _estimateGasForDifferentRoutes(routes, inputCoinAddress, outputCoinAddress, _amount),
+                        (0, utils_1._getUsdRate)(outputCoinAddress),
+                        axios_1.default.get("https://api.curve.fi/api/getGas"),
+                        (0, utils_1._getUsdRate)(curve_1.curve.chainId === 137 ? curve_1.COINS.matic : curve_1.COINS.eth),
+                    ])];
+            case 14:
+                _f = _h.sent(), gasAmounts = _f[0], outputCoinUsdRate = _f[1], gasData = _f[2], ethUsdRate = _f[3];
+                gasPrice = gasData.data.data.gas.standard;
+                expectedAmounts = (routes).map(function (route) { return Number(ethers_1.ethers.utils.formatUnits(route._output, outputCoinDecimals)); });
+                expectedAmountsUsd = expectedAmounts.map(function (a) { return a * outputCoinUsdRate; });
+                txCostsUsd = gasAmounts.map(function (a) { return ethUsdRate * a * gasPrice / 1e18; });
+                routes.forEach(function (route, i) {
+                    route.outputUsd = expectedAmountsUsd[i];
+                    route.txCostUsd = txCostsUsd[i];
+                });
+                return [2 /*return*/, routes.reduce(function (route1, route2) { return (route1.outputUsd - route1.txCostUsd) - (route2.outputUsd - route2.txCostUsd) >= 0 ? route1 : route2; })];
+        }
+    });
+}); }, {
+    promise: true,
+    maxAge: 5 * 60 * 1000, // 5m
+});
+var getBestRouteAndOutput = function (inputCoin, outputCoin, amount) { return __awaiter(void 0, void 0, void 0, function () {
+    var _a, inputCoinAddress, outputCoinAddress, outputCoinDecimals, _c, steps, _output;
+    return __generator(this, function (_d) {
+        switch (_d.label) {
+            case 0:
+                _a = (0, utils_1._getCoinAddresses)(inputCoin, outputCoin), inputCoinAddress = _a[0], outputCoinAddress = _a[1];
+                outputCoinDecimals = (0, utils_1._getCoinDecimals)(outputCoinAddress)[0];
+                return [4 /*yield*/, _getBestRouteAndOutput(inputCoinAddress, outputCoinAddress, amount)];
+            case 1:
+                _c = _d.sent(), steps = _c.steps, _output = _c._output;
+                return [2 /*return*/, { route: steps, output: ethers_1.ethers.utils.formatUnits(_output, outputCoinDecimals) }];
+        }
+    });
+}); };
+exports.getBestRouteAndOutput = getBestRouteAndOutput;
+var routerExchangeExpected = function (inputCoin, outputCoin, amount) { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, (0, exports.getBestRouteAndOutput)(inputCoin, outputCoin, amount)];
+            case 1: return [2 /*return*/, (_a.sent())['output']];
+        }
+    });
+}); };
+exports.routerExchangeExpected = routerExchangeExpected;
+var routerExchangeIsApproved = function (inputCoin, amount) { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, (0, utils_1.hasAllowance)([inputCoin], [amount], curve_1.curve.signerAddress, curve_1.ALIASES.registry_exchange)];
+            case 1: return [2 /*return*/, _a.sent()];
+        }
+    });
+}); };
+exports.routerExchangeIsApproved = routerExchangeIsApproved;
+var routerExchangeApproveEstimateGas = function (inputCoin, amount) { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, (0, utils_1.ensureAllowanceEstimateGas)([inputCoin], [amount], curve_1.ALIASES.registry_exchange)];
+            case 1: return [2 /*return*/, _a.sent()];
+        }
+    });
+}); };
+exports.routerExchangeApproveEstimateGas = routerExchangeApproveEstimateGas;
+var routerExchangeApprove = function (inputCoin, amount) { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, (0, utils_1.ensureAllowance)([inputCoin], [amount], curve_1.ALIASES.registry_exchange)];
+            case 1: return [2 /*return*/, _a.sent()];
+        }
+    });
+}); };
+exports.routerExchangeApprove = routerExchangeApprove;
+var routerExchangeEstimateGas = function (inputCoin, outputCoin, amount, maxSlippage) {
+    if (maxSlippage === void 0) { maxSlippage = 0.01; }
+    return __awaiter(void 0, void 0, void 0, function () {
+        var _a, inputCoinAddress, outputCoinAddress, _c, inputCoinDecimals, outputCoinDecimals, route, _d, _route, _swapParams, _factorySwapAddresses, _amount, minRecvAmountBN, _minRecvAmount, contract, value;
+        return __generator(this, function (_e) {
+            switch (_e.label) {
+                case 0:
+                    _a = (0, utils_1._getCoinAddresses)(inputCoin, outputCoin), inputCoinAddress = _a[0], outputCoinAddress = _a[1];
+                    _c = (0, utils_1._getCoinDecimals)(inputCoinAddress, outputCoinAddress), inputCoinDecimals = _c[0], outputCoinDecimals = _c[1];
+                    return [4 /*yield*/, _getBestRouteAndOutput(inputCoinAddress, outputCoinAddress, amount)];
+                case 1:
+                    route = _e.sent();
+                    if (route.steps.length === 0) {
+                        throw new Error("This pair can't be exchanged");
+                    }
+                    _d = _getExchangeMultipleArgs(inputCoinAddress, route), _route = _d._route, _swapParams = _d._swapParams, _factorySwapAddresses = _d._factorySwapAddresses;
+                    _amount = ethers_1.ethers.utils.parseUnits(amount, inputCoinDecimals);
+                    minRecvAmountBN = (0, utils_1.toBN)(route._output, outputCoinDecimals).times(1 - maxSlippage);
+                    _minRecvAmount = (0, utils_1.fromBN)(minRecvAmountBN, outputCoinDecimals);
+                    contract = curve_1.curve.contracts[curve_1.ALIASES.registry_exchange].contract;
+                    value = (0, utils_1.isEth)(inputCoinAddress) ? _amount : ethers_1.ethers.BigNumber.from(0);
+                    return [4 /*yield*/, curve_1.curve.updateFeeData()];
+                case 2:
+                    _e.sent();
+                    return [4 /*yield*/, contract.estimateGas.exchange_multiple(_route, _swapParams, _amount, _minRecvAmount, _factorySwapAddresses, __assign(__assign({}, curve_1.curve.constantOptions), { value: value }))];
+                case 3: return [2 /*return*/, (_e.sent()).toNumber()];
+            }
+        });
+    });
+};
+exports.routerExchangeEstimateGas = routerExchangeEstimateGas;
+var routerExchange = function (inputCoin, outputCoin, amount, maxSlippage) {
+    if (maxSlippage === void 0) { maxSlippage = 0.01; }
+    return __awaiter(void 0, void 0, void 0, function () {
+        var _a, inputCoinAddress, outputCoinAddress, _c, inputCoinDecimals, outputCoinDecimals, route, _d, _route, _swapParams, _factorySwapAddresses, _amount, minRecvAmountBN, _minRecvAmount, contract, value, gasLimit;
+        return __generator(this, function (_e) {
+            switch (_e.label) {
+                case 0:
+                    _a = (0, utils_1._getCoinAddresses)(inputCoin, outputCoin), inputCoinAddress = _a[0], outputCoinAddress = _a[1];
+                    _c = (0, utils_1._getCoinDecimals)(inputCoinAddress, outputCoinAddress), inputCoinDecimals = _c[0], outputCoinDecimals = _c[1];
+                    return [4 /*yield*/, (0, utils_1.ensureAllowance)([inputCoin], [amount], curve_1.ALIASES.registry_exchange)];
+                case 1:
+                    _e.sent();
+                    return [4 /*yield*/, _getBestRouteAndOutput(inputCoinAddress, outputCoinAddress, amount)];
+                case 2:
+                    route = _e.sent();
+                    if (route.steps.length === 0) {
+                        throw new Error("This pair can't be exchanged");
+                    }
+                    _d = _getExchangeMultipleArgs(inputCoinAddress, route), _route = _d._route, _swapParams = _d._swapParams, _factorySwapAddresses = _d._factorySwapAddresses;
+                    _amount = ethers_1.ethers.utils.parseUnits(amount, inputCoinDecimals);
+                    minRecvAmountBN = (0, utils_1.toBN)(route._output, outputCoinDecimals).times(1 - maxSlippage);
+                    _minRecvAmount = (0, utils_1.fromBN)(minRecvAmountBN, outputCoinDecimals);
+                    contract = curve_1.curve.contracts[curve_1.ALIASES.registry_exchange].contract;
+                    value = (0, utils_1.isEth)(inputCoinAddress) ? _amount : ethers_1.ethers.BigNumber.from(0);
+                    return [4 /*yield*/, curve_1.curve.updateFeeData()];
+                case 3:
+                    _e.sent();
+                    return [4 /*yield*/, contract.estimateGas.exchange_multiple(_route, _swapParams, _amount, _minRecvAmount, _factorySwapAddresses, __assign(__assign({}, curve_1.curve.constantOptions), { value: value }))];
+                case 4:
+                    gasLimit = (_e.sent()).mul(130).div(100);
+                    return [4 /*yield*/, contract.exchange_multiple(_route, _swapParams, _amount, _minRecvAmount, _factorySwapAddresses, __assign(__assign({}, curve_1.curve.options), { value: value, gasLimit: gasLimit }))];
+                case 5: return [2 /*return*/, (_e.sent()).hash];
+            }
+        });
+    });
+};
+exports.routerExchange = routerExchange;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curvefi/api",
-  "version": "1.22.0",
+  "version": "1.23.0",
   "description": "JavaScript library for curve.fi",
   "main": "lib/index.js",
   "scripts": {