@avail-project/ca-common 2.2.1 → 2.3.0

package/dist/cjs/xcs/autochoice.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AutoSelectionError = void 0;
+exports.AggregateAggregatorsMode = exports.AutoSelectionError = void 0;
 exports.aggregateAggregators = aggregateAggregators;
 exports.autoSelectSourcesV2 = autoSelectSourcesV2;
 exports.autoSelectSourcesV2ByRecipient = autoSelectSourcesV2ByRecipient;
@@ -22,6 +22,11 @@ class AutoSelectionError extends Error {
 }
 exports.AutoSelectionError = AutoSelectionError;
 const safetyMultiplier = new decimal_js_1.default("1.025");
+var AggregateAggregatorsMode;
+(function (AggregateAggregatorsMode) {
+    AggregateAggregatorsMode[AggregateAggregatorsMode["MaximizeOutput"] = 0] = "MaximizeOutput";
+    AggregateAggregatorsMode[AggregateAggregatorsMode["MinimizeInput"] = 1] = "MinimizeInput";
+})(AggregateAggregatorsMode || (exports.AggregateAggregatorsMode = AggregateAggregatorsMode = {}));
 async function aggregateAggregators(requests, aggregators, mode) {
     const responses = await Promise.all(aggregators.map(async (agg) => {
         let quotes;
@@ -39,7 +44,7 @@ async function aggregateAggregators(requests, aggregators, mode) {
     }));
     const final = new Array(requests.length);
     switch (mode) {
-        case 0 /* AggregateAggregatorsMode.MaximizeOutput */: {
+        case AggregateAggregatorsMode.MaximizeOutput: {
             for (let i = 0; i < requests.length; i++) {
                 const best = (0, data_1.maxByBigInt)(responses.map((ra) => ({ quote: ra.quotes[i], aggregator: ra.agg })), (r) => r.quote?.output.amountRaw ?? 0n);
                 if (best != null) {
@@ -54,7 +59,7 @@ async function aggregateAggregators(requests, aggregators, mode) {
             }
             break;
         }
-        case 1 /* AggregateAggregatorsMode.MinimizeInput */: {
+        case AggregateAggregatorsMode.MinimizeInput: {
             for (let i = 0; i < requests.length; i++) {
                 const best = (0, data_1.minByBigInt)(responses.map((ra) => ({ quote: ra.quotes[i], aggregator: ra.agg })), 
                 // Default null quotes to MAX so they never win as the minimum
@@ -231,7 +236,7 @@ async function autoSelectSourcesV2ByRecipient(holdings, outputRequired, aggregat
     }
     // Sort by original index to maintain priority
     processingQueue.sort((a, b) => a.idx - b.idx);
-    const responses = await aggregateAggregators(fullLiquidationQuotes.map((fq) => fq.req), aggregators, 0 /* AggregateAggregatorsMode.MaximizeOutput */);
+    const responses = await aggregateAggregators(fullLiquidationQuotes.map((fq) => fq.req), aggregators, AggregateAggregatorsMode.MaximizeOutput);
     console.debug("AutoSelectSources:Quotes", responses);
     const final = [];
     const usedCOTs = [];
@@ -293,7 +298,7 @@ async function autoSelectSourcesV2ByRecipient(holdings, outputRequired, aggregat
                             seriousness: iface_1.QuoteSeriousness.SERIOUS,
                             inputAmount: (0, data_1.convertDecimalToBigInt)(expectedInput),
                         },
-                    ], aggregators, 0 /* AggregateAggregatorsMode.MaximizeOutput */);
+                    ], aggregators, AggregateAggregatorsMode.MaximizeOutput);
                     if (adequateQuoteResult.length !== 1) {
                         throw new AutoSelectionError("Unexpected response length from aggregateAggregators");
                     }
@@ -371,7 +376,7 @@ async function determineDestinationSwaps(userAddress, requirement, aggregators,
         inputAmount: requirement.amountRaw,
         seriousness: iface_1.QuoteSeriousness.PRICE_SURVEY,
     };
-    const fullLiquidationResult = await aggregateAggregators([fullLiquidationQR], aggregators, 0 /* AggregateAggregatorsMode.MaximizeOutput */);
+    const fullLiquidationResult = await aggregateAggregators([fullLiquidationQR], aggregators, AggregateAggregatorsMode.MaximizeOutput);
     if (fullLiquidationResult.length !== 1) {
         throw new AutoSelectionError("Unexpected response length from aggregateAggregators");
     }
@@ -396,7 +401,7 @@ async function determineDestinationSwaps(userAddress, requirement, aggregators,
                 inputAmount: (0, data_1.convertDecimalToBigInt)(curAmount),
                 seriousness: iface_1.QuoteSeriousness.SERIOUS,
             },
-        ], aggregators, 0 /* AggregateAggregatorsMode.MaximizeOutput */);
+        ], aggregators, AggregateAggregatorsMode.MaximizeOutput);
         if (buyQuoteResult.length !== 1) {
             throw new AutoSelectionError("Unexpected response length from aggregateAggregators");
         }
@@ -473,7 +478,7 @@ async function liquidateInputHoldingsByRecipient(holdings, aggregators, commonCu
             });
         }
     }
-    const responses = await aggregateAggregators(fullLiquidationQuotes.map((fq) => fq.req), aggregators, 0 /* AggregateAggregatorsMode.MaximizeOutput */);
+    const responses = await aggregateAggregators(fullLiquidationQuotes.map((fq) => fq.req), aggregators, AggregateAggregatorsMode.MaximizeOutput);
     console.debug("XCS | LIH | Responses:", responses);
     const quotes = [];
     for (const [i, response] of responses.entries()) {
@@ -512,7 +517,7 @@ async function destinationSwapWithExactIn(userAddress, omniChainID, inputAmount,
             inputAmount: inputAmount,
             seriousness: iface_1.QuoteSeriousness.SERIOUS,
         },
-    ], aggregators, 0 /* AggregateAggregatorsMode.MaximizeOutput */);
+    ], aggregators, AggregateAggregatorsMode.MaximizeOutput);
     if (fullLiquidationResult.length !== 1) {
         throw new AutoSelectionError("Unexpected response length from aggregateAggregators");
     }

package/dist/cjs/xcs/bebop-agg.js

@@ -119,7 +119,7 @@ class BebopAggregator {
                     amountRaw: BigInt(sellT.amount),
                     contractAddress: inputTokenAddr,
                     decimals: sellT.decimals,
-                    value: decimal_js_1.default.mul(inputAmountInDecimal, sellT.priceUsd).toNumber(),
+                    value: decimal_js_1.default.mul(inputAmountInDecimal, sellT.priceUsd ?? 0).toNumber(),
                     symbol: sellT.symbol,
                 },
                 output: {
@@ -127,7 +127,7 @@ class BebopAggregator {
                     amountRaw: BigInt(buyT.minimumAmount),
                     contractAddress: outputTokenAddr,
                     decimals: buyT.decimals,
-                    value: decimal_js_1.default.mul(buyT.priceUsd, outputAmountInDecimal).toNumber(),
+                    value: decimal_js_1.default.mul(outputAmountInDecimal, buyT.priceUsd ?? 0).toNumber(),
                     symbol: buyT.symbol,
                 },
                 txData: {

package/dist/cjs/xcs/index.js

@@ -6,3 +6,4 @@ tslib_1.__exportStar(require("./lifi-agg"), exports);
 tslib_1.__exportStar(require("./bebop-agg"), exports);
 tslib_1.__exportStar(require("./fibrous-agg"), exports);
 tslib_1.__exportStar(require("./autochoice"), exports);
+tslib_1.__exportStar(require("./selectsources"), exports);

package/dist/cjs/xcs/lifi-agg.js

@@ -23,11 +23,31 @@ const ALLOWED_CHAINS = new Set([
 ]);
 class LiFiAggregator {
     static BASE_URL_V1 = "https://li.quest/v1";
+    // Params that don't depend on chain — spread into every quote request.
+    // `denyExchanges` is built per-call via `denyExchangesFor(chainId)`.
     static COMMON_OPTIONS = {
-        denyExchanges: "openocean",
         slippage: "0.01",
         skipSimulation: true,
     };
+    // Tools denied on every chain.
+    static GLOBAL_DENY = ["openocean"];
+    // Tools denied only on specific chains. Add an entry here when a tool quotes
+    // well on most chains but mis-quotes on a specific one — global-denying it
+    // would needlessly disable healthy routes elsewhere.
+    //
+    // 999 (HyperEVM): fly/hyperflow/liquidswap all share the same on-chain entry
+    //   (0x0a0758d937d1059c356d4714e57f5df0239bce1a) and systematically over-quote
+    //   native HYPE -> USDC routes by 5-11% (LI.FI /quote toAmountMin vs on-chain
+    //   delivery, observed via InsufficientAmountOut(0xe52970aa) failures in
+    //   HyperEVM Safe-mode swaps). They quote within ±0.2% of other tools on
+    //   Ethereum/Base/Arbitrum/Polygon/Optimism, so the deny is chain-local.
+    static PER_CHAIN_DENY = {
+        999: ["fly", "hyperflow", "liquidswap"],
+    };
+    denyExchangesFor(chainId) {
+        const perChain = LiFiAggregator.PER_CHAIN_DENY[chainId] ?? [];
+        return [...LiFiAggregator.GLOBAL_DENY, ...perChain].join(",");
+    }
     axios;
     constructor(apiKey) {
         this.axios = axios_1.default.create({
@@ -68,6 +88,7 @@ class LiFiAggregator {
                             toAddress: receiverAddrHex,
                             fromAmount: r.inputAmount.toString(),
                             ...LiFiAggregator.COMMON_OPTIONS,
+                            denyExchanges: this.denyExchangesFor(Number(r.chain.chainID)),
                         },
                     });
                     break;
@@ -85,6 +106,7 @@ class LiFiAggregator {
                             toAddress: receiverAddrHex,
                             toAmount: r.outputAmount.toString(),
                             ...LiFiAggregator.COMMON_OPTIONS,
+                            denyExchanges: this.denyExchangesFor(Number(r.chain.chainID)),
                         },
                     });
                     break;

package/dist/cjs/xcs/selectsources.js

@@ -0,0 +1,255 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectSources = selectSources;
+const tslib_1 = require("tslib");
+const decimal_js_1 = tslib_1.__importDefault(require("decimal.js"));
+const iface_1 = require("./iface");
+const autochoice_1 = require("./autochoice");
+const data_1 = require("../data");
+const safetyMultiplier = new decimal_js_1.default("1.025");
+async function selectSources(args) {
+    const { sources, outputRequired, aggregators, commonCurrencyID = data_1.CurrencyID.USDC, prefixHeadroom = new decimal_js_1.default("1.25"), } = args;
+    console.debug("XCS | SS:", {
+        sources,
+        outputRequired: outputRequired.toFixed(),
+        prefixHeadroom: prefixHeadroom.toFixed(),
+    });
+    const cotList = [];
+    const nonCOTQuotes = [];
+    for (const [idx, src] of sources.entries()) {
+        const chain = data_1.ChaindataMap.get(src.chainID);
+        if (chain == null) {
+            throw new autochoice_1.AutoSelectionError("Chain not found");
+        }
+        const cot = chain.Currencies.find((c) => c.currencyID === commonCurrencyID);
+        if (cot == null) {
+            console.debug("XCS | SS | Skipping source — no COT on chain", { chain });
+            continue;
+        }
+        const originalHolding = {
+            chainID: src.chainID,
+            tokenAddress: src.tokenAddress,
+            amountRaw: src.amountRaw,
+        };
+        if (Buffer.compare(src.tokenAddress, cot.tokenAddress) === 0) {
+            const normalizedAmount = new decimal_js_1.default(src.amountRaw.toString()).div(decimal_js_1.default.pow(10, cot.decimals));
+            cotList.push({
+                amount: normalizedAmount,
+                idx,
+                chainID: src.chainID,
+                currency: cot,
+                originalHolding,
+            });
+        }
+        else {
+            nonCOTQuotes.push({
+                req: {
+                    userAddress: src.takerAddress,
+                    receiverAddress: src.receiverAddress,
+                    type: iface_1.QuoteType.EXACT_IN,
+                    chain: chain.ChainID,
+                    inputToken: src.tokenAddress,
+                    inputAmount: src.amountRaw,
+                    outputToken: cot.tokenAddress,
+                    seriousness: iface_1.QuoteSeriousness.PRICE_SURVEY,
+                },
+                originalHolding,
+                cur: cot,
+                idx,
+                value: src.value,
+            });
+        }
+    }
+    // Continuous-COT fast path — covers outputRequired without touching any aggregator.
+    if (cotList.length > 0 && cotList[0].idx === 0) {
+        let continuousAmount = new decimal_js_1.default(0);
+        let continuousCount = 0;
+        for (const cot of cotList) {
+            if (cot.idx !== continuousCount)
+                break;
+            continuousAmount = continuousAmount.add(cot.amount);
+            continuousCount++;
+            if (continuousAmount.gte(outputRequired)) {
+                console.log("XCS | SS | Continuous COTs cover requirement, no quotes needed");
+                const usedCOTs = [];
+                let r = outputRequired;
+                for (let i = 0; i < continuousCount; i++) {
+                    const c = cotList[i];
+                    const amountToUse = decimal_js_1.default.min(r, c.amount);
+                    usedCOTs.push({
+                        originalHolding: c.originalHolding,
+                        amountUsed: amountToUse,
+                        idx: c.idx,
+                        cur: c.currency,
+                    });
+                    r = r.minus(amountToUse);
+                    if (r.lte(0))
+                        break;
+                }
+                return { quoteResponses: [], usedCOTs };
+            }
+        }
+    }
+    const queue = [];
+    for (const c of cotList) {
+        queue.push({ idx: c.idx, isCOT: true, cotData: c });
+    }
+    for (const q of nonCOTQuotes) {
+        queue.push({ idx: q.idx, isCOT: false, quoteData: q });
+    }
+    queue.sort((a, b) => a.idx - b.idx);
+    // Smallest priority-ordered prefix whose cumulative value covers
+    // `outputRequired × prefixHeadroom`. Quote only that prefix initially; the batch
+    // is extended below if realised aggregator output under-delivers.
+    const target = outputRequired.mul(prefixHeadroom);
+    let cumulative = new decimal_js_1.default(0);
+    let prefixCutoffIdx = null;
+    for (const item of queue) {
+        if (item.isCOT) {
+            cumulative = cumulative.add(item.cotData.amount);
+        }
+        else {
+            cumulative = cumulative.add(item.quoteData.value);
+        }
+        if (cumulative.gte(target)) {
+            prefixCutoffIdx = item.idx;
+            break;
+        }
+    }
+    console.debug("XCS | SS | Prefix selected", {
+        prefixCutoffIdx,
+        cumulative: cumulative.toFixed(),
+        target: target.toFixed(),
+    });
+    const responseByIdx = new Map();
+    const quoteAndStore = async (batch) => {
+        if (batch.length === 0)
+            return;
+        const r = await (0, autochoice_1.aggregateAggregators)(batch.map((b) => b.req), aggregators, autochoice_1.AggregateAggregatorsMode.MaximizeOutput);
+        for (let i = 0; i < batch.length; i++) {
+            responseByIdx.set(batch[i].idx, r[i]);
+        }
+    };
+    const initialBatch = prefixCutoffIdx == null
+        ? nonCOTQuotes
+        : nonCOTQuotes.filter((q) => q.idx <= prefixCutoffIdx);
+    console.debug("XCS | SS | Initial quote batch", {
+        initialCount: initialBatch.length,
+        totalNonCOT: nonCOTQuotes.length,
+    });
+    await quoteAndStore(initialBatch);
+    const final = [];
+    const usedCOTs = [];
+    let remainder = outputRequired;
+    for (const item of queue) {
+        if (remainder.lte(0))
+            break;
+        if (item.isCOT) {
+            const { cotData } = item;
+            const amountToUse = decimal_js_1.default.min(remainder, cotData.amount);
+            usedCOTs.push({
+                originalHolding: cotData.originalHolding,
+                amountUsed: amountToUse,
+                idx: cotData.idx,
+                cur: cotData.currency,
+            });
+            remainder = remainder.minus(amountToUse);
+            console.debug("XCS | SS | cot", {
+                idx: cotData.idx,
+                amountToUse: amountToUse.toFixed(),
+                remainder: remainder.toFixed(),
+            });
+            continue;
+        }
+        const { quoteData } = item;
+        let lookup = responseByIdx.get(quoteData.idx);
+        if (lookup == null) {
+            // Prefix under-delivered: quote every non-COT we haven't yet and continue.
+            const unquoted = nonCOTQuotes.filter((q) => !responseByIdx.has(q.idx));
+            console.log("XCS | SS | Prefix under-delivered, extending batch", {
+                remaining: unquoted.length,
+            });
+            await quoteAndStore(unquoted);
+            lookup = responseByIdx.get(quoteData.idx);
+        }
+        if (lookup == null)
+            continue;
+        const { quote: resp, aggregator } = lookup;
+        if (resp == null)
+            continue;
+        console.debug("XCS | SS | quote-eval", {
+            idx: quoteData.idx,
+            remainder: remainder.toFixed(),
+            input: resp.input,
+            output: resp.output,
+        });
+        const divisor = decimal_js_1.default.pow(10, quoteData.cur.decimals);
+        const oamD = new decimal_js_1.default(resp.output.amount);
+        if (oamD.gt(remainder)) {
+            const indicativePrice = decimal_js_1.default.div(resp.input.amountRaw.toString(), resp.output.amountRaw.toString());
+            const userBal = new decimal_js_1.default(quoteData.originalHolding.amountRaw.toString());
+            let expectedInput = decimal_js_1.default.min(remainder.mul(divisor).mul(indicativePrice).mul(safetyMultiplier), userBal);
+            let attempts = 0;
+            while (true) {
+                if (++attempts > 10) {
+                    throw new autochoice_1.AutoSelectionError("Partial quote did not converge");
+                }
+                console.debug("XCS | SS | partial_quote_loop", {
+                    indicativePrice: indicativePrice.toFixed(),
+                    expectedInput: expectedInput.toFixed(),
+                    userBal: userBal.toFixed(),
+                    remainder: remainder.toFixed(),
+                });
+                const adequate = await (0, autochoice_1.aggregateAggregators)([
+                    {
+                        ...quoteData.req,
+                        seriousness: iface_1.QuoteSeriousness.SERIOUS,
+                        inputAmount: (0, data_1.convertDecimalToBigInt)(expectedInput),
+                    },
+                ], aggregators, autochoice_1.AggregateAggregatorsMode.MaximizeOutput);
+                if (adequate.length !== 1) {
+                    throw new autochoice_1.AutoSelectionError("Unexpected response length from aggregateAggregators");
+                }
+                const aq = adequate[0];
+                if (aq.quote == null) {
+                    throw new autochoice_1.AutoSelectionError("Couldn't get buy quote");
+                }
+                const oam2D = new decimal_js_1.default(aq.quote.output.amount);
+                if (oam2D.gte(remainder)) {
+                    final.push({
+                        quote: aq.quote,
+                        aggregator: aq.aggregator,
+                        holding: quoteData.originalHolding,
+                        chainID: Number(quoteData.req.chain.chainID),
+                    });
+                    remainder = remainder.minus(oam2D);
+                    break;
+                }
+                else if (expectedInput.eq(userBal)) {
+                    throw new autochoice_1.AutoSelectionError("Holding was supposedly enough to meet the full requirement but ceased to be so subsequently");
+                }
+                else {
+                    expectedInput = decimal_js_1.default.min(expectedInput.mul(safetyMultiplier), userBal);
+                }
+            }
+        }
+        else {
+            final.push({
+                quote: resp,
+                holding: quoteData.originalHolding,
+                aggregator,
+                chainID: Number(quoteData.req.chain.chainID),
+            });
+            remainder = remainder.minus(resp.output.amount);
+            console.debug("XCS | SS | full_quote", {
+                idx: quoteData.idx,
+                remainder: remainder.toFixed(),
+            });
+        }
+    }
+    if (remainder.gt(0)) {
+        throw new autochoice_1.AutoSelectionError("NOT_ENOUGH_SWAP_FOR_REQUIREMENT");
+    }
+    console.log("XCS | SS | final_quotes", { quotes: final, cots: usedCOTs });
+    return { quoteResponses: final, usedCOTs };
+}

package/dist/esm/xcs/autochoice.js

@@ -6,6 +6,11 @@ import { ChaindataMap, convertBigIntToDecimal, convertDecimalToBigInt, CurrencyI
 export class AutoSelectionError extends Error {
 }
 const safetyMultiplier = new Decimal("1.025");
+export var AggregateAggregatorsMode;
+(function (AggregateAggregatorsMode) {
+    AggregateAggregatorsMode[AggregateAggregatorsMode["MaximizeOutput"] = 0] = "MaximizeOutput";
+    AggregateAggregatorsMode[AggregateAggregatorsMode["MinimizeInput"] = 1] = "MinimizeInput";
+})(AggregateAggregatorsMode || (AggregateAggregatorsMode = {}));
 export async function aggregateAggregators(requests, aggregators, mode) {
     const responses = await Promise.all(aggregators.map(async (agg) => {
         let quotes;
@@ -23,7 +28,7 @@ export async function aggregateAggregators(requests, aggregators, mode) {
     }));
     const final = new Array(requests.length);
     switch (mode) {
-        case 0 /* AggregateAggregatorsMode.MaximizeOutput */: {
+        case AggregateAggregatorsMode.MaximizeOutput: {
             for (let i = 0; i < requests.length; i++) {
                 const best = maxByBigInt(responses.map((ra) => ({ quote: ra.quotes[i], aggregator: ra.agg })), (r) => r.quote?.output.amountRaw ?? 0n);
                 if (best != null) {
@@ -38,7 +43,7 @@ export async function aggregateAggregators(requests, aggregators, mode) {
             }
             break;
         }
-        case 1 /* AggregateAggregatorsMode.MinimizeInput */: {
+        case AggregateAggregatorsMode.MinimizeInput: {
             for (let i = 0; i < requests.length; i++) {
                 const best = minByBigInt(responses.map((ra) => ({ quote: ra.quotes[i], aggregator: ra.agg })), 
                 // Default null quotes to MAX so they never win as the minimum
@@ -215,7 +220,7 @@ export async function autoSelectSourcesV2ByRecipient(holdings, outputRequired, a
     }
     // Sort by original index to maintain priority
     processingQueue.sort((a, b) => a.idx - b.idx);
-    const responses = await aggregateAggregators(fullLiquidationQuotes.map((fq) => fq.req), aggregators, 0 /* AggregateAggregatorsMode.MaximizeOutput */);
+    const responses = await aggregateAggregators(fullLiquidationQuotes.map((fq) => fq.req), aggregators, AggregateAggregatorsMode.MaximizeOutput);
     console.debug("AutoSelectSources:Quotes", responses);
     const final = [];
     const usedCOTs = [];
@@ -277,7 +282,7 @@ export async function autoSelectSourcesV2ByRecipient(holdings, outputRequired, a
                             seriousness: QuoteSeriousness.SERIOUS,
                             inputAmount: convertDecimalToBigInt(expectedInput),
                         },
-                    ], aggregators, 0 /* AggregateAggregatorsMode.MaximizeOutput */);
+                    ], aggregators, AggregateAggregatorsMode.MaximizeOutput);
                     if (adequateQuoteResult.length !== 1) {
                         throw new AutoSelectionError("Unexpected response length from aggregateAggregators");
                     }
@@ -355,7 +360,7 @@ export async function determineDestinationSwaps(userAddress, requirement, aggreg
         inputAmount: requirement.amountRaw,
         seriousness: QuoteSeriousness.PRICE_SURVEY,
     };
-    const fullLiquidationResult = await aggregateAggregators([fullLiquidationQR], aggregators, 0 /* AggregateAggregatorsMode.MaximizeOutput */);
+    const fullLiquidationResult = await aggregateAggregators([fullLiquidationQR], aggregators, AggregateAggregatorsMode.MaximizeOutput);
     if (fullLiquidationResult.length !== 1) {
         throw new AutoSelectionError("Unexpected response length from aggregateAggregators");
     }
@@ -380,7 +385,7 @@ export async function determineDestinationSwaps(userAddress, requirement, aggreg
                 inputAmount: convertDecimalToBigInt(curAmount),
                 seriousness: QuoteSeriousness.SERIOUS,
             },
-        ], aggregators, 0 /* AggregateAggregatorsMode.MaximizeOutput */);
+        ], aggregators, AggregateAggregatorsMode.MaximizeOutput);
         if (buyQuoteResult.length !== 1) {
             throw new AutoSelectionError("Unexpected response length from aggregateAggregators");
         }
@@ -457,7 +462,7 @@ export async function liquidateInputHoldingsByRecipient(holdings, aggregators, c
             });
         }
     }
-    const responses = await aggregateAggregators(fullLiquidationQuotes.map((fq) => fq.req), aggregators, 0 /* AggregateAggregatorsMode.MaximizeOutput */);
+    const responses = await aggregateAggregators(fullLiquidationQuotes.map((fq) => fq.req), aggregators, AggregateAggregatorsMode.MaximizeOutput);
     console.debug("XCS | LIH | Responses:", responses);
     const quotes = [];
     for (const [i, response] of responses.entries()) {
@@ -496,7 +501,7 @@ export async function destinationSwapWithExactIn(userAddress, omniChainID, input
             inputAmount: inputAmount,
             seriousness: QuoteSeriousness.SERIOUS,
         },
-    ], aggregators, 0 /* AggregateAggregatorsMode.MaximizeOutput */);
+    ], aggregators, AggregateAggregatorsMode.MaximizeOutput);
     if (fullLiquidationResult.length !== 1) {
         throw new AutoSelectionError("Unexpected response length from aggregateAggregators");
     }

package/dist/esm/xcs/bebop-agg.js

@@ -115,7 +115,7 @@ export class BebopAggregator {
                     amountRaw: BigInt(sellT.amount),
                     contractAddress: inputTokenAddr,
                     decimals: sellT.decimals,
-                    value: Decimal.mul(inputAmountInDecimal, sellT.priceUsd).toNumber(),
+                    value: Decimal.mul(inputAmountInDecimal, sellT.priceUsd ?? 0).toNumber(),
                     symbol: sellT.symbol,
                 },
                 output: {
@@ -123,7 +123,7 @@ export class BebopAggregator {
                     amountRaw: BigInt(buyT.minimumAmount),
                     contractAddress: outputTokenAddr,
                     decimals: buyT.decimals,
-                    value: Decimal.mul(buyT.priceUsd, outputAmountInDecimal).toNumber(),
+                    value: Decimal.mul(outputAmountInDecimal, buyT.priceUsd ?? 0).toNumber(),
                     symbol: buyT.symbol,
                 },
                 txData: {

package/dist/esm/xcs/index.js

@@ -3,3 +3,4 @@ export * from './lifi-agg';
 export * from './bebop-agg';
 export * from './fibrous-agg';
 export * from './autochoice';
+export * from './selectsources';

package/dist/esm/xcs/lifi-agg.js

@@ -19,11 +19,31 @@ const ALLOWED_CHAINS = new Set([
 ]);
 export class LiFiAggregator {
     static BASE_URL_V1 = "https://li.quest/v1";
+    // Params that don't depend on chain — spread into every quote request.
+    // `denyExchanges` is built per-call via `denyExchangesFor(chainId)`.
     static COMMON_OPTIONS = {
-        denyExchanges: "openocean",
         slippage: "0.01",
         skipSimulation: true,
     };
+    // Tools denied on every chain.
+    static GLOBAL_DENY = ["openocean"];
+    // Tools denied only on specific chains. Add an entry here when a tool quotes
+    // well on most chains but mis-quotes on a specific one — global-denying it
+    // would needlessly disable healthy routes elsewhere.
+    //
+    // 999 (HyperEVM): fly/hyperflow/liquidswap all share the same on-chain entry
+    //   (0x0a0758d937d1059c356d4714e57f5df0239bce1a) and systematically over-quote
+    //   native HYPE -> USDC routes by 5-11% (LI.FI /quote toAmountMin vs on-chain
+    //   delivery, observed via InsufficientAmountOut(0xe52970aa) failures in
+    //   HyperEVM Safe-mode swaps). They quote within ±0.2% of other tools on
+    //   Ethereum/Base/Arbitrum/Polygon/Optimism, so the deny is chain-local.
+    static PER_CHAIN_DENY = {
+        999: ["fly", "hyperflow", "liquidswap"],
+    };
+    denyExchangesFor(chainId) {
+        const perChain = LiFiAggregator.PER_CHAIN_DENY[chainId] ?? [];
+        return [...LiFiAggregator.GLOBAL_DENY, ...perChain].join(",");
+    }
     axios;
     constructor(apiKey) {
         this.axios = axios.create({
@@ -64,6 +84,7 @@ export class LiFiAggregator {
                             toAddress: receiverAddrHex,
                             fromAmount: r.inputAmount.toString(),
                             ...LiFiAggregator.COMMON_OPTIONS,
+                            denyExchanges: this.denyExchangesFor(Number(r.chain.chainID)),
                         },
                     });
                     break;
@@ -81,6 +102,7 @@ export class LiFiAggregator {
                             toAddress: receiverAddrHex,
                             toAmount: r.outputAmount.toString(),
                             ...LiFiAggregator.COMMON_OPTIONS,
+                            denyExchanges: this.denyExchangesFor(Number(r.chain.chainID)),
                         },
                     });
                     break;

package/dist/esm/xcs/selectsources.js

@@ -0,0 +1,251 @@
+import Decimal from "decimal.js";
+import { QuoteSeriousness, QuoteType, } from "./iface";
+import { AggregateAggregatorsMode, aggregateAggregators, AutoSelectionError, } from "./autochoice";
+import { ChaindataMap, convertDecimalToBigInt, CurrencyID, } from "../data";
+const safetyMultiplier = new Decimal("1.025");
+export async function selectSources(args) {
+    const { sources, outputRequired, aggregators, commonCurrencyID = CurrencyID.USDC, prefixHeadroom = new Decimal("1.25"), } = args;
+    console.debug("XCS | SS:", {
+        sources,
+        outputRequired: outputRequired.toFixed(),
+        prefixHeadroom: prefixHeadroom.toFixed(),
+    });
+    const cotList = [];
+    const nonCOTQuotes = [];
+    for (const [idx, src] of sources.entries()) {
+        const chain = ChaindataMap.get(src.chainID);
+        if (chain == null) {
+            throw new AutoSelectionError("Chain not found");
+        }
+        const cot = chain.Currencies.find((c) => c.currencyID === commonCurrencyID);
+        if (cot == null) {
+            console.debug("XCS | SS | Skipping source — no COT on chain", { chain });
+            continue;
+        }
+        const originalHolding = {
+            chainID: src.chainID,
+            tokenAddress: src.tokenAddress,
+            amountRaw: src.amountRaw,
+        };
+        if (Buffer.compare(src.tokenAddress, cot.tokenAddress) === 0) {
+            const normalizedAmount = new Decimal(src.amountRaw.toString()).div(Decimal.pow(10, cot.decimals));
+            cotList.push({
+                amount: normalizedAmount,
+                idx,
+                chainID: src.chainID,
+                currency: cot,
+                originalHolding,
+            });
+        }
+        else {
+            nonCOTQuotes.push({
+                req: {
+                    userAddress: src.takerAddress,
+                    receiverAddress: src.receiverAddress,
+                    type: QuoteType.EXACT_IN,
+                    chain: chain.ChainID,
+                    inputToken: src.tokenAddress,
+                    inputAmount: src.amountRaw,
+                    outputToken: cot.tokenAddress,
+                    seriousness: QuoteSeriousness.PRICE_SURVEY,
+                },
+                originalHolding,
+                cur: cot,
+                idx,
+                value: src.value,
+            });
+        }
+    }
+    // Continuous-COT fast path — covers outputRequired without touching any aggregator.
+    if (cotList.length > 0 && cotList[0].idx === 0) {
+        let continuousAmount = new Decimal(0);
+        let continuousCount = 0;
+        for (const cot of cotList) {
+            if (cot.idx !== continuousCount)
+                break;
+            continuousAmount = continuousAmount.add(cot.amount);
+            continuousCount++;
+            if (continuousAmount.gte(outputRequired)) {
+                console.log("XCS | SS | Continuous COTs cover requirement, no quotes needed");
+                const usedCOTs = [];
+                let r = outputRequired;
+                for (let i = 0; i < continuousCount; i++) {
+                    const c = cotList[i];
+                    const amountToUse = Decimal.min(r, c.amount);
+                    usedCOTs.push({
+                        originalHolding: c.originalHolding,
+                        amountUsed: amountToUse,
+                        idx: c.idx,
+                        cur: c.currency,
+                    });
+                    r = r.minus(amountToUse);
+                    if (r.lte(0))
+                        break;
+                }
+                return { quoteResponses: [], usedCOTs };
+            }
+        }
+    }
+    const queue = [];
+    for (const c of cotList) {
+        queue.push({ idx: c.idx, isCOT: true, cotData: c });
+    }
+    for (const q of nonCOTQuotes) {
+        queue.push({ idx: q.idx, isCOT: false, quoteData: q });
+    }
+    queue.sort((a, b) => a.idx - b.idx);
+    // Smallest priority-ordered prefix whose cumulative value covers
+    // `outputRequired × prefixHeadroom`. Quote only that prefix initially; the batch
+    // is extended below if realised aggregator output under-delivers.
+    const target = outputRequired.mul(prefixHeadroom);
+    let cumulative = new Decimal(0);
+    let prefixCutoffIdx = null;
+    for (const item of queue) {
+        if (item.isCOT) {
+            cumulative = cumulative.add(item.cotData.amount);
+        }
+        else {
+            cumulative = cumulative.add(item.quoteData.value);
+        }
+        if (cumulative.gte(target)) {
+            prefixCutoffIdx = item.idx;
+            break;
+        }
+    }
+    console.debug("XCS | SS | Prefix selected", {
+        prefixCutoffIdx,
+        cumulative: cumulative.toFixed(),
+        target: target.toFixed(),
+    });
+    const responseByIdx = new Map();
+    const quoteAndStore = async (batch) => {
+        if (batch.length === 0)
+            return;
+        const r = await aggregateAggregators(batch.map((b) => b.req), aggregators, AggregateAggregatorsMode.MaximizeOutput);
+        for (let i = 0; i < batch.length; i++) {
+            responseByIdx.set(batch[i].idx, r[i]);
+        }
+    };
+    const initialBatch = prefixCutoffIdx == null
+        ? nonCOTQuotes
+        : nonCOTQuotes.filter((q) => q.idx <= prefixCutoffIdx);
+    console.debug("XCS | SS | Initial quote batch", {
+        initialCount: initialBatch.length,
+        totalNonCOT: nonCOTQuotes.length,
+    });
+    await quoteAndStore(initialBatch);
+    const final = [];
+    const usedCOTs = [];
+    let remainder = outputRequired;
+    for (const item of queue) {
+        if (remainder.lte(0))
+            break;
+        if (item.isCOT) {
+            const { cotData } = item;
+            const amountToUse = Decimal.min(remainder, cotData.amount);
+            usedCOTs.push({
+                originalHolding: cotData.originalHolding,
+                amountUsed: amountToUse,
+                idx: cotData.idx,
+                cur: cotData.currency,
+            });
+            remainder = remainder.minus(amountToUse);
+            console.debug("XCS | SS | cot", {
+                idx: cotData.idx,
+                amountToUse: amountToUse.toFixed(),
+                remainder: remainder.toFixed(),
+            });
+            continue;
+        }
+        const { quoteData } = item;
+        let lookup = responseByIdx.get(quoteData.idx);
+        if (lookup == null) {
+            // Prefix under-delivered: quote every non-COT we haven't yet and continue.
+            const unquoted = nonCOTQuotes.filter((q) => !responseByIdx.has(q.idx));
+            console.log("XCS | SS | Prefix under-delivered, extending batch", {
+                remaining: unquoted.length,
+            });
+            await quoteAndStore(unquoted);
+            lookup = responseByIdx.get(quoteData.idx);
+        }
+        if (lookup == null)
+            continue;
+        const { quote: resp, aggregator } = lookup;
+        if (resp == null)
+            continue;
+        console.debug("XCS | SS | quote-eval", {
+            idx: quoteData.idx,
+            remainder: remainder.toFixed(),
+            input: resp.input,
+            output: resp.output,
+        });
+        const divisor = Decimal.pow(10, quoteData.cur.decimals);
+        const oamD = new Decimal(resp.output.amount);
+        if (oamD.gt(remainder)) {
+            const indicativePrice = Decimal.div(resp.input.amountRaw.toString(), resp.output.amountRaw.toString());
+            const userBal = new Decimal(quoteData.originalHolding.amountRaw.toString());
+            let expectedInput = Decimal.min(remainder.mul(divisor).mul(indicativePrice).mul(safetyMultiplier), userBal);
+            let attempts = 0;
+            while (true) {
+                if (++attempts > 10) {
+                    throw new AutoSelectionError("Partial quote did not converge");
+                }
+                console.debug("XCS | SS | partial_quote_loop", {
+                    indicativePrice: indicativePrice.toFixed(),
+                    expectedInput: expectedInput.toFixed(),
+                    userBal: userBal.toFixed(),
+                    remainder: remainder.toFixed(),
+                });
+                const adequate = await aggregateAggregators([
+                    {
+                        ...quoteData.req,
+                        seriousness: QuoteSeriousness.SERIOUS,
+                        inputAmount: convertDecimalToBigInt(expectedInput),
+                    },
+                ], aggregators, AggregateAggregatorsMode.MaximizeOutput);
+                if (adequate.length !== 1) {
+                    throw new AutoSelectionError("Unexpected response length from aggregateAggregators");
+                }
+                const aq = adequate[0];
+                if (aq.quote == null) {
+                    throw new AutoSelectionError("Couldn't get buy quote");
+                }
+                const oam2D = new Decimal(aq.quote.output.amount);
+                if (oam2D.gte(remainder)) {
+                    final.push({
+                        quote: aq.quote,
+                        aggregator: aq.aggregator,
+                        holding: quoteData.originalHolding,
+                        chainID: Number(quoteData.req.chain.chainID),
+                    });
+                    remainder = remainder.minus(oam2D);
+                    break;
+                }
+                else if (expectedInput.eq(userBal)) {
+                    throw new AutoSelectionError("Holding was supposedly enough to meet the full requirement but ceased to be so subsequently");
+                }
+                else {
+                    expectedInput = Decimal.min(expectedInput.mul(safetyMultiplier), userBal);
+                }
+            }
+        }
+        else {
+            final.push({
+                quote: resp,
+                holding: quoteData.originalHolding,
+                aggregator,
+                chainID: Number(quoteData.req.chain.chainID),
+            });
+            remainder = remainder.minus(resp.output.amount);
+            console.debug("XCS | SS | full_quote", {
+                idx: quoteData.idx,
+                remainder: remainder.toFixed(),
+            });
+        }
+    }
+    if (remainder.gt(0)) {
+        throw new AutoSelectionError("NOT_ENOUGH_SWAP_FOR_REQUIREMENT");
+    }
+    console.log("XCS | SS | final_quotes", { quotes: final, cots: usedCOTs });
+    return { quoteResponses: final, usedCOTs };
+}

package/dist/types/xcs/autochoice.d.ts

@@ -13,7 +13,7 @@ export type HoldingWithSwapAddresses = Holding & {
 };
 export declare class AutoSelectionError extends Error {
 }
-declare const enum AggregateAggregatorsMode {
+export declare enum AggregateAggregatorsMode {
     MaximizeOutput = 0,
     MinimizeInput = 1
 }
@@ -102,4 +102,3 @@ export declare function autoSelectSources(args: {
         cur: Currency;
     }[];
 }>;
-export {};

package/dist/types/xcs/bebop-agg.d.ts

@@ -18,21 +18,21 @@ export type BebopCommonQuote = {
     buyTokens: Record<Hex, {
         amount: string;
         decimals: number;
-        priceUsd: number;
+        priceUsd?: number;
         symbol: string;
         minimumAmount: string;
-        price: number;
-        priceBeforeFee: number;
+        price?: number;
+        priceBeforeFee?: number;
         amountBeforeFee: string;
         deltaFromExpected: number;
     }>;
     sellTokens: Record<Hex, {
         amount: string;
         decimals: number;
-        priceUsd: number;
+        priceUsd?: number;
         symbol: string;
-        price: number;
-        priceBeforeFee: number;
+        price?: number;
+        priceBeforeFee?: number;
     }>;
     settlementAddress: string;
     approvalTarget: Hex;

package/dist/types/xcs/index.d.ts

@@ -3,3 +3,4 @@ export * from './lifi-agg';
 export * from './bebop-agg';
 export * from './fibrous-agg';
 export * from './autochoice';
+export * from './selectsources';

package/dist/types/xcs/lifi-agg.d.ts

@@ -33,6 +33,9 @@ export type LiFiResponse = {
 export declare class LiFiAggregator implements Aggregator {
     private static readonly BASE_URL_V1;
     private static readonly COMMON_OPTIONS;
+    private static readonly GLOBAL_DENY;
+    private static readonly PER_CHAIN_DENY;
+    private denyExchangesFor;
     private readonly axios;
     constructor(apiKey: string);
     getQuotes(requests: (QuoteRequestExactInput | QuoteRequestExactOutput)[]): Promise<(Quote | null)[]>;

package/dist/types/xcs/selectsources.d.ts

@@ -0,0 +1,27 @@
+import Decimal from "decimal.js";
+import { Aggregator, Holding, QuoteResponse } from "./iface";
+import { Currency, CurrencyID, OmniversalChainID } from "../data";
+import { Bytes } from "../types";
+export type SourceWithValue = {
+    chainID: OmniversalChainID;
+    tokenAddress: Bytes;
+    amountRaw: bigint;
+    takerAddress: Bytes;
+    receiverAddress: Bytes;
+    value: number;
+};
+export declare function selectSources(args: {
+    sources: SourceWithValue[];
+    outputRequired: Decimal;
+    aggregators: Aggregator[];
+    commonCurrencyID?: CurrencyID;
+    prefixHeadroom?: Decimal;
+}): Promise<{
+    quoteResponses: QuoteResponse[];
+    usedCOTs: {
+        originalHolding: Holding;
+        amountUsed: Decimal;
+        idx: number;
+        cur: Currency;
+    }[];
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avail-project/ca-common",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "common utilities for CA",
   "files": [
     "dist"