@fenine/universal-router-sdk 1.0.0

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/getCurrencyAddress.d.ts

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

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

@@ -0,0 +1,5 @@
+import { ETH_ADDRESS } from './constants';
+export function getCurrencyAddress(currency) {
+    return currency.isNative ? ETH_ADDRESS : currency.wrapped.address;
+}
+//# sourceMappingURL=getCurrencyAddress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getCurrencyAddress.js","sourceRoot":"","sources":["../../../../src/utils/getCurrencyAddress.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAA;AACnE,CAAC"}

package/dist/esm/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/esm/src/utils/inputTokens.js

@@ -0,0 +1,51 @@
+import invariant from 'tiny-invariant';
+import { ethers } from 'ethers';
+import { validateAndParseAddress } from '@fenine/sdk-core';
+import { NonfungiblePositionManager } from '@fenine/v3-sdk';
+import { CommandType } from './routerCommands';
+import { ROUTER_AS_RECIPIENT } from './constants';
+const SIGNATURE_LENGTH = 65;
+const EIP_2098_SIGNATURE_LENGTH = 64;
+export function encodePermit(planner, permit2) {
+    let signature = permit2.signature;
+    const length = 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.utils.joinSignature(ethers.utils.splitSignature(permit2.signature));
+    }
+    planner.addCommand(CommandType.PERMIT2_PERMIT, [permit2, signature]);
+}
+export function encodeV3PositionPermit(planner, permit, tokenId) {
+    const calldata = NonfungiblePositionManager.INTERFACE.encodeFunctionData('permit', [
+        validateAndParseAddress(permit.spender),
+        tokenId,
+        permit.deadline,
+        permit.v,
+        permit.r,
+        permit.s,
+    ]);
+    planner.addCommand(CommandType.V3_POSITION_MANAGER_PERMIT, [calldata]);
+}
+// 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
+export function encodeInputTokenOptions(planner, options) {
+    // first ensure that all tokens provided for encoding are the same
+    if (!!options.permit2TransferFrom && !!options.permit2Permit)
+        invariant(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(CommandType.PERMIT2_TRANSFER_FROM, [
+            options.permit2TransferFrom.token,
+            options.permit2TransferFrom.recipient ? options.permit2TransferFrom.recipient : ROUTER_AS_RECIPIENT,
+            options.permit2TransferFrom.amount,
+        ]);
+    }
+}
+//# sourceMappingURL=inputTokens.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputTokens.js","sourceRoot":"","sources":["../../../../src/utils/inputTokens.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,uBAAuB,EAAa,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAoB,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AAE7E,OAAO,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAsBjD,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAC3B,MAAM,yBAAyB,GAAG,EAAE,CAAA;AAEpC,MAAM,UAAU,YAAY,CAAC,OAAqB,EAAE,OAAsB;IACxE,IAAI,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IAEjC,MAAM,MAAM,GAAG,MAAM,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,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;KACvF;IAED,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAqB,EAAE,MAAwB,EAAE,OAAkB;IACxG,MAAM,QAAQ,GAAG,0BAA0B,CAAC,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE;QACjF,uBAAuB,CAAC,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,WAAW,CAAC,0BAA0B,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;AACxE,CAAC;AAED,6EAA6E;AAC7E,iEAAiE;AACjE,kFAAkF;AAClF,yFAAyF;AACzF,iGAAiG;AACjG,MAAM,UAAU,uBAAuB,CAAC,OAAqB,EAAE,OAA0B;IACvF,kEAAkE;IAClE,IAAI,CAAC,CAAC,OAAO,CAAC,mBAAmB,IAAI,CAAC,CAAC,OAAO,CAAC,aAAa;QAC1D,SAAS,CAAC,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,WAAW,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,mBAAmB;YACnG,OAAO,CAAC,mBAAmB,CAAC,MAAM;SACnC,CAAC,CAAA;KACH;AACH,CAAC"}

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/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/esm/src/utils/numbers.js

@@ -0,0 +1,19 @@
+import { BigNumber } from 'ethers';
+import JSBI from 'jsbi';
+import bn from 'bignumber.js';
+import { toHex } from '@fenine/v3-sdk';
+export function expandTo18DecimalsBN(n) {
+    // use bn intermediately to allow decimals in intermediate calculations
+    return BigNumber.from(new bn(n).times(new bn(10).pow(18)).toFixed());
+}
+export function expandTo18Decimals(n) {
+    return JSBI.BigInt(BigNumber.from(n).mul(BigNumber.from(10).pow(18)).toString());
+}
+export function encodeFeeBips(fee) {
+    return toHex(fee.multiply(10000).quotient);
+}
+const FULL_PORTION_PRECISION = JSBI.exponentiate(JSBI.BigInt(10), JSBI.BigInt(18));
+export function encodeFee1e18(fee) {
+    return toHex(fee.multiply(FULL_PORTION_PRECISION).quotient);
+}
+//# sourceMappingURL=numbers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../../../../src/utils/numbers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,MAAM,cAAc,CAAA;AAE7B,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAEtC,MAAM,UAAU,oBAAoB,CAAC,CAAS;IAC5C,uEAAuE;IACvE,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAS;IAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;AAClF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAM,CAAC,CAAC,QAAQ,CAAC,CAAA;AAC7C,CAAC;AAED,MAAM,sBAAsB,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;AAElF,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,QAAQ,CAAC,CAAA;AAC7D,CAAC"}

package/dist/esm/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/esm/src/utils/pathCurrency.js

@@ -0,0 +1,23 @@
+import { Pool as V4Pool } from '@uniswap/v4-sdk';
+export 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 V4Pool && pool.token0.wrapped.equals(currency)) {
+        return pool.token0;
+    }
+    else if (pool instanceof V4Pool && 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
+}
+//# sourceMappingURL=pathCurrency.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pathCurrency.js","sourceRoot":"","sources":["../../../../src/utils/pathCurrency.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAGhD,MAAM,UAAU,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,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;QACzE,OAAO,IAAI,CAAC,MAAM,CAAA;KACnB;SAAM,IAAI,IAAI,YAAY,MAAM,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"}

package/dist/esm/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;