thirdweb 5.31.1 → 5.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thirdweb",
-  "version": "5.31.1",
+  "version": "5.32.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/thirdweb-dev/js.git#main"
@@ -204,21 +204,24 @@
     "mipd": "0.0.7",
     "node-libs-browser": "2.2.1",
     "uqr": "0.1.2",
-    "viem": "2.16.4"
+    "viem": "2.16.5"
   },
   "peerDependencies": {
     "@aws-sdk/client-lambda": "^3",
     "@aws-sdk/credential-providers": "^3",
     "@coinbase/wallet-mobile-sdk": "^1",
     "@react-native-async-storage/async-storage": "^1",
+    "@react-native-clipboard/clipboard": "^1",
     "amazon-cognito-identity-js": "^6",
     "aws-amplify": "^5",
     "ethers": "^5 || ^6",
+    "expo-linking": "^6",
     "expo-web-browser": "^13",
     "react": ">=18",
     "react-native": ">=0.70",
     "react-native-aes-gcm-crypto": "^0.2",
     "react-native-quick-crypto": ">=0.7.0-rc.6 || >=0.7",
+    "react-native-svg": "^15",
     "typescript": ">=5.0.4"
   },
   "peerDependenciesMeta": {
@@ -237,12 +240,18 @@
     "react-native-aes-gcm-crypto": {
       "optional": true
     },
+    "expo-linking": {
+      "optional": true
+    },
     "expo-web-browser": {
       "optional": true
     },
     "react-native-quick-crypto": {
       "optional": true
     },
+    "react-native-svg": {
+      "optional": true
+    },
     "aws-amplify": {
       "optional": true
     },
@@ -258,6 +267,9 @@
     "@react-native-async-storage/async-storage": {
       "optional": true
     },
+    "@react-native-clipboard/clipboard": {
+      "optional": true
+    },
     "@coinbase/wallet-mobile-sdk": {
       "optional": true
     }
@@ -270,6 +282,7 @@
     "@aws-sdk/credential-providers": "3.577.0",
     "@coinbase/wallet-mobile-sdk": "1.0.13",
     "@react-native-async-storage/async-storage": "^1.23.1",
+    "@react-native-clipboard/clipboard": "1.14.1",
     "@testing-library/jest-dom": "^6.4.6",
     "@testing-library/react": "^16.0.0",
     "@testing-library/user-event": "^14.5.2",
@@ -280,12 +293,15 @@
     "amazon-cognito-identity-js": "6.3.12",
     "aws-amplify": "5.3.18",
     "cross-spawn": "7.0.3",
+    "expo-linking": "6.3.1",
     "expo-web-browser": "13.0.3",
     "happy-dom": "^14.12.0",
     "react-native": "0.74.2",
     "react-native-aes-gcm-crypto": "0.2.2",
     "react-native-quick-crypto": "0.7.0-rc.6",
-    "vitest": "1.6.0"
+    "react-native-svg": "15.3.0",
+    "vitest": "1.6.0",
+    "typescript": "5.5.2"
   },
   "scripts": {
     "bench:compare": "bun run ./benchmarks/run.ts",

package/src/exports/react.native.ts

@@ -1,5 +1,12 @@
 export { ThirdwebProvider } from "../react/core/providers/thirdweb-provider.js";
 
+// theme
+export { darkTheme, lightTheme } from "../react/core/design-system/index.js";
+export type {
+  Theme,
+  ThemeOverrides,
+} from "../react/core/design-system/index.js";
+
 // wallet hooks
 export { useActiveWallet } from "../react/native/hooks/wallets/useActiveWallet.js";
 export { useActiveWalletChain } from "../react/native/hooks/wallets/useActiveWalletChain.js";
@@ -77,11 +84,18 @@ export {
 export { AutoConnect } from "../react/native/ui/AutoConnect/AutoConnect.js";
 export type { AutoConnectProps } from "../react/core/hooks/connection/types.js";
 
-export { TransactionButton } from "../react/native/ui/TransactionButton/TrabsactionButton.js";
+export { TransactionButton } from "../react/native/ui/transaction/TransactionButton.js";
 export type { TransactionButtonProps } from "../react/core/hooks/transaction/transaction-button-utils.js";
 
+export type {
+  ConnectButtonProps,
+  ConnectButton_connectButtonOptions,
+  ConnectButton_connectModalOptions,
+  ConnectButton_detailsButtonOptions,
+  ConnectButton_detailsModalOptions,
+} from "../react/core/hooks/connection/ConnectButtonProps.js";
+export { ConnectButton } from "../react/native/ui/connect/ConnectButton.js";
+export { ConnectEmbed } from "../react/native/ui/connect/ConnectModal.js";
+
 // wallet info
-export {
-  useWalletInfo,
-  useWalletImage,
-} from "../react/web/ui/hooks/useWalletInfo.js";
+export { useWalletInfo, useWalletImage } from "../react/core/utils/wallet.js";

package/src/exports/react.ts

@@ -5,10 +5,8 @@ export type {
 } from "../react/core/design-system/index.js";
 
 export { ConnectButton } from "../react/web/ui/ConnectWallet/ConnectButton.js";
-export {
-  ConnectEmbed,
-  type ConnectEmbedProps,
-} from "../react/web/ui/ConnectWallet/Modal/ConnectEmbed.js";
+export { ConnectEmbed } from "../react/web/ui/ConnectWallet/Modal/ConnectEmbed.js";
+export { type ConnectEmbedProps } from "../react/core/hooks/connection/ConnectEmbedProps.js";
 
 export type {
   ConnectButtonProps,
@@ -16,7 +14,7 @@ export type {
   ConnectButton_connectModalOptions,
   ConnectButton_detailsButtonOptions,
   ConnectButton_detailsModalOptions,
-} from "../react/web/ui/ConnectWallet/ConnectButtonProps.js";
+} from "../react/core/hooks/connection/ConnectButtonProps.js";
 export type { NetworkSelectorProps } from "../react/web/ui/ConnectWallet/NetworkSelector.js";
 export type { WelcomeScreen } from "../react/web/ui/ConnectWallet/screens/types.js";
 export type { LocaleId } from "../react/web/ui/types.js";
@@ -30,8 +28,8 @@ export { ThirdwebProvider } from "../react/core/providers/thirdweb-provider.js";
 export type {
   SupportedTokens,
   TokenInfo,
-} from "../react/web/ui/ConnectWallet/defaultTokens.js";
-export { defaultTokens } from "../react/web/ui/ConnectWallet/defaultTokens.js";
+} from "../react/core/utils/defaultTokens.js";
+export { defaultTokens } from "../react/core/utils/defaultTokens.js";
 
 // Media Renderer
 export { MediaRenderer } from "../react/web/ui/MediaRenderer/MediaRenderer.js";
@@ -123,7 +121,7 @@ export {
   type PayEmbedProps,
   type PayEmbedConnectOptions,
 } from "../react/web/ui/PayEmbed.js";
-export type { PayUIOptions } from "../react/web/ui/ConnectWallet/ConnectButtonProps.js";
+export type { PayUIOptions } from "../react/core/hooks/connection/ConnectButtonProps.js";
 
 export {
   useConnectModal,
@@ -131,10 +129,7 @@ export {
 } from "../react/web/ui/ConnectWallet/useConnectModal.js";
 
 // wallet info
-export {
-  useWalletInfo,
-  useWalletImage,
-} from "../react/web/ui/hooks/useWalletInfo.js";
+export { useWalletInfo, useWalletImage } from "../react/core/utils/wallet.js";
 
 export {
   useWalletDetailsModal,

package/src/exports/wallets/in-app.ts

@@ -13,4 +13,4 @@ export { type GetAuthenticatedUserParams } from "../../wallets/in-app/core/authe
 
 export { hasStoredPasskey } from "../../wallets/in-app/web/lib/auth/passkeys.js";
 
-export { socialIcons } from "../../react/web/wallets/in-app/socialIcons.js";
+export { socialIcons } from "../../react/core/utils/socialIcons.js";

package/src/pay/utils/definitions.ts

@@ -1,59 +1,66 @@
 import { getThirdwebDomains } from "../../utils/domains.js";
 
+export const getPayBaseUrl = () => {
+  const payDomain: string = getThirdwebDomains().pay;
+  return payDomain.startsWith("localhost")
+    ? `http://${payDomain}`
+    : `https://${payDomain}`;
+};
+
 /**
  * Endpoint to get the status of a "Buy with Crypto" quote.
  * @internal
  */
 export const getPayBuyWithCryptoStatusUrl = () =>
-  `https://${getThirdwebDomains().pay}/buy-with-crypto/status/v1`;
+  `${getPayBaseUrl()}/buy-with-crypto/status/v1`;
 /**
  * Endpoint to get "Buy with Crypto" quote.
  * @internal
  */
 export const getPayBuyWithCryptoQuoteEndpoint = () =>
-  `https://${getThirdwebDomains().pay}/buy-with-crypto/quote/v1`;
+  `${getPayBaseUrl()}/buy-with-crypto/quote/v1`;
 
 /**
  * Endpoint to get a "Buy with Fiat" quote.
  * @internal
  */
 export const getPayBuyWithFiatQuoteEndpoint = () =>
-  `https://${getThirdwebDomains().pay}/buy-with-fiat/quote/v1`;
+  `${getPayBaseUrl()}/buy-with-fiat/quote/v1`;
 
 /**
  * Endpoint to get the status of a "Buy with Fiat" transaction status.
  * @internal
  */
 export const getPayBuyWithFiatStatusEndpoint = () =>
-  `https://${getThirdwebDomains().pay}/buy-with-fiat/status/v1`;
+  `${getPayBaseUrl()}/buy-with-fiat/status/v1`;
 
 /**
  * Endpoint to get history of "Buy with Fiat" transactions for given wallet address.
  * @internal
  */
 export const getPayBuyWithFiatHistoryEndpoint = () =>
-  `https://${getThirdwebDomains().pay}/buy-with-fiat/history/v1`;
+  `${getPayBaseUrl()}/buy-with-fiat/history/v1`;
 
 /**
  * Endpoint to get a "Buy with Crypto" transaction history for a given wallet address.
  * @internal
  */
 export const getPayBuyWithCryptoHistoryEndpoint = () =>
-  `https://${getThirdwebDomains().pay}/buy-with-crypto/history/v1`;
+  `${getPayBaseUrl()}/buy-with-crypto/history/v1`;
 
 /**
  * Endpoint to get a list of supported destination chains and tokens for thirdweb pay.
  * @internal
  */
 export const getPaySupportedDestinations = () =>
-  `https://${getThirdwebDomains().pay}/destination-tokens/v1`;
+  `${getPayBaseUrl()}/destination-tokens/v1`;
 
 /**
  * Endpoint to get a list of supported source chains + tokens for thirdweb pay.
  * @internal
  */
 export const getPaySupportedSources = () =>
-  `https://${getThirdwebDomains().pay}/buy-with-crypto/source-tokens/v1`;
+  `${getPayBaseUrl()}/buy-with-crypto/source-tokens/v1`;
 
 /**
  * Endpoint to get buy history for a given wallet address.
@@ -61,4 +68,4 @@ export const getPaySupportedSources = () =>
  * @internal
  */
 export const getPayBuyHistoryEndpoint = () =>
-  `https://${getThirdwebDomains().pay}/wallet/history/v1`;
+  `${getPayBaseUrl()}/wallet/history/v1`;

package/src/react/{web/ui/ConnectWallet → core/hooks/connection}/ConnectButtonProps.ts

@@ -3,12 +3,12 @@ import type { ThirdwebClient } from "../../../../client/client.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 { Theme } from "../../../core/design-system/index.js";
-import type { SiweAuthOptions } from "../../../core/hooks/auth/useSiweAuth.js";
-import type { LocaleId } from "../types.js";
-import type { NetworkSelectorProps } from "./NetworkSelector.js";
-import type { SupportedTokens } from "./defaultTokens.js";
-import type { WelcomeScreen } from "./screens/types.js";
+import type { NetworkSelectorProps } from "../../../web/ui/ConnectWallet/NetworkSelector.js";
+import type { WelcomeScreen } from "../../../web/ui/ConnectWallet/screens/types.js";
+import type { LocaleId } from "../../../web/ui/types.js";
+import type { Theme } from "../../design-system/index.js";
+import type { SupportedTokens } from "../../utils/defaultTokens.js";
+import type { SiweAuthOptions } from "../auth/useSiweAuth.js";
 
 export type PayUIOptions = {
   /**
@@ -699,10 +699,7 @@ export type ConnectButtonProps = {
    * />
    * ```
    */
-  onDisconnect?: (info: {
-    wallet: Wallet;
-    account: Account;
-  }) => void;
+  onDisconnect?: (info: { wallet: Wallet; account: Account }) => void;
 
   /**
    * Configure options for WalletConnect

package/src/react/core/hooks/connection/ConnectEmbedProps.ts

@@ -0,0 +1,285 @@
+import type { Chain } from "../../../../chains/types.js";
+import type { ThirdwebClient } from "../../../../client/client.js";
+import type { Wallet } from "../../../../wallets/interfaces/wallet.js";
+import type { SmartWalletOptions } from "../../../../wallets/smart/types.js";
+import type { AppMetadata } from "../../../../wallets/types.js";
+import type { LocaleId } from "../../../web/ui/types.js";
+import type { Theme } from "../../design-system/index.js";
+import type { SiweAuthOptions } from "../auth/useSiweAuth.js";
+
+export type ConnectEmbedProps = {
+  /**
+   * A client is the entry point to the thirdweb SDK.
+   * It is required for all other actions.
+   * You can create a client using the `createThirdwebClient` function. Refer to the [Creating a Client](https://portal.thirdweb.com/typescript/v5/client) documentation for more information.
+   *
+   * You must provide a `clientId` or `secretKey` in order to initialize a client. Pass `clientId` if you want for client-side usage and `secretKey` for server-side usage.
+   *
+   * ```tsx
+   * import { createThirdwebClient } from "thirdweb";
+   *
+   * const client = createThirdwebClient({
+   *  clientId: "<your_client_id>",
+   * })
+   * ```
+   */
+  client: ThirdwebClient;
+
+  /**
+   * Metadata of the app that will be passed to connected wallet. Setting this is highly recommended.
+   *
+   * Some wallets display this information to the user when they connect to your app.
+   * @example
+   * ```ts
+   * {
+   *   name: "My App",
+   *   url: "https://my-app.com",
+   *   description: "some description about your app",
+   *   logoUrl: "https://path/to/my-app/logo.svg",
+   * };
+   * ```
+   */
+  appMetadata?: AppMetadata;
+
+  /**
+   * By default - ConnectEmbed UI uses the `en-US` locale for english language users.
+   *
+   * You can customize the language used in the ConnectEmbed UI by setting the `locale` prop.
+   *
+   * Refer to the [`LocaleId`](https://portal.thirdweb.com/references/typescript/v5/LocaleId) type for supported locales.
+   */
+  locale?: LocaleId;
+
+  /**
+   * Array of supported wallets. If not provided, default wallets will be used.
+   * @example
+   * ```tsx
+   * import { AutoConnect } from "thirdweb/react";
+   * import { createWallet, inAppWallet } from "thirdweb/wallets";
+   *
+   * const wallets = [
+   *   inAppWallet(),
+   *   createWallet("io.metamask"),
+   *   createWallet("com.coinbase.wallet"),
+   *   createWallet("me.rainbow"),
+   * ];
+   *
+   * function Example() {
+   *  return (
+   *    <ConnectEmbed
+   *      client={client}
+   *      wallets={wallets}
+   *    />
+   *  )
+   * }
+   * ```
+   *
+   * If no wallets are specified. The component will show All the EIP-6963 compliant installed wallet extensions, as well as below default wallets:
+   *
+   * ```tsx
+   * const defaultWallets = [
+   *  inAppWallet(),
+   *  createWallet("io.metamask"),
+   *  createWallet("com.coinbase.wallet"),
+   *  createWallet("me.rainbow"),
+   *  createWallet("io.zerion.wallet"),
+   * ]
+   * ```
+   *
+   * The `ConnectEmbed` also shows a "All wallets" button at the end of wallet list which allows user to connect to any of the 350+ wallets
+   */
+  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.
+   * ```tsx
+   * <ConnectEmbed client={client} autoConnect={{ timeout: 10000 }} />
+   * ```
+   */
+  autoConnect?:
+    | {
+        timeout: number;
+      }
+    | boolean;
+
+  /**
+   * 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.
+   *
+   * 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.
+   * @example
+   * ```tsx
+   * import { polygon } from "thirdweb/chains";
+   *
+   * function Example() {
+   *  return <div> <ConnectEmbed chain={polygon} /> </div>
+   * }
+   * ```
+   */
+  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 `ConnectEmbed`'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
+   *
+   * ```tsx
+   * <ConnectEmbed chains={[ethereum, polygon, optimism]} />
+   * ```
+   *
+   * 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[];
+
+  /**
+   * Class name to be added to the root element of ConnectEmbed
+   */
+  className?: string;
+
+  /**
+   * Set the theme for the `ConnectEmbed` component. By default it is set to `"dark"`
+   *
+   * theme can be set to either `"dark"`, `"light"` or a custom theme object.
+   * You can also import [`lightTheme`](https://portal.thirdweb.com/references/typescript/v5/lightTheme)
+   * or [`darkTheme`](https://portal.thirdweb.com/references/typescript/v5/darkTheme)
+   * functions from `thirdweb/react` to use the default themes as base and overrides parts of it.
+   * @example
+   * ```ts
+   * import { lightTheme } from "thirdweb/react";
+   *
+   * const customTheme = lightTheme({
+   *  colors: {
+   *    modalBg: 'red'
+   *  }
+   * })
+   *
+   * function Example() {
+   *  return <ConnectEmbed theme={customTheme} />
+   * }
+   * ```
+   */
+  theme?: "dark" | "light" | Theme;
+
+  /**
+   * CSS styles to be applied to the root element of ConnectEmbed
+   */
+  style?: React.CSSProperties;
+
+  /**
+   * If provided, Embed will show a Terms of Service message at the bottom with below link
+   */
+  termsOfServiceUrl?: string;
+
+  /**
+   * If provided, Embed will show a Privacy Policy message at the bottom with below link
+   */
+  privacyPolicyUrl?: string;
+
+  /**
+   * Callback to be called on successful connection of wallet - including auto-connect.
+   * The callback is called with the connected wallet
+   *
+   * ```tsx
+   * <ConnectEmbed
+   *  onConnect={(wallet) => {
+   *    console.log("connected to", wallet)
+   *  }}
+   * />
+   * ```
+   * ```
+   */
+  onConnect?: (wallet: Wallet) => void;
+
+  /**
+   * By default, A "Powered by Thirdweb" branding is shown at the bottom of the embed.
+   *
+   * If you want to hide it, set this to `false`
+   * @example
+   * ```tsx
+   * <ConnectEmbed showThirdwebBranding={false} />
+   * ```
+   */
+  showThirdwebBranding?: boolean;
+
+  /**
+   * 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.
+   *
+   * ```tsx
+   * <ConnectEmbed
+   *   accountAbstraction={{
+   *    factoryAddress: "0x123...",
+   *    chain: sepolia,
+   *    gasless: true;
+   *   }}
+   * />
+   */
+  accountAbstraction?: SmartWalletOptions;
+
+  /**
+   * Wallets to show as recommended in the `ConnectEmbed` UI
+   */
+  recommendedWallets?: Wallet[];
+
+  /**
+   * By default, `ConnectEmbed` shows a "All Wallets" button that shows a list of 350+ wallets.
+   *
+   * You can disable this button by setting `showAllWallets` prop to `false`
+   */
+  showAllWallets?: boolean;
+
+  /**
+   * ConnectEmbed supports two modal size variants: `compact` and `wide`.
+   *
+   * By default it is set to `compact`, you can set it to `wide` if you want to show a wider modal.
+   *
+   * Note that if the screen width can not fit the wide modal, the `compact` version will be shown regardless of this `modalSize` options provided
+   */
+  modalSize?: "compact" | "wide";
+
+  /**
+   * 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;
+};

package/src/react/core/hooks/connection/types.ts

@@ -28,7 +28,7 @@ export type AutoConnectProps = {
    * }
    * ```
    */
-  wallets: Wallet[];
+  wallets?: Wallet[];
 
   /**
    * A client is the entry point to the thirdweb SDK.

package/src/react/core/hooks/transaction/useSendTransaction.ts

@@ -11,10 +11,10 @@ import {
   type GetWalletBalanceResult,
   getWalletBalance,
 } from "../../../../wallets/utils/getWalletBalance.js";
-import type { SupportedTokens } from "../../../web/ui/ConnectWallet/defaultTokens.js";
 import { fetchBuySupportedDestinations } from "../../../web/ui/ConnectWallet/screens/Buy/swap/useSwapSupportedChains.js";
 import type { LocaleId } from "../../../web/ui/types.js";
 import type { Theme } from "../../design-system/index.js";
+import type { SupportedTokens } from "../../utils/defaultTokens.js";
 
 /**
  * Configuration for the "Pay Modal" that opens when the user doesn't have enough funds to send a transaction.

package/src/react/core/hooks/wallets/useAutoConnect.ts

@@ -15,7 +15,7 @@ import { useSetActiveWalletConnectionStatusCore } from "./useSetActiveWalletConn
 export function useAutoConnectCore(
   manager: ConnectionManager,
   storage: AsyncStorage,
-  props: AutoConnectProps,
+  props: AutoConnectProps & { wallets: Wallet[] },
   getInstalledWallets?: () => Wallet[],
 ) {
   const setConnectionStatus = useSetActiveWalletConnectionStatusCore(manager);