@quantabit/swap-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QuantaBit Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# @quantabit/swap-sdk
+
+QuantaBit Swap SDK facilitates instant token swap operations, optimal path routing calculations, automated market maker (AMM) pool interactions, and slippage monitoring on the QuantaBit network.
+
+## Features
+
+- **Swap Quote Generation**: Retrieve real-time pricing feeds with LP fee and price impact indicators.
+- **Slippage Enforcement**: Strict client-side validation to abort transactions under high price impact.
+- **Liquidity Pool Queries**: Fetch liquidity details, trade rates and token assets.
+- **State Synchronization Hooks**: React hooks to fetch real-time quotes on token pair inputs.
+- **Multilingual dictionary**: Built-in support for localized notifications in EN, ZH, JA, and KO.
+
+## Installation
+
+```bash
+npm install @quantabit/swap-sdk @quantabit/sdk-config
+```
+
+## Quick Start
+
+```javascript
+import { getSwapQuote, executeSwap, getLiquidityPools } from '@quantabit/swap-sdk';
+
+// Get swap route/quote
+const quote = await getSwapQuote('QBT', 'USDT', 100);
+
+// Execute swap with 1% max slippage tolerance
+const result = await executeSwap(quote, 'user_wallet_address', 0.01);
+```
+
+## Brand & Links
+
+- **Official Website**: [https://quantabit.io](https://quantabit.io)
+- **Documentation**: [https://docs.quantabit.io](https://docs.quantabit.io)
+- **Explorer**: [https://explorer.mg.qbitchain.io](https://explorer.mg.qbitchain.io)
+- **Source Code**: [https://github.com/quantabit-chain/qbit-sdk](https://github.com/quantabit-chain/qbit-sdk)

package/dist/index.cjs

@@ -0,0 +1,159 @@
+'use strict';
+
+var react = require('react');
+var sdkConfig = require('@quantabit/sdk-config');
+
+const messages = {
+  en: {
+    swap_success: "Swap transaction executed successfully",
+    swap_failed: "Swap transaction failed",
+    slippage_exceeded: "Price slippage limit exceeded",
+    insufficient_liquidity: "Insufficient liquidity in pool",
+    invalid_token_pair: "Invalid token pair specified"
+  },
+  zh: {
+    swap_success: "兑换交易成功执行",
+    swap_failed: "兑换交易失败",
+    slippage_exceeded: "价格滑点超出限制",
+    insufficient_liquidity: "资金池流动性不足",
+    invalid_token_pair: "指定的代币交易对无效"
+  },
+  ja: {
+    swap_success: "スワップ取引が正常に実行されました",
+    swap_failed: "スワップ取引に失敗しました",
+    slippage_exceeded: "許容スリッページ制限を超過しました",
+    insufficient_liquidity: "プール内の流動性が不足しています",
+    invalid_token_pair: "無効なトークンペアが指定されました"
+  },
+  ko: {
+    swap_success: "스왑 트랜잭션이 성공적으로 실행되었습니다",
+    swap_failed: "스왑 트랜잭션 실패",
+    slippage_exceeded: "허용 슬리피지 한도 초과",
+    insufficient_liquidity: "풀 내 유동성이 부족합니다",
+    invalid_token_pair: "유효하지 않은 토큰 쌍입니다"
+  }
+};
+let currentLang = null;
+function getLanguage() {
+  return currentLang || sdkConfig.getLanguage() || 'en';
+}
+function setLanguage(lang) {
+  if (messages[lang]) {
+    currentLang = lang;
+  }
+}
+function t(key) {
+  const lang = getLanguage();
+  return messages[lang]?.[key] || messages['en']?.[key] || key;
+}
+
+// 模拟 AMM 资金池兑换率
+const EXCHANGE_RATES = {
+  "QBT/USDT": 1.25,
+  "XWIN/USDT": 0.88,
+  "wQBT/QBT": 1.00
+};
+async function getSwapQuote(fromToken, toToken, amount) {
+  if (amount <= 0) {
+    throw new Error("Amount must be positive");
+  }
+  const pair1 = `${fromToken}/${toToken}`;
+  const pair2 = `${toToken}/${fromToken}`;
+  let rate;
+  if (EXCHANGE_RATES[pair1]) {
+    rate = EXCHANGE_RATES[pair1];
+  } else if (EXCHANGE_RATES[pair2]) {
+    rate = 1 / EXCHANGE_RATES[pair2];
+  } else {
+    throw new Error(t('invalid_token_pair'));
+  }
+
+  // 模拟少量价差/手续费/滑点 (0.3% LP fee)
+  const lpFee = amount * 0.003;
+  const outputAmount = (amount - lpFee) * rate;
+  const priceImpact = parseFloat((amount * 0.0001).toFixed(4)); // 0.01% price impact per unit of input
+
+  return {
+    fromToken,
+    toToken,
+    inputAmount: amount,
+    outputAmount: parseFloat(outputAmount.toFixed(6)),
+    rate: parseFloat(rate.toFixed(6)),
+    lpFee: parseFloat(lpFee.toFixed(6)),
+    priceImpact: priceImpact > 0.1 ? 0.1 : priceImpact
+  };
+}
+async function executeSwap(quote, userWallet, maxSlippage = 0.01) {
+  if (!quote || !userWallet) {
+    throw new Error("Missing swap quote or user wallet");
+  }
+
+  // 模拟滑点判定
+  if (quote.priceImpact > maxSlippage) {
+    throw new Error(t('slippage_exceeded'));
+  }
+  return {
+    txHash: `swap_tx_${Math.random().toString(36).substr(2, 9)}`,
+    fromToken: quote.fromToken,
+    toToken: quote.toToken,
+    inputAmount: quote.inputAmount,
+    outputAmount: quote.outputAmount,
+    status: "success",
+    message: t('swap_success')
+  };
+}
+async function getLiquidityPools() {
+  return Object.keys(EXCHANGE_RATES).map(pair => {
+    const [tokenA, tokenB] = pair.split('/');
+    return {
+      pair,
+      tokenA,
+      tokenB,
+      rate: EXCHANGE_RATES[pair],
+      liquidityUSD: Math.floor(Math.random() * 5000000) + 1000000
+    };
+  });
+}
+function useSwapQuote(fromToken, toToken, amount) {
+  const [quote, setQuote] = react.useState(null);
+  const [error, setError] = react.useState(null);
+  const [loading, setLoading] = react.useState(false);
+  react.useEffect(() => {
+    if (!fromToken || !toToken || !amount || amount <= 0) {
+      setQuote(null);
+      return;
+    }
+    setLoading(true);
+    setError(null);
+    const timer = setTimeout(async () => {
+      try {
+        const q = await getSwapQuote(fromToken, toToken, amount);
+        setQuote(q);
+      } catch (err) {
+        setError(err.message);
+        setQuote(null);
+      } finally {
+        setLoading(false);
+      }
+    }, 500);
+    return () => clearTimeout(timer);
+  }, [fromToken, toToken, amount]);
+  return {
+    quote,
+    error,
+    loading
+  };
+}
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+
+exports.EXCHANGE_RATES = EXCHANGE_RATES;
+exports.SUPPORTED_LANGUAGES = SUPPORTED_LANGUAGES;
+exports.executeSwap = executeSwap;
+exports.getLanguage = getLanguage;
+exports.getLiquidityPools = getLiquidityPools;
+exports.getSwapQuote = getSwapQuote;
+exports.messages = messages;
+exports.setLanguage = setLanguage;
+exports.t = t;
+exports.useSwapQuote = useSwapQuote;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/i18n/index.js","../src/index.js"],"sourcesContent":["import { getLanguage as getGlobalLang } from '@quantabit/sdk-config';\n\nexport const messages = {\n  en: {\n    swap_success: \"Swap transaction executed successfully\",\n    swap_failed: \"Swap transaction failed\",\n    slippage_exceeded: \"Price slippage limit exceeded\",\n    insufficient_liquidity: \"Insufficient liquidity in pool\",\n    invalid_token_pair: \"Invalid token pair specified\"\n  },\n  zh: {\n    swap_success: \"兑换交易成功执行\",\n    swap_failed: \"兑换交易失败\",\n    slippage_exceeded: \"价格滑点超出限制\",\n    insufficient_liquidity: \"资金池流动性不足\",\n    invalid_token_pair: \"指定的代币交易对无效\"\n  },\n  ja: {\n    swap_success: \"スワップ取引が正常に実行されました\",\n    swap_failed: \"スワップ取引に失敗しました\",\n    slippage_exceeded: \"許容スリッページ制限を超過しました\",\n    insufficient_liquidity: \"プール内の流動性が不足しています\",\n    invalid_token_pair: \"無効なトークンペアが指定されました\"\n  },\n  ko: {\n    swap_success: \"스왑 트랜잭션이 성공적으로 실행되었습니다\",\n    swap_failed: \"스왑 트랜잭션 실패\",\n    slippage_exceeded: \"허용 슬리피지 한도 초과\",\n    insufficient_liquidity: \"풀 내 유동성이 부족합니다\",\n    invalid_token_pair: \"유효하지 않은 토큰 쌍입니다\"\n  }\n};\n\nlet currentLang = null;\n\nexport function getLanguage() {\n  return currentLang || getGlobalLang() || 'en';\n}\n\nexport function setLanguage(lang) {\n  if (messages[lang]) {\n    currentLang = lang;\n  }\n}\n\nexport function t(key) {\n  const lang = getLanguage();\n  return messages[lang]?.[key] || messages['en']?.[key] || key;\n}\n","import { useState, useEffect } from 'react';\nimport { getConfig } from '@quantabit/sdk-config';\nimport { t, setLanguage, getLanguage, messages } from './i18n/index.js';\n\n// 模拟 AMM 资金池兑换率\nconst EXCHANGE_RATES = {\n  \"QBT/USDT\": 1.25,\n  \"XWIN/USDT\": 0.88,\n  \"wQBT/QBT\": 1.00\n};\n\nexport async function getSwapQuote(fromToken, toToken, amount) {\n  if (amount <= 0) {\n    throw new Error(\"Amount must be positive\");\n  }\n  \n  const pair1 = `${fromToken}/${toToken}`;\n  const pair2 = `${toToken}/${fromToken}`;\n  let rate;\n  \n  if (EXCHANGE_RATES[pair1]) {\n    rate = EXCHANGE_RATES[pair1];\n  } else if (EXCHANGE_RATES[pair2]) {\n    rate = 1 / EXCHANGE_RATES[pair2];\n  } else {\n    throw new Error(t('invalid_token_pair'));\n  }\n  \n  // 模拟少量价差/手续费/滑点 (0.3% LP fee)\n  const lpFee = amount * 0.003;\n  const outputAmount = (amount - lpFee) * rate;\n  const priceImpact = parseFloat((amount * 0.0001).toFixed(4)); // 0.01% price impact per unit of input\n  \n  return {\n    fromToken,\n    toToken,\n    inputAmount: amount,\n    outputAmount: parseFloat(outputAmount.toFixed(6)),\n    rate: parseFloat(rate.toFixed(6)),\n    lpFee: parseFloat(lpFee.toFixed(6)),\n    priceImpact: priceImpact > 0.1 ? 0.1 : priceImpact\n  };\n}\n\nexport async function executeSwap(quote, userWallet, maxSlippage = 0.01) {\n  if (!quote || !userWallet) {\n    throw new Error(\"Missing swap quote or user wallet\");\n  }\n  \n  // 模拟滑点判定\n  if (quote.priceImpact > maxSlippage) {\n    throw new Error(t('slippage_exceeded'));\n  }\n  \n  return {\n    txHash: `swap_tx_${Math.random().toString(36).substr(2, 9)}`,\n    fromToken: quote.fromToken,\n    toToken: quote.toToken,\n    inputAmount: quote.inputAmount,\n    outputAmount: quote.outputAmount,\n    status: \"success\",\n    message: t('swap_success')\n  };\n}\n\nexport async function getLiquidityPools() {\n  return Object.keys(EXCHANGE_RATES).map(pair => {\n    const [tokenA, tokenB] = pair.split('/');\n    return {\n      pair,\n      tokenA,\n      tokenB,\n      rate: EXCHANGE_RATES[pair],\n      liquidityUSD: Math.floor(Math.random() * 5000000) + 1000000\n    };\n  });\n}\n\nexport function useSwapQuote(fromToken, toToken, amount) {\n  const [quote, setQuote] = useState(null);\n  const [error, setError] = useState(null);\n  const [loading, setLoading] = useState(false);\n\n  useEffect(() => {\n    if (!fromToken || !toToken || !amount || amount <= 0) {\n      setQuote(null);\n      return;\n    }\n    setLoading(true);\n    setError(null);\n    \n    const timer = setTimeout(async () => {\n      try {\n        const q = await getSwapQuote(fromToken, toToken, amount);\n        setQuote(q);\n      } catch (err) {\n        setError(err.message);\n        setQuote(null);\n      } finally {\n        setLoading(false);\n      }\n    }, 500);\n\n    return () => clearTimeout(timer);\n  }, [fromToken, toToken, amount]);\n\n  return { quote, error, loading };\n}\n\nexport { t, setLanguage, getLanguage, messages };\nexport const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];\nexport { EXCHANGE_RATES };\n"],"names":["messages","en","swap_success","swap_failed","slippage_exceeded","insufficient_liquidity","invalid_token_pair","zh","ja","ko","currentLang","getLanguage","getGlobalLang","setLanguage","lang","t","key","EXCHANGE_RATES","getSwapQuote","fromToken","toToken","amount","Error","pair1","pair2","rate","lpFee","outputAmount","priceImpact","parseFloat","toFixed","inputAmount","executeSwap","quote","userWallet","maxSlippage","txHash","Math","random","toString","substr","status","message","getLiquidityPools","Object","keys","map","pair","tokenA","tokenB","split","liquidityUSD","floor","useSwapQuote","setQuote","useState","error","setError","loading","setLoading","useEffect","timer","setTimeout","q","err","clearTimeout","SUPPORTED_LANGUAGES"],"mappings":"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"}

package/dist/index.esm.js

@@ -0,0 +1,148 @@
+import { useState, useEffect } from 'react';
+import { getLanguage as getLanguage$1 } from '@quantabit/sdk-config';
+
+const messages = {
+  en: {
+    swap_success: "Swap transaction executed successfully",
+    swap_failed: "Swap transaction failed",
+    slippage_exceeded: "Price slippage limit exceeded",
+    insufficient_liquidity: "Insufficient liquidity in pool",
+    invalid_token_pair: "Invalid token pair specified"
+  },
+  zh: {
+    swap_success: "兑换交易成功执行",
+    swap_failed: "兑换交易失败",
+    slippage_exceeded: "价格滑点超出限制",
+    insufficient_liquidity: "资金池流动性不足",
+    invalid_token_pair: "指定的代币交易对无效"
+  },
+  ja: {
+    swap_success: "スワップ取引が正常に実行されました",
+    swap_failed: "スワップ取引に失敗しました",
+    slippage_exceeded: "許容スリッページ制限を超過しました",
+    insufficient_liquidity: "プール内の流動性が不足しています",
+    invalid_token_pair: "無効なトークンペアが指定されました"
+  },
+  ko: {
+    swap_success: "스왑 트랜잭션이 성공적으로 실행되었습니다",
+    swap_failed: "스왑 트랜잭션 실패",
+    slippage_exceeded: "허용 슬리피지 한도 초과",
+    insufficient_liquidity: "풀 내 유동성이 부족합니다",
+    invalid_token_pair: "유효하지 않은 토큰 쌍입니다"
+  }
+};
+let currentLang = null;
+function getLanguage() {
+  return currentLang || getLanguage$1() || 'en';
+}
+function setLanguage(lang) {
+  if (messages[lang]) {
+    currentLang = lang;
+  }
+}
+function t(key) {
+  const lang = getLanguage();
+  return messages[lang]?.[key] || messages['en']?.[key] || key;
+}
+
+// 模拟 AMM 资金池兑换率
+const EXCHANGE_RATES = {
+  "QBT/USDT": 1.25,
+  "XWIN/USDT": 0.88,
+  "wQBT/QBT": 1.00
+};
+async function getSwapQuote(fromToken, toToken, amount) {
+  if (amount <= 0) {
+    throw new Error("Amount must be positive");
+  }
+  const pair1 = `${fromToken}/${toToken}`;
+  const pair2 = `${toToken}/${fromToken}`;
+  let rate;
+  if (EXCHANGE_RATES[pair1]) {
+    rate = EXCHANGE_RATES[pair1];
+  } else if (EXCHANGE_RATES[pair2]) {
+    rate = 1 / EXCHANGE_RATES[pair2];
+  } else {
+    throw new Error(t('invalid_token_pair'));
+  }
+
+  // 模拟少量价差/手续费/滑点 (0.3% LP fee)
+  const lpFee = amount * 0.003;
+  const outputAmount = (amount - lpFee) * rate;
+  const priceImpact = parseFloat((amount * 0.0001).toFixed(4)); // 0.01% price impact per unit of input
+
+  return {
+    fromToken,
+    toToken,
+    inputAmount: amount,
+    outputAmount: parseFloat(outputAmount.toFixed(6)),
+    rate: parseFloat(rate.toFixed(6)),
+    lpFee: parseFloat(lpFee.toFixed(6)),
+    priceImpact: priceImpact > 0.1 ? 0.1 : priceImpact
+  };
+}
+async function executeSwap(quote, userWallet, maxSlippage = 0.01) {
+  if (!quote || !userWallet) {
+    throw new Error("Missing swap quote or user wallet");
+  }
+
+  // 模拟滑点判定
+  if (quote.priceImpact > maxSlippage) {
+    throw new Error(t('slippage_exceeded'));
+  }
+  return {
+    txHash: `swap_tx_${Math.random().toString(36).substr(2, 9)}`,
+    fromToken: quote.fromToken,
+    toToken: quote.toToken,
+    inputAmount: quote.inputAmount,
+    outputAmount: quote.outputAmount,
+    status: "success",
+    message: t('swap_success')
+  };
+}
+async function getLiquidityPools() {
+  return Object.keys(EXCHANGE_RATES).map(pair => {
+    const [tokenA, tokenB] = pair.split('/');
+    return {
+      pair,
+      tokenA,
+      tokenB,
+      rate: EXCHANGE_RATES[pair],
+      liquidityUSD: Math.floor(Math.random() * 5000000) + 1000000
+    };
+  });
+}
+function useSwapQuote(fromToken, toToken, amount) {
+  const [quote, setQuote] = useState(null);
+  const [error, setError] = useState(null);
+  const [loading, setLoading] = useState(false);
+  useEffect(() => {
+    if (!fromToken || !toToken || !amount || amount <= 0) {
+      setQuote(null);
+      return;
+    }
+    setLoading(true);
+    setError(null);
+    const timer = setTimeout(async () => {
+      try {
+        const q = await getSwapQuote(fromToken, toToken, amount);
+        setQuote(q);
+      } catch (err) {
+        setError(err.message);
+        setQuote(null);
+      } finally {
+        setLoading(false);
+      }
+    }, 500);
+    return () => clearTimeout(timer);
+  }, [fromToken, toToken, amount]);
+  return {
+    quote,
+    error,
+    loading
+  };
+}
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+
+export { EXCHANGE_RATES, SUPPORTED_LANGUAGES, executeSwap, getLanguage, getLiquidityPools, getSwapQuote, messages, setLanguage, t, useSwapQuote };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/i18n/index.js","../src/index.js"],"sourcesContent":["import { getLanguage as getGlobalLang } from '@quantabit/sdk-config';\n\nexport const messages = {\n  en: {\n    swap_success: \"Swap transaction executed successfully\",\n    swap_failed: \"Swap transaction failed\",\n    slippage_exceeded: \"Price slippage limit exceeded\",\n    insufficient_liquidity: \"Insufficient liquidity in pool\",\n    invalid_token_pair: \"Invalid token pair specified\"\n  },\n  zh: {\n    swap_success: \"兑换交易成功执行\",\n    swap_failed: \"兑换交易失败\",\n    slippage_exceeded: \"价格滑点超出限制\",\n    insufficient_liquidity: \"资金池流动性不足\",\n    invalid_token_pair: \"指定的代币交易对无效\"\n  },\n  ja: {\n    swap_success: \"スワップ取引が正常に実行されました\",\n    swap_failed: \"スワップ取引に失敗しました\",\n    slippage_exceeded: \"許容スリッページ制限を超過しました\",\n    insufficient_liquidity: \"プール内の流動性が不足しています\",\n    invalid_token_pair: \"無効なトークンペアが指定されました\"\n  },\n  ko: {\n    swap_success: \"스왑 트랜잭션이 성공적으로 실행되었습니다\",\n    swap_failed: \"스왑 트랜잭션 실패\",\n    slippage_exceeded: \"허용 슬리피지 한도 초과\",\n    insufficient_liquidity: \"풀 내 유동성이 부족합니다\",\n    invalid_token_pair: \"유효하지 않은 토큰 쌍입니다\"\n  }\n};\n\nlet currentLang = null;\n\nexport function getLanguage() {\n  return currentLang || getGlobalLang() || 'en';\n}\n\nexport function setLanguage(lang) {\n  if (messages[lang]) {\n    currentLang = lang;\n  }\n}\n\nexport function t(key) {\n  const lang = getLanguage();\n  return messages[lang]?.[key] || messages['en']?.[key] || key;\n}\n","import { useState, useEffect } from 'react';\nimport { getConfig } from '@quantabit/sdk-config';\nimport { t, setLanguage, getLanguage, messages } from './i18n/index.js';\n\n// 模拟 AMM 资金池兑换率\nconst EXCHANGE_RATES = {\n  \"QBT/USDT\": 1.25,\n  \"XWIN/USDT\": 0.88,\n  \"wQBT/QBT\": 1.00\n};\n\nexport async function getSwapQuote(fromToken, toToken, amount) {\n  if (amount <= 0) {\n    throw new Error(\"Amount must be positive\");\n  }\n  \n  const pair1 = `${fromToken}/${toToken}`;\n  const pair2 = `${toToken}/${fromToken}`;\n  let rate;\n  \n  if (EXCHANGE_RATES[pair1]) {\n    rate = EXCHANGE_RATES[pair1];\n  } else if (EXCHANGE_RATES[pair2]) {\n    rate = 1 / EXCHANGE_RATES[pair2];\n  } else {\n    throw new Error(t('invalid_token_pair'));\n  }\n  \n  // 模拟少量价差/手续费/滑点 (0.3% LP fee)\n  const lpFee = amount * 0.003;\n  const outputAmount = (amount - lpFee) * rate;\n  const priceImpact = parseFloat((amount * 0.0001).toFixed(4)); // 0.01% price impact per unit of input\n  \n  return {\n    fromToken,\n    toToken,\n    inputAmount: amount,\n    outputAmount: parseFloat(outputAmount.toFixed(6)),\n    rate: parseFloat(rate.toFixed(6)),\n    lpFee: parseFloat(lpFee.toFixed(6)),\n    priceImpact: priceImpact > 0.1 ? 0.1 : priceImpact\n  };\n}\n\nexport async function executeSwap(quote, userWallet, maxSlippage = 0.01) {\n  if (!quote || !userWallet) {\n    throw new Error(\"Missing swap quote or user wallet\");\n  }\n  \n  // 模拟滑点判定\n  if (quote.priceImpact > maxSlippage) {\n    throw new Error(t('slippage_exceeded'));\n  }\n  \n  return {\n    txHash: `swap_tx_${Math.random().toString(36).substr(2, 9)}`,\n    fromToken: quote.fromToken,\n    toToken: quote.toToken,\n    inputAmount: quote.inputAmount,\n    outputAmount: quote.outputAmount,\n    status: \"success\",\n    message: t('swap_success')\n  };\n}\n\nexport async function getLiquidityPools() {\n  return Object.keys(EXCHANGE_RATES).map(pair => {\n    const [tokenA, tokenB] = pair.split('/');\n    return {\n      pair,\n      tokenA,\n      tokenB,\n      rate: EXCHANGE_RATES[pair],\n      liquidityUSD: Math.floor(Math.random() * 5000000) + 1000000\n    };\n  });\n}\n\nexport function useSwapQuote(fromToken, toToken, amount) {\n  const [quote, setQuote] = useState(null);\n  const [error, setError] = useState(null);\n  const [loading, setLoading] = useState(false);\n\n  useEffect(() => {\n    if (!fromToken || !toToken || !amount || amount <= 0) {\n      setQuote(null);\n      return;\n    }\n    setLoading(true);\n    setError(null);\n    \n    const timer = setTimeout(async () => {\n      try {\n        const q = await getSwapQuote(fromToken, toToken, amount);\n        setQuote(q);\n      } catch (err) {\n        setError(err.message);\n        setQuote(null);\n      } finally {\n        setLoading(false);\n      }\n    }, 500);\n\n    return () => clearTimeout(timer);\n  }, [fromToken, toToken, amount]);\n\n  return { quote, error, loading };\n}\n\nexport { t, setLanguage, getLanguage, messages };\nexport const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];\nexport { EXCHANGE_RATES };\n"],"names":["messages","en","swap_success","swap_failed","slippage_exceeded","insufficient_liquidity","invalid_token_pair","zh","ja","ko","currentLang","getLanguage","getGlobalLang","setLanguage","lang","t","key","EXCHANGE_RATES","getSwapQuote","fromToken","toToken","amount","Error","pair1","pair2","rate","lpFee","outputAmount","priceImpact","parseFloat","toFixed","inputAmount","executeSwap","quote","userWallet","maxSlippage","txHash","Math","random","toString","substr","status","message","getLiquidityPools","Object","keys","map","pair","tokenA","tokenB","split","liquidityUSD","floor","useSwapQuote","setQuote","useState","error","setError","loading","setLoading","useEffect","timer","setTimeout","q","err","clearTimeout","SUPPORTED_LANGUAGES"],"mappings":"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"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@quantabit/swap-sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "QuantaBit Swap SDK - AMM liquidity integration, routing and smart contract swaps",
+  "main": "dist/index.cjs",
+  "module": "dist/index.esm.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "files": [
+    "dist",
+    "types",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "jest --passWithNoTests",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/quantabit-chain/qbit-sdk.git",
+    "directory": "packages/swap-sdk"
+  },
+  "keywords": [
+    "swap",
+    "amm",
+    "dex",
+    "routing",
+    "web3",
+    "react",
+    "quantabit"
+  ],
+  "author": "QuantaBit Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "dependencies": {
+    "@quantabit/sdk-config": "^1.0.10"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "qbit": {
+    "privacy": {
+      "level": "functional",
+      "dataCollection": "Fetches liquidity pool rates. No personal records stored.",
+      "gdprCompliant": true,
+      "ccpaCompliant": true
+    }
+  },
+  "homepage": "https://github.com/quantabit-chain/qbit-sdk/tree/main/packages/swap-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/quantabit-chain/qbit-sdk/issues"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,43 @@
+export interface SwapQuote {
+  fromToken: string;
+  toToken: string;
+  inputAmount: number;
+  outputAmount: number;
+  rate: number;
+  lpFee: number;
+  priceImpact: number;
+}
+
+export interface SwapResult {
+  txHash: string;
+  fromToken: string;
+  toToken: string;
+  inputAmount: number;
+  outputAmount: number;
+  status: 'success' | 'failed';
+  message: string;
+}
+
+export interface LiquidityPool {
+  pair: string;
+  tokenA: string;
+  tokenB: string;
+  rate: number;
+  liquidityUSD: number;
+}
+
+export function getSwapQuote(fromToken: string, toToken: string, amount: number): Promise<SwapQuote>;
+export function executeSwap(quote: SwapQuote, userWallet: string, maxSlippage?: number): Promise<SwapResult>;
+export function getLiquidityPools(): Promise<LiquidityPool[]>;
+
+export function useSwapQuote(fromToken: string, toToken: string, amount: number): {
+  quote: SwapQuote | null;
+  error: string | null;
+  loading: boolean;
+};
+
+export function getLanguage(): string;
+export function setLanguage(lang: string): void;
+export function t(key: string): string;
+export const SUPPORTED_LANGUAGES: string[];
+export const messages: Record<string, Record<string, string>>;