@uniswap/universal-router-sdk 5.2.0 → 5.3.0

package/dist/esm/src/types/encodeSwaps.d.ts

@@ -0,0 +1,149 @@
+import { BigNumberish } from 'ethers';
+import { Currency, CurrencyAmount, Percent, TradeType } from '@uniswap/sdk-core';
+import { type PathKey, type PoolKey } from '@uniswap/v4-sdk';
+import { TokenTransferMode } from '../entities/actions/uniswap';
+import { Permit2Permit } from '../utils/inputTokens';
+import { UniversalRouterVersion } from '../utils/constants';
+export type { PathKey, PoolKey };
+export type Fee = {
+    kind: 'portion';
+    recipient: string;
+    fee: Percent;
+} | {
+    kind: 'flat';
+    recipient: string;
+    amount: BigNumberish;
+};
+export type SwapSpecification = {
+    tradeType: TradeType;
+    routing: {
+        inputToken: Currency;
+        outputToken: Currency;
+        amount: CurrencyAmount<Currency>;
+        quote: CurrencyAmount<Currency>;
+    };
+    slippageTolerance: Percent;
+    recipient?: string;
+    fee?: Fee;
+    tokenTransferMode?: TokenTransferMode;
+    permit?: Permit2Permit;
+    chainId?: number;
+    deadline?: BigNumberish;
+    urVersion?: UniversalRouterVersion;
+    safeMode?: boolean;
+};
+export type NormalizedSwapSpecification = Omit<SwapSpecification, 'recipient' | 'tokenTransferMode' | 'urVersion' | 'safeMode'> & {
+    recipient: string;
+    tokenTransferMode: TokenTransferMode;
+    urVersion: UniversalRouterVersion;
+    safeMode: boolean;
+};
+export type V2SwapExactIn = {
+    type: 'V2_SWAP_EXACT_IN';
+    recipient: string;
+    amountIn: BigNumberish;
+    amountOutMin: BigNumberish;
+    path: string[];
+    minHopPriceX36?: BigNumberish[];
+};
+export type V2SwapExactOut = {
+    type: 'V2_SWAP_EXACT_OUT';
+    recipient: string;
+    amountOut: BigNumberish;
+    amountInMax: BigNumberish;
+    path: string[];
+    minHopPriceX36?: BigNumberish[];
+};
+export type V3SwapExactIn = {
+    type: 'V3_SWAP_EXACT_IN';
+    recipient: string;
+    amountIn: BigNumberish;
+    amountOutMin: BigNumberish;
+    path: string;
+    minHopPriceX36?: BigNumberish[];
+};
+export type V3SwapExactOut = {
+    type: 'V3_SWAP_EXACT_OUT';
+    recipient: string;
+    amountOut: BigNumberish;
+    amountInMax: BigNumberish;
+    path: string;
+    minHopPriceX36?: BigNumberish[];
+};
+export type V4Swap = {
+    type: 'V4_SWAP';
+    v4Actions: V4Action[];
+};
+export type WrapEth = {
+    type: 'WRAP_ETH';
+    recipient: string;
+    amount: BigNumberish;
+};
+export type UnwrapWeth = {
+    type: 'UNWRAP_WETH';
+    recipient: string;
+    amountMin: BigNumberish;
+};
+export type SwapStep = V2SwapExactIn | V2SwapExactOut | V3SwapExactIn | V3SwapExactOut | V4Swap | WrapEth | UnwrapWeth;
+export type V4SwapExactIn = {
+    action: 'SWAP_EXACT_IN';
+    currencyIn: string;
+    path: PathKey[];
+    amountIn: BigNumberish;
+    amountOutMinimum: BigNumberish;
+    minHopPriceX36?: BigNumberish[];
+};
+export type V4SwapExactInSingle = {
+    action: 'SWAP_EXACT_IN_SINGLE';
+    poolKey: PoolKey;
+    zeroForOne: boolean;
+    amountIn: BigNumberish;
+    amountOutMinimum: BigNumberish;
+    minHopPriceX36?: BigNumberish;
+    hookData: string;
+};
+export type V4SwapExactOut = {
+    action: 'SWAP_EXACT_OUT';
+    currencyOut: string;
+    path: PathKey[];
+    amountOut: BigNumberish;
+    amountInMaximum: BigNumberish;
+    minHopPriceX36?: BigNumberish[];
+};
+export type V4SwapExactOutSingle = {
+    action: 'SWAP_EXACT_OUT_SINGLE';
+    poolKey: PoolKey;
+    zeroForOne: boolean;
+    amountOut: BigNumberish;
+    amountInMaximum: BigNumberish;
+    minHopPriceX36?: BigNumberish;
+    hookData: string;
+};
+export type V4Settle = {
+    action: 'SETTLE';
+    currency: string;
+    amount: BigNumberish;
+};
+export type V4SettleAll = {
+    action: 'SETTLE_ALL';
+    currency: string;
+    maxAmount: BigNumberish;
+};
+export type V4Take = {
+    action: 'TAKE';
+    currency: string;
+    recipient: string;
+    amount: BigNumberish;
+};
+export type V4TakeAll = {
+    action: 'TAKE_ALL';
+    currency: string;
+    minAmount: BigNumberish;
+};
+export type V4TakePortion = {
+    action: 'TAKE_PORTION';
+    currency: string;
+    recipient: string;
+    bips: BigNumberish;
+};
+export type V4Action = V4SwapExactIn | V4SwapExactInSingle | V4SwapExactOut | V4SwapExactOutSingle | V4Settle | V4SettleAll | V4Take | V4TakeAll | V4TakePortion;

package/dist/esm/src/types/encodeSwaps.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=encodeSwaps.js.map

package/dist/esm/src/types/encodeSwaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodeSwaps.js","sourceRoot":"","sources":["../../../../src/types/encodeSwaps.ts"],"names":[],"mappings":""}

package/dist/esm/src/utils/computeEncodeSwapsAmounts.d.ts

@@ -0,0 +1,8 @@
+import { BigNumber } from 'ethers';
+import { NormalizedSwapSpecification } from '../types/encodeSwaps';
+export type EncodeSwapsAmounts = {
+    exactOrMaxAmountIn: BigNumber;
+    grossMinOrExactAmountOut: BigNumber;
+    netMinOrExactAmountOut: BigNumber;
+};
+export declare function computeEncodeSwapsAmounts(spec: NormalizedSwapSpecification): EncodeSwapsAmounts;

package/dist/esm/src/utils/computeEncodeSwapsAmounts.js

@@ -0,0 +1,43 @@
+import { BigNumber } from 'ethers';
+import { TradeType } from '@uniswap/sdk-core';
+import { isAtLeastV2_1_1 } from './constants';
+import { encodeFee1e18, encodeFeeBips } from './numbers';
+// Slippage is applied to the quote: scaled down to a floor for exact-input output,
+// scaled up to a ceiling for exact-output input. The unscaled side is the user's exact value.
+// Portion fees pair with exact-input (1e18 precision on >=v2.1.1, bps on v2.0); flat fees pair with exact-output.
+export function computeEncodeSwapsAmounts(spec) {
+    var _a, _b;
+    const routingAmount = BigNumber.from(spec.routing.amount.quotient.toString());
+    const routingQuote = BigNumber.from(spec.routing.quote.quotient.toString());
+    const slippageNumerator = BigNumber.from(spec.slippageTolerance.numerator.toString());
+    const slippageDenominator = BigNumber.from(spec.slippageTolerance.denominator.toString());
+    if (spec.tradeType === TradeType.EXACT_INPUT) {
+        const grossMinOrExactAmountOut = routingQuote
+            .mul(slippageDenominator)
+            .div(slippageDenominator.add(slippageNumerator));
+        if (((_a = spec.fee) === null || _a === void 0 ? void 0 : _a.kind) === 'portion') {
+            const feeAmount = isAtLeastV2_1_1(spec.urVersion)
+                ? grossMinOrExactAmountOut.mul(BigNumber.from(encodeFee1e18(spec.fee.fee))).div(BigNumber.from(10).pow(18))
+                : grossMinOrExactAmountOut.mul(BigNumber.from(encodeFeeBips(spec.fee.fee))).div(10000);
+            return {
+                exactOrMaxAmountIn: routingAmount,
+                grossMinOrExactAmountOut,
+                netMinOrExactAmountOut: grossMinOrExactAmountOut.sub(feeAmount),
+            };
+        }
+        return {
+            exactOrMaxAmountIn: routingAmount,
+            grossMinOrExactAmountOut,
+            netMinOrExactAmountOut: grossMinOrExactAmountOut,
+        };
+    }
+    const exactOrMaxAmountIn = routingQuote.mul(slippageDenominator.add(slippageNumerator)).div(slippageDenominator);
+    const grossMinOrExactAmountOut = routingAmount;
+    const netMinOrExactAmountOut = ((_b = spec.fee) === null || _b === void 0 ? void 0 : _b.kind) === 'flat' ? grossMinOrExactAmountOut.sub(BigNumber.from(spec.fee.amount)) : grossMinOrExactAmountOut;
+    return {
+        exactOrMaxAmountIn,
+        grossMinOrExactAmountOut,
+        netMinOrExactAmountOut,
+    };
+}
+//# sourceMappingURL=computeEncodeSwapsAmounts.js.map

package/dist/esm/src/utils/computeEncodeSwapsAmounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeEncodeSwapsAmounts.js","sourceRoot":"","sources":["../../../../src/utils/computeEncodeSwapsAmounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAWxD,mFAAmF;AACnF,8FAA8F;AAC9F,kHAAkH;AAClH,MAAM,UAAU,yBAAyB,CAAC,IAAiC;;IACzE,MAAM,aAAa,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC7E,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC3E,MAAM,iBAAiB,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAA;IACrF,MAAM,mBAAmB,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAA;IAEzF,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,WAAW,EAAE;QAC5C,MAAM,wBAAwB,GAAG,YAAY;aAC1C,GAAG,CAAC,mBAAmB,CAAC;aACxB,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAA;QAElD,IAAI,CAAA,MAAA,IAAI,CAAC,GAAG,0CAAE,IAAI,MAAK,SAAS,EAAE;YAChC,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC;gBAC/C,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC3G,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAM,CAAC,CAAA;YAEzF,OAAO;gBACL,kBAAkB,EAAE,aAAa;gBACjC,wBAAwB;gBACxB,sBAAsB,EAAE,wBAAwB,CAAC,GAAG,CAAC,SAAS,CAAC;aAChE,CAAA;SACF;QAED,OAAO;YACL,kBAAkB,EAAE,aAAa;YACjC,wBAAwB;YACxB,sBAAsB,EAAE,wBAAwB;SACjD,CAAA;KACF;IAED,MAAM,kBAAkB,GAAG,YAAY,CAAC,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;IAChH,MAAM,wBAAwB,GAAG,aAAa,CAAA;IAC9C,MAAM,sBAAsB,GAC1B,CAAA,MAAA,IAAI,CAAC,GAAG,0CAAE,IAAI,MAAK,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAA;IAEtH,OAAO;QACL,kBAAkB;QAClB,wBAAwB;QACxB,sBAAsB;KACvB,CAAA;AACH,CAAC"}

package/dist/esm/src/utils/encodeSwapStep.d.ts

@@ -0,0 +1,4 @@
+import { UniversalRouterVersion } from './constants';
+import { RoutePlanner } from './routerCommands';
+import { SwapStep } from '../types/encodeSwaps';
+export declare function encodeSwapStep(planner: RoutePlanner, step: SwapStep, urVersion?: UniversalRouterVersion): void;

package/dist/esm/src/utils/encodeSwapStep.js

@@ -0,0 +1,57 @@
+import { V4Planner } from '@uniswap/v4-sdk';
+import { isAtLeastV2_1_1 } from './constants';
+import { CommandType } from './routerCommands';
+import { encodeV4Action, toV4URVersion } from './encodeV4Action';
+// V2/V3 swap params hardcode payerIsUser=false; encodeSwaps pulls funds into the router first via PERMIT2_TRANSFER_FROM
+export function encodeSwapStep(planner, step, urVersion) {
+    var _a, _b, _c, _d;
+    const useV2_1_1 = isAtLeastV2_1_1(urVersion);
+    switch (step.type) {
+        case 'V2_SWAP_EXACT_IN': {
+            const params = [step.recipient, step.amountIn, step.amountOutMin, step.path, false];
+            if (useV2_1_1)
+                params.push((_a = step.minHopPriceX36) !== null && _a !== void 0 ? _a : []);
+            planner.addCommand(CommandType.V2_SWAP_EXACT_IN, params, false, urVersion);
+            return;
+        }
+        case 'V2_SWAP_EXACT_OUT': {
+            const params = [step.recipient, step.amountOut, step.amountInMax, step.path, false];
+            if (useV2_1_1)
+                params.push((_b = step.minHopPriceX36) !== null && _b !== void 0 ? _b : []);
+            planner.addCommand(CommandType.V2_SWAP_EXACT_OUT, params, false, urVersion);
+            return;
+        }
+        case 'V3_SWAP_EXACT_IN': {
+            const params = [step.recipient, step.amountIn, step.amountOutMin, step.path, false];
+            if (useV2_1_1)
+                params.push((_c = step.minHopPriceX36) !== null && _c !== void 0 ? _c : []);
+            planner.addCommand(CommandType.V3_SWAP_EXACT_IN, params, false, urVersion);
+            return;
+        }
+        case 'V3_SWAP_EXACT_OUT': {
+            const params = [step.recipient, step.amountOut, step.amountInMax, step.path, false];
+            if (useV2_1_1)
+                params.push((_d = step.minHopPriceX36) !== null && _d !== void 0 ? _d : []);
+            planner.addCommand(CommandType.V3_SWAP_EXACT_OUT, params, false, urVersion);
+            return;
+        }
+        case 'V4_SWAP': {
+            const v4Planner = new V4Planner();
+            for (const v4Action of step.v4Actions) {
+                const encoded = encodeV4Action(v4Action, urVersion);
+                v4Planner.addAction(encoded.action, encoded.params, toV4URVersion(urVersion));
+            }
+            planner.addCommand(CommandType.V4_SWAP, [v4Planner.finalize()], false, urVersion);
+            return;
+        }
+        case 'WRAP_ETH':
+            planner.addCommand(CommandType.WRAP_ETH, [step.recipient, step.amount], false, urVersion);
+            return;
+        case 'UNWRAP_WETH':
+            planner.addCommand(CommandType.UNWRAP_WETH, [step.recipient, step.amountMin], false, urVersion);
+            return;
+        default:
+            throw new Error(`Unknown swap step type: ${step.type}`);
+    }
+}
+//# sourceMappingURL=encodeSwapStep.js.map

package/dist/esm/src/utils/encodeSwapStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodeSwapStep.js","sourceRoot":"","sources":["../../../../src/utils/encodeSwapStep.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/utils/encodeV4Action.d.ts

@@ -0,0 +1,8 @@
+import { Actions, URVersion } from '@uniswap/v4-sdk';
+import { UniversalRouterVersion } from './constants';
+import { V4Action } from '../types/encodeSwaps';
+export declare function toV4URVersion(version?: UniversalRouterVersion): URVersion;
+export declare function encodeV4Action(v4Action: V4Action, urVersion?: UniversalRouterVersion): {
+    action: Actions;
+    params: any[];
+};

package/dist/esm/src/utils/encodeV4Action.js

@@ -0,0 +1,92 @@
+import { Actions, URVersion } from '@uniswap/v4-sdk';
+import { UniversalRouterVersion, isAtLeastV2_1_1 } from './constants';
+const ACTION_NAME_TO_ENUM = Object.fromEntries(Object.entries(Actions).filter(([key]) => isNaN(Number(key))));
+const V4_UR_VERSION_MAP = {
+    [UniversalRouterVersion.V2_0]: URVersion.V2_0,
+    [UniversalRouterVersion.V2_1_1]: URVersion.V2_1_1,
+};
+export function toV4URVersion(version) {
+    if (version === undefined)
+        return URVersion.V2_0;
+    const mapped = V4_UR_VERSION_MAP[version];
+    if (!mapped)
+        throw new Error(`No v4-sdk URVersion mapping for UniversalRouterVersion: ${version}`);
+    return mapped;
+}
+export function encodeV4Action(v4Action, urVersion) {
+    var _a, _b, _c, _d;
+    const action = ACTION_NAME_TO_ENUM[v4Action.action];
+    if (action === undefined)
+        throw new Error(`Unknown V4 action: ${v4Action.action}`);
+    const useV2_1_1 = isAtLeastV2_1_1(urVersion);
+    switch (v4Action.action) {
+        case 'SWAP_EXACT_IN':
+            return {
+                action,
+                params: [
+                    {
+                        currencyIn: v4Action.currencyIn,
+                        path: v4Action.path,
+                        ...(useV2_1_1 && { minHopPriceX36: (_a = v4Action.minHopPriceX36) !== null && _a !== void 0 ? _a : [] }),
+                        amountIn: v4Action.amountIn,
+                        amountOutMinimum: v4Action.amountOutMinimum,
+                    },
+                ],
+            };
+        case 'SWAP_EXACT_IN_SINGLE':
+            return {
+                action,
+                params: [
+                    {
+                        poolKey: v4Action.poolKey,
+                        zeroForOne: v4Action.zeroForOne,
+                        amountIn: v4Action.amountIn,
+                        amountOutMinimum: v4Action.amountOutMinimum,
+                        ...(useV2_1_1 && { minHopPriceX36: (_b = v4Action.minHopPriceX36) !== null && _b !== void 0 ? _b : 0 }),
+                        hookData: v4Action.hookData,
+                    },
+                ],
+            };
+        case 'SWAP_EXACT_OUT':
+            return {
+                action,
+                params: [
+                    {
+                        currencyOut: v4Action.currencyOut,
+                        path: v4Action.path,
+                        ...(useV2_1_1 && { minHopPriceX36: (_c = v4Action.minHopPriceX36) !== null && _c !== void 0 ? _c : [] }),
+                        amountOut: v4Action.amountOut,
+                        amountInMaximum: v4Action.amountInMaximum,
+                    },
+                ],
+            };
+        case 'SWAP_EXACT_OUT_SINGLE':
+            return {
+                action,
+                params: [
+                    {
+                        poolKey: v4Action.poolKey,
+                        zeroForOne: v4Action.zeroForOne,
+                        amountOut: v4Action.amountOut,
+                        amountInMaximum: v4Action.amountInMaximum,
+                        ...(useV2_1_1 && { minHopPriceX36: (_d = v4Action.minHopPriceX36) !== null && _d !== void 0 ? _d : 0 }),
+                        hookData: v4Action.hookData,
+                    },
+                ],
+            };
+        case 'SETTLE':
+            // payerIsUser=false: same router-custody model as encodeSwapStep — funds are already in the router
+            return { action, params: [v4Action.currency, v4Action.amount, false] };
+        case 'SETTLE_ALL':
+            return { action, params: [v4Action.currency, v4Action.maxAmount] };
+        case 'TAKE':
+            return { action, params: [v4Action.currency, v4Action.recipient, v4Action.amount] };
+        case 'TAKE_ALL':
+            return { action, params: [v4Action.currency, v4Action.minAmount] };
+        case 'TAKE_PORTION':
+            return { action, params: [v4Action.currency, v4Action.recipient, v4Action.bips] };
+        default:
+            throw new Error(`Unhandled V4 action: ${v4Action.action}`);
+    }
+}
+//# sourceMappingURL=encodeV4Action.js.map

package/dist/esm/src/utils/encodeV4Action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodeV4Action.js","sourceRoot":"","sources":["../../../../src/utils/encodeV4Action.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/utils/normalizeEncodeSwapsSpec.d.ts

@@ -0,0 +1,2 @@
+import { NormalizedSwapSpecification, SwapSpecification } from '../types/encodeSwaps';
+export declare function normalizeEncodeSwapsSpec(spec: SwapSpecification): NormalizedSwapSpecification;

package/dist/esm/src/utils/normalizeEncodeSwapsSpec.js

@@ -0,0 +1,14 @@
+import { TokenTransferMode } from '../entities/actions/uniswap';
+import { SENDER_AS_RECIPIENT, UniversalRouterVersion } from './constants';
+// Fills the four optional fields that `validateEncodeSwaps` and `computeEncodeSwapsAmounts` require.
+export function normalizeEncodeSwapsSpec(spec) {
+    var _a, _b, _c, _d;
+    return {
+        ...spec,
+        recipient: (_a = spec.recipient) !== null && _a !== void 0 ? _a : SENDER_AS_RECIPIENT,
+        tokenTransferMode: (_b = spec.tokenTransferMode) !== null && _b !== void 0 ? _b : TokenTransferMode.Permit2,
+        urVersion: (_c = spec.urVersion) !== null && _c !== void 0 ? _c : UniversalRouterVersion.V2_0,
+        safeMode: (_d = spec.safeMode) !== null && _d !== void 0 ? _d : false,
+    };
+}
+//# sourceMappingURL=normalizeEncodeSwapsSpec.js.map

package/dist/esm/src/utils/normalizeEncodeSwapsSpec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeEncodeSwapsSpec.js","sourceRoot":"","sources":["../../../../src/utils/normalizeEncodeSwapsSpec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAE/D,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEzE,qGAAqG;AACrG,MAAM,UAAU,wBAAwB,CAAC,IAAuB;;IAC9D,OAAO;QACL,GAAG,IAAI;QACP,SAAS,EAAE,MAAA,IAAI,CAAC,SAAS,mCAAI,mBAAmB;QAChD,iBAAiB,EAAE,MAAA,IAAI,CAAC,iBAAiB,mCAAI,iBAAiB,CAAC,OAAO;QACtE,SAAS,EAAE,MAAA,IAAI,CAAC,SAAS,mCAAI,sBAAsB,CAAC,IAAI;QACxD,QAAQ,EAAE,MAAA,IAAI,CAAC,QAAQ,mCAAI,KAAK;KACjC,CAAA;AACH,CAAC"}

package/dist/esm/src/utils/validateEncodeSwaps.d.ts

@@ -0,0 +1,2 @@
+import { NormalizedSwapSpecification, SwapStep } from '../types/encodeSwaps';
+export declare function validateEncodeSwaps(spec: NormalizedSwapSpecification, swapSteps: SwapStep[]): void;

package/dist/esm/src/utils/validateEncodeSwaps.js

@@ -0,0 +1,130 @@
+import { BigNumber } from 'ethers';
+import invariant from 'tiny-invariant';
+import { TradeType } from '@uniswap/sdk-core';
+import { TokenTransferMode } from '../entities/actions/uniswap';
+import { ROUTER_AS_RECIPIENT, SENDER_AS_RECIPIENT, UniversalRouterVersion, ZERO_ADDRESS } from './constants';
+// V3 path: 20-byte address + N × (3-byte fee + 20-byte address); minimum is 43 bytes (single hop, N=1)
+// Returns N or undefined if malformed
+function getV3HopCount(path) {
+    if (!path.startsWith('0x'))
+        return undefined;
+    const byteLength = (path.length - 2) / 2;
+    if (byteLength < 43)
+        return undefined;
+    const variableSegmentLength = byteLength - 20;
+    if (variableSegmentLength < 23 || variableSegmentLength % 23 !== 0)
+        return undefined;
+    return variableSegmentLength / 23;
+}
+function hasV4MinHopPriceX36(action) {
+    switch (action.action) {
+        case 'SWAP_EXACT_IN':
+        case 'SWAP_EXACT_OUT':
+        case 'SWAP_EXACT_IN_SINGLE':
+        case 'SWAP_EXACT_OUT_SINGLE':
+            return action.minHopPriceX36 !== undefined;
+        default:
+            return false;
+    }
+}
+function validateV4HopCounts(actions) {
+    for (const action of actions) {
+        switch (action.action) {
+            case 'SWAP_EXACT_IN':
+            case 'SWAP_EXACT_OUT':
+                invariant(!action.minHopPriceX36 || action.minHopPriceX36.length === action.path.length, 'V4_MIN_HOP_PRICE_X36_LENGTH_MISMATCH');
+                break;
+            default:
+                break;
+        }
+    }
+}
+function assertRouterRecipient(recipient) {
+    invariant(recipient === ROUTER_AS_RECIPIENT, 'STEP_RECIPIENT_MUST_BE_ROUTER');
+}
+function assertRouterActionRecipient(recipient) {
+    invariant(recipient === ROUTER_AS_RECIPIENT, 'V4_ACTION_RECIPIENT_MUST_BE_ROUTER');
+}
+// V4 actions that take a recipient must use router custody so the SDK's settlement sweeps see the funds
+function validateV4Recipients(actions) {
+    for (const action of actions) {
+        switch (action.action) {
+            case 'TAKE':
+            case 'TAKE_PORTION':
+                assertRouterActionRecipient(action.recipient);
+                break;
+            default:
+                break;
+        }
+    }
+}
+export function validateEncodeSwaps(spec, swapSteps) {
+    var _a, _b, _c, _d;
+    invariant(swapSteps.length > 0, 'EMPTY_SWAP_STEPS');
+    const amountCurrency = spec.routing.amount.currency.wrapped;
+    const quoteCurrency = spec.routing.quote.currency.wrapped;
+    const inputCurrency = spec.routing.inputToken.wrapped;
+    const outputCurrency = spec.routing.outputToken.wrapped;
+    invariant(!spec.slippageTolerance.lessThan(0), 'SLIPPAGE_TOLERANCE');
+    invariant(spec.recipient !== ZERO_ADDRESS, 'RECIPIENT_CANNOT_BE_ZERO');
+    invariant(spec.recipient !== ROUTER_AS_RECIPIENT, 'RECIPIENT_CANNOT_BE_ROUTER');
+    // routing.amount is on the exact side of the trade; routing.quote is on the slippage side
+    if (spec.tradeType === TradeType.EXACT_INPUT) {
+        invariant(amountCurrency.equals(inputCurrency), 'INVALID_ROUTING_AMOUNT_CURRENCY');
+        invariant(quoteCurrency.equals(outputCurrency), 'INVALID_ROUTING_QUOTE_CURRENCY');
+    }
+    else {
+        invariant(amountCurrency.equals(outputCurrency), 'INVALID_ROUTING_AMOUNT_CURRENCY');
+        invariant(quoteCurrency.equals(inputCurrency), 'INVALID_ROUTING_QUOTE_CURRENCY');
+    }
+    // ApproveProxy ingress lives upstream in the proxy contract: needs chain id, ERC20 input, no permit2, explicit recipient
+    if (spec.tokenTransferMode === TokenTransferMode.ApproveProxy) {
+        invariant(!!spec.chainId, 'PROXY_MISSING_CHAIN_ID');
+        invariant(!spec.routing.inputToken.isNative, 'PROXY_NATIVE_INPUT');
+        invariant(!spec.permit, 'PROXY_PERMIT_CONFLICT');
+        invariant(spec.recipient !== SENDER_AS_RECIPIENT, 'PROXY_EXPLICIT_RECIPIENT_REQUIRED');
+    }
+    // permit2 is ERC20-only; native input pays via msg.value
+    invariant(!(spec.routing.inputToken.isNative && spec.permit), 'NATIVE_INPUT_PERMIT');
+    // portion fees pair with exact-input (% of variable output); flat fees pair with exact-output (fixed deduction from the target)
+    invariant(!(((_a = spec.fee) === null || _a === void 0 ? void 0 : _a.kind) === 'portion' && spec.tradeType !== TradeType.EXACT_INPUT), 'INVALID_PORTION_FEE_TRADE_TYPE');
+    invariant(!(((_b = spec.fee) === null || _b === void 0 ? void 0 : _b.kind) === 'flat' && spec.tradeType !== TradeType.EXACT_OUTPUT), 'INVALID_FLAT_FEE_TRADE_TYPE');
+    invariant(!(((_c = spec.fee) === null || _c === void 0 ? void 0 : _c.kind) === 'flat' &&
+        BigNumber.from(spec.fee.amount).gt(BigNumber.from(spec.routing.amount.quotient.toString()))), 'FLAT_FEE_GT_AMOUNT');
+    // v2.0 PAY_PORTION takes whole bps; fractional bps need >=v2.1.1's PAY_PORTION_FULL_PRECISION
+    invariant(!(((_d = spec.fee) === null || _d === void 0 ? void 0 : _d.kind) === 'portion' &&
+        spec.urVersion === UniversalRouterVersion.V2_0 &&
+        !spec.fee.fee.multiply(10000).remainder.equalTo(0)), 'FRACTIONAL_BPS_PORTION_FEE_UNSUPPORTED_ON_V2_0');
+    // per-step: capability-gate by UR version, recipients must be router custody, per-hop arrays must match hop counts
+    for (const step of swapSteps) {
+        if (spec.urVersion === UniversalRouterVersion.V2_0) {
+            invariant(!('minHopPriceX36' in step) || step.minHopPriceX36 === undefined, 'MIN_HOP_PRICE_X36_UNSUPPORTED_ON_V2_0');
+            invariant(!(step.type === 'V4_SWAP' && step.v4Actions.some(hasV4MinHopPriceX36)), 'MIN_HOP_PRICE_X36_UNSUPPORTED_ON_V2_0');
+        }
+        switch (step.type) {
+            case 'V2_SWAP_EXACT_IN':
+            case 'V2_SWAP_EXACT_OUT':
+                assertRouterRecipient(step.recipient);
+                invariant(!step.minHopPriceX36 || step.minHopPriceX36.length === step.path.length - 1, 'V2_MIN_HOP_PRICE_X36_LENGTH_MISMATCH');
+                break;
+            case 'V3_SWAP_EXACT_IN':
+            case 'V3_SWAP_EXACT_OUT': {
+                assertRouterRecipient(step.recipient);
+                const hopCount = getV3HopCount(step.path);
+                invariant(hopCount === undefined || !step.minHopPriceX36 || step.minHopPriceX36.length === hopCount, 'V3_MIN_HOP_PRICE_X36_LENGTH_MISMATCH');
+                break;
+            }
+            case 'WRAP_ETH':
+            case 'UNWRAP_WETH':
+                assertRouterRecipient(step.recipient);
+                break;
+            case 'V4_SWAP':
+                validateV4HopCounts(step.v4Actions);
+                validateV4Recipients(step.v4Actions);
+                break;
+            default:
+                break;
+        }
+    }
+}
+//# sourceMappingURL=validateEncodeSwaps.js.map

package/dist/esm/src/utils/validateEncodeSwaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateEncodeSwaps.js","sourceRoot":"","sources":["../../../../src/utils/validateEncodeSwaps.ts"],"names":[],"mappings":"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"}

package/dist/types/src/index.d.ts

@@ -1,5 +1,6 @@
 export { SwapRouter } from './swapRouter';
 export type { MigrateV3ToV4Options, SignedRouteOptions, EIP712Payload } from './swapRouter';
+export * from './types/encodeSwaps';
 export * from './entities';
 export * from './utils/routerTradeAdapter';
 export { RoutePlanner, CommandType, COMMAND_DEFINITION, Parser, Subparser } from './utils/routerCommands';
@@ -8,4 +9,6 @@ export { UNIVERSAL_ROUTER_CREATION_BLOCK, UNIVERSAL_ROUTER_ADDRESS, SWAP_PROXY_A
 export { CommandParser, GenericCommandParser } from './utils/commandParser';
 export type { UniversalRouterCommand, UniversalRouterCall, Param, CommandsDefinition } from './utils/commandParser';
 export type { Permit2Permit } from './utils/inputTokens';
+export { normalizeEncodeSwapsSpec } from './utils/normalizeEncodeSwapsSpec';
+export { validateEncodeSwaps } from './utils/validateEncodeSwaps';
 export { NONCE_SKIP_CHECK, generateNonce, EXECUTE_SIGNED_TYPES, getUniversalRouterDomain } from './utils/eip712';

package/dist/types/src/swapRouter.d.ts

@@ -6,6 +6,7 @@ import { Trade as RouterTrade } from '@uniswap/router-sdk';
 import { Currency, TradeType } from '@uniswap/sdk-core';
 import { SwapOptions } from './entities/actions/uniswap';
 import { AcrossV4DepositV3Params } from './entities/actions/across';
+import { SwapSpecification, SwapStep } from './types/encodeSwaps';
 import { TypedDataDomain, TypedDataField } from '@ethersproject/abstract-signer';
 export type SwapRouterConfig = {
     sender?: string;
@@ -40,6 +41,20 @@ export declare abstract class SwapRouter {
     static INTERFACE: Interface;
     static PROXY_INTERFACE: Interface;
     static swapCallParameters(trades: RouterTrade<Currency, Currency, TradeType>, options: SwapOptions, bridgeOptions?: AcrossV4DepositV3Params[]): MethodParameters;
+    /**
+     * Encodes router-provided swap steps inside the SDK safety envelope.
+     *
+     * Routers own `swapSteps` (V2/V3/V4 swaps, plus any `WRAP_ETH` / `UNWRAP_WETH` required by the route).
+     * The SDK owns ingress, fees, final settlement, exact-output refund, and optional `safeMode`.
+     *
+     * Router contract: end with final output in `spec.routing.outputToken`; for `EXACT_OUTPUT`, unused input
+     * must end in `spec.routing.inputToken`. Don't include a top-level `SWEEP` — the SDK appends settlement,
+     * refund, and safeMode sweeps itself.
+     *
+     * Router custody with `payerIsUser = false` is deliberate for safety, even if it costs an extra command
+     * or transfer; the SDK does not infer route topology on behalf of routers.
+     */
+    static encodeSwaps(spec: SwapSpecification, swapSteps: SwapStep[]): MethodParameters;
     /**
      * Generate EIP712 payload for signed execution (no signing performed)
      * Decodes existing execute() calldata and prepares it for signing
@@ -80,8 +95,9 @@ export declare abstract class SwapRouter {
      */
     private static encodePlan;
     /**
-     * Encodes a planned route into calldata targeting the SwapProxy contract.
+     * Wraps an inner UR plan in calldata targeting the SwapProxy contract.
      * The proxy pulls ERC20 tokens from the user into the UR, then executes commands.
      */
     private static encodeProxyPlan;
+    private static encodeProxyCall;
 }