Expose routingAndLiquidityOptions on EpochIntentWidget

.agents/skills/epoch-widget/reference/props.md

@@ -20,6 +20,7 @@ Required: `isOpen`, `onClose`, `api`. Everything else optional.
 | `lockDestinationToken` | `boolean` | `true` | Pay-only; `false` lets user re-pick destination. Forced off in swap. |
 | `usdPriceFor` | `(t:{chainId,address,symbol}) => number\|null\|Promise<number\|null>` | — | Resolver for "≈ $…" line. |
 | `ctaLabels` | `Partial<{submit, switchNetwork, quoting, preparing, signing, submitting, polling, complete, insufficientBalance, configureRequired}>` | — | Per-state CTA copy. |
+| `routingAndLiquidityOptions` | `RoutingAndLiquidityOptions` | `{ preset: "any" }` | Restrict solver routing for quote + submit. Presets: `any`, `filler-single-transaction`, `external-multi-transactions`, `custom`. |
 | `earnDefaultTab` | `'deposit' \| 'withdraw'` | `'deposit'` | Earn starting tab. |
 | `earnHideTabs` | `boolean` | `false` | Hide deposit/withdraw tabs. |
 | `earnMarketsSource` | `OneDeltaConfig[]` | — | Static market configs (e.g. `HARDCODED_ONEDELTA_CONFIGS`). |

package.json

@@ -39,8 +39,8 @@
   },
   "dependencies": {
     "@epoch-protocol/epoch-commons-sdk": "^0.1.14",
-    "@epoch-protocol/epoch-flows-sdk": "^0.1.1",
-    "@epoch-protocol/epoch-intents-sdk": "^1.0.26",
+    "@epoch-protocol/epoch-flows-sdk": "^0.1.2",
+    "@epoch-protocol/epoch-intents-sdk": "^1.0.27",
     "clsx": "^2.1.1",
     "tailwind-merge": "^2.6.1"
   },

src/EpochIntentWidget.tsx

@@ -58,6 +58,7 @@ export function EpochIntentWidget(props: EpochIntentWidgetProps) {
     usdPriceFor,
     onSourceTokenChange,
     onQuote,
+    routingAndLiquidityOptions,
   } = props;
 
   const rawMode = modeProp ?? flowProp ?? 'pay';
@@ -111,6 +112,7 @@ export function EpochIntentWidget(props: EpochIntentWidgetProps) {
     usdPriceFor,
     onSourceTokenChange,
     onQuote,
+    routingAndLiquidityOptions,
   };
 
   if (!isConnected) {
@@ -162,6 +164,7 @@ export function EpochIntentWidget(props: EpochIntentWidgetProps) {
         onSign={onSign}
         onSuccess={onSuccess}
         onStatus={onStatus}
+        routingAndLiquidityOptions={routingAndLiquidityOptions}
       />
     );
   }

src/components/EarnIntentWidget.tsx

@@ -22,6 +22,7 @@ import type {
   OnStartCtx,
   OnStatusCtx,
   OnSuccessCtx,
+  RoutingAndLiquidityOptions,
 } from '../types';
 import { buildEarnDepositIntent } from '../earn/build-deposit-intent';
 import { buildEarnWithdrawIntent } from '../earn/build-withdraw-intent';
@@ -124,6 +125,7 @@ interface EarnIntentWidgetProps {
   onSign?: (ctx: OnSignCtx) => void;
   onSuccess?: (ctx: OnSuccessCtx) => void;
   onStatus?: (ctx: OnStatusCtx) => void;
+  routingAndLiquidityOptions?: RoutingAndLiquidityOptions;
 }
 
 export function EarnIntentWidget({
@@ -158,6 +160,7 @@ export function EarnIntentWidget({
   onSign,
   onSuccess,
   onStatus,
+  routingAndLiquidityOptions,
 }: EarnIntentWidgetProps) {
   const sessionId = useSessionId(isOpen);
   const { address, isConnected, connector } = useAccount();
@@ -603,6 +606,7 @@ export function EarnIntentWidget({
     walletClient,
     address,
     sessionId,
+    routingAndLiquidityOptions,
     onIntentSent,
     onIntentComplete,
     onError,

src/components/PaySwapIntentWidget.tsx

@@ -75,6 +75,7 @@ export type PaySwapIntentWidgetProps = Pick<
   | "usdPriceFor"
   | "onSourceTokenChange"
   | "onQuote"
+  | "routingAndLiquidityOptions"
 > & {
   /** `pay` vs `swap` — same SDK path; affects copy and `onStart` / internal `mode`. */
   variant: "pay" | "swap";
@@ -115,6 +116,7 @@ export function PaySwapIntentWidget({
   usdPriceFor,
   onSourceTokenChange,
   onQuote,
+  routingAndLiquidityOptions,
 }: PaySwapIntentWidgetProps) {
   // `lockDestinationToken` is a Pay-only concept — Swap UX always lets the
   // user pick what they receive. Force-disable for Swap regardless of the
@@ -379,6 +381,7 @@ export function PaySwapIntentWidget({
     sessionId,
     mode: variant,
     receiver,
+    routingAndLiquidityOptions,
     onIntentSent,
     onIntentComplete,
     onRequestClose: onClose,

src/earn/use-earn-intent-flow.ts

@@ -3,6 +3,7 @@ import { keccak256, parseUnits, toBytes } from 'viem';
 import type { WalletClient } from 'viem';
 import { TaskType } from '@epoch-protocol/epoch-commons-sdk';
 import { CollateralType, EpochIntentSDK } from '@epoch-protocol/epoch-intents-sdk';
+import type { RoutingAndLiquidityOptions } from '../types';
 import type {
   EarnMidenCreateP2IDNote,
   EpochEarnMarket,
@@ -84,6 +85,7 @@ interface UseEarnIntentFlowParams {
   sessionId: string;
   /** @deprecated SIO now selects the solver via smallocator; this prop is ignored. */
   earnSolverUrl?: string;
+  routingAndLiquidityOptions?: RoutingAndLiquidityOptions;
   onIntentSent?: (data: IntentSentPayload) => void;
   onIntentComplete?: (data: IntentCompletePayload) => void;
   onError?: (ctx: OnErrorCtx) => void;
@@ -137,6 +139,7 @@ export function useEarnIntentFlow({
   address,
   walletClient,
   sessionId,
+  routingAndLiquidityOptions,
   onIntentSent,
   onIntentComplete,
   onError,
@@ -385,6 +388,9 @@ export function useEarnIntentFlow({
           taskTypeString,
           intentData,
           isNative: false,
+          ...(routingAndLiquidityOptions
+            ? { routingAndLiquidityOptions }
+            : {}),
         });
 
         if (callId !== quoteCallIdRef.current || !mountedRef.current) return;
@@ -419,7 +425,7 @@ export function useEarnIntentFlow({
         setStatus('idle');
       }
     },
-    [address, walletClient, apiBaseUrl, buildParams],
+    [address, walletClient, apiBaseUrl, buildParams, routingAndLiquidityOptions],
   );
 
   // ---- Poll intent status ---------------------------------------------------
@@ -515,6 +521,9 @@ export function useEarnIntentFlow({
             taskTypeString,
             intentData,
             isNative: false,
+            ...(routingAndLiquidityOptions
+              ? { routingAndLiquidityOptions }
+              : {}),
           });
           if (!qr?.success) {
             throw new Error((qr as { error?: string } | undefined)?.error ?? 'Quote failed');
@@ -532,6 +541,9 @@ export function useEarnIntentFlow({
           taskTypeString,
           intentData,
           quoteResult,
+          ...(routingAndLiquidityOptions
+            ? { routingAndLiquidityOptions }
+            : {}),
         };
 
         if (submitParams.isMidenDeposit && input.midenSource) {

src/index.ts

@@ -38,6 +38,7 @@ export type {
   OnErrorCtx,
   OnStatusCtx,
   WidgetLifecycleStatus,
+  RoutingAndLiquidityOptions,
 } from './types';
 export { DEFAULT_THEME, LIGHT_THEME, DARK_THEME, resolveTheme, themeToCssVars } from './theme';
 export { cn } from './lib/cn';

src/types.ts

@@ -26,6 +26,7 @@ export type {
   OneDeltaMarketRow,
   OneDeltaTokenRisk,
   OneDeltaUnderlyingAsset,
+  RoutingAndLiquidityOptions,
   SessionCtx,
   WidgetFlow,
   WidgetMode,
@@ -49,6 +50,7 @@ import type {
   OneDeltaConfig,
   WidgetFlow,
   WidgetMode,
+  RoutingAndLiquidityOptions,
 } from '@epoch-protocol/epoch-flows-sdk';
 
 /** SDK config plus widget-only testnet endpoint overrides. */
@@ -295,12 +297,17 @@ export interface EpochIntentWidgetProps {
   earnPoolsSortDir?: 'ASC' | 'DESC';
   /** @deprecated retained for backwards compatibility. */
   earnUseMockData?: boolean;
-  /**
-   * Optional Miden wallet adapter for funding earn deposits from Miden (testnet).
+  /** Optional Miden wallet adapter for funding earn deposits from Miden (testnet).
    * Requires a connected EVM wallet as intent sponsor; Miden supplies collateral via P2IDE note.
    */
   earnMiden?: EarnMidenAdapter;
 
+  /**
+   * Restrict which solver liquidity paths SIO may quote for pay, swap, and earn flows.
+   * Use the same value for quote and submit. Defaults to `{ preset: "any" }` when omitted.
+   */
+  routingAndLiquidityOptions?: RoutingAndLiquidityOptions;
+
   // ---- API ------------------------------------------------------------------
 
   api: ApiConfig;

src/use-intent-flow.ts

@@ -13,6 +13,7 @@ import type {
   OnSignCtx,
   OnSuccessCtx,
   OnErrorCtx,
+  RoutingAndLiquidityOptions,
   WidgetFlow,
 } from './types';
 
@@ -29,6 +30,7 @@ interface UseIntentFlowParams {
   sessionId: string;
   mode: WidgetFlow;
   receiver?: `0x${string}`;
+  routingAndLiquidityOptions?: RoutingAndLiquidityOptions;
   onIntentSent?: (data: IntentSentPayload) => void;
   onIntentComplete?: (data: IntentCompletePayload) => void;
   onError?: (error: Error) => void;
@@ -71,6 +73,7 @@ export function useIntentFlow(params: UseIntentFlowParams): UseIntentFlowReturn
     sessionId,
     mode,
     receiver,
+    routingAndLiquidityOptions,
     onIntentSent,
     onIntentComplete,
     onError,
@@ -136,6 +139,7 @@ export function useIntentFlow(params: UseIntentFlowParams): UseIntentFlowReturn
       intentConfig,
       isTestnet,
       receiver,
+      routingAndLiquidityOptions,
     });
     sessionRef.current = session;
 
@@ -183,6 +187,7 @@ export function useIntentFlow(params: UseIntentFlowParams): UseIntentFlowReturn
     mode,
     isTestnet,
     receiver,
+    routingAndLiquidityOptions,
     // Hot deps for the session config — recreating on intent shape changes is
     // fine because typed-data signing is per-submit anyway.
     requiredToken,