hak-saucerswap-plugin 1.0.0 → 1.0.1

package/dist/index.cjs

@@ -3,15 +3,15 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var zod = require('zod');
-var sdk = require('@hashgraph/sdk');
 var axios = require('axios');
+var sdk = require('@hashgraph/sdk');
 var hederaAgentKit = require('hedera-agent-kit');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var axios__default = /*#__PURE__*/_interopDefault(axios);
 
-// src/tools/swap.ts
+// src/tools/farms.ts
 
 // src/api/endpoints.ts
 var SAUCER_ENDPOINTS = {
@@ -197,6 +197,35 @@ var resolveSaucerSwapConfig = (context) => {
   };
 };
 
+// src/tools/farms.ts
+var farmsInputSchema = zod.z.object({
+  poolId: zod.z.number().int().positive().optional().describe("Optional pool ID to filter farms")
+});
+var farmsTool = {
+  method: "saucerswap_get_farms",
+  name: "SaucerSwap Get Farms",
+  description: "Get active farming opportunities on SaucerSwap.",
+  parameters: farmsInputSchema,
+  execute: async (_client, context, params) => {
+    const args = farmsInputSchema.parse(params);
+    const config = resolveSaucerSwapConfig(context);
+    const api = context.saucerswapClient ?? createSaucerSwapClient(config);
+    try {
+      const farms = await api.getFarms();
+      const filtered = args.poolId ? farms.filter((farm) => farm.poolId === args.poolId) : farms;
+      return {
+        success: true,
+        farms: filtered
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+  }
+};
+
 // src/utils/amm.ts
 var calculatePriceImpact = (inputAmount, outputAmount, poolReserveIn, poolReserveOut) => {
   const inAmount = Number(inputAmount);
@@ -218,53 +247,6 @@ var applySlippageToAmount = (amount, slippageTolerance) => {
   const numerator = BigInt(1e4 - bps);
   return (amountBig * numerator / 10000n).toString();
 };
-
-// src/utils/quote.ts
-var readAmount = (value) => {
-  if (typeof value === "string") {
-    return value;
-  }
-  if (typeof value === "number" && Number.isFinite(value)) {
-    return value.toString();
-  }
-  return null;
-};
-var normalizeSwapQuote = (quote, fallbackAmountIn) => {
-  const amountIn = readAmount(quote.amountIn) ?? fallbackAmountIn;
-  const expectedOutput = readAmount(quote.expectedOutput) ?? readAmount(quote.amountOut) ?? readAmount(quote.amountOutMin) ?? "";
-  if (!expectedOutput) {
-    throw new Error("SaucerSwap quote did not include an output amount.");
-  }
-  return {
-    amountIn,
-    expectedOutput,
-    priceImpact: typeof quote.priceImpact === "number" ? quote.priceImpact : null,
-    route: Array.isArray(quote.route) ? quote.route : [],
-    raw: quote
-  };
-};
-
-// src/utils/units.ts
-var parseUnits = (amount, decimals) => {
-  if (!amount || typeof amount !== "string") {
-    throw new Error("Amount must be a non-empty string.");
-  }
-  if (decimals < 0) {
-    throw new Error("Decimals must be non-negative.");
-  }
-  const trimmed = amount.trim();
-  if (!/^\d+(\.\d+)?$/.test(trimmed)) {
-    throw new Error(`Invalid amount format: ${amount}`);
-  }
-  const [whole, fraction = ""] = trimmed.split(".");
-  if (fraction.length > decimals) {
-    throw new Error(`Amount has more than ${decimals} decimal places.`);
-  }
-  const paddedFraction = fraction.padEnd(decimals, "0");
-  const combined = `${whole}${paddedFraction}`;
-  const normalized = combined.replace(/^0+/, "");
-  return normalized === "" ? "0" : normalized;
-};
 var normalizeTokenAlias = (token, config) => {
   const tokenLower = token.toLowerCase();
   for (const [alias, value] of Object.entries(config.tokenAliases)) {
@@ -312,211 +294,29 @@ var finalizeTransaction = async (transaction, client, context, extra) => {
   };
 };
 
-// src/tools/swap.ts
-var swapInputSchema = zod.z.object({
-  fromToken: zod.z.string().describe("Token ID to swap from (e.g., 'HBAR' or '0.0.123456')"),
-  toToken: zod.z.string().describe("Token ID to swap to"),
-  amount: zod.z.string().describe("Amount to swap (decimal format)"),
-  slippageTolerance: zod.z.number().optional().default(0.5).describe("Maximum slippage tolerance percentage"),
-  deadline: zod.z.number().optional().describe("Transaction deadline in minutes from now or a unix timestamp")
-});
-var resolveDeadline = (deadlineInput, defaultMinutes) => {
-  const now = Math.floor(Date.now() / 1e3);
-  if (!deadlineInput) {
-    return now + defaultMinutes * 60;
-  }
-  if (deadlineInput > now + 60) {
-    return Math.floor(deadlineInput);
+// src/utils/units.ts
+var parseUnits = (amount, decimals) => {
+  if (!amount || typeof amount !== "string") {
+    throw new Error("Amount must be a non-empty string.");
   }
-  return now + Math.round(deadlineInput) * 60;
-};
-var amountToSmallest = (amount, decimals) => {
-  return parseUnits(amount, decimals);
-};
-var expectedToSmallest = (amount, decimals) => {
-  return amount.includes(".") ? parseUnits(amount, decimals) : amount;
-};
-var swapTool = {
-  method: "saucerswap_swap_tokens",
-  name: "SaucerSwap Swap Tokens",
-  description: "Execute a token swap on SaucerSwap DEX.",
-  parameters: swapInputSchema,
-  execute: async (client, context, params) => {
-    const args = swapInputSchema.parse(params);
-    const config = resolveSaucerSwapConfig(context);
-    const operatorAccountId = client?.operatorAccountId?.toString();
-    const slippageTolerance = args.slippageTolerance ?? 0.5;
-    if (!operatorAccountId) {
-      return {
-        success: false,
-        error: "Hedera client with an operator account is required for swaps."
-      };
-    }
-    try {
-      const api = context.saucerswapClient ?? createSaucerSwapClient(config);
-      const fromTokenAlias = normalizeTokenAlias(args.fromToken, config);
-      const toTokenAlias = normalizeTokenAlias(args.toToken, config);
-      const fromTokenId = await api.resolveTokenId(fromTokenAlias);
-      const toTokenId = await api.resolveTokenId(toTokenAlias);
-      const fromTokenMeta = await api.getTokenByIdOrSymbol(fromTokenId);
-      const toTokenMeta = await api.getTokenByIdOrSymbol(toTokenId);
-      if (!fromTokenMeta || !toTokenMeta) {
-        return {
-          success: false,
-          error: "Unable to resolve token metadata from SaucerSwap API."
-        };
-      }
-      const quote = normalizeSwapQuote(
-        await api.getSwapQuote({
-          fromToken: fromTokenId,
-          toToken: toTokenId,
-          amount: args.amount
-        }),
-        args.amount
-      );
-      const amountInSmallest = amountToSmallest(args.amount, fromTokenMeta.decimals);
-      const expectedOutSmallest = expectedToSmallest(
-        quote.expectedOutput,
-        toTokenMeta.decimals
-      );
-      const minOutSmallest = applySlippageToAmount(expectedOutSmallest, slippageTolerance);
-      const routerContractId = config.defaultPoolVersion === "v2" ? config.routerV2ContractId ?? config.routerContractId : config.routerContractId ?? config.routerV2ContractId;
-      if (!routerContractId) {
-        return {
-          success: false,
-          error: "Missing SaucerSwap router contract ID configuration."
-        };
-      }
-      const deadline = resolveDeadline(args.deadline, config.deadlineMinutes);
-      const toAddress = accountIdToSolidityAddress(operatorAccountId);
-      const path = [
-        tokenIdToSolidityAddress(requireTokenId(fromTokenId)),
-        tokenIdToSolidityAddress(requireTokenId(toTokenId))
-      ];
-      const params2 = new sdk.ContractFunctionParameters().addUint256(amountInSmallest).addUint256(minOutSmallest).addAddressArray(path).addAddress(toAddress).addUint256(deadline);
-      const transaction = new sdk.ContractExecuteTransaction().setContractId(contractIdFromString(routerContractId)).setGas(config.gasLimit).setFunction("swapExactTokensForTokens", params2);
-      return await finalizeTransaction(transaction, client, context, {
-        estimatedOutput: quote.expectedOutput,
-        minOutput: minOutSmallest,
-        priceImpact: quote.priceImpact,
-        route: quote.route
-      });
-    } catch (error) {
-      return {
-        success: false,
-        error: error instanceof Error ? error.message : "Unknown error"
-      };
-    }
+  if (decimals < 0) {
+    throw new Error("Decimals must be non-negative.");
   }
-};
-var quoteInputSchema = zod.z.object({
-  fromToken: zod.z.string().describe("Token ID to swap from (e.g., 'HBAR' or '0.0.123456')"),
-  toToken: zod.z.string().describe("Token ID to swap to"),
-  amount: zod.z.string().describe("Amount to swap (decimal format)"),
-  slippageTolerance: zod.z.number().optional().default(0.5).describe("Maximum slippage tolerance percentage")
-});
-var quoteTool = {
-  method: "saucerswap_get_swap_quote",
-  name: "SaucerSwap Get Swap Quote",
-  description: "Get a price quote for swapping tokens on SaucerSwap.",
-  parameters: quoteInputSchema,
-  execute: async (_client, context, params) => {
-    const args = quoteInputSchema.parse(params);
-    const config = resolveSaucerSwapConfig(context);
-    const client = context.saucerswapClient;
-    const api = client ?? createSaucerSwapClient(config);
-    const slippageTolerance = args.slippageTolerance ?? 0.5;
-    try {
-      const fromToken = normalizeTokenAlias(args.fromToken, config);
-      const toToken = normalizeTokenAlias(args.toToken, config);
-      const fromTokenId = await api.resolveTokenId(fromToken);
-      const toTokenId = await api.resolveTokenId(toToken);
-      const rawQuote = await api.getSwapQuote({
-        fromToken: fromTokenId,
-        toToken: toTokenId,
-        amount: args.amount
-      });
-      const normalized = normalizeSwapQuote(rawQuote, args.amount);
-      if (normalized.priceImpact === null) {
-        const pool = await api.getPoolByTokens(fromTokenId, toTokenId, config.defaultPoolVersion);
-        if (pool && rawQuote.amountIn && rawQuote.amountOut) {
-          const isAToB = pool.tokenA.id === fromTokenId;
-          const reserveIn = isAToB ? pool.tokenReserveA : pool.tokenReserveB;
-          const reserveOut = isAToB ? pool.tokenReserveB : pool.tokenReserveA;
-          normalized.priceImpact = calculatePriceImpact(
-            rawQuote.amountIn,
-            rawQuote.amountOut,
-            reserveIn,
-            reserveOut
-          );
-        }
-      }
-      let minOutput = null;
-      if (normalized.expectedOutput.includes(".")) {
-        const expectedNumber = Number(normalized.expectedOutput);
-        minOutput = Number.isFinite(expectedNumber) ? (expectedNumber * (1 - slippageTolerance / 100)).toString() : null;
-      } else {
-        minOutput = applySlippageToAmount(normalized.expectedOutput, slippageTolerance);
-      }
-      return {
-        success: true,
-        quote: normalized,
-        minOutput
-      };
-    } catch (error) {
-      return {
-        success: false,
-        error: error instanceof Error ? error.message : "Unknown error"
-      };
-    }
+  const trimmed = amount.trim();
+  if (!/^\d+(\.\d+)?$/.test(trimmed)) {
+    throw new Error(`Invalid amount format: ${amount}`);
   }
-};
-var poolsInputSchema = zod.z.object({
-  tokenA: zod.z.string().optional().describe("First token ID or symbol"),
-  tokenB: zod.z.string().optional().describe("Second token ID or symbol"),
-  version: zod.z.enum(["v1", "v2"]).optional().describe("Pool version"),
-  limit: zod.z.number().int().positive().optional().describe("Maximum number of pools to return")
-});
-var poolsTool = {
-  method: "saucerswap_get_pools",
-  name: "SaucerSwap Get Pools",
-  description: "Query SaucerSwap liquidity pools and reserves.",
-  parameters: poolsInputSchema,
-  execute: async (_client, context, params) => {
-    const args = poolsInputSchema.parse(params);
-    const config = resolveSaucerSwapConfig(context);
-    const api = context.saucerswapClient ?? createSaucerSwapClient(config);
-    try {
-      const version = args.version ?? config.defaultPoolVersion;
-      const pools = await api.getPools(version);
-      let filtered = pools;
-      if (args.tokenA && args.tokenB) {
-        const tokenA = normalizeTokenAlias(args.tokenA, config);
-        const tokenB = normalizeTokenAlias(args.tokenB, config);
-        const tokenAId = await api.resolveTokenId(tokenA);
-        const tokenBId = await api.resolveTokenId(tokenB);
-        filtered = pools.filter((pool) => {
-          const direct = pool.tokenA.id === tokenAId && pool.tokenB.id === tokenBId;
-          const inverse = pool.tokenA.id === tokenBId && pool.tokenB.id === tokenAId;
-          return direct || inverse;
-        });
-      }
-      if (args.limit && args.limit > 0) {
-        filtered = filtered.slice(0, args.limit);
-      }
-      return {
-        success: true,
-        version,
-        pools: filtered
-      };
-    } catch (error) {
-      return {
-        success: false,
-        error: error instanceof Error ? error.message : "Unknown error"
-      };
-    }
+  const [whole, fraction = ""] = trimmed.split(".");
+  if (fraction.length > decimals) {
+    throw new Error(`Amount has more than ${decimals} decimal places.`);
   }
+  const paddedFraction = fraction.padEnd(decimals, "0");
+  const combined = `${whole}${paddedFraction}`;
+  const normalized = combined.replace(/^0+/, "");
+  return normalized === "" ? "0" : normalized;
 };
+
+// src/tools/liquidity.ts
 var addLiquidityInputSchema = zod.z.object({
   tokenA: zod.z.string().describe("First token ID"),
   tokenB: zod.z.string().describe("Second token ID"),
@@ -531,7 +331,7 @@ var removeLiquidityInputSchema = zod.z.object({
   minAmountA: zod.z.string().describe("Minimum amount of tokenA to receive"),
   minAmountB: zod.z.string().describe("Minimum amount of tokenB to receive")
 });
-var resolveDeadline2 = (defaultMinutes) => {
+var resolveDeadline = (defaultMinutes) => {
   return Math.floor(Date.now() / 1e3) + defaultMinutes * 60;
 };
 var resolveRouterContract = (config) => {
@@ -576,7 +376,7 @@ var addLiquidityTool = {
       const amountAMin = applySlippageToAmount(amountADesired, slippageTolerance);
       const amountBMin = applySlippageToAmount(amountBDesired, slippageTolerance);
       const routerContractId = resolveRouterContract(config);
-      const deadline = resolveDeadline2(config.deadlineMinutes);
+      const deadline = resolveDeadline(config.deadlineMinutes);
       const toAddress = accountIdToSolidityAddress(operatorAccountId);
       const params2 = new sdk.ContractFunctionParameters().addAddress(tokenIdToSolidityAddress(requireTokenId(tokenAId))).addAddress(tokenIdToSolidityAddress(requireTokenId(tokenBId))).addUint256(amountADesired).addUint256(amountBDesired).addUint256(amountAMin).addUint256(amountBMin).addAddress(toAddress).addUint256(deadline);
       const transaction = new sdk.ContractExecuteTransaction().setContractId(contractIdFromString(routerContractId)).setGas(config.gasLimit).setFunction("addLiquidity", params2);
@@ -634,7 +434,7 @@ var removeLiquidityTool = {
       const minAmountA = parseUnits(args.minAmountA, tokenA.decimals);
       const minAmountB = parseUnits(args.minAmountB, tokenB.decimals);
       const routerContractId = resolveRouterContract(config);
-      const deadline = resolveDeadline2(config.deadlineMinutes);
+      const deadline = resolveDeadline(config.deadlineMinutes);
       const toAddress = accountIdToSolidityAddress(operatorAccountId);
       const params2 = new sdk.ContractFunctionParameters().addAddress(tokenIdToSolidityAddress(requireTokenId(tokenAId))).addAddress(tokenIdToSolidityAddress(requireTokenId(tokenBId))).addUint256(lpAmount).addUint256(minAmountA).addUint256(minAmountB).addAddress(toAddress).addUint256(deadline);
       const transaction = new sdk.ContractExecuteTransaction().setContractId(contractIdFromString(routerContractId)).setGas(config.gasLimit).setFunction("removeLiquidity", params2);
@@ -651,25 +451,226 @@ var removeLiquidityTool = {
     }
   }
 };
-var farmsInputSchema = zod.z.object({
-  poolId: zod.z.number().int().positive().optional().describe("Optional pool ID to filter farms")
+var poolsInputSchema = zod.z.object({
+  tokenA: zod.z.string().optional().describe("First token ID or symbol"),
+  tokenB: zod.z.string().optional().describe("Second token ID or symbol"),
+  version: zod.z.enum(["v1", "v2"]).optional().describe("Pool version"),
+  limit: zod.z.number().int().positive().optional().describe("Maximum number of pools to return")
 });
-var farmsTool = {
-  method: "saucerswap_get_farms",
-  name: "SaucerSwap Get Farms",
-  description: "Get active farming opportunities on SaucerSwap.",
-  parameters: farmsInputSchema,
+var poolsTool = {
+  method: "saucerswap_get_pools",
+  name: "SaucerSwap Get Pools",
+  description: "Query SaucerSwap liquidity pools and reserves.",
+  parameters: poolsInputSchema,
   execute: async (_client, context, params) => {
-    const args = farmsInputSchema.parse(params);
+    const args = poolsInputSchema.parse(params);
     const config = resolveSaucerSwapConfig(context);
     const api = context.saucerswapClient ?? createSaucerSwapClient(config);
     try {
-      const farms = await api.getFarms();
-      const filtered = args.poolId ? farms.filter((farm) => farm.poolId === args.poolId) : farms;
+      const version = args.version ?? config.defaultPoolVersion;
+      const pools = await api.getPools(version);
+      let filtered = pools;
+      if (args.tokenA && args.tokenB) {
+        const tokenA = normalizeTokenAlias(args.tokenA, config);
+        const tokenB = normalizeTokenAlias(args.tokenB, config);
+        const tokenAId = await api.resolveTokenId(tokenA);
+        const tokenBId = await api.resolveTokenId(tokenB);
+        filtered = pools.filter((pool) => {
+          const direct = pool.tokenA.id === tokenAId && pool.tokenB.id === tokenBId;
+          const inverse = pool.tokenA.id === tokenBId && pool.tokenB.id === tokenAId;
+          return direct || inverse;
+        });
+      }
+      if (args.limit && args.limit > 0) {
+        filtered = filtered.slice(0, args.limit);
+      }
       return {
         success: true,
-        farms: filtered
+        version,
+        pools: filtered
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error"
       };
+    }
+  }
+};
+
+// src/utils/quote.ts
+var readAmount = (value) => {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value.toString();
+  }
+  return null;
+};
+var normalizeSwapQuote = (quote, fallbackAmountIn) => {
+  const amountIn = readAmount(quote.amountIn) ?? fallbackAmountIn;
+  const expectedOutput = readAmount(quote.expectedOutput) ?? readAmount(quote.amountOut) ?? readAmount(quote.amountOutMin) ?? "";
+  if (!expectedOutput) {
+    throw new Error("SaucerSwap quote did not include an output amount.");
+  }
+  return {
+    amountIn,
+    expectedOutput,
+    priceImpact: typeof quote.priceImpact === "number" ? quote.priceImpact : null,
+    route: Array.isArray(quote.route) ? quote.route : [],
+    raw: quote
+  };
+};
+
+// src/tools/quote.ts
+var quoteInputSchema = zod.z.object({
+  fromToken: zod.z.string().describe("Token ID to swap from (e.g., 'HBAR' or '0.0.123456')"),
+  toToken: zod.z.string().describe("Token ID to swap to"),
+  amount: zod.z.string().describe("Amount to swap (decimal format)"),
+  slippageTolerance: zod.z.number().optional().default(0.5).describe("Maximum slippage tolerance percentage")
+});
+var quoteTool = {
+  method: "saucerswap_get_swap_quote",
+  name: "SaucerSwap Get Swap Quote",
+  description: "Get a price quote for swapping tokens on SaucerSwap.",
+  parameters: quoteInputSchema,
+  execute: async (_client, context, params) => {
+    const args = quoteInputSchema.parse(params);
+    const config = resolveSaucerSwapConfig(context);
+    const client = context.saucerswapClient;
+    const api = client ?? createSaucerSwapClient(config);
+    const slippageTolerance = args.slippageTolerance ?? 0.5;
+    try {
+      const fromToken = normalizeTokenAlias(args.fromToken, config);
+      const toToken = normalizeTokenAlias(args.toToken, config);
+      const fromTokenId = await api.resolveTokenId(fromToken);
+      const toTokenId = await api.resolveTokenId(toToken);
+      const rawQuote = await api.getSwapQuote({
+        fromToken: fromTokenId,
+        toToken: toTokenId,
+        amount: args.amount
+      });
+      const normalized = normalizeSwapQuote(rawQuote, args.amount);
+      if (normalized.priceImpact === null) {
+        const pool = await api.getPoolByTokens(fromTokenId, toTokenId, config.defaultPoolVersion);
+        if (pool && rawQuote.amountIn && rawQuote.amountOut) {
+          const isAToB = pool.tokenA.id === fromTokenId;
+          const reserveIn = isAToB ? pool.tokenReserveA : pool.tokenReserveB;
+          const reserveOut = isAToB ? pool.tokenReserveB : pool.tokenReserveA;
+          normalized.priceImpact = calculatePriceImpact(
+            rawQuote.amountIn,
+            rawQuote.amountOut,
+            reserveIn,
+            reserveOut
+          );
+        }
+      }
+      let minOutput = null;
+      if (normalized.expectedOutput.includes(".")) {
+        const expectedNumber = Number(normalized.expectedOutput);
+        minOutput = Number.isFinite(expectedNumber) ? (expectedNumber * (1 - slippageTolerance / 100)).toString() : null;
+      } else {
+        minOutput = applySlippageToAmount(normalized.expectedOutput, slippageTolerance);
+      }
+      return {
+        success: true,
+        quote: normalized,
+        minOutput
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+  }
+};
+var swapInputSchema = zod.z.object({
+  fromToken: zod.z.string().describe("Token ID to swap from (e.g., 'HBAR' or '0.0.123456')"),
+  toToken: zod.z.string().describe("Token ID to swap to"),
+  amount: zod.z.string().describe("Amount to swap (decimal format)"),
+  slippageTolerance: zod.z.number().optional().default(0.5).describe("Maximum slippage tolerance percentage"),
+  deadline: zod.z.number().optional().describe("Transaction deadline in minutes from now or a unix timestamp")
+});
+var resolveDeadline2 = (deadlineInput, defaultMinutes) => {
+  const now = Math.floor(Date.now() / 1e3);
+  if (!deadlineInput) {
+    return now + defaultMinutes * 60;
+  }
+  if (deadlineInput > now + 60) {
+    return Math.floor(deadlineInput);
+  }
+  return now + Math.round(deadlineInput) * 60;
+};
+var amountToSmallest = (amount, decimals) => {
+  return parseUnits(amount, decimals);
+};
+var expectedToSmallest = (amount, decimals) => {
+  return amount.includes(".") ? parseUnits(amount, decimals) : amount;
+};
+var swapTool = {
+  method: "saucerswap_swap_tokens",
+  name: "SaucerSwap Swap Tokens",
+  description: "Execute a token swap on SaucerSwap DEX.",
+  parameters: swapInputSchema,
+  execute: async (client, context, params) => {
+    const args = swapInputSchema.parse(params);
+    const config = resolveSaucerSwapConfig(context);
+    const operatorAccountId = client?.operatorAccountId?.toString();
+    const slippageTolerance = args.slippageTolerance ?? 0.5;
+    if (!operatorAccountId) {
+      return {
+        success: false,
+        error: "Hedera client with an operator account is required for swaps."
+      };
+    }
+    try {
+      const api = context.saucerswapClient ?? createSaucerSwapClient(config);
+      const fromTokenAlias = normalizeTokenAlias(args.fromToken, config);
+      const toTokenAlias = normalizeTokenAlias(args.toToken, config);
+      const fromTokenId = await api.resolveTokenId(fromTokenAlias);
+      const toTokenId = await api.resolveTokenId(toTokenAlias);
+      const fromTokenMeta = await api.getTokenByIdOrSymbol(fromTokenId);
+      const toTokenMeta = await api.getTokenByIdOrSymbol(toTokenId);
+      if (!fromTokenMeta || !toTokenMeta) {
+        return {
+          success: false,
+          error: "Unable to resolve token metadata from SaucerSwap API."
+        };
+      }
+      const quote = normalizeSwapQuote(
+        await api.getSwapQuote({
+          fromToken: fromTokenId,
+          toToken: toTokenId,
+          amount: args.amount
+        }),
+        args.amount
+      );
+      const amountInSmallest = amountToSmallest(args.amount, fromTokenMeta.decimals);
+      const expectedOutSmallest = expectedToSmallest(quote.expectedOutput, toTokenMeta.decimals);
+      const minOutSmallest = applySlippageToAmount(expectedOutSmallest, slippageTolerance);
+      const routerContractId = config.defaultPoolVersion === "v2" ? config.routerV2ContractId ?? config.routerContractId : config.routerContractId ?? config.routerV2ContractId;
+      if (!routerContractId) {
+        return {
+          success: false,
+          error: "Missing SaucerSwap router contract ID configuration."
+        };
+      }
+      const deadline = resolveDeadline2(args.deadline, config.deadlineMinutes);
+      const toAddress = accountIdToSolidityAddress(operatorAccountId);
+      const path = [
+        tokenIdToSolidityAddress(requireTokenId(fromTokenId)),
+        tokenIdToSolidityAddress(requireTokenId(toTokenId))
+      ];
+      const params2 = new sdk.ContractFunctionParameters().addUint256(amountInSmallest).addUint256(minOutSmallest).addAddressArray(path).addAddress(toAddress).addUint256(deadline);
+      const transaction = new sdk.ContractExecuteTransaction().setContractId(contractIdFromString(routerContractId)).setGas(config.gasLimit).setFunction("swapExactTokensForTokens", params2);
+      return await finalizeTransaction(transaction, client, context, {
+        estimatedOutput: quote.expectedOutput,
+        minOutput: minOutSmallest,
+        priceImpact: quote.priceImpact,
+        route: quote.route
+      });
     } catch (error) {
       return {
         success: false,