@swapkit/core 1.0.0-rc.149 → 1.0.0-rc.150

package/dist/index.js

@@ -152,10 +152,12 @@ function SwapKit({
   function isAssetValueApproved(assetValue, contractAddress) {
     return approve({ assetValue, contractAddress, type: ApproveMode.CheckOnly });
   }
-  function swap({ pluginName, ...rest }) {
-    const plugin = getSwapKitPlugin(pluginName);
+  function swap({ route, pluginName, ...rest }) {
+    if (pluginName || route.providers[0]?.toLowerCase())
+      throw new SwapKitError("core_swap_route_not_complete");
+    const plugin = getSwapKitPlugin(pluginName || route.providers[0]?.toLowerCase());
     if ("swap" in plugin) {
-      return plugin.swap(rest);
+      return plugin.swap({ ...rest, route });
     }
     throw new SwapKitError("core_plugin_swap_not_found");
   }
@@ -178,4 +180,4 @@ export {
   SwapKit
 };
 
-//# debugId=516820E14373AD4864756e2164756e21
+//# debugId=EAD076E6FCCAA6E764756e2164756e21

package/dist/index.js.map

@@ -3,11 +3,11 @@
   "sources": ["../src/index.ts", "../src/client.ts", "../src/helpers/explorerUrls.ts", "../src/client.ts"],
   "sourcesContent": [
     "export * from \"@swapkit/api\";\nexport * from \"@swapkit/helpers\";\n\nexport * from \"./client.ts\";\n",
-  "import {\n  type AddChainWalletParams,\n  ApproveMode,\n  type ApproveReturnType,\n  AssetValue,\n  type Chain,\n  type ConnectConfig,\n  type EVMChain,\n  EVMChains,\n  SwapKitError,\n  type SwapParams,\n  type Wallet,\n} from \"@swapkit/helpers\";\nimport type { BaseEVMWallet } from \"@swapkit/toolbox-evm\";\n\nimport {\n  getExplorerAddressUrl as getAddressUrl,\n  getExplorerTxUrl as getTxUrl,\n} from \"./helpers/explorerUrls.ts\";\nimport type { Apis, SwapKitPluginInterface, SwapKitWallet } from \"./types.ts\";\n\nexport function SwapKit<\n  Plugins extends { [key in string]: SwapKitPluginInterface<{ [key in string]: Todo }> },\n  Wallets extends { [key in string]: SwapKitWallet<NotWorth[]> },\n>({\n  apis = {},\n  config = {},\n  plugins,\n  rpcUrls = {},\n  stagenet = false,\n  wallets,\n}: {\n  apis?: Apis;\n  config?: ConnectConfig;\n  plugins: Plugins;\n  rpcUrls?: { [key in Chain]?: string };\n  stagenet?: boolean;\n  wallets: Wallets;\n}) {\n  type PluginName = keyof Plugins;\n\n  /**\n   * @REMOVE (V1)\n   * Compatibility layer for plugins and wallets for easier migration and backwards compatibility\n   */\n  const compatPlugins: Plugins = Array.isArray(plugins)\n    ? plugins.reduce((acc, pluginInterface) => {\n        // @ts-ignore Ignore until we remove the compatibility layer\n        const { name, plugin } = Object.values(pluginInterface)?.[0] || {};\n        acc[name] = plugin;\n        return acc;\n      }, {})\n    : plugins;\n  const compatWallets: Wallets = Array.isArray(wallets)\n    ? wallets.reduce((acc, wallet) => {\n        // @ts-ignore Ignore until we remove the compatibility layer\n        const [walletName, connectWallet] = Object.entries(wallet)?.[0] || {};\n        acc[walletName] = connectWallet;\n        return acc;\n      }, {})\n    : wallets;\n\n  const connectedWallets = {} as Wallet;\n  const availablePlugins = Object.entries(compatPlugins).reduce(\n    (acc, [pluginName, { plugin, config }]) => {\n      const methods = plugin({ wallets: connectedWallets, stagenet, config });\n\n      // @ts-expect-error\n      acc[pluginName] = methods;\n      return acc;\n    },\n    {} as { [key in PluginName]: ReturnType<Plugins[key][\"plugin\"]> },\n  );\n\n  const connectWalletMethods = Object.entries(compatWallets).reduce(\n    (acc, [walletName, wallet]) => {\n      const connectWallet = wallet({ addChain, config, apis, rpcUrls });\n\n      // @ts-expect-error\n      acc[walletName] = connectWallet;\n      return acc;\n    },\n    {} as { [key in keyof Wallets]: ReturnType<Wallets[key]> },\n  );\n\n  /**\n   * @Private\n   */\n  function getSwapKitPlugin<T extends PluginName>(pluginName: T) {\n    const plugin = availablePlugins[pluginName] || Object.values(availablePlugins)[0];\n\n    if (!plugin) {\n      throw new SwapKitError(\"core_plugin_not_found\", \"Could not find the requested plugin\");\n    }\n\n    return plugin;\n  }\n\n  function addChain<T extends Chain>(connectWallet: AddChainWalletParams<T>) {\n    // @ts-expect-error: TODO\n    connectedWallets[connectWallet.chain] = connectWallet;\n  }\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: <explanation>\n  function approve<T extends ApproveMode>({\n    assetValue,\n    type = \"checkOnly\" as T,\n    contractAddress: spenderAddress,\n  }: {\n    type: T;\n    assetValue: AssetValue;\n    contractAddress: string | PluginName;\n  }) {\n    const plugin = availablePlugins[spenderAddress];\n\n    if (plugin) {\n      if (type === ApproveMode.CheckOnly && \"isAssetValueApproved\" in plugin) {\n        return plugin.isAssetValueApproved({ assetValue }) as ApproveReturnType<T>;\n      }\n      if (type === ApproveMode.Approve && \"approveAssetValue\" in plugin) {\n        return plugin.approveAssetValue({ assetValue }) as ApproveReturnType<T>;\n      }\n\n      throw new SwapKitError(\n        \"core_approve_asset_target_invalid\",\n        `Target ${String(spenderAddress)} cannot be used for approve operation`,\n      );\n    }\n\n    const { address, chain, isGasAsset, isSynthetic } = assetValue;\n    const isEVMChain = EVMChains.includes(chain as EVMChain);\n    const isNativeEVM = isEVMChain && isGasAsset;\n\n    if (isNativeEVM || !isEVMChain || isSynthetic) {\n      return Promise.resolve(type === \"checkOnly\" ? true : \"approved\") as ApproveReturnType<T>;\n    }\n\n    const walletMethods = connectedWallets[chain] as BaseEVMWallet;\n    const walletAction = type === \"checkOnly\" ? walletMethods?.isApproved : walletMethods?.approve;\n    if (!walletAction) throw new SwapKitError(\"core_wallet_connection_not_found\");\n\n    const from = getAddress(chain);\n    if (!(address && from && typeof spenderAddress === \"string\")) {\n      throw new SwapKitError(\"core_approve_asset_address_or_from_not_found\");\n    }\n\n    return walletAction({\n      amount: assetValue.getBaseValue(\"bigint\"),\n      assetAddress: address,\n      from,\n      spenderAddress,\n    }) as ApproveReturnType<T>;\n  }\n\n  /**\n   * @Public\n   */\n  function getWallet<T extends Chain>(chain: T) {\n    return connectedWallets[chain];\n  }\n  function getAddress<T extends Chain>(chain: T) {\n    return getWallet(chain)?.address || \"\";\n  }\n  /**\n   * TODO: Figure out validation without connecting to wallet\n   */\n  function validateAddress({ address, chain }: { address: string; chain: Chain }) {\n    return getWallet(chain)?.validateAddress?.(address);\n  }\n\n  function getBalance<T extends Chain>(chain: T, refresh?: boolean) {\n    if (refresh) {\n      return getWalletWithBalance(chain).then((wallet) => wallet.balance);\n    }\n\n    return getWallet(chain)?.balance || [];\n  }\n\n  async function getWalletWithBalance<T extends Chain>(chain: T, potentialScamFilter = true) {\n    const defaultBalance = [AssetValue.fromChainOrSignature(chain)];\n    const wallet = getWallet(chain);\n\n    if (!wallet) {\n      throw new SwapKitError(\"core_wallet_connection_not_found\");\n    }\n\n    if (\"getBalance\" in wallet) {\n      const balance = await wallet.getBalance(wallet.address, potentialScamFilter);\n      wallet.balance = balance?.length ? balance : defaultBalance;\n    }\n\n    return wallet;\n  }\n\n  function approveAssetValue(assetValue: AssetValue, contractAddress: string | PluginName) {\n    return approve({ assetValue, contractAddress, type: ApproveMode.Approve });\n  }\n\n  function isAssetValueApproved(assetValue: AssetValue, contractAddress: string | PluginName) {\n    return approve({ assetValue, contractAddress, type: ApproveMode.CheckOnly });\n  }\n\n  function swap<T extends PluginName>({ pluginName, ...rest }: SwapParams<T>) {\n    const plugin = getSwapKitPlugin(pluginName);\n\n    if (\"swap\" in plugin) {\n      return plugin.swap(rest);\n    }\n\n    throw new SwapKitError(\"core_plugin_swap_not_found\");\n  }\n\n  return {\n    ...availablePlugins,\n    ...connectWalletMethods,\n\n    approveAssetValue,\n    getAddress,\n    getBalance,\n    getExplorerAddressUrl: getAddressUrl,\n    getExplorerTxUrl: getTxUrl,\n    getWallet,\n    getWalletWithBalance,\n    isAssetValueApproved,\n    swap,\n    validateAddress,\n  };\n}\n",
+  "import {\n  type AddChainWalletParams,\n  ApproveMode,\n  type ApproveReturnType,\n  AssetValue,\n  type Chain,\n  type ConnectConfig,\n  type EVMChain,\n  EVMChains,\n  SwapKitError,\n  type SwapParams,\n  type Wallet,\n} from \"@swapkit/helpers\";\nimport type { BaseEVMWallet } from \"@swapkit/toolbox-evm\";\n\nimport {\n  getExplorerAddressUrl as getAddressUrl,\n  getExplorerTxUrl as getTxUrl,\n} from \"./helpers/explorerUrls.ts\";\nimport type { Apis, SwapKitPluginInterface, SwapKitWallet } from \"./types.ts\";\n\nexport function SwapKit<\n  Plugins extends { [key in string]: SwapKitPluginInterface<{ [key in string]: Todo }> },\n  Wallets extends { [key in string]: SwapKitWallet<NotWorth[]> },\n>({\n  apis = {},\n  config = {},\n  plugins,\n  rpcUrls = {},\n  stagenet = false,\n  wallets,\n}: {\n  apis?: Apis;\n  config?: ConnectConfig;\n  plugins: Plugins;\n  rpcUrls?: { [key in Chain]?: string };\n  stagenet?: boolean;\n  wallets: Wallets;\n}) {\n  type PluginName = keyof Plugins;\n\n  /**\n   * @REMOVE (V1)\n   * Compatibility layer for plugins and wallets for easier migration and backwards compatibility\n   */\n  const compatPlugins: Plugins = Array.isArray(plugins)\n    ? plugins.reduce((acc, pluginInterface) => {\n        // @ts-ignore Ignore until we remove the compatibility layer\n        const { name, plugin } = Object.values(pluginInterface)?.[0] || {};\n        acc[name] = plugin;\n        return acc;\n      }, {})\n    : plugins;\n  const compatWallets: Wallets = Array.isArray(wallets)\n    ? wallets.reduce((acc, wallet) => {\n        // @ts-ignore Ignore until we remove the compatibility layer\n        const [walletName, connectWallet] = Object.entries(wallet)?.[0] || {};\n        acc[walletName] = connectWallet;\n        return acc;\n      }, {})\n    : wallets;\n\n  const connectedWallets = {} as Wallet;\n  const availablePlugins = Object.entries(compatPlugins).reduce(\n    (acc, [pluginName, { plugin, config }]) => {\n      const methods = plugin({ wallets: connectedWallets, stagenet, config });\n\n      // @ts-expect-error\n      acc[pluginName] = methods;\n      return acc;\n    },\n    {} as { [key in PluginName]: ReturnType<Plugins[key][\"plugin\"]> },\n  );\n\n  const connectWalletMethods = Object.entries(compatWallets).reduce(\n    (acc, [walletName, wallet]) => {\n      const connectWallet = wallet({ addChain, config, apis, rpcUrls });\n\n      // @ts-expect-error\n      acc[walletName] = connectWallet;\n      return acc;\n    },\n    {} as { [key in keyof Wallets]: ReturnType<Wallets[key]> },\n  );\n\n  /**\n   * @Private\n   */\n  function getSwapKitPlugin<T extends PluginName>(pluginName: T) {\n    const plugin = availablePlugins[pluginName] || Object.values(availablePlugins)[0];\n\n    if (!plugin) {\n      throw new SwapKitError(\"core_plugin_not_found\", \"Could not find the requested plugin\");\n    }\n\n    return plugin;\n  }\n\n  function addChain<T extends Chain>(connectWallet: AddChainWalletParams<T>) {\n    // @ts-expect-error: TODO\n    connectedWallets[connectWallet.chain] = connectWallet;\n  }\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: <explanation>\n  function approve<T extends ApproveMode>({\n    assetValue,\n    type = \"checkOnly\" as T,\n    contractAddress: spenderAddress,\n  }: {\n    type: T;\n    assetValue: AssetValue;\n    contractAddress: string | PluginName;\n  }) {\n    const plugin = availablePlugins[spenderAddress];\n\n    if (plugin) {\n      if (type === ApproveMode.CheckOnly && \"isAssetValueApproved\" in plugin) {\n        return plugin.isAssetValueApproved({ assetValue }) as ApproveReturnType<T>;\n      }\n      if (type === ApproveMode.Approve && \"approveAssetValue\" in plugin) {\n        return plugin.approveAssetValue({ assetValue }) as ApproveReturnType<T>;\n      }\n\n      throw new SwapKitError(\n        \"core_approve_asset_target_invalid\",\n        `Target ${String(spenderAddress)} cannot be used for approve operation`,\n      );\n    }\n\n    const { address, chain, isGasAsset, isSynthetic } = assetValue;\n    const isEVMChain = EVMChains.includes(chain as EVMChain);\n    const isNativeEVM = isEVMChain && isGasAsset;\n\n    if (isNativeEVM || !isEVMChain || isSynthetic) {\n      return Promise.resolve(type === \"checkOnly\" ? true : \"approved\") as ApproveReturnType<T>;\n    }\n\n    const walletMethods = connectedWallets[chain] as BaseEVMWallet;\n    const walletAction = type === \"checkOnly\" ? walletMethods?.isApproved : walletMethods?.approve;\n    if (!walletAction) throw new SwapKitError(\"core_wallet_connection_not_found\");\n\n    const from = getAddress(chain);\n    if (!(address && from && typeof spenderAddress === \"string\")) {\n      throw new SwapKitError(\"core_approve_asset_address_or_from_not_found\");\n    }\n\n    return walletAction({\n      amount: assetValue.getBaseValue(\"bigint\"),\n      assetAddress: address,\n      from,\n      spenderAddress,\n    }) as ApproveReturnType<T>;\n  }\n\n  /**\n   * @Public\n   */\n  function getWallet<T extends Chain>(chain: T) {\n    return connectedWallets[chain];\n  }\n  function getAddress<T extends Chain>(chain: T) {\n    return getWallet(chain)?.address || \"\";\n  }\n  /**\n   * TODO: Figure out validation without connecting to wallet\n   */\n  function validateAddress({ address, chain }: { address: string; chain: Chain }) {\n    return getWallet(chain)?.validateAddress?.(address);\n  }\n\n  function getBalance<T extends Chain>(chain: T, refresh?: boolean) {\n    if (refresh) {\n      return getWalletWithBalance(chain).then((wallet) => wallet.balance);\n    }\n\n    return getWallet(chain)?.balance || [];\n  }\n\n  async function getWalletWithBalance<T extends Chain>(chain: T, potentialScamFilter = true) {\n    const defaultBalance = [AssetValue.fromChainOrSignature(chain)];\n    const wallet = getWallet(chain);\n\n    if (!wallet) {\n      throw new SwapKitError(\"core_wallet_connection_not_found\");\n    }\n\n    if (\"getBalance\" in wallet) {\n      const balance = await wallet.getBalance(wallet.address, potentialScamFilter);\n      wallet.balance = balance?.length ? balance : defaultBalance;\n    }\n\n    return wallet;\n  }\n\n  function approveAssetValue(assetValue: AssetValue, contractAddress: string | PluginName) {\n    return approve({ assetValue, contractAddress, type: ApproveMode.Approve });\n  }\n\n  function isAssetValueApproved(assetValue: AssetValue, contractAddress: string | PluginName) {\n    return approve({ assetValue, contractAddress, type: ApproveMode.CheckOnly });\n  }\n\n  function swap<T extends PluginName>({ route, pluginName, ...rest }: SwapParams<T>) {\n    if (pluginName || route.providers[0]?.toLowerCase())\n      throw new SwapKitError(\"core_swap_route_not_complete\");\n\n    const plugin = getSwapKitPlugin(\n      (pluginName || route.providers[0]?.toLowerCase()) as PluginName,\n    );\n\n    if (\"swap\" in plugin) {\n      return plugin.swap({ ...rest, route });\n    }\n\n    throw new SwapKitError(\"core_plugin_swap_not_found\");\n  }\n\n  return {\n    ...availablePlugins,\n    ...connectWalletMethods,\n\n    approveAssetValue,\n    getAddress,\n    getBalance,\n    getExplorerAddressUrl: getAddressUrl,\n    getExplorerTxUrl: getTxUrl,\n    getWallet,\n    getWalletWithBalance,\n    isAssetValueApproved,\n    swap,\n    validateAddress,\n  };\n}\n",
   "import { Chain, ChainToExplorerUrl } from \"@swapkit/helpers\";\n\nexport function getExplorerTxUrl({ chain, txHash }: { txHash: string; chain: Chain }) {\n  const baseUrl = ChainToExplorerUrl[chain];\n\n  switch (chain) {\n    case Chain.Binance:\n    case Chain.Maya:\n    case Chain.Kujira:\n    case Chain.Cosmos:\n    case Chain.THORChain:\n      return `${baseUrl}/tx/${txHash.startsWith(\"0x\") ? txHash.slice(2) : txHash}`;\n\n    case Chain.Arbitrum:\n    case Chain.Avalanche:\n    case Chain.BinanceSmartChain:\n    case Chain.Ethereum:\n    case Chain.Optimism:\n    case Chain.Polkadot:\n    case Chain.Polygon:\n      return `${baseUrl}/tx/${txHash.startsWith(\"0x\") ? txHash : `0x${txHash}`}`;\n\n    case Chain.Litecoin:\n    case Chain.Bitcoin:\n    case Chain.BitcoinCash:\n    case Chain.Dogecoin:\n      return `${baseUrl}/transaction/${txHash.toLowerCase()}`;\n\n    default:\n      throw new Error(`Unsupported chain: ${chain}`);\n  }\n}\n\nexport function getExplorerAddressUrl({ chain, address }: { address: string; chain: Chain }) {\n  const baseUrl = ChainToExplorerUrl[chain];\n\n  return `${baseUrl}/address/${address}`;\n}\n",
-  "import {\n  type AddChainWalletParams,\n  ApproveMode,\n  type ApproveReturnType,\n  AssetValue,\n  type Chain,\n  type ConnectConfig,\n  type EVMChain,\n  EVMChains,\n  SwapKitError,\n  type SwapParams,\n  type Wallet,\n} from \"@swapkit/helpers\";\nimport type { BaseEVMWallet } from \"@swapkit/toolbox-evm\";\n\nimport {\n  getExplorerAddressUrl as getAddressUrl,\n  getExplorerTxUrl as getTxUrl,\n} from \"./helpers/explorerUrls.ts\";\nimport type { Apis, SwapKitPluginInterface, SwapKitWallet } from \"./types.ts\";\n\nexport function SwapKit<\n  Plugins extends { [key in string]: SwapKitPluginInterface<{ [key in string]: Todo }> },\n  Wallets extends { [key in string]: SwapKitWallet<NotWorth[]> },\n>({\n  apis = {},\n  config = {},\n  plugins,\n  rpcUrls = {},\n  stagenet = false,\n  wallets,\n}: {\n  apis?: Apis;\n  config?: ConnectConfig;\n  plugins: Plugins;\n  rpcUrls?: { [key in Chain]?: string };\n  stagenet?: boolean;\n  wallets: Wallets;\n}) {\n  type PluginName = keyof Plugins;\n\n  /**\n   * @REMOVE (V1)\n   * Compatibility layer for plugins and wallets for easier migration and backwards compatibility\n   */\n  const compatPlugins: Plugins = Array.isArray(plugins)\n    ? plugins.reduce((acc, pluginInterface) => {\n        // @ts-ignore Ignore until we remove the compatibility layer\n        const { name, plugin } = Object.values(pluginInterface)?.[0] || {};\n        acc[name] = plugin;\n        return acc;\n      }, {})\n    : plugins;\n  const compatWallets: Wallets = Array.isArray(wallets)\n    ? wallets.reduce((acc, wallet) => {\n        // @ts-ignore Ignore until we remove the compatibility layer\n        const [walletName, connectWallet] = Object.entries(wallet)?.[0] || {};\n        acc[walletName] = connectWallet;\n        return acc;\n      }, {})\n    : wallets;\n\n  const connectedWallets = {} as Wallet;\n  const availablePlugins = Object.entries(compatPlugins).reduce(\n    (acc, [pluginName, { plugin, config }]) => {\n      const methods = plugin({ wallets: connectedWallets, stagenet, config });\n\n      // @ts-expect-error\n      acc[pluginName] = methods;\n      return acc;\n    },\n    {} as { [key in PluginName]: ReturnType<Plugins[key][\"plugin\"]> },\n  );\n\n  const connectWalletMethods = Object.entries(compatWallets).reduce(\n    (acc, [walletName, wallet]) => {\n      const connectWallet = wallet({ addChain, config, apis, rpcUrls });\n\n      // @ts-expect-error\n      acc[walletName] = connectWallet;\n      return acc;\n    },\n    {} as { [key in keyof Wallets]: ReturnType<Wallets[key]> },\n  );\n\n  /**\n   * @Private\n   */\n  function getSwapKitPlugin<T extends PluginName>(pluginName: T) {\n    const plugin = availablePlugins[pluginName] || Object.values(availablePlugins)[0];\n\n    if (!plugin) {\n      throw new SwapKitError(\"core_plugin_not_found\", \"Could not find the requested plugin\");\n    }\n\n    return plugin;\n  }\n\n  function addChain<T extends Chain>(connectWallet: AddChainWalletParams<T>) {\n    // @ts-expect-error: TODO\n    connectedWallets[connectWallet.chain] = connectWallet;\n  }\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: <explanation>\n  function approve<T extends ApproveMode>({\n    assetValue,\n    type = \"checkOnly\" as T,\n    contractAddress: spenderAddress,\n  }: {\n    type: T;\n    assetValue: AssetValue;\n    contractAddress: string | PluginName;\n  }) {\n    const plugin = availablePlugins[spenderAddress];\n\n    if (plugin) {\n      if (type === ApproveMode.CheckOnly && \"isAssetValueApproved\" in plugin) {\n        return plugin.isAssetValueApproved({ assetValue }) as ApproveReturnType<T>;\n      }\n      if (type === ApproveMode.Approve && \"approveAssetValue\" in plugin) {\n        return plugin.approveAssetValue({ assetValue }) as ApproveReturnType<T>;\n      }\n\n      throw new SwapKitError(\n        \"core_approve_asset_target_invalid\",\n        `Target ${String(spenderAddress)} cannot be used for approve operation`,\n      );\n    }\n\n    const { address, chain, isGasAsset, isSynthetic } = assetValue;\n    const isEVMChain = EVMChains.includes(chain as EVMChain);\n    const isNativeEVM = isEVMChain && isGasAsset;\n\n    if (isNativeEVM || !isEVMChain || isSynthetic) {\n      return Promise.resolve(type === \"checkOnly\" ? true : \"approved\") as ApproveReturnType<T>;\n    }\n\n    const walletMethods = connectedWallets[chain] as BaseEVMWallet;\n    const walletAction = type === \"checkOnly\" ? walletMethods?.isApproved : walletMethods?.approve;\n    if (!walletAction) throw new SwapKitError(\"core_wallet_connection_not_found\");\n\n    const from = getAddress(chain);\n    if (!(address && from && typeof spenderAddress === \"string\")) {\n      throw new SwapKitError(\"core_approve_asset_address_or_from_not_found\");\n    }\n\n    return walletAction({\n      amount: assetValue.getBaseValue(\"bigint\"),\n      assetAddress: address,\n      from,\n      spenderAddress,\n    }) as ApproveReturnType<T>;\n  }\n\n  /**\n   * @Public\n   */\n  function getWallet<T extends Chain>(chain: T) {\n    return connectedWallets[chain];\n  }\n  function getAddress<T extends Chain>(chain: T) {\n    return getWallet(chain)?.address || \"\";\n  }\n  /**\n   * TODO: Figure out validation without connecting to wallet\n   */\n  function validateAddress({ address, chain }: { address: string; chain: Chain }) {\n    return getWallet(chain)?.validateAddress?.(address);\n  }\n\n  function getBalance<T extends Chain>(chain: T, refresh?: boolean) {\n    if (refresh) {\n      return getWalletWithBalance(chain).then((wallet) => wallet.balance);\n    }\n\n    return getWallet(chain)?.balance || [];\n  }\n\n  async function getWalletWithBalance<T extends Chain>(chain: T, potentialScamFilter = true) {\n    const defaultBalance = [AssetValue.fromChainOrSignature(chain)];\n    const wallet = getWallet(chain);\n\n    if (!wallet) {\n      throw new SwapKitError(\"core_wallet_connection_not_found\");\n    }\n\n    if (\"getBalance\" in wallet) {\n      const balance = await wallet.getBalance(wallet.address, potentialScamFilter);\n      wallet.balance = balance?.length ? balance : defaultBalance;\n    }\n\n    return wallet;\n  }\n\n  function approveAssetValue(assetValue: AssetValue, contractAddress: string | PluginName) {\n    return approve({ assetValue, contractAddress, type: ApproveMode.Approve });\n  }\n\n  function isAssetValueApproved(assetValue: AssetValue, contractAddress: string | PluginName) {\n    return approve({ assetValue, contractAddress, type: ApproveMode.CheckOnly });\n  }\n\n  function swap<T extends PluginName>({ pluginName, ...rest }: SwapParams<T>) {\n    const plugin = getSwapKitPlugin(pluginName);\n\n    if (\"swap\" in plugin) {\n      return plugin.swap(rest);\n    }\n\n    throw new SwapKitError(\"core_plugin_swap_not_found\");\n  }\n\n  return {\n    ...availablePlugins,\n    ...connectWalletMethods,\n\n    approveAssetValue,\n    getAddress,\n    getBalance,\n    getExplorerAddressUrl: getAddressUrl,\n    getExplorerTxUrl: getTxUrl,\n    getWallet,\n    getWalletWithBalance,\n    isAssetValueApproved,\n    swap,\n    validateAddress,\n  };\n}\n"
+  "import {\n  type AddChainWalletParams,\n  ApproveMode,\n  type ApproveReturnType,\n  AssetValue,\n  type Chain,\n  type ConnectConfig,\n  type EVMChain,\n  EVMChains,\n  SwapKitError,\n  type SwapParams,\n  type Wallet,\n} from \"@swapkit/helpers\";\nimport type { BaseEVMWallet } from \"@swapkit/toolbox-evm\";\n\nimport {\n  getExplorerAddressUrl as getAddressUrl,\n  getExplorerTxUrl as getTxUrl,\n} from \"./helpers/explorerUrls.ts\";\nimport type { Apis, SwapKitPluginInterface, SwapKitWallet } from \"./types.ts\";\n\nexport function SwapKit<\n  Plugins extends { [key in string]: SwapKitPluginInterface<{ [key in string]: Todo }> },\n  Wallets extends { [key in string]: SwapKitWallet<NotWorth[]> },\n>({\n  apis = {},\n  config = {},\n  plugins,\n  rpcUrls = {},\n  stagenet = false,\n  wallets,\n}: {\n  apis?: Apis;\n  config?: ConnectConfig;\n  plugins: Plugins;\n  rpcUrls?: { [key in Chain]?: string };\n  stagenet?: boolean;\n  wallets: Wallets;\n}) {\n  type PluginName = keyof Plugins;\n\n  /**\n   * @REMOVE (V1)\n   * Compatibility layer for plugins and wallets for easier migration and backwards compatibility\n   */\n  const compatPlugins: Plugins = Array.isArray(plugins)\n    ? plugins.reduce((acc, pluginInterface) => {\n        // @ts-ignore Ignore until we remove the compatibility layer\n        const { name, plugin } = Object.values(pluginInterface)?.[0] || {};\n        acc[name] = plugin;\n        return acc;\n      }, {})\n    : plugins;\n  const compatWallets: Wallets = Array.isArray(wallets)\n    ? wallets.reduce((acc, wallet) => {\n        // @ts-ignore Ignore until we remove the compatibility layer\n        const [walletName, connectWallet] = Object.entries(wallet)?.[0] || {};\n        acc[walletName] = connectWallet;\n        return acc;\n      }, {})\n    : wallets;\n\n  const connectedWallets = {} as Wallet;\n  const availablePlugins = Object.entries(compatPlugins).reduce(\n    (acc, [pluginName, { plugin, config }]) => {\n      const methods = plugin({ wallets: connectedWallets, stagenet, config });\n\n      // @ts-expect-error\n      acc[pluginName] = methods;\n      return acc;\n    },\n    {} as { [key in PluginName]: ReturnType<Plugins[key][\"plugin\"]> },\n  );\n\n  const connectWalletMethods = Object.entries(compatWallets).reduce(\n    (acc, [walletName, wallet]) => {\n      const connectWallet = wallet({ addChain, config, apis, rpcUrls });\n\n      // @ts-expect-error\n      acc[walletName] = connectWallet;\n      return acc;\n    },\n    {} as { [key in keyof Wallets]: ReturnType<Wallets[key]> },\n  );\n\n  /**\n   * @Private\n   */\n  function getSwapKitPlugin<T extends PluginName>(pluginName: T) {\n    const plugin = availablePlugins[pluginName] || Object.values(availablePlugins)[0];\n\n    if (!plugin) {\n      throw new SwapKitError(\"core_plugin_not_found\", \"Could not find the requested plugin\");\n    }\n\n    return plugin;\n  }\n\n  function addChain<T extends Chain>(connectWallet: AddChainWalletParams<T>) {\n    // @ts-expect-error: TODO\n    connectedWallets[connectWallet.chain] = connectWallet;\n  }\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: <explanation>\n  function approve<T extends ApproveMode>({\n    assetValue,\n    type = \"checkOnly\" as T,\n    contractAddress: spenderAddress,\n  }: {\n    type: T;\n    assetValue: AssetValue;\n    contractAddress: string | PluginName;\n  }) {\n    const plugin = availablePlugins[spenderAddress];\n\n    if (plugin) {\n      if (type === ApproveMode.CheckOnly && \"isAssetValueApproved\" in plugin) {\n        return plugin.isAssetValueApproved({ assetValue }) as ApproveReturnType<T>;\n      }\n      if (type === ApproveMode.Approve && \"approveAssetValue\" in plugin) {\n        return plugin.approveAssetValue({ assetValue }) as ApproveReturnType<T>;\n      }\n\n      throw new SwapKitError(\n        \"core_approve_asset_target_invalid\",\n        `Target ${String(spenderAddress)} cannot be used for approve operation`,\n      );\n    }\n\n    const { address, chain, isGasAsset, isSynthetic } = assetValue;\n    const isEVMChain = EVMChains.includes(chain as EVMChain);\n    const isNativeEVM = isEVMChain && isGasAsset;\n\n    if (isNativeEVM || !isEVMChain || isSynthetic) {\n      return Promise.resolve(type === \"checkOnly\" ? true : \"approved\") as ApproveReturnType<T>;\n    }\n\n    const walletMethods = connectedWallets[chain] as BaseEVMWallet;\n    const walletAction = type === \"checkOnly\" ? walletMethods?.isApproved : walletMethods?.approve;\n    if (!walletAction) throw new SwapKitError(\"core_wallet_connection_not_found\");\n\n    const from = getAddress(chain);\n    if (!(address && from && typeof spenderAddress === \"string\")) {\n      throw new SwapKitError(\"core_approve_asset_address_or_from_not_found\");\n    }\n\n    return walletAction({\n      amount: assetValue.getBaseValue(\"bigint\"),\n      assetAddress: address,\n      from,\n      spenderAddress,\n    }) as ApproveReturnType<T>;\n  }\n\n  /**\n   * @Public\n   */\n  function getWallet<T extends Chain>(chain: T) {\n    return connectedWallets[chain];\n  }\n  function getAddress<T extends Chain>(chain: T) {\n    return getWallet(chain)?.address || \"\";\n  }\n  /**\n   * TODO: Figure out validation without connecting to wallet\n   */\n  function validateAddress({ address, chain }: { address: string; chain: Chain }) {\n    return getWallet(chain)?.validateAddress?.(address);\n  }\n\n  function getBalance<T extends Chain>(chain: T, refresh?: boolean) {\n    if (refresh) {\n      return getWalletWithBalance(chain).then((wallet) => wallet.balance);\n    }\n\n    return getWallet(chain)?.balance || [];\n  }\n\n  async function getWalletWithBalance<T extends Chain>(chain: T, potentialScamFilter = true) {\n    const defaultBalance = [AssetValue.fromChainOrSignature(chain)];\n    const wallet = getWallet(chain);\n\n    if (!wallet) {\n      throw new SwapKitError(\"core_wallet_connection_not_found\");\n    }\n\n    if (\"getBalance\" in wallet) {\n      const balance = await wallet.getBalance(wallet.address, potentialScamFilter);\n      wallet.balance = balance?.length ? balance : defaultBalance;\n    }\n\n    return wallet;\n  }\n\n  function approveAssetValue(assetValue: AssetValue, contractAddress: string | PluginName) {\n    return approve({ assetValue, contractAddress, type: ApproveMode.Approve });\n  }\n\n  function isAssetValueApproved(assetValue: AssetValue, contractAddress: string | PluginName) {\n    return approve({ assetValue, contractAddress, type: ApproveMode.CheckOnly });\n  }\n\n  function swap<T extends PluginName>({ route, pluginName, ...rest }: SwapParams<T>) {\n    if (pluginName || route.providers[0]?.toLowerCase())\n      throw new SwapKitError(\"core_swap_route_not_complete\");\n\n    const plugin = getSwapKitPlugin(\n      (pluginName || route.providers[0]?.toLowerCase()) as PluginName,\n    );\n\n    if (\"swap\" in plugin) {\n      return plugin.swap({ ...rest, route });\n    }\n\n    throw new SwapKitError(\"core_plugin_swap_not_found\");\n  }\n\n  return {\n    ...availablePlugins,\n    ...connectWalletMethods,\n\n    approveAssetValue,\n    getAddress,\n    getBalance,\n    getExplorerAddressUrl: getAddressUrl,\n    getExplorerTxUrl: getTxUrl,\n    getWallet,\n    getWalletWithBalance,\n    isAssetValueApproved,\n    swap,\n    validateAddress,\n  };\n}\n"
   ],
   "mappings": ";AAAA;AACA;;;ACDA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA;AAEO,SAAS,gBAAgB,GAAG,OAAO,UAA4C;AACpF,QAAM,UAAU,mBAAmB;AAEnC,UAAQ;AAAA,SACD,MAAM;AAAA,SACN,MAAM;AAAA,SACN,MAAM;AAAA,SACN,MAAM;AAAA,SACN,MAAM;AACT,aAAO,GAAG,cAAc,OAAO,WAAW,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI;AAAA,SAEjE,MAAM;AAAA,SACN,MAAM;AAAA,SACN,MAAM;AAAA,SACN,MAAM;AAAA,SACN,MAAM;AAAA,SACN,MAAM;AAAA,SACN,MAAM;AACT,aAAO,GAAG,cAAc,OAAO,WAAW,IAAI,IAAI,SAAS,KAAK;AAAA,SAE7D,MAAM;AAAA,SACN,MAAM;AAAA,SACN,MAAM;AAAA,SACN,MAAM;AACT,aAAO,GAAG,uBAAuB,OAAO,YAAY;AAAA;AAGpD,YAAM,IAAI,MAAM,sBAAsB,OAAO;AAAA;AAAA;AAI5C,SAAS,qBAAqB,GAAG,OAAO,WAA8C;AAC3F,QAAM,UAAU,mBAAmB;AAEnC,SAAO,GAAG,mBAAmB;AAAA;",
-  "debugId": "516820E14373AD4864756e2164756e21",
+  "debugId": "EAD076E6FCCAA6E764756e2164756e21",
   "names": []
 }

package/package.json

@@ -1,26 +1,26 @@
 {
   "author": "swapkit-oss",
   "dependencies": {
-    "@swapkit/api": "1.0.0-rc.67",
-    "@swapkit/helpers": "1.0.0-rc.101"
+    "@swapkit/api": "1.0.0-rc.68",
+    "@swapkit/helpers": "1.0.0-rc.102"
   },
   "description": "SwapKit - Core",
   "devDependencies": {
     "@swapkit/tokens": "1.0.0-rc.52",
-    "@swapkit/toolbox-cosmos": "1.0.0-rc.125",
-    "@swapkit/toolbox-evm": "1.0.0-rc.107",
-    "@swapkit/toolbox-substrate": "1.0.0-rc.36",
-    "@swapkit/toolbox-utxo": "1.0.0-rc.110",
+    "@swapkit/toolbox-cosmos": "1.0.0-rc.126",
+    "@swapkit/toolbox-evm": "1.0.0-rc.108",
+    "@swapkit/toolbox-substrate": "1.0.0-rc.37",
+    "@swapkit/toolbox-utxo": "1.0.0-rc.111",
     "bun-types": "1.1.8"
   },
   "peerDependencies": {
-    "@swapkit/api": "1.0.0-rc.67",
-    "@swapkit/helpers": "1.0.0-rc.101",
+    "@swapkit/api": "1.0.0-rc.68",
+    "@swapkit/helpers": "1.0.0-rc.102",
     "@swapkit/tokens": "1.0.0-rc.52",
-    "@swapkit/toolbox-cosmos": "1.0.0-rc.125",
-    "@swapkit/toolbox-evm": "1.0.0-rc.107",
-    "@swapkit/toolbox-substrate": "1.0.0-rc.36",
-    "@swapkit/toolbox-utxo": "1.0.0-rc.110"
+    "@swapkit/toolbox-cosmos": "1.0.0-rc.126",
+    "@swapkit/toolbox-evm": "1.0.0-rc.108",
+    "@swapkit/toolbox-substrate": "1.0.0-rc.37",
+    "@swapkit/toolbox-utxo": "1.0.0-rc.111"
   },
   "files": [
     "src/",
@@ -45,5 +45,5 @@
   },
   "type": "module",
   "types": "./src/index.ts",
-  "version": "1.0.0-rc.149"
+  "version": "1.0.0-rc.150"
 }

package/src/client.ts

@@ -200,11 +200,16 @@ export function SwapKit<
     return approve({ assetValue, contractAddress, type: ApproveMode.CheckOnly });
   }
 
-  function swap<T extends PluginName>({ pluginName, ...rest }: SwapParams<T>) {
-    const plugin = getSwapKitPlugin(pluginName);
+  function swap<T extends PluginName>({ route, pluginName, ...rest }: SwapParams<T>) {
+    if (pluginName || route.providers[0]?.toLowerCase())
+      throw new SwapKitError("core_swap_route_not_complete");
+
+    const plugin = getSwapKitPlugin(
+      (pluginName || route.providers[0]?.toLowerCase()) as PluginName,
+    );
 
     if ("swap" in plugin) {
-      return plugin.swap(rest);
+      return plugin.swap({ ...rest, route });
     }
 
     throw new SwapKitError("core_plugin_swap_not_found");