@kittycorn-labs/universal-router-sdk 1.4.42 → 2.0.0

package/dist/cjs/src/entities/actions/uniswap.js

@@ -0,0 +1,740 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UniswapTrade = exports.TokenTransferMode = exports.MAX_FEE_RECIPIENTS = void 0;
+const tslib_1 = require("tslib");
+const v4_sdk_1 = require("@kittycorn-labs/v4-sdk");
+const tiny_invariant_1 = tslib_1.__importDefault(require("tiny-invariant"));
+const routerCommands_1 = require("../../utils/routerCommands");
+const v2_sdk_1 = require("@kittycorn-labs/v2-sdk");
+const v3_sdk_1 = require("@kittycorn-labs/v3-sdk");
+const v4_sdk_2 = require("@kittycorn-labs/v4-sdk");
+const router_sdk_1 = require("@kittycorn-labs/router-sdk");
+const pathCurrency_1 = require("../../utils/pathCurrency");
+const toV4URVersion_1 = require("../../utils/toV4URVersion");
+const sdk_core_1 = require("@kittycorn-labs/sdk-core");
+const Command_1 = require("../Command");
+const constants_1 = require("../../utils/constants");
+const getCurrencyAddress_1 = require("../../utils/getCurrencyAddress");
+const numbers_1 = require("../../utils/numbers");
+const portionFees_1 = require("../../utils/portionFees");
+const bignumber_1 = require("@ethersproject/bignumber");
+// A product decision (interface + partner + integrator + referrer), not a protocol limit; each recipient costs one command.
+exports.MAX_FEE_RECIPIENTS = 4;
+// the existing router permit object doesn't include enough data for permit2
+// so we extend swap options with the permit2 permit
+// when safe mode is enabled, the SDK will add an extra ETH sweep for security
+// when useRouterBalance is enabled the SDK will use the balance in the router for the swap
+var TokenTransferMode;
+(function (TokenTransferMode) {
+    TokenTransferMode["Permit2"] = "Permit2";
+    TokenTransferMode["ApproveProxy"] = "ApproveProxy";
+})(TokenTransferMode = exports.TokenTransferMode || (exports.TokenTransferMode = {}));
+const REFUND_ETH_PRICE_IMPACT_THRESHOLD = new sdk_core_1.Percent(50, 100);
+// The amount encoded for a route's FIRST hop. With routerBalanceInput the router spends
+// whatever it holds at execution time, so the quoted amount is replaced by the
+// CONTRACT_BALANCE sentinel; later hops already use it to chain the intermediate token.
+function firstHopInputAmount(options, quotedAmountIn) {
+    return options.routerBalanceInput ? constants_1.CONTRACT_BALANCE : quotedAmountIn;
+}
+// Wrapper for uniswap router-sdk trade entity to encode swaps for Universal Router
+// also translates trade objects from previous (v2, v3) SDKs
+class UniswapTrade {
+    constructor(trade, options) {
+        this.trade = trade;
+        this.options = options;
+        this.tradeType = Command_1.RouterActionType.UniswapTrade;
+        if (trade.swaps.some(({ route }) => route.pools.some(pool => pool instanceof v4_sdk_2.Pool && (0, v4_sdk_1.isTokenizeConversion)(pool)))) {
+            throw new Error('Tokenize conversions require buildKittycornUniversalMethodParameters');
+        }
+        if (Array.isArray(options.fee)) {
+            // An empty array would still make the router custody the output while paying nobody.
+            if (options.fee.length === 0)
+                throw new Error('At least one fee recipient required');
+            if (options.fee.length > exports.MAX_FEE_RECIPIENTS) {
+                throw new Error(`At most ${exports.MAX_FEE_RECIPIENTS} fee recipients permitted`);
+            }
+        }
+        if (!!options.fee && !!options.flatFee)
+            throw new Error('Only one fee option permitted');
+        if (options.nativeErc20Input) {
+            // input token is the chain's native gas token exposed via an ERC20 predeploy (e.g. Arc USDC);
+            // the router is funded by msg.value instead of Permit2, so it pays pools from its own balance
+            if (this.trade.inputAmount.currency.isNative)
+                throw new Error('nativeErc20Input requires an ERC20 input token');
+            if (options.tokenTransferMode === TokenTransferMode.ApproveProxy) {
+                throw new Error('nativeErc20Input is not supported with ApproveProxy');
+            }
+            if (options.inputTokenPermit)
+                throw new Error('nativeErc20Input does not use Permit2; remove inputTokenPermit');
+            if (this.inputRequiresUnwrap) {
+                throw new Error('nativeErc20Input requires routes quoted against the ERC20 input (native pathInput unsupported)');
+            }
+        }
+        if (options.routerBalanceInput) {
+            // The router spends a balance a third party funded in the same transaction, so the
+            // amount is unknown at encode time and msg.sender is the funder, not the beneficiary.
+            if (!options.recipient || options.recipient === constants_1.SENDER_AS_RECIPIENT) {
+                throw new Error('Explicit recipient address required with routerBalanceInput (SENDER_AS_RECIPIENT resolves to the caller, who is not the swapper)');
+            }
+            // The Dispatcher maps recipient sentinels: address(2) resolves to the router itself —
+            // unwrapWETH9 then skips the transfer and a native-out execute() SUCCEEDS with the
+            // ETH stranded in the permissionless router — and address(0) burns. Both are
+            // format-valid addresses, so upstream shape checks pass them straight through.
+            if (options.recipient === constants_1.ROUTER_AS_RECIPIENT || bignumber_1.BigNumber.from(options.recipient).isZero()) {
+                throw new Error('routerBalanceInput recipient cannot be a UR sentinel or the zero address');
+            }
+            // Native input is funded as msg.value on execute() — raw transfers to the router
+            // revert (its receive() only accepts ETH from WETH) — and wrapped in full by the
+            // route's WRAP_ETH. Routes that consume native directly (pure-native v4) have no
+            // wrap step to size with CONTRACT_BALANCE, so they stay unsupported.
+            if (this.trade.inputAmount.currency.isNative && !this.inputRequiresWrap) {
+                throw new Error('routerBalanceInput with a native input requires a route that wraps to WETH');
+            }
+            if (this.trade.tradeType !== sdk_core_1.TradeType.EXACT_INPUT) {
+                throw new Error('routerBalanceInput requires TradeType.EXACT_INPUT');
+            }
+            // Split routes: CONTRACT_BALANCE resolves to the router's whole balance,
+            // so exactly ONE leg (the largest, encoded last) spends it; the other
+            // legs keep their quoted amounts from router custody. With a native
+            // input every leg must consume the wrapped token, since the single
+            // WRAP_ETH funds them all.
+            if (this.trade.swaps.length > 1 &&
+                this.trade.inputAmount.currency.isNative &&
+                this.trade.swaps.some((swap) => { var _a; return (_a = swap.route.pathInput) === null || _a === void 0 ? void 0 : _a.isNative; })) {
+                throw new Error('routerBalanceInput split routes with a native input require every leg to wrap to WETH');
+            }
+            // A WETH input whose route unwraps: UNWRAP_WETH takes the router's whole WETH
+            // balance, so it is the greedy claim and every leg must consume the resulting
+            // native currency. Checked across all legs rather than via inputRequiresUnwrap,
+            // which only inspects leg 0 and so depends on leg order.
+            if (!this.trade.inputAmount.currency.isNative && this.trade.swaps.length > 1) {
+                const nativeLegs = this.trade.swaps.filter((swap) => { var _a; return (_a = swap.route.pathInput) === null || _a === void 0 ? void 0 : _a.isNative; }).length;
+                if (nativeLegs > 0 && nativeLegs < this.trade.swaps.length) {
+                    throw new Error('routerBalanceInput with an unwrapped input requires every leg to consume native');
+                }
+            }
+            if (options.inputTokenPermit) {
+                throw new Error('routerBalanceInput does not use Permit2; remove inputTokenPermit');
+            }
+            if (options.nativeErc20Input) {
+                throw new Error('routerBalanceInput is not supported with nativeErc20Input');
+            }
+            if (options.tokenTransferMode === TokenTransferMode.ApproveProxy) {
+                throw new Error('routerBalanceInput is not supported with ApproveProxy');
+            }
+            if (options.routerBalanceInput.minimumAmount !== undefined && !options.chainId) {
+                throw new Error('routerBalanceInput.minimumAmount requires chainId to resolve the router address');
+            }
+        }
+        if (options.tokenTransferMode === TokenTransferMode.ApproveProxy) {
+            if (!options.recipient || options.recipient === constants_1.SENDER_AS_RECIPIENT) {
+                throw new Error('Explicit recipient address required when using SwapProxy (SENDER_AS_RECIPIENT resolves to proxy)');
+            }
+            this.payerIsUser = false;
+        }
+        else if (this.inputRequiresWrap ||
+            this.inputRequiresUnwrap ||
+            this.options.useRouterBalance ||
+            this.options.nativeErc20Input ||
+            this.options.routerBalanceInput) {
+            this.payerIsUser = false;
+        }
+        else {
+            this.payerIsUser = true;
+        }
+    }
+    get isAllV4() {
+        let result = true;
+        for (const swap of this.trade.swaps) {
+            result = result && swap.route.protocol == router_sdk_1.Protocol.V4;
+        }
+        return result;
+    }
+    // this.trade.swaps is an array of swaps / trades.
+    // we are iterating over one swap (trade) at a time so length is 1
+    // route is either v2, v3, v4, or mixed
+    // pathInput and pathOutput are the currencies of the input and output of the route
+    // this.trade.inputAmount is the input currency of the trade (could be different from pathInput)
+    // this.trade.outputAmount is the output currency of the trade (could be different from pathOutput)
+    // each route can have multiple pools
+    get inputRequiresWrap() {
+        const swap = this.trade.swaps[0];
+        const route = swap.route;
+        const firstPool = route.pools[0];
+        if (firstPool instanceof v4_sdk_2.Pool) {
+            // If first pool is a v4 pool and input currency is native and the path input currency in the route is not native, we need to wrap.
+            return (this.trade.inputAmount.currency.isNative &&
+                !this.trade.swaps[0].route.pathInput.isNative);
+        }
+        // If first pool is not a v4 pool and input currency is native, we need to wrap
+        return this.trade.inputAmount.currency.isNative;
+    }
+    get inputRequiresUnwrap() {
+        const swap = this.trade.swaps[0];
+        const route = swap.route;
+        const firstPool = route.pools[0];
+        if (firstPool instanceof v4_sdk_2.Pool) {
+            // If the first pool is a v4 pool and input currency is not native and the path input currency is native, we need to unwrap
+            return (!this.trade.inputAmount.currency.isNative &&
+                this.trade.swaps[0].route.pathInput.isNative);
+        }
+        // If the first pool is not a v4 pool, we don't need to unwrap.
+        return false;
+    }
+    get outputRequiresWrap() {
+        const swap = this.trade.swaps[0];
+        const lastRoute = swap.route;
+        const lastPool = lastRoute.pools[lastRoute.pools.length - 1];
+        // if last pool is v4:
+        if (lastPool instanceof v4_sdk_2.Pool) {
+            // If output currency is not native but path currency output is native, we need to wrap
+            if (!this.trade.outputAmount.currency.isNative) {
+                if (lastRoute.pathOutput.isNative) {
+                    // this means path output is native and we need to wrap
+                    return true;
+                }
+                else if (lastPool.currency1.equals(lastPool.currency0.wrapped) && lastRoute.pools.length > 1) {
+                    let poolBefore = lastRoute.pools[lastRoute.pools.length - 2];
+                    // this means last pool is eth-weth and pool before contains weth
+                    if (poolBefore instanceof v4_sdk_2.Pool &&
+                        (poolBefore.currency0.equals(lastPool.currency1) || poolBefore.currency1.equals(lastPool.currency1))) {
+                        return true;
+                    }
+                    else if (poolBefore.token0.equals(lastPool.currency1) || poolBefore.token1.equals(lastPool.currency1)) {
+                        // same for v2 and v3 pools
+                        return true;
+                    }
+                }
+            }
+        }
+        // if last pool is not v4:
+        // we do not need to wrap because v2 and v3 pools already require wrapped tokens
+        return false;
+    }
+    get outputRequiresUnwrap() {
+        const swap = this.trade.swaps[0];
+        const lastRoute = swap.route;
+        const lastPool = lastRoute.pools[lastRoute.pools.length - 1];
+        // if last pool is v4:
+        if (lastPool instanceof v4_sdk_2.Pool) {
+            // If output currency is native and path currency output is not native, we need to unwrap
+            if (this.trade.outputAmount.currency.isNative) {
+                if (!this.trade.swaps[0].route.pathOutput.isNative) {
+                    // this means path output is weth and we need to unwrap
+                    return true;
+                }
+                else if (lastRoute.pools.length > 1 &&
+                    lastRoute.pools[lastRoute.pools.length - 2] instanceof v4_sdk_2.Pool &&
+                    lastRoute.pools[lastRoute.pools.length - 2].currency0.isNative &&
+                    lastPool.currency1.equals(lastPool.currency0.wrapped)) {
+                    // this means last pool is eth-weth and we need to unwrap
+                    return true;
+                }
+                else {
+                    return false;
+                }
+            }
+        }
+        // else: if path output currency is native, we need to unwrap because v2 and v3 pools already require wrapped tokens
+        return this.trade.outputAmount.currency.isNative;
+    }
+    get outputRequiresTransition() {
+        return this.outputRequiresWrap || this.outputRequiresUnwrap;
+    }
+    encode(planner, _config) {
+        var _a, _b, _c, _d;
+        // Input floor first, so an under-funded router reverts before any swap runs. A native
+        // balance input has no balance-check command, so its floor is asserted post-wrap as WETH.
+        const balanceInputIsNative = !!this.options.routerBalanceInput && this.trade.inputAmount.currency.isNative;
+        const minimumRouterBalance = (_a = this.options.routerBalanceInput) === null || _a === void 0 ? void 0 : _a.minimumAmount;
+        if (minimumRouterBalance !== undefined && !balanceInputIsNative) {
+            // BALANCE_CHECK_ERC20 reads `owner` verbatim, without the sentinel resolution the
+            // recipient params get, so this must be the router's real address.
+            planner.addCommand(routerCommands_1.CommandType.BALANCE_CHECK_ERC20, [
+                (0, constants_1.UNIVERSAL_ROUTER_ADDRESS)((_b = this.options.urVersion) !== null && _b !== void 0 ? _b : constants_1.UniversalRouterVersion.V2_0, this.options.chainId),
+                this.trade.inputAmount.currency.address,
+                minimumRouterBalance,
+            ]);
+        }
+        // If the input currency is the native currency, we need to wrap it with the router as the recipient
+        if (this.inputRequiresWrap) {
+            // TODO: optimize if only one v2 pool we can directly send this to the pool
+            planner.addCommand(routerCommands_1.CommandType.WRAP_ETH, [
+                constants_1.ROUTER_AS_RECIPIENT,
+                // Balance input: wrap everything the router holds (attached msg.value plus any
+                // stray native), so no value is left behind — UR never refunds msg.value.
+                this.options.routerBalanceInput
+                    ? constants_1.CONTRACT_BALANCE
+                    : this.trade.maximumAmountIn(this.options.slippageTolerance).quotient.toString(),
+            ]);
+            if (minimumRouterBalance !== undefined && balanceInputIsNative) {
+                planner.addCommand(routerCommands_1.CommandType.BALANCE_CHECK_ERC20, [
+                    (0, constants_1.UNIVERSAL_ROUTER_ADDRESS)((_c = this.options.urVersion) !== null && _c !== void 0 ? _c : constants_1.UniversalRouterVersion.V2_0, this.options.chainId),
+                    this.trade.inputAmount.currency.wrapped.address,
+                    minimumRouterBalance,
+                ]);
+            }
+        }
+        else if (this.inputRequiresUnwrap) {
+            // Balance input: the WETH is already in the router and msg.sender is the funder,
+            // not the swapper — pulling from them would spend the filler's own tokens.
+            if (this.options.tokenTransferMode !== TokenTransferMode.ApproveProxy && !this.options.routerBalanceInput) {
+                // send wrapped token to router to unwrap via Permit2
+                planner.addCommand(routerCommands_1.CommandType.PERMIT2_TRANSFER_FROM, [
+                    this.trade.inputAmount.currency.address,
+                    constants_1.ROUTER_AS_RECIPIENT,
+                    this.trade.maximumAmountIn(this.options.slippageTolerance).quotient.toString(),
+                ]);
+            }
+            // In proxy mode, the proxy already transferred tokens to the UR; just unwrap
+            planner.addCommand(routerCommands_1.CommandType.UNWRAP_WETH, [constants_1.ROUTER_AS_RECIPIENT, 0]);
+        }
+        // The overall recipient at the end of the trade, SENDER_AS_RECIPIENT uses the msg.sender
+        this.options.recipient = (_d = this.options.recipient) !== null && _d !== void 0 ? _d : constants_1.SENDER_AS_RECIPIENT;
+        // flag for whether we want to perform slippage check on aggregate output of multiple routes
+        //   1. when there are >2 exact input trades. this is only a heuristic,
+        //      as it's still more gas-expensive even in this case, but has benefits
+        //      in that the reversion probability is lower
+        const performAggregatedSlippageCheck = this.trade.tradeType === sdk_core_1.TradeType.EXACT_INPUT && this.trade.routes.length > 2;
+        // v2SwapExactOutput only bounds amountIn and forwards whatever the pair actually produced, so a
+        // V2 exact-out leg paying the recipient directly has no output check. V3 (V3InvalidAmountOut)
+        // and V4 (exact TAKE) legs assert their own output; V2 legs need custody + a floored SWEEP.
+        const v2ExactOutputNeedsFloor = this.trade.tradeType === sdk_core_1.TradeType.EXACT_OUTPUT &&
+            this.trade.routes.some((route) => route.pools.some((pool) => pool instanceof v2_sdk_1.Pair));
+        const routerMustCustody = performAggregatedSlippageCheck ||
+            this.outputRequiresTransition ||
+            hasFeeOption(this.options) ||
+            // Balance-swap splits: the remainder leg's output varies with delivery,
+            // so the minimum is enforced on the aggregate sweep, never per leg.
+            (!!this.options.routerBalanceInput && this.trade.swaps.length > 1) ||
+            v2ExactOutputNeedsFloor;
+        // Balance-swap splits: the fixed legs run first with their quoted amounts
+        // (per-leg options drop routerBalanceInput, so they encode normally from
+        // router custody); the largest leg runs LAST and spends CONTRACT_BALANCE,
+        // absorbing all delivery variance. The fill only reverts when delivery
+        // cannot cover the fixed legs, so the tolerance is the largest leg's share.
+        let swapsInOrder = this.trade.swaps;
+        let remainderSwap;
+        if (this.options.routerBalanceInput && swapsInOrder.length > 1) {
+            remainderSwap = swapsInOrder.reduce((largest, swap) => swap.inputAmount.greaterThan(largest.inputAmount) ? swap : largest);
+            swapsInOrder = [...swapsInOrder.filter((swap) => swap !== remainderSwap), remainderSwap];
+        }
+        for (const swap of swapsInOrder) {
+            const legOptions = remainderSwap !== undefined && swap !== remainderSwap
+                ? { ...this.options, routerBalanceInput: undefined }
+                : this.options;
+            switch (swap.route.protocol) {
+                case router_sdk_1.Protocol.V2:
+                    addV2Swap(planner, swap, this.trade.tradeType, legOptions, this.payerIsUser, routerMustCustody);
+                    break;
+                case router_sdk_1.Protocol.V3:
+                    addV3Swap(planner, swap, this.trade.tradeType, legOptions, this.payerIsUser, routerMustCustody);
+                    break;
+                case router_sdk_1.Protocol.V4:
+                    addV4Swap(planner, swap, this.trade.tradeType, legOptions, this.payerIsUser, routerMustCustody);
+                    break;
+                case router_sdk_1.Protocol.MIXED:
+                    addMixedSwap(planner, swap, this.trade.tradeType, legOptions, this.payerIsUser, routerMustCustody);
+                    break;
+                default:
+                    throw new Error('UNSUPPORTED_TRADE_PROTOCOL');
+            }
+        }
+        let minimumAmountOut = bignumber_1.BigNumber.from(this.trade.minimumAmountOut(this.options.slippageTolerance).quotient.toString());
+        // The router custodies for 3 reasons: to unwrap, to take a fee, and/or to do a slippage check
+        if (routerMustCustody) {
+            const pools = this.trade.swaps[0].route.pools;
+            const pathOutputCurrencyAddress = (0, getCurrencyAddress_1.getCurrencyAddress)((0, pathCurrency_1.getPathCurrency)(this.trade.outputAmount.currency, pools[pools.length - 1]));
+            // UR >= V2_1_1 has PAY_PORTION_FULL_PRECISION (1e18); older versions only bips.
+            const useFullPrecision = (0, constants_1.isAtLeastV2_1_1)(this.options.urVersion);
+            // If there is a fee, that percentage is sent to the fee recipient. One PAY_PORTION per
+            // recipient, emitted in the caller's order, ahead of the settlement command below.
+            // In the case where ETH is the output currency, the fee is taken in WETH (for gas reasons)
+            const feeList = toFeeOptionsList(this.options.fee);
+            // Rescaling gross fractions against a shrinking balance yields fractional bips, which PAY_PORTION cannot represent.
+            (0, tiny_invariant_1.default)(feeList.length <= 1 || useFullPrecision, 'Multiple fee recipients require Universal Router version V2_1_1 or higher');
+            // Rescales fee i to f_i / (1 - sum of earlier fees), so each recipient gets its stated fraction of gross.
+            const scaledFees = (0, portionFees_1.scalePortionFees)(feeList);
+            for (const { recipient, grossFee, scaledFee } of scaledFees) {
+                if (useFullPrecision) {
+                    planner.addCommand(routerCommands_1.CommandType.PAY_PORTION_FULL_PRECISION, [pathOutputCurrencyAddress, recipient, (0, numbers_1.encodeFee1e18)(scaledFee)], false, this.options.urVersion);
+                }
+                else {
+                    // Reject fractional bips fees on older UR versions to prevent silent precision loss
+                    if (!grossFee.multiply(10000).remainder.equalTo(0)) {
+                        throw new Error('Fractional fee bips require Universal Router version V2_1_1 or higher');
+                    }
+                    // single fee: scaled == gross, so the legacy bips encoding is unchanged
+                    planner.addCommand(routerCommands_1.CommandType.PAY_PORTION, [pathOutputCurrencyAddress, recipient, (0, numbers_1.encodeFeeBips)(grossFee)]);
+                }
+            }
+            // The sweep floor must expect what the commands leave behind, so the deduction replays their cascade.
+            let feeDeduction = (0, portionFees_1.simulatePortionFeeDeduction)(minimumAmountOut, scaledFees, useFullPrecision);
+            // If there is a flat fee, that absolute amount is sent to the fee recipient
+            // In the case where ETH is the output currency, the fee is taken in WETH (for gas reasons)
+            if (!!this.options.flatFee) {
+                const feeAmount = this.options.flatFee.amount;
+                if (minimumAmountOut.lt(feeAmount))
+                    throw new Error('Flat fee amount greater than minimumAmountOut');
+                planner.addCommand(routerCommands_1.CommandType.TRANSFER, [pathOutputCurrencyAddress, this.options.flatFee.recipient, feeAmount]);
+                feeDeduction = bignumber_1.BigNumber.from(feeAmount);
+            }
+            // If the trade is exact output, and a fee was taken, we must adjust the amount out to be the amount after the fee
+            // Otherwise we continue as expected with the trade's normal expected output
+            if (this.trade.tradeType === sdk_core_1.TradeType.EXACT_OUTPUT) {
+                minimumAmountOut = minimumAmountOut.sub(feeDeduction);
+            }
+            // The remaining tokens that need to be sent to the user after the fee is taken will be caught
+            // by this if-else clause.
+            if (this.outputRequiresUnwrap) {
+                planner.addCommand(routerCommands_1.CommandType.UNWRAP_WETH, [this.options.recipient, minimumAmountOut]);
+            }
+            else {
+                // Custodied legs are encoded with amountOutMinimum 0, so this SWEEP is the trade's only
+                // output check. WRAP_ETH has no minimum, so wrap into the router and let the SWEEP floor it.
+                if (this.outputRequiresWrap) {
+                    planner.addCommand(routerCommands_1.CommandType.WRAP_ETH, [constants_1.ROUTER_AS_RECIPIENT, constants_1.CONTRACT_BALANCE]);
+                }
+                planner.addCommand(routerCommands_1.CommandType.SWEEP, [
+                    (0, getCurrencyAddress_1.getCurrencyAddress)(this.trade.outputAmount.currency),
+                    this.options.recipient,
+                    minimumAmountOut,
+                ]);
+            }
+        }
+        // for exactOutput swaps with native input or that perform an inputToken transition (wrap or unwrap)
+        // we need to send back the change to the user
+        if (this.trade.tradeType === sdk_core_1.TradeType.EXACT_OUTPUT || riskOfPartialFill(this.trade)) {
+            if (this.inputRequiresWrap) {
+                planner.addCommand(routerCommands_1.CommandType.UNWRAP_WETH, [this.options.recipient, 0]);
+            }
+            else if (this.inputRequiresUnwrap) {
+                planner.addCommand(routerCommands_1.CommandType.WRAP_ETH, [this.options.recipient, constants_1.CONTRACT_BALANCE]);
+            }
+            else if (this.options.tokenTransferMode === TokenTransferMode.ApproveProxy) {
+                // Proxy pulled maximumAmountIn into the UR; sweep any unused input back to the user
+                planner.addCommand(routerCommands_1.CommandType.SWEEP, [
+                    (0, getCurrencyAddress_1.getCurrencyAddress)(this.trade.inputAmount.currency),
+                    this.options.recipient,
+                    0,
+                ]);
+            }
+            else if (this.options.nativeErc20Input || this.trade.inputAmount.currency.isNative) {
+                // must refund extra native currency sent along (nativeErc20Input or native v4 trades).
+                // For nativeErc20Input the leftover lives in the router's native balance (18 decimals), so
+                // sweep it as native: an ERC20 sweep would floor to the token's decimals and strand dust.
+                planner.addCommand(routerCommands_1.CommandType.SWEEP, [constants_1.ETH_ADDRESS, this.options.recipient, 0]);
+            }
+        }
+        // Native balance input always sweeps trailing ETH dust to the recipient: the funder is
+        // a third party, so anything left on the router would otherwise be stranded or swept
+        // by a stranger.
+        if (this.options.safeMode || (this.options.routerBalanceInput && this.trade.inputAmount.currency.isNative)) {
+            planner.addCommand(routerCommands_1.CommandType.SWEEP, [constants_1.ETH_ADDRESS, this.options.recipient, 0]);
+        }
+    }
+}
+exports.UniswapTrade = UniswapTrade;
+// encode a uniswap v2 swap
+function addV2Swap(planner, { route, inputAmount, outputAmount, minHopPriceX36 }, tradeType, options, payerIsUser, routerMustCustody) {
+    if ((minHopPriceX36 === null || minHopPriceX36 === void 0 ? void 0 : minHopPriceX36.length) && minHopPriceX36.length !== route.pools.length) {
+        throw new Error(`minHopPriceX36 length (${minHopPriceX36.length}) must equal route.pools.length (${route.pools.length})`);
+    }
+    const trade = new v2_sdk_1.Trade(route, tradeType == sdk_core_1.TradeType.EXACT_INPUT ? inputAmount : outputAmount, tradeType);
+    const useV2_1_1 = (0, constants_1.isAtLeastV2_1_1)(options.urVersion);
+    if (tradeType == sdk_core_1.TradeType.EXACT_INPUT) {
+        const params = [
+            // if native, we have to unwrap so keep in the router for now
+            routerMustCustody ? constants_1.ROUTER_AS_RECIPIENT : options.recipient,
+            firstHopInputAmount(options, trade.maximumAmountIn(options.slippageTolerance).quotient.toString()),
+            // if router will custody funds, we do aggregated slippage check from router
+            routerMustCustody ? 0 : trade.minimumAmountOut(options.slippageTolerance).quotient.toString(),
+            route.path.map((token) => token.wrapped.address),
+            payerIsUser,
+        ];
+        if (useV2_1_1)
+            params.push(minHopPriceX36 !== null && minHopPriceX36 !== void 0 ? minHopPriceX36 : []);
+        planner.addCommand(routerCommands_1.CommandType.V2_SWAP_EXACT_IN, params, false, options.urVersion);
+    }
+    else if (tradeType == sdk_core_1.TradeType.EXACT_OUTPUT) {
+        const params = [
+            routerMustCustody ? constants_1.ROUTER_AS_RECIPIENT : options.recipient,
+            trade.minimumAmountOut(options.slippageTolerance).quotient.toString(),
+            trade.maximumAmountIn(options.slippageTolerance).quotient.toString(),
+            route.path.map((token) => token.wrapped.address),
+            payerIsUser,
+        ];
+        if (useV2_1_1)
+            params.push(minHopPriceX36 !== null && minHopPriceX36 !== void 0 ? minHopPriceX36 : []);
+        planner.addCommand(routerCommands_1.CommandType.V2_SWAP_EXACT_OUT, params, false, options.urVersion);
+    }
+}
+// encode a uniswap v3 swap
+function addV3Swap(planner, { route, inputAmount, outputAmount, minHopPriceX36 }, tradeType, options, payerIsUser, routerMustCustody) {
+    if ((minHopPriceX36 === null || minHopPriceX36 === void 0 ? void 0 : minHopPriceX36.length) && minHopPriceX36.length !== route.pools.length) {
+        throw new Error(`minHopPriceX36 length (${minHopPriceX36.length}) must equal route.pools.length (${route.pools.length})`);
+    }
+    const trade = v3_sdk_1.Trade.createUncheckedTrade({
+        route: route,
+        inputAmount,
+        outputAmount,
+        tradeType,
+    });
+    const useV2_1_1 = (0, constants_1.isAtLeastV2_1_1)(options.urVersion);
+    const path = (0, v3_sdk_1.encodeRouteToPath)(route, trade.tradeType === sdk_core_1.TradeType.EXACT_OUTPUT);
+    if (tradeType == sdk_core_1.TradeType.EXACT_INPUT) {
+        const params = [
+            routerMustCustody ? constants_1.ROUTER_AS_RECIPIENT : options.recipient,
+            firstHopInputAmount(options, trade.maximumAmountIn(options.slippageTolerance).quotient.toString()),
+            routerMustCustody ? 0 : trade.minimumAmountOut(options.slippageTolerance).quotient.toString(),
+            path,
+            payerIsUser,
+        ];
+        if (useV2_1_1)
+            params.push(minHopPriceX36 !== null && minHopPriceX36 !== void 0 ? minHopPriceX36 : []);
+        planner.addCommand(routerCommands_1.CommandType.V3_SWAP_EXACT_IN, params, false, options.urVersion);
+    }
+    else if (tradeType == sdk_core_1.TradeType.EXACT_OUTPUT) {
+        const params = [
+            routerMustCustody ? constants_1.ROUTER_AS_RECIPIENT : options.recipient,
+            trade.minimumAmountOut(options.slippageTolerance).quotient.toString(),
+            trade.maximumAmountIn(options.slippageTolerance).quotient.toString(),
+            path,
+            payerIsUser,
+        ];
+        if (useV2_1_1)
+            params.push(minHopPriceX36 !== null && minHopPriceX36 !== void 0 ? minHopPriceX36 : []);
+        planner.addCommand(routerCommands_1.CommandType.V3_SWAP_EXACT_OUT, params, false, options.urVersion);
+    }
+}
+function addV4Swap(planner, { inputAmount, outputAmount, route, minHopPriceX36 }, tradeType, options, payerIsUser, routerMustCustody) {
+    var _a, _b;
+    if ((minHopPriceX36 === null || minHopPriceX36 === void 0 ? void 0 : minHopPriceX36.length) && minHopPriceX36.length !== route.pools.length) {
+        throw new Error(`minHopPriceX36 length (${minHopPriceX36.length}) must equal route.pools.length (${route.pools.length})`);
+    }
+    // create a deep copy of pools since v4Planner encoding tampers with array
+    const pools = route.pools.map((p) => p);
+    const v4Route = new v4_sdk_2.Route(pools, inputAmount.currency, outputAmount.currency);
+    const trade = v4_sdk_2.Trade.createUncheckedTrade({
+        route: v4Route,
+        inputAmount,
+        outputAmount,
+        tradeType,
+    });
+    const slippageToleranceOnSwap = routerMustCustody && tradeType == sdk_core_1.TradeType.EXACT_INPUT ? undefined : options.slippageTolerance;
+    const perHopSlippage = (_a = minHopPriceX36 === null || minHopPriceX36 === void 0 ? void 0 : minHopPriceX36.map((s) => bignumber_1.BigNumber.from(s))) !== null && _a !== void 0 ? _a : [];
+    const settleBeforeSwap = routeHasSettleBeforeSwapHook(pools, options.settleBeforeSwapHooks);
+    (0, tiny_invariant_1.default)(!settleBeforeSwap || tradeType === sdk_core_1.TradeType.EXACT_INPUT, 'SETTLE_BEFORE_SWAP_HOOK_EXACT_INPUT_ONLY');
+    const v4Planner = new v4_sdk_2.V4Planner();
+    if (options.routerBalanceInput || settleBeforeSwap) {
+        // V4Planner.addTrade would bake the quoted amountIn into the swap action, so build the
+        // pair explicitly instead: SETTLE the input first, then swap the resulting open delta.
+        // Same shape the mixed-route encoder uses for its v4 sections.
+        const pathInput = trade.route.pathInput;
+        if (options.routerBalanceInput) {
+            v4Planner.addSettle(pathInput, false, constants_1.CONTRACT_BALANCE);
+        }
+        else {
+            v4Planner.addSettle(pathInput, payerIsUser, bignumber_1.BigNumber.from(inputAmount.quotient.toString()));
+        }
+        v4Planner.addAction(v4_sdk_2.Actions.SWAP_EXACT_IN, [
+            {
+                currencyIn: pathInput.isNative ? constants_1.ETH_ADDRESS : pathInput.wrapped.address,
+                path: (0, v4_sdk_2.encodeRouteToPath)(v4Route),
+                minHopPriceX36: perHopSlippage,
+                amountIn: 0,
+                amountOutMinimum: slippageToleranceOnSwap
+                    ? trade.minimumAmountOut(slippageToleranceOnSwap).quotient.toString()
+                    : 0,
+            },
+        ], (0, toV4URVersion_1.toV4URVersion)(options.urVersion));
+    }
+    else {
+        v4Planner.addTrade(trade, slippageToleranceOnSwap, perHopSlippage, (0, toV4URVersion_1.toV4URVersion)(options.urVersion));
+        v4Planner.addSettle(trade.route.pathInput, payerIsUser);
+    }
+    // Handle split route output consistency:
+    // - If output is ETH and some routes output WETH: force all to output WETH, then unwrap
+    // - If output is WETH and some routes output ETH: force all to output ETH, then wrap
+    let pathOutputForTake = trade.route.pathOutput;
+    let lastPool = v4Route.pools[v4Route.pools.length - 1];
+    let ethWethPool = lastPool.currency1.equals(lastPool.currency0.wrapped);
+    if (ethWethPool && v4Route.pools.length > 1) {
+        let poolBefore = v4Route.pools[v4Route.pools.length - 2];
+        if (pathOutputForTake.isNative && poolBefore.currency0.isNative) {
+            pathOutputForTake = pathOutputForTake.wrapped;
+        }
+        else if (!pathOutputForTake.isNative &&
+            (poolBefore.currency0.equals(lastPool.currency1) || poolBefore.currency1.equals(lastPool.currency1))) {
+            pathOutputForTake = lastPool.currency0;
+        }
+    }
+    // Floor exact-out delivery: TAKE the exact leg amountOut instead of OPEN_DELTA, so an
+    // under-delivering pool (e.g. liquidity exhausted at the price limit) leaves an unsettled
+    // delta and reverts at unlock instead of silently forwarding a partial fill.
+    let takeAmount;
+    if (tradeType === sdk_core_1.TradeType.EXACT_OUTPUT) {
+        takeAmount = bignumber_1.BigNumber.from(outputAmount.quotient.toString());
+        // amount 0 encodes as the OPEN_DELTA sentinel, which would silently drop the floor
+        (0, tiny_invariant_1.default)(!takeAmount.isZero(), 'ZERO_EXACT_OUTPUT_AMOUNT');
+    }
+    v4Planner.addTake(pathOutputForTake, routerMustCustody ? constants_1.ROUTER_AS_RECIPIENT : (_b = options.recipient) !== null && _b !== void 0 ? _b : constants_1.SENDER_AS_RECIPIENT, takeAmount);
+    planner.addCommand(routerCommands_1.CommandType.V4_SWAP, [v4Planner.finalize()]);
+}
+function routeHasSettleBeforeSwapHook(pools, settleBeforeSwapHooks) {
+    if (!(settleBeforeSwapHooks === null || settleBeforeSwapHooks === void 0 ? void 0 : settleBeforeSwapHooks.length))
+        return false;
+    const hooks = new Set(settleBeforeSwapHooks.map((hook) => hook.toLowerCase()));
+    return pools.some((pool) => hooks.has(pool.hooks.toLowerCase()));
+}
+// encode a mixed route swap, i.e. including both v2 and v3 pools
+function addMixedSwap(planner, swap, tradeType, options, payerIsUser, routerMustCustody) {
+    var _a, _b, _c, _d;
+    const route = swap.route;
+    if (((_a = swap.minHopPriceX36) === null || _a === void 0 ? void 0 : _a.length) && swap.minHopPriceX36.length !== route.pools.length) {
+        throw new Error(`minHopPriceX36 length (${swap.minHopPriceX36.length}) must equal route.pools.length (${route.pools.length})`);
+    }
+    const inputAmount = swap.inputAmount;
+    const outputAmount = swap.outputAmount;
+    const tradeRecipient = routerMustCustody ? constants_1.ROUTER_AS_RECIPIENT : (_b = options.recipient) !== null && _b !== void 0 ? _b : constants_1.SENDER_AS_RECIPIENT;
+    // single hop, so it can be reduced to plain swap logic for one protocol version
+    if (route.pools.length === 1) {
+        if (route.pools[0] instanceof v4_sdk_2.Pool) {
+            return addV4Swap(planner, swap, tradeType, options, payerIsUser, routerMustCustody);
+        }
+        else if (route.pools[0] instanceof v3_sdk_1.Pool) {
+            return addV3Swap(planner, swap, tradeType, options, payerIsUser, routerMustCustody);
+        }
+        else if (route.pools[0] instanceof v2_sdk_1.Pair) {
+            return addV2Swap(planner, swap, tradeType, options, payerIsUser, routerMustCustody);
+        }
+        else {
+            throw new Error('Invalid route type');
+        }
+    }
+    const trade = router_sdk_1.MixedRouteTrade.createUncheckedTrade({
+        route: route,
+        inputAmount,
+        outputAmount,
+        tradeType,
+    });
+    const amountIn = trade.maximumAmountIn(options.slippageTolerance, inputAmount).quotient.toString();
+    const amountOut = routerMustCustody
+        ? 0
+        : trade.minimumAmountOut(options.slippageTolerance, outputAmount).quotient.toString();
+    // logic from
+    // https://github.com/Uniswap/router-sdk/blob/d8eed164e6c79519983844ca8b6a3fc24ebcb8f8/src/swapRouter.ts#L276
+    const sections = (0, router_sdk_1.partitionMixedRouteByProtocol)(route);
+    const isLastSectionInRoute = (i) => {
+        return i === sections.length - 1;
+    };
+    const useV2_1_1 = (0, constants_1.isAtLeastV2_1_1)(options.urVersion);
+    let inputToken = route.pathInput;
+    let hopOffset = 0;
+    for (let i = 0; i < sections.length; i++) {
+        const section = sections[i];
+        const routePool = section[0];
+        const outputToken = (0, router_sdk_1.getOutputOfPools)(section, inputToken);
+        const subRoute = new router_sdk_1.MixedRoute(new router_sdk_1.MixedRouteSDK([...section], inputToken, outputToken));
+        // Slice this section's portion of minHopPriceX36 from the flat array
+        const sectionHopSlippage = (_c = swap.minHopPriceX36) === null || _c === void 0 ? void 0 : _c.slice(hopOffset, hopOffset + section.length);
+        let nextInputToken;
+        let swapRecipient;
+        if (isLastSectionInRoute(i)) {
+            nextInputToken = outputToken;
+            swapRecipient = tradeRecipient;
+        }
+        else {
+            const nextPool = sections[i + 1][0];
+            nextInputToken = (0, pathCurrency_1.getPathCurrency)(outputToken, nextPool);
+            const v2PoolIsSwapRecipient = nextPool instanceof v2_sdk_1.Pair && outputToken.equals(nextInputToken);
+            swapRecipient = v2PoolIsSwapRecipient ? nextPool.liquidityToken.address : constants_1.ROUTER_AS_RECIPIENT;
+        }
+        if (routePool instanceof v4_sdk_2.Pool) {
+            const v4Planner = new v4_sdk_2.V4Planner();
+            const v4SubRoute = new v4_sdk_2.Route(section, subRoute.input, subRoute.output);
+            const v4SectionSlippage = (_d = sectionHopSlippage === null || sectionHopSlippage === void 0 ? void 0 : sectionHopSlippage.map((s) => bignumber_1.BigNumber.from(s))) !== null && _d !== void 0 ? _d : [];
+            v4Planner.addSettle(inputToken, payerIsUser && i === 0, (i == 0 ? firstHopInputAmount(options, amountIn) : constants_1.CONTRACT_BALANCE));
+            v4Planner.addAction(v4_sdk_2.Actions.SWAP_EXACT_IN, [
+                {
+                    currencyIn: inputToken.isNative ? constants_1.ETH_ADDRESS : inputToken.address,
+                    path: (0, v4_sdk_2.encodeRouteToPath)(v4SubRoute),
+                    minHopPriceX36: v4SectionSlippage,
+                    amountIn: 0,
+                    amountOutMinimum: !isLastSectionInRoute(i) ? 0 : amountOut,
+                },
+            ], (0, toV4URVersion_1.toV4URVersion)(options.urVersion));
+            // Handle split route output consistency for V4 sections in mixed routes
+            let outputTokenForTake = outputToken;
+            if (isLastSectionInRoute(i)) {
+                let lastPool = route.pools[route.pools.length - 1];
+                let v4Pool = lastPool instanceof v4_sdk_2.Pool;
+                let ethWethPool = v4Pool ? lastPool.currency1.equals(lastPool.currency0.wrapped) : false;
+                let poolBefore = route.pools[route.pools.length - 2];
+                if (ethWethPool) {
+                    if (outputToken.isNative && poolBefore.token0.isNative) {
+                        outputTokenForTake = outputToken.wrapped;
+                    }
+                    else if (!outputToken.isNative &&
+                        (poolBefore.token0.equals(lastPool.token1) || poolBefore.token1.equals(lastPool.token1))) {
+                        outputTokenForTake = lastPool.token0;
+                    }
+                }
+            }
+            v4Planner.addTake(outputTokenForTake, swapRecipient);
+            planner.addCommand(routerCommands_1.CommandType.V4_SWAP, [v4Planner.finalize()]);
+        }
+        else if (routePool instanceof v3_sdk_1.Pool) {
+            const v3Params = [
+                swapRecipient,
+                i == 0 ? firstHopInputAmount(options, amountIn) : constants_1.CONTRACT_BALANCE,
+                !isLastSectionInRoute(i) ? 0 : amountOut,
+                (0, router_sdk_1.encodeMixedRouteToPath)(subRoute),
+                payerIsUser && i === 0, // payerIsUser
+            ];
+            if (useV2_1_1)
+                v3Params.push(sectionHopSlippage !== null && sectionHopSlippage !== void 0 ? sectionHopSlippage : []);
+            planner.addCommand(routerCommands_1.CommandType.V3_SWAP_EXACT_IN, v3Params, false, options.urVersion);
+        }
+        else if (routePool instanceof v2_sdk_1.Pair) {
+            const v2Params = [
+                swapRecipient,
+                i === 0 ? firstHopInputAmount(options, amountIn) : constants_1.CONTRACT_BALANCE,
+                !isLastSectionInRoute(i) ? 0 : amountOut,
+                subRoute.path.map((token) => token.wrapped.address),
+                payerIsUser && i === 0,
+            ];
+            if (useV2_1_1)
+                v2Params.push(sectionHopSlippage !== null && sectionHopSlippage !== void 0 ? sectionHopSlippage : []);
+            planner.addCommand(routerCommands_1.CommandType.V2_SWAP_EXACT_IN, v2Params, false, options.urVersion);
+        }
+        else {
+            throw new Error('Unexpected Pool Type');
+        }
+        // perform a token transition (wrap/unwrap if necessary)
+        if (!isLastSectionInRoute(i)) {
+            if (outputToken.isNative && !nextInputToken.isNative) {
+                planner.addCommand(routerCommands_1.CommandType.WRAP_ETH, [constants_1.ROUTER_AS_RECIPIENT, constants_1.CONTRACT_BALANCE]);
+            }
+            else if (!outputToken.isNative && nextInputToken.isNative) {
+                planner.addCommand(routerCommands_1.CommandType.UNWRAP_WETH, [constants_1.ROUTER_AS_RECIPIENT, 0]);
+            }
+        }
+        hopOffset += section.length;
+        inputToken = nextInputToken;
+    }
+}
+// if price impact is very high, there's a chance of hitting max/min prices resulting in a partial fill of the swap
+function riskOfPartialFill(trade) {
+    return trade.priceImpact.greaterThan(REFUND_ETH_PRICE_IMPACT_THRESHOLD);
+}
+// A lone FeeOptions becomes a one-element list, so the single-recipient path is unchanged.
+function toFeeOptionsList(fee) {
+    if (!fee)
+        return [];
+    return Array.isArray(fee) ? fee : [fee];
+}
+function hasFeeOption(swapOptions) {
+    return toFeeOptionsList(swapOptions.fee).length > 0 || !!swapOptions.flatFee;
+}
+//# sourceMappingURL=uniswap.js.map