@uniswap/universal-router-sdk 4.33.0 → 4.34.0

package/dist/entities/actions/uniswap.d.ts

@@ -9,6 +9,10 @@ export declare type FlatFeeOptions = {
     amount: BigNumberish;
     recipient: string;
 };
+export declare enum TokenTransferMode {
+    Permit2 = "Permit2",
+    ApproveProxy = "ApproveProxy"
+}
 export declare type SwapOptions = Omit<RouterSwapOptions, 'inputTokenPermit'> & {
     useRouterBalance?: boolean;
     inputTokenPermit?: Permit2Permit;
@@ -16,6 +20,8 @@ export declare type SwapOptions = Omit<RouterSwapOptions, 'inputTokenPermit'> &
     safeMode?: boolean;
     maxHopSlippage?: BigNumber[];
     urVersion?: URVersion;
+    tokenTransferMode?: TokenTransferMode;
+    chainId?: number;
 };
 export declare class UniswapTrade implements Command {
     trade: RouterTrade<Currency, Currency, TradeType>;

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export * from './entities';
 export * from './utils/routerTradeAdapter';
 export { RoutePlanner, CommandType, COMMAND_DEFINITION, Parser, Subparser } from './utils/routerCommands';
 export type { CommandDefinition, ParamType } from './utils/routerCommands';
-export { UNIVERSAL_ROUTER_CREATION_BLOCK, UNIVERSAL_ROUTER_ADDRESS, ROUTER_AS_RECIPIENT, WETH_ADDRESS, UniversalRouterVersion, } from './utils/constants';
+export { UNIVERSAL_ROUTER_CREATION_BLOCK, UNIVERSAL_ROUTER_ADDRESS, SWAP_PROXY_ADDRESS, ROUTER_AS_RECIPIENT, WETH_ADDRESS, UniversalRouterVersion, } from './utils/constants';
 export { CommandParser, GenericCommandParser } from './utils/commandParser';
 export type { UniversalRouterCommand, UniversalRouterCall, Param, CommandsDefinition } from './utils/commandParser';
 export type { Permit2Permit } from './utils/inputTokens';

package/dist/swapRouter.d.ts

@@ -38,6 +38,7 @@ export interface MigrateV3ToV4Options {
 }
 export declare abstract class SwapRouter {
     static INTERFACE: Interface;
+    static PROXY_INTERFACE: Interface;
     static swapCallParameters(trades: RouterTrade<Currency, Currency, TradeType>, options: SwapOptions, bridgeOptions?: AcrossV4DepositV3Params[]): MethodParameters;
     /**
      * Generate EIP712 payload for signed execution (no signing performed)
@@ -78,4 +79,9 @@ export declare abstract class SwapRouter {
      * @param config the router config
      */
     private static encodePlan;
+    /**
+     * Encodes a planned route into calldata targeting the SwapProxy contract.
+     * The proxy pulls ERC20 tokens from the user into the UR, then executes commands.
+     */
+    private static encodeProxyPlan;
 }

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

@@ -449,6 +449,7 @@ var _routerConfigs, _routerConfigs2, _routerConfigs3, _routerConfigs4, _routerCo
   UniversalRouterVersion["V2_1"] = "2.1";
 })(exports.UniversalRouterVersion || (exports.UniversalRouterVersion = {}));
 var WETH_NOT_SUPPORTED_ON_CHAIN = '0x0000000000000000000000000000000000000000';
+var SWAP_PROXY_DEPLOY_ADDRESS = '0x02E5be68D46DAc0B524905bfF209cf47EE6dB2a9';
 // Todo: Change `CHAIN_CONFIGS` to pull the UR address with v4
 var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   weth: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
@@ -461,7 +462,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs[exports.UniversalRouterVersion.V2_1] = {
     address: '0xd92a36b0000531ef3063ded4de20a0783308446c',
     creationBlock: 23836348
-  }, _routerConfigs)
+  }, _routerConfigs),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[5] = {
   weth: '0xb4fbf271143f4fbf7b91a5ded31805e42b2208d6',
   routerConfigs: (_routerConfigs2 = {}, _routerConfigs2[exports.UniversalRouterVersion.V1_2] = {
@@ -485,7 +487,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs3[exports.UniversalRouterVersion.V2_1] = {
     address: '0x470FFC67b1feEEC31D16C46AC7545C98716a194c',
     creationBlock: 9664766
-  }, _routerConfigs3)
+  }, _routerConfigs3),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[137] = {
   weth: '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270',
   routerConfigs: (_routerConfigs4 = {}, _routerConfigs4[exports.UniversalRouterVersion.V1_2] = {
@@ -497,7 +500,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs4[exports.UniversalRouterVersion.V2_1] = {
     address: '0xE27610fD9dD05FC061366bc9dA414CA6F948f204',
     creationBlock: 79245524
-  }, _routerConfigs4)
+  }, _routerConfigs4),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[80001] = {
   weth: '0x9c3C9283D3e44854697Cd22D3Faa240Cfb032889',
   routerConfigs: (_routerConfigs5 = {}, _routerConfigs5[exports.UniversalRouterVersion.V1_2] = {
@@ -521,7 +525,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs6[exports.UniversalRouterVersion.V2_1] = {
     address: '0xde20EEE5398D3790a4D356e8925bD21Ea65D99Af',
     creationBlock: 143998769
-  }, _routerConfigs6)
+  }, _routerConfigs6),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[420] = {
   weth: '0x4200000000000000000000000000000000000006',
   routerConfigs: (_routerConfigs7 = {}, _routerConfigs7[exports.UniversalRouterVersion.V1_2] = {
@@ -545,7 +550,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs8[exports.UniversalRouterVersion.V2_1] = {
     address: '0x96b2FD2F80e9428Daa65d859653117D453981AB4',
     creationBlock: 402060097
-  }, _routerConfigs8)
+  }, _routerConfigs8),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[421613] = {
   weth: '0xe39Ab88f8A4777030A534146A9Ca3B52bd5D43A3',
   routerConfigs: (_routerConfigs9 = {}, _routerConfigs9[exports.UniversalRouterVersion.V1_2] = {
@@ -569,7 +575,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs0[exports.UniversalRouterVersion.V2_1] = {
     address: '0xBB8Ed9bF0BFF210652AE5f473a849F82e990DDf6',
     creationBlock: 51696199
-  }, _routerConfigs0)
+  }, _routerConfigs0),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[44787] = {
   weth: WETH_NOT_SUPPORTED_ON_CHAIN,
   routerConfigs: (_routerConfigs1 = {}, _routerConfigs1[exports.UniversalRouterVersion.V1_2] = {
@@ -593,7 +600,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs10[exports.UniversalRouterVersion.V2_1] = {
     address: '0x91BF3bfAEf8D771A74E1A8fE460b3EE646b2e588',
     creationBlock: 68794488
-  }, _routerConfigs10)
+  }, _routerConfigs10),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[43114] = {
   weth: '0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7',
   routerConfigs: (_routerConfigs11 = {}, _routerConfigs11[exports.UniversalRouterVersion.V1_2] = {
@@ -605,7 +613,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs11[exports.UniversalRouterVersion.V2_1] = {
     address: '0x0Cf1f86B331A03179646341D10A2A87515087221',
     creationBlock: 72254439
-  }, _routerConfigs11)
+  }, _routerConfigs11),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[84531] = {
   weth: '0x4200000000000000000000000000000000000006',
   routerConfigs: (_routerConfigs12 = {}, _routerConfigs12[exports.UniversalRouterVersion.V1_2] = {
@@ -629,7 +638,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs13[exports.UniversalRouterVersion.V2_1] = {
     address: '0xf3a4f4094bd2c6c06ca2f61789d8727b8d1e7259',
     creationBlock: 38404211
-  }, _routerConfigs13)
+  }, _routerConfigs13),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[81457] = {
   weth: '0x4300000000000000000000000000000000000004',
   routerConfigs: (_routerConfigs14 = {}, _routerConfigs14[exports.UniversalRouterVersion.V1_2] = {
@@ -641,7 +651,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs14[exports.UniversalRouterVersion.V2_1] = {
     address: '0x77c0097c1acf6fd84878d3f7c0603e3f04e8bec7',
     creationBlock: 27394047
-  }, _routerConfigs14)
+  }, _routerConfigs14),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[7777777] = {
   weth: '0x4200000000000000000000000000000000000006',
   routerConfigs: (_routerConfigs15 = {}, _routerConfigs15[exports.UniversalRouterVersion.V1_2] = {
@@ -653,7 +664,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs15[exports.UniversalRouterVersion.V2_1] = {
     address: '0x880853091b60f80301a0c1d2f9893c4993041295',
     creationBlock: 38452170
-  }, _routerConfigs15)
+  }, _routerConfigs15),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[324] = {
   weth: '0x5aea5775959fbc2557cc8789bc1bf90a239d9a91',
   routerConfigs: (_routerConfigs16 = {}, _routerConfigs16[exports.UniversalRouterVersion.V1_2] = {
@@ -665,7 +677,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs16[exports.UniversalRouterVersion.V2_1] = {
     address: '0x0000000000000000000000000000000000000000',
     creationBlock: 1
-  }, _routerConfigs16)
+  }, _routerConfigs16),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[480] = {
   weth: '0x4200000000000000000000000000000000000006',
   routerConfigs: (_routerConfigs17 = {}, _routerConfigs17[exports.UniversalRouterVersion.V1_2] = {
@@ -677,7 +690,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs17[exports.UniversalRouterVersion.V2_1] = {
     address: '0x03c4f6b55733cdf3caa07c01e5b83ddee3381f60',
     creationBlock: 22131418
-  }, _routerConfigs17)
+  }, _routerConfigs17),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[1301] = {
   weth: '0x4200000000000000000000000000000000000006',
   routerConfigs: (_routerConfigs18 = {}, _routerConfigs18[exports.UniversalRouterVersion.V1_2] = {
@@ -689,7 +703,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs18[exports.UniversalRouterVersion.V2_1] = {
     address: '0x7F9B8D606E0F35E5073ABf93695814530b28a37b',
     creationBlock: 36746405
-  }, _routerConfigs18)
+  }, _routerConfigs18),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[130] = {
   weth: '0x4200000000000000000000000000000000000006',
   routerConfigs: (_routerConfigs19 = {}, _routerConfigs19[exports.UniversalRouterVersion.V1_2] = {
@@ -701,7 +716,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs19[exports.UniversalRouterVersion.V2_1] = {
     address: '0xe6039ae5b44f90d56c6b029354fb22999861a9a0',
     creationBlock: 32850661
-  }, _routerConfigs19)
+  }, _routerConfigs19),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[10143] = {
   weth: '0x760AfE86e5de5fa0Ee542fc7B7B713e1c5425701',
   routerConfigs: (_routerConfigs20 = {}, _routerConfigs20[exports.UniversalRouterVersion.V1_2] = {
@@ -713,7 +729,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs20[exports.UniversalRouterVersion.V2_1] = {
     address: '0x0000000000000000000000000000000000000000',
     creationBlock: 1
-  }, _routerConfigs20)
+  }, _routerConfigs20),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[84532] = {
   weth: '0x4200000000000000000000000000000000000006',
   routerConfigs: (_routerConfigs21 = {}, _routerConfigs21[exports.UniversalRouterVersion.V1_2] = {
@@ -725,7 +742,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs21[exports.UniversalRouterVersion.V2_1] = {
     address: '0x0000000000000000000000000000000000000000',
     creationBlock: 1
-  }, _routerConfigs21)
+  }, _routerConfigs21),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[1868] = {
   weth: '0x4200000000000000000000000000000000000006',
   routerConfigs: (_routerConfigs22 = {}, _routerConfigs22[exports.UniversalRouterVersion.V1_2] = {
@@ -737,7 +755,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs22[exports.UniversalRouterVersion.V2_1] = {
     address: '0xdb1d5986551c820bd0f3b1caca3e77ce03acb5ef',
     creationBlock: 15232223
-  }, _routerConfigs22)
+  }, _routerConfigs22),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[143] = {
   weth: '0x3bd359C1119dA7Da1D913D1C4D2B7c461115433A',
   routerConfigs: (_routerConfigs23 = {}, _routerConfigs23[exports.UniversalRouterVersion.V1_2] = {
@@ -749,7 +768,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs23[exports.UniversalRouterVersion.V2_1] = {
     address: '0xBC2A036E5027b9AE57BbA847eF88E1b14823F7B1',
     creationBlock: 36720825
-  }, _routerConfigs23)
+  }, _routerConfigs23),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[59144] = {
   weth: '0xe5D7C2a44FfDDf6b295A15c148167daaAf5Cf34f',
   routerConfigs: (_routerConfigs24 = {}, _routerConfigs24[exports.UniversalRouterVersion.V1_2] = {
@@ -761,7 +781,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs24[exports.UniversalRouterVersion.V2_1] = {
     address: '0xba548ce7a95f87bc66a0c7c6eab1e428735f8b57',
     creationBlock: 1
-  }, _routerConfigs24)
+  }, _routerConfigs24),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[4217] = {
   weth: WETH_NOT_SUPPORTED_ON_CHAIN,
   routerConfigs: (_routerConfigs25 = {}, _routerConfigs25[exports.UniversalRouterVersion.V1_2] = {
@@ -773,7 +794,8 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs25[exports.UniversalRouterVersion.V2_1] = {
     address: '0xa2dc7d0266f0cc50b3eeaf36c9bfcecff1beea91',
     creationBlock: 1
-  }, _routerConfigs25)
+  }, _routerConfigs25),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS[196] = {
   weth: '0xe538905cf8410324e03A5A23C1c177a474D59b2b',
   routerConfigs: (_routerConfigs26 = {}, _routerConfigs26[exports.UniversalRouterVersion.V1_2] = {
@@ -785,12 +807,19 @@ var CHAIN_CONFIGS = (_CHAIN_CONFIGS = {}, _CHAIN_CONFIGS[1] = {
   }, _routerConfigs26[exports.UniversalRouterVersion.V2_1] = {
     address: '0x0000000000000000000000000000000000000000',
     creationBlock: 1
-  }, _routerConfigs26)
+  }, _routerConfigs26),
+  swapProxy: SWAP_PROXY_DEPLOY_ADDRESS
 }, _CHAIN_CONFIGS);
 var UNIVERSAL_ROUTER_ADDRESS = function UNIVERSAL_ROUTER_ADDRESS(version, chainId) {
   if (!(chainId in CHAIN_CONFIGS)) throw new Error("Universal Router not deployed on chain " + chainId);
   return CHAIN_CONFIGS[chainId].routerConfigs[version].address;
 };
+var SWAP_PROXY_ADDRESS = function SWAP_PROXY_ADDRESS(chainId) {
+  if (!(chainId in CHAIN_CONFIGS)) throw new Error("SwapProxy not deployed on chain " + chainId);
+  var proxy = CHAIN_CONFIGS[chainId].swapProxy;
+  if (!proxy) throw new Error("SwapProxy not configured for chain " + chainId);
+  return proxy;
+};
 var UNIVERSAL_ROUTER_CREATION_BLOCK = function UNIVERSAL_ROUTER_CREATION_BLOCK(version, chainId) {
   if (!(chainId in CHAIN_CONFIGS)) throw new Error("Universal Router not deployed on chain " + chainId);
   return CHAIN_CONFIGS[chainId].routerConfigs[version].creationBlock;
@@ -814,6 +843,10 @@ function encodeFeeBips(fee) {
   return v3Sdk.toHex(fee.multiply(10000).quotient);
 }
 
+(function (TokenTransferMode) {
+  TokenTransferMode["Permit2"] = "Permit2";
+  TokenTransferMode["ApproveProxy"] = "ApproveProxy";
+})(exports.TokenTransferMode || (exports.TokenTransferMode = {}));
 var REFUND_ETH_PRICE_IMPACT_THRESHOLD = /*#__PURE__*/new sdkCore.Percent(50, 100);
 // Wrapper for uniswap router-sdk trade entity to encode swaps for Universal Router
 // also translates trade objects from previous (v2, v3) SDKs
@@ -823,7 +856,12 @@ var UniswapTrade = /*#__PURE__*/function () {
     this.options = options;
     this.tradeType = exports.RouterActionType.UniswapTrade;
     if (!!options.fee && !!options.flatFee) throw new Error('Only one fee option permitted');
-    if (this.inputRequiresWrap || this.inputRequiresUnwrap || this.options.useRouterBalance) {
+    if (options.tokenTransferMode === exports.TokenTransferMode.ApproveProxy) {
+      if (!options.recipient || options.recipient === 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.payerIsUser = false;
     } else {
       this.payerIsUser = true;
@@ -837,8 +875,11 @@ var UniswapTrade = /*#__PURE__*/function () {
       // TODO: optimize if only one v2 pool we can directly send this to the pool
       planner.addCommand(exports.CommandType.WRAP_ETH, [ROUTER_AS_RECIPIENT, this.trade.maximumAmountIn(this.options.slippageTolerance).quotient.toString()]);
     } else if (this.inputRequiresUnwrap) {
-      // send wrapped token to router to unwrap
-      planner.addCommand(exports.CommandType.PERMIT2_TRANSFER_FROM, [this.trade.inputAmount.currency.address, ROUTER_AS_RECIPIENT, this.trade.maximumAmountIn(this.options.slippageTolerance).quotient.toString()]);
+      if (this.options.tokenTransferMode !== exports.TokenTransferMode.ApproveProxy) {
+        // send wrapped token to router to unwrap via Permit2
+        planner.addCommand(exports.CommandType.PERMIT2_TRANSFER_FROM, [this.trade.inputAmount.currency.address, 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(exports.CommandType.UNWRAP_WETH, [ROUTER_AS_RECIPIENT, 0]);
     }
     // The overall recipient at the end of the trade, SENDER_AS_RECIPIENT uses the msg.sender
@@ -913,6 +954,9 @@ var UniswapTrade = /*#__PURE__*/function () {
         planner.addCommand(exports.CommandType.UNWRAP_WETH, [this.options.recipient, 0]);
       } else if (this.inputRequiresUnwrap) {
         planner.addCommand(exports.CommandType.WRAP_ETH, [this.options.recipient, CONTRACT_BALANCE]);
+      } else if (this.options.tokenTransferMode === exports.TokenTransferMode.ApproveProxy) {
+        // Proxy pulled maximumAmountIn into the UR; sweep any unused input back to the user
+        planner.addCommand(exports.CommandType.SWEEP, [getCurrencyAddress(this.trade.inputAmount.currency), this.options.recipient, 0]);
       } else if (this.trade.inputAmount.currency.isNative) {
         // must refund extra native currency sent along for native v4 trades (no input transition)
         planner.addCommand(exports.CommandType.SWEEP, [ETH_ADDRESS, this.options.recipient, 0]);
@@ -1287,11 +1331,19 @@ function generateNonce() {
  */
 var NONCE_SKIP_CHECK = '0x' + /*#__PURE__*/'f'.repeat(64); // bytes32(type(uint256).max)
 
+var _UR_VERSION_MAP;
 function isMint(options) {
   return Object.keys(options).some(function (k) {
     return k === 'recipient';
   });
 }
+var UR_VERSION_MAP = (_UR_VERSION_MAP = {}, _UR_VERSION_MAP[v4Sdk.URVersion.V2_0] = exports.UniversalRouterVersion.V2_0, _UR_VERSION_MAP[v4Sdk.URVersion.V2_1] = exports.UniversalRouterVersion.V2_1, _UR_VERSION_MAP);
+function toUniversalRouterVersion(urVersion) {
+  if (urVersion === undefined) return undefined;
+  var mapped = UR_VERSION_MAP[urVersion];
+  if (!mapped) throw new Error("Unsupported URVersion: " + urVersion);
+  return mapped;
+}
 var SwapRouter = /*#__PURE__*/function () {
   function SwapRouter() {}
   SwapRouter.swapCallParameters = function swapCallParameters(trades, options, bridgeOptions // Optional bridge parameters
@@ -1300,9 +1352,15 @@ var SwapRouter = /*#__PURE__*/function () {
     var planner = new RoutePlanner();
     var trade = new UniswapTrade(trades, options);
     var inputCurrency = trade.trade.inputAmount.currency;
-    !!(inputCurrency.isNative && !!options.inputTokenPermit) ?  invariant(false, 'NATIVE_INPUT_PERMIT')  : void 0;
-    if (options.inputTokenPermit) {
-      encodePermit(planner, options.inputTokenPermit);
+    if (options.tokenTransferMode === exports.TokenTransferMode.ApproveProxy) {
+      !!inputCurrency.isNative ?  invariant(false, 'PROXY_NATIVE_INPUT: SwapProxy only supports ERC20 input')  : void 0;
+      !!!options.chainId ?  invariant(false, 'PROXY_MISSING_CHAIN_ID: chainId required when tokenTransferMode is ApproveProxy')  : void 0;
+      !!options.inputTokenPermit ?  invariant(false, 'PROXY_PERMIT_CONFLICT: Permit2 not used with SwapProxy')  : void 0;
+    } else {
+      !!(inputCurrency.isNative && !!options.inputTokenPermit) ?  invariant(false, 'NATIVE_INPUT_PERMIT')  : void 0;
+      if (options.inputTokenPermit) {
+        encodePermit(planner, options.inputTokenPermit);
+      }
     }
     var nativeCurrencyValue = inputCurrency.isNative ? ethers.BigNumber.from(trade.trade.maximumAmountIn(options.slippageTolerance).quotient.toString()) : ethers.BigNumber.from(0);
     trade.encode(planner, {
@@ -1315,6 +1373,9 @@ var SwapRouter = /*#__PURE__*/function () {
         planner.addAcrossBridge(bridge);
       }
     }
+    if (options.tokenTransferMode === exports.TokenTransferMode.ApproveProxy) {
+      return SwapRouter.encodeProxyPlan(planner, trade, options);
+    }
     return SwapRouter.encodePlan(planner, nativeCurrencyValue, {
       deadline: options.deadlineOrPreviousBlockhash ? ethers.BigNumber.from(options.deadlineOrPreviousBlockhash) : undefined
     });
@@ -1496,10 +1557,30 @@ var SwapRouter = /*#__PURE__*/function () {
       calldata: calldata,
       value: nativeCurrencyValue.toHexString()
     };
+  }
+  /**
+   * Encodes a planned route into calldata targeting the SwapProxy contract.
+   * The proxy pulls ERC20 tokens from the user into the UR, then executes commands.
+   */;
+  SwapRouter.encodeProxyPlan = function encodeProxyPlan(planner, trade, options) {
+    var _toUniversalRouterVer;
+    var commands = planner.commands,
+      inputs = planner.inputs;
+    var urVersion = (_toUniversalRouterVer = toUniversalRouterVersion(options.urVersion)) != null ? _toUniversalRouterVer : exports.UniversalRouterVersion.V2_0;
+    var routerAddress = UNIVERSAL_ROUTER_ADDRESS(urVersion, options.chainId);
+    var inputToken = trade.trade.inputAmount.currency.address;
+    var inputAmount = ethers.BigNumber.from(trade.trade.maximumAmountIn(options.slippageTolerance).quotient.toString());
+    var deadline = options.deadlineOrPreviousBlockhash ? ethers.BigNumber.from(options.deadlineOrPreviousBlockhash) : ethers.BigNumber.from(Math.floor(Date.now() / 1000) + 1800); // 30 min default
+    var calldata = SwapRouter.PROXY_INTERFACE.encodeFunctionData('execute', [routerAddress, inputToken, inputAmount, commands, inputs, deadline]);
+    return {
+      calldata: calldata,
+      value: ethers.BigNumber.from(0).toHexString()
+    };
   };
   return SwapRouter;
 }();
 SwapRouter.INTERFACE = /*#__PURE__*/new abi.Interface(UniversalRouter.abi);
+SwapRouter.PROXY_INTERFACE = /*#__PURE__*/new abi.Interface(['function execute(address router, address token, uint256 amount, bytes calldata commands, bytes[] calldata inputs, uint256 deadline) external']);
 
 var UnwrapWETH = /*#__PURE__*/function () {
   function UnwrapWETH(amount, chainId, permit2) {
@@ -1831,6 +1912,7 @@ exports.NONCE_SKIP_CHECK = NONCE_SKIP_CHECK;
 exports.ROUTER_AS_RECIPIENT = ROUTER_AS_RECIPIENT;
 exports.RoutePlanner = RoutePlanner;
 exports.RouterTradeAdapter = RouterTradeAdapter;
+exports.SWAP_PROXY_ADDRESS = SWAP_PROXY_ADDRESS;
 exports.SwapRouter = SwapRouter;
 exports.UNIVERSAL_ROUTER_ADDRESS = UNIVERSAL_ROUTER_ADDRESS;
 exports.UNIVERSAL_ROUTER_CREATION_BLOCK = UNIVERSAL_ROUTER_CREATION_BLOCK;