@uniswap/router-sdk 1.0.6 → 1.3.0

package/dist/router-sdk.cjs.development.js

@@ -14,11 +14,14 @@ var sdkCore = require('@uniswap/sdk-core');
 var IPeripheryPaymentsWithFeeExtended_json = require('@uniswap/swap-router-contracts/artifacts/contracts/interfaces/IPeripheryPaymentsWithFeeExtended.sol/IPeripheryPaymentsWithFeeExtended.json');
 var ISwapRouter02_json = require('@uniswap/swap-router-contracts/artifacts/contracts/interfaces/ISwapRouter02.sol/ISwapRouter02.json');
 var v2Sdk = require('@uniswap/v2-sdk');
+var solidity = require('@ethersproject/solidity');
 
 var MSG_SENDER = '0x0000000000000000000000000000000000000001';
 var ADDRESS_THIS = '0x0000000000000000000000000000000000000002';
 var ZERO = /*#__PURE__*/JSBI.BigInt(0);
-var ONE = /*#__PURE__*/JSBI.BigInt(1);
+var ONE = /*#__PURE__*/JSBI.BigInt(1); // = 1 << 23 or 100000000000000000000000
+
+var V2_FEE_PATH_PLACEHOLDER = 8388608;
 
 (function (ApprovalTypes) {
   ApprovalTypes[ApprovalTypes["NOT_REQUIRED"] = 0] = "NOT_REQUIRED";
@@ -279,6 +282,24 @@ function _createClass(Constructor, protoProps, staticProps) {
   return Constructor;
 }
 
+function _extends() {
+  _extends = Object.assign || function (target) {
+    for (var i = 1; i < arguments.length; i++) {
+      var source = arguments[i];
+
+      for (var key in source) {
+        if (Object.prototype.hasOwnProperty.call(source, key)) {
+          target[key] = source[key];
+        }
+      }
+    }
+
+    return target;
+  };
+
+  return _extends.apply(this, arguments);
+}
+
 function _inheritsLoose(subClass, superClass) {
   subClass.prototype = Object.create(superClass.prototype);
   subClass.prototype.constructor = subClass;
@@ -1093,9 +1114,690 @@ try {
 }
 });
 
+/**
+ * Represents a list of pools or pairs through which a swap can occur
+ * @template TInput The input token
+ * @template TOutput The output token
+ */
+
+var MixedRouteSDK = /*#__PURE__*/function () {
+  /**
+   * Creates an instance of route.
+   * @param pools An array of `TPool` objects (pools or pairs), ordered by the route the swap will take
+   * @param input The input token
+   * @param output The output token
+   */
+  function MixedRouteSDK(pools, input, output) {
+    this._midPrice = null;
+    !(pools.length > 0) ?  invariant(false, 'POOLS')  : void 0;
+    var chainId = pools[0].chainId;
+    var allOnSameChain = pools.every(function (pool) {
+      return pool.chainId === chainId;
+    });
+    !allOnSameChain ?  invariant(false, 'CHAIN_IDS')  : void 0;
+    var wrappedInput = input.wrapped;
+    !pools[0].involvesToken(wrappedInput) ?  invariant(false, 'INPUT')  : void 0;
+    !pools[pools.length - 1].involvesToken(output.wrapped) ?  invariant(false, 'OUTPUT')  : void 0;
+    /**
+     * Normalizes token0-token1 order and selects the next token/fee step to add to the path
+     * */
+
+    var tokenPath = [wrappedInput];
+
+    for (var _iterator = _createForOfIteratorHelperLoose(pools.entries()), _step; !(_step = _iterator()).done;) {
+      var _step$value = _step.value,
+          i = _step$value[0],
+          pool = _step$value[1];
+      var currentInputToken = tokenPath[i];
+      !(currentInputToken.equals(pool.token0) || currentInputToken.equals(pool.token1)) ?  invariant(false, 'PATH')  : void 0;
+      var nextToken = currentInputToken.equals(pool.token0) ? pool.token1 : pool.token0;
+      tokenPath.push(nextToken);
+    }
+
+    this.pools = pools;
+    this.path = tokenPath;
+    this.input = input;
+    this.output = output != null ? output : tokenPath[tokenPath.length - 1];
+  }
+
+  _createClass(MixedRouteSDK, [{
+    key: "chainId",
+    get: function get() {
+      return this.pools[0].chainId;
+    }
+    /**
+     * Returns the mid price of the route
+     */
+
+  }, {
+    key: "midPrice",
+    get: function get() {
+      if (this._midPrice !== null) return this._midPrice;
+      var price = this.pools.slice(1).reduce(function (_ref, pool) {
+        var nextInput = _ref.nextInput,
+            price = _ref.price;
+        return nextInput.equals(pool.token0) ? {
+          nextInput: pool.token1,
+          price: price.multiply(pool.token0Price)
+        } : {
+          nextInput: pool.token0,
+          price: price.multiply(pool.token1Price)
+        };
+      }, this.pools[0].token0.equals(this.input.wrapped) ? {
+        nextInput: this.pools[0].token1,
+        price: this.pools[0].token0Price
+      } : {
+        nextInput: this.pools[0].token0,
+        price: this.pools[0].token1Price
+      }).price;
+      return this._midPrice = new sdkCore.Price(this.input, this.output, price.denominator, price.numerator);
+    }
+  }]);
+
+  return MixedRouteSDK;
+}();
+
+/**
+ * Trades comparator, an extension of the input output comparator that also considers other dimensions of the trade in ranking them
+ * @template TInput The input token, either Ether or an ERC-20
+ * @template TOutput The output token, either Ether or an ERC-20
+ * @template TTradeType The trade type, either exact input or exact output
+ * @param a The first trade to compare
+ * @param b The second trade to compare
+ * @returns A sorted ordering for two neighboring elements in a trade array
+ */
+
+function tradeComparator(a, b) {
+  // must have same input and output token for comparison
+  !a.inputAmount.currency.equals(b.inputAmount.currency) ?  invariant(false, 'INPUT_CURRENCY')  : void 0;
+  !a.outputAmount.currency.equals(b.outputAmount.currency) ?  invariant(false, 'OUTPUT_CURRENCY')  : void 0;
+
+  if (a.outputAmount.equalTo(b.outputAmount)) {
+    if (a.inputAmount.equalTo(b.inputAmount)) {
+      // consider the number of hops since each hop costs gas
+      var aHops = a.swaps.reduce(function (total, cur) {
+        return total + cur.route.path.length;
+      }, 0);
+      var bHops = b.swaps.reduce(function (total, cur) {
+        return total + cur.route.path.length;
+      }, 0);
+      return aHops - bHops;
+    } // trade A requires less input than trade B, so A should come first
+
+
+    if (a.inputAmount.lessThan(b.inputAmount)) {
+      return -1;
+    } else {
+      return 1;
+    }
+  } else {
+    // tradeA has less output than trade B, so should come second
+    if (a.outputAmount.lessThan(b.outputAmount)) {
+      return 1;
+    } else {
+      return -1;
+    }
+  }
+}
+/**
+ * Represents a trade executed against a set of routes where some percentage of the input is
+ * split across each route.
+ *
+ * Each route has its own set of pools. Pools can not be re-used across routes.
+ *
+ * Does not account for slippage, i.e., changes in price environment that can occur between
+ * the time the trade is submitted and when it is executed.
+ * @notice This class is functionally the same as the `Trade` class in the `@uniswap/v3-sdk` package, aside from typing and some input validation.
+ * @template TInput The input token, either Ether or an ERC-20
+ * @template TOutput The output token, either Ether or an ERC-20
+ * @template TTradeType The trade type, either exact input or exact output
+ */
+
+var MixedRouteTrade = /*#__PURE__*/function () {
+  /**
+   * Construct a trade by passing in the pre-computed property values
+   * @param routes The routes through which the trade occurs
+   * @param tradeType The type of trade, exact input or exact output
+   */
+  function MixedRouteTrade(_ref) {
+    var routes = _ref.routes,
+        tradeType = _ref.tradeType;
+    var inputCurrency = routes[0].inputAmount.currency;
+    var outputCurrency = routes[0].outputAmount.currency;
+    !routes.every(function (_ref2) {
+      var route = _ref2.route;
+      return inputCurrency.wrapped.equals(route.input.wrapped);
+    }) ?  invariant(false, 'INPUT_CURRENCY_MATCH')  : void 0;
+    !routes.every(function (_ref3) {
+      var route = _ref3.route;
+      return outputCurrency.wrapped.equals(route.output.wrapped);
+    }) ?  invariant(false, 'OUTPUT_CURRENCY_MATCH')  : void 0;
+    var numPools = routes.map(function (_ref4) {
+      var route = _ref4.route;
+      return route.pools.length;
+    }).reduce(function (total, cur) {
+      return total + cur;
+    }, 0);
+    var poolAddressSet = new Set();
+
+    for (var _iterator = _createForOfIteratorHelperLoose(routes), _step; !(_step = _iterator()).done;) {
+      var route = _step.value.route;
+
+      for (var _iterator2 = _createForOfIteratorHelperLoose(route.pools), _step2; !(_step2 = _iterator2()).done;) {
+        var pool = _step2.value;
+        pool instanceof v3Sdk.Pool ? poolAddressSet.add(v3Sdk.Pool.getAddress(pool.token0, pool.token1, pool.fee)) : poolAddressSet.add(v2Sdk.Pair.getAddress(pool.token0, pool.token1));
+      }
+    }
+
+    !(numPools == poolAddressSet.size) ?  invariant(false, 'POOLS_DUPLICATED')  : void 0;
+    !(tradeType === sdkCore.TradeType.EXACT_INPUT) ?  invariant(false, 'TRADE_TYPE')  : void 0;
+    this.swaps = routes;
+    this.tradeType = tradeType;
+  }
+  /**
+   * @deprecated Deprecated in favor of 'swaps' property. If the trade consists of multiple routes
+   * this will return an error.
+   *
+   * When the trade consists of just a single route, this returns the route of the trade,
+   * i.e. which pools the trade goes through.
+   */
+
+
+  /**
+   * Constructs a trade by simulating swaps through the given route
+   * @template TInput The input token, either Ether or an ERC-20.
+   * @template TOutput The output token, either Ether or an ERC-20.
+   * @template TTradeType The type of the trade, either exact in or exact out.
+   * @param route route to swap through
+   * @param amount the amount specified, either input or output, depending on tradeType
+   * @param tradeType whether the trade is an exact input or exact output swap
+   * @returns The route
+   */
+  MixedRouteTrade.fromRoute =
+  /*#__PURE__*/
+  function () {
+    var _fromRoute = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/runtime_1.mark(function _callee(route, amount, tradeType) {
+      var amounts, inputAmount, outputAmount, i, pool, _yield$pool$getOutput, _outputAmount;
+
+      return runtime_1.wrap(function _callee$(_context) {
+        while (1) {
+          switch (_context.prev = _context.next) {
+            case 0:
+              amounts = new Array(route.path.length);
+              !(tradeType === sdkCore.TradeType.EXACT_INPUT) ?  invariant(false, 'TRADE_TYPE')  : void 0;
+              !amount.currency.equals(route.input) ?  invariant(false, 'INPUT')  : void 0;
+              amounts[0] = amount.wrapped;
+              i = 0;
+
+            case 5:
+              if (!(i < route.path.length - 1)) {
+                _context.next = 15;
+                break;
+              }
+
+              pool = route.pools[i];
+              _context.next = 9;
+              return pool.getOutputAmount(amounts[i]);
+
+            case 9:
+              _yield$pool$getOutput = _context.sent;
+              _outputAmount = _yield$pool$getOutput[0];
+              amounts[i + 1] = _outputAmount;
+
+            case 12:
+              i++;
+              _context.next = 5;
+              break;
+
+            case 15:
+              inputAmount = sdkCore.CurrencyAmount.fromFractionalAmount(route.input, amount.numerator, amount.denominator);
+              outputAmount = sdkCore.CurrencyAmount.fromFractionalAmount(route.output, amounts[amounts.length - 1].numerator, amounts[amounts.length - 1].denominator);
+              return _context.abrupt("return", new MixedRouteTrade({
+                routes: [{
+                  inputAmount: inputAmount,
+                  outputAmount: outputAmount,
+                  route: route
+                }],
+                tradeType: tradeType
+              }));
+
+            case 18:
+            case "end":
+              return _context.stop();
+          }
+        }
+      }, _callee);
+    }));
+
+    function fromRoute(_x, _x2, _x3) {
+      return _fromRoute.apply(this, arguments);
+    }
+
+    return fromRoute;
+  }()
+  /**
+   * Constructs a trade from routes by simulating swaps
+   *
+   * @template TInput The input token, either Ether or an ERC-20.
+   * @template TOutput The output token, either Ether or an ERC-20.
+   * @template TTradeType The type of the trade, either exact in or exact out.
+   * @param routes the routes to swap through and how much of the amount should be routed through each
+   * @param tradeType whether the trade is an exact input or exact output swap
+   * @returns The trade
+   */
+  ;
+
+  MixedRouteTrade.fromRoutes =
+  /*#__PURE__*/
+  function () {
+    var _fromRoutes = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/runtime_1.mark(function _callee2(routes, tradeType) {
+      var populatedRoutes, _iterator3, _step3, _step3$value, route, amount, amounts, inputAmount, outputAmount, i, pool, _yield$pool$getOutput2, _outputAmount2;
+
+      return runtime_1.wrap(function _callee2$(_context2) {
+        while (1) {
+          switch (_context2.prev = _context2.next) {
+            case 0:
+              populatedRoutes = [];
+              !(tradeType === sdkCore.TradeType.EXACT_INPUT) ?  invariant(false, 'TRADE_TYPE')  : void 0;
+              _iterator3 = _createForOfIteratorHelperLoose(routes);
+
+            case 3:
+              if ((_step3 = _iterator3()).done) {
+                _context2.next = 26;
+                break;
+              }
+
+              _step3$value = _step3.value, route = _step3$value.route, amount = _step3$value.amount;
+              amounts = new Array(route.path.length);
+              inputAmount = void 0;
+              outputAmount = void 0;
+              !amount.currency.equals(route.input) ?  invariant(false, 'INPUT')  : void 0;
+              inputAmount = sdkCore.CurrencyAmount.fromFractionalAmount(route.input, amount.numerator, amount.denominator);
+              amounts[0] = sdkCore.CurrencyAmount.fromFractionalAmount(route.input.wrapped, amount.numerator, amount.denominator);
+              i = 0;
+
+            case 12:
+              if (!(i < route.path.length - 1)) {
+                _context2.next = 22;
+                break;
+              }
+
+              pool = route.pools[i];
+              _context2.next = 16;
+              return pool.getOutputAmount(amounts[i]);
+
+            case 16:
+              _yield$pool$getOutput2 = _context2.sent;
+              _outputAmount2 = _yield$pool$getOutput2[0];
+              amounts[i + 1] = _outputAmount2;
+
+            case 19:
+              i++;
+              _context2.next = 12;
+              break;
+
+            case 22:
+              outputAmount = sdkCore.CurrencyAmount.fromFractionalAmount(route.output, amounts[amounts.length - 1].numerator, amounts[amounts.length - 1].denominator);
+              populatedRoutes.push({
+                route: route,
+                inputAmount: inputAmount,
+                outputAmount: outputAmount
+              });
+
+            case 24:
+              _context2.next = 3;
+              break;
+
+            case 26:
+              return _context2.abrupt("return", new MixedRouteTrade({
+                routes: populatedRoutes,
+                tradeType: tradeType
+              }));
+
+            case 27:
+            case "end":
+              return _context2.stop();
+          }
+        }
+      }, _callee2);
+    }));
+
+    function fromRoutes(_x4, _x5) {
+      return _fromRoutes.apply(this, arguments);
+    }
+
+    return fromRoutes;
+  }()
+  /**
+   * Creates a trade without computing the result of swapping through the route. Useful when you have simulated the trade
+   * elsewhere and do not have any tick data
+   * @template TInput The input token, either Ether or an ERC-20
+   * @template TOutput The output token, either Ether or an ERC-20
+   * @template TTradeType The type of the trade, either exact in or exact out
+   * @param constructorArguments The arguments passed to the trade constructor
+   * @returns The unchecked trade
+   */
+  ;
+
+  MixedRouteTrade.createUncheckedTrade = function createUncheckedTrade(constructorArguments) {
+    return new MixedRouteTrade(_extends({}, constructorArguments, {
+      routes: [{
+        inputAmount: constructorArguments.inputAmount,
+        outputAmount: constructorArguments.outputAmount,
+        route: constructorArguments.route
+      }]
+    }));
+  }
+  /**
+   * Creates a trade without computing the result of swapping through the routes. Useful when you have simulated the trade
+   * elsewhere and do not have any tick data
+   * @template TInput The input token, either Ether or an ERC-20
+   * @template TOutput The output token, either Ether or an ERC-20
+   * @template TTradeType The type of the trade, either exact in or exact out
+   * @param constructorArguments The arguments passed to the trade constructor
+   * @returns The unchecked trade
+   */
+  ;
+
+  MixedRouteTrade.createUncheckedTradeWithMultipleRoutes = function createUncheckedTradeWithMultipleRoutes(constructorArguments) {
+    return new MixedRouteTrade(constructorArguments);
+  }
+  /**
+   * Get the minimum amount that must be received from this trade for the given slippage tolerance
+   * @param slippageTolerance The tolerance of unfavorable slippage from the execution price of this trade
+   * @returns The amount out
+   */
+  ;
+
+  var _proto = MixedRouteTrade.prototype;
+
+  _proto.minimumAmountOut = function minimumAmountOut(slippageTolerance, amountOut) {
+    if (amountOut === void 0) {
+      amountOut = this.outputAmount;
+    }
+
+    !!slippageTolerance.lessThan(ZERO) ?  invariant(false, 'SLIPPAGE_TOLERANCE')  : void 0; /// does not support exactOutput, as enforced in the constructor
+
+    var slippageAdjustedAmountOut = new sdkCore.Fraction(ONE).add(slippageTolerance).invert().multiply(amountOut.quotient).quotient;
+    return sdkCore.CurrencyAmount.fromRawAmount(amountOut.currency, slippageAdjustedAmountOut);
+  }
+  /**
+   * Get the maximum amount in that can be spent via this trade for the given slippage tolerance
+   * @param slippageTolerance The tolerance of unfavorable slippage from the execution price of this trade
+   * @returns The amount in
+   */
+  ;
+
+  _proto.maximumAmountIn = function maximumAmountIn(slippageTolerance, amountIn) {
+    if (amountIn === void 0) {
+      amountIn = this.inputAmount;
+    }
+
+    !!slippageTolerance.lessThan(ZERO) ?  invariant(false, 'SLIPPAGE_TOLERANCE')  : void 0;
+    return amountIn; /// does not support exactOutput
+  }
+  /**
+   * Return the execution price after accounting for slippage tolerance
+   * @param slippageTolerance the allowed tolerated slippage
+   * @returns The execution price
+   */
+  ;
+
+  _proto.worstExecutionPrice = function worstExecutionPrice(slippageTolerance) {
+    return new sdkCore.Price(this.inputAmount.currency, this.outputAmount.currency, this.maximumAmountIn(slippageTolerance).quotient, this.minimumAmountOut(slippageTolerance).quotient);
+  }
+  /**
+   * Given a list of pools, and a fixed amount in, returns the top `maxNumResults` trades that go from an input token
+   * amount to an output token, making at most `maxHops` hops.
+   * Note this does not consider aggregation, as routes are linear. It's possible a better route exists by splitting
+   * the amount in among multiple routes.
+   * @param pools the pools to consider in finding the best trade
+   * @param nextAmountIn exact amount of input currency to spend
+   * @param currencyOut the desired currency out
+   * @param maxNumResults maximum number of results to return
+   * @param maxHops maximum number of hops a returned trade can make, e.g. 1 hop goes through a single pool
+   * @param currentPools used in recursion; the current list of pools
+   * @param currencyAmountIn used in recursion; the original value of the currencyAmountIn parameter
+   * @param bestTrades used in recursion; the current list of best trades
+   * @returns The exact in trade
+   */
+  ;
+
+  MixedRouteTrade.bestTradeExactIn =
+  /*#__PURE__*/
+  function () {
+    var _bestTradeExactIn = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/runtime_1.mark(function _callee3(pools, currencyAmountIn, currencyOut, _temp, // used in recursion.
+    currentPools, nextAmountIn, bestTrades) {
+      var _ref5, _ref5$maxNumResults, maxNumResults, _ref5$maxHops, maxHops, amountIn, tokenOut, i, pool, amountOut, _yield$pool$getOutput3, poolsExcludingThisPool;
+
+      return runtime_1.wrap(function _callee3$(_context3) {
+        while (1) {
+          switch (_context3.prev = _context3.next) {
+            case 0:
+              _ref5 = _temp === void 0 ? {} : _temp, _ref5$maxNumResults = _ref5.maxNumResults, maxNumResults = _ref5$maxNumResults === void 0 ? 3 : _ref5$maxNumResults, _ref5$maxHops = _ref5.maxHops, maxHops = _ref5$maxHops === void 0 ? 3 : _ref5$maxHops;
+
+              if (currentPools === void 0) {
+                currentPools = [];
+              }
+
+              if (nextAmountIn === void 0) {
+                nextAmountIn = currencyAmountIn;
+              }
+
+              if (bestTrades === void 0) {
+                bestTrades = [];
+              }
+
+              !(pools.length > 0) ?  invariant(false, 'POOLS')  : void 0;
+              !(maxHops > 0) ?  invariant(false, 'MAX_HOPS')  : void 0;
+              !(currencyAmountIn === nextAmountIn || currentPools.length > 0) ?  invariant(false, 'INVALID_RECURSION')  : void 0;
+              amountIn = nextAmountIn.wrapped;
+              tokenOut = currencyOut.wrapped;
+              i = 0;
+
+            case 10:
+              if (!(i < pools.length)) {
+                _context3.next = 49;
+                break;
+              }
+
+              pool = pools[i]; // pool irrelevant
+
+              if (!(!pool.token0.equals(amountIn.currency) && !pool.token1.equals(amountIn.currency))) {
+                _context3.next = 14;
+                break;
+              }
+
+              return _context3.abrupt("continue", 46);
+
+            case 14:
+              if (!(pool instanceof v2Sdk.Pair)) {
+                _context3.next = 17;
+                break;
+              }
+
+              if (!(pool.reserve0.equalTo(ZERO) || pool.reserve1.equalTo(ZERO))) {
+                _context3.next = 17;
+                break;
+              }
+
+              return _context3.abrupt("continue", 46);
+
+            case 17:
+              amountOut = void 0;
+              _context3.prev = 18;
+              _context3.next = 22;
+              return pool.getOutputAmount(amountIn);
+
+            case 22:
+              _yield$pool$getOutput3 = _context3.sent;
+              amountOut = _yield$pool$getOutput3[0];
+              _context3.next = 31;
+              break;
+
+            case 26:
+              _context3.prev = 26;
+              _context3.t0 = _context3["catch"](18);
+
+              if (!_context3.t0.isInsufficientInputAmountError) {
+                _context3.next = 30;
+                break;
+              }
+
+              return _context3.abrupt("continue", 46);
+
+            case 30:
+              throw _context3.t0;
+
+            case 31:
+              if (!(amountOut.currency.isToken && amountOut.currency.equals(tokenOut))) {
+                _context3.next = 42;
+                break;
+              }
+
+              _context3.t1 = sdkCore.sortedInsert;
+              _context3.t2 = bestTrades;
+              _context3.next = 36;
+              return MixedRouteTrade.fromRoute(new MixedRouteSDK([].concat(currentPools, [pool]), currencyAmountIn.currency, currencyOut), currencyAmountIn, sdkCore.TradeType.EXACT_INPUT);
+
+            case 36:
+              _context3.t3 = _context3.sent;
+              _context3.t4 = maxNumResults;
+              _context3.t5 = tradeComparator;
+              (0, _context3.t1)(_context3.t2, _context3.t3, _context3.t4, _context3.t5);
+              _context3.next = 46;
+              break;
+
+            case 42:
+              if (!(maxHops > 1 && pools.length > 1)) {
+                _context3.next = 46;
+                break;
+              }
+
+              poolsExcludingThisPool = pools.slice(0, i).concat(pools.slice(i + 1, pools.length)); // otherwise, consider all the other paths that lead from this token as long as we have not exceeded maxHops
+
+              _context3.next = 46;
+              return MixedRouteTrade.bestTradeExactIn(poolsExcludingThisPool, currencyAmountIn, currencyOut, {
+                maxNumResults: maxNumResults,
+                maxHops: maxHops - 1
+              }, [].concat(currentPools, [pool]), amountOut, bestTrades);
+
+            case 46:
+              i++;
+              _context3.next = 10;
+              break;
+
+            case 49:
+              return _context3.abrupt("return", bestTrades);
+
+            case 50:
+            case "end":
+              return _context3.stop();
+          }
+        }
+      }, _callee3, null, [[18, 26]]);
+    }));
+
+    function bestTradeExactIn(_x6, _x7, _x8, _x9, _x10, _x11, _x12) {
+      return _bestTradeExactIn.apply(this, arguments);
+    }
+
+    return bestTradeExactIn;
+  }();
+
+  _createClass(MixedRouteTrade, [{
+    key: "route",
+    get: function get() {
+      !(this.swaps.length == 1) ?  invariant(false, 'MULTIPLE_ROUTES')  : void 0;
+      return this.swaps[0].route;
+    }
+    /**
+     * The input amount for the trade assuming no slippage.
+     */
+
+  }, {
+    key: "inputAmount",
+    get: function get() {
+      if (this._inputAmount) {
+        return this._inputAmount;
+      }
+
+      var inputCurrency = this.swaps[0].inputAmount.currency;
+      var totalInputFromRoutes = this.swaps.map(function (_ref6) {
+        var inputAmount = _ref6.inputAmount;
+        return inputAmount;
+      }).reduce(function (total, cur) {
+        return total.add(cur);
+      }, sdkCore.CurrencyAmount.fromRawAmount(inputCurrency, 0));
+      this._inputAmount = totalInputFromRoutes;
+      return this._inputAmount;
+    }
+    /**
+     * The output amount for the trade assuming no slippage.
+     */
+
+  }, {
+    key: "outputAmount",
+    get: function get() {
+      if (this._outputAmount) {
+        return this._outputAmount;
+      }
+
+      var outputCurrency = this.swaps[0].outputAmount.currency;
+      var totalOutputFromRoutes = this.swaps.map(function (_ref7) {
+        var outputAmount = _ref7.outputAmount;
+        return outputAmount;
+      }).reduce(function (total, cur) {
+        return total.add(cur);
+      }, sdkCore.CurrencyAmount.fromRawAmount(outputCurrency, 0));
+      this._outputAmount = totalOutputFromRoutes;
+      return this._outputAmount;
+    }
+    /**
+     * The price expressed in terms of output amount/input amount.
+     */
+
+  }, {
+    key: "executionPrice",
+    get: function get() {
+      var _this$_executionPrice;
+
+      return (_this$_executionPrice = this._executionPrice) != null ? _this$_executionPrice : this._executionPrice = new sdkCore.Price(this.inputAmount.currency, this.outputAmount.currency, this.inputAmount.quotient, this.outputAmount.quotient);
+    }
+    /**
+     * Returns the percent difference between the route's mid price and the price impact
+     */
+
+  }, {
+    key: "priceImpact",
+    get: function get() {
+      if (this._priceImpact) {
+        return this._priceImpact;
+      }
+
+      var spotOutputAmount = sdkCore.CurrencyAmount.fromRawAmount(this.outputAmount.currency, 0);
+
+      for (var _iterator4 = _createForOfIteratorHelperLoose(this.swaps), _step4; !(_step4 = _iterator4()).done;) {
+        var _step4$value = _step4.value,
+            route = _step4$value.route,
+            inputAmount = _step4$value.inputAmount;
+        var midPrice = route.midPrice;
+        spotOutputAmount = spotOutputAmount.add(midPrice.quote(inputAmount));
+      }
+
+      var priceImpact = spotOutputAmount.subtract(this.outputAmount).divide(spotOutputAmount);
+      this._priceImpact = new sdkCore.Percent(priceImpact.numerator, priceImpact.denominator);
+      return this._priceImpact;
+    }
+  }]);
+
+  return MixedRouteTrade;
+}();
+
 (function (Protocol) {
   Protocol["V2"] = "V2";
   Protocol["V3"] = "V3";
+  Protocol["MIXED"] = "MIXED";
 })(exports.Protocol || (exports.Protocol = {}));
 
 var RouteV2 = /*#__PURE__*/function (_V2RouteSDK) {
@@ -1126,28 +1828,45 @@ var RouteV3 = /*#__PURE__*/function (_V3RouteSDK) {
   }
 
   return RouteV3;
-}(v3Sdk.Route);
+}(v3Sdk.Route); // Mixed route wrapper
+
+var MixedRoute = /*#__PURE__*/function (_MixedRouteSDK) {
+  _inheritsLoose(MixedRoute, _MixedRouteSDK);
+
+  function MixedRoute(mixedRoute) {
+    var _this3;
+
+    _this3 = _MixedRouteSDK.call(this, mixedRoute.pools, mixedRoute.input, mixedRoute.output) || this;
+    _this3.protocol = exports.Protocol.MIXED;
+    return _this3;
+  }
+
+  return MixedRoute;
+}(MixedRouteSDK);
 
 var Trade = /*#__PURE__*/function () {
   //  construct a trade across v2 and v3 routes from pre-computed amounts
   function Trade(_ref) {
     var v2Routes = _ref.v2Routes,
         v3Routes = _ref.v3Routes,
-        tradeType = _ref.tradeType;
+        tradeType = _ref.tradeType,
+        mixedRoutes = _ref.mixedRoutes;
     this.swaps = [];
     this.routes = []; // wrap v2 routes
 
     for (var _iterator = _createForOfIteratorHelperLoose(v2Routes), _step; !(_step = _iterator()).done;) {
       var _step$value = _step.value,
           routev2 = _step$value.routev2,
-          inputAmount = _step$value.inputAmount,
-          outputAmount = _step$value.outputAmount;
-      var route = new RouteV2(routev2);
-      this.routes.push(route);
+          _inputAmount = _step$value.inputAmount,
+          _outputAmount = _step$value.outputAmount;
+
+      var _route = new RouteV2(routev2);
+
+      this.routes.push(_route);
       this.swaps.push({
-        route: route,
-        inputAmount: inputAmount,
-        outputAmount: outputAmount
+        route: _route,
+        inputAmount: _inputAmount,
+        outputAmount: _outputAmount
       });
     } // wrap v3 routes
 
@@ -1155,17 +1874,34 @@ var Trade = /*#__PURE__*/function () {
     for (var _iterator2 = _createForOfIteratorHelperLoose(v3Routes), _step2; !(_step2 = _iterator2()).done;) {
       var _step2$value = _step2.value,
           routev3 = _step2$value.routev3,
-          _inputAmount = _step2$value.inputAmount,
-          _outputAmount = _step2$value.outputAmount;
+          _inputAmount2 = _step2$value.inputAmount,
+          _outputAmount2 = _step2$value.outputAmount;
 
-      var _route = new RouteV3(routev3);
+      var _route2 = new RouteV3(routev3);
 
-      this.routes.push(_route);
+      this.routes.push(_route2);
       this.swaps.push({
-        route: _route,
-        inputAmount: _inputAmount,
-        outputAmount: _outputAmount
+        route: _route2,
+        inputAmount: _inputAmount2,
+        outputAmount: _outputAmount2
       });
+    } // wrap mixedRoutes
+
+
+    if (mixedRoutes) {
+      for (var _iterator3 = _createForOfIteratorHelperLoose(mixedRoutes), _step3; !(_step3 = _iterator3()).done;) {
+        var _step3$value = _step3.value,
+            mixedRoute = _step3$value.mixedRoute,
+            inputAmount = _step3$value.inputAmount,
+            outputAmount = _step3$value.outputAmount;
+        var route = new MixedRoute(mixedRoute);
+        this.routes.push(route);
+        this.swaps.push({
+          route: route,
+          inputAmount: inputAmount,
+          outputAmount: outputAmount
+        });
+      }
     }
 
     this.tradeType = tradeType; // each route must have the same input and output currency
@@ -1189,17 +1925,19 @@ var Trade = /*#__PURE__*/function () {
     }, 0);
     var poolAddressSet = new Set();
 
-    for (var _iterator3 = _createForOfIteratorHelperLoose(this.swaps), _step3; !(_step3 = _iterator3()).done;) {
-      var _route2 = _step3.value.route;
+    for (var _iterator4 = _createForOfIteratorHelperLoose(this.swaps), _step4; !(_step4 = _iterator4()).done;) {
+      var _route3 = _step4.value.route;
 
-      for (var _iterator4 = _createForOfIteratorHelperLoose(_route2.pools), _step4; !(_step4 = _iterator4()).done;) {
-        var pool = _step4.value;
+      for (var _iterator5 = _createForOfIteratorHelperLoose(_route3.pools), _step5; !(_step5 = _iterator5()).done;) {
+        var pool = _step5.value;
 
-        if (_route2.protocol == exports.Protocol.V3) {
+        if (pool instanceof v3Sdk.Pool) {
           poolAddressSet.add(v3Sdk.Pool.getAddress(pool.token0, pool.token1, pool.fee));
-        } else {
+        } else if (pool instanceof v2Sdk.Pair) {
           var pair = pool;
           poolAddressSet.add(v2Sdk.Pair.getAddress(pair.token0, pair.token1));
+        } else {
+          throw new Error('Unexpected pool type in route when constructing trade object');
         }
       }
     }
@@ -1261,8 +1999,8 @@ var Trade = /*#__PURE__*/function () {
   };
 
   Trade.fromRoutes = /*#__PURE__*/function () {
-    var _fromRoutes = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/runtime_1.mark(function _callee(v2Routes, v3Routes, tradeType) {
-      var populatedV2Routes, populatedV3Routes, _iterator5, _step5, _step5$value, routev2, amount, v2Trade, inputAmount, outputAmount, _iterator6, _step6, _step6$value, routev3, _amount, v3Trade, _inputAmount2, _outputAmount2;
+    var _fromRoutes = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/runtime_1.mark(function _callee(v2Routes, v3Routes, tradeType, mixedRoutes) {
+      var populatedV2Routes, populatedV3Routes, populatedMixedRoutes, _iterator6, _step6, _step6$value, routev2, _amount, v2Trade, _inputAmount3, _outputAmount3, _iterator7, _step7, _step7$value, routev3, _amount2, v3Trade, _inputAmount4, _outputAmount4, _iterator8, _step8, _step8$value, mixedRoute, amount, mixedRouteTrade, inputAmount, outputAmount;
 
       return runtime_1.wrap(function _callee$(_context) {
         while (1) {
@@ -1270,51 +2008,84 @@ var Trade = /*#__PURE__*/function () {
             case 0:
               populatedV2Routes = [];
               populatedV3Routes = [];
+              populatedMixedRoutes = [];
 
-              for (_iterator5 = _createForOfIteratorHelperLoose(v2Routes); !(_step5 = _iterator5()).done;) {
-                _step5$value = _step5.value, routev2 = _step5$value.routev2, amount = _step5$value.amount;
-                v2Trade = new v2Sdk.Trade(routev2, amount, tradeType);
-                inputAmount = v2Trade.inputAmount, outputAmount = v2Trade.outputAmount;
+              for (_iterator6 = _createForOfIteratorHelperLoose(v2Routes); !(_step6 = _iterator6()).done;) {
+                _step6$value = _step6.value, routev2 = _step6$value.routev2, _amount = _step6$value.amount;
+                v2Trade = new v2Sdk.Trade(routev2, _amount, tradeType);
+                _inputAmount3 = v2Trade.inputAmount, _outputAmount3 = v2Trade.outputAmount;
                 populatedV2Routes.push({
                   routev2: routev2,
-                  inputAmount: inputAmount,
-                  outputAmount: outputAmount
+                  inputAmount: _inputAmount3,
+                  outputAmount: _outputAmount3
                 });
               }
 
-              _iterator6 = _createForOfIteratorHelperLoose(v3Routes);
+              _iterator7 = _createForOfIteratorHelperLoose(v3Routes);
 
-            case 4:
-              if ((_step6 = _iterator6()).done) {
-                _context.next = 13;
+            case 5:
+              if ((_step7 = _iterator7()).done) {
+                _context.next = 14;
                 break;
               }
 
-              _step6$value = _step6.value, routev3 = _step6$value.routev3, _amount = _step6$value.amount;
-              _context.next = 8;
-              return v3Sdk.Trade.fromRoute(routev3, _amount, tradeType);
+              _step7$value = _step7.value, routev3 = _step7$value.routev3, _amount2 = _step7$value.amount;
+              _context.next = 9;
+              return v3Sdk.Trade.fromRoute(routev3, _amount2, tradeType);
 
-            case 8:
+            case 9:
               v3Trade = _context.sent;
-              _inputAmount2 = v3Trade.inputAmount, _outputAmount2 = v3Trade.outputAmount;
+              _inputAmount4 = v3Trade.inputAmount, _outputAmount4 = v3Trade.outputAmount;
               populatedV3Routes.push({
                 routev3: routev3,
-                inputAmount: _inputAmount2,
-                outputAmount: _outputAmount2
+                inputAmount: _inputAmount4,
+                outputAmount: _outputAmount4
               });
 
-            case 11:
-              _context.next = 4;
+            case 12:
+              _context.next = 5;
               break;
 
-            case 13:
+            case 14:
+              if (!mixedRoutes) {
+                _context.next = 25;
+                break;
+              }
+
+              _iterator8 = _createForOfIteratorHelperLoose(mixedRoutes);
+
+            case 16:
+              if ((_step8 = _iterator8()).done) {
+                _context.next = 25;
+                break;
+              }
+
+              _step8$value = _step8.value, mixedRoute = _step8$value.mixedRoute, amount = _step8$value.amount;
+              _context.next = 20;
+              return MixedRouteTrade.fromRoute(mixedRoute, amount, tradeType);
+
+            case 20:
+              mixedRouteTrade = _context.sent;
+              inputAmount = mixedRouteTrade.inputAmount, outputAmount = mixedRouteTrade.outputAmount;
+              populatedMixedRoutes.push({
+                mixedRoute: mixedRoute,
+                inputAmount: inputAmount,
+                outputAmount: outputAmount
+              });
+
+            case 23:
+              _context.next = 16;
+              break;
+
+            case 25:
               return _context.abrupt("return", new Trade({
                 v2Routes: populatedV2Routes,
                 v3Routes: populatedV3Routes,
+                mixedRoutes: populatedMixedRoutes,
                 tradeType: tradeType
               }));
 
-            case 14:
+            case 26:
             case "end":
               return _context.stop();
           }
@@ -1322,7 +2093,7 @@ var Trade = /*#__PURE__*/function () {
       }, _callee);
     }));
 
-    function fromRoutes(_x, _x2, _x3) {
+    function fromRoutes(_x, _x2, _x3, _x4) {
       return _fromRoutes.apply(this, arguments);
     }
 
@@ -1331,14 +2102,18 @@ var Trade = /*#__PURE__*/function () {
 
   Trade.fromRoute = /*#__PURE__*/function () {
     var _fromRoute = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/runtime_1.mark(function _callee2(route, amount, tradeType) {
-      var v2Routes, v3Routes, v2Trade, inputAmount, outputAmount, v3Trade, _inputAmount3, _outputAmount3;
+      var v2Routes, v3Routes, mixedRoutes, v2Trade, inputAmount, outputAmount, v3Trade, _inputAmount5, _outputAmount5, mixedRouteTrade, _inputAmount6, _outputAmount6;
 
       return runtime_1.wrap(function _callee2$(_context2) {
         while (1) {
           switch (_context2.prev = _context2.next) {
             case 0:
+              v2Routes = [];
+              v3Routes = [];
+              mixedRoutes = [];
+
               if (!(route instanceof v2Sdk.Route)) {
-                _context2.next = 7;
+                _context2.next = 9;
                 break;
               }
 
@@ -1349,32 +2124,61 @@ var Trade = /*#__PURE__*/function () {
                 inputAmount: inputAmount,
                 outputAmount: outputAmount
               }];
-              v3Routes = [];
-              _context2.next = 13;
+              _context2.next = 26;
               break;
 
-            case 7:
-              _context2.next = 9;
+            case 9:
+              if (!(route instanceof v3Sdk.Route)) {
+                _context2.next = 17;
+                break;
+              }
+
+              _context2.next = 12;
               return v3Sdk.Trade.fromRoute(route, amount, tradeType);
 
-            case 9:
+            case 12:
               v3Trade = _context2.sent;
-              _inputAmount3 = v3Trade.inputAmount, _outputAmount3 = v3Trade.outputAmount;
+              _inputAmount5 = v3Trade.inputAmount, _outputAmount5 = v3Trade.outputAmount;
               v3Routes = [{
                 routev3: route,
-                inputAmount: _inputAmount3,
-                outputAmount: _outputAmount3
+                inputAmount: _inputAmount5,
+                outputAmount: _outputAmount5
               }];
-              v2Routes = [];
+              _context2.next = 26;
+              break;
+
+            case 17:
+              if (!(route instanceof MixedRouteSDK)) {
+                _context2.next = 25;
+                break;
+              }
+
+              _context2.next = 20;
+              return MixedRouteTrade.fromRoute(route, amount, tradeType);
+
+            case 20:
+              mixedRouteTrade = _context2.sent;
+              _inputAmount6 = mixedRouteTrade.inputAmount, _outputAmount6 = mixedRouteTrade.outputAmount;
+              mixedRoutes = [{
+                mixedRoute: route,
+                inputAmount: _inputAmount6,
+                outputAmount: _outputAmount6
+              }];
+              _context2.next = 26;
+              break;
 
-            case 13:
+            case 25:
+              throw new Error('Invalid route type');
+
+            case 26:
               return _context2.abrupt("return", new Trade({
                 v2Routes: v2Routes,
                 v3Routes: v3Routes,
+                mixedRoutes: mixedRoutes,
                 tradeType: tradeType
               }));
 
-            case 14:
+            case 27:
             case "end":
               return _context2.stop();
           }
@@ -1382,7 +2186,7 @@ var Trade = /*#__PURE__*/function () {
       }, _callee2);
     }));
 
-    function fromRoute(_x4, _x5, _x6) {
+    function fromRoute(_x5, _x6, _x7) {
       return _fromRoute.apply(this, arguments);
     }
 
@@ -1447,10 +2251,10 @@ var Trade = /*#__PURE__*/function () {
 
       var spotOutputAmount = sdkCore.CurrencyAmount.fromRawAmount(this.outputAmount.currency, 0);
 
-      for (var _iterator7 = _createForOfIteratorHelperLoose(this.swaps), _step7; !(_step7 = _iterator7()).done;) {
-        var _step7$value = _step7.value,
-            route = _step7$value.route,
-            inputAmount = _step7$value.inputAmount;
+      for (var _iterator9 = _createForOfIteratorHelperLoose(this.swaps), _step9; !(_step9 = _iterator9()).done;) {
+        var _step9$value = _step9.value,
+            route = _step9$value.route,
+            inputAmount = _step9$value.inputAmount;
         var midPrice = route.midPrice;
         spotOutputAmount = spotOutputAmount.add(midPrice.quote(inputAmount));
       }
@@ -1464,7 +2268,99 @@ var Trade = /*#__PURE__*/function () {
   return Trade;
 }();
 
+/**
+ * Converts a route to a hex encoded path
+ * @notice only supports exactIn route encodings
+ * @param route the mixed path to convert to an encoded path
+ * @returns the exactIn encoded path
+ */
+
+function encodeMixedRouteToPath(route) {
+  var firstInputToken = route.input.wrapped;
+
+  var _route$pools$reduce = route.pools.reduce(function (_ref, pool, index) {
+    var inputToken = _ref.inputToken,
+        path = _ref.path,
+        types = _ref.types;
+    var outputToken = pool.token0.equals(inputToken) ? pool.token1 : pool.token0;
+
+    if (index === 0) {
+      return {
+        inputToken: outputToken,
+        types: ['address', 'uint24', 'address'],
+        path: [inputToken.address, pool instanceof v3Sdk.Pool ? pool.fee : V2_FEE_PATH_PLACEHOLDER, outputToken.address]
+      };
+    } else {
+      return {
+        inputToken: outputToken,
+        types: [].concat(types, ['uint24', 'address']),
+        path: [].concat(path, [pool instanceof v3Sdk.Pool ? pool.fee : V2_FEE_PATH_PLACEHOLDER, outputToken.address])
+      };
+    }
+  }, {
+    inputToken: firstInputToken,
+    path: [],
+    types: []
+  }),
+      path = _route$pools$reduce.path,
+      types = _route$pools$reduce.types;
+
+  return solidity.pack(types, path);
+}
+
+/**
+ * Utility function to return each consecutive section of Pools or Pairs in a MixedRoute
+ * @param route
+ * @returns a nested array of Pools or Pairs in the order of the route
+ */
+
+var partitionMixedRouteByProtocol = function partitionMixedRouteByProtocol(route) {
+  var acc = [];
+  var left = 0;
+  var right = 0;
+
+  while (right < route.pools.length) {
+    if (route.pools[left] instanceof v3Sdk.Pool && route.pools[right] instanceof v2Sdk.Pair || route.pools[left] instanceof v2Sdk.Pair && route.pools[right] instanceof v3Sdk.Pool) {
+      acc.push(route.pools.slice(left, right));
+      left = right;
+    } // seek forward with right pointer
+
+
+    right++;
+
+    if (right === route.pools.length) {
+      /// we reached the end, take the rest
+      acc.push(route.pools.slice(left, right));
+    }
+  }
+
+  return acc;
+};
+/**
+ * Simple utility function to get the output of an array of Pools or Pairs
+ * @param pools
+ * @param firstInputToken
+ * @returns the output token of the last pool in the array
+ */
+
+var getOutputOfPools = function getOutputOfPools(pools, firstInputToken) {
+  var _pools$reduce = pools.reduce(function (_ref, pool) {
+    var inputToken = _ref.inputToken;
+    if (!pool.involvesToken(inputToken)) throw new Error('PATH');
+    var outputToken = pool.token0.equals(inputToken) ? pool.token1 : pool.token0;
+    return {
+      inputToken: outputToken
+    };
+  }, {
+    inputToken: firstInputToken
+  }),
+      outputToken = _pools$reduce.inputToken;
+
+  return outputToken;
+};
+
 var ZERO$1 = /*#__PURE__*/JSBI.BigInt(0);
+var REFUND_ETH_PRICE_IMPACT_THRESHOLD = /*#__PURE__*/new sdkCore.Percent( /*#__PURE__*/JSBI.BigInt(50), /*#__PURE__*/JSBI.BigInt(100));
 /**
  * Represents the Uniswap V2 + V3 SwapRouter02, and has static methods for helping execute trades.
  */
@@ -1474,6 +2370,15 @@ var SwapRouter = /*#__PURE__*/function () {
    * Cannot be constructed.
    */
   function SwapRouter() {}
+  /**
+   * @notice Generates the calldata for a Swap with a V2 Route.
+   * @param trade The V2Trade to encode.
+   * @param options SwapOptions to use for the trade.
+   * @param routerMustCustody Flag for whether funds should be sent to the router
+   * @param performAggregatedSlippageCheck Flag for whether we want to perform an aggregated slippage check
+   * @returns A string array of calldatas for the trade.
+   */
+
 
   SwapRouter.encodeV2Swap = function encodeV2Swap(trade, options, routerMustCustody, performAggregatedSlippageCheck) {
     var amountIn = v3Sdk.toHex(trade.maximumAmountIn(options.slippageTolerance).quotient);
@@ -1490,7 +2395,16 @@ var SwapRouter = /*#__PURE__*/function () {
       var exactOutputParams = [amountOut, amountIn, path, recipient];
       return SwapRouter.INTERFACE.encodeFunctionData('swapTokensForExactTokens', exactOutputParams);
     }
-  };
+  }
+  /**
+   * @notice Generates the calldata for a Swap with a V3 Route.
+   * @param trade The V3Trade to encode.
+   * @param options SwapOptions to use for the trade.
+   * @param routerMustCustody Flag for whether funds should be sent to the router
+   * @param performAggregatedSlippageCheck Flag for whether we want to perform an aggregated slippage check
+   * @returns A string array of calldatas for the trade.
+   */
+  ;
 
   SwapRouter.encodeV3Swap = function encodeV3Swap(trade, options, routerMustCustody, performAggregatedSlippageCheck) {
     var calldatas = [];
@@ -1553,36 +2467,145 @@ var SwapRouter = /*#__PURE__*/function () {
       }
     }
 
+    return calldatas;
+  }
+  /**
+   * @notice Generates the calldata for a MixedRouteSwap. Since single hop routes are not MixedRoutes, we will instead generate
+   *         them via the existing encodeV3Swap and encodeV2Swap methods.
+   * @param trade The MixedRouteTrade to encode.
+   * @param options SwapOptions to use for the trade.
+   * @param routerMustCustody Flag for whether funds should be sent to the router
+   * @param performAggregatedSlippageCheck Flag for whether we want to perform an aggregated slippage check
+   * @returns A string array of calldatas for the trade.
+   */
+  ;
+
+  SwapRouter.encodeMixedRouteSwap = function encodeMixedRouteSwap(trade, options, routerMustCustody, performAggregatedSlippageCheck) {
+    var calldatas = [];
+    !(trade.tradeType === sdkCore.TradeType.EXACT_INPUT) ?  invariant(false, 'TRADE_TYPE')  : void 0;
+
+    for (var _iterator2 = _createForOfIteratorHelperLoose(trade.swaps), _step2; !(_step2 = _iterator2()).done;) {
+      var _step2$value = _step2.value,
+          route = _step2$value.route,
+          inputAmount = _step2$value.inputAmount,
+          outputAmount = _step2$value.outputAmount;
+      var amountIn = v3Sdk.toHex(trade.maximumAmountIn(options.slippageTolerance, inputAmount).quotient);
+      var amountOut = v3Sdk.toHex(trade.minimumAmountOut(options.slippageTolerance, outputAmount).quotient); // flag for whether the trade is single hop or not
+
+      var singleHop = route.pools.length === 1;
+      var recipient = routerMustCustody ? ADDRESS_THIS : typeof options.recipient === 'undefined' ? MSG_SENDER : sdkCore.validateAndParseAddress(options.recipient);
+
+      var mixedRouteIsAllV3 = function mixedRouteIsAllV3(route) {
+        return route.pools.every(function (pool) {
+          return pool instanceof v3Sdk.Pool;
+        });
+      };
+
+      if (singleHop) {
+        /// For single hop, since it isn't really a mixedRoute, we'll just mimic behavior of V3 or V2
+        /// We don't use encodeV3Swap() or encodeV2Swap() because casting the trade to a V3Trade or V2Trade is overcomplex
+        if (mixedRouteIsAllV3(route)) {
+          var exactInputSingleParams = {
+            tokenIn: route.path[0].address,
+            tokenOut: route.path[1].address,
+            fee: route.pools[0].fee,
+            recipient: recipient,
+            amountIn: amountIn,
+            amountOutMinimum: performAggregatedSlippageCheck ? 0 : amountOut,
+            sqrtPriceLimitX96: 0
+          };
+          calldatas.push(SwapRouter.INTERFACE.encodeFunctionData('exactInputSingle', [exactInputSingleParams]));
+        } else {
+          var path = route.path.map(function (token) {
+            return token.address;
+          });
+          var exactInputParams = [amountIn, performAggregatedSlippageCheck ? 0 : amountOut, path, recipient];
+          calldatas.push(SwapRouter.INTERFACE.encodeFunctionData('swapExactTokensForTokens', exactInputParams));
+        }
+      } else {
+        (function () {
+          var sections = partitionMixedRouteByProtocol(route);
+
+          var isLastSectionInRoute = function isLastSectionInRoute(i) {
+            return i === sections.length - 1;
+          };
+
+          var outputToken = void 0;
+          var inputToken = route.input.wrapped;
+
+          for (var i = 0; i < sections.length; i++) {
+            var section = sections[i]; /// Now, we get output of this section
+
+            outputToken = getOutputOfPools(section, inputToken);
+            var newRouteOriginal = new MixedRouteSDK([].concat(section), section[0].token0.equals(inputToken) ? section[0].token0 : section[0].token1, outputToken);
+            var newRoute = new MixedRoute(newRouteOriginal); /// Previous output is now input
+
+            inputToken = outputToken;
+
+            if (mixedRouteIsAllV3(newRoute)) {
+              var _path = encodeMixedRouteToPath(newRoute);
+
+              var _exactInputParams = {
+                path: _path,
+                // By default router holds funds until the last swap, then it is sent to the recipient
+                // special case exists where we are unwrapping WETH output, in which case `routerMustCustody` is set to true
+                // and router still holds the funds. That logic bundled into how the value of `recipient` is calculated
+                recipient: isLastSectionInRoute(i) ? recipient : ADDRESS_THIS,
+                amountIn: i == 0 ? amountIn : 0,
+                amountOutMinimum: !isLastSectionInRoute(i) ? 0 : amountOut
+              };
+              calldatas.push(SwapRouter.INTERFACE.encodeFunctionData('exactInput', [_exactInputParams]));
+            } else {
+              var _exactInputParams2 = [i == 0 ? amountIn : 0, !isLastSectionInRoute(i) ? 0 : amountOut, newRoute.path.map(function (token) {
+                return token.address;
+              }), isLastSectionInRoute(i) ? recipient : ADDRESS_THIS];
+              calldatas.push(SwapRouter.INTERFACE.encodeFunctionData('swapExactTokensForTokens', _exactInputParams2));
+            }
+          }
+        })();
+      }
+    }
+
     return calldatas;
   };
 
   SwapRouter.encodeSwaps = function encodeSwaps(trades, options, isSwapAndAdd) {
-    // If dealing with an instance of the aggregated Trade object, unbundle it to individual V2Trade and V3Trade objects.
+    // If dealing with an instance of the aggregated Trade object, unbundle it to individual trade objects.
     if (trades instanceof Trade) {
       !trades.swaps.every(function (swap) {
-        return swap.route.protocol == exports.Protocol.V3 || swap.route.protocol == exports.Protocol.V2;
+        return swap.route.protocol == exports.Protocol.V3 || swap.route.protocol == exports.Protocol.V2 || swap.route.protocol == exports.Protocol.MIXED;
       }) ?  invariant(false, 'UNSUPPORTED_PROTOCOL')  : void 0;
-      var v2Andv3Trades = [];
+      var individualTrades = [];
 
-      for (var _iterator2 = _createForOfIteratorHelperLoose(trades.swaps), _step2; !(_step2 = _iterator2()).done;) {
-        var _step2$value = _step2.value,
-            route = _step2$value.route,
-            inputAmount = _step2$value.inputAmount,
-            outputAmount = _step2$value.outputAmount;
+      for (var _iterator3 = _createForOfIteratorHelperLoose(trades.swaps), _step3; !(_step3 = _iterator3()).done;) {
+        var _step3$value = _step3.value,
+            route = _step3$value.route,
+            inputAmount = _step3$value.inputAmount,
+            outputAmount = _step3$value.outputAmount;
 
         if (route.protocol == exports.Protocol.V2) {
-          v2Andv3Trades.push(new v2Sdk.Trade(route, trades.tradeType == sdkCore.TradeType.EXACT_INPUT ? inputAmount : outputAmount, trades.tradeType));
+          individualTrades.push(new v2Sdk.Trade(route, trades.tradeType == sdkCore.TradeType.EXACT_INPUT ? inputAmount : outputAmount, trades.tradeType));
         } else if (route.protocol == exports.Protocol.V3) {
-          v2Andv3Trades.push(v3Sdk.Trade.createUncheckedTrade({
+          individualTrades.push(v3Sdk.Trade.createUncheckedTrade({
+            route: route,
+            inputAmount: inputAmount,
+            outputAmount: outputAmount,
+            tradeType: trades.tradeType
+          }));
+        } else if (route.protocol == exports.Protocol.MIXED) {
+          individualTrades.push( /// we can change the naming of this function on MixedRouteTrade if needed
+          MixedRouteTrade.createUncheckedTrade({
             route: route,
             inputAmount: inputAmount,
             outputAmount: outputAmount,
             tradeType: trades.tradeType
           }));
+        } else {
+          throw new Error('UNSUPPORTED_TRADE_PROTOCOL');
         }
       }
 
-      trades = v2Andv3Trades;
+      trades = individualTrades;
     }
 
     if (!Array.isArray(trades)) {
@@ -1590,7 +2613,7 @@ var SwapRouter = /*#__PURE__*/function () {
     }
 
     var numberOfTrades = trades.reduce(function (numberOfTrades, trade) {
-      return numberOfTrades + (trade instanceof v3Sdk.Trade ? trade.swaps.length : 1);
+      return numberOfTrades + (trade instanceof v3Sdk.Trade || trade instanceof MixedRouteTrade ? trade.swaps.length : 1);
     }, 0);
     var sampleTrade = trades[0]; // All trades should have the same starting/ending currency and trade type
 
@@ -1623,16 +2646,23 @@ var SwapRouter = /*#__PURE__*/function () {
       calldatas.push(v3Sdk.SelfPermit.encodePermit(sampleTrade.inputAmount.currency, options.inputTokenPermit));
     }
 
-    for (var _iterator3 = _createForOfIteratorHelperLoose(trades), _step3; !(_step3 = _iterator3()).done;) {
-      var trade = _step3.value;
+    for (var _iterator4 = _createForOfIteratorHelperLoose(trades), _step4; !(_step4 = _iterator4()).done;) {
+      var trade = _step4.value;
 
       if (trade instanceof v2Sdk.Trade) {
         calldatas.push(SwapRouter.encodeV2Swap(trade, options, routerMustCustody, performAggregatedSlippageCheck));
-      } else {
-        for (var _iterator4 = _createForOfIteratorHelperLoose(SwapRouter.encodeV3Swap(trade, options, routerMustCustody, performAggregatedSlippageCheck)), _step4; !(_step4 = _iterator4()).done;) {
-          var calldata = _step4.value;
+      } else if (trade instanceof v3Sdk.Trade) {
+        for (var _iterator5 = _createForOfIteratorHelperLoose(SwapRouter.encodeV3Swap(trade, options, routerMustCustody, performAggregatedSlippageCheck)), _step5; !(_step5 = _iterator5()).done;) {
+          var calldata = _step5.value;
           calldatas.push(calldata);
         }
+      } else if (trade instanceof MixedRouteTrade) {
+        for (var _iterator6 = _createForOfIteratorHelperLoose(SwapRouter.encodeMixedRouteSwap(trade, options, routerMustCustody, performAggregatedSlippageCheck)), _step6; !(_step6 = _iterator6()).done;) {
+          var _calldata = _step6.value;
+          calldatas.push(_calldata);
+        }
+      } else {
+        throw new Error('Unsupported trade object');
       }
     }
 
@@ -1660,7 +2690,7 @@ var SwapRouter = /*#__PURE__*/function () {
   }
   /**
    * Produces the on-chain method name to call and the hex encoded parameters to pass as arguments for a given trade.
-   * @param trade to produce call parameters for
+   * @param trades to produce call parameters for
    * @param options options for the call parameters
    */
   ;
@@ -1682,10 +2712,11 @@ var SwapRouter = /*#__PURE__*/function () {
       } else {
         calldatas.push(PaymentsExtended.encodeSweepToken(sampleTrade.outputAmount.currency.wrapped, minimumAmountOut.quotient, options.recipient, options.fee));
       }
-    } // must refund when paying in ETH, but with an uncertain input amount
+    } // must refund when paying in ETH: either with an uncertain input amount OR if there's a chance of a partial fill.
+    // unlike ERC20's, the full ETH value must be sent in the transaction, so the rest must be refunded.
 
 
-    if (inputIsNative && sampleTrade.tradeType === sdkCore.TradeType.EXACT_OUTPUT) {
+    if (inputIsNative && (sampleTrade.tradeType === sdkCore.TradeType.EXACT_OUTPUT || SwapRouter.riskOfPartialFill(trades))) {
       calldatas.push(v3Sdk.Payments.encodeRefundETH());
     }
 
@@ -1696,7 +2727,7 @@ var SwapRouter = /*#__PURE__*/function () {
   }
   /**
    * Produces the on-chain method name to call and the hex encoded parameters to pass as arguments for a given trade.
-   * @param trade to produce call parameters for
+   * @param trades to produce call parameters for
    * @param options options for the call parameters
    */
   ;
@@ -1770,6 +2801,21 @@ var SwapRouter = /*#__PURE__*/function () {
       calldata: MulticallExtended.encodeMulticall(calldatas, options.deadlineOrPreviousBlockhash),
       value: value.toString()
     };
+  } // if price impact is very high, there's a chance of hitting max/min prices resulting in a partial fill of the swap
+  ;
+
+  SwapRouter.riskOfPartialFill = function riskOfPartialFill(trades) {
+    if (Array.isArray(trades)) {
+      return trades.some(function (trade) {
+        return SwapRouter.v3TradeWithHighPriceImpact(trade);
+      });
+    } else {
+      return SwapRouter.v3TradeWithHighPriceImpact(trades);
+    }
+  };
+
+  SwapRouter.v3TradeWithHighPriceImpact = function v3TradeWithHighPriceImpact(trade) {
+    return !(trade instanceof v2Sdk.Trade) && trade.priceImpact.greaterThan(REFUND_ETH_PRICE_IMPACT_THRESHOLD);
   };
 
   SwapRouter.getPositionAmounts = function getPositionAmounts(position, zeroForOne) {
@@ -1796,6 +2842,8 @@ SwapRouter.INTERFACE = /*#__PURE__*/new abi.Interface(ISwapRouter02_json.abi);
 exports.ADDRESS_THIS = ADDRESS_THIS;
 exports.ApproveAndCall = ApproveAndCall;
 exports.MSG_SENDER = MSG_SENDER;
+exports.MixedRoute = MixedRoute;
+exports.MixedRouteSDK = MixedRouteSDK;
 exports.MulticallExtended = MulticallExtended;
 exports.ONE = ONE;
 exports.PaymentsExtended = PaymentsExtended;
@@ -1803,6 +2851,10 @@ exports.RouteV2 = RouteV2;
 exports.RouteV3 = RouteV3;
 exports.SwapRouter = SwapRouter;
 exports.Trade = Trade;
+exports.V2_FEE_PATH_PLACEHOLDER = V2_FEE_PATH_PLACEHOLDER;
 exports.ZERO = ZERO;
+exports.encodeMixedRouteToPath = encodeMixedRouteToPath;
+exports.getOutputOfPools = getOutputOfPools;
 exports.isMint = isMint;
+exports.partitionMixedRouteByProtocol = partitionMixedRouteByProtocol;
 //# sourceMappingURL=router-sdk.cjs.development.js.map