thirdweb 5.105.49-nightly-04862de9e4e11724720fa40a0ed4713ff2bfdad5-20250917000323 → 5.106.0

package/src/react/web/ui/Bridge/swap-widget/types.ts

@@ -0,0 +1,157 @@
+import type { Chain } from "../../../../../chains/types.js";
+import type {
+  Account,
+  Wallet,
+} from "../../../../../wallets/interfaces/wallet.js";
+import type { SmartWalletOptions } from "../../../../../wallets/smart/types.js";
+import type { AppMetadata } from "../../../../../wallets/types.js";
+import type { SiweAuthOptions } from "../../../../core/hooks/auth/useSiweAuth.js";
+import type { ConnectButton_connectModalOptions } from "../../../../core/hooks/connection/ConnectButtonProps.js";
+import type { BridgePrepareResult } from "../../../../core/hooks/useBridgePrepare.js";
+
+/**
+ * Connection options for the `SwapWidget` component
+ *
+ * @example
+ * ```tsx
+ * <SwapWidget client={client} connectOptions={{
+ *    connectModal: {
+ *      size: 'compact',
+ *      title: "Sign in",
+ *    }
+ *  }}
+ * />
+ * ```
+ */
+export type SwapWidgetConnectOptions = {
+  /**
+   * Configurations for the `ConnectButton`'s Modal that is shown for connecting a wallet
+   * Refer to the [`ConnectButton_connectModalOptions`](https://portal.thirdweb.com/references/typescript/v5/ConnectButton_connectModalOptions) type for more details
+   */
+  connectModal?: ConnectButton_connectModalOptions;
+
+  /**
+   * Configure options for WalletConnect
+   *
+   * By default WalletConnect uses the thirdweb's default project id.
+   * Setting your own project id is recommended.
+   *
+   * You can create a project id by signing up on [walletconnect.com](https://walletconnect.com/)
+   */
+  walletConnect?: {
+    projectId?: string;
+  };
+
+  /**
+   * Enable Account abstraction for all wallets. This will connect to the users's smart account based on the connected personal wallet and the given options.
+   *
+   * This allows to sponsor gas fees for your user's transaction using the thirdweb account abstraction infrastructure.
+   *
+   */
+  accountAbstraction?: SmartWalletOptions;
+
+  /**
+   * Array of wallets to show in Connect Modal. If not provided, default wallets will be used.
+   */
+  wallets?: Wallet[];
+  /**
+   * When the user has connected their wallet to your site, this configuration determines whether or not you want to automatically connect to the last connected wallet when user visits your site again in the future.
+   *
+   * By default it is set to `{ timeout: 15000 }` meaning that autoConnect is enabled and if the autoConnection does not succeed within 15 seconds, it will be cancelled.
+   *
+   * If you want to disable autoConnect, set this prop to `false`.
+   *
+   * If you want to customize the timeout, you can assign an object with a `timeout` key to this prop.
+   */
+  autoConnect?:
+    | {
+        timeout: number;
+      }
+    | boolean;
+
+  /**
+   * Metadata of the app that will be passed to connected wallet. Setting this is highly recommended.
+   */
+  appMetadata?: AppMetadata;
+
+  /**
+   * The [`Chain`](https://portal.thirdweb.com/references/typescript/v5/Chain) object of the blockchain you want the wallet to connect to
+   *
+   * If a `chain` is not specified, Wallet will be connected to whatever is the default set in the wallet.
+   *
+   * If a `chain` is specified, Wallet will be prompted to switch to given chain after connection if it is not already connected to it.
+   * This ensures that the wallet is connected to the correct blockchain before interacting with your app.
+   *
+   * The `ConnectButton` also shows a "Switch Network" button until the wallet is connected to the specified chain. Clicking on the "Switch Network" button triggers the wallet to switch to the specified chain.
+   *
+   * You can create a `Chain` object using the [`defineChain`](https://portal.thirdweb.com/references/typescript/v5/defineChain) function.
+   * At minimum, you need to pass the `id` of the blockchain to `defineChain` function to create a `Chain` object.
+   * ```
+   */
+  chain?: Chain;
+
+  /**
+   * Array of chains that your app supports.
+   *
+   * This is only relevant if your app is a multi-chain app and works across multiple blockchains.
+   * If your app only works on a single blockchain, you should only specify the `chain` prop.
+   *
+   * Given list of chains will used in various ways:
+   * - They will be displayed in the network selector in the `ConnectButton`'s details modal post connection
+   * - They will be sent to wallet at the time of connection if the wallet supports requesting multiple chains ( example: WalletConnect ) so that users can switch between the chains post connection easily
+   *
+   * You can create a `Chain` object using the [`defineChain`](https://portal.thirdweb.com/references/typescript/v5/defineChain) function.
+   * At minimum, you need to pass the `id` of the blockchain to `defineChain` function to create a `Chain` object.
+   *
+   * ```tsx
+   * import { defineChain } from "thirdweb/react";
+   *
+   * const polygon = defineChain({
+   *   id: 137,
+   * });
+   * ```
+   */
+  chains?: Chain[];
+
+  /**
+   * Wallets to show as recommended in the `ConnectButton`'s Modal
+   */
+  recommendedWallets?: Wallet[];
+
+  /**
+   * By default, ConnectButton modal shows a "All Wallets" button that shows a list of 500+ wallets.
+   *
+   * You can disable this button by setting `showAllWallets` prop to `false`
+   */
+  showAllWallets?: boolean;
+
+  /**
+   * Enable SIWE (Sign in with Ethererum) by passing an object of type `SiweAuthOptions` to
+   * enforce the users to sign a message after connecting their wallet to authenticate themselves.
+   *
+   * Refer to the [`SiweAuthOptions`](https://portal.thirdweb.com/references/typescript/v5/SiweAuthOptions) for more details
+   */
+  auth?: SiweAuthOptions;
+};
+
+/**
+ * @internal
+ */
+export type ActiveWalletInfo = {
+  activeChain: Chain;
+  activeWallet: Wallet;
+  activeAccount: Account;
+};
+
+/**
+ * @internal
+ */
+export type TokenSelection = {
+  tokenAddress: string;
+  chainId: number;
+};
+
+export type SwapPreparedQuote = Extract<
+  BridgePrepareResult,
+  { type: "buy" | "sell" }
+>;

package/src/react/web/ui/Bridge/swap-widget/use-bridge-chains.ts

@@ -0,0 +1,14 @@
+import { useQuery } from "@tanstack/react-query";
+import { chains } from "../../../../../bridge/index.js";
+import type { ThirdwebClient } from "../../../../../client/client.js";
+
+export function useBridgeChains(client: ThirdwebClient) {
+  return useQuery({
+    queryKey: ["bridge-chains"],
+    queryFn: () => {
+      return chains({ client });
+    },
+    refetchOnMount: false,
+    refetchOnWindowFocus: false,
+  });
+}

package/src/react/web/ui/Bridge/swap-widget/use-tokens.ts

@@ -0,0 +1,120 @@
+import { useQuery } from "@tanstack/react-query";
+import type { Token } from "../../../../../bridge/index.js";
+import { tokens } from "../../../../../bridge/Token.js";
+import type { ThirdwebClient } from "../../../../../client/client.js";
+import { isAddress } from "../../../../../utils/address.js";
+import { getThirdwebBaseUrl } from "../../../../../utils/domains.js";
+
+export function useTokens(options: {
+  client: ThirdwebClient;
+  chainId?: number;
+  search?: string;
+  offset: number;
+  limit: number;
+}) {
+  return useQuery<Token[]>({
+    queryKey: ["tokens", options],
+    enabled: !!options.chainId,
+    queryFn: () => {
+      if (!options.chainId) {
+        throw new Error("Chain ID is required");
+      }
+
+      const isSearchAddress = options.search
+        ? isAddress(options.search)
+        : false;
+
+      return tokens({
+        chainId: options.chainId,
+        client: options.client,
+        offset: options.offset,
+        limit: options.limit,
+        includePrices: false,
+        name: !options.search || isSearchAddress ? undefined : options.search,
+        tokenAddress: isSearchAddress ? options.search : undefined,
+      });
+    },
+  });
+}
+
+export type TokenBalance = {
+  balance: string;
+  chain_id: number;
+  decimals: number;
+  name: string;
+  icon_uri: string;
+  price_data: {
+    circulating_supply: number;
+    market_cap_usd: number;
+    percent_change_24h: number;
+    price_timestamp: string;
+    price_usd: number;
+    total_supply: number;
+    usd_value: number;
+    volume_24h_usd: number;
+  };
+  symbol: string;
+  token_address: string;
+};
+
+type TokenBalancesResponse = {
+  result: {
+    pagination: {
+      hasMore: boolean;
+      limit: number;
+      page: number;
+      totalCount: number;
+    };
+    tokens: TokenBalance[];
+  };
+};
+
+export function useTokenBalances(options: {
+  clientId: string;
+  page: number;
+  limit: number;
+  walletAddress: string | undefined;
+  chainId: number | undefined;
+}) {
+  return useQuery({
+    queryKey: ["bridge/v1/wallets", options],
+    enabled: !!options.chainId && !!options.walletAddress,
+    queryFn: async () => {
+      if (!options.chainId || !options.walletAddress) {
+        throw new Error("invalid options");
+      }
+      const baseUrl = getThirdwebBaseUrl("bridge");
+      const isDev = baseUrl.includes("thirdweb-dev");
+      const url = new URL(
+        `https://api.${isDev ? "thirdweb-dev" : "thirdweb"}.com/v1/wallets/${options.walletAddress}/tokens`,
+      );
+      url.searchParams.set("chainId", options.chainId.toString());
+      url.searchParams.set("limit", options.limit.toString());
+      url.searchParams.set("page", options.page.toString());
+      url.searchParams.set("metadata", "true");
+      url.searchParams.set("resolveMetadataLinks", "true");
+      url.searchParams.set("includeSpam", "false");
+      url.searchParams.set("includeNative", "true");
+      url.searchParams.set("sortBy", "usd_value");
+      url.searchParams.set("sortOrder", "desc");
+      url.searchParams.set("includeWithoutPrice", "false"); // filter out tokens with no price
+
+      const response = await fetch(url.toString(), {
+        headers: {
+          "x-client-id": options.clientId,
+        },
+      });
+
+      if (!response.ok) {
+        throw new Error(
+          `Failed to fetch token balances: ${response.statusText}`,
+        );
+      }
+
+      const json = (await response.json()) as TokenBalancesResponse;
+      return json.result;
+    },
+    refetchOnMount: false,
+    refetchOnWindowFocus: false,
+  });
+}

package/src/react/web/ui/Bridge/swap-widget/utils.ts

@@ -0,0 +1,3 @@
+export function cleanedChainName(name: string) {
+  return name.replace("Mainnet", "");
+}

package/src/react/web/ui/ConnectWallet/ConnectButton.tsx

@@ -161,6 +161,19 @@ const TW_CONNECT_WALLET = "tw-connect-wallet";
  *
  * [View all available themes properties](https://portal.thirdweb.com/references/typescript/v5/Theme)
  *
+ * ### Overriding styles using class names
+ *
+ * Some elements in this component have classes with a `tw-` prefix.
+ * You can target these classes in your own CSS stylesheet to override their styles.
+ *
+ * In some cases, you may need to use the `!important` flag for the override to take effect. Do not use on auto-generated class names, as they may change between builds.
+ *
+ * ```css
+ * .tw-back-button {
+ *   background-color: red !important;
+ * }
+ * ```
+ *
  * ### Changing the display language
  *
  * ```tsx
@@ -543,6 +556,8 @@ function ConnectButtonInner(
             )}
           </Button>
           <Modal
+            className="tw-modal__sign-in"
+            title="Sign in"
             open={showSignatureModal}
             setOpen={setShowSignatureModal}
             size="compact"

package/src/react/web/ui/ConnectWallet/Details.test.tsx

@@ -560,7 +560,7 @@ describe("Details Modal", () => {
     );
 
     // Add assertions to check if the modal is rendered correctly
-    expect(screen.getByText("Connect Modal")).toBeInTheDocument();
+    expect(screen.getByText("Manage Wallet")).toBeInTheDocument();
   });
 
   it("should call closeModal when the close button is clicked", async () => {

package/src/react/web/ui/ConnectWallet/Details.tsx

@@ -572,6 +572,7 @@ export function DetailsModal(props: {
           <Container px="lg">
             {/* Send, Receive, Swap */}
             <Container
+              className="tw-highlight-buttons"
               style={{
                 display: "flex",
                 gap: spacing.xs,
@@ -579,6 +580,7 @@ export function DetailsModal(props: {
             >
               {!hideSendFunds && (
                 <Button
+                  className="tw-highlight-button__send"
                   onClick={() => {
                     setScreen("send");
                   }}
@@ -608,6 +610,7 @@ export function DetailsModal(props: {
 
               {!hideReceiveFunds && (
                 <Button
+                  className="tw-highlight-button__receive"
                   onClick={() => {
                     setScreen("receive");
                   }}
@@ -632,6 +635,7 @@ export function DetailsModal(props: {
                 chainMetadataQuery.data &&
                 !chainMetadataQuery.data.testnet && (
                   <Button
+                    className="tw-highlight-button__buy"
                     onClick={() => {
                       trackPayEvent({
                         client: client,
@@ -682,6 +686,7 @@ export function DetailsModal(props: {
 
           {/* Transactions */}
           <MenuButton
+            className="tw-view-transactions-button"
             onClick={() => {
               setScreen("transactions");
             }}
@@ -699,6 +704,7 @@ export function DetailsModal(props: {
           {/* Hide the View Funds button if the assetTabs props is set to an empty array */}
           {(props.assetTabs === undefined || props.assetTabs.length > 0) && (
             <MenuButton
+              className="tw-view-assets-button"
               onClick={() => {
                 setScreen("view-assets");
               }}
@@ -713,6 +719,7 @@ export function DetailsModal(props: {
 
           {/* Manage Wallet */}
           <MenuButton
+            className="tw-manage-wallet-button"
             onClick={() => {
               setScreen("manage-wallet");
             }}
@@ -729,6 +736,7 @@ export function DetailsModal(props: {
             (chainFaucetsQuery.faucets.length > 0 ||
               walletChain?.id === LocalhostChainId) && (
               <MenuLink
+                className="tw-request-testnet-funds-button"
                 as="a"
                 href={
                   chainFaucetsQuery.faucets ? chainFaucetsQuery.faucets[0] : "#"
@@ -759,6 +767,7 @@ export function DetailsModal(props: {
           <Spacer y="sm" />
           <Container px="md">
             <MenuButton
+              className="tw-disconnect-wallet-button"
               data-variant="danger"
               onClick={() => {
                 if (activeWallet && activeAccount) {
@@ -1000,6 +1009,8 @@ export function DetailsModal(props: {
       <WalletUIStatesProvider isOpen={false} theme={props.theme}>
         <ScreenSetupContext.Provider value={screenSetup}>
           <Modal
+            className="tw-modal__wallet-details"
+            title="Manage Wallet"
             open={isOpen}
             setOpen={(_open) => {
               if (!_open) {
@@ -1042,7 +1053,7 @@ export function NetworkSwitcherButton(props: {
   }
   return (
     <MenuButton
-      className="tw-internal-network-switcher-button"
+      className="tw-internal-network-switcher-button tw-switch-network-button"
       data-variant="primary"
       disabled={disableSwitchChain}
       onClick={() => {

package/src/react/web/ui/ConnectWallet/Modal/AllWalletsUI.tsx

@@ -69,7 +69,12 @@ function AllWalletsUI(props: {
   }, [searchResults, itemsToShow]);
 
   return (
-    <Container animate="fadein" flex="column" fullHeight>
+    <Container
+      animate="fadein"
+      flex="column"
+      fullHeight
+      className="tw-all-wallets-screen"
+    >
       <Container p="lg">
         <ModalHeader onBack={props.onBack} title="Select Wallet" />
       </Container>
@@ -140,6 +145,7 @@ function AllWalletsUI(props: {
                     }}
                   >
                     <WalletEntryButton
+                      className="tw-select-wallet-button"
                       badge={undefined}
                       client={props.client}
                       connectLocale={props.connectLocale}

package/src/react/web/ui/ConnectWallet/Modal/ConnectEmbed.tsx

@@ -22,6 +22,7 @@ import { useIsAutoConnecting } from "../../../../core/hooks/wallets/useIsAutoCon
 import { useConnectionManager } from "../../../../core/providers/connection-manager.js";
 import { WalletUIStatesProvider } from "../../../providers/wallet-ui-states-provider.js";
 import { canFitWideModal } from "../../../utils/canFitWideModal.js";
+import { cls } from "../../../utils/cls.js";
 import { usePreloadWalletProviders } from "../../../utils/usePreloadWalletProviders.js";
 import { LoadingScreen } from "../../../wallets/shared/LoadingScreen.js";
 import { AutoConnect } from "../../AutoConnect/AutoConnect.js";
@@ -161,6 +162,19 @@ import { useSetupScreen } from "./screen.js";
  *
  * [View all available themes properties](https://portal.thirdweb.com/references/typescript/v5/Theme)
  *
+ * ### Overriding styles using class names
+ *
+ * Some elements in this component have classes with a `tw-` prefix.
+ * You can target these classes in your own CSS stylesheet to override their styles.
+ *
+ * In some cases, you may need to use the `!important` flag for the override to take effect. Do not use on auto-generated class names, as they may change between builds.
+ *
+ * ```css
+ * .tw-back-button {
+ *   background-color: red !important;
+ * }
+ * ```
+ *
  * ### Changing the display language
  *
  * ```tsx
@@ -266,7 +280,11 @@ export function ConnectEmbed(props: ConnectEmbedProps) {
         <>
           {autoConnectComp}
           <CustomThemeProvider theme={props.theme}>
-            <EmbedContainer modalSize={modalSize}>
+            <EmbedContainer
+              modalSize={modalSize}
+              className={cls("tw-widget-loading", props.className)}
+              style={props.style}
+            >
               <LoadingScreen />
             </EmbedContainer>
           </CustomThemeProvider>

package/src/react/web/ui/ConnectWallet/Modal/ConnectModal.tsx

@@ -118,6 +118,8 @@ const ConnectModal = (props: ConnectModalOptions) => {
 
   return (
     <Modal
+      className="tw-modal__connect-wallet"
+      title="Connect Wallet"
       hide={hideModal}
       open={isWalletModalOpen}
       setOpen={(value) => {

package/src/react/web/ui/ConnectWallet/NetworkSelector.tsx

@@ -146,6 +146,7 @@ type NetworkSelectorContentProps = {
   showTabs?: boolean;
   connectLocale: ConnectLocale;
   client: ThirdwebClient;
+  className?: string;
 };
 
 /**
@@ -364,7 +365,7 @@ export function NetworkSelectorContent(props: NetworkSelectorContentProps) {
   );
 
   return (
-    <Container>
+    <Container className={props.className}>
       <Container p="lg">
         {props.onBack ? (
           <ModalHeader onBack={props.onBack} title={locale.title} />
@@ -954,6 +955,8 @@ export function useNetworkSwitcherModal() {
       setRootEl(
         <CustomThemeProvider theme={props.theme}>
           <Modal
+            className="tw-modal__switch-network"
+            title="Switch Network"
             open={true}
             setOpen={(value) => {
               if (!value) {

package/src/react/web/ui/ConnectWallet/WalletEntryButton.tsx

@@ -23,6 +23,7 @@ import type { ConnectLocale } from "./locale/types.js";
  * @internal
  */
 export function WalletEntryButton(props: {
+  className?: string;
   wallet: Wallet;
   selectWallet: () => void;
   connectLocale: ConnectLocale;
@@ -56,6 +57,7 @@ export function WalletEntryButton(props: {
 
   return (
     <WalletButtonEl
+      className={props.className}
       data-active={props.isActive}
       onClick={selectWallet}
       type="button"

package/src/react/web/ui/ConnectWallet/WalletSelector.tsx

@@ -1,6 +1,6 @@
 "use client";
 import { ChevronLeftIcon } from "@radix-ui/react-icons";
-import { lazy, Suspense, useEffect, useRef, useState } from "react";
+import { useEffect, useRef, useState } from "react";
 import type { Chain } from "../../../../chains/types.js";
 import type { ThirdwebClient } from "../../../../client/client.js";
 import type { InjectedSupportedWalletIds } from "../../../../wallets/__generated__/wallet-ids.js";
@@ -18,7 +18,7 @@ import {
 } from "../../../core/design-system/index.js";
 import { useSetSelectionData } from "../../providers/wallet-ui-states-provider.js";
 import { sortWallets } from "../../utils/sortWallets.js";
-import { LoadingScreen } from "../../wallets/shared/LoadingScreen.js";
+import InAppWalletSelectionUI from "../../wallets/in-app/InAppWalletSelectionUI.js";
 import {
   Container,
   Line,
@@ -43,10 +43,6 @@ import { PoweredByThirdweb } from "./PoweredByTW.js";
 import { WalletButtonEl, WalletEntryButton } from "./WalletEntryButton.js";
 import { WalletTypeRowButton } from "./WalletTypeRowButton.js";
 
-const InAppWalletSelectionUI = /* @__PURE__ */ lazy(
-  () => import("../../wallets/in-app/InAppWalletSelectionUI.js"),
-);
-
 // const localWalletId = "local";
 const inAppWalletId: WalletId = "inApp";
 
@@ -202,7 +198,7 @@ const WalletSelectorInner: React.FC<WalletSelectorProps> = (props) => {
       title={props.modalHeader.title}
     />
   ) : (
-    <Container center="y" flex="row" gap="xxs">
+    <Container center="y" flex="row" gap="xs" className="tw-header">
       {!props.meta.titleIconUrl ? null : (
         <Img
           client={props.client}
@@ -222,6 +218,7 @@ const WalletSelectorInner: React.FC<WalletSelectorProps> = (props) => {
 
   const connectAWallet = (
     <WalletTypeRowButton
+      className="tw-select-connect-a-wallet-button"
       client={props.client}
       disabled={props.meta.requireApproval && !approvedTOS}
       icon={OutlineWalletIcon}
@@ -234,6 +231,7 @@ const WalletSelectorInner: React.FC<WalletSelectorProps> = (props) => {
 
   const newToWallets = (
     <Container
+      className="tw-get-started-container"
       flex="row"
       style={{
         justifyContent: "space-between",
@@ -489,6 +487,7 @@ const WalletSelectorInner: React.FC<WalletSelectorProps> = (props) => {
   return (
     <Container
       animate="fadein"
+      className="tw-wallet-selection"
       flex="column"
       fullHeight
       scrollY
@@ -620,22 +619,21 @@ const WalletSelection: React.FC<{
             // data-full-width={!!walletConfig.selectUI}
           >
             {wallet.id === "inApp" && props.size === "compact" ? (
-              <Suspense fallback={<LoadingScreen height="195px" />}>
-                <InAppWalletSelectionUI
-                  chain={props.chain}
-                  client={props.client}
-                  connectLocale={props.connectLocale}
-                  disabled={props.disabled}
-                  done={() => props.done(wallet)}
-                  goBack={props.goBack}
-                  recommendedWallets={props.recommendedWallets}
-                  select={() => props.selectWallet(wallet)}
-                  size={props.size}
-                  wallet={wallet as Wallet<"inApp">}
-                />
-              </Suspense>
+              <InAppWalletSelectionUI
+                chain={props.chain}
+                client={props.client}
+                connectLocale={props.connectLocale}
+                disabled={props.disabled}
+                done={() => props.done(wallet)}
+                goBack={props.goBack}
+                recommendedWallets={props.recommendedWallets}
+                select={() => props.selectWallet(wallet)}
+                size={props.size}
+                wallet={wallet as Wallet<"inApp">}
+              />
             ) : (
               <WalletEntryButton
+                className="tw-wallet-select-wallet-button"
                 badge={undefined}
                 client={props.client}
                 connectLocale={props.connectLocale}
@@ -655,7 +653,7 @@ const WalletSelection: React.FC<{
       })}
 
       {props.onShowAll && props.showAllWallets !== false && (
-        <ButtonContainer>
+        <ButtonContainer className="tw-show-all-wallets-button">
           <WalletButtonEl onClick={props.onShowAll}>
             <ShowAllWalletsIcon>
               <div data-dot />

package/src/react/web/ui/ConnectWallet/WalletTypeRowButton.tsx

@@ -11,12 +11,14 @@ type WalletTypeRowProps = {
   title: string;
   icon: IconFC;
   disabled?: boolean;
+  className?: string;
 };
 
 export function WalletTypeRowButton(props: WalletTypeRowProps) {
   return (
     <Button
       disabled={props.disabled}
+      className={props.className}
       fullWidth
       onClick={() => {
         props.onClick();