@vultisig/core-chain 2.9.0 → 2.10.1

package/dist/swap/general/lifi/api/getLifiSwapQuote.d.ts

@@ -1,3 +1,4 @@
+import { LifiAffiliateConfig } from '@vultisig/core-chain/swap/general/lifi/config';
 import { LifiSwapEnabledChain } from '@vultisig/core-chain/swap/general/lifi/LifiSwapEnabledChains';
 import { TransferDirection } from '@vultisig/lib-utils/TransferDirection';
 import { AccountCoinKey } from '../../../../coin/AccountCoin.js';
@@ -7,6 +8,9 @@ type Input = Record<TransferDirection, AccountCoinKey<LifiSwapEnabledChain> & {
 }> & {
     amount: bigint;
     affiliateBps?: number;
+    /** Consumer-supplied LI.FI integrator override. When omitted, falls back
+     * to the global `lifiConfig.integratorName` (vultisig-0 by default). */
+    lifiAffiliateConfig?: LifiAffiliateConfig;
 };
 /** @internal exported for unit tests only */
 export declare const STABLE_TICKERS: ReadonlySet<string>;
@@ -16,6 +20,6 @@ export declare const isStablePair: (from: {
 }, to: {
     ticker?: string;
 }) => boolean;
-export declare const getLifiSwapQuote: ({ amount, affiliateBps, ...transfer }: Input) => Promise<GeneralSwapQuote>;
+export declare const getLifiSwapQuote: ({ amount, affiliateBps, lifiAffiliateConfig, ...transfer }: Input) => Promise<GeneralSwapQuote>;
 export {};
 //# sourceMappingURL=getLifiSwapQuote.d.ts.map

package/dist/swap/general/lifi/api/getLifiSwapQuote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getLifiSwapQuote.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/lifi/api/getLifiSwapQuote.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,oBAAoB,EAAE,MAAM,8DAA8D,CAAA;AAKpH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAGzD,KAAK,KAAK,GAAG,MAAM,CAAC,iBAAiB,EAAE,cAAc,CAAC,oBAAoB,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG;IACnG,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAKD,6CAA6C;AAC7C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAa7C,CAAA;AAKF,6CAA6C;AAC7C,eAAO,MAAM,YAAY,GAAI,MAAM;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,OACxB,CAAA;AA+F1D,eAAO,MAAM,gBAAgB,GAAU,uCAAuC,KAAK,KAAG,OAAO,CAAC,gBAAgB,CAgK7G,CAAA"}
+{"version":3,"file":"getLifiSwapQuote.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/lifi/api/getLifiSwapQuote.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAyB,MAAM,+CAA+C,CAAA;AAC1G,OAAO,EAAmB,oBAAoB,EAAE,MAAM,8DAA8D,CAAA;AAKpH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAGzD,KAAK,KAAK,GAAG,MAAM,CAAC,iBAAiB,EAAE,cAAc,CAAC,oBAAoB,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG;IACnG,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;4EACwE;IACxE,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;CAC1C,CAAA;AAKD,6CAA6C;AAC7C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAa7C,CAAA;AAKF,6CAA6C;AAC7C,eAAO,MAAM,YAAY,GAAI,MAAM;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,OACxB,CAAA;AAkG1D,eAAO,MAAM,gBAAgB,GAAU,4DAKpC,KAAK,KAAG,OAAO,CAAC,gBAAgB,CA8KlC,CAAA"}

package/dist/swap/general/lifi/api/getLifiSwapQuote.js

@@ -1,8 +1,8 @@
-import { createConfig, getQuote } from '@lifi/sdk';
+import { getQuote } from '@lifi/sdk';
 import { getChainKind } from '@vultisig/core-chain/ChainKind';
 import { solanaConfig } from '@vultisig/core-chain/chains/solana/solanaConfig';
 import { chainFeeCoin } from '@vultisig/core-chain/coin/chainFeeCoin';
-import { lifiConfig } from '@vultisig/core-chain/swap/general/lifi/config';
+import { lifiConfig, setupLifi } from '@vultisig/core-chain/swap/general/lifi/config';
 import { lifiSwapChainId } from '@vultisig/core-chain/swap/general/lifi/LifiSwapEnabledChains';
 import { shouldBePresent } from '@vultisig/lib-utils/assert/shouldBePresent';
 import { match } from '@vultisig/lib-utils/match';
@@ -30,10 +30,13 @@ export const STABLE_TICKERS = new Set([
 const isStableTicker = (ticker) => ticker !== undefined && STABLE_TICKERS.has(ticker.toUpperCase());
 /** @internal exported for unit tests only */
 export const isStablePair = (from, to) => isStableTicker(from.ticker) && isStableTicker(to.ticker);
-const setupLifi = memoize(() => {
-    createConfig({
-        integrator: lifiConfig.integratorName,
-    });
+/** Lazy bootstrap for callers that never invoked the public `setupLifi`
+ * — uses whatever defaults sit on `lifiConfig` (vultisig-0 + no apiUrl
+ * unless a consumer mutated them at module load). The public `setupLifi`
+ * exported from ../config is idempotent and short-circuits subsequent
+ * calls, so this is safe to call on every quote. */
+const ensureLifiConfigured = memoize(() => {
+    setupLifi();
 });
 // Slippage tolerance baked into the LiFi-prebuilt swap tx. The
 // returned `transactionRequest.data` is a fully-formed Solana / EVM
@@ -119,8 +122,8 @@ const resolveSwapFeeChain = (chainId, fallback) => {
     }
     return resolved;
 };
-export const getLifiSwapQuote = async ({ amount, affiliateBps, ...transfer }) => {
-    setupLifi();
+export const getLifiSwapQuote = async ({ amount, affiliateBps, lifiAffiliateConfig, ...transfer }) => {
+    ensureLifiConfigured();
     const [fromChain, toChain] = [transfer.from, transfer.to].map(({ chain }) => lifiSwapChainId[chain]);
     const [fromToken, toToken] = [transfer.from, transfer.to].map(({ id, chain }) => id ?? chainFeeCoin[chain].ticker);
     const [fromAddress, toAddress] = [transfer.from, transfer.to].map(({ address }) => address);
@@ -136,6 +139,12 @@ export const getLifiSwapQuote = async ({ amount, affiliateBps, ...transfer }) =>
     if (combinedCostBps > MAX_COMBINED_COST_BPS) {
         console.warn(`[getLifiSwapQuote] affiliate + slippage combined cost exceeds ${MAX_COMBINED_COST_BPS}bps: ${combinedCostBps}bps`);
     }
+    // Per-call integrator override — when the consumer supplied a
+    // `lifiAffiliateConfig` (e.g. Station via mcp-ts) the affiliate fee
+    // for THIS quote is tagged to their portal integrator instead of the
+    // SDK-default. Falls back to whatever `lifiConfig.integratorName`
+    // resolves to (vultisig-0 unless the consumer's setupLifi() ran first).
+    const integrator = lifiAffiliateConfig?.integratorName ?? lifiConfig.integratorName;
     const quote = await getQuote({
         fromChain,
         toChain,
@@ -144,8 +153,15 @@ export const getLifiSwapQuote = async ({ amount, affiliateBps, ...transfer }) =>
         fromAmount: amount.toString(),
         fromAddress,
         toAddress,
-        fee: affiliateBps ? affiliateBps / 10000 : undefined,
+        // NeOMakinG #618 r2 should-fix: explicit `undefined` only when affiliateBps
+        // is genuinely unset. `affiliateBps: 0` previously fell into the truthy-test
+        // and became `undefined`, which let LiFi's getQuote silently fall back to
+        // `_config.routeOptions?.fee` (see @lifi/sdk src/services/api.js: `params.fee
+        // ??= _config.routeOptions?.fee`). For a consumer that explicitly set 0,
+        // that's a silent non-zero fee. Now: 0 stays 0.
+        fee: affiliateBps !== undefined ? affiliateBps / 10000 : undefined,
         slippage,
+        integrator,
     });
     const { transactionRequest, estimate } = quote;
     const chainKind = getChainKind(transfer.from.chain);

package/dist/swap/general/lifi/api/getLifiSwapQuote.js.map

@@ -1 +1 @@
-{"version":3,"file":"getLifiSwapQuote.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/lifi/api/getLifiSwapQuote.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"getLifiSwapQuote.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/lifi/api/getLifiSwapQuote.ts"],"names":[],"mappings":"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"}

package/dist/swap/general/lifi/config.d.ts

@@ -1,4 +1,75 @@
+/**
+ * SDK-default LI.FI integrator + (optional) API URL. Used when no consumer
+ * has called `setupLifi` with a custom config — affiliate fees on routes
+ * fetched with these defaults land in the `vultisig-0` portal bucket.
+ *
+ * Consumers (e.g. Station via vultisig/mcp-ts) override at module boot
+ * via `setupLifi({integratorName, apiUrl})` to redirect both the global
+ * LI.FI SDK init AND the per-call integrator tag.
+ */
 export declare const lifiConfig: {
     integratorName: string;
+    apiUrl: string | undefined;
 };
+/**
+ * Per-CALL affiliate config for LI.FI. Consumer-supplied via
+ * `SwapAffiliateConfig.lifi`. Overrides the `integrator` tag on a single
+ * `getQuote` request so affiliate fees route to the consumer's LI.FI portal
+ * integrator instead of the SDK-default `vultisig-0`.
+ *
+ * NOTE: this type is INTENTIONALLY narrower than `LifiBootstrapConfig`.
+ * LI.FI's `getQuote` API does not accept a per-call `apiUrl` — the base URL
+ * is a property of the global SDK init. Including `apiUrl` here would
+ * silently mislead consumers who supply `lifi: { integratorName, apiUrl }`
+ * via `SwapAffiliateConfig` and expect the proxy to apply: it would not.
+ * For the proxy URL, consumers must call `setupLifi({integratorName, apiUrl})`
+ * at module boot — see `LifiBootstrapConfig`. (Ehsan-saradar #618 review.)
+ */
+export type LifiAffiliateConfig = {
+    integratorName: string;
+};
+/**
+ * Global LI.FI SDK bootstrap config. Strictly wider than `LifiAffiliateConfig`
+ * because `apiUrl` is meaningful here (passed to `@lifi/sdk`'s `createConfig`
+ * as the base URL for every request the LI.FI SDK makes after this point) and
+ * intentionally meaningless on the per-call surface.
+ *
+ * Consumers call `setupLifi(bootstrap)` once at module boot.
+ */
+export type LifiBootstrapConfig = {
+    integratorName: string;
+    apiUrl?: string;
+};
+/**
+ * Initialise the global LI.FI SDK config.
+ *
+ * Two call modes:
+ *
+ * 1. **Consumer bootstrap** (`setupLifi(config)` with a config arg):
+ *    Always applies — re-invokes `createConfig` with the supplied
+ *    integrator + apiUrl regardless of whether a prior lazy default-fallback
+ *    already ran. This protects against an "ordering footgun" where a swap
+ *    quote runs before the consumer's boot-time setup and the lazy path
+ *    silently latches the `vultisig-0` default + drops the consumer's
+ *    later apiUrl proxy. (Ehsan-saradar #618 review.)
+ *
+ * 2. **Lazy default** (`setupLifi()` with no arg, called from
+ *    `ensureLifiConfigured` in `getLifiSwapQuote`): only runs once; idempotent
+ *    no-op on every subsequent call. Falls back to whatever `lifiConfig`
+ *    currently holds — `vultisig-0` + no apiUrl unless a consumer mutated
+ *    them already.
+ *
+ * Net effect:
+ * - Consumer-before-lazy: consumer wins (the only `createConfig` call).
+ * - Lazy-before-consumer: lazy installs defaults, then the consumer's
+ *   explicit call overwrites them via the explicit-bootstrap branch above.
+ * - Consumer-after-consumer: the latest consumer-bootstrap call overwrites
+ *   `lifiConfig` and re-runs `createConfig` (last-writer wins). In practice
+ *   consumers should only call this once. The `getLifiSwapQuote.integrator`
+ *   test `'repeated calls re-run createConfig with each new config'` pins
+ *   this contract. (Ehsan-saradar #618 r2.)
+ */
+export declare const setupLifi: (config?: LifiBootstrapConfig) => void;
+/** @internal Test-only reset hook. Never call from production code. */
+export declare const _resetLifiConfigForTest: () => void;
 //# sourceMappingURL=config.d.ts.map

package/dist/swap/general/lifi/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/swap/general/lifi/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;CAEtB,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/swap/general/lifi/config.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;;YAEA,MAAM,GAAG,SAAS;CACxC,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,mBAAmB,KAAG,IAmBxD,CAAA;AAED,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,QAAO,IAI1C,CAAA"}

package/dist/swap/general/lifi/config.js

@@ -1,4 +1,70 @@
+import { createConfig } from '@lifi/sdk';
+/**
+ * SDK-default LI.FI integrator + (optional) API URL. Used when no consumer
+ * has called `setupLifi` with a custom config — affiliate fees on routes
+ * fetched with these defaults land in the `vultisig-0` portal bucket.
+ *
+ * Consumers (e.g. Station via vultisig/mcp-ts) override at module boot
+ * via `setupLifi({integratorName, apiUrl})` to redirect both the global
+ * LI.FI SDK init AND the per-call integrator tag.
+ */
 export const lifiConfig = {
     integratorName: 'vultisig-0',
+    apiUrl: undefined,
+};
+let configured = false;
+/**
+ * Initialise the global LI.FI SDK config.
+ *
+ * Two call modes:
+ *
+ * 1. **Consumer bootstrap** (`setupLifi(config)` with a config arg):
+ *    Always applies — re-invokes `createConfig` with the supplied
+ *    integrator + apiUrl regardless of whether a prior lazy default-fallback
+ *    already ran. This protects against an "ordering footgun" where a swap
+ *    quote runs before the consumer's boot-time setup and the lazy path
+ *    silently latches the `vultisig-0` default + drops the consumer's
+ *    later apiUrl proxy. (Ehsan-saradar #618 review.)
+ *
+ * 2. **Lazy default** (`setupLifi()` with no arg, called from
+ *    `ensureLifiConfigured` in `getLifiSwapQuote`): only runs once; idempotent
+ *    no-op on every subsequent call. Falls back to whatever `lifiConfig`
+ *    currently holds — `vultisig-0` + no apiUrl unless a consumer mutated
+ *    them already.
+ *
+ * Net effect:
+ * - Consumer-before-lazy: consumer wins (the only `createConfig` call).
+ * - Lazy-before-consumer: lazy installs defaults, then the consumer's
+ *   explicit call overwrites them via the explicit-bootstrap branch above.
+ * - Consumer-after-consumer: the latest consumer-bootstrap call overwrites
+ *   `lifiConfig` and re-runs `createConfig` (last-writer wins). In practice
+ *   consumers should only call this once. The `getLifiSwapQuote.integrator`
+ *   test `'repeated calls re-run createConfig with each new config'` pins
+ *   this contract. (Ehsan-saradar #618 r2.)
+ */
+export const setupLifi = (config) => {
+    // Consumer-bootstrap branch — always applies, regardless of `configured`.
+    if (config) {
+        lifiConfig.integratorName = config.integratorName;
+        lifiConfig.apiUrl = config.apiUrl;
+        createConfig(config.apiUrl
+            ? { integrator: config.integratorName, apiUrl: config.apiUrl }
+            : { integrator: config.integratorName });
+        configured = true;
+        return;
+    }
+    // Lazy default branch — idempotent.
+    if (configured)
+        return;
+    const integrator = lifiConfig.integratorName;
+    const apiUrl = lifiConfig.apiUrl;
+    createConfig(apiUrl ? { integrator, apiUrl } : { integrator });
+    configured = true;
+};
+/** @internal Test-only reset hook. Never call from production code. */
+export const _resetLifiConfigForTest = () => {
+    configured = false;
+    lifiConfig.integratorName = 'vultisig-0';
+    lifiConfig.apiUrl = undefined;
 };
 //# sourceMappingURL=config.js.map

package/dist/swap/general/lifi/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/swap/general/lifi/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,cAAc,EAAE,YAAY;CAC7B,CAAA"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/swap/general/lifi/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAExC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,cAAc,EAAE,YAAY;IAC5B,MAAM,EAAE,SAA+B;CACxC,CAAA;AAiCD,IAAI,UAAU,GAAG,KAAK,CAAA;AAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAA4B,EAAQ,EAAE;IAC9D,0EAA0E;IAC1E,IAAI,MAAM,EAAE,CAAC;QACX,UAAU,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAA;QACjD,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;QACjC,YAAY,CACV,MAAM,CAAC,MAAM;YACX,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;YAC9D,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,CAC1C,CAAA;QACD,UAAU,GAAG,IAAI,CAAA;QACjB,OAAM;IACR,CAAC;IACD,oCAAoC;IACpC,IAAI,UAAU;QAAE,OAAM;IACtB,MAAM,UAAU,GAAG,UAAU,CAAC,cAAc,CAAA;IAC5C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAA;IAChC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAA;IAC9D,UAAU,GAAG,IAAI,CAAA;AACnB,CAAC,CAAA;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAS,EAAE;IAChD,UAAU,GAAG,KAAK,CAAA;IAClB,UAAU,CAAC,cAAc,GAAG,YAAY,CAAA;IACxC,UAAU,CAAC,MAAM,GAAG,SAAS,CAAA;AAC/B,CAAC,CAAA"}

package/dist/swap/quote/findSwapQuote.d.ts

@@ -1,6 +1,7 @@
 import { AccountCoin } from '@vultisig/core-chain/coin/AccountCoin';
 import { VultDiscountTier } from '@vultisig/core-chain/swap/affiliate';
 import { KyberSwapBaseAffiliateConfig } from '@vultisig/core-chain/swap/general/kyber/config';
+import { LifiAffiliateConfig } from '@vultisig/core-chain/swap/general/lifi/config';
 import { OneInchAffiliateConfig } from '@vultisig/core-chain/swap/general/oneInch/api/getOneInchSwapQuote';
 import { NativeSwapAffiliateConfig } from '@vultisig/core-chain/swap/native/api/affiliate';
 import { TransferDirection } from '@vultisig/lib-utils/TransferDirection';
@@ -14,6 +15,7 @@ export type SwapAffiliateConfig = {
     native?: NativeSwapAffiliateConfig;
     oneInch?: OneInchAffiliateConfig;
     kyber?: KyberSwapBaseAffiliateConfig;
+    lifi?: LifiAffiliateConfig;
 };
 export type FindSwapQuoteInput = Record<TransferDirection, AccountCoin> & {
     amount: bigint;
@@ -23,19 +25,16 @@ export type FindSwapQuoteInput = Record<TransferDirection, AccountCoin> & {
 };
 type SwapQuoteProviderName = 'CowSwap' | 'KyberSwap' | '1inch' | 'LiFi' | 'SwapKit' | 'THORChain' | 'MayaChain';
 /**
- * Declared preference order for AGGREGATOR ties — when two aggregators return
- * identical `outputAmount`, the earlier entry wins. This makes the tie-break
- * explicit (the previous implementation tied via `fetchers[]` array index,
- * which was determined dynamically by `shouldPreferGeneralSwap` and therefore
- * harder to reason about). Native providers (THORChain/MayaChain) bypass this
- * because they have hard priority over aggregators regardless of output.
- *
- * Order rationale: KyberSwap and 1inch typically surface the best on-chain
- * liquidity for EVM-only swaps; LiFi covers the broader cross-chain matrix;
- * SwapKit is the catch-all fallback. Adjust as data changes.
+ * Declared preference order for economically equivalent quotes. Quotes are
+ * first ranked by comparable net output across all providers. Providers within
+ * `SWAP_QUOTE_PREFERENCE_BAND_BPS` of the best output are then selected by this
+ * order, so users stay close to the best rate while near-ties prefer CowSwap,
+ * native routes, and SwapKit economics.
  *
  * @internal Exported for unit-test introspection only.
  */
+export declare const providerPreferenceOrder: readonly SwapQuoteProviderName[];
+/** @deprecated Use `providerPreferenceOrder`. */
 export declare const aggregatorPreferenceOrder: readonly SwapQuoteProviderName[];
 export declare const findSwapQuote: ({ from, to, amount, referral, vultDiscountTier, affiliateConfig, }: FindSwapQuoteInput) => Promise<SwapQuote>;
 export {};

package/dist/swap/quote/findSwapQuote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"findSwapQuote.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/swap/quote/findSwapQuote.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAA;AACnE,OAAO,EAAuB,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAM3F,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAA;AAG7F,OAAO,EAEL,sBAAsB,EACvB,MAAM,mEAAmE,CAAA;AAQ1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAA;AAe1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAEzE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC;;;;8CAI8C;AAC9C,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,yBAAyB,CAAA;IAClC,OAAO,CAAC,EAAE,sBAAsB,CAAA;IAChC,KAAK,CAAC,EAAE,4BAA4B,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAAG;IACxE,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC1C,eAAe,CAAC,EAAE,mBAAmB,CAAA;CACtC,CAAA;AAED,KAAK,qBAAqB,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAA;AA2D/G;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,qBAAqB,EAQ5D,CAAA;AAkFV,eAAO,MAAM,aAAa,GAAU,oEAOjC,kBAAkB,KAAG,OAAO,CAAC,SAAS,CAiXxC,CAAA"}
+{"version":3,"file":"findSwapQuote.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/swap/quote/findSwapQuote.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAA;AACnE,OAAO,EAAuB,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAM3F,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAA;AAE7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAA;AAEnF,OAAO,EAEL,sBAAsB,EACvB,MAAM,mEAAmE,CAAA;AAQ1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAA;AAe1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAEzE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC;;;;8CAI8C;AAC9C,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,yBAAyB,CAAA;IAClC,OAAO,CAAC,EAAE,sBAAsB,CAAA;IAChC,KAAK,CAAC,EAAE,4BAA4B,CAAA;IACpC,IAAI,CAAC,EAAE,mBAAmB,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAAG;IACxE,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC1C,eAAe,CAAC,EAAE,mBAAmB,CAAA;CACtC,CAAA;AAED,KAAK,qBAAqB,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAA;AAyB/G;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,qBAAqB,EAY1D,CAAA;AAEV,iDAAiD;AACjD,eAAO,MAAM,yBAAyB,kCAA0B,CAAA;AA4FhE,eAAO,MAAM,aAAa,GAAU,oEAOjC,kBAAkB,KAAG,OAAO,CAAC,SAAS,CAsYxC,CAAA"}

package/dist/swap/quote/findSwapQuote.js

@@ -23,34 +23,6 @@ import { isOneOf } from '@vultisig/lib-utils/array/isOneOf';
 import { bigIntToNumber } from '@vultisig/lib-utils/bigint/bigIntToNumber';
 import { isInError } from '@vultisig/lib-utils/error/isInError';
 import { pick } from '@vultisig/lib-utils/record/pick';
-/**
- * Hard native priority: when any direct THORChain or MayaChain route is available,
- * it is always preferred over any aggregator (SwapKit, LiFi, etc.) regardless of
- * gross output. When both THOR and Maya succeed, the one with the higher comparable
- * output wins; among aggregator-only results the normal output ranking applies.
- *
- * Rationale (paaao, 2026-05-22): for L1 swaps that native protocols serve directly,
- * the protocol-aligned route is always preferred. Direct routes capture full
- * vultisig affiliate revenue and avoid the aggregator fee skim; the protocol is
- * the moat. Mirrors the priority-first-success pattern in vultisig-ios's
- * `SwapService.fetchQuote` + `Coin+Swaps.swapProviders`.
- */
-/**
- * Native swap providers — direct on-chain protocols (no aggregator layer).
- *
- * Adding a new native protocol (e.g. Chainflip-direct in the future) requires:
- *   1. Adding its name to `SwapQuoteProviderName` above
- *   2. Adding it here so `isNativeProvider` recognises it for hard-priority
- *      selection in `selectBestEligibleQuote`
- *   3. Wiring its fetcher into `getNativeFetchers`
- *
- * The `satisfies` clause gives compile-time safety against typos, but the
- * semantic mapping (which providers count as "native") still lives in this
- * file and must be kept aligned with the protocol's actual integration mode.
- */
-const nativeProviderNames = ['THORChain', 'MayaChain'];
-const nativeProviderNamesSet = new Set(nativeProviderNames);
-const isNativeProvider = (name) => nativeProviderNamesSet.has(name);
 const QUOTE_FETCH_TIMEOUT_MS = 30_000;
 const withTimeout = (p, ms) => {
     let timeoutId;
@@ -62,30 +34,38 @@ const withTimeout = (p, ms) => {
     });
 };
 /**
- * Declared preference order for AGGREGATOR ties — when two aggregators return
- * identical `outputAmount`, the earlier entry wins. This makes the tie-break
- * explicit (the previous implementation tied via `fetchers[]` array index,
- * which was determined dynamically by `shouldPreferGeneralSwap` and therefore
- * harder to reason about). Native providers (THORChain/MayaChain) bypass this
- * because they have hard priority over aggregators regardless of output.
- *
- * Order rationale: KyberSwap and 1inch typically surface the best on-chain
- * liquidity for EVM-only swaps; LiFi covers the broader cross-chain matrix;
- * SwapKit is the catch-all fallback. Adjust as data changes.
+ * Declared preference order for economically equivalent quotes. Quotes are
+ * first ranked by comparable net output across all providers. Providers within
+ * `SWAP_QUOTE_PREFERENCE_BAND_BPS` of the best output are then selected by this
+ * order, so users stay close to the best rate while near-ties prefer CowSwap,
+ * native routes, and SwapKit economics.
  *
  * @internal Exported for unit-test introspection only.
  */
-export const aggregatorPreferenceOrder = [
-    // 'CowSwap' intentionally omitted in Phase 1 — see fetcher-registration
-    // comment lower in this file. Will be added (and slotted first for the
-    // large-trade RFQ benefit) when Phase 2 wires the build/sign path.
+export const providerPreferenceOrder = [
+    // CowSwap is slotted FIRST: its solver-driven RFQ fills are MEV-protected and
+    // gas-less, so on an exact-output tie it is the preferred route. It only
+    // competes for same-chain ERC-20 EVM pairs (see fetcher registration below);
+    // for every other pair it simply isn't in the candidate set.
+    'CowSwap',
+    'THORChain',
+    'MayaChain',
+    'SwapKit',
     'KyberSwap',
     '1inch',
     'LiFi',
-    'SwapKit',
 ];
-const aggregatorPreferenceIndex = new Map(aggregatorPreferenceOrder.map((name, idx) => [name, idx]));
-const getAggregatorPreferenceRank = (name) => aggregatorPreferenceIndex.get(name) ?? Number.POSITIVE_INFINITY;
+/** @deprecated Use `providerPreferenceOrder`. */
+export const aggregatorPreferenceOrder = providerPreferenceOrder;
+const providerPreferenceIndex = new Map(providerPreferenceOrder.map((name, idx) => [name, idx]));
+const getProviderPreferenceRank = (name) => providerPreferenceIndex.get(name) ?? Number.POSITIVE_INFINITY;
+/**
+ * Tuning point for issue #605's banded routing rule. 100 bps = 1%.
+ * Adjust this when product wants a wider or narrower provider-preference band.
+ */
+const SWAP_QUOTE_PREFERENCE_BAND_BPS = 100n;
+const BPS_DENOMINATOR = 10000n;
+const isWithinPreferenceBand = (outputAmount, bestOutputAmount) => outputAmount * BPS_DENOMINATOR >= bestOutputAmount * (BPS_DENOMINATOR - SWAP_QUOTE_PREFERENCE_BAND_BPS);
 /** Re-base an integer amount from `fromDecimals` fixed-point to `toDecimals`. */
 function rebaseDecimals(value, fromDecimals, toDecimals) {
     if (fromDecimals === toDecimals) {
@@ -117,40 +97,32 @@ function getComparableOutputAmount(q, to) {
     return BigInt(q.quote.general.dstAmount);
 }
 function selectBestEligibleQuote(settled) {
-    let bestNative = null;
-    let bestAggregator = null;
-    let bestAggregatorPreferenceRank = Number.POSITIVE_INFINITY;
+    const candidates = [];
     for (let i = 0; i < settled.length; i++) {
         const result = settled[i];
-        if (result.status !== 'fulfilled') {
-            continue;
+        if (result.status === 'fulfilled') {
+            candidates.push(result.value);
         }
-        const candidate = result.value;
-        if (isNativeProvider(candidate.providerName)) {
-            // Among natives (THOR + Maya), prefer higher output.
-            if (bestNative === null || candidate.outputAmount > bestNative.outputAmount) {
-                bestNative = candidate;
-            }
+    }
+    if (candidates.length === 0) {
+        return null;
+    }
+    const bestOutputAmount = candidates.reduce((best, candidate) => (candidate.outputAmount > best ? candidate.outputAmount : best), candidates[0].outputAmount);
+    let selected = null;
+    let selectedPreferenceRank = Number.POSITIVE_INFINITY;
+    for (const candidate of candidates) {
+        if (!isWithinPreferenceBand(candidate.outputAmount, bestOutputAmount)) {
+            continue;
         }
-        else {
-            // Tie-break by declared aggregator preference (lower rank wins). This
-            // replaces the previous index-based tie-break, which was determined
-            // dynamically by `shouldPreferGeneralSwap` and therefore harder to
-            // reason about. The declared order lives in `aggregatorPreferenceOrder`
-            // above. (#521 r3 — NeO should-fix.)
-            const candidateRank = getAggregatorPreferenceRank(candidate.providerName);
-            if (bestAggregator === null ||
-                candidate.outputAmount > bestAggregator.outputAmount ||
-                (candidate.outputAmount === bestAggregator.outputAmount && candidateRank < bestAggregatorPreferenceRank)) {
-                bestAggregator = candidate;
-                bestAggregatorPreferenceRank = candidateRank;
-            }
+        const candidatePreferenceRank = getProviderPreferenceRank(candidate.providerName);
+        if (selected === null ||
+            candidatePreferenceRank < selectedPreferenceRank ||
+            (candidatePreferenceRank === selectedPreferenceRank && candidate.outputAmount > selected.outputAmount)) {
+            selected = candidate;
+            selectedPreferenceRank = candidatePreferenceRank;
         }
     }
-    // Hard THORChain/Maya priority: if any native route exists, always prefer it
-    // over any aggregator route. Mirrors vultisig-ios's priority-first-success
-    // pattern. No output comparison between native and aggregator.
-    return (bestNative ?? bestAggregator)?.quote ?? null;
+    return selected?.quote ?? null;
 }
 export const findSwapQuote = async ({ from, to, amount, referral, vultDiscountTier, affiliateConfig, }) => {
     // Runtime guard: THORName affiliateFeeAddress must be lowercase.
@@ -193,19 +165,36 @@ export const findSwapQuote = async ({ from, to, amount, referral, vultDiscountTi
         const fromChain = from.chain;
         const toChain = to.chain;
         const chainAmount = amount;
-        // CowSwap: Phase 1 (SDK scaffold only). NOT registered as a live fetcher
-        // until Phase 2 wires the build/sign path through `getCowSwapOrder` +
-        // `submitCowSwapOrder` (the off-chain order flow, see #471). Registering
-        // here while the consumer pipeline can't sign would let CowSwap win a
-        // quote and then fail at sign time. The cowswap module + types + tests
-        // remain in this PR so Phase 2 only needs to plug in the fetcher block
-        // here and the consumer-side dispatch in mcp-ts. (#584 round-1 — Ehsan)
-        //
-        // void-imports so the dead-code linter doesn't gripe; they're used by
-        // sibling tests + ensure the module compiles cleanly.
-        void getCowSwapQuote;
-        void cowSwapChainConfig;
-        void cowSwapSupportedChains;
+        // CowSwap (Phase 2 — off-chain RFQ orders). Gated to same-chain ERC-20 →
+        // ERC-20 pairs on a CowSwap-supported EVM chain. Both sides must be ERC-20
+        // (`from.id` and `to.id` present): selling native ETH needs the GPv2
+        // eth-flow contract (out of scope here) and the off-chain order is settled
+        // by solvers against ERC-20 balances. The consumer signs the order's
+        // EIP-712 digest and submits it via `submitCowSwapOrder` — see
+        // `cowswap_order` handling in `buildSwapKeysignPayload`.
+        if (fromChain === toChain &&
+            isOneOf(fromChain, cowSwapSupportedChains) &&
+            from.id !== undefined &&
+            to.id !== undefined) {
+            const cowChainConfig = cowSwapChainConfig[fromChain];
+            const sellToken = from.id;
+            const buyToken = to.id;
+            result.push({
+                providerName: 'CowSwap',
+                fetch: async () => {
+                    const general = await getCowSwapQuote({
+                        sellToken,
+                        buyToken,
+                        sellAmount: chainAmount,
+                        from: from.address,
+                        receiver: from.address,
+                        chainConfig: cowChainConfig,
+                        affiliateBps,
+                    });
+                    return { quote: { general }, discounts: vultDiscount };
+                },
+            });
+        }
         if (isOneOf(fromChain, kyberSwapEnabledChains) &&
             isOneOf(toChain, kyberSwapEnabledChains) &&
             fromChain === toChain) {
@@ -260,6 +249,7 @@ export const findSwapQuote = async ({ from, to, amount, referral, vultDiscountTi
                         },
                         amount: chainAmount,
                         affiliateBps,
+                        lifiAffiliateConfig: affiliateConfig?.lifi,
                     });
                     return { quote: { general }, discounts: vultDiscount };
                 },
@@ -345,7 +335,7 @@ export const findSwapQuote = async ({ from, to, amount, referral, vultDiscountTi
     // deterministic message selection regardless of `Promise.allSettled`
     // resolution order. (#535 r3 — NeO preferably-blocking response.)
     const belowMinimumProviderOrder = [
-        // 'CowSwap' omitted in Phase 1 (no live fetcher — see comment higher up).
+        'CowSwap',
         'KyberSwap',
         '1inch',
         'LiFi',