@paraswap/dex-lib 5.0.6-fallback-encoding.0 → 5.0.6-fallback-encoding.2

package/build/executor/fallback-routes/generate.js

@@ -0,0 +1,294 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAllRoutes = generateAllRoutes;
+/* eslint-disable no-console */
+const dotenv_1 = __importDefault(require("dotenv"));
+dotenv_1.default.config();
+/**
+ * Fallback test-route generator.
+ *
+ * For each scenario in ./scenarios.ts: price every hop (and split slice) live
+ * on Arbitrum via LocalParaswapSDK, assemble a multi-hop OptimalRate, and
+ * replace the marked member with a fabricated always-reverting `Native` quote
+ * whose revertable fallback is the real priced quote. Writes ./routes.json,
+ * consumed by src/executor/fallback-routes-live-e2e.test.ts.
+ *
+ * Run:  GENERATE_FALLBACK_ROUTES=1 npx jest src/executor/fallback-routes/generate-routes.test.ts --forceExit
+ * Requires .env: HTTP_PROVIDER_42161.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const abi_1 = require("@ethersproject/abi");
+const core_1 = require("@paraswap/core");
+const local_paraswap_sdk_1 = require("../../implementations/local-paraswap-sdk");
+const constants_1 = require("../../constants");
+const utils_1 = require("../../utils");
+const scenarios_1 = require("./scenarios");
+const NETWORK = constants_1.Network.ARBITRUM;
+const PRICING_DEX = 'UniswapV3';
+const AUGUSTUS_V6 = '0x6a000f20005980200259b80c5102003040001068';
+const WETH_ARBITRUM = '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1';
+// Local token map (generate.ts is compiled as source, so it cannot import
+// tests/constants-e2e which lives outside the tsconfig rootDir).
+const TOKENS = {
+    ETH: {
+        address: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE',
+        decimals: 18,
+    },
+    WETH: { address: WETH_ARBITRUM, decimals: 18 },
+    USDC: {
+        address: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+        decimals: 6,
+    },
+    USDT: {
+        address: '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9',
+        decimals: 6,
+    },
+    WBTC: {
+        address: '0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f',
+        decimals: 8,
+    },
+};
+const erc20 = new abi_1.Interface(['function transferFrom(address,address,uint256)']);
+// A quote whose calldata always reverts on-chain: transferFrom with no allowance.
+function fabricatedRevertingQuote(hopSrcToken, amount) {
+    return {
+        quote: {
+            txRequest: {
+                // eee has no code — use WETH as the reverting ERC20 target for ETH hops
+                target: (0, utils_1.isETHAddress)(hopSrcToken) ? WETH_ARBITRUM : hopSrcToken,
+                calldata: erc20.encodeFunctionData('transferFrom', [
+                    '0x000000000000000000000000000000000000dEaD',
+                    '0x000000000000000000000000000000000000bEEF',
+                    amount,
+                ]),
+                value: '0',
+            },
+        },
+    };
+}
+// One SDK (with initialized pricing) per venue, created lazily.
+class SdkRegistry {
+    sdks = {};
+    async get(dexKey) {
+        if (!this.sdks[dexKey]) {
+            const sdk = new local_paraswap_sdk_1.LocalParaswapSDK(NETWORK, [dexKey], '');
+            await sdk.initializePricing?.();
+            this.sdks[dexKey] = sdk;
+        }
+        return this.sdks[dexKey];
+    }
+    async release() {
+        for (const sdk of Object.values(this.sdks)) {
+            await sdk.releaseResources?.();
+        }
+    }
+}
+// Build the swaps (hops) of one route, pricing every slice live. Returns the
+// route's swaps, its output amount and the latest pricing block.
+async function buildRouteSwaps(sdks, scenarioName, path, hops, routeAmount) {
+    const tokens = TOKENS;
+    if (hops.length !== path.length - 1) {
+        throw new Error(`${scenarioName}: hops must match path segments`);
+    }
+    let runningAmount = routeAmount;
+    let blockNumber = 0;
+    const swaps = [];
+    for (let i = 0; i < hops.length; i++) {
+        const hop = hops[i];
+        const from = tokens[path[i]];
+        const to = tokens[path[i + 1]];
+        const split = hop.split ?? [100];
+        if (split.reduce((a, b) => a + b, 0) !== 100) {
+            throw new Error(`${scenarioName}: hop ${i} split must sum to 100`);
+        }
+        // Slice amounts; last slice takes the remainder to preserve the total.
+        const slices = split.map(p => (runningAmount * BigInt(p)) / 100n);
+        slices[slices.length - 1] =
+            runningAmount - slices.slice(0, -1).reduce((a, b) => a + b, 0n);
+        const members = [];
+        let hopDestTotal = 0n;
+        const priceSlice = async (dexKey, amount) => {
+            const sdk = await sdks.get(dexKey);
+            const priced = await sdk.getPrices(from, to, amount, constants_1.SwapSide.SELL, constants_1.ContractMethod.swapExactAmountIn);
+            blockNumber = priced.blockNumber;
+            return priced.bestRoute[0].swaps[0].swapExchanges[0];
+        };
+        for (let j = 0; j < slices.length; j++) {
+            const memberDex = hop.pricingDexes?.[j] ?? PRICING_DEX;
+            const realSe = await priceSlice(memberDex, slices[j]);
+            const member = {
+                ...realSe,
+                srcAmount: slices[j].toString(),
+                percent: split[j],
+            };
+            if (hop.fabricatedMemberIndex === j) {
+                // The fallback may be priced on a different venue (e.g. a raw-ETH one).
+                const fallbackSe = hop.fallbackPricingDex
+                    ? {
+                        ...(await priceSlice(hop.fallbackPricingDex, slices[j])),
+                        srcAmount: slices[j].toString(),
+                        percent: split[j],
+                    }
+                    : member;
+                hopDestTotal += BigInt(fallbackSe.destAmount);
+                members.push({
+                    exchange: 'Native',
+                    srcAmount: member.srcAmount,
+                    destAmount: fallbackSe.destAmount,
+                    percent: split[j],
+                    data: fabricatedRevertingQuote(from.address, slices[j]),
+                    fallback: fallbackSe, // the real quote is the revertable fallback
+                });
+            }
+            else {
+                hopDestTotal += BigInt(realSe.destAmount);
+                members.push(member);
+            }
+        }
+        swaps.push({
+            srcToken: from.address,
+            srcDecimals: from.decimals,
+            destToken: to.address,
+            destDecimals: to.decimals,
+            swapExchanges: members,
+        });
+        runningAmount = hopDestTotal;
+    }
+    return { swaps, out: runningAmount, blockNumber };
+}
+async function generateScenario(sdks, spec) {
+    const tokens = TOKENS;
+    const routeSpecs = spec.routes ?? [
+        { percent: 100, path: spec.path, hops: spec.hops },
+    ];
+    if (routeSpecs.reduce((a, r) => a + r.percent, 0) !== 100) {
+        throw new Error(`${spec.name}: route percents must sum to 100`);
+    }
+    const srcSym = routeSpecs[0].path[0];
+    const destSym = routeSpecs[0].path[routeSpecs[0].path.length - 1];
+    if (!routeSpecs.every(r => r.path[0] === srcSym && r.path[r.path.length - 1] === destSym)) {
+        throw new Error(`${spec.name}: all routes must share src and dest tokens`);
+    }
+    // Split the src amount across routes; last route takes the remainder.
+    const total = BigInt(spec.amount);
+    const routeAmounts = routeSpecs.map(r => (total * BigInt(r.percent)) / 100n);
+    routeAmounts[routeAmounts.length - 1] =
+        total - routeAmounts.slice(0, -1).reduce((a, b) => a + b, 0n);
+    let blockNumber = 0;
+    let destAmount = 0n;
+    const bestRoute = [];
+    for (let i = 0; i < routeSpecs.length; i++) {
+        const r = routeSpecs[i];
+        const built = await buildRouteSwaps(sdks, spec.name, r.path, r.hops, routeAmounts[i]);
+        blockNumber = built.blockNumber;
+        destAmount += built.out;
+        bestRoute.push({ percent: r.percent, swaps: built.swaps });
+    }
+    const src = tokens[srcSym];
+    const dest = tokens[destSym];
+    const priceRoute = {
+        blockNumber,
+        network: NETWORK,
+        srcToken: src.address,
+        srcDecimals: src.decimals,
+        srcAmount: spec.amount,
+        destToken: dest.address,
+        destDecimals: dest.decimals,
+        destAmount: destAmount.toString(),
+        bestRoute,
+        gasCostUSD: '0',
+        gasCost: '0',
+        others: [],
+        side: constants_1.SwapSide.SELL,
+        contractAddress: AUGUSTUS_V6,
+        tokenTransferProxy: '',
+        version: core_1.ParaSwapVersion.V6,
+        contractMethod: constants_1.ContractMethod.swapExactAmountIn,
+        partner: 'test',
+        maxImpactReached: false,
+        hmac: '0',
+        srcUSD: '0',
+        destUSD: '0',
+    };
+    return {
+        name: spec.name,
+        description: spec.description,
+        network: NETWORK,
+        generatedAt: new Date().toISOString(),
+        slippageBps: spec.slippageBps ?? 300,
+        expectGroup: spec.expectGroup ?? true,
+        expectSuccess: spec.expectSuccess ?? true,
+        priceRoute,
+    };
+}
+async function generateAllRoutes() {
+    const sdks = new SdkRegistry();
+    const routes = [];
+    const failures = [];
+    try {
+        for (const spec of scenarios_1.SCENARIOS) {
+            try {
+                console.log(`generating: ${spec.name} ...`);
+                routes.push(await generateScenario(sdks, spec));
+            }
+            catch (e) {
+                console.error(`FAILED: ${spec.name}:`, e);
+                failures.push(spec.name);
+            }
+        }
+    }
+    finally {
+        await sdks.release();
+    }
+    const out = {
+        _readme: 'GENERATED by src/executor/fallback-routes/generate.ts — do not edit by hand. ' +
+            'Manufactured fallback test routes: each marked member is a Native swapExchange ' +
+            'with an always-reverting quote whose `fallback` is a real quote priced at the ' +
+            'pinned blockNumber. Regenerate when routes go stale: ' +
+            'GENERATE_FALLBACK_ROUTES=1 npx jest src/executor/fallback-routes/generate-routes.test.ts --forceExit',
+        routes,
+    };
+    const outPath = path.join(__dirname, 'routes.json');
+    fs.writeFileSync(outPath, JSON.stringify(out, null, 2));
+    console.log(`\nwrote ${routes.length}/${scenarios_1.SCENARIOS.length} routes to ${outPath}` +
+        (failures.length ? `\nfailed: ${failures.join(', ')}` : ''));
+    return { routes, failures };
+}
+//# sourceMappingURL=generate.js.map

package/build/executor/fallback-routes/generate.js.map

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

package/build/executor/fallback-routes/scenarios.d.ts

@@ -0,0 +1,7 @@
+import { ScenarioSpec } from './types';
+/**
+ * The fallback test matrix. All SELL, Arbitrum, priced on UniswapV3.
+ *
+ * Executor mapping: 100%-per-hop routes -> Executor01; any split -> Executor02.
+ */
+export declare const SCENARIOS: ScenarioSpec[];

package/build/executor/fallback-routes/scenarios.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCENARIOS = void 0;
+const USDC_10 = (10n * 10n ** 6n).toString();
+const USDT_10 = (10n * 10n ** 6n).toString();
+const ETH_0_01 = (10n ** 16n).toString();
+/**
+ * The fallback test matrix. All SELL, Arbitrum, priced on UniswapV3.
+ *
+ * Executor mapping: 100%-per-hop routes -> Executor01; any split -> Executor02.
+ */
+exports.SCENARIOS = [
+    {
+        name: 'single-hop-fallback',
+        description: 'E01 whole-hop group: single USDC->WETH hop, primary reverts, fallback fills',
+        path: ['USDC', 'WETH'],
+        amount: USDC_10,
+        hops: [{ fabricatedMemberIndex: 0 }],
+    },
+    {
+        name: 'multihop-fallback-first-hop',
+        description: 'E01 group at sequence START: USDC->WETH->WBTC, hop0 falls back, its output threads to hop1',
+        path: ['USDC', 'WETH', 'WBTC'],
+        amount: USDC_10,
+        hops: [{ fabricatedMemberIndex: 0 }, {}],
+    },
+    {
+        name: 'multihop-fallback-last-hop',
+        description: 'E01 group at sequence END: USDC->WETH->WBTC, hop1 falls back after a real hop0',
+        path: ['USDC', 'WETH', 'WBTC'],
+        amount: USDC_10,
+        hops: [{}, { fabricatedMemberIndex: 0 }],
+    },
+    {
+        name: 'multihop-fallback-middle-hop',
+        description: 'E01 group in sequence MIDDLE: USDT->USDC->WETH->WBTC, hop1 falls back between real hops',
+        path: ['USDT', 'USDC', 'WETH', 'WBTC'],
+        amount: USDT_10,
+        hops: [{}, { fabricatedMemberIndex: 0 }, {}],
+    },
+    {
+        name: 'eth-src-wrap-in-try',
+        description: 'E01 wrap rollback: ETH->USDC, primary (needs WETH) wraps inside the try; on revert the wrap rolls back and the fallback re-wraps',
+        path: ['ETH', 'USDC'],
+        amount: ETH_0_01,
+        hops: [{ fabricatedMemberIndex: 0 }],
+    },
+    {
+        name: 'eth-dest-unwrap',
+        description: 'E01 unwrap side: USDC->ETH, primary and fallback both WETH-based (same wrap-ness), unwrap-after machinery',
+        path: ['USDC', 'ETH'],
+        amount: USDC_10,
+        hops: [{ fabricatedMemberIndex: 0 }],
+    },
+    {
+        name: 'split-member-fallback',
+        description: 'E02 group nested in a path: USDC->WETH split 50/50, member 0 falls back, sibling unaffected',
+        path: ['USDC', 'WETH'],
+        amount: USDC_10,
+        hops: [{ split: [50, 50], fabricatedMemberIndex: 0 }],
+    },
+    {
+        name: 'multihop-split-then-fallback-hop',
+        description: 'E02 WHOLE-HOP group with threading flag: USDC->WETH->WBTC, hop0 split 50/50 (all real), hop1 single fabricated',
+        path: ['USDC', 'WETH', 'WBTC'],
+        amount: USDC_10,
+        hops: [{ split: [50, 50] }, { fabricatedMemberIndex: 0 }],
+    },
+    {
+        name: 'eth-src-split-member-fallback',
+        description: 'E02 input normalization: ETH->USDC split 50/50, member 0 falls back; external wrap persists, fallback gets its approve prepended',
+        path: ['ETH', 'USDC'],
+        amount: ETH_0_01,
+        hops: [{ split: [50, 50], fabricatedMemberIndex: 0 }],
+    },
+    {
+        name: 'multihop-fallback-hop-then-split',
+        description: 'E02 MID-ROUTE whole-hop group threading (flag 11): USDC->WETH->WBTC, hop0 single fabricated (its output must thread on), hop1 split 50/50 all real',
+        path: ['USDC', 'WETH', 'WBTC'],
+        amount: USDC_10,
+        hops: [{ fabricatedMemberIndex: 0 }, { split: [50, 50] }],
+    },
+    {
+        name: 'split-last-member-fallback',
+        description: 'E02 group as the LAST split member (remainder-path semantics): USDC->WETH split 50/50, member 1 falls back',
+        path: ['USDC', 'WETH'],
+        amount: USDC_10,
+        hops: [{ split: [50, 50], fabricatedMemberIndex: 1 }],
+    },
+    {
+        name: 'eth-dest-split-member-fallback',
+        description: 'E02 ETH-dest split: USDC->ETH split 50/50, member 0 falls back; unwrap-after machinery composes with the group (same wrap-ness)',
+        path: ['USDC', 'ETH'],
+        amount: USDC_10,
+        hops: [{ split: [50, 50], fabricatedMemberIndex: 0 }],
+    },
+    {
+        name: 'multihop-double-fallback',
+        description: 'E01 TWO groups in one route: USDC->WETH->WBTC, both hops fall back sequentially',
+        path: ['USDC', 'WETH', 'WBTC'],
+        amount: USDC_10,
+        hops: [{ fabricatedMemberIndex: 0 }, { fabricatedMemberIndex: 0 }],
+    },
+    {
+        name: 'split-member-and-hop-double-fallback',
+        description: 'E02 TWO groups in one route: hop0 split 50/50 with member 0 falling back (group in path), hop1 single fabricated (whole-hop group)',
+        path: ['USDC', 'WETH', 'WBTC'],
+        amount: USDC_10,
+        hops: [
+            { split: [50, 50], fabricatedMemberIndex: 0 },
+            { fabricatedMemberIndex: 0 },
+        ],
+    },
+    {
+        name: 'eth-src-raw-eth-fallback',
+        description: 'E01 raw-ETH fallback: ETH->USDC, primary (needs WETH) wraps inside the try; on revert the wrap rolls back and the UniswapV4 fallback spends raw ETH directly',
+        path: ['ETH', 'USDC'],
+        amount: ETH_0_01,
+        hops: [{ fabricatedMemberIndex: 0, fallbackPricingDex: 'UniswapV4' }],
+    },
+    {
+        name: 'eth-src-split-fallback-unwrap-normalization',
+        description: 'E02 input normalization WITHDRAW branch: ETH->USDC split 50/50 (all members need WETH -> root wrap, external), member 0 falls back to raw-ETH UniswapV4 -> WETH.withdraw(slice) prepended to the fallback block',
+        path: ['ETH', 'USDC'],
+        amount: ETH_0_01,
+        hops: [
+            {
+                split: [50, 50],
+                fabricatedMemberIndex: 0,
+                fallbackPricingDex: 'UniswapV4',
+            },
+        ],
+    },
+    {
+        name: 'eth-src-mixed-siblings-wrap-in-try',
+        description: 'E02 branch-local wrap: ETH->USDC split 50/50 with a raw-ETH sibling (UniswapV4) -> no root wrap -> member 0 wraps INSIDE its try; on revert the wrap rolls back and the WETH-based fallback re-wraps',
+        path: ['ETH', 'USDC'],
+        amount: ETH_0_01,
+        hops: [
+            {
+                split: [50, 50],
+                fabricatedMemberIndex: 0,
+                pricingDexes: [undefined, 'UniswapV4'],
+            },
+        ],
+    },
+    {
+        name: 'eth-dest-mixed-wrapness-e01',
+        description: 'E01 mixed wrap-ness on ETH dest (no guard needed: E01 threads per-branch via raw return): USDC->ETH, primary WETH-based, fallback raw-ETH UniswapV4',
+        path: ['USDC', 'ETH'],
+        amount: USDC_10,
+        hops: [{ fabricatedMemberIndex: 0, fallbackPricingDex: 'UniswapV4' }],
+    },
+    {
+        name: 'megaswap-fallback-in-route',
+        description: 'MEGASWAP (bestRoute.length=2, 50/50): routeA = USDC->WETH->WBTC with hop0 falling back mid-route, routeB = same path all real',
+        amount: USDC_10,
+        routes: [
+            {
+                percent: 50,
+                path: ['USDC', 'WETH', 'WBTC'],
+                hops: [{ fabricatedMemberIndex: 0 }, {}],
+            },
+            { percent: 50, path: ['USDC', 'WETH', 'WBTC'], hops: [{}, {}] },
+        ],
+    },
+    {
+        name: 'megaswap-split-member-fallback',
+        description: 'MEGASWAP deepest nesting: routeA hop0 is a 50/50 split whose member 0 falls back (group in path, inside a nested vertical branch), routeB simple real',
+        amount: USDC_10,
+        routes: [
+            {
+                percent: 50,
+                path: ['USDC', 'WETH', 'WBTC'],
+                hops: [{ split: [50, 50], fabricatedMemberIndex: 0 }, {}],
+            },
+            { percent: 50, path: ['USDC', 'WETH', 'WBTC'], hops: [{}, {}] },
+        ],
+    },
+    {
+        name: 'megaswap-whole-route-fallback',
+        description: 'MEGASWAP: routeA is a single fabricated hop (the group IS the whole route content), routeB real multi-hop',
+        amount: USDC_10,
+        routes: [
+            {
+                percent: 50,
+                path: ['USDC', 'WBTC'],
+                hops: [{ fabricatedMemberIndex: 0 }],
+            },
+            { percent: 50, path: ['USDC', 'WETH', 'WBTC'], hops: [{}, {}] },
+        ],
+    },
+    {
+        name: 'eth-dest-split-mixed-wrapness-runs-plain',
+        description: 'NEGATIVE, E02 guard: USDC->ETH split 50/50, member 0 primary WETH-based with raw-ETH UniswapV4 fallback -> mixed wrap-ness on ETH dest is guarded, no group is encoded, the reverting primary runs plain and the tx fails',
+        path: ['USDC', 'ETH'],
+        amount: USDC_10,
+        hops: [
+            {
+                split: [50, 50],
+                fabricatedMemberIndex: 0,
+                fallbackPricingDex: 'UniswapV4',
+            },
+        ],
+        expectGroup: false,
+        expectSuccess: false,
+    },
+];
+//# sourceMappingURL=scenarios.js.map

package/build/executor/fallback-routes/scenarios.js.map

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

package/build/executor/fallback-routes/types.d.ts

@@ -0,0 +1,45 @@
+import { OptimalRate } from '@paraswap/core';
+/**
+ * Declarative spec for a manufactured fallback test route.
+ *
+ * Every scenario is a SELL route along `path`. Each hop is priced live (per
+ * split slice) with a real AMM; the hop/member marked `fabricated` becomes a
+ * `Native` swapExchange with an always-reverting quote carrying the real
+ * priced quote as its revertable fallback.
+ */
+export type HopSpec = {
+    split?: number[];
+    fabricatedMemberIndex?: number;
+    pricingDexes?: (string | undefined)[];
+    fallbackPricingDex?: string;
+};
+export type RouteSpec = {
+    percent: number;
+    path: string[];
+    hops: HopSpec[];
+};
+export type ScenarioSpec = {
+    name: string;
+    description: string;
+    amount: string;
+    path?: string[];
+    hops?: HopSpec[];
+    routes?: RouteSpec[];
+    slippageBps?: number;
+    expectGroup?: boolean;
+    expectSuccess?: boolean;
+};
+export type GeneratedRoute = {
+    name: string;
+    description: string;
+    network: number;
+    generatedAt: string;
+    slippageBps: number;
+    expectGroup: boolean;
+    expectSuccess: boolean;
+    priceRoute: OptimalRate;
+};
+export type GeneratedRoutesFile = {
+    _readme: string;
+    routes: GeneratedRoute[];
+};

package/build/executor/fallback-routes/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/executor/fallback-routes/types.js.map

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

package/build/generic-swap-transaction-builder.js

@@ -102,8 +102,7 @@ class GenericSwapTransactionBuilder {
             // Revertable fallback alternative attached during pricing (api).
             // Build it the same way as the primary so its setup (approve/wrap)
             // is encoded inside the group's fallback branch.
-            const seFallback = se
-                .fallback;
+            const seFallback = se.fallback;
             const fallback = seFallback
                 ? await this.buildSingleExchangeParam(priceRoute, routeIndex, swap, swapIndex, seFallback, minMaxAmount, bytecodeBuilder, getDexParamOptions)
                 : undefined;