feat: add enableSwaps in transferWithHook and transfer

docs/docs/03-sdk/04-methods-reference/transfer/transferWithHook.md

@@ -109,6 +109,8 @@ sprinter.transferWithHook(settings, { baseUrl: 'https://custom.api.url' }).then(
     - `recipient?`: *(Optional)* The address of the recipient of any leftover tokens.
     - `sourceChains?`: *(Optional)* An array of source chain IDs to be considered for the transfer. If omitted, Sprinter will use all available chains for the solution.
     - `threshold?`: *(Optional)* The minimum amount of tokens required to trigger the transfer solution. If not met, the transfer solution will not proceed.
+    - `enableSwaps`: *(Optional)* Defaults to `false`. Whether to enable token swaps on the source chain.
+
 - `fetchOptions?`: *(Optional)* An object containing `baseUrl` to override the default API endpoint for this request.
 
 import HowToCallData from "../_how-to-calldata.md"

docs/docs/03-sdk/04-methods-reference/transfer/transfer_method.md

@@ -37,6 +37,7 @@ sprinter.transfer(settings).then(solution => {
   - `recipient?`: *(Optional)* The address of the recipient of any leftover tokens.
   - `sourceChains?`: *(Optional)* An array of source chain IDs to be considered for the transfer. If omitted, Sprinter will use all available chains for the solution. To limit the solution to a specific chain, provide an array containing only that chain's ID.
   - `threshold?`: *(Optional)* The minimum amount of tokens required to trigger the transfer solution. If not met, the transfer solution will not proceed.
+  - `enableSwaps`: *(Optional)* Defaults to `false`. Whether to enable token swaps on the source chain.
 
 - `fetchOptions?`: *(Optional)* An object containing `baseUrl` to override the default API endpoint for this request.
 

packages/react/.prettierrc

@@ -0,0 +1,6 @@
+{
+	"useTabs": false,
+	"singleQuote": false,
+	"trailingComma": "all",
+	"printWidth": 80
+}

packages/sdk/.prettierrc

@@ -0,0 +1,6 @@
+{
+  "useTabs": false,
+  "singleQuote": false,
+  "trailingComma": "all",
+  "printWidth": 80
+}

packages/sdk/src/api.ts

@@ -148,6 +148,7 @@ export async function getContractSolution(
     contractCall,
     threshold,
     whitelistedSourceChains,
+    enableSwaps,
   }: ContractSolutionOptions,
   { baseUrl, signal }: FetchOptions = {},
 ): Promise<SolutionResponse> {
@@ -165,6 +166,7 @@ export async function getContractSolution(
       type: "fungible",
       threshold,
       whitelistedSourceChains,
+      enableSwaps,
     }),
   }).then(
     (response) =>
@@ -185,6 +187,7 @@ export async function getContractCallSolution(
     recipient,
     threshold,
     whitelistedSourceChains,
+    enableSwaps,
   }: SingleHopContractSolutionOptions,
   { baseUrl, signal }: FetchOptions = {},
 ): Promise<SolutionResponse> {
@@ -203,6 +206,7 @@ export async function getContractCallSolution(
       recipient,
       threshold,
       whitelistedSourceChains,
+      enableSwaps,
     }),
   }).then(
     (response) =>

packages/sdk/src/internal/validators.ts

@@ -2,6 +2,7 @@ import {
   array,
   assign,
   bigint,
+  boolean,
   define,
   number,
   object,
@@ -35,6 +36,7 @@ const BridgeCoreSchema = object({
   amount: numberLike,
   threshold: optional(number()),
   sourceChains: optional(array(number())),
+  enableSwaps: optional(boolean()),
 });
 
 const BridgeCoreWithRecipientSchema = assign(

packages/sdk/src/sprinter.ts

@@ -355,6 +355,7 @@ export class Sprinter {
    * - `recipient` (optional): The address of the recipient of any leftover tokens.
    * - `threshold` (optional): The minimum amount threshold required for the transfer.
    * - `sourceChains` (optional): An array of whitelisted source chain IDs for the transfer.
+   * - `enableSwaps` {boolean} (optional): Defaults to `false`. Whether to enable token swaps on the source chain.
    *
    * @param {FetchOptions} [options] - Optional configuration for the fetch request, such as custom headers or query parameters.
    *
@@ -372,6 +373,7 @@ export class Sprinter {
    *   token: "USDC",
    *   amount: "100000000",
    *   recipient: "0xRecipientAddress", // Optional recipient of leftover tokens
+   *   enableSwaps: true,  // Enabling swaps on the source chain
    * };
    *
    * sprinter.transfer(settings).then(solution => {
@@ -387,10 +389,11 @@ export class Sprinter {
   ): Promise<SolutionResponse> {
     assert(settings, SingleHopSchema);
 
-    const { sourceChains, amount, ...data } = settings;
+    const { sourceChains, amount, enableSwaps = false, ...data } = settings;
     return await getContractCallSolution(
       {
         ...data,
+        enableSwaps,
         amount: BigInt(amount),
         whitelistedSourceChains: sourceChains,
       } as SolutionOptions,
@@ -422,6 +425,7 @@ export class Sprinter {
    * - `recipient` {string} (optional): The address of the recipient of any leftover tokens.
    * - `sourceChains` {Array<number>} (optional): An array of source chain IDs to be considered for the transfer.
    * - `threshold` {number} (optional): The minimum amount threshold required for the transfer.
+   * - `enableSwaps` {boolean} (optional): Defaults to `false`. Whether to enable token swaps on the source chain.
    *
    * @param {FetchOptions} [options] - Optional configuration for the fetch request, such as custom headers or query parameters.
    *
@@ -444,6 +448,7 @@ export class Sprinter {
    *     gasLimit: 21000,
    *   },
    *   recipient: "0xRecipientAddress", // for sending leftover tokens
+   *   enableSwaps: true,  // Enabling swaps on the source chain
    * };
    *
    * sprinter.transferWithHook(settings).then(solution => {
@@ -459,10 +464,11 @@ export class Sprinter {
   ): Promise<SolutionResponse> {
     assert(settings, SingleHopWithContractSchema);
 
-    const { sourceChains, amount, ...data } = settings;
+    const { sourceChains, amount, enableSwaps = false, ...data } = settings;
     return await getContractCallSolution(
       {
         ...data,
+        enableSwaps,
         amount: BigInt(amount),
         whitelistedSourceChains: sourceChains,
       } as SolutionOptions,

packages/sdk/src/types.ts

@@ -45,6 +45,7 @@ export interface SolutionOptions {
   amount: NumberLike;
   threshold?: number;
   whitelistedSourceChains?: ChainID[];
+  enableSwaps?: boolean;
 }
 
 export interface ContractCallSolutionOptions {