thirdweb 5.100.2-nightly-88533d9113dc07c97cfaf0162591477c7056e69b-20250522000412 → 5.100.2

package/src/engine/server-wallet.ts

@@ -144,13 +144,14 @@ export function serverWallet(options: ServerWalletOptions): ServerWallet {
 
     const result = await sendTransaction({
       baseUrl: getThirdwebBaseUrl("engineCloud"),
+      bodySerializer: stringify,
       fetch: getClientFetch(client),
       headers,
       body,
     });
 
     if (result.error) {
-      throw new Error(`Error sending transaction: ${result.error}`);
+      throw new Error(`Error sending transaction: ${stringify(result.error)}`);
     }
 
     const data = result.data?.result;
@@ -220,6 +221,7 @@ export function serverWallet(options: ServerWalletOptions): ServerWallet {
 
       const signResult = await signMessage({
         baseUrl: getThirdwebBaseUrl("engineCloud"),
+        bodySerializer: stringify,
         fetch: getClientFetch(client),
         headers,
         body: {
@@ -256,6 +258,7 @@ export function serverWallet(options: ServerWalletOptions): ServerWallet {
 
       const signResult = await signTypedData({
         baseUrl: getThirdwebBaseUrl("engineCloud"),
+        bodySerializer: stringify,
         fetch: getClientFetch(client),
         headers,
         body: {

package/src/exports/react.native.ts

@@ -9,10 +9,11 @@ export type {
 
 // wallet hooks
 export { useActiveWallet } from "../react/core/hooks/wallets/useActiveWallet.js";
-export { useAdminWallet } from "../react/core/hooks/wallets/useAdminWallet.js";
 export { useActiveWalletChain } from "../react/core/hooks/wallets/useActiveWalletChain.js";
 export { useActiveWalletConnectionStatus } from "../react/core/hooks/wallets/useActiveWalletConnectionStatus.js";
 export { useActiveAccount } from "../react/core/hooks/wallets/useActiveAccount.js";
+export { useAdminWallet } from "../react/core/hooks/wallets/useAdminWallet.js";
+export { useAuthToken } from "../react/core/hooks/wallets/useAuthToken.js";
 export { useAutoConnect } from "../react/native/hooks/wallets/useAutoConnect.js";
 export { useConnect } from "../react/core/hooks/wallets/useConnect.js";
 export { useConnectedWallets } from "../react/core/hooks/wallets/useConnectedWallets.js";

package/src/exports/react.ts

@@ -40,10 +40,11 @@ export type { MediaRendererProps } from "../react/web/ui/MediaRenderer/types.js"
 
 // wallet hooks
 export { useActiveWallet } from "../react/core/hooks/wallets/useActiveWallet.js";
-export { useAdminWallet } from "../react/core/hooks/wallets/useAdminWallet.js";
 export { useActiveWalletChain } from "../react/core/hooks/wallets/useActiveWalletChain.js";
 export { useActiveWalletConnectionStatus } from "../react/core/hooks/wallets/useActiveWalletConnectionStatus.js";
 export { useActiveAccount } from "../react/core/hooks/wallets/useActiveAccount.js";
+export { useAdminWallet } from "../react/core/hooks/wallets/useAdminWallet.js";
+export { useAuthToken } from "../react/core/hooks/wallets/useAuthToken.js";
 export { useAutoConnect } from "../react/web/hooks/wallets/useAutoConnect.js";
 export { useConnect } from "../react/core/hooks/wallets/useConnect.js";
 export { useConnectedWallets } from "../react/core/hooks/wallets/useConnectedWallets.js";

package/src/pay/buyWithCrypto/getQuote.ts

@@ -83,6 +83,11 @@ export type GetBuyWithCryptoQuoteParams = {
    * For example, if you want to allow a maximum slippage of 0.5%, you should specify `50` bps.
    */
   maxSlippageBPS?: number;
+
+  /**
+   * @hidden
+   */
+  paymentLinkId?: string;
 } & (
   | {
       /**
@@ -203,6 +208,7 @@ export async function getBuyWithCryptoQuote(
           amount: amount,
           purchaseData: params.purchaseData,
           client: params.client,
+          paymentLinkId: params.paymentLinkId,
         });
       } else if (params.fromAmount) {
         const originTokenContract = getContract({
@@ -224,6 +230,7 @@ export async function getBuyWithCryptoQuote(
           amount: amount,
           purchaseData: params.purchaseData,
           client: params.client,
+          paymentLinkId: params.paymentLinkId,
         });
       }
       throw new Error(

package/src/pay/buyWithCrypto/getTransfer.ts

@@ -60,6 +60,11 @@ export type GetBuyWithCryptoTransferParams = {
    * For direct transfers, specify who will pay for the transfer fee. Can be "sender" or "receiver".
    */
   feePayer?: "sender" | "receiver";
+
+  /**
+   * @hidden
+   */
+  paymentLinkId?: string;
 };
 
 /**
@@ -127,6 +132,7 @@ export async function getBuyWithCryptoTransfer(
       receiver: params.toAddress,
       client: params.client,
       feePayer: params.feePayer,
+      paymentLinkId: params.paymentLinkId,
     });
 
     const firstStep = quote.steps[0];

package/src/pay/buyWithFiat/getPostOnRampQuote.ts

@@ -21,6 +21,11 @@ export type GetPostOnRampQuoteParams = {
    * The "Buy with fiat" transaction status object returned by [`getBuyWithFiatStatus`](https://portal.thirdweb.com/typescript/v5/getBuyWithFiatStatus) function
    */
   buyWithFiatStatus: BuyWithFiatStatus;
+
+  /**
+   * @hidden
+   */
+  paymentLinkId?: string;
 };
 
 /**
@@ -61,6 +66,7 @@ export type GetPostOnRampQuoteParams = {
 export async function getPostOnRampQuote({
   client,
   buyWithFiatStatus,
+  paymentLinkId,
 }: GetPostOnRampQuoteParams): Promise<BuyWithCryptoQuote> {
   if (buyWithFiatStatus.status === "NOT_FOUND") {
     throw new Error("Invalid buyWithFiatStatus");
@@ -77,5 +83,6 @@ export async function getPostOnRampQuote({
     toChainId: buyWithFiatStatus.quote.toToken.chainId,
     toTokenAddress: buyWithFiatStatus.quote.toToken.tokenAddress,
     toAmount: buyWithFiatStatus.quote.estimatedToTokenAmount,
+    paymentLinkId: paymentLinkId,
   });
 }

package/src/pay/buyWithFiat/getQuote.ts

@@ -95,6 +95,11 @@ export type GetBuyWithFiatQuoteParams = {
    * By default, we choose a recommended provider based on the location of the user, KYC status, and currency.
    */
   preferredProvider?: FiatProvider;
+
+  /**
+   * @hidden
+   */
+  paymentLinkId?: string;
 };
 
 /**
@@ -321,6 +326,7 @@ export async function getBuyWithFiatQuote(
       currency: params.fromCurrencySymbol,
       maxSteps: 2,
       onrampTokenAddress: NATIVE_TOKEN_ADDRESS, // force onramp to native token to avoid missing gas issues
+      paymentLinkId: params.paymentLinkId,
     });
 
     // Determine tokens based on steps rules

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

@@ -98,6 +98,7 @@ export type PayUIOptions = Prettify<
             currency?: CurrencyMeta["shorthand"];
           };
           preferredProvider?: FiatProvider;
+          supportedProviders?: FiatProvider[];
         }
       | false;
 

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

@@ -0,0 +1,41 @@
+import { useActiveAccount } from "./useActiveAccount.js";
+import { useActiveWallet } from "./useActiveWallet.js";
+
+/**
+ * A hook that returns the authentication token (JWT) for the currently active wallet.
+ * This token can be used to authorize API calls to your backend server.
+ *
+ * @returns The JWT string if the active wallet is an in-app wallet and matches the active account, null otherwise
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const authToken = useAuthToken();
+ *
+ *   const fetchData = async () => {
+ *     const response = await fetch('https://api.example.com/data', {
+ *       headers: {
+ *         'Authorization': `Bearer ${authToken}`
+ *       }
+ *     });
+ *     // ... handle response
+ *   };
+ * }
+ * ```
+ *
+ * @wallet
+ */
+export function useAuthToken() {
+  const activeWallet = useActiveWallet();
+  const activeAccount = useActiveAccount();
+  // if the active wallet is an in-app wallet and the active account is the same as the active wallet's account, return the auth token for the in-app wallet
+  if (
+    activeWallet?.getAuthToken &&
+    activeAccount &&
+    activeAccount.address === activeWallet.getAccount()?.address
+  ) {
+    return activeWallet.getAuthToken();
+  }
+  // all other wallets don't expose an auth token for now
+  return null;
+}

package/src/react/web/ui/ConnectWallet/screens/Buy/BuyScreen.tsx

@@ -83,6 +83,7 @@ export type BuyScreenProps = {
   connectOptions: PayEmbedConnectOptions | undefined;
   hiddenWallets?: WalletId[];
   isEmbed: boolean;
+  paymentLinkId?: string;
 };
 
 /**
@@ -151,6 +152,7 @@ type BuyScreenContentProps = {
   hiddenWallets?: WalletId[];
   connectOptions: PayEmbedConnectOptions | undefined;
   isEmbed: boolean;
+  paymentLinkId?: string;
 };
 
 /**
@@ -347,6 +349,7 @@ function BuyScreenContent(props: BuyScreenContentProps) {
       <OnRampScreen
         title={props.title}
         transactionMode={payOptions.mode === "transaction"}
+        paymentLinkId={props.paymentLinkId}
         quote={screen.quote}
         onBack={() => {
           setScreen({
@@ -395,6 +398,7 @@ function BuyScreenContent(props: BuyScreenContentProps) {
           });
         }}
         onSuccess={onSwapSuccess}
+        paymentLinkId={props.paymentLinkId}
       />
     );
   }
@@ -530,6 +534,7 @@ function BuyScreenContent(props: BuyScreenContentProps) {
               {screen.id === "buy-with-crypto" && activeAccount && (
                 <SwapScreenContent
                   setScreen={setScreen}
+                  paymentLinkId={props.paymentLinkId}
                   tokenAmount={deferredTokenAmount}
                   toChain={toChain}
                   toToken={toToken}
@@ -585,6 +590,7 @@ function BuyScreenContent(props: BuyScreenContentProps) {
                   payer={payer}
                   setTokenAmount={setTokenAmount}
                   setHasEditedAmount={setHasEditedAmount}
+                  paymentLinkId={props.paymentLinkId}
                 />
               )}
 

package/src/react/web/ui/ConnectWallet/screens/Buy/PayProviderSelection.tsx

@@ -0,0 +1,68 @@
+import { ChevronDownIcon } from "@radix-ui/react-icons";
+import type { FiatProvider } from "../../../../../../pay/utils/commonTypes.js";
+import { iconSize, spacing } from "../../../../../core/design-system/index.js";
+import { Container } from "../../../components/basic.js";
+import { Button } from "../../../components/buttons.js";
+import { Text } from "../../../components/text.js";
+import { getProviderLabel } from "./utils.js";
+
+/**
+ * Shows the selected payment provider based on the preferred provider OR the quoted provider.
+ * @internal
+ */
+export const PayProviderSelection = (props: {
+  onShowProviders: () => void;
+  quotedProvider?: FiatProvider;
+  preferredProvider?: FiatProvider;
+  supportedProviders: FiatProvider[];
+}) => {
+  const ProviderItem = (
+    <Container
+      flex="row"
+      center="y"
+      gap="xxs"
+      color="secondaryText"
+      style={{ padding: spacing.md }}
+    >
+      <Text size="xs">
+        {getProviderLabel(
+          props.preferredProvider ?? props.quotedProvider ?? "",
+        )}
+      </Text>
+      {props.supportedProviders.length > 1 && (
+        <ChevronDownIcon width={iconSize.sm} height={iconSize.sm} />
+      )}
+    </Container>
+  );
+
+  return (
+    <Container
+      bg="tertiaryBg"
+      flex="row"
+      borderColor="borderColor"
+      style={{
+        paddingLeft: spacing.md,
+        justifyContent: "space-between",
+        alignItems: "center",
+        borderWidth: "1px",
+        borderStyle: "solid",
+        borderBottom: "none",
+      }}
+    >
+      <Text size="xs" color="secondaryText">
+        Provider
+      </Text>
+      {props.supportedProviders.length > 1 ? (
+        <Button
+          variant="ghost"
+          onClick={props.onShowProviders}
+          style={{ padding: 0 }} // Padding is managed within children as the button is conditional
+        >
+          {ProviderItem}
+        </Button>
+      ) : (
+        ProviderItem
+      )}
+    </Container>
+  );
+};

package/src/react/web/ui/ConnectWallet/screens/Buy/PayWIthCreditCard.tsx

@@ -85,7 +85,7 @@ export function PayWithCreditCard(props: {
             {props.value
               ? `${props.currency.symbol}${formatNumber(
                   Number(props.value),
-                  6,
+                  2,
                 )}`
               : "--"}
           </Text>

package/src/react/web/ui/ConnectWallet/screens/Buy/fiat/FiatScreenContent.tsx

@@ -1,16 +1,13 @@
-import { ChevronDownIcon } from "@radix-ui/react-icons";
 import { useState } from "react";
 import { trackPayEvent } from "../../../../../../../analytics/track/pay.js";
 import type { Chain } from "../../../../../../../chains/types.js";
 import type { ThirdwebClient } from "../../../../../../../client/client.js";
 import { NATIVE_TOKEN_ADDRESS } from "../../../../../../../constants/addresses.js";
-import type { FiatProvider } from "../../../../../../../pay/utils/commonTypes.js";
-import { formatNumber } from "../../../../../../../utils/formatNumber.js";
 import {
-  type Theme,
-  iconSize,
-  spacing,
-} from "../../../../../../core/design-system/index.js";
+  type FiatProvider,
+  FiatProviders,
+} from "../../../../../../../pay/utils/commonTypes.js";
+import type { Theme } from "../../../../../../core/design-system/index.js";
 import type { PayUIOptions } from "../../../../../../core/hooks/connection/ConnectButtonProps.js";
 import { useBuyWithFiatQuote } from "../../../../../../core/hooks/pay/useBuyWithFiatQuote.js";
 import { PREFERRED_FIAT_PROVIDER_STORAGE_KEY } from "../../../../../../core/utils/storage.js";
@@ -25,9 +22,9 @@ import { Spinner } from "../../../../components/Spinner.js";
 import { Container } from "../../../../components/basic.js";
 import { Button } from "../../../../components/buttons.js";
 import { Text } from "../../../../components/text.js";
-import { TokenSymbol } from "../../../../components/token/TokenSymbol.js";
 import { type ERC20OrNativeToken, isNativeToken } from "../../nativeToken.js";
 import { EstimatedTimeAndFees } from "../EstimatedTimeAndFees.js";
+import { PayProviderSelection } from "../PayProviderSelection.js";
 import { PayWithCreditCard } from "../PayWIthCreditCard.js";
 import type { SelectedScreen } from "../main/types.js";
 import { FiatFees } from "../swap/Fees.js";
@@ -50,6 +47,7 @@ export function FiatScreenContent(props: {
   payer: PayerInfo;
   setTokenAmount: (amount: string) => void;
   setHasEditedAmount: (hasEdited: boolean) => void;
+  paymentLinkId: undefined | string;
 }) {
   const {
     toToken,
@@ -60,6 +58,7 @@ export function FiatScreenContent(props: {
     toChain,
     showCurrencySelector,
     selectedCurrency,
+    paymentLinkId,
   } = props;
   const defaultRecipientAddress = (
     props.payOptions as Extract<PayUIOptions, { mode: "direct_payment" }>
@@ -84,6 +83,19 @@ export function FiatScreenContent(props: {
       : undefined,
   );
 
+  const supportedProviders = (() => {
+    if (!buyWithFiatOptions) return [...FiatProviders];
+    const options = buyWithFiatOptions?.supportedProviders ?? [];
+    const optionsWithPreferred =
+      options.length > 0
+        ? new Set([
+            ...(preferredProvider ? [preferredProvider] : []),
+            ...options,
+          ])
+        : FiatProviders;
+    return Array.from(optionsWithPreferred);
+  })();
+
   const fiatQuoteQuery = useBuyWithFiatQuote(
     buyWithFiatOptions !== false && tokenAmount
       ? {
@@ -98,7 +110,8 @@ export function FiatScreenContent(props: {
           isTestMode: buyWithFiatOptions?.testMode,
           purchaseData: props.payOptions.purchaseData,
           fromAddress: payer.account.address,
-          preferredProvider: preferredProvider,
+          paymentLinkId: paymentLinkId,
+          preferredProvider: preferredProvider ?? supportedProviders[0],
         }
       : undefined,
   );
@@ -158,6 +171,7 @@ export function FiatScreenContent(props: {
                 </Text>
                 <Spacer y="lg" />
                 <Providers
+                  supportedProviders={supportedProviders}
                   preferredProvider={
                     preferredProvider || fiatQuoteQuery.data?.provider
                   }
@@ -187,35 +201,13 @@ export function FiatScreenContent(props: {
             currency={selectedCurrency}
             onSelectCurrency={showCurrencySelector}
           />
-          <Container
-            bg="tertiaryBg"
-            flex="row"
-            borderColor="borderColor"
-            style={{
-              paddingLeft: spacing.md,
-              justifyContent: "space-between",
-              alignItems: "center",
-              borderWidth: "1px",
-              borderStyle: "solid",
-              borderBottom: "none",
-            }}
-          >
-            <Text size="xs" color="secondaryText">
-              Provider
-            </Text>
-            <Button variant="ghost" onClick={showProviders}>
-              <Container flex="row" center="y" gap="xxs" color="secondaryText">
-                <Text size="xs">
-                  {preferredProvider
-                    ? `${preferredProvider.charAt(0).toUpperCase() + preferredProvider.slice(1).toLowerCase()}`
-                    : fiatQuoteQuery.data?.provider
-                      ? `${fiatQuoteQuery.data?.provider.charAt(0).toUpperCase() + fiatQuoteQuery.data?.provider.slice(1).toLowerCase()}`
-                      : ""}
-                </Text>
-                <ChevronDownIcon width={iconSize.sm} height={iconSize.sm} />
-              </Container>
-            </Button>
-          </Container>
+          {/** Shows preferred or quoted provider and conditional selection */}
+          <PayProviderSelection
+            onShowProviders={showProviders}
+            quotedProvider={fiatQuoteQuery.data?.provider}
+            preferredProvider={preferredProvider}
+            supportedProviders={supportedProviders}
+          />
           {/* Estimated time + View fees button */}
           <EstimatedTimeAndFees
             quoteIsLoading={fiatQuoteQuery.isLoading}
@@ -227,77 +219,43 @@ export function FiatScreenContent(props: {
         {/* Error message */}
         {errorMsg && (
           <div>
-            {errorMsg.data?.minimumAmountEth ? (
-              <Text color="danger" size="sm" center multiline>
-                Minimum amount is{" "}
-                {formatNumber(Number(errorMsg.data.minimumAmountEth), 6)}{" "}
-                <TokenSymbol
-                  token={toToken}
-                  chain={toChain}
-                  size="sm"
-                  inline
-                  color="danger"
-                />
-              </Text>
-            ) : (
-              <div>
-                <Text color="danger" size="xs" center multiline>
-                  {errorMsg.title}
-                </Text>
-                <Text size="xs" center multiline>
-                  {errorMsg.message}
-                </Text>
-              </div>
-            )}
+            <Text color="danger" size="xs" center multiline>
+              {errorMsg.title}
+            </Text>
+            <Text size="xs" center multiline>
+              {errorMsg.message}
+            </Text>
           </div>
         )}
       </Container>
 
-      {errorMsg?.data?.minimumAmountEth ? (
-        <Button
-          variant="accent"
-          fullWidth
-          onClick={() => {
-            props.setTokenAmount(
-              formatNumber(
-                Number(errorMsg.data?.minimumAmountEth),
-                6,
-              ).toString(),
-            );
-            props.setHasEditedAmount(true);
-          }}
-        >
-          Set Minimum
-        </Button>
-      ) : (
-        <Button
-          variant={disableSubmit ? "outline" : "accent"}
-          data-disabled={disableSubmit}
-          disabled={disableSubmit}
-          fullWidth
-          onClick={() => {
-            trackPayEvent({
-              event: "confirm_onramp_quote",
-              client: client,
-              walletAddress: payer.account.address,
-              walletType: payer.wallet.id,
-              toChainId: toChain.id,
-              toToken: isNativeToken(toToken) ? undefined : toToken.address,
-            });
-            handleSubmit();
-          }}
-          gap="xs"
-        >
-          {fiatQuoteQuery.isLoading ? (
-            <>
-              Getting price quote
-              <Spinner size="sm" color="accentButtonText" />
-            </>
-          ) : (
-            "Continue"
-          )}
-        </Button>
-      )}
+      <Button
+        variant={disableSubmit ? "outline" : "accent"}
+        data-disabled={disableSubmit}
+        disabled={disableSubmit}
+        fullWidth
+        onClick={() => {
+          trackPayEvent({
+            event: "confirm_onramp_quote",
+            client: client,
+            walletAddress: payer.account.address,
+            walletType: payer.wallet.id,
+            toChainId: toChain.id,
+            toToken: isNativeToken(toToken) ? undefined : toToken.address,
+          });
+          handleSubmit();
+        }}
+        gap="xs"
+      >
+        {fiatQuoteQuery.isLoading ? (
+          <>
+            Getting price quote
+            <Spinner size="sm" color="accentButtonText" />
+          </>
+        ) : (
+          "Continue"
+        )}
+      </Button>
     </Container>
   );
 }

package/src/react/web/ui/ConnectWallet/screens/Buy/fiat/OnRampScreen.tsx

@@ -44,6 +44,7 @@ import { StepConnectorArrow } from "../swap/StepConnector.js";
 import { WalletRow } from "../swap/WalletRow.js";
 import { addPendingTx } from "../swap/pendingSwapTx.js";
 import type { PayerInfo } from "../types.js";
+import { getProviderLabel } from "../utils.js";
 import { StepContainer } from "./FiatSteps.js";
 
 type OnRampScreenState = {
@@ -71,6 +72,7 @@ export function OnRampScreen(props: {
   payer: PayerInfo;
   onSuccess: (status: BuyWithFiatStatus) => void;
   receiverAddress: string;
+  paymentLinkId?: string;
 }) {
   const connectedWallets = useConnectedWallets();
   const isAutoMode = isInAppSigner({
@@ -85,6 +87,7 @@ export function OnRampScreen(props: {
     payer: props.payer,
     theme: props.theme,
     isAutoMode,
+    paymentLinkId: props.paymentLinkId,
   });
   const firstStepChainId = state.steps[0]?.step.token.chainId;
   return (
@@ -211,7 +214,7 @@ function StepUI(props: {
         />
         <Container flex="column" gap="3xs" center="y" style={{ flex: "1" }}>
           <Text size="sm" color="primaryText">
-            {step.action.charAt(0).toUpperCase() + step.action.slice(1)}
+            {getProviderLabel(step.action)}
           </Text>
 
           <Container
@@ -288,6 +291,7 @@ function useOnRampScreenState(props: {
   payer: PayerInfo;
   theme: "light" | "dark";
   isAutoMode?: boolean;
+  paymentLinkId?: string;
 }): OnRampScreenState {
   const onRampSteps = getOnRampSteps(props.quote);
   const [currentStepIndex, setCurrentStepIndex] = useState(0);
@@ -322,6 +326,7 @@ function useOnRampScreenState(props: {
     client: props.client,
     payer: props.payer,
     isFiatFlow: true,
+    paymentLinkId: props.paymentLinkId,
   });
 
   // Track swap status
@@ -615,6 +620,7 @@ function useSwapMutation(props: {
   client: ThirdwebClient;
   payer: PayerInfo;
   isFiatFlow: boolean;
+  paymentLinkId?: string;
 }) {
   const queryClient = useQueryClient();
   return useMutation({
@@ -646,6 +652,7 @@ function useSwapMutation(props: {
         toTokenAddress: toToken.tokenAddress,
         fromAddress: account.address,
         toAddress: account.address,
+        paymentLinkId: props.paymentLinkId,
         client: props.client,
       });