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

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

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeV4Action = void 0;
+const v4_sdk_1 = require("@kittycorn-labs/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))));
+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 defaults to false (router custody); validateEncodeSwaps gates when true is allowed
+            return { action, params: [v4Action.currency, v4Action.amount, v4Action.payerIsUser === true] };
+        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/{utils → cjs/src/utils}/getCurrencyAddress.d.ts

@@ -1,2 +1,2 @@
-import { Currency } from '@kittycorn-labs/sdk-core';
-export declare function getCurrencyAddress(currency: Currency): string;
+import { Currency } from '@kittycorn-labs/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/{utils → cjs/src/utils}/inputTokens.d.ts

@@ -1,23 +1,23 @@
-import { BigintIsh } from '@kittycorn-labs/sdk-core';
-import { NFTPermitOptions } from '@kittycorn-labs/v3-sdk';
-import { PermitSingle } from '@uniswap/permit2-sdk';
-import { RoutePlanner } from './routerCommands';
-export interface Permit2Permit extends PermitSingle {
-    signature: string;
-}
-export declare type ApproveProtocol = {
-    token: string;
-    protocol: string;
-};
-export declare type Permit2TransferFrom = {
-    token: string;
-    amount: string;
-    recipient?: string;
-};
-export declare 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;
+import { BigintIsh } from '@kittycorn-labs/sdk-core';
+import { NFTPermitOptions } from '@kittycorn-labs/v3-sdk';
+import { PermitSingle } from '@uniswap/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 bytes_1 = require("@ethersproject/bytes");
+const sdk_core_1 = require("@kittycorn-labs/sdk-core");
+const v3_sdk_1 = require("@kittycorn-labs/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 = (0, bytes_1.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 = (0, bytes_1.joinSignature)((0, bytes_1.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,gDAA8E;AAC9E,uDAA6E;AAC7E,mDAAqF;AAErF,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,IAAA,gBAAQ,EAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAA;IACjD,sFAAsF;IACtF,IAAI,MAAM,KAAK,gBAAgB,IAAI,MAAM,KAAK,yBAAyB,EAAE;QACvE,+FAA+F;QAC/F,SAAS,GAAG,IAAA,qBAAa,EAAC,IAAA,sBAAc,EAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;KAC7D;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,6 @@
+import { Fee, FlatFee, NormalizedSwapSpecification, PortionFee, SwapSpecification } from '../types/encodeSwaps';
+export declare function normalizeEncodeSwapsSpec(spec: SwapSpecification): NormalizedSwapSpecification;
+/** A lone `Fee` becomes a one-element list, so every read site handles multiple recipients by construction. */
+export declare function toFeeList(fee: SwapSpecification['fee']): Fee[];
+export declare function toPortionFeeList(fee: SwapSpecification['fee']): PortionFee[];
+export declare function toFlatFeeList(fee: SwapSpecification['fee']): FlatFee[];

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

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toFlatFeeList = exports.toPortionFeeList = exports.toFeeList = exports.normalizeEncodeSwapsSpec = void 0;
+const uniswap_1 = require("../entities/actions/uniswap");
+const constants_1 = require("./constants");
+// Fills the five optional fields that `validateEncodeSwaps` and `computeEncodeSwapsAmounts` require.
+function normalizeEncodeSwapsSpec(spec) {
+    var _a, _b, _c, _d, _e;
+    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.DEFAULT_UR_VERSION,
+        safeMode: (_d = spec.safeMode) !== null && _d !== void 0 ? _d : false,
+        allowDirectTransfers: (_e = spec.allowDirectTransfers) !== null && _e !== void 0 ? _e : false,
+    };
+}
+exports.normalizeEncodeSwapsSpec = normalizeEncodeSwapsSpec;
+/** A lone `Fee` becomes a one-element list, so every read site handles multiple recipients by construction. */
+function toFeeList(fee) {
+    if (!fee)
+        return [];
+    return Array.isArray(fee) ? fee : [fee];
+}
+exports.toFeeList = toFeeList;
+function toPortionFeeList(fee) {
+    return toFeeList(fee).filter((entry) => entry.kind === 'portion');
+}
+exports.toPortionFeeList = toPortionFeeList;
+function toFlatFeeList(fee) {
+    return toFeeList(fee).filter((entry) => entry.kind === 'flat');
+}
+exports.toFlatFeeList = toFlatFeeList;
+//# 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,2CAAqE;AAErE,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,8BAAkB;QAC/C,QAAQ,EAAE,MAAA,IAAI,CAAC,QAAQ,mCAAI,KAAK;QAChC,oBAAoB,EAAE,MAAA,IAAI,CAAC,oBAAoB,mCAAI,KAAK;KACzD,CAAA;AACH,CAAC;AATD,4DASC;AAED,+GAA+G;AAC/G,SAAgB,SAAS,CAAC,GAA6B;IACrD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAA;IACnB,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AACzC,CAAC;AAHD,8BAGC;AAED,SAAgB,gBAAgB,CAAC,GAA6B;IAC5D,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAuB,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAA;AACxF,CAAC;AAFD,4CAEC;AAED,SAAgB,aAAa,CAAC,GAA6B;IACzD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAoB,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;AAClF,CAAC;AAFD,sCAEC"}

package/dist/{utils → cjs/src/utils}/numbers.d.ts

@@ -1,6 +1,7 @@
-import { BigNumber } from 'ethers';
-import JSBI from 'jsbi';
-import { Percent } from '@kittycorn-labs/sdk-core';
-export declare function expandTo18DecimalsBN(n: number): BigNumber;
-export declare function expandTo18Decimals(n: number): JSBI;
-export declare function encodeFeeBips(fee: Percent): string;
+import { BigNumber } from '@ethersproject/bignumber';
+import JSBI from 'jsbi';
+import { Percent } from '@kittycorn-labs/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 bignumber_1 = require("@ethersproject/bignumber");
+const jsbi_1 = tslib_1.__importDefault(require("jsbi"));
+const bignumber_js_1 = tslib_1.__importDefault(require("bignumber.js"));
+const v3_sdk_1 = require("@kittycorn-labs/v3-sdk");
+function expandTo18DecimalsBN(n) {
+    // use bn intermediately to allow decimals in intermediate calculations
+    return bignumber_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(bignumber_1.BigNumber.from(n).mul(bignumber_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,wDAAoD;AACpD,wDAAuB;AACvB,wEAA6B;AAE7B,mDAA8C;AAE9C,SAAgB,oBAAoB,CAAC,CAAS;IAC5C,uEAAuE;IACvE,OAAO,qBAAS,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,qBAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,qBAAS,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/{utils → cjs/src/utils}/pathCurrency.d.ts

@@ -1,3 +1,3 @@
-import { Currency } from '@kittycorn-labs/sdk-core';
-import { TPool } from '@kittycorn-labs/router-sdk';
-export declare function getPathCurrency(currency: Currency, pool: TPool): Currency;
+import { Currency } from '@kittycorn-labs/sdk-core';
+import { TPool } from '@kittycorn-labs/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("@kittycorn-labs/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,mDAAuD;AAGvD,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/portionFees.d.ts

@@ -0,0 +1,14 @@
+import { BigNumber } from '@ethersproject/bignumber';
+import { Percent } from '@kittycorn-labs/sdk-core';
+import { FeeOptions } from '@kittycorn-labs/v3-sdk';
+export interface ScaledPortionFee {
+    recipient: string;
+    /** The caller-supplied fee, read as a fraction of the gross swap output. */
+    grossFee: Percent;
+    /** Rescaled against the balance remaining when its PAY_PORTION executes, so the recipient still gets `grossFee` of gross. */
+    scaledFee: Percent;
+}
+/** Gross fractions to remaining-balance fractions: scaled_i = f_i / (1 - sum(f_0..f_{i-1})), in exact Fraction arithmetic; throws at or past 100%, since a 100% total encodes a swap that pays the swapper nothing. */
+export declare function scalePortionFees(fees: FeeOptions[]): ScaledPortionFee[];
+/** Replays the cascade with the ENCODED portions, which is exact where sum(floor(gross * f_i)) is off by dust either way; reduces to the legacy quantized deduction for a single fee, never exceeds grossAmount, and holds for larger fills. */
+export declare function simulatePortionFeeDeduction(grossAmount: BigNumber, scaledFees: ScaledPortionFee[], useFullPrecision: boolean): BigNumber;

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

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.simulatePortionFeeDeduction = exports.scalePortionFees = void 0;
+const bignumber_1 = require("@ethersproject/bignumber");
+const sdk_core_1 = require("@kittycorn-labs/sdk-core");
+const numbers_1 = require("./numbers");
+const ONE = new sdk_core_1.Fraction(1);
+/** Gross fractions to remaining-balance fractions: scaled_i = f_i / (1 - sum(f_0..f_{i-1})), in exact Fraction arithmetic; throws at or past 100%, since a 100% total encodes a swap that pays the swapper nothing. */
+function scalePortionFees(fees) {
+    let remaining = ONE;
+    return fees.map(({ fee, recipient }) => {
+        if (fee.lessThan(0))
+            throw new Error('Portion fees cannot be negative');
+        // Strictly less: remaining stays positive, so the swapper's sweep is always non-empty.
+        if (!fee.lessThan(remaining))
+            throw new Error('Portion fees together exceed 100% of the swap output');
+        const scaled = fee.divide(remaining);
+        remaining = remaining.subtract(fee);
+        return {
+            recipient,
+            grossFee: new sdk_core_1.Percent(fee.numerator, fee.denominator),
+            scaledFee: new sdk_core_1.Percent(scaled.numerator, scaled.denominator),
+        };
+    });
+}
+exports.scalePortionFees = scalePortionFees;
+const FEE_1E18_DENOMINATOR = bignumber_1.BigNumber.from(10).pow(18);
+const FEE_BIPS_DENOMINATOR = bignumber_1.BigNumber.from(10000);
+/** Replays the cascade with the ENCODED portions, which is exact where sum(floor(gross * f_i)) is off by dust either way; reduces to the legacy quantized deduction for a single fee, never exceeds grossAmount, and holds for larger fills. */
+function simulatePortionFeeDeduction(grossAmount, scaledFees, useFullPrecision) {
+    let remainingBalance = grossAmount;
+    for (const { scaledFee } of scaledFees) {
+        const encodedPortion = bignumber_1.BigNumber.from(useFullPrecision ? (0, numbers_1.encodeFee1e18)(scaledFee) : (0, numbers_1.encodeFeeBips)(scaledFee));
+        const portionDenominator = useFullPrecision ? FEE_1E18_DENOMINATOR : FEE_BIPS_DENOMINATOR;
+        remainingBalance = remainingBalance.sub(remainingBalance.mul(encodedPortion).div(portionDenominator));
+    }
+    return grossAmount.sub(remainingBalance);
+}
+exports.simulatePortionFeeDeduction = simulatePortionFeeDeduction;
+//# sourceMappingURL=portionFees.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portionFees.js","sourceRoot":"","sources":["../../../../src/utils/portionFees.ts"],"names":[],"mappings":";;;AAAA,wDAAoD;AACpD,uDAA4D;AAE5D,uCAAwD;AAUxD,MAAM,GAAG,GAAG,IAAI,mBAAQ,CAAC,CAAC,CAAC,CAAA;AAE3B,uNAAuN;AACvN,SAAgB,gBAAgB,CAAC,IAAkB;IACjD,IAAI,SAAS,GAAa,GAAG,CAAA;IAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE;QACrC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;QACvE,uFAAuF;QACvF,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;QACrG,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACpC,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QACnC,OAAO;YACL,SAAS;YACT,QAAQ,EAAE,IAAI,kBAAO,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC;YACrD,SAAS,EAAE,IAAI,kBAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;SAC7D,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAdD,4CAcC;AAED,MAAM,oBAAoB,GAAG,qBAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AACvD,MAAM,oBAAoB,GAAG,qBAAS,CAAC,IAAI,CAAC,KAAM,CAAC,CAAA;AAEnD,gPAAgP;AAChP,SAAgB,2BAA2B,CACzC,WAAsB,EACtB,UAA8B,EAC9B,gBAAyB;IAEzB,IAAI,gBAAgB,GAAG,WAAW,CAAA;IAClC,KAAK,MAAM,EAAE,SAAS,EAAE,IAAI,UAAU,EAAE;QACtC,MAAM,cAAc,GAAG,qBAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAA,uBAAa,EAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAA,uBAAa,EAAC,SAAS,CAAC,CAAC,CAAA;QAC7G,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAAA;QACzF,gBAAgB,GAAG,gBAAgB,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAA;KACtG;IACD,OAAO,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;AAC1C,CAAC;AAZD,kEAYC"}

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

@@ -0,0 +1,31 @@
+import { BigNumber } from '@ethersproject/bignumber';
+import { SwapStep, V4Action } from '../types/encodeSwaps';
+export declare function stepSpendsToken(step: SwapStep, inputTokenAddress: string): boolean;
+export declare function isInputSettle(action: V4Action, tokenAddress: string): boolean;
+export declare function isInputSwap(action: V4Action, tokenAddress: string): boolean;
+export declare function v4SwapAmountIn(action: V4Action): BigNumber;
+export declare function stepSpendAmount(step: SwapStep, tokenAddress: string): BigNumber;
+/**
+ * Rewrites a step plan to spend the router's entire input-token balance.
+ *
+ * Single spender: its v2/v3 exact-in amount becomes the CONTRACT_BALANCE
+ * sentinel (a v4 spender settles CONTRACT_BALANCE; one of its input swaps
+ * consumes the open delta while any others keep their quoted slices).
+ *
+ * Split routes (multiple spenders of the input token): every spender but the
+ * largest keeps its quoted amount, funded from router custody; the largest is
+ * rewritten to CONTRACT_BALANCE and MOVED after the other spenders, so it
+ * absorbs all delivery variance and the fill only reverts when delivery
+ * cannot cover the fixed legs.
+ */
+export declare function applyRouterBalanceInputToSteps(swapSteps: SwapStep[], inputTokenAddress: string, wrappedNativeAddress?: string): SwapStep[];
+/**
+ * Native-input variant: the plan leads with the route's WRAP_ETH, which is resized to wrap
+ * the router's entire native balance (attached msg.value plus any stray ETH, so no value
+ * is left behind — UR never refunds msg.value); the wrapped-token hop that follows then
+ * spends CONTRACT_BALANCE like an ERC20 balance swap.
+ *
+ * `validateEncodeSwaps` guarantees steps[0] is a router-recipient WRAP_ETH and exactly one
+ * later step spends the wrapped token.
+ */
+export declare function applyNativeRouterBalanceInputToSteps(swapSteps: SwapStep[], wrappedTokenAddress: string): SwapStep[];