@fenine/universal-router-sdk 1.0.0

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

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeSwapStep = void 0;
+const v4_sdk_1 = require("@uniswap/v4-sdk");
+const constants_1 = require("./constants");
+const routerCommands_1 = require("./routerCommands");
+const encodeV4Action_1 = require("./encodeV4Action");
+// V2/V3 swap params hardcode payerIsUser=false; encodeSwaps pulls funds into the router first via PERMIT2_TRANSFER_FROM
+function encodeSwapStep(planner, step, urVersion) {
+    var _a, _b, _c, _d;
+    const useV2_1_1 = (0, constants_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(routerCommands_1.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(routerCommands_1.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(routerCommands_1.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(routerCommands_1.CommandType.V3_SWAP_EXACT_OUT, params, false, urVersion);
+            return;
+        }
+        case 'V4_SWAP': {
+            const v4Planner = new v4_sdk_1.V4Planner();
+            for (const v4Action of step.v4Actions) {
+                const encoded = (0, encodeV4Action_1.encodeV4Action)(v4Action, urVersion);
+                v4Planner.addAction(encoded.action, encoded.params, (0, encodeV4Action_1.toV4URVersion)(urVersion));
+            }
+            planner.addCommand(routerCommands_1.CommandType.V4_SWAP, [v4Planner.finalize()], false, urVersion);
+            return;
+        }
+        case 'WRAP_ETH':
+            planner.addCommand(routerCommands_1.CommandType.WRAP_ETH, [step.recipient, step.amount], false, urVersion);
+            return;
+        case 'UNWRAP_WETH':
+            planner.addCommand(routerCommands_1.CommandType.UNWRAP_WETH, [step.recipient, step.amountMin], false, urVersion);
+            return;
+        default:
+            throw new Error(`Unknown swap step type: ${step.type}`);
+    }
+}
+exports.encodeSwapStep = encodeSwapStep;
+//# sourceMappingURL=encodeSwapStep.js.map

package/dist/cjs/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/cjs/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/cjs/src/utils/encodeV4Action.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeV4Action = exports.toV4URVersion = void 0;
+const v4_sdk_1 = require("@uniswap/v4-sdk");
+const constants_1 = require("./constants");
+const ACTION_NAME_TO_ENUM = Object.fromEntries(Object.entries(v4_sdk_1.Actions).filter(([key]) => isNaN(Number(key))));
+const V4_UR_VERSION_MAP = {
+    [constants_1.UniversalRouterVersion.V2_0]: v4_sdk_1.URVersion.V2_0,
+    [constants_1.UniversalRouterVersion.V2_1_1]: v4_sdk_1.URVersion.V2_1_1,
+};
+function toV4URVersion(version) {
+    if (version === undefined)
+        return v4_sdk_1.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;
+}
+exports.toV4URVersion = toV4URVersion;
+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 = (0, constants_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}`);
+    }
+}
+exports.encodeV4Action = encodeV4Action;
+//# sourceMappingURL=encodeV4Action.js.map

package/dist/cjs/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/cjs/src/utils/getCurrencyAddress.d.ts

@@ -0,0 +1,2 @@
+import { Currency } from '@fenine/sdk-core';
+export declare function getCurrencyAddress(currency: Currency): string;

package/dist/cjs/src/utils/getCurrencyAddress.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrencyAddress = void 0;
+const constants_1 = require("./constants");
+function getCurrencyAddress(currency) {
+    return currency.isNative ? constants_1.ETH_ADDRESS : currency.wrapped.address;
+}
+exports.getCurrencyAddress = getCurrencyAddress;
+//# sourceMappingURL=getCurrencyAddress.js.map

package/dist/cjs/src/utils/getCurrencyAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCurrencyAddress.js","sourceRoot":"","sources":["../../../../src/utils/getCurrencyAddress.ts"],"names":[],"mappings":";;;AACA,2CAAyC;AAEzC,SAAgB,kBAAkB,CAAC,QAAkB;IACnD,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,uBAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAA;AACnE,CAAC;AAFD,gDAEC"}

package/dist/cjs/src/utils/inputTokens.d.ts

@@ -0,0 +1,23 @@
+import { BigintIsh } from '@fenine/sdk-core';
+import { NFTPermitOptions } from '@fenine/v3-sdk';
+import { PermitSingle } from '@fenine/permit2-sdk';
+import { RoutePlanner } from './routerCommands';
+export interface Permit2Permit extends PermitSingle {
+    signature: string;
+}
+export type ApproveProtocol = {
+    token: string;
+    protocol: string;
+};
+export type Permit2TransferFrom = {
+    token: string;
+    amount: string;
+    recipient?: string;
+};
+export type InputTokenOptions = {
+    permit2Permit?: Permit2Permit;
+    permit2TransferFrom?: Permit2TransferFrom;
+};
+export declare function encodePermit(planner: RoutePlanner, permit2: Permit2Permit): void;
+export declare function encodeV3PositionPermit(planner: RoutePlanner, permit: NFTPermitOptions, tokenId: BigintIsh): void;
+export declare function encodeInputTokenOptions(planner: RoutePlanner, options: InputTokenOptions): void;

package/dist/cjs/src/utils/inputTokens.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeInputTokenOptions = exports.encodeV3PositionPermit = exports.encodePermit = void 0;
+const tslib_1 = require("tslib");
+const tiny_invariant_1 = tslib_1.__importDefault(require("tiny-invariant"));
+const ethers_1 = require("ethers");
+const sdk_core_1 = require("@fenine/sdk-core");
+const v3_sdk_1 = require("@fenine/v3-sdk");
+const routerCommands_1 = require("./routerCommands");
+const constants_1 = require("./constants");
+const SIGNATURE_LENGTH = 65;
+const EIP_2098_SIGNATURE_LENGTH = 64;
+function encodePermit(planner, permit2) {
+    let signature = permit2.signature;
+    const length = ethers_1.ethers.utils.arrayify(permit2.signature).length;
+    // signature data provided for EIP-1271 may have length different from ECDSA signature
+    if (length === SIGNATURE_LENGTH || length === EIP_2098_SIGNATURE_LENGTH) {
+        // sanitizes signature to cover edge cases of malformed EIP-2098 sigs and v used as recovery id
+        signature = ethers_1.ethers.utils.joinSignature(ethers_1.ethers.utils.splitSignature(permit2.signature));
+    }
+    planner.addCommand(routerCommands_1.CommandType.PERMIT2_PERMIT, [permit2, signature]);
+}
+exports.encodePermit = encodePermit;
+function encodeV3PositionPermit(planner, permit, tokenId) {
+    const calldata = v3_sdk_1.NonfungiblePositionManager.INTERFACE.encodeFunctionData('permit', [
+        (0, sdk_core_1.validateAndParseAddress)(permit.spender),
+        tokenId,
+        permit.deadline,
+        permit.v,
+        permit.r,
+        permit.s,
+    ]);
+    planner.addCommand(routerCommands_1.CommandType.V3_POSITION_MANAGER_PERMIT, [calldata]);
+}
+exports.encodeV3PositionPermit = encodeV3PositionPermit;
+// Handles the encoding of commands needed to gather input tokens for a trade
+// Approval: The router approving another address to take tokens.
+//   note: Only seaport and sudoswap support this action. Approvals are left open.
+// Permit: A Permit2 signature-based Permit to allow the router to access a user's tokens
+// Transfer: A Permit2 TransferFrom of tokens from a user to either the router or another address
+function encodeInputTokenOptions(planner, options) {
+    // first ensure that all tokens provided for encoding are the same
+    if (!!options.permit2TransferFrom && !!options.permit2Permit)
+        (0, tiny_invariant_1.default)(options.permit2TransferFrom.token === options.permit2Permit.details.token, `inconsistent token`);
+    // if this order has a options.permit2Permit, encode it
+    if (!!options.permit2Permit) {
+        encodePermit(planner, options.permit2Permit);
+    }
+    if (!!options.permit2TransferFrom) {
+        planner.addCommand(routerCommands_1.CommandType.PERMIT2_TRANSFER_FROM, [
+            options.permit2TransferFrom.token,
+            options.permit2TransferFrom.recipient ? options.permit2TransferFrom.recipient : constants_1.ROUTER_AS_RECIPIENT,
+            options.permit2TransferFrom.amount,
+        ]);
+    }
+}
+exports.encodeInputTokenOptions = encodeInputTokenOptions;
+//# sourceMappingURL=inputTokens.js.map

package/dist/cjs/src/utils/inputTokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputTokens.js","sourceRoot":"","sources":["../../../../src/utils/inputTokens.ts"],"names":[],"mappings":";;;;AAAA,4EAAsC;AACtC,mCAA+B;AAC/B,+CAAqE;AACrE,2CAA6E;AAE7E,qDAA4D;AAC5D,2CAAiD;AAsBjD,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAC3B,MAAM,yBAAyB,GAAG,EAAE,CAAA;AAEpC,SAAgB,YAAY,CAAC,OAAqB,EAAE,OAAsB;IACxE,IAAI,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IAEjC,MAAM,MAAM,GAAG,eAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAA;IAC9D,sFAAsF;IACtF,IAAI,MAAM,KAAK,gBAAgB,IAAI,MAAM,KAAK,yBAAyB,EAAE;QACvE,+FAA+F;QAC/F,SAAS,GAAG,eAAM,CAAC,KAAK,CAAC,aAAa,CAAC,eAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;KACvF;IAED,OAAO,CAAC,UAAU,CAAC,4BAAW,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;AACtE,CAAC;AAXD,oCAWC;AAED,SAAgB,sBAAsB,CAAC,OAAqB,EAAE,MAAwB,EAAE,OAAkB;IACxG,MAAM,QAAQ,GAAG,mCAA0B,CAAC,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE;QACjF,IAAA,kCAAuB,EAAC,MAAM,CAAC,OAAO,CAAC;QACvC,OAAO;QACP,MAAM,CAAC,QAAQ;QACf,MAAM,CAAC,CAAC;QACR,MAAM,CAAC,CAAC;QACR,MAAM,CAAC,CAAC;KACT,CAAC,CAAA;IAEF,OAAO,CAAC,UAAU,CAAC,4BAAW,CAAC,0BAA0B,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;AACxE,CAAC;AAXD,wDAWC;AAED,6EAA6E;AAC7E,iEAAiE;AACjE,kFAAkF;AAClF,yFAAyF;AACzF,iGAAiG;AACjG,SAAgB,uBAAuB,CAAC,OAAqB,EAAE,OAA0B;IACvF,kEAAkE;IAClE,IAAI,CAAC,CAAC,OAAO,CAAC,mBAAmB,IAAI,CAAC,CAAC,OAAO,CAAC,aAAa;QAC1D,IAAA,wBAAS,EAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,KAAK,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAA;IAE5G,uDAAuD;IACvD,IAAI,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE;QAC3B,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;KAC7C;IAED,IAAI,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE;QACjC,OAAO,CAAC,UAAU,CAAC,4BAAW,CAAC,qBAAqB,EAAE;YACpD,OAAO,CAAC,mBAAmB,CAAC,KAAK;YACjC,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,+BAAmB;YACnG,OAAO,CAAC,mBAAmB,CAAC,MAAM;SACnC,CAAC,CAAA;KACH;AACH,CAAC;AAjBD,0DAiBC"}

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

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

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

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeEncodeSwapsSpec = void 0;
+const uniswap_1 = require("../entities/actions/uniswap");
+const constants_1 = require("./constants");
+// Fills the four optional fields that `validateEncodeSwaps` and `computeEncodeSwapsAmounts` require.
+function normalizeEncodeSwapsSpec(spec) {
+    var _a, _b, _c, _d;
+    return {
+        ...spec,
+        recipient: (_a = spec.recipient) !== null && _a !== void 0 ? _a : constants_1.SENDER_AS_RECIPIENT,
+        tokenTransferMode: (_b = spec.tokenTransferMode) !== null && _b !== void 0 ? _b : uniswap_1.TokenTransferMode.Permit2,
+        urVersion: (_c = spec.urVersion) !== null && _c !== void 0 ? _c : constants_1.UniversalRouterVersion.V2_0,
+        safeMode: (_d = spec.safeMode) !== null && _d !== void 0 ? _d : false,
+    };
+}
+exports.normalizeEncodeSwapsSpec = normalizeEncodeSwapsSpec;
+//# sourceMappingURL=normalizeEncodeSwapsSpec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeEncodeSwapsSpec.js","sourceRoot":"","sources":["../../../../src/utils/normalizeEncodeSwapsSpec.ts"],"names":[],"mappings":";;;AAAA,yDAA+D;AAE/D,2CAAyE;AAEzE,qGAAqG;AACrG,SAAgB,wBAAwB,CAAC,IAAuB;;IAC9D,OAAO;QACL,GAAG,IAAI;QACP,SAAS,EAAE,MAAA,IAAI,CAAC,SAAS,mCAAI,+BAAmB;QAChD,iBAAiB,EAAE,MAAA,IAAI,CAAC,iBAAiB,mCAAI,2BAAiB,CAAC,OAAO;QACtE,SAAS,EAAE,MAAA,IAAI,CAAC,SAAS,mCAAI,kCAAsB,CAAC,IAAI;QACxD,QAAQ,EAAE,MAAA,IAAI,CAAC,QAAQ,mCAAI,KAAK;KACjC,CAAA;AACH,CAAC;AARD,4DAQC"}

package/dist/cjs/src/utils/numbers.d.ts

@@ -0,0 +1,7 @@
+import { BigNumber } from 'ethers';
+import JSBI from 'jsbi';
+import { Percent } from '@fenine/sdk-core';
+export declare function expandTo18DecimalsBN(n: number): BigNumber;
+export declare function expandTo18Decimals(n: number): JSBI;
+export declare function encodeFeeBips(fee: Percent): string;
+export declare function encodeFee1e18(fee: Percent): string;

package/dist/cjs/src/utils/numbers.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeFee1e18 = exports.encodeFeeBips = exports.expandTo18Decimals = exports.expandTo18DecimalsBN = void 0;
+const tslib_1 = require("tslib");
+const ethers_1 = require("ethers");
+const jsbi_1 = tslib_1.__importDefault(require("jsbi"));
+const bignumber_js_1 = tslib_1.__importDefault(require("bignumber.js"));
+const v3_sdk_1 = require("@fenine/v3-sdk");
+function expandTo18DecimalsBN(n) {
+    // use bn intermediately to allow decimals in intermediate calculations
+    return ethers_1.BigNumber.from(new bignumber_js_1.default(n).times(new bignumber_js_1.default(10).pow(18)).toFixed());
+}
+exports.expandTo18DecimalsBN = expandTo18DecimalsBN;
+function expandTo18Decimals(n) {
+    return jsbi_1.default.BigInt(ethers_1.BigNumber.from(n).mul(ethers_1.BigNumber.from(10).pow(18)).toString());
+}
+exports.expandTo18Decimals = expandTo18Decimals;
+function encodeFeeBips(fee) {
+    return (0, v3_sdk_1.toHex)(fee.multiply(10000).quotient);
+}
+exports.encodeFeeBips = encodeFeeBips;
+const FULL_PORTION_PRECISION = jsbi_1.default.exponentiate(jsbi_1.default.BigInt(10), jsbi_1.default.BigInt(18));
+function encodeFee1e18(fee) {
+    return (0, v3_sdk_1.toHex)(fee.multiply(FULL_PORTION_PRECISION).quotient);
+}
+exports.encodeFee1e18 = encodeFee1e18;
+//# sourceMappingURL=numbers.js.map

package/dist/cjs/src/utils/numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../../../../src/utils/numbers.ts"],"names":[],"mappings":";;;;AAAA,mCAAkC;AAClC,wDAAuB;AACvB,wEAA6B;AAE7B,2CAAsC;AAEtC,SAAgB,oBAAoB,CAAC,CAAS;IAC5C,uEAAuE;IACvE,OAAO,kBAAS,CAAC,IAAI,CAAC,IAAI,sBAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,sBAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;AACtE,CAAC;AAHD,oDAGC;AAED,SAAgB,kBAAkB,CAAC,CAAS;IAC1C,OAAO,cAAI,CAAC,MAAM,CAAC,kBAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,kBAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;AAClF,CAAC;AAFD,gDAEC;AAED,SAAgB,aAAa,CAAC,GAAY;IACxC,OAAO,IAAA,cAAK,EAAC,GAAG,CAAC,QAAQ,CAAC,KAAM,CAAC,CAAC,QAAQ,CAAC,CAAA;AAC7C,CAAC;AAFD,sCAEC;AAED,MAAM,sBAAsB,GAAG,cAAI,CAAC,YAAY,CAAC,cAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,cAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;AAElF,SAAgB,aAAa,CAAC,GAAY;IACxC,OAAO,IAAA,cAAK,EAAC,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,QAAQ,CAAC,CAAA;AAC7D,CAAC;AAFD,sCAEC"}

package/dist/cjs/src/utils/pathCurrency.d.ts

@@ -0,0 +1,3 @@
+import { Currency } from '@fenine/sdk-core';
+import { TPool } from '@uniswap/router-sdk';
+export declare function getPathCurrency(currency: Currency, pool: TPool): Currency;

package/dist/cjs/src/utils/pathCurrency.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPathCurrency = void 0;
+const v4_sdk_1 = require("@uniswap/v4-sdk");
+function getPathCurrency(currency, pool) {
+    // return currency if the currency matches a currency of the pool
+    if (pool.involvesToken(currency)) {
+        return currency;
+        // return if currency.wrapped if pool involves wrapped currency
+    }
+    else if (pool.involvesToken(currency.wrapped)) {
+        return currency.wrapped;
+        // return native currency if pool involves native version of wrapped currency (only applies to V4)
+    }
+    else if (pool instanceof v4_sdk_1.Pool && pool.token0.wrapped.equals(currency)) {
+        return pool.token0;
+    }
+    else if (pool instanceof v4_sdk_1.Pool && pool.token1.wrapped.equals(currency)) {
+        return pool.token1;
+    }
+    else {
+        throw new Error(`Expected currency ${currency.symbol} to be either ${pool.token0.symbol} or ${pool.token1.symbol}`);
+    }
+    return currency; // this line needed for typescript to compile
+}
+exports.getPathCurrency = getPathCurrency;
+//# sourceMappingURL=pathCurrency.js.map

package/dist/cjs/src/utils/pathCurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathCurrency.js","sourceRoot":"","sources":["../../../../src/utils/pathCurrency.ts"],"names":[],"mappings":";;;AACA,4CAAgD;AAGhD,SAAgB,eAAe,CAAC,QAAkB,EAAE,IAAW;IAC7D,iEAAiE;IACjE,IAAI,IAAI,CAAC,aAAa,CAAC,QAAiB,CAAC,EAAE;QACzC,OAAO,QAAQ,CAAA;QAEf,+DAA+D;KAChE;SAAM,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAgB,CAAC,EAAE;QACxD,OAAO,QAAQ,CAAC,OAAO,CAAA;QAEvB,kGAAkG;KACnG;SAAM,IAAI,IAAI,YAAY,aAAM,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;QACzE,OAAO,IAAI,CAAC,MAAM,CAAA;KACnB;SAAM,IAAI,IAAI,YAAY,aAAM,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;QACzE,OAAO,IAAI,CAAC,MAAM,CAAA;KACnB;SAAM;QACL,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,iBAAiB,IAAI,CAAC,MAAM,CAAC,MAAM,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;KACpH;IAED,OAAO,QAAQ,CAAA,CAAC,6CAA6C;AAC/D,CAAC;AAnBD,0CAmBC"}

package/dist/cjs/src/utils/routerCommands.d.ts

@@ -0,0 +1,77 @@
+import { UniversalRouterVersion } from './constants';
+import { AcrossV4DepositV3Params } from '../entities/actions/across';
+/**
+ * CommandTypes
+ * @description Flags that modify a command's execution
+ * @enum {number}
+ */
+export declare enum CommandType {
+    V3_SWAP_EXACT_IN = 0,
+    V3_SWAP_EXACT_OUT = 1,
+    PERMIT2_TRANSFER_FROM = 2,
+    PERMIT2_PERMIT_BATCH = 3,
+    SWEEP = 4,
+    TRANSFER = 5,
+    PAY_PORTION = 6,
+    PAY_PORTION_FULL_PRECISION = 7,
+    V2_SWAP_EXACT_IN = 8,
+    V2_SWAP_EXACT_OUT = 9,
+    PERMIT2_PERMIT = 10,
+    WRAP_ETH = 11,
+    UNWRAP_WETH = 12,
+    PERMIT2_TRANSFER_FROM_BATCH = 13,
+    BALANCE_CHECK_ERC20 = 14,
+    V4_SWAP = 16,
+    V3_POSITION_MANAGER_PERMIT = 17,
+    V3_POSITION_MANAGER_CALL = 18,
+    V4_INITIALIZE_POOL = 19,
+    V4_POSITION_MANAGER_CALL = 20,
+    EXECUTE_SUB_PLAN = 33,
+    ACROSS_V4_DEPOSIT_V3 = 64
+}
+export declare enum Subparser {
+    V3PathExactIn = 0,
+    V3PathExactOut = 1
+}
+export declare enum Parser {
+    Abi = 0,
+    V4Actions = 1,
+    V3Actions = 2
+}
+export type ParamType = {
+    readonly name: string;
+    readonly type: string;
+    readonly subparser?: Subparser;
+};
+export type CommandDefinition = {
+    parser: Parser.Abi;
+    params: ParamType[];
+} | {
+    parser: Parser.V4Actions;
+} | {
+    parser: Parser.V3Actions;
+};
+export declare const COMMAND_DEFINITION: {
+    [key in CommandType]: CommandDefinition;
+};
+export declare const V2V3_SWAP_COMMANDS_V2_1_1: {
+    [key: number]: CommandDefinition;
+};
+export declare class RoutePlanner {
+    commands: string;
+    inputs: string[];
+    constructor();
+    addSubPlan(subplan: RoutePlanner): RoutePlanner;
+    addCommand(type: CommandType, parameters: any[], allowRevert?: boolean, urVersion?: UniversalRouterVersion): RoutePlanner;
+    /**
+     * Add Across bridge deposit command for cross-chain bridging
+     * @param params AcrossV4DepositV3Params containing bridge parameters
+     * @returns RoutePlanner instance for chaining
+     */
+    addAcrossBridge(params: AcrossV4DepositV3Params): RoutePlanner;
+}
+export type RouterCommand = {
+    type: CommandType;
+    encodedInput: string;
+};
+export declare function createCommand(type: CommandType, parameters: any[], urVersion?: UniversalRouterVersion): RouterCommand;