@swapkit/core 1.0.0-rc.99 → 1.0.1

package/dist/index.js

@@ -0,0 +1,3 @@
+export*from"@swapkit/api";export*from"@swapkit/helpers";import{stripToCashAddress as zo} from"@swapkit/toolbox-utxo";import{lowercasedContractAbiMapping as H} from"@swapkit/contracts";import{ApproveMode as Y,AssetValue as Z,Chain as $,EVMChains as d,ProviderName as i,SwapKitError as P,isGasAsset as t} from"@swapkit/helpers";import{estimateTransactionFee as n,cosmosValidateAddress as s} from"@swapkit/toolbox-cosmos";import{evmValidateAddress as l} from"@swapkit/toolbox-evm";import{substrateValidateAddress as e} from"@swapkit/toolbox-substrate";import{utxoValidateAddress as a} from"@swapkit/toolbox-utxo";import{Chain as U,ChainToExplorerUrl as b,SwapKitError as c} from"@swapkit/helpers";function m({chain:q,txHash:_}){const y=b[q];switch(q){case U.Maya:case U.Kujira:case U.Cosmos:case U.THORChain:case U.Solana:return`${y}/tx/${_.startsWith("0x")?_.slice(2):_}`;case U.Arbitrum:case U.Avalanche:case U.BinanceSmartChain:case U.Ethereum:case U.Optimism:case U.Polkadot:case U.Polygon:return`${y}/tx/${_.startsWith("0x")?_:`0x${_}`}`;case U.Litecoin:case U.Bitcoin:case U.BitcoinCash:case U.Dogecoin:return`${y}/transaction/${_.toLowerCase()}`;default:throw new c({errorKey:"core_explorer_unsupported_chain",info:{chain:q}})}}function E({chain:q,address:_}){const y=b[q];switch(q){case U.Solana:return`${y}/account/${_}`;default:return`${y}/address/${_}`}}function Lo({apis:q={},config:_={},plugins:y,rpcUrls:C={},stagenet:D=!1,wallets:F}){const J={},Q=Object.entries(y).reduce((o,[x,{plugin:k,config:T}])=>{const B=k({wallets:J,stagenet:D,config:T??_});return o[x]=B,o},{}),M=Object.entries(F).reduce((o,[x,k])=>{const T=k({addChain:W,config:_,apis:q,rpcUrls:C});return o[x]=T,o},{});function S(o){const x=Q[o]||Object.values(Q)[0];if(!x)throw new P("core_plugin_not_found");return x}function O(o){const x=Object.values(Q).find((k)=>k.supportedSwapkitProviders?.includes(o));if(!x)throw new P("core_plugin_not_found");return x}function W(o){J[o.chain]=o}function j({assetValue:o,type:x="checkOnly",contractAddress:k}){const T=Q[k];if(T){if(x===Y.CheckOnly&&"isAssetValueApproved"in T)return T.isAssetValueApproved({assetValue:o});if(x===Y.Approve&&"approveAssetValue"in T)return T.approveAssetValue({assetValue:o});throw new P({errorKey:"core_approve_asset_target_invalid",info:{message:`Target ${String(k)} cannot be used for approve operation`}})}const B=o.chain,z=d.includes(B);if(z&&o.isGasAsset||!z||o.isSynthetic)return Promise.resolve(x==="checkOnly"?!0:"approved");const L=I(B),R=x==="checkOnly"?L.isApproved:L.approve;if(!R)throw new P("core_wallet_connection_not_found");if(!(o.address&&L.address&&typeof k==="string"))throw new P("core_approve_asset_address_or_from_not_found");return R({amount:o.getBaseValue("bigint"),assetAddress:o.address,from:L.address,spenderAddress:k})}function I(o){return J[o]}function v(){return{...J}}function N(o){return I(o)?.address||""}function K(o,x){return j({assetValue:o,contractAddress:x,type:Y.Approve})}function A(o,x){return j({assetValue:o,contractAddress:x,type:Y.CheckOnly})}function G(o){I(o)?.disconnect?.(),delete J[o]}function w(){for(let o of Object.keys(J))G(o)}function V(o,x){return x?f(o).then((k)=>k.balance):I(o)?.balance||[]}function r({address:o,chain:x}){switch(x){case $.Arbitrum:case $.Avalanche:case $.Optimism:case $.BinanceSmartChain:case $.Polygon:case $.Ethereum:return l({address:o});case $.Litecoin:case $.Dash:case $.Dogecoin:case $.BitcoinCash:case $.Bitcoin:return a({address:o,chain:x});case $.Cosmos:case $.Kujira:case $.Maya:case $.THORChain:return s({address:o,chain:x});case $.Polkadot:return e({address:o,chain:x});default:return!1}}async function f(o,x=!0){const k=[Z.from({chain:o})],T=I(o);if(!T)throw new P("core_wallet_connection_not_found");if("getBalance"in T){const B=await T.getBalance(T.address,x);T.balance=B?.length?B:k}return T}function h({route:o,pluginName:x,...k}){const T=x&&S(x)||O(o.providers[0]);if(!T)throw new P("core_swap_route_not_complete");if("swap"in T)return T.swap({...k,route:o});throw new P("core_plugin_swap_not_found")}function g({from:o,recipient:x,assetValue:k,feeOptionKey:T}){const B=k.chain,z=I(B);if(!z)throw new P("core_wallet_connection_not_found");return z.transfer({from:o,recipient:x,assetValue:k,feeOptionKey:T})}async function p({type:o,feeOptionKey:x,params:k}){const{assetValue:T}=k,{chain:B}=T;if(!I(B))throw new P("core_wallet_connection_not_found");const z=Z.from({chain:B});switch(B){case $.Arbitrum:case $.Avalanche:case $.Ethereum:case $.BinanceSmartChain:case $.Polygon:{const X=I(B);if(o==="transfer"){const L=await X.createTransferTx(k);return X.estimateTransactionFee(L,x)}if(o==="approve"&&!t(T))return X.estimateTransactionFee(await X.createApprovalTx({assetAddress:T.address,spenderAddress:k.contractAddress,amount:T.getBaseValue("bigint"),from:X.address}),x);if(o==="swap"){if(k.route.providers[0]===i.CHAINFLIP){const u=await X.createTransferTx({from:X.address,recipient:X.address,assetValue:T});return X.estimateTransactionFee(u,x)}const{evmTransactionDetails:R}=k.route;if(!(R&&H[R.contractAddress]))return;return X.estimateTransactionFee(await X.createContractTxObject({contractAddress:R.contractAddress,abi:H[R.contractAddress],funcName:R.contractMethod,funcParams:R.contractParams}),x)}return Z.from({chain:B})}case $.Bitcoin:case $.BitcoinCash:case $.Dogecoin:case $.Dash:case $.Litecoin:{const{estimateMaxSendableAmount:X,address:L}=I(B);return X({...k,feeOptionKey:x,from:L,recipient:L})}case $.THORChain:case $.Maya:case $.Kujira:case $.Cosmos:return n(k);case $.Polkadot:{const{address:X,estimateTransactionFee:L}=I(B);return L({...k,recipient:X})}default:return z}}return{...Q,...M,approveAssetValue:K,getAddress:N,getBalance:V,getExplorerAddressUrl:E,getExplorerTxUrl:m,getWallet:I,getAllWallets:v,getWalletWithBalance:f,isAssetValueApproved:A,estimateTransactionFee:p,swap:h,transfer:g,validateAddress:r,disconnectAll:w,disconnectChain:G}}export{zo as stripToCashAddress,Lo as SwapKit};
+
+//# debugId=C19E100412E60E5664756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/client.ts", "../src/helpers/explorerUrls.ts"],
+  "sourcesContent": [
+    "export * from \"@swapkit/api\";\nexport * from \"@swapkit/helpers\";\nexport { stripToCashAddress } from \"@swapkit/toolbox-utxo\";\n\nexport * from \"./client.ts\";\nexport * from \"./types.ts\";\n",
+    "import { lowercasedContractAbiMapping } from \"@swapkit/contracts\";\nimport {\n  type AddChainWalletParams,\n  ApproveMode,\n  type ApproveReturnType,\n  AssetValue,\n  Chain,\n  type ConnectConfig,\n  type EVMChain,\n  EVMChains,\n  type FeeOption,\n  ProviderName as PluginNameEnum,\n  SwapKitError,\n  type SwapParams,\n  type WalletChain,\n  isGasAsset,\n} from \"@swapkit/helpers\";\nimport {\n  type TransferParams as CosmosTransferParams,\n  estimateTransactionFee as cosmosTransactionFee,\n  cosmosValidateAddress,\n} from \"@swapkit/toolbox-cosmos\";\nimport { type TransferParams as EVMTransferParams, evmValidateAddress } from \"@swapkit/toolbox-evm\";\nimport { substrateValidateAddress } from \"@swapkit/toolbox-substrate\";\nimport { type UTXOTransferParams, utxoValidateAddress } from \"@swapkit/toolbox-utxo\";\n\nimport {\n  getExplorerAddressUrl as getAddressUrl,\n  getExplorerTxUrl as getTxUrl,\n} from \"./helpers/explorerUrls.ts\";\nimport type { Apis, SwapKitPluginInterface, SwapKitWallet, Wallet } 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  const connectedWallets = {} as Wallet;\n  const availablePlugins = Object.entries(plugins).reduce(\n    (acc, [pluginName, { plugin, config: pluginConfig }]) => {\n      const methods = plugin({\n        wallets: connectedWallets,\n        stagenet,\n        config: pluginConfig ?? config,\n      });\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(wallets).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  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\");\n    }\n\n    return plugin;\n  }\n\n  function getSwapKitPluginForSKProvider(pluginName: PluginNameEnum): Plugins[keyof Plugins] {\n    const plugin = Object.values(availablePlugins).find((plugin) =>\n      plugin.supportedSwapkitProviders?.includes(pluginName),\n    );\n\n    if (!plugin) {\n      throw new SwapKitError(\"core_plugin_not_found\");\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        errorKey: \"core_approve_asset_target_invalid\",\n        info: { message: `Target ${String(spenderAddress)} cannot be used for approve operation` },\n      });\n    }\n\n    const chain = assetValue.chain as EVMChain;\n    const isEVMChain = EVMChains.includes(chain);\n    const isNativeEVM = isEVMChain && assetValue.isGasAsset;\n\n    if (isNativeEVM || !isEVMChain || assetValue.isSynthetic) {\n      return Promise.resolve(type === \"checkOnly\" ? true : \"approved\") as ApproveReturnType<T>;\n    }\n\n    const wallet = getWallet(chain);\n    const walletAction = type === \"checkOnly\" ? wallet.isApproved : wallet.approve;\n    if (!walletAction) throw new SwapKitError(\"core_wallet_connection_not_found\");\n\n    if (!(assetValue.address && wallet.address && 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: assetValue.address,\n      from: wallet.address,\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\n  function getAllWallets() {\n    return { ...connectedWallets };\n  }\n\n  function getAddress<T extends Chain>(chain: T) {\n    return getWallet(chain)?.address || \"\";\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 disconnectChain<T extends Chain>(chain: T) {\n    const wallet = getWallet(chain);\n    wallet?.disconnect?.();\n    delete connectedWallets[chain];\n  }\n\n  function disconnectAll() {\n    for (const chain of Object.keys(connectedWallets) as (keyof typeof connectedWallets)[]) {\n      disconnectChain(chain);\n    }\n  }\n\n  function getBalance<T extends Chain>(chain: T, refresh?: boolean) {\n    return refresh\n      ? getWalletWithBalance(chain).then((wallet) => wallet.balance)\n      : getWallet(chain)?.balance || [];\n  }\n\n  function validateAddress({ address, chain }: { address: string; chain: Chain }) {\n    switch (chain) {\n      case Chain.Arbitrum:\n      case Chain.Avalanche:\n      case Chain.Optimism:\n      case Chain.BinanceSmartChain:\n      case Chain.Polygon:\n      case Chain.Ethereum:\n        return evmValidateAddress({ address });\n\n      case Chain.Litecoin:\n      case Chain.Dash:\n      case Chain.Dogecoin:\n      case Chain.BitcoinCash:\n      case Chain.Bitcoin:\n        return utxoValidateAddress({ address, chain });\n\n      case Chain.Cosmos:\n      case Chain.Kujira:\n      case Chain.Maya:\n      case Chain.THORChain:\n        return cosmosValidateAddress({ address, chain });\n\n      case Chain.Polkadot:\n        return substrateValidateAddress({ address, chain });\n\n      default:\n        return false;\n    }\n  }\n\n  async function getWalletWithBalance<T extends Chain>(chain: T, potentialScamFilter = true) {\n    const defaultBalance = [AssetValue.from({ 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      // @ts-expect-error TODO add getBalance to radix\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 swap<T extends PluginName>({ route, pluginName, ...rest }: SwapParams<T>) {\n    const plugin =\n      (pluginName && getSwapKitPlugin(pluginName)) ||\n      getSwapKitPluginForSKProvider(route.providers[0] as PluginNameEnum);\n\n    if (!plugin) throw new SwapKitError(\"core_swap_route_not_complete\");\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  function transfer({\n    from,\n    recipient,\n    assetValue,\n    feeOptionKey,\n  }: UTXOTransferParams | EVMTransferParams | CosmosTransferParams) {\n    const chain = assetValue.chain as WalletChain;\n    const wallet = getWallet(chain);\n    if (!wallet) throw new SwapKitError(\"core_wallet_connection_not_found\");\n\n    return wallet.transfer({ from, recipient, assetValue, feeOptionKey });\n  }\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: TODO clean this up\n  async function estimateTransactionFee<T extends PluginName>({\n    type,\n    feeOptionKey,\n    params,\n  }: (\n    | { type: \"swap\"; params: SwapParams<T> & { assetValue: AssetValue } }\n    | {\n        type: \"transfer\";\n        params: UTXOTransferParams | EVMTransferParams | CosmosTransferParams;\n      }\n    | {\n        type: \"approve\";\n        params: {\n          assetValue: AssetValue;\n          contractAddress: string | PluginName;\n          feeOptionKey?: FeeOption;\n        };\n      }\n  ) & {\n    feeOptionKey: FeeOption;\n  }): Promise<AssetValue | undefined> {\n    const { assetValue } = params;\n    const { chain } = assetValue;\n\n    if (!getWallet(chain)) throw new SwapKitError(\"core_wallet_connection_not_found\");\n\n    const baseValue = AssetValue.from({ chain });\n\n    switch (chain) {\n      case Chain.Arbitrum:\n      case Chain.Avalanche:\n      case Chain.Ethereum:\n      case Chain.BinanceSmartChain:\n      case Chain.Polygon: {\n        const wallet = getWallet(chain);\n        if (type === \"transfer\") {\n          const txObject = await wallet.createTransferTx(params);\n          return wallet.estimateTransactionFee(txObject, feeOptionKey);\n        }\n\n        if (type === \"approve\" && !isGasAsset(assetValue)) {\n          return wallet.estimateTransactionFee(\n            await wallet.createApprovalTx({\n              assetAddress: assetValue.address as string,\n              spenderAddress: params.contractAddress as string,\n              amount: assetValue.getBaseValue(\"bigint\"),\n              from: wallet.address,\n            }),\n            feeOptionKey,\n          );\n        }\n\n        if (type === \"swap\") {\n          const plugin = params.route.providers[0] as PluginNameEnum;\n          if (plugin === PluginNameEnum.CHAINFLIP) {\n            const txObject = await wallet.createTransferTx({\n              from: wallet.address,\n              recipient: wallet.address,\n              assetValue,\n            });\n            return wallet.estimateTransactionFee(txObject, feeOptionKey);\n          }\n\n          const { evmTransactionDetails } = params.route;\n          if (\n            !(\n              evmTransactionDetails &&\n              lowercasedContractAbiMapping[evmTransactionDetails.contractAddress]\n            )\n          ) {\n            return undefined;\n          }\n\n          return wallet.estimateTransactionFee(\n            await wallet.createContractTxObject({\n              contractAddress: evmTransactionDetails.contractAddress,\n              // biome-ignore lint/style/noNonNullAssertion: TS cant infer the type\n              abi: lowercasedContractAbiMapping[evmTransactionDetails.contractAddress]!,\n              funcName: evmTransactionDetails.contractMethod,\n              funcParams: evmTransactionDetails.contractParams,\n            }),\n            feeOptionKey,\n          );\n        }\n\n        return AssetValue.from({ chain });\n      }\n\n      case Chain.Bitcoin:\n      case Chain.BitcoinCash:\n      case Chain.Dogecoin:\n      case Chain.Dash:\n      case Chain.Litecoin: {\n        const { estimateMaxSendableAmount, address } = getWallet(chain);\n\n        return estimateMaxSendableAmount({\n          ...params,\n          feeOptionKey,\n          from: address,\n          recipient: address,\n        });\n      }\n\n      case Chain.THORChain:\n      case Chain.Maya:\n      case Chain.Kujira:\n      case Chain.Cosmos: {\n        return cosmosTransactionFee(params);\n      }\n\n      case Chain.Polkadot: {\n        const { address, estimateTransactionFee } = getWallet(chain);\n\n        return estimateTransactionFee({ ...params, recipient: address });\n      }\n\n      default:\n        return baseValue;\n    }\n  }\n\n  return {\n    ...availablePlugins,\n    ...connectWalletMethods,\n\n    approveAssetValue,\n    getAddress,\n    getBalance,\n    getExplorerAddressUrl: getAddressUrl,\n    getExplorerTxUrl: getTxUrl,\n    getWallet,\n    getAllWallets,\n    getWalletWithBalance,\n    isAssetValueApproved,\n    estimateTransactionFee,\n    swap,\n    transfer,\n    validateAddress,\n    disconnectAll,\n    disconnectChain,\n  };\n}\n",
+    "import { Chain, ChainToExplorerUrl, SwapKitError } 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.Maya:\n    case Chain.Kujira:\n    case Chain.Cosmos:\n    case Chain.THORChain:\n    case Chain.Solana:\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 SwapKitError({ errorKey: \"core_explorer_unsupported_chain\", info: { chain } });\n  }\n}\n\nexport function getExplorerAddressUrl({ chain, address }: { address: string; chain: Chain }) {\n  const baseUrl = ChainToExplorerUrl[chain];\n\n  switch (chain) {\n    case Chain.Solana:\n      return `${baseUrl}/account/${address}`;\n\n    default:\n      return `${baseUrl}/address/${address}`;\n  }\n}\n"
+  ],
+  "mappings": "AAAA,0BACA,8BACA,6BAAS,gCCFT,uCAAS,4BACT,sBAEE,gBAEA,WACA,eAGA,kBAEA,kBACA,gBAGA,0BAEF,iCAEE,2BACA,iCAEF,6BAAmD,8BACnD,mCAAS,oCACT,8BAAkC,+BCxBlC,gBAAS,wBAAO,kBAAoB,0BAE7B,SAAS,CAAgB,EAAG,QAAO,UAA4C,CACpF,MAAM,EAAU,EAAmB,GAEnC,OAAQ,QACD,EAAM,UACN,EAAM,YACN,EAAM,YACN,EAAM,eACN,EAAM,OACT,MAAO,GAAG,QAAc,EAAO,WAAW,IAAI,EAAI,EAAO,MAAM,CAAC,EAAI,SAEjE,EAAM,cACN,EAAM,eACN,EAAM,uBACN,EAAM,cACN,EAAM,cACN,EAAM,cACN,EAAM,QACT,MAAO,GAAG,QAAc,EAAO,WAAW,IAAI,EAAI,EAAS,KAAK,WAE7D,EAAM,cACN,EAAM,aACN,EAAM,iBACN,EAAM,SACT,MAAO,GAAG,iBAAuB,EAAO,YAAY,YAGpD,MAAM,IAAI,EAAa,CAAE,SAAU,kCAAmC,KAAM,CAAE,OAAM,CAAE,CAAC,GAItF,SAAS,CAAqB,EAAG,QAAO,WAA8C,CAC3F,MAAM,EAAU,EAAmB,GAEnC,OAAQ,QACD,EAAM,OACT,MAAO,GAAG,aAAmB,YAG7B,MAAO,GAAG,aAAmB,KDT5B,SAAS,EAGf,EACC,OAAO,CAAC,EACR,SAAS,CAAC,EACV,UACA,UAAU,CAAC,EACX,WAAW,GACX,WAQC,CAGD,MAAM,EAAmB,CAAC,EACpB,EAAmB,OAAO,QAAQ,CAAO,EAAE,OAC/C,CAAC,GAAM,GAAc,SAAQ,OAAQ,MAAoB,CACvD,MAAM,EAAU,EAAO,CACrB,QAAS,EACT,WACA,OAAQ,GAAgB,CAC1B,CAAC,EAID,OADA,EAAI,GAAc,EACX,GAET,CAAC,CACH,EAEM,EAAuB,OAAO,QAAQ,CAAO,EAAE,OACnD,CAAC,GAAM,EAAY,KAAY,CAC7B,MAAM,EAAgB,EAAO,CAAE,WAAU,SAAQ,OAAM,SAAQ,CAAC,EAIhE,OADA,EAAI,GAAc,EACX,GAET,CAAC,CACH,EAEA,SAAS,CAAsC,CAAC,EAAe,CAC7D,MAAM,EAAS,EAAiB,IAAe,OAAO,OAAO,CAAgB,EAAE,GAE/E,IAAK,EACH,MAAM,IAAI,EAAa,uBAAuB,EAGhD,OAAO,EAGT,SAAS,CAA6B,CAAC,EAAoD,CACzF,MAAM,EAAS,OAAO,OAAO,CAAgB,EAAE,KAAK,CAAC,IACnD,EAAO,2BAA2B,SAAS,CAAU,CACvD,EAEA,IAAK,EACH,MAAM,IAAI,EAAa,uBAAuB,EAGhD,OAAO,EAGT,SAAS,CAAyB,CAAC,EAAwC,CAEzE,EAAiB,EAAc,OAAS,EAI1C,SAAS,CAA8B,EACrC,aACA,OAAO,YACP,gBAAiB,GAKhB,CACD,MAAM,EAAS,EAAiB,GAEhC,GAAI,EAAQ,CACV,GAAI,IAAS,EAAY,WAAa,yBAA0B,EAC9D,OAAO,EAAO,qBAAqB,CAAE,YAAW,CAAC,EAEnD,GAAI,IAAS,EAAY,SAAW,sBAAuB,EACzD,OAAO,EAAO,kBAAkB,CAAE,YAAW,CAAC,EAGhD,MAAM,IAAI,EAAa,CACrB,SAAU,oCACV,KAAM,CAAE,QAAS,UAAU,OAAO,CAAc,wCAAyC,CAC3F,CAAC,EAGH,MAAM,EAAQ,EAAW,MACnB,EAAa,EAAU,SAAS,CAAK,EAG3C,GAFoB,GAAc,EAAW,aAEzB,GAAc,EAAW,YAC3C,OAAO,QAAQ,QAAQ,IAAS,YAAc,GAAO,UAAU,EAGjE,MAAM,EAAS,EAAU,CAAK,EACxB,EAAe,IAAS,YAAc,EAAO,WAAa,EAAO,QACvE,IAAK,EAAc,MAAM,IAAI,EAAa,kCAAkC,EAE5E,KAAM,EAAW,SAAW,EAAO,gBAAkB,IAAmB,UACtE,MAAM,IAAI,EAAa,8CAA8C,EAGvE,OAAO,EAAa,CAClB,OAAQ,EAAW,aAAa,QAAQ,EACxC,aAAc,EAAW,QACzB,KAAM,EAAO,QACb,gBACF,CAAC,EAMH,SAAS,CAA0B,CAAC,EAAU,CAC5C,OAAO,EAAiB,GAG1B,SAAS,CAAa,EAAG,CACvB,MAAO,IAAK,CAAiB,EAG/B,SAAS,CAA2B,CAAC,EAAU,CAC7C,OAAO,EAAU,CAAK,GAAG,SAAW,GAGtC,SAAS,CAAiB,CAAC,EAAwB,EAAsC,CACvF,OAAO,EAAQ,CAAE,aAAY,kBAAiB,KAAM,EAAY,OAAQ,CAAC,EAG3E,SAAS,CAAoB,CAAC,EAAwB,EAAsC,CAC1F,OAAO,EAAQ,CAAE,aAAY,kBAAiB,KAAM,EAAY,SAAU,CAAC,EAG7E,SAAS,CAAgC,CAAC,EAAU,CAElD,AADe,EAAU,CAAK,GACtB,aAAa,SACd,EAAiB,GAG1B,SAAS,CAAa,EAAG,CACvB,QAAW,KAAS,OAAO,KAAK,CAAgB,EAC9C,EAAgB,CAAK,EAIzB,SAAS,CAA2B,CAAC,EAAU,EAAmB,CAChE,OAAO,EACH,EAAqB,CAAK,EAAE,KAAK,CAAC,IAAW,EAAO,OAAO,EAC3D,EAAU,CAAK,GAAG,SAAW,CAAC,EAGpC,SAAS,CAAe,EAAG,UAAS,SAA4C,CAC9E,OAAQ,QACD,EAAM,cACN,EAAM,eACN,EAAM,cACN,EAAM,uBACN,EAAM,aACN,EAAM,SACT,OAAO,EAAmB,CAAE,SAAQ,CAAC,OAElC,EAAM,cACN,EAAM,UACN,EAAM,cACN,EAAM,iBACN,EAAM,QACT,OAAO,EAAoB,CAAE,UAAS,OAAM,CAAC,OAE1C,EAAM,YACN,EAAM,YACN,EAAM,UACN,EAAM,UACT,OAAO,EAAsB,CAAE,UAAS,OAAM,CAAC,OAE5C,EAAM,SACT,OAAO,EAAyB,CAAE,UAAS,OAAM,CAAC,UAGlD,MAAO,IAIb,eAAe,CAAqC,CAAC,EAAU,EAAsB,GAAM,CACzF,MAAM,EAAiB,CAAC,EAAW,KAAK,CAAE,OAAM,CAAC,CAAC,EAC5C,EAAS,EAAU,CAAK,EAE9B,IAAK,EACH,MAAM,IAAI,EAAa,kCAAkC,EAG3D,GAAI,eAAgB,EAAQ,CAE1B,MAAM,EAAU,MAAM,EAAO,WAAW,EAAO,QAAS,CAAmB,EAC3E,EAAO,QAAU,GAAS,OAAS,EAAU,EAG/C,OAAO,EAGT,SAAS,CAA0B,EAAG,QAAO,gBAAe,GAAuB,CACjF,MAAM,EACH,GAAc,EAAiB,CAAU,GAC1C,EAA8B,EAAM,UAAU,EAAoB,EAEpE,IAAK,EAAQ,MAAM,IAAI,EAAa,8BAA8B,EAElE,GAAI,SAAU,EACZ,OAAO,EAAO,KAAK,IAAK,EAAM,OAAM,CAAC,EAGvC,MAAM,IAAI,EAAa,4BAA4B,EAGrD,SAAS,CAAQ,EACf,OACA,YACA,aACA,gBACgE,CAChE,MAAM,EAAQ,EAAW,MACnB,EAAS,EAAU,CAAK,EAC9B,IAAK,EAAQ,MAAM,IAAI,EAAa,kCAAkC,EAEtE,OAAO,EAAO,SAAS,CAAE,OAAM,YAAW,aAAY,cAAa,CAAC,EAItE,eAAe,CAA4C,EACzD,OACA,eACA,UAiBkC,CAClC,MAAQ,cAAe,GACf,SAAU,EAElB,IAAK,EAAU,CAAK,EAAG,MAAM,IAAI,EAAa,kCAAkC,EAEhF,MAAM,EAAY,EAAW,KAAK,CAAE,OAAM,CAAC,EAE3C,OAAQ,QACD,EAAM,cACN,EAAM,eACN,EAAM,cACN,EAAM,uBACN,EAAM,QAAS,CAClB,MAAM,EAAS,EAAU,CAAK,EAC9B,GAAI,IAAS,WAAY,CACvB,MAAM,EAAW,MAAM,EAAO,iBAAiB,CAAM,EACrD,OAAO,EAAO,uBAAuB,EAAU,CAAY,EAG7D,GAAI,IAAS,YAAc,EAAW,CAAU,EAC9C,OAAO,EAAO,uBACZ,MAAM,EAAO,iBAAiB,CAC5B,aAAc,EAAW,QACzB,eAAgB,EAAO,gBACvB,OAAQ,EAAW,aAAa,QAAQ,EACxC,KAAM,EAAO,OACf,CAAC,EACD,CACF,EAGF,GAAI,IAAS,OAAQ,CAEnB,GADe,EAAO,MAAM,UAAU,KACvB,EAAe,UAAW,CACvC,MAAM,EAAW,MAAM,EAAO,iBAAiB,CAC7C,KAAM,EAAO,QACb,UAAW,EAAO,QAClB,YACF,CAAC,EACD,OAAO,EAAO,uBAAuB,EAAU,CAAY,EAG7D,MAAQ,yBAA0B,EAAO,MACzC,KAEI,GACA,EAA6B,EAAsB,kBAGrD,OAGF,OAAO,EAAO,uBACZ,MAAM,EAAO,uBAAuB,CAClC,gBAAiB,EAAsB,gBAEvC,IAAK,EAA6B,EAAsB,iBACxD,SAAU,EAAsB,eAChC,WAAY,EAAsB,cACpC,CAAC,EACD,CACF,EAGF,OAAO,EAAW,KAAK,CAAE,OAAM,CAAC,CAClC,MAEK,EAAM,aACN,EAAM,iBACN,EAAM,cACN,EAAM,UACN,EAAM,SAAU,CACnB,MAAQ,4BAA2B,WAAY,EAAU,CAAK,EAE9D,OAAO,EAA0B,IAC5B,EACH,eACA,KAAM,EACN,UAAW,CACb,CAAC,CACH,MAEK,EAAM,eACN,EAAM,UACN,EAAM,YACN,EAAM,OACT,OAAO,EAAqB,CAAM,OAG/B,EAAM,SAAU,CACnB,MAAQ,UAAS,0BAA2B,EAAU,CAAK,EAE3D,OAAO,EAAuB,IAAK,EAAQ,UAAW,CAAQ,CAAC,CACjE,SAGE,OAAO,GAIb,MAAO,IACF,KACA,EAEH,oBACA,aACA,aACA,sBAAuB,EACvB,iBAAkB,EAClB,YACA,gBACA,uBACA,uBACA,yBACA,OACA,WACA,kBACA,gBACA,iBACF",
+  "debugId": "C19E100412E60E5664756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,60 +1,39 @@
 {
-  "author": "swapkit-oss-team",
+  "author": "swapkit-oss",
   "dependencies": {
-    "@swapkit/helpers": "1.0.0-rc.71",
-    "@swapkit/types": "1.0.0-rc.37"
-  },
-  "description": "SwapKit Lib core",
-  "devDependencies": {
-    "@vitest/coverage-istanbul": "1.2.1",
-    "vite": "5.0.12",
-    "vitest": "1.2.1",
-    "@internal/config": "0.0.2-rc.0",
-    "@swapkit/tokens": "1.0.0-rc.34",
-    "@swapkit/toolbox-cosmos": "1.0.0-rc.82",
-    "@swapkit/toolbox-evm": "1.0.0-rc.77",
-    "@swapkit/toolbox-substrate": "1.0.0-rc.5",
-    "@swapkit/toolbox-utxo": "1.0.0-rc.76"
-  },
-  "peerDependencies": {
-    "@swapkit/tokens": "1.0.0-rc.34",
-    "@swapkit/toolbox-cosmos": "1.0.0-rc.82",
-    "@swapkit/toolbox-evm": "1.0.0-rc.77",
-    "@swapkit/toolbox-substrate": "1.0.0-rc.5",
-    "@swapkit/toolbox-utxo": "1.0.0-rc.76"
-  },
-  "eslintConfig": {
-    "extends": "../../../internal/eslint-config"
-  },
-  "exports": {
-    ".": {
-      "import": "./dist/index.es.js",
-      "require": "./dist/index.cjs",
-      "types": "./dist/index.d.ts"
-    }
+    "@swapkit/api": "1.0.1",
+    "@swapkit/contracts": "1.0.1",
+    "@swapkit/helpers": "1.0.1",
+    "@swapkit/plugin-evm": "1.0.1",
+    "@swapkit/toolbox-cosmos": "1.0.1",
+    "@swapkit/toolbox-evm": "1.0.1",
+    "@swapkit/toolbox-solana": "1.0.1",
+    "@swapkit/toolbox-substrate": "1.0.1",
+    "@swapkit/toolbox-utxo": "1.0.1"
   },
+  "description": "SwapKit - Core",
   "files": [
     "src/",
     "dist/"
   ],
   "homepage": "https://github.com/thorswap/SwapKit",
   "license": "Apache-2.0",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.es.js",
+  "main": "./dist/index.js",
   "name": "@swapkit/core",
   "react-native": "./src/index.ts",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/thorswap/SwapKit.git"
   },
-  "type": "module",
-  "types": "./dist/index.d.ts",
-  "version": "1.0.0-rc.99",
   "scripts": {
-    "build": "NODE_OPTIONS=--max_old_space_size=16384 vite build",
-    "clean": "rm -rf dist vite.config.ts.* .turbo node_modules",
-    "lint": "eslint ./ --ext .ts,.tsx --fix; tsc --noEmit",
-    "test": "vitest --run",
-    "test:coverage": "vitest run --coverage"
-  }
-}
+    "build": "bun run ./build.ts",
+    "clean": "rm -rf dist node_modules *.tsbuildinfo",
+    "lint": "biome check --write ./src",
+    "test": "echo 'bun test'",
+    "test:coverage": "bun test --coverage",
+    "type-check": "tsc --noEmit"
+  },
+  "type": "module",
+  "types": "./src/index.ts",
+  "version": "1.0.1"
+}

package/src/__tests__/helpers.test.ts

@@ -0,0 +1,65 @@
+import { describe, expect, test } from "bun:test";
+import { Chain, ChainToExplorerUrl, CosmosChains, EVMChains, UTXOChains } from "@swapkit/helpers";
+import { getExplorerAddressUrl, getExplorerTxUrl } from "../helpers/explorerUrls.ts";
+
+describe("Explorer URLs", () => {
+  describe("CosmosChains", () => {
+    for (const chain of CosmosChains) {
+      test(`getExplorerTxUrl returns correct URL for ${chain}`, () => {
+        expect(getExplorerTxUrl({ chain, txHash: "0x123456789" })).toBe(
+          `${ChainToExplorerUrl[chain]}/tx/123456789`,
+        );
+
+        expect(getExplorerAddressUrl({ chain, address: "asdfg" })).toBe(
+          `${ChainToExplorerUrl[chain]}/address/asdfg`,
+        );
+      });
+    }
+  });
+
+  describe("EVMChains & SubstrateChains", () => {
+    for (const chain of [...EVMChains, Chain.Polkadot]) {
+      test(`getExplorerTxUrl returns correct URL for ${chain}`, () => {
+        expect(getExplorerTxUrl({ chain, txHash: "0x123456789" })).toBe(
+          `${ChainToExplorerUrl[chain]}/tx/0x123456789`,
+        );
+
+        expect(getExplorerAddressUrl({ chain, address: "asdfg" })).toBe(
+          `${ChainToExplorerUrl[chain]}/address/asdfg`,
+        );
+      });
+    }
+
+    test("getExplorerTxUrl adds 0x for EVM like chains", () => {
+      expect(getExplorerTxUrl({ chain: Chain.Ethereum, txHash: "12345" })).toBe(
+        "https://etherscan.io/tx/0x12345",
+      );
+    });
+  });
+
+  describe("UTXOChains", () => {
+    for (const chain of UTXOChains.filter((c) => c !== Chain.Dash)) {
+      test(`getExplorerTxUrl returns correct URL for ${chain}`, () => {
+        expect(getExplorerTxUrl({ chain, txHash: "0x123456789" })).toBe(
+          `${ChainToExplorerUrl[chain]}/transaction/0x123456789`,
+        );
+
+        expect(getExplorerAddressUrl({ chain, address: "asdfg" })).toBe(
+          `${ChainToExplorerUrl[chain]}/address/asdfg`,
+        );
+      });
+    }
+  });
+
+  describe("Solana", () => {
+    test("getExplorerTxUrl returns correct URL for Solana", () => {
+      expect(getExplorerTxUrl({ chain: Chain.Solana, txHash: "b123456789" })).toBe(
+        "https://solscan.io/tx/b123456789",
+      );
+
+      expect(getExplorerAddressUrl({ chain: Chain.Solana, address: "asdfg" })).toBe(
+        "https://solscan.io/account/asdfg",
+      );
+    });
+  });
+});

package/src/client.ts

@@ -0,0 +1,415 @@
+import { lowercasedContractAbiMapping } from "@swapkit/contracts";
+import {
+  type AddChainWalletParams,
+  ApproveMode,
+  type ApproveReturnType,
+  AssetValue,
+  Chain,
+  type ConnectConfig,
+  type EVMChain,
+  EVMChains,
+  type FeeOption,
+  ProviderName as PluginNameEnum,
+  SwapKitError,
+  type SwapParams,
+  type WalletChain,
+  isGasAsset,
+} from "@swapkit/helpers";
+import {
+  type TransferParams as CosmosTransferParams,
+  estimateTransactionFee as cosmosTransactionFee,
+  cosmosValidateAddress,
+} from "@swapkit/toolbox-cosmos";
+import { type TransferParams as EVMTransferParams, evmValidateAddress } from "@swapkit/toolbox-evm";
+import { substrateValidateAddress } from "@swapkit/toolbox-substrate";
+import { type UTXOTransferParams, utxoValidateAddress } from "@swapkit/toolbox-utxo";
+
+import {
+  getExplorerAddressUrl as getAddressUrl,
+  getExplorerTxUrl as getTxUrl,
+} from "./helpers/explorerUrls.ts";
+import type { Apis, SwapKitPluginInterface, SwapKitWallet, Wallet } from "./types.ts";
+
+export function SwapKit<
+  Plugins extends { [key in string]: SwapKitPluginInterface<{ [key in string]: Todo }> },
+  Wallets extends { [key in string]: SwapKitWallet<NotWorth[]> },
+>({
+  apis = {},
+  config = {},
+  plugins,
+  rpcUrls = {},
+  stagenet = false,
+  wallets,
+}: {
+  apis?: Apis;
+  config?: ConnectConfig;
+  plugins: Plugins;
+  rpcUrls?: { [key in Chain]?: string };
+  stagenet?: boolean;
+  wallets: Wallets;
+}) {
+  type PluginName = keyof Plugins;
+
+  const connectedWallets = {} as Wallet;
+  const availablePlugins = Object.entries(plugins).reduce(
+    (acc, [pluginName, { plugin, config: pluginConfig }]) => {
+      const methods = plugin({
+        wallets: connectedWallets,
+        stagenet,
+        config: pluginConfig ?? config,
+      });
+
+      // @ts-expect-error
+      acc[pluginName] = methods;
+      return acc;
+    },
+    {} as { [key in PluginName]: ReturnType<Plugins[key]["plugin"]> },
+  );
+
+  const connectWalletMethods = Object.entries(wallets).reduce(
+    (acc, [walletName, wallet]) => {
+      const connectWallet = wallet({ addChain, config, apis, rpcUrls });
+
+      // @ts-expect-error
+      acc[walletName] = connectWallet;
+      return acc;
+    },
+    {} as { [key in keyof Wallets]: ReturnType<Wallets[key]> },
+  );
+
+  function getSwapKitPlugin<T extends PluginName>(pluginName: T) {
+    const plugin = availablePlugins[pluginName] || Object.values(availablePlugins)[0];
+
+    if (!plugin) {
+      throw new SwapKitError("core_plugin_not_found");
+    }
+
+    return plugin;
+  }
+
+  function getSwapKitPluginForSKProvider(pluginName: PluginNameEnum): Plugins[keyof Plugins] {
+    const plugin = Object.values(availablePlugins).find((plugin) =>
+      plugin.supportedSwapkitProviders?.includes(pluginName),
+    );
+
+    if (!plugin) {
+      throw new SwapKitError("core_plugin_not_found");
+    }
+
+    return plugin;
+  }
+
+  function addChain<T extends Chain>(connectWallet: AddChainWalletParams<T>) {
+    // @ts-expect-error: TODO
+    connectedWallets[connectWallet.chain] = connectWallet;
+  }
+
+  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: <explanation>
+  function approve<T extends ApproveMode>({
+    assetValue,
+    type = "checkOnly" as T,
+    contractAddress: spenderAddress,
+  }: {
+    type: T;
+    assetValue: AssetValue;
+    contractAddress: string | PluginName;
+  }) {
+    const plugin = availablePlugins[spenderAddress];
+
+    if (plugin) {
+      if (type === ApproveMode.CheckOnly && "isAssetValueApproved" in plugin) {
+        return plugin.isAssetValueApproved({ assetValue }) as ApproveReturnType<T>;
+      }
+      if (type === ApproveMode.Approve && "approveAssetValue" in plugin) {
+        return plugin.approveAssetValue({ assetValue }) as ApproveReturnType<T>;
+      }
+
+      throw new SwapKitError({
+        errorKey: "core_approve_asset_target_invalid",
+        info: { message: `Target ${String(spenderAddress)} cannot be used for approve operation` },
+      });
+    }
+
+    const chain = assetValue.chain as EVMChain;
+    const isEVMChain = EVMChains.includes(chain);
+    const isNativeEVM = isEVMChain && assetValue.isGasAsset;
+
+    if (isNativeEVM || !isEVMChain || assetValue.isSynthetic) {
+      return Promise.resolve(type === "checkOnly" ? true : "approved") as ApproveReturnType<T>;
+    }
+
+    const wallet = getWallet(chain);
+    const walletAction = type === "checkOnly" ? wallet.isApproved : wallet.approve;
+    if (!walletAction) throw new SwapKitError("core_wallet_connection_not_found");
+
+    if (!(assetValue.address && wallet.address && typeof spenderAddress === "string")) {
+      throw new SwapKitError("core_approve_asset_address_or_from_not_found");
+    }
+
+    return walletAction({
+      amount: assetValue.getBaseValue("bigint"),
+      assetAddress: assetValue.address,
+      from: wallet.address,
+      spenderAddress,
+    }) as ApproveReturnType<T>;
+  }
+
+  /**
+   * @Public
+   */
+  function getWallet<T extends Chain>(chain: T) {
+    return connectedWallets[chain];
+  }
+
+  function getAllWallets() {
+    return { ...connectedWallets };
+  }
+
+  function getAddress<T extends Chain>(chain: T) {
+    return getWallet(chain)?.address || "";
+  }
+
+  function approveAssetValue(assetValue: AssetValue, contractAddress: string | PluginName) {
+    return approve({ assetValue, contractAddress, type: ApproveMode.Approve });
+  }
+
+  function isAssetValueApproved(assetValue: AssetValue, contractAddress: string | PluginName) {
+    return approve({ assetValue, contractAddress, type: ApproveMode.CheckOnly });
+  }
+
+  function disconnectChain<T extends Chain>(chain: T) {
+    const wallet = getWallet(chain);
+    wallet?.disconnect?.();
+    delete connectedWallets[chain];
+  }
+
+  function disconnectAll() {
+    for (const chain of Object.keys(connectedWallets) as (keyof typeof connectedWallets)[]) {
+      disconnectChain(chain);
+    }
+  }
+
+  function getBalance<T extends Chain>(chain: T, refresh?: boolean) {
+    return refresh
+      ? getWalletWithBalance(chain).then((wallet) => wallet.balance)
+      : getWallet(chain)?.balance || [];
+  }
+
+  function validateAddress({ address, chain }: { address: string; chain: Chain }) {
+    switch (chain) {
+      case Chain.Arbitrum:
+      case Chain.Avalanche:
+      case Chain.Optimism:
+      case Chain.BinanceSmartChain:
+      case Chain.Polygon:
+      case Chain.Ethereum:
+        return evmValidateAddress({ address });
+
+      case Chain.Litecoin:
+      case Chain.Dash:
+      case Chain.Dogecoin:
+      case Chain.BitcoinCash:
+      case Chain.Bitcoin:
+        return utxoValidateAddress({ address, chain });
+
+      case Chain.Cosmos:
+      case Chain.Kujira:
+      case Chain.Maya:
+      case Chain.THORChain:
+        return cosmosValidateAddress({ address, chain });
+
+      case Chain.Polkadot:
+        return substrateValidateAddress({ address, chain });
+
+      default:
+        return false;
+    }
+  }
+
+  async function getWalletWithBalance<T extends Chain>(chain: T, potentialScamFilter = true) {
+    const defaultBalance = [AssetValue.from({ chain })];
+    const wallet = getWallet(chain);
+
+    if (!wallet) {
+      throw new SwapKitError("core_wallet_connection_not_found");
+    }
+
+    if ("getBalance" in wallet) {
+      // @ts-expect-error TODO add getBalance to radix
+      const balance = await wallet.getBalance(wallet.address, potentialScamFilter);
+      wallet.balance = balance?.length ? balance : defaultBalance;
+    }
+
+    return wallet;
+  }
+
+  function swap<T extends PluginName>({ route, pluginName, ...rest }: SwapParams<T>) {
+    const plugin =
+      (pluginName && getSwapKitPlugin(pluginName)) ||
+      getSwapKitPluginForSKProvider(route.providers[0] as PluginNameEnum);
+
+    if (!plugin) throw new SwapKitError("core_swap_route_not_complete");
+
+    if ("swap" in plugin) {
+      return plugin.swap({ ...rest, route });
+    }
+
+    throw new SwapKitError("core_plugin_swap_not_found");
+  }
+
+  function transfer({
+    from,
+    recipient,
+    assetValue,
+    feeOptionKey,
+  }: UTXOTransferParams | EVMTransferParams | CosmosTransferParams) {
+    const chain = assetValue.chain as WalletChain;
+    const wallet = getWallet(chain);
+    if (!wallet) throw new SwapKitError("core_wallet_connection_not_found");
+
+    return wallet.transfer({ from, recipient, assetValue, feeOptionKey });
+  }
+
+  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: TODO clean this up
+  async function estimateTransactionFee<T extends PluginName>({
+    type,
+    feeOptionKey,
+    params,
+  }: (
+    | { type: "swap"; params: SwapParams<T> & { assetValue: AssetValue } }
+    | {
+        type: "transfer";
+        params: UTXOTransferParams | EVMTransferParams | CosmosTransferParams;
+      }
+    | {
+        type: "approve";
+        params: {
+          assetValue: AssetValue;
+          contractAddress: string | PluginName;
+          feeOptionKey?: FeeOption;
+        };
+      }
+  ) & {
+    feeOptionKey: FeeOption;
+  }): Promise<AssetValue | undefined> {
+    const { assetValue } = params;
+    const { chain } = assetValue;
+
+    if (!getWallet(chain)) throw new SwapKitError("core_wallet_connection_not_found");
+
+    const baseValue = AssetValue.from({ chain });
+
+    switch (chain) {
+      case Chain.Arbitrum:
+      case Chain.Avalanche:
+      case Chain.Ethereum:
+      case Chain.BinanceSmartChain:
+      case Chain.Polygon: {
+        const wallet = getWallet(chain);
+        if (type === "transfer") {
+          const txObject = await wallet.createTransferTx(params);
+          return wallet.estimateTransactionFee(txObject, feeOptionKey);
+        }
+
+        if (type === "approve" && !isGasAsset(assetValue)) {
+          return wallet.estimateTransactionFee(
+            await wallet.createApprovalTx({
+              assetAddress: assetValue.address as string,
+              spenderAddress: params.contractAddress as string,
+              amount: assetValue.getBaseValue("bigint"),
+              from: wallet.address,
+            }),
+            feeOptionKey,
+          );
+        }
+
+        if (type === "swap") {
+          const plugin = params.route.providers[0] as PluginNameEnum;
+          if (plugin === PluginNameEnum.CHAINFLIP) {
+            const txObject = await wallet.createTransferTx({
+              from: wallet.address,
+              recipient: wallet.address,
+              assetValue,
+            });
+            return wallet.estimateTransactionFee(txObject, feeOptionKey);
+          }
+
+          const { evmTransactionDetails } = params.route;
+          if (
+            !(
+              evmTransactionDetails &&
+              lowercasedContractAbiMapping[evmTransactionDetails.contractAddress]
+            )
+          ) {
+            return undefined;
+          }
+
+          return wallet.estimateTransactionFee(
+            await wallet.createContractTxObject({
+              contractAddress: evmTransactionDetails.contractAddress,
+              // biome-ignore lint/style/noNonNullAssertion: TS cant infer the type
+              abi: lowercasedContractAbiMapping[evmTransactionDetails.contractAddress]!,
+              funcName: evmTransactionDetails.contractMethod,
+              funcParams: evmTransactionDetails.contractParams,
+            }),
+            feeOptionKey,
+          );
+        }
+
+        return AssetValue.from({ chain });
+      }
+
+      case Chain.Bitcoin:
+      case Chain.BitcoinCash:
+      case Chain.Dogecoin:
+      case Chain.Dash:
+      case Chain.Litecoin: {
+        const { estimateMaxSendableAmount, address } = getWallet(chain);
+
+        return estimateMaxSendableAmount({
+          ...params,
+          feeOptionKey,
+          from: address,
+          recipient: address,
+        });
+      }
+
+      case Chain.THORChain:
+      case Chain.Maya:
+      case Chain.Kujira:
+      case Chain.Cosmos: {
+        return cosmosTransactionFee(params);
+      }
+
+      case Chain.Polkadot: {
+        const { address, estimateTransactionFee } = getWallet(chain);
+
+        return estimateTransactionFee({ ...params, recipient: address });
+      }
+
+      default:
+        return baseValue;
+    }
+  }
+
+  return {
+    ...availablePlugins,
+    ...connectWalletMethods,
+
+    approveAssetValue,
+    getAddress,
+    getBalance,
+    getExplorerAddressUrl: getAddressUrl,
+    getExplorerTxUrl: getTxUrl,
+    getWallet,
+    getAllWallets,
+    getWalletWithBalance,
+    isAssetValueApproved,
+    estimateTransactionFee,
+    swap,
+    transfer,
+    validateAddress,
+    disconnectAll,
+    disconnectChain,
+  };
+}

package/src/helpers/explorerUrls.ts

@@ -0,0 +1,44 @@
+import { Chain, ChainToExplorerUrl, SwapKitError } from "@swapkit/helpers";
+
+export function getExplorerTxUrl({ chain, txHash }: { txHash: string; chain: Chain }) {
+  const baseUrl = ChainToExplorerUrl[chain];
+
+  switch (chain) {
+    case Chain.Maya:
+    case Chain.Kujira:
+    case Chain.Cosmos:
+    case Chain.THORChain:
+    case Chain.Solana:
+      return `${baseUrl}/tx/${txHash.startsWith("0x") ? txHash.slice(2) : txHash}`;
+
+    case Chain.Arbitrum:
+    case Chain.Avalanche:
+    case Chain.BinanceSmartChain:
+    case Chain.Ethereum:
+    case Chain.Optimism:
+    case Chain.Polkadot:
+    case Chain.Polygon:
+      return `${baseUrl}/tx/${txHash.startsWith("0x") ? txHash : `0x${txHash}`}`;
+
+    case Chain.Litecoin:
+    case Chain.Bitcoin:
+    case Chain.BitcoinCash:
+    case Chain.Dogecoin:
+      return `${baseUrl}/transaction/${txHash.toLowerCase()}`;
+
+    default:
+      throw new SwapKitError({ errorKey: "core_explorer_unsupported_chain", info: { chain } });
+  }
+}
+
+export function getExplorerAddressUrl({ chain, address }: { address: string; chain: Chain }) {
+  const baseUrl = ChainToExplorerUrl[chain];
+
+  switch (chain) {
+    case Chain.Solana:
+      return `${baseUrl}/account/${address}`;
+
+    default:
+      return `${baseUrl}/address/${address}`;
+  }
+}