@swapkit/helpers 2.5.0 → 3.0.0-beta.0

package/src/{helpers/web3wallets.ts → utils/wallets.ts}

@@ -1,27 +1,16 @@
 import type { BrowserProvider } from "ethers";
 import { SwapKitError } from "../modules/swapKitError";
 import {
-  Chain,
-  ChainId,
+  type AddChainType,
+  type Chain,
+  ChainToHexChainId,
   type EIP6963AnnounceProviderEvent,
   type EIP6963Provider,
+  type EthereumWindowProvider,
+  type NetworkParams,
   WalletOption,
 } from "../types";
-
-export type EthereumWindowProvider = BrowserProvider & {
-  __XDEFI?: boolean;
-  isBraveWallet?: boolean;
-  isCoinbaseWallet?: boolean;
-  isMetaMask?: boolean;
-  isOkxWallet?: boolean;
-  isKeepKeyWallet?: boolean;
-  isTrust?: boolean;
-  isTalisman?: boolean;
-  on: (event: string, callback?: () => void) => void;
-  overrideIsMetaMask?: boolean;
-  request: <T = unknown>(args: { method: string; params?: unknown[] }) => Promise<T>;
-  selectedProvider?: EthereumWindowProvider;
-};
+import { warnOnce } from "./others";
 
 declare const window: {
   ethereum: EthereumWindowProvider;
@@ -32,54 +21,91 @@ declare const window: {
   xfi?: { ethereum: EthereumWindowProvider };
 } & Window;
 
-type NetworkParams = {
-  chainId: ChainId;
-  chainName: string;
-  nativeCurrency: {
-    name: string;
-    symbol: string;
-    decimals: number;
-  };
-  rpcUrls: string[];
-  blockExplorerUrls: string[];
-};
+export function isWeb3Detected() {
+  return typeof window.ethereum !== "undefined";
+}
 
-type ProviderRequestParams = {
-  provider?: BrowserProvider;
-  params?: any;
-  method:
-    | "wallet_addEthereumChain"
-    | "wallet_switchEthereumChain"
-    | "eth_requestAccounts"
-    | "eth_sendTransaction"
-    | "eth_signTransaction";
-};
-
-const methodsToWrap = [
-  "approve",
-  "approvedAmount",
-  "call",
-  "sendTransaction",
-  "transfer",
-  "isApproved",
-  "approvedAmount",
-  "EIP1193SendTransaction",
-  "getFeeData",
-  "broadcastTransaction",
-  "estimateCall",
-  "estimateGasLimit",
-  "estimateGasPrices",
-  "createContractTxObject",
-];
-
-export const wrapMethodWithNetworkSwitch = <T extends (...args: any[]) => any>(
+export function isDetected(walletOption: WalletOption) {
+  return listWeb3EVMWallets().includes(walletOption);
+}
+
+export function listWeb3EVMWallets() {
+  const metamaskEnabled = window?.ethereum && !window.ethereum?.isBraveWallet;
+  // @ts-ignore that should be implemented in ctrl and hooked up via swapkit core
+  const ctrlEnabled = window?.xfi || window?.ethereum?.__XDEFI;
+  const braveEnabled = window?.ethereum?.isBraveWallet;
+  const trustEnabled = window?.ethereum?.isTrust || window?.trustwallet;
+  const coinbaseEnabled =
+    (window?.ethereum?.overrideIsMetaMask &&
+      window?.ethereum?.selectedProvider?.isCoinbaseWallet) ||
+    window?.coinbaseWalletExtension;
+  const bitgetEnabled = window?.bitkeep?.ethereum;
+
+  const wallets = [];
+  if (metamaskEnabled) wallets.push(WalletOption.METAMASK);
+  if (ctrlEnabled) wallets.push(WalletOption.CTRL);
+  if (braveEnabled) wallets.push(WalletOption.BRAVE);
+  if (trustEnabled) wallets.push(WalletOption.TRUSTWALLET_WEB);
+  if (coinbaseEnabled) wallets.push(WalletOption.COINBASE_WEB);
+  if (okxMobileEnabled()) wallets.push(WalletOption.OKX_MOBILE);
+  if (bitgetEnabled) wallets.push(WalletOption.BITGET);
+
+  return wallets;
+}
+
+export async function switchEVMWalletNetwork(
+  provider: BrowserProvider,
+  chain: Chain,
+  networkParams?: NetworkParams,
+) {
+  try {
+    await providerRequest({
+      provider,
+      method: "wallet_switchEthereumChain",
+      params: [{ chainId: ChainToHexChainId[chain] }],
+    });
+  } catch (_error) {
+    if (!networkParams) {
+      throw new Error("Failed to switch network, networkParams not provided");
+    }
+    await addEVMWalletNetwork(provider, networkParams);
+  }
+}
+
+export function filterSupportedChains<T extends string[]>({
+  chains,
+  supportedChains,
+  walletType,
+}: { chains: Chain[]; supportedChains: T; walletType?: WalletOption }) {
+  const supported = chains.filter((chain) => supportedChains.includes(chain));
+
+  if (supported.length === 0) {
+    throw new SwapKitError("wallet_chain_not_supported", {
+      wallet: walletType,
+      chain: chains.join(", "),
+    });
+  }
+
+  const unsupported = chains.filter((chain) => !supportedChains.includes(chain));
+
+  warnOnce(
+    unsupported.length > 0,
+    `${walletType} wallet does not support the following chains: ${unsupported.join(
+      ", ",
+    )}. These chains will be ignored.`,
+  );
+
+  return supported as T;
+}
+
+export function wrapMethodWithNetworkSwitch<T extends (...args: any[]) => any>(
   func: T,
   provider: BrowserProvider,
-  chainId: ChainId,
-) =>
+  chain: Chain,
+) {
   (async (...args: any[]) => {
     try {
-      await switchEVMWalletNetwork(provider, chainId);
+      await switchEVMWalletNetwork(provider, chain);
     } catch (error) {
       throw new SwapKitError({
         errorKey: "helpers_failed_to_switch_network",
@@ -88,25 +114,31 @@ export const wrapMethodWithNetworkSwitch = <T extends (...args: any[]) => any>(
     }
     return func(...args);
   }) as unknown as T;
+}
 
-const providerRequest = ({ provider, params, method }: ProviderRequestParams) => {
-  if (!provider?.send) {
-    throw new SwapKitError("helpers_not_found_provider");
-  }
-
-  const providerParams = params ? (Array.isArray(params) ? params : [params]) : [];
-  return provider.send(method, providerParams);
-};
-
-export const prepareNetworkSwitch = <T extends { [key: string]: (...args: any[]) => any }>({
+export function prepareNetworkSwitch<T extends { [key: string]: (...args: any[]) => any }>({
   toolbox,
-  chainId,
+  chain,
   provider = window.ethereum,
-}: {
-  toolbox: T;
-  chainId: ChainId;
-  provider?: BrowserProvider;
-}) => {
+  methodNames = [],
+}: { toolbox: T; chain: Chain; provider?: BrowserProvider; methodNames?: string[] }) {
+  const methodsToWrap = [
+    ...methodNames,
+    "approve",
+    "approvedAmount",
+    "call",
+    "sendTransaction",
+    "transfer",
+    "isApproved",
+    "approvedAmount",
+    "EIP1193SendTransaction",
+    "getFeeData",
+    "broadcastTransaction",
+    "estimateCall",
+    "estimateGasLimit",
+    "estimateGasPrices",
+    "createContractTxObject",
+  ];
   const wrappedMethods = methodsToWrap.reduce((object, methodName) => {
     if (!toolbox[methodName]) return object;
     const method = toolbox[methodName];
@@ -116,37 +148,23 @@ export const prepareNetworkSwitch = <T extends { [key: string]: (...args: any[])
     return {
       // biome-ignore lint/performance/noAccumulatingSpread: This is a valid use case
       ...object,
-      [methodName]: wrapMethodWithNetworkSwitch<typeof method>(method, provider, chainId),
+      [methodName]: wrapMethodWithNetworkSwitch<typeof method>(method, provider, chain),
     };
   }, {});
 
   return { ...toolbox, ...wrappedMethods };
-};
-
-export const addEVMWalletNetwork = (provider: BrowserProvider, networkParams: NetworkParams) =>
-  providerRequest({ provider, method: "wallet_addEthereumChain", params: [networkParams] });
+}
 
-export const switchEVMWalletNetwork = (
-  provider: BrowserProvider,
-  chainId = ChainId.EthereumHex,
-  networkParams?: NetworkParams,
-) => {
-  try {
-    providerRequest({ provider, method: "wallet_switchEthereumChain", params: [{ chainId }] });
-  } catch (_error) {
-    if (!networkParams) {
-      throw new Error("Failed to switch network, networkParams not provided");
-    }
-    addEVMWalletNetwork(provider, networkParams);
-  }
-};
+export function addEVMWalletNetwork(provider: BrowserProvider, networkParams: NetworkParams) {
+  return providerRequest({ provider, method: "wallet_addEthereumChain", params: [networkParams] });
+}
 
-export const addAccountsChangedCallback = (callback: () => void) => {
+export function addAccountsChangedCallback(callback: () => void) {
   window.ethereum?.on("accountsChanged", () => callback());
   window.xfi?.ethereum.on("accountsChanged", () => callback());
-};
+}
 
-export const getETHDefaultWallet = () => {
+export function getETHDefaultWallet() {
   const { isTrust, isBraveWallet, __XDEFI, overrideIsMetaMask, selectedProvider } =
     window?.ethereum || {};
   if (isTrust) return WalletOption.TRUSTWALLET_WEB;
@@ -154,44 +172,6 @@ export const getETHDefaultWallet = () => {
   if (overrideIsMetaMask && selectedProvider?.isCoinbaseWallet) return WalletOption.COINBASE_WEB;
   if (__XDEFI) WalletOption.CTRL;
   return WalletOption.METAMASK;
-};
-
-export const isDetected = (walletOption: WalletOption) => {
-  return listWeb3EVMWallets().includes(walletOption);
-};
-
-export const listWeb3EVMWallets = () => {
-  const metamaskEnabled = window?.ethereum && !window.ethereum?.isBraveWallet;
-  // @ts-ignore that should be implemented in ctrl and hooked up via swapkit core
-  const ctrlEnabled = window?.xfi || window?.ethereum?.__XDEFI;
-  const braveEnabled = window?.ethereum?.isBraveWallet;
-  const trustEnabled = window?.ethereum?.isTrust || window?.trustwallet;
-  const coinbaseEnabled =
-    (window?.ethereum?.overrideIsMetaMask &&
-      window?.ethereum?.selectedProvider?.isCoinbaseWallet) ||
-    window?.coinbaseWalletExtension;
-  const bitgetEnabled = window?.bitkeep?.ethereum;
-
-  const wallets = [];
-  if (metamaskEnabled) wallets.push(WalletOption.METAMASK);
-  if (ctrlEnabled) wallets.push(WalletOption.CTRL);
-  if (braveEnabled) wallets.push(WalletOption.BRAVE);
-  if (trustEnabled) wallets.push(WalletOption.TRUSTWALLET_WEB);
-  if (coinbaseEnabled) wallets.push(WalletOption.COINBASE_WEB);
-  if (okxMobileEnabled()) wallets.push(WalletOption.OKX_MOBILE);
-  if (bitgetEnabled) wallets.push(WalletOption.BITGET);
-
-  return wallets;
-};
-
-export function pickEvmApiKey({
-  chain,
-  nonEthApiKey,
-  ethApiKey,
-}: { chain: Chain; nonEthApiKey?: string; ethApiKey?: string }) {
-  const apiKey = chain === Chain.Ethereum ? ethApiKey : nonEthApiKey;
-
-  return apiKey;
 }
 
 export function getEIP6963Wallets() {
@@ -212,7 +192,7 @@ export function getEIP6963Wallets() {
   return { providers, removeEIP6963EventListener };
 }
 
-export const okxMobileEnabled = () => {
+export function okxMobileEnabled() {
   const ua = navigator.userAgent;
   const isIOS = /iphone|ipad|ipod|ios/i.test(ua);
   const isAndroid = /android|XiaoMi|MiuiBrowser/i.test(ua);
@@ -220,6 +200,62 @@ export const okxMobileEnabled = () => {
   const isOKApp = /OKApp/i.test(ua);
 
   return isMobile && isOKApp;
-};
+}
+
+export function createWallet<
+  ConnectParams extends any[],
+  SupportedChains extends Chain[],
+  const Name extends string,
+  WalletType extends WalletOption,
+>({
+  connect,
+  name,
+  supportedChains,
+  walletType,
+}: {
+  connect: (connectParams: {
+    addChain: AddChainType;
+    walletType: WalletType;
+    supportedChains: SupportedChains;
+  }) => (...params: ConnectParams) => Promise<boolean>;
+  name: Name;
+  supportedChains: SupportedChains;
+  walletType?: WalletType;
+}) {
+  function connectWallet(connectParams: {
+    addChain: AddChainType;
+  }) {
+    return connect({ ...connectParams, walletType: walletType as WalletType, supportedChains });
+  }
+
+  return {
+    [name]: { supportedChains, connectWallet },
+  } as unknown as {
+    [key in Name]: {
+      connectWallet: typeof connectWallet;
+      supportedChains: SupportedChains;
+    };
+  };
+}
 
-export const isWeb3Detected = () => typeof window.ethereum !== "undefined";
+function providerRequest({
+  provider,
+  params,
+  method,
+}: {
+  provider?: BrowserProvider;
+  params?: any;
+  method:
+    | "wallet_addEthereumChain"
+    | "wallet_switchEthereumChain"
+    | "eth_requestAccounts"
+    | "eth_sendTransaction"
+    | "eth_signTransaction";
+}) {
+  if (!provider?.send) {
+    throw new SwapKitError("helpers_not_found_provider");
+  }
+
+  const providerParams = params ? (Array.isArray(params) ? params : [params]) : [];
+  return provider.send(method, providerParams);
+}

package/src/modules/walletUtils.ts

@@ -1,30 +0,0 @@
-import type { Chain } from "../types/chains";
-import type { WalletOption } from "../types/wallet";
-import { SwapKitError } from "./swapKitError";
-
-export function filterSupportedChains<T extends Chain>(
-  chains: Chain[],
-  supportedChains: readonly T[],
-  walletOption: WalletOption,
-) {
-  const supported = chains.filter((chain): chain is T => supportedChains.includes(chain as T));
-
-  if (supported.length === 0) {
-    throw new SwapKitError("wallet_chain_not_supported", {
-      wallet: walletOption,
-      chain: chains.join(", "),
-    });
-  }
-
-  const unsupported = chains.filter((chain) => !supportedChains.includes(chain as T));
-
-  if (unsupported.length > 0) {
-    console.warn(
-      `${walletOption} wallet does not support the following chains: ${unsupported.join(
-        ", ",
-      )}. These chains will be ignored.`,
-    );
-  }
-
-  return supported;
-}

package/src/types/network.ts

@@ -1,49 +0,0 @@
-/** @deprecated Use getRPCUrl or RPC_URLS instead */
-export enum RPCUrl {
-  Arbitrum = "https://arb1.arbitrum.io/rpc",
-  Avalanche = "https://avalanche-c-chain-rpc.publicnode.com",
-  Base = "https://base.llamarpc.com",
-  BinanceSmartChain = "https://bsc-dataseed.binance.org",
-  Bitcoin = "https://bitcoin-rpc.publicnode.com",
-  BitcoinCash = "https://node-router.thorswap.net/bitcoin-cash",
-  Chainflip = "wss://mainnet-archive.chainflip.io",
-  Cosmos = "https://node-router.thorswap.net/cosmos/rpc",
-  Dash = "https://dash-rpc.publicnode.com",
-  Dogecoin = "https://node-router.thorswap.net/dogecoin",
-  Ethereum = "https://ethereum-rpc.publicnode.com",
-  Kujira = "https://rpc-kujira.synergynodes.com/",
-  Litecoin = "https://node-router.thorswap.net/litecoin",
-  Maya = "https://tendermint.mayachain.info",
-  MayaStagenet = "https://stagenet.tendermint.mayachain.info",
-  Optimism = "https://mainnet.optimism.io",
-  Polkadot = "wss://rpc.polkadot.io",
-  Polygon = "https://polygon-rpc.com",
-  Radix = "https://radix-mainnet.rpc.grove.city/v1/326002fc/core",
-  THORChain = "https://rpc.thorswap.net",
-  THORChainStagenet = "https://stagenet-rpc.ninerealms.com",
-  Solana = "https://solana-rpc.publicnode.com",
-}
-
-/** @deprecated Use EXPLORER_URLS instead */
-export enum ExplorerUrl {
-  Arbitrum = "https://arbiscan.io",
-  Avalanche = "https://snowtrace.io",
-  Base = "https://basescan.org",
-  BinanceSmartChain = "https://bscscan.com",
-  Bitcoin = "https://blockchair.com/bitcoin",
-  BitcoinCash = "https://www.blockchair.com/bitcoin-cash",
-  Chainflip = "https://explorer.polkascan.io/polkadot",
-  Cosmos = "https://www.mintscan.io/cosmos",
-  Dash = "https://blockchair.com/dash",
-  Dogecoin = "https://blockchair.com/dogecoin",
-  Ethereum = "https://etherscan.io",
-  Kujira = "https://finder.kujira.network/kaiyo-1",
-  Litecoin = "https://blockchair.com/litecoin",
-  Maya = "https://www.mayascan.org",
-  Optimism = "https://optimistic.etherscan.io",
-  Polkadot = "https://polkadot.subscan.io",
-  Polygon = "https://polygonscan.com",
-  Radix = "https://dashboard.radixdlt.com",
-  THORChain = "https://runescan.io",
-  Solana = "https://solscan.io",
-}