feat(preset): extend routes and quote requests to support preset

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/types",
-  "version": "17.44.1",
+  "version": "17.45.0-alpha.2",
   "description": "Types for the LI.FI stack",
   "keywords": [
     "sdk",

src/api.ts

@@ -113,29 +113,56 @@ export interface RoutesRequest {
   fromAmountForGas?: string
 }
 
-export interface RouteOptions {
-  integrator?: string // Should contain the identifier of the integrator. Usually, it's dApp/company name.
-  fee?: number // 0.03 = take 3% integrator fee (requires verified integrator to be set)
-  maxPriceImpact?: number // Hide routes with price impact greater than or equal to this value
-  order?: Order // (default: CHEAPEST) 'FASTEST' | 'CHEAPEST'
-  slippage?: number // (default: 0.03) Expressed as decimal proportion, 0.03 represents 3%
-  referrer?: string // Integrators can set a wallet address as a referrer to track them
-  allowSwitchChain?: boolean // (default: false) Whether chain switches should be allowed in the routes
-  allowDestinationCall?: boolean // (default: true) destination calls are enabled by default
+export interface RouteOptionsBase {
+  /** 0.03 = take 3% integrator fee (requires verified integrator to be set) */
+  fee?: number
+
+  /** Hide routes with price impact greater than or equal to this value */
+  maxPriceImpact?: number
+
+  /** (default: CHEAPEST) 'FASTEST' | 'CHEAPEST' */
+  order?: Order
+
+  /** (default: 0.03) Expressed as decimal proportion, 0.03 represents 3% */
+  slippage?: number
+
+  /** (default: false) Whether chain switches should be allowed in the routes */
+  allowSwitchChain?: boolean
+
+  /** (default: true) destination calls are enabled by default */
+  allowDestinationCall?: boolean
+
+  /** Bridges that should or should not be taken into consideration for the possibilities */
   bridges?: AllowDenyPrefer
+
+  /** Exchanges that should or should not be taken into consideration for the possibilities */
   exchanges?: AllowDenyPrefer
+
+  /** Timing strategies for the routes */
   timing?: Timing
-  /**
-   * Whether to include routes that require a transaction or a message, or both
-   * @default 'transaction'
-   */
+
+  /** Whether to include routes that require a transaction or a message, or both
+   * @default 'transaction' */
   executionType?: ExecutionType
-  jitoBundle?: boolean // Solana specific option, without it implicit source swaps routes are discarded
+}
+
+export interface RouteOptions extends RouteOptionsBase {
+  /** Should contain the identifier of the integrator. Usually, it's dApp/company name. */
+  integrator?: string
+
+  /** Integrators can set a wallet address as a referrer to track them */
+  referrer?: string
+
+  /** Solana specific option, without it implicit source swaps routes are discarded */
+  jitoBundle?: boolean
+
+  /** Preset configuration for stablecoin routing optimization.
+   * When provided, this preset will override other route options with optimized settings */
+  preset?: string
 
-  /**
-   * @deprecated This property is deprecated and will be removed in future versions.
-   */
-  insurance?: boolean // Whether the user wants to insure their tx
+  /** Whether the user wants to insure their tx
+   * @deprecated This property is deprecated and will be removed in future versions. */
+  insurance?: boolean
 }
 
 export const ExecutionTypes = ['transaction', 'message', 'all'] as const
@@ -322,12 +349,17 @@ export interface QuoteRequest extends ToolConfiguration, TimingStrings {
   fromAmountForGas?: string // the amount of token to convert to gas
   maxPriceImpact?: number // hide routes with price impact greater than or equal to this value
   skipSimulation?: boolean
-  jitoBundle?: boolean // Solana specific option, without it implicit source swaps routes are discarded
 
-  /**
-   * @deprecated This property is deprecated and will be removed in future versions.
-   */
-  insurance?: boolean // indicates whether the user wants a quote with bridge insurance
+  /** Solana specific option, without it implicit source swaps routes are discarded */
+  jitoBundle?: boolean
+
+  /** Preset configuration for stablecoin routing optimization
+   * When provided, this preset will override other route options with optimized settings */
+  preset?: string
+
+  /** Indicates whether the user wants a quote with bridge insurance
+   * @deprecated This property is deprecated and will be removed in future versions. */
+  insurance?: boolean
 }
 
 export interface QuoteToAmountRequest