@shogun-sdk/swap 0.0.2-test.3 → 0.0.2-test.30

package/dist/core.cjs

@@ -3,6 +3,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -16,40 +17,29 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/core/index.ts
 var core_exports = {};
 __export(core_exports, {
-  ChainID: () => import_intents_sdk10.ChainID,
-  NATIVE_TOKEN: () => NATIVE_TOKEN,
-  SOLANA_CHAIN_ID: () => SOLANA_CHAIN_ID,
+  ChainId: () => ChainId,
+  OrderExecutionType: () => OrderExecutionType,
   SupportedChains: () => SupportedChains,
+  SwapSDK: () => SwapSDK,
   buildQuoteParams: () => buildQuoteParams,
-  executeOrder: () => executeOrder,
-  getBalances: () => getBalances,
-  getQuote: () => getQuote,
-  getTokenList: () => getTokenList,
-  isEvmChain: () => import_intents_sdk10.isEvmChain,
-  isNativeAddress: () => isNativeAddress,
-  isViemWalletClient: () => isViemWalletClient,
-  serializeBigIntsToStrings: () => serializeBigIntsToStrings
+  isEvmChain: () => isEvmChain
 });
 module.exports = __toCommonJS(core_exports);
 
-// src/core/token-list.ts
-var import_intents_sdk = require("@shogun-sdk/intents-sdk");
-async function getTokenList(params) {
-  return (0, import_intents_sdk.getTokenList)(params);
-}
-
 // src/core/getQuote.ts
-var import_intents_sdk4 = require("@shogun-sdk/intents-sdk");
-var import_viem = require("viem");
-
-// src/core/executeOrder/normalizeNative.ts
 var import_intents_sdk3 = require("@shogun-sdk/intents-sdk");
+var import_viem2 = require("viem");
+
+// src/core/execute/normalizeNative.ts
+var import_intents_sdk2 = require("@shogun-sdk/intents-sdk");
 
 // src/utils/address.ts
+var import_viem = require("viem");
 var NATIVE_TOKEN = {
   ETH: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
   SOL: "So11111111111111111111111111111111111111111",
@@ -60,13 +50,32 @@ var isNativeAddress = (tokenAddress) => {
   const normalizedTokenAddress = tokenAddress.toLowerCase();
   return !!tokenAddress && NATIVE_ADDRESSES.includes(normalizedTokenAddress);
 };
+function normalizeEvmTokenAddress(address) {
+  const lower = address.toLowerCase();
+  return lower === NATIVE_TOKEN.ETH.toLowerCase() ? import_viem.zeroAddress : address;
+}
 
 // src/utils/chain.ts
-var import_intents_sdk2 = require("@shogun-sdk/intents-sdk");
-var SOLANA_CHAIN_ID = import_intents_sdk2.ChainID.Solana;
-var SupportedChains = [
+var import_intents_sdk = require("@shogun-sdk/intents-sdk");
+var SOLANA_CHAIN_ID = import_intents_sdk.ChainID.Solana;
+var CURRENT_SUPPORTED = [
+  import_intents_sdk.ChainID.Solana,
+  import_intents_sdk.ChainID.BSC,
+  import_intents_sdk.ChainID.Base,
+  import_intents_sdk.ChainID.MONAD
+];
+var ChainId = Object.entries(import_intents_sdk.ChainID).reduce(
+  (acc, [key, value]) => {
+    if (typeof value === "number" && CURRENT_SUPPORTED.includes(value)) {
+      acc[key] = value;
+    }
+    return acc;
+  },
+  {}
+);
+var SupportedChainsInternal = [
   {
-    id: import_intents_sdk2.ChainID.Arbitrum,
+    id: import_intents_sdk.ChainID.Arbitrum,
     name: "Arbitrum",
     isEVM: true,
     wrapped: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
@@ -75,7 +84,7 @@ var SupportedChains = [
     tokenAddress: NATIVE_TOKEN.ETH
   },
   {
-    id: import_intents_sdk2.ChainID.Optimism,
+    id: import_intents_sdk.ChainID.Optimism,
     name: "Optimism",
     isEVM: true,
     wrapped: "0x4200000000000000000000000000000000000006",
@@ -84,7 +93,7 @@ var SupportedChains = [
     tokenAddress: NATIVE_TOKEN.ETH
   },
   {
-    id: import_intents_sdk2.ChainID.Base,
+    id: import_intents_sdk.ChainID.Base,
     name: "Base",
     isEVM: true,
     wrapped: "0x4200000000000000000000000000000000000006",
@@ -93,7 +102,7 @@ var SupportedChains = [
     tokenAddress: NATIVE_TOKEN.ETH
   },
   {
-    id: import_intents_sdk2.ChainID.Hyperliquid,
+    id: import_intents_sdk.ChainID.Hyperliquid,
     name: "Hyperliquid",
     isEVM: true,
     wrapped: "0x5555555555555555555555555555555555555555",
@@ -102,7 +111,7 @@ var SupportedChains = [
     tokenAddress: NATIVE_TOKEN.ETH
   },
   {
-    id: import_intents_sdk2.ChainID.BSC,
+    id: import_intents_sdk.ChainID.BSC,
     name: "BSC",
     isEVM: true,
     wrapped: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c",
@@ -118,8 +127,21 @@ var SupportedChains = [
     symbol: "SOL",
     decimals: 9,
     tokenAddress: NATIVE_TOKEN.SOL
+  },
+  {
+    id: import_intents_sdk.ChainID.MONAD,
+    name: "Monad",
+    isEVM: true,
+    wrapped: "0x3bd359C1119dA7Da1D913D1C4D2B7c461115433A",
+    symbol: "MON",
+    decimals: 18,
+    tokenAddress: NATIVE_TOKEN.ETH
   }
 ];
+var SupportedChains = SupportedChainsInternal.filter(
+  (c) => CURRENT_SUPPORTED.includes(c.id)
+);
+var isEvmChain = import_intents_sdk.isEvmChain;
 
 // src/utils/viem.ts
 function isViemWalletClient(wallet) {
@@ -147,9 +169,9 @@ function serializeBigIntsToStrings(obj) {
   return obj;
 }
 
-// src/core/executeOrder/normalizeNative.ts
+// src/core/execute/normalizeNative.ts
 function normalizeNative(chainId, address) {
-  if ((0, import_intents_sdk3.isEvmChain)(chainId) && isNativeAddress(address)) {
+  if ((0, import_intents_sdk2.isEvmChain)(chainId) && isNativeAddress(address)) {
     const chain = SupportedChains.find((c) => c.id === chainId);
     if (!chain?.wrapped)
       throw new Error(`Wrapped token not found for chainId ${chainId}`);
@@ -160,39 +182,43 @@ function normalizeNative(chainId, address) {
 
 // src/core/getQuote.ts
 async function getQuote(params) {
+  const amount = BigInt(params.amount);
   if (!params.tokenIn?.address || !params.tokenOut?.address) {
     throw new Error("Both tokenIn and tokenOut must include an address.");
   }
   if (!params.sourceChainId || !params.destChainId) {
     throw new Error("Both sourceChainId and destChainId are required.");
   }
-  if (params.amount <= 0n) {
+  if (amount <= 0n) {
     throw new Error("Amount must be greater than 0.");
   }
   const normalizedTokenIn = normalizeNative(params.sourceChainId, params.tokenIn.address);
-  const data = await import_intents_sdk4.QuoteProvider.getQuote({
+  const data = await import_intents_sdk3.QuoteProvider.getQuote({
     sourceChainId: params.sourceChainId,
     destChainId: params.destChainId,
     tokenIn: normalizedTokenIn,
     tokenOut: params.tokenOut.address,
-    amount: params.amount
+    amount
   });
-  const inputSlippage = params.slippage ?? 5;
-  const slippageDecimal = inputSlippage / 100;
-  const slippage = Math.min(Math.max(slippageDecimal, 0), 0.5);
+  const slippagePercent = Math.min(Math.max(params.slippage ?? 0.5, 0), 50);
   let warning;
-  if (slippage > 0.1) {
-    warning = `\u26A0\uFE0F High slippage tolerance (${(slippage * 100).toFixed(2)}%) \u2014 price may vary significantly.`;
+  if (slippagePercent > 10) {
+    warning = `\u26A0\uFE0F High slippage tolerance (${slippagePercent.toFixed(2)}%) \u2014 price may vary significantly.`;
   }
-  const estimatedAmountOut = BigInt(data.estimatedAmountOutReduced);
-  const slippageBps = BigInt(Math.round(slippage * 1e4));
+  const estimatedAmountOut = BigInt(data.estimatedAmountOut);
+  const slippageBps = BigInt(Math.round(slippagePercent * 100));
   const estimatedAmountOutAfterSlippage = estimatedAmountOut * (10000n - slippageBps) / 10000n;
+  const pricePerTokenOutInUsd = data.estimatedAmountOutUsd / Number(data.estimatedAmountOut);
+  const amountOutUsdAfterSlippage = Number(estimatedAmountOutAfterSlippage) * pricePerTokenOutInUsd;
+  const minStablecoinsAmountValue = BigInt(data.estimatedAmountInAsMinStablecoinAmount);
+  const minStablecoinsAmountAfterSlippage = minStablecoinsAmountValue * (10000n - slippageBps) / 10000n;
   const pricePerInputToken = estimatedAmountOut * 10n ** BigInt(params.tokenIn.decimals ?? 18) / BigInt(params.amount);
   return {
-    amountOut: estimatedAmountOut,
-    amountOutUsd: data.estimatedAmountOutUsd,
+    amountOut: estimatedAmountOutAfterSlippage,
+    amountOutUsd: amountOutUsdAfterSlippage,
     amountInUsd: data.amountInUsd,
-    minStablecoinsAmount: data.estimatedAmountInAsMinStablecoinAmount,
+    // Input USD stays the same
+    minStablecoinsAmount: minStablecoinsAmountAfterSlippage,
     tokenIn: {
       address: params.tokenIn.address,
       decimals: params.tokenIn.decimals ?? 18,
@@ -203,12 +229,13 @@ async function getQuote(params) {
       decimals: params.tokenOut.decimals ?? 18,
       chainId: params.destChainId
     },
-    amountIn: params.amount,
+    amountIn: BigInt(params.amount),
     pricePerInputToken,
-    slippage,
+    slippage: slippagePercent,
     internal: {
       ...data,
-      estimatedAmountOutReduced: estimatedAmountOutAfterSlippage
+      estimatedAmountOutReduced: estimatedAmountOutAfterSlippage,
+      estimatedAmountOutUsdReduced: amountOutUsdAfterSlippage
     },
     warning
   };
@@ -226,13 +253,13 @@ function buildQuoteParams({
     tokenOut,
     sourceChainId,
     destChainId,
-    amount: (0, import_viem.parseUnits)(amount.toString(), tokenIn.decimals ?? 18),
+    amount: (0, import_viem2.parseUnits)(amount.toString(), tokenIn.decimals ?? 18).toString(),
     slippage
   };
 }
 
 // src/core/getBalances.ts
-var import_intents_sdk5 = require("@shogun-sdk/intents-sdk");
+var import_intents_sdk4 = require("@shogun-sdk/intents-sdk");
 async function getBalances(params, options) {
   const { addresses, cursorEvm, cursorSvm } = params;
   const { signal } = options ?? {};
@@ -245,7 +272,7 @@ async function getBalances(params, options) {
     cursorSvm
   });
   const start = performance.now();
-  const response = await fetch(`${import_intents_sdk5.TOKEN_SEARCH_API_BASE_URL}/tokens/balances`, {
+  const response = await fetch(`${import_intents_sdk4.TOKEN_SEARCH_API_BASE_URL}/tokens/balances`, {
     method: "POST",
     headers: {
       accept: "application/json",
@@ -273,21 +300,67 @@ async function getBalances(params, options) {
   const evmItems = data.evm?.items ?? [];
   const svmItems = data.svm?.items ?? [];
   const combined = [...evmItems, ...svmItems];
+  const filtered = combined.filter(
+    (b) => CURRENT_SUPPORTED.includes(b.chainId)
+  );
   return {
-    results: combined,
+    results: filtered,
     nextCursorEvm: data.evm?.cursor ?? null,
     nextCursorSvm: data.svm?.cursor ?? null
   };
 }
 
-// src/core/executeOrder/execute.ts
-var import_intents_sdk9 = require("@shogun-sdk/intents-sdk");
-var import_viem4 = require("viem");
+// src/core/token-list.ts
+var import_intents_sdk5 = require("@shogun-sdk/intents-sdk");
+async function getTokenList(params) {
+  const url = new URL(`${import_intents_sdk5.TOKEN_SEARCH_API_BASE_URL}/tokens/search`);
+  if (params.q) url.searchParams.append("q", params.q);
+  if (params.networkId) url.searchParams.append("networkId", String(params.networkId));
+  if (params.page) url.searchParams.append("page", String(params.page));
+  if (params.limit) url.searchParams.append("limit", String(params.limit));
+  const res = await fetch(url.toString(), {
+    signal: params.signal
+  });
+  if (!res.ok) {
+    throw new Error(`Failed to fetch tokens: ${res.status} ${res.statusText}`);
+  }
+  const data = await res.json();
+  const filteredResults = data.results.filter(
+    (token) => CURRENT_SUPPORTED.includes(token.chainId)
+  );
+  return {
+    ...data,
+    results: filteredResults,
+    count: filteredResults.length
+  };
+}
+
+// src/core/token.ts
+var import_intents_sdk6 = require("@shogun-sdk/intents-sdk");
+async function getTokensData(addresses) {
+  if (!addresses?.length) return [];
+  const response = await fetch(`${import_intents_sdk6.TOKEN_SEARCH_API_BASE_URL}/tokens/tokens`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      accept: "*/*"
+    },
+    body: JSON.stringify({ addresses })
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to fetch token data: ${response.statusText}`);
+  }
+  const data = await response.json();
+  const filtered = data.filter((t) => CURRENT_SUPPORTED.includes(Number(t.chainId)));
+  return filtered;
+}
+
+// src/core/execute/execute.ts
+var import_intents_sdk12 = require("@shogun-sdk/intents-sdk");
+var import_viem7 = require("viem");
 
 // src/wallet-adapter/evm-wallet-adapter/adapter.ts
-var import_ethers = require("ethers/lib/ethers.js");
-var import_utils2 = require("ethers/lib/utils.js");
-var import_viem2 = require("viem");
+var import_viem3 = require("viem");
 function isEVMTransaction(tx) {
   return typeof tx.from === "string";
 }
@@ -305,15 +378,26 @@ var adaptViemWallet = (wallet) => {
     if (!isEVMTransaction(transaction)) {
       throw new Error("Expected EVMTransaction but got SolanaTransaction");
     }
-    const tx = await wallet.sendTransaction({
-      from: transaction.from,
-      to: transaction.to,
-      data: transaction.data,
-      value: transaction.value,
-      account: wallet.account?.address,
-      chain: wallet.chain
-    });
-    return tx;
+    if (wallet.transport.type === "http") {
+      const request = await wallet.prepareTransactionRequest({
+        to: transaction.to,
+        data: transaction.data,
+        value: transaction.value,
+        chain: wallet.chain
+      });
+      const serializedTransaction = await wallet.signTransaction(request);
+      const tx = await wallet.sendRawTransaction({ serializedTransaction });
+      return tx;
+    } else {
+      const hash = await wallet.sendTransaction({
+        to: transaction.to,
+        data: transaction.data,
+        value: transaction.value,
+        chain: wallet.chain,
+        account: wallet.account
+      });
+      return hash;
+    }
   };
   const switchChain = async (chainId) => {
     try {
@@ -336,55 +420,96 @@ var adaptViemWallet = (wallet) => {
     if (!addr) throw new Error("No address found");
     return addr;
   };
+  const readContract = async ({
+    address: address2,
+    abi,
+    functionName,
+    args = []
+  }) => {
+    const publicClient = wallet.extend(import_viem3.publicActions);
+    return await publicClient.readContract({
+      address: address2,
+      abi,
+      functionName,
+      args
+    });
+  };
   return {
     vmType: "EVM" /* EVM */,
-    transport: (0, import_viem2.custom)(wallet.transport),
+    transport: (0, import_viem3.custom)(wallet.transport),
     getChainId: async () => wallet.getChainId(),
     address,
     sendTransaction,
     signTypedData,
-    switchChain
+    switchChain,
+    readContract
   };
 };
 
-// src/core/executeOrder/handleEvmExecution.ts
-var import_intents_sdk7 = require("@shogun-sdk/intents-sdk");
-var import_viem3 = require("viem");
+// src/core/execute/handleEvmExecution.ts
+var import_intents_sdk10 = require("@shogun-sdk/intents-sdk");
+var import_viem6 = require("viem");
 
-// src/core/executeOrder/stageMessages.ts
+// src/core/execute/stageMessages.ts
 var DEFAULT_STAGE_MESSAGES = {
   processing: "Preparing transaction for execution",
   approving: "Approving token allowance",
   approved: "Token approved successfully",
-  signing: "Signing order for submission",
-  submitting: "Submitting order to Auctioneer",
-  success: "Order executed successfully",
-  error: "Order execution failed"
+  signing: "Signing transaction for submission",
+  submitting: "Submitting transaction",
+  initiated: "Transaction initiated.",
+  success: "Transaction Executed successfully",
+  success_limit: "Limit order has been submitted successfully.",
+  shogun_processing: "Shogun is processing your transaction",
+  error: "Transaction failed during submission"
 };
 
-// src/core/executeOrder/buildOrder.ts
-var import_intents_sdk6 = require("@shogun-sdk/intents-sdk");
+// src/core/execute/buildOrder.ts
+var import_intents_sdk7 = require("@shogun-sdk/intents-sdk");
+var import_viem4 = require("viem");
+
+// src/utils/order.ts
+var OrderExecutionType = /* @__PURE__ */ ((OrderExecutionType2) => {
+  OrderExecutionType2["LIMIT"] = "limit";
+  OrderExecutionType2["MARKET"] = "market";
+  return OrderExecutionType2;
+})(OrderExecutionType || {});
+
+// src/core/execute/buildOrder.ts
 async function buildOrder({
   quote,
   accountAddress,
   destination,
   deadline,
-  isSingleChain
+  isSingleChain,
+  orderType,
+  options
 }) {
   const { tokenIn, tokenOut } = quote;
+  let amountOutMin = BigInt(quote.internal.estimatedAmountOutReduced);
+  if (orderType === "limit" /* LIMIT */ && options && "executionPrice" in options) {
+    const executionPrice = Number(options.executionPrice);
+    if (Number.isFinite(executionPrice) && executionPrice > 0) {
+      const decimalsIn = tokenIn.decimals ?? 18;
+      const decimalsOut = tokenOut.decimals ?? 18;
+      const formattedAmountIn = Number((0, import_viem4.formatUnits)(BigInt(quote.amountIn.toString()), decimalsIn));
+      const rawAmountOut = formattedAmountIn * executionPrice;
+      amountOutMin = (0, import_viem4.parseUnits)(rawAmountOut.toString(), decimalsOut);
+    }
+  }
   if (isSingleChain) {
-    return await import_intents_sdk6.SingleChainOrder.create({
+    return await import_intents_sdk7.SingleChainOrder.create({
       user: accountAddress,
       chainId: tokenIn.chainId,
       tokenIn: tokenIn.address,
       tokenOut: tokenOut.address,
       amountIn: quote.amountIn,
-      amountOutMin: quote.internal.estimatedAmountOutReduced,
+      amountOutMin,
       deadline,
       destinationAddress: destination
     });
   }
-  return await import_intents_sdk6.CrossChainOrder.create({
+  return await import_intents_sdk7.CrossChainOrder.create({
     user: accountAddress,
     sourceChainId: tokenIn.chainId,
     sourceTokenAddress: tokenIn.address,
@@ -393,12 +518,161 @@ async function buildOrder({
     destinationTokenAddress: tokenOut.address,
     destinationAddress: destination,
     deadline,
-    destinationTokenMinAmount: quote.internal.estimatedAmountOutReduced,
+    destinationTokenMinAmount: amountOutMin,
     minStablecoinAmount: quote.minStablecoinsAmount
   });
 }
 
-// src/core/executeOrder/handleEvmExecution.ts
+// src/utils/pollOrderStatus.ts
+var import_intents_sdk8 = require("@shogun-sdk/intents-sdk");
+async function pollOrderStatus(address, orderId, options = {}) {
+  const { intervalMs = 2e3, timeoutMs = 3e5 } = options;
+  const startTime = Date.now();
+  const isDebug = process.env.NODE_ENV !== "production";
+  const isEvmAddress = /^0x[a-fA-F0-9]{40}$/.test(address);
+  const isSuiAddress = /^0x[a-fA-F0-9]{64}$/.test(address);
+  const isSolanaAddress = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(address);
+  let queryParam;
+  if (isEvmAddress) queryParam = `evmWallets=${address}`;
+  else if (isSuiAddress) queryParam = `suiWallets=${address}`;
+  else if (isSolanaAddress) queryParam = `solanaWallets=${address}`;
+  else throw new Error(`Unrecognized wallet address format: ${address}`);
+  const queryUrl = `${import_intents_sdk8.AUCTIONEER_URL}/user_intent?${queryParam}`;
+  return new Promise((resolve, reject) => {
+    const pollInterval = setInterval(async () => {
+      try {
+        if (Date.now() - startTime > timeoutMs) {
+          clearInterval(pollInterval);
+          return resolve("Timeout");
+        }
+        const res = await fetch(queryUrl, {
+          method: "GET",
+          headers: { "Content-Type": "application/json" }
+        });
+        if (!res.ok) {
+          clearInterval(pollInterval);
+          return reject(
+            new Error(`Failed to fetch orders: ${res.status} ${res.statusText}`)
+          );
+        }
+        const json = await res.json();
+        const data = json?.data ?? {};
+        const allOrders = [
+          ...data.crossChainDcaOrders ?? [],
+          ...data.crossChainLimitOrders ?? [],
+          ...data.singleChainDcaOrders ?? [],
+          ...data.singleChainLimitOrders ?? []
+        ];
+        const targetOrder = allOrders.find((o) => o.orderId === orderId);
+        if (!targetOrder) {
+          if (isDebug)
+            console.debug(`[pollOrderStatus] [${orderId}] Not found yet`);
+          return;
+        }
+        const { orderStatus } = targetOrder;
+        if (isDebug) {
+          const elapsed = ((Date.now() - startTime) / 1e3).toFixed(1);
+          console.debug(`targetOrder`, targetOrder);
+          console.debug(
+            `[pollOrderStatus] [${orderId}] status=${orderStatus} (elapsed ${elapsed}s)`
+          );
+        }
+        if (["Fulfilled", "Cancelled", "Outdated"].includes(orderStatus)) {
+          clearInterval(pollInterval);
+          return resolve(orderStatus);
+        }
+      } catch (error) {
+        clearInterval(pollInterval);
+        return reject(error);
+      }
+    }, intervalMs);
+  });
+}
+
+// src/core/execute/handleOrderPollingResult.ts
+async function handleOrderPollingResult({
+  status,
+  orderId,
+  chainId,
+  update,
+  messageFor
+}) {
+  switch (status) {
+    case "Fulfilled":
+      update("success", messageFor("success"));
+      return {
+        status: true,
+        orderId,
+        chainId,
+        finalStatus: status,
+        stage: "success"
+      };
+    case "Cancelled":
+      update("error", "Order was cancelled before fulfillment");
+      break;
+    case "Timeout":
+      update("error", "Order polling timed out");
+      break;
+    case "NotFound":
+    default:
+      update("error", "Order not found");
+      break;
+  }
+  return {
+    status: false,
+    orderId,
+    chainId,
+    finalStatus: status,
+    stage: "error"
+  };
+}
+
+// src/core/execute/ensurePermit2Allowance.ts
+var import_viem5 = require("viem");
+var import_intents_sdk9 = require("@shogun-sdk/intents-sdk");
+async function ensurePermit2Allowance({
+  chainId,
+  tokenIn,
+  wallet,
+  accountAddress,
+  requiredAmount,
+  increaseByDelta = false
+}) {
+  const spender = import_intents_sdk9.PERMIT2_ADDRESS[chainId];
+  let currentAllowance = 0n;
+  try {
+    if (!wallet.readContract) {
+      throw new Error("Wallet does not implement readContract()");
+    }
+    currentAllowance = await wallet.readContract({
+      address: tokenIn,
+      abi: import_viem5.erc20Abi,
+      functionName: "allowance",
+      args: [accountAddress, spender]
+    });
+  } catch (error) {
+    console.warn(`[Permit2] Failed to read allowance for ${tokenIn}`, error);
+  }
+  const approvalAmount = increaseByDelta ? currentAllowance + requiredAmount : import_viem5.maxUint256;
+  console.debug(
+    `[Permit2] Approving ${approvalAmount} for ${tokenIn} (current: ${currentAllowance}, required: ${requiredAmount})`
+  );
+  await wallet.sendTransaction({
+    to: tokenIn,
+    from: accountAddress,
+    data: (0, import_viem5.encodeFunctionData)({
+      abi: import_viem5.erc20Abi,
+      functionName: "approve",
+      args: [spender, approvalAmount]
+    }),
+    value: 0n
+  });
+  console.info(
+    `[Permit2] Approval transaction sent for ${tokenIn} on chain ${chainId}`
+  );
+}
+
+// src/core/execute/handleEvmExecution.ts
 async function handleEvmExecution({
   recipientAddress,
   quote,
@@ -406,18 +680,22 @@ async function handleEvmExecution({
   accountAddress,
   wallet,
   isSingleChain,
-  deadline,
-  update
+  update,
+  orderType,
+  options
 }) {
-  const messageFor = (stage) => DEFAULT_STAGE_MESSAGES[stage];
+  const messageFor = (stage) => DEFAULT_STAGE_MESSAGES[stage] ?? "";
+  const deadline = options?.deadline ?? Math.floor(Date.now() / 1e3) + 20 * 60;
   await wallet.switchChain(chainId);
   const tokenIn = normalizeNative(chainId, quote.tokenIn.address);
+  quote.tokenOut.address = normalizeEvmTokenAddress(quote.tokenOut.address);
   const shouldWrapNative = isNativeAddress(quote.tokenIn.address);
   update("processing", shouldWrapNative ? `${messageFor("processing")} (wrapping native token)` : messageFor("processing"));
   if (shouldWrapNative) {
+    quote.tokenIn.address === tokenIn;
     await wallet.sendTransaction({
       to: tokenIn,
-      data: (0, import_viem3.encodeFunctionData)({
+      data: (0, import_viem6.encodeFunctionData)({
         abi: [{ type: "function", name: "deposit", stateMutability: "payable", inputs: [], outputs: [] }],
         functionName: "deposit",
         args: []
@@ -426,43 +704,70 @@ async function handleEvmExecution({
       from: accountAddress
     });
   }
-  update("approving", messageFor("approving"));
-  await wallet.sendTransaction({
-    to: tokenIn,
-    data: (0, import_viem3.encodeFunctionData)({
-      abi: import_viem3.erc20Abi,
-      functionName: "approve",
-      args: [import_intents_sdk7.PERMIT2_ADDRESS[chainId], BigInt(quote.amountIn)]
-    }),
-    value: 0n,
-    from: accountAddress
+  update("processing", messageFor("approving"));
+  await ensurePermit2Allowance({
+    chainId,
+    tokenIn,
+    wallet,
+    accountAddress,
+    requiredAmount: BigInt(quote.amountIn)
   });
-  update("approved", messageFor("approved"));
+  update("processing", messageFor("approved"));
   const destination = recipientAddress ?? accountAddress;
   const order = await buildOrder({
     quote,
     accountAddress,
     destination,
     deadline,
-    isSingleChain
+    isSingleChain,
+    orderType,
+    options
   });
-  update("signing", messageFor("signing"));
-  const { orderTypedData, nonce } = isSingleChain ? await (0, import_intents_sdk7.getEVMSingleChainOrderTypedData)(order) : await (0, import_intents_sdk7.getEVMCrossChainOrderTypedData)(order);
+  console.debug(`order`, order);
+  update("processing", messageFor("signing"));
+  const { orderTypedData, nonce } = isSingleChain ? await (0, import_intents_sdk10.getEVMSingleChainOrderTypedData)(order) : await (0, import_intents_sdk10.getEVMCrossChainOrderTypedData)(order);
+  const typedData = serializeBigIntsToStrings(orderTypedData);
   if (!wallet.signTypedData) {
     throw new Error("Wallet does not support EIP-712 signing");
   }
-  const signature = await wallet.signTypedData(serializeBigIntsToStrings(orderTypedData));
-  update("submitting", messageFor("submitting"));
+  const signature = await wallet.signTypedData({
+    domain: typedData.domain,
+    types: typedData.types,
+    primaryType: typedData.primaryType,
+    value: typedData.message,
+    message: typedData.message
+  });
+  update("processing", messageFor("submitting"));
   const res = await order.sendToAuctioneer({ signature, nonce: nonce.toString() });
   if (!res.success) {
     throw new Error("Auctioneer submission failed");
   }
-  update("success", messageFor("success"));
-  return { status: true, txHash: res.data, chainId, stage: "success" };
+  update("initiated", messageFor("initiated"));
+  const { intentId: orderId } = res.data;
+  update("initiated", messageFor("shogun_processing"));
+  if (orderType === "limit" /* LIMIT */) {
+    update("success", messageFor("success_limit"));
+    return {
+      status: true,
+      orderId,
+      chainId,
+      finalStatus: "OrderPlaced",
+      stage: "success"
+    };
+  } else {
+    const status = await pollOrderStatus(accountAddress, orderId);
+    return await handleOrderPollingResult({
+      status,
+      orderId,
+      chainId,
+      update,
+      messageFor
+    });
+  }
 }
 
-// src/core/executeOrder/handleSolanaExecution.ts
-var import_intents_sdk8 = require("@shogun-sdk/intents-sdk");
+// src/core/execute/handleSolanaExecution.ts
+var import_intents_sdk11 = require("@shogun-sdk/intents-sdk");
 var import_web3 = require("@solana/web3.js");
 async function handleSolanaExecution({
   recipientAddress,
@@ -471,12 +776,14 @@ async function handleSolanaExecution({
   isSingleChain,
   update,
   accountAddress,
-  deadline
+  orderType,
+  options
 }) {
   if (!wallet.rpcUrl) {
     throw new Error("Solana wallet is missing rpcUrl");
   }
-  const messageFor = (stage) => DEFAULT_STAGE_MESSAGES[stage];
+  const deadline = options?.deadline ?? Math.floor(Date.now() / 1e3) + 20 * 60;
+  const messageFor = (stage) => DEFAULT_STAGE_MESSAGES[stage] ?? "";
   update("processing", messageFor("processing"));
   const destination = recipientAddress ?? accountAddress;
   const order = await buildOrder({
@@ -484,7 +791,9 @@ async function handleSolanaExecution({
     accountAddress,
     destination,
     deadline,
-    isSingleChain
+    isSingleChain,
+    orderType,
+    options
   });
   const txData = await getSolanaOrderInstructions({
     order,
@@ -492,10 +801,9 @@ async function handleSolanaExecution({
     rpcUrl: wallet.rpcUrl
   });
   const transaction = import_web3.VersionedTransaction.deserialize(Uint8Array.from(txData.txBytes));
-  update("signing", messageFor("signing"));
-  console.log({ order });
-  const txSignature = await wallet.sendTransaction(transaction);
-  update("submitting", messageFor("submitting"));
+  update("processing", messageFor("signing"));
+  await wallet.sendTransaction(transaction);
+  update("processing", messageFor("submitting"));
   const response = await submitToAuctioneer({
     order,
     isSingleChain,
@@ -504,13 +812,28 @@ async function handleSolanaExecution({
   if (!response.success) {
     throw new Error("Auctioneer submission failed");
   }
-  update("success", messageFor("success"));
-  return {
-    status: true,
-    txHash: txSignature,
-    chainId: import_intents_sdk8.ChainID.Solana,
-    stage: "success"
-  };
+  update("initiated", messageFor("initiated"));
+  const { intentId: orderId } = response.data;
+  update("initiated", messageFor("shogun_processing"));
+  if (orderType === "limit" /* LIMIT */) {
+    update("success", messageFor("success_limit"));
+    return {
+      status: true,
+      orderId,
+      chainId: SOLANA_CHAIN_ID,
+      finalStatus: "OrderPlaced",
+      stage: "success"
+    };
+  } else {
+    const status = await pollOrderStatus(accountAddress, orderId);
+    return await handleOrderPollingResult({
+      status,
+      orderId,
+      chainId: SOLANA_CHAIN_ID,
+      update,
+      messageFor
+    });
+  }
 }
 async function getSolanaOrderInstructions({
   order,
@@ -518,11 +841,11 @@ async function getSolanaOrderInstructions({
   rpcUrl
 }) {
   if (isSingleChain) {
-    return await (0, import_intents_sdk8.getSolanaSingleChainOrderInstructions)(order, {
+    return await (0, import_intents_sdk11.getSolanaSingleChainOrderInstructions)(order, {
       rpcUrl
     });
   }
-  return await (0, import_intents_sdk8.getSolanaCrossChainOrderInstructions)(order, {
+  return await (0, import_intents_sdk11.getSolanaCrossChainOrderInstructions)(order, {
     rpcUrl
   });
 }
@@ -543,52 +866,93 @@ async function submitToAuctioneer({
   });
 }
 
-// src/core/executeOrder/execute.ts
+// src/core/execute/execute.ts
 async function executeOrder({
   quote,
   accountAddress,
   recipientAddress,
   wallet,
   onStatus,
+  orderType = "market" /* MARKET */,
   options = {}
 }) {
-  const deadline = options.deadline ?? Math.floor(Date.now() / 1e3) + 20 * 60;
+  const isDev = process.env.NODE_ENV !== "production";
+  const log = (...args) => {
+    if (isDev) console.debug("[OneShot::executeOrder]", ...args);
+  };
   const messageFor = (stage) => DEFAULT_STAGE_MESSAGES[stage];
-  const update = (stage, message) => onStatus?.(stage, message ?? messageFor(stage));
+  const update = (stage, message) => {
+    log("Stage:", stage, "| Message:", message ?? messageFor(stage));
+    onStatus?.(stage, message ?? messageFor(stage));
+  };
   try {
+    log("Starting execution:", {
+      accountAddress,
+      recipientAddress,
+      tokenIn: quote?.tokenIn,
+      tokenOut: quote?.tokenOut
+    });
     const adapter = normalizeWallet(wallet);
     if (!adapter) throw new Error("No wallet provided");
     const { tokenIn, tokenOut } = quote;
+    const srcChain = Number(tokenIn.chainId);
+    const destChain = Number(tokenOut.chainId);
+    if (!CURRENT_SUPPORTED.includes(srcChain) || !CURRENT_SUPPORTED.includes(destChain)) {
+      const unsupportedChains = [
+        !CURRENT_SUPPORTED.includes(srcChain) ? srcChain : null,
+        !CURRENT_SUPPORTED.includes(destChain) ? destChain : null
+      ].filter(Boolean).join(", ");
+      const errorMsg = `Unsupported chain(s): ${unsupportedChains}`;
+      update("error", errorMsg);
+      log("Error:", errorMsg);
+      throw new Error(errorMsg);
+    }
     const isSingleChain = tokenIn.chainId === tokenOut.chainId;
     const chainId = Number(tokenIn.chainId);
-    update("processing", messageFor("processing"));
-    if ((0, import_intents_sdk9.isEvmChain)(chainId)) {
-      return await handleEvmExecution({
+    update("processing");
+    if ((0, import_intents_sdk12.isEvmChain)(chainId)) {
+      log("Detected EVM chain:", chainId);
+      const result = await handleEvmExecution({
         recipientAddress,
         quote,
         chainId,
         accountAddress,
         wallet: adapter,
         isSingleChain,
-        deadline,
-        update
+        update,
+        orderType,
+        options
       });
+      log("EVM execution result:", result);
+      return result;
     }
-    if (chainId === import_intents_sdk9.ChainID.Solana) {
-      return await handleSolanaExecution({
+    if (chainId === import_intents_sdk12.ChainID.Solana) {
+      log("Detected Solana chain");
+      const result = await handleSolanaExecution({
         recipientAddress,
         quote,
         accountAddress,
         wallet: adapter,
         isSingleChain,
-        deadline,
-        update
+        update,
+        orderType,
+        options
       });
+      log("Solana execution result:", result);
+      return result;
     }
-    update("error", "Unsupported chain");
-    return { status: false, message: "Unsupported chain", stage: "error" };
+    const unsupported = `Unsupported chain: ${chainId}`;
+    update("error", unsupported);
+    log("Error:", unsupported);
+    return { status: false, message: unsupported, stage: "error" };
   } catch (error) {
-    const message = error instanceof import_viem4.BaseError ? error.shortMessage : error instanceof Error ? error.message : String(error);
+    let message = "An unknown error occurred";
+    if (error && typeof error === "object") {
+      const err = error;
+      message = err.details ?? err.message ?? message;
+    } else if (typeof error === "string") {
+      message = error;
+    }
     update("error", message);
     return { status: false, message, stage: "error" };
   }
@@ -599,21 +963,484 @@ function normalizeWallet(wallet) {
   return wallet;
 }
 
-// src/core/index.ts
-var import_intents_sdk10 = require("@shogun-sdk/intents-sdk");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ChainID,
-  NATIVE_TOKEN,
-  SOLANA_CHAIN_ID,
-  SupportedChains,
-  buildQuoteParams,
-  executeOrder,
-  getBalances,
-  getQuote,
-  getTokenList,
-  isEvmChain,
-  isNativeAddress,
-  isViemWalletClient,
-  serializeBigIntsToStrings
-});
+// src/core/orders/getOrders.ts
+var import_intents_sdk13 = require("@shogun-sdk/intents-sdk");
+async function getOrders({
+  evmAddress,
+  solAddress
+}) {
+  if (!evmAddress && !solAddress) {
+    throw new Error("At least one wallet address (EVM, Solana) must be provided.");
+  }
+  const orders = await (0, import_intents_sdk13.fetchUserOrders)(evmAddress, solAddress);
+  return orders;
+}
+
+// src/core/orders/cancelOrder.ts
+var import_intents_sdk14 = require("@shogun-sdk/intents-sdk");
+var import_web32 = require("@solana/web3.js");
+var import_viem8 = require("viem");
+async function cancelIntentsOrder({
+  order,
+  wallet,
+  sol_rpc
+}) {
+  const isCrossChain = "srcChainId" in order && "destChainId" in order && order.srcChainId !== order.destChainId;
+  const srcChain = "srcChainId" in order ? order.srcChainId : order.chainId;
+  const isSolanaOrder = srcChain === import_intents_sdk14.ChainID.Solana;
+  if (isSolanaOrder) {
+    if (!isCrossChain) {
+      const { versionedMessageBytes: versionedMessageBytes2 } = await (0, import_intents_sdk14.cancelSingleChainOrderInstructionsAsBytes)(
+        order.orderId,
+        order.user,
+        { rpcUrl: sol_rpc }
+      );
+      const message2 = import_web32.VersionedMessage.deserialize(
+        versionedMessageBytes2
+      );
+      const tx2 = new import_web32.VersionedTransaction(message2);
+      return await wallet.sendTransaction(tx2);
+    }
+    const { versionedMessageBytes } = await (0, import_intents_sdk14.cancelCrossChainOrderInstructionsAsBytes)(
+      order.orderId,
+      order.user,
+      { rpcUrl: sol_rpc }
+    );
+    const message = import_web32.VersionedMessage.deserialize(
+      versionedMessageBytes
+    );
+    const tx = new import_web32.VersionedTransaction(message);
+    return await wallet.sendTransaction(tx);
+  }
+  const chainId = srcChain;
+  const { readContract } = wallet;
+  if (!readContract) {
+    throw new Error("Wallet does not support readContract");
+  }
+  const nonce = BigInt(order.nonce ?? "0");
+  const nonceWordPos = nonce >> 8n;
+  const nonceBitPos = nonce - nonceWordPos * 256n;
+  if (isCrossChain) {
+    const [orderData = [false, false], currentNonceBitmap = 0n] = await Promise.all([
+      readContract({
+        address: import_intents_sdk14.CROSS_CHAIN_GUARD_ADDRESSES[chainId],
+        abi: [
+          {
+            inputs: [{ name: "orderId", type: "bytes32" }],
+            name: "orderData",
+            outputs: [
+              { name: "initialized", type: "bool" },
+              { name: "deactivated", type: "bool" }
+            ],
+            stateMutability: "view",
+            type: "function"
+          }
+        ],
+        functionName: "orderData",
+        args: [order.orderId]
+      }),
+      readContract({
+        address: import_intents_sdk14.PERMIT2_ADDRESS[chainId],
+        abi: [
+          {
+            inputs: [
+              { name: "owner", type: "address" },
+              { name: "wordPos", type: "uint256" }
+            ],
+            name: "nonceBitmap",
+            outputs: [{ name: "", type: "uint256" }],
+            stateMutability: "view",
+            type: "function"
+          }
+        ],
+        functionName: "nonceBitmap",
+        args: [order.user, nonceWordPos]
+      })
+    ]);
+    const [initialized, deactivated] = orderData;
+    if (initialized) {
+      if (deactivated) {
+        throw new Error("Order is already deactivated");
+      }
+      return await wallet.sendTransaction({
+        to: import_intents_sdk14.CROSS_CHAIN_GUARD_ADDRESSES[order.srcChainId],
+        data: (0, import_viem8.encodeFunctionData)({
+          abi: [
+            {
+              inputs: [
+                {
+                  components: [
+                    { name: "user", type: "address" },
+                    { name: "tokenIn", type: "address" },
+                    { name: "srcChainId", type: "uint256" },
+                    { name: "deadline", type: "uint256" },
+                    { name: "amountIn", type: "uint256" },
+                    { name: "minStablecoinsAmount", type: "uint256" },
+                    { name: "executionDetailsHash", type: "bytes32" },
+                    { name: "nonce", type: "uint256" }
+                  ],
+                  name: "orderInfo",
+                  type: "tuple"
+                }
+              ],
+              name: "cancelOrder",
+              outputs: [],
+              stateMutability: "nonpayable",
+              type: "function"
+            }
+          ],
+          functionName: "cancelOrder",
+          args: [
+            {
+              user: order.user,
+              tokenIn: order.tokenIn,
+              srcChainId: BigInt(order.srcChainId),
+              deadline: BigInt(order.deadline),
+              amountIn: BigInt(order.amountIn),
+              minStablecoinsAmount: BigInt(order.minStablecoinsAmount),
+              executionDetailsHash: order.executionDetailsHash,
+              nonce
+            }
+          ]
+        }),
+        value: BigInt(0),
+        from: order.user
+      });
+    } else {
+      if ((currentNonceBitmap & 1n << nonceBitPos) !== 0n) {
+        throw new Error("Nonce is already invalidated");
+      }
+      const mask2 = 1n << nonceBitPos;
+      return await wallet.sendTransaction({
+        to: import_intents_sdk14.PERMIT2_ADDRESS[order.srcChainId],
+        data: (0, import_viem8.encodeFunctionData)({
+          abi: [
+            {
+              inputs: [
+                { name: "wordPos", type: "uint256" },
+                { name: "mask", type: "uint256" }
+              ],
+              name: "invalidateUnorderedNonces",
+              outputs: [],
+              stateMutability: "nonpayable",
+              type: "function"
+            }
+          ],
+          functionName: "invalidateUnorderedNonces",
+          args: [nonceWordPos, mask2]
+        }),
+        value: BigInt(0),
+        from: order.user
+      });
+    }
+  }
+  const [wasManuallyInitialized, currentBitmap = 0n] = await Promise.all([
+    readContract({
+      address: import_intents_sdk14.SINGLE_CHAIN_GUARD_ADDRESSES[chainId],
+      abi: [
+        {
+          inputs: [{ name: "orderHash", type: "bytes32" }],
+          name: "orderManuallyInitialized",
+          outputs: [{ name: "", type: "bool" }],
+          stateMutability: "view",
+          type: "function"
+        }
+      ],
+      functionName: "orderManuallyInitialized",
+      args: [order.orderId]
+    }),
+    readContract({
+      address: import_intents_sdk14.PERMIT2_ADDRESS[chainId],
+      abi: [
+        {
+          inputs: [
+            { name: "owner", type: "address" },
+            { name: "wordPos", type: "uint256" }
+          ],
+          name: "nonceBitmap",
+          outputs: [{ name: "", type: "uint256" }],
+          stateMutability: "view",
+          type: "function"
+        }
+      ],
+      functionName: "nonceBitmap",
+      args: [order.user, nonceWordPos]
+    })
+  ]);
+  if (wasManuallyInitialized) {
+    return await wallet.sendTransaction({
+      to: import_intents_sdk14.SINGLE_CHAIN_GUARD_ADDRESSES[chainId],
+      data: (0, import_viem8.encodeFunctionData)({
+        abi: [
+          {
+            inputs: [
+              {
+                name: "order",
+                type: "tuple",
+                components: [
+                  { name: "amountIn", type: "uint256" },
+                  { name: "tokenIn", type: "address" },
+                  { name: "deadline", type: "uint256" },
+                  { name: "nonce", type: "uint256" },
+                  { name: "encodedExternalCallData", type: "bytes" },
+                  {
+                    name: "extraTransfers",
+                    type: "tuple[]",
+                    components: [
+                      { name: "amount", type: "uint256" },
+                      { name: "receiver", type: "address" },
+                      { name: "token", type: "address" }
+                    ]
+                  },
+                  {
+                    name: "requestedOutput",
+                    type: "tuple",
+                    components: [
+                      { name: "amount", type: "uint256" },
+                      { name: "receiver", type: "address" },
+                      { name: "token", type: "address" }
+                    ]
+                  },
+                  { name: "user", type: "address" }
+                ]
+              }
+            ],
+            name: "cancelManuallyCreatedOrder",
+            outputs: [],
+            stateMutability: "nonpayable",
+            type: "function"
+          }
+        ],
+        functionName: "cancelManuallyCreatedOrder",
+        args: [
+          {
+            amountIn: BigInt(order.amountIn),
+            tokenIn: order.tokenIn,
+            deadline: BigInt(order.deadline),
+            nonce,
+            encodedExternalCallData: "0x",
+            extraTransfers: (order.extraTransfers || []).map((t) => ({
+              amount: BigInt(t.amount),
+              receiver: t.receiver,
+              token: t.token
+            })),
+            requestedOutput: {
+              amount: BigInt(order.amountOutMin),
+              receiver: order.destinationAddress,
+              token: order.tokenOut
+            },
+            user: order.user
+          }
+        ]
+      }),
+      value: 0n,
+      from: order.user
+    });
+  }
+  const mask = 1n << nonceBitPos;
+  if ((currentBitmap & mask) !== 0n) {
+    throw new Error("Nonce is already invalidated");
+  }
+  return await wallet.sendTransaction({
+    to: import_intents_sdk14.PERMIT2_ADDRESS[chainId],
+    data: (0, import_viem8.encodeFunctionData)({
+      abi: [
+        {
+          inputs: [
+            { name: "wordPos", type: "uint256" },
+            { name: "mask", type: "uint256" }
+          ],
+          name: "invalidateUnorderedNonces",
+          outputs: [],
+          stateMutability: "nonpayable",
+          type: "function"
+        }
+      ],
+      functionName: "invalidateUnorderedNonces",
+      args: [nonceWordPos, mask]
+    }),
+    value: 0n,
+    from: order.user
+  });
+}
+
+// src/core/client.ts
+var SwapSDK = class {
+  constructor(config) {
+    __publicField(this, "apiKey");
+    /**
+     * Fetches metadata for one or more tokens from the Shogun Token Search API.
+     *
+     * ---
+     * ### Overview
+     * `getTokensData` retrieves normalized token information — such as symbol, name,
+     * decimals, logo URI, and verified status — for a given list of token addresses.
+     *
+     * It supports both **EVM** and **SVM (Solana)** tokens, returning metadata from
+     * Shogun’s unified token registry.
+     *
+     * ---
+     * @example
+     * ```ts
+     * const tokens = await getTokensData([
+     *   "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC
+     *   "So11111111111111111111111111111111111111112", // SOL
+     * ]);
+     *
+     * console.log(tokens);
+     * [
+     * { symbol: "USDC", name: "USD Coin", chainId: 1, decimals: 6, ... },
+     * { symbol: "SOL", name: "Solana", chainId: 101, decimals: 9, ... }
+     * ]
+     * ```
+     *
+     * @param addresses - An array of token addresses (EVM or SVM) to fetch metadata for.
+     * @returns A promise resolving to an array of {@link TokenInfo} objects.
+     *
+     * @throws Will throw an error if the network request fails or the API responds with a non-OK status.
+     */
+    __publicField(this, "getTokensData", getTokensData.bind(this));
+    if (!config.apiKey) {
+      throw new Error("SwapSDK: Missing API key");
+    }
+    this.apiKey = config.apiKey;
+    if (this.apiKey) void this.apiKey;
+  }
+  /**
+   * Retrieves a swap quote for the given input and output tokens.
+   *
+   * @param params - Quote parameters including source/destination tokens and amount.
+   * @returns A normalized `SwapQuoteResponse` containing output amount, route, and metadata.
+   */
+  async getQuote(params) {
+    return getQuote(params);
+  }
+  /**
+   * Fetches token balances for the specified user wallet(s).
+   *
+   * Supports both EVM and SVM (Solana) wallet addresses.
+   *
+   * @param params - Wallet address and optional chain filters.
+   * @param options - Optional abort signal for cancellation.
+   * @returns A unified balance response with per-chain token details.
+   */
+  async getBalances(params, options) {
+    return getBalances(params, options);
+  }
+  /**
+   * Retrieves a list of verified tokens based on search query or chain filter.
+   *
+   * @param params - Search parameters (query, chain ID, pagination options).
+   * @returns Paginated `TokenSearchResponse` containing token metadata.
+   */
+  async getTokenList(params) {
+    return getTokenList(params);
+  }
+  /**
+   * Executes a prepared swap quote using the provided wallet and configuration.
+   *
+   * Handles:
+   * - Token approval (if required)
+   * - Transaction signing and broadcasting
+   * - Confirmation polling and stage-based status updates
+   *
+   * Supports both:
+   * - Market orders (with optional deadline)
+   * - Limit orders (requires executionPrice and deadline)
+   *
+   * @param quote - The swap quote to execute, containing route and metadata.
+   * @param accountAddress - The user's wallet address executing the swap.
+   * @param recipientAddress - Optional recipient address for the output tokens (defaults to sender).
+   * @param wallet - Adapted wallet instance (EVM/Solana) or a standard Viem `WalletClient`.
+   * @param onStatus - Optional callback for receiving execution stage updates and messages.
+   * @param orderType - Defines whether this is a market or limit order.
+   * @param options - Execution parameters (different per order type).
+   *
+   * @returns A finalized execution result containing transaction hash, status, and any returned data.
+   *
+   * @example
+   * ```ts
+   * * Market order
+   * const result = await sdk.executeTransaction({
+   *   quote,
+   *   accountAddress: "0x123...",
+   *   wallet,
+   *   orderType: OrderExecutionType.MARKET,
+   *   options: { deadline: 1800 },
+   *   onStatus: (stage, msg) => console.log(stage, msg),
+   * });
+   *
+   * * Limit order
+   * const result = await sdk.executeTransaction({
+   *   quote,
+   *   accountAddress: "0x123...",
+   *   wallet,
+   *   orderType: OrderExecutionType.LIMIT,
+   *   options: { executionPrice: "0.0021", deadline: 3600 },
+   * });
+   * ```
+   */
+  async executeTransaction({
+    quote,
+    accountAddress,
+    recipientAddress,
+    wallet,
+    onStatus,
+    orderType,
+    options
+  }) {
+    return executeOrder({
+      quote,
+      wallet,
+      accountAddress,
+      recipientAddress,
+      onStatus,
+      orderType,
+      options
+    });
+  }
+  /**
+  * Fetches all user orders (Market, Limit, Cross-chain) for connected wallets.
+  *
+  * ---
+  * ### Overview
+  * Retrieves both **single-chain** and **cross-chain** orders from the Shogun Intents API.
+  * Works across EVM, Solana
+  *
+  * ---
+  * @example
+  * ```ts
+  * const orders = await sdk.getOrders({
+  *   evmAddress: "0x123...",
+  *   solAddress: "9d12hF...abc",
+  * });
+  *
+  * console.log(orders.singleChainLimitOrders);
+  * ```
+  *
+  * @param params - Wallet addresses to fetch orders for (EVM, Solana).
+  * @returns A structured {@link ApiUserOrders} object containing all user orders.
+  */
+  async getOrders(params) {
+    return getOrders(params);
+  }
+  /**
+   * Cancels an order (single-chain or cross-chain) on EVM or Solana.
+   *
+   * Internally routes to the correct guard contract or Solana program to
+   * deactivate the order or invalidate its nonce.
+   *
+   * @param params.order - Order payload returned from the Intents API.
+   * @param params.wallet - Adapted wallet used to submit the cancellation transaction.
+   * @param params.solRpc - Solana RPC URL used for SVM cancellations.
+   *
+   * @returns A transaction signature or hash from the underlying wallet.
+   */
+  async cancelOrder(params) {
+    return cancelIntentsOrder({
+      order: params.order,
+      wallet: params.wallet,
+      sol_rpc: params.solRpc
+    });
+  }
+};