thirdweb 5.100.1 → 5.100.2-nightly-5ab59ff400cc32caa414354855fa07831ed90f3a-20250523000413

package/src/bridge/Sell.ts

@@ -4,6 +4,7 @@ import type { ThirdwebClient } from "../client/client.js";
 import { getThirdwebBaseUrl } from "../utils/domains.js";
 import { getClientFetch } from "../utils/fetch.js";
 import { stringify } from "../utils/json.js";
+import { ApiError } from "./types/Errors.js";
 import type { PreparedQuote, Quote } from "./types/Quote.js";
 
 /**
@@ -126,9 +127,12 @@ export async function quote(options: quote.Options): Promise<quote.Result> {
   const response = await clientFetch(url.toString());
   if (!response.ok) {
     const errorJson = await response.json();
-    throw new Error(
-      `${errorJson.code} | ${errorJson.message} - ${errorJson.correlationId}`,
-    );
+    throw new ApiError({
+      code: errorJson.code || "UNKNOWN_ERROR",
+      message: errorJson.message || response.statusText,
+      correlationId: errorJson.correlationId || undefined,
+      statusCode: response.status,
+    });
   }
 
   const { data }: { data: Quote } = await response.json();
@@ -323,6 +327,7 @@ export async function prepare(
     client,
     purchaseData,
     maxSteps,
+    paymentLinkId,
   } = options;
 
   const clientFetch = getClientFetch(client);
@@ -344,13 +349,17 @@ export async function prepare(
       receiver,
       purchaseData,
       maxSteps,
+      paymentLinkId,
     }),
   });
   if (!response.ok) {
     const errorJson = await response.json();
-    throw new Error(
-      `${errorJson.code} | ${errorJson.message} - ${errorJson.correlationId}`,
-    );
+    throw new ApiError({
+      code: errorJson.code || "UNKNOWN_ERROR",
+      message: errorJson.message || response.statusText,
+      correlationId: errorJson.correlationId || undefined,
+      statusCode: response.status,
+    });
   }
 
   const { data }: { data: PreparedQuote } = await response.json();
@@ -395,6 +404,10 @@ export declare namespace prepare {
     client: ThirdwebClient;
     purchaseData?: unknown;
     maxSteps?: number;
+    /**
+     * @hidden
+     */
+    paymentLinkId?: string;
   };
 
   type Result = PreparedQuote & {

package/src/bridge/Status.ts

@@ -3,6 +3,7 @@ import type { Chain } from "../chains/types.js";
 import type { ThirdwebClient } from "../client/client.js";
 import { getThirdwebBaseUrl } from "../utils/domains.js";
 import { getClientFetch } from "../utils/fetch.js";
+import { ApiError } from "./types/Errors.js";
 import type { Status } from "./types/Status.js";
 
 /**
@@ -115,9 +116,12 @@ export async function status(options: status.Options): Promise<status.Result> {
   const response = await clientFetch(url.toString());
   if (!response.ok) {
     const errorJson = await response.json();
-    throw new Error(
-      `${errorJson.code} | ${errorJson.message} - ${errorJson.correlationId}`,
-    );
+    throw new ApiError({
+      code: errorJson.code || "UNKNOWN_ERROR",
+      message: errorJson.message || response.statusText,
+      correlationId: errorJson.correlationId || undefined,
+      statusCode: response.status,
+    });
   }
 
   const { data }: { data: Status } = await response.json();

package/src/bridge/Transfer.ts

@@ -4,6 +4,7 @@ import type { ThirdwebClient } from "../client/client.js";
 import { getThirdwebBaseUrl } from "../utils/domains.js";
 import { getClientFetch } from "../utils/fetch.js";
 import { stringify } from "../utils/json.js";
+import { ApiError } from "./types/Errors.js";
 import type { PreparedQuote } from "./types/Quote.js";
 
 /**
@@ -189,6 +190,7 @@ export async function prepare(
     amount,
     purchaseData,
     feePayer,
+    paymentLinkId,
   } = options;
 
   const clientFetch = getClientFetch(client);
@@ -208,13 +210,17 @@ export async function prepare(
       receiver,
       purchaseData,
       feePayer,
+      paymentLinkId,
     }),
   });
   if (!response.ok) {
     const errorJson = await response.json();
-    throw new Error(
-      `${errorJson.code} | ${errorJson.message} - ${errorJson.correlationId}`,
-    );
+    throw new ApiError({
+      code: errorJson.code || "UNKNOWN_ERROR",
+      message: errorJson.message || response.statusText,
+      correlationId: errorJson.correlationId || undefined,
+      statusCode: response.status,
+    });
   }
 
   const { data }: { data: PreparedQuote } = await response.json();
@@ -254,6 +260,10 @@ export declare namespace prepare {
     client: ThirdwebClient;
     purchaseData?: unknown;
     feePayer?: "sender" | "receiver";
+    /**
+     * @hidden
+     */
+    paymentLinkId?: string;
   };
 
   type Result = PreparedQuote & {

package/src/bridge/index.ts

@@ -16,4 +16,5 @@ export type {
 } from "./types/Route.js";
 export type { Status } from "./types/Status.js";
 export type { Token } from "./types/Token.js";
-export type { BridgeAction } from "./types/BridgeAction.js";
+export type { Action } from "./types/BridgeAction.js";
+export type { ApiError } from "./types/Errors.js";

package/src/bridge/types/BridgeAction.ts

@@ -1 +1 @@
-export type BridgeAction = "approval" | "transfer" | "buy" | "sell";
+export type Action = "approval" | "transfer" | "buy" | "sell";

package/src/bridge/types/Errors.ts

@@ -0,0 +1,24 @@
+type ErrorCode =
+  | "INVALID_INPUT"
+  | "ROUTE_NOT_FOUND"
+  | "AMOUNT_TOO_LOW"
+  | "AMOUNT_TOO_HIGH"
+  | "UNKNOWN_ERROR";
+
+export class ApiError extends Error {
+  code: ErrorCode;
+  correlationId?: string;
+  statusCode: number;
+
+  constructor(args: {
+    code: ErrorCode;
+    message: string;
+    statusCode: number;
+    correlationId?: string;
+  }) {
+    super(args.message);
+    this.code = args.code;
+    this.correlationId = args.correlationId;
+    this.statusCode = args.statusCode;
+  }
+}

package/src/bridge/types/Route.ts

@@ -1,7 +1,7 @@
 import type { Hex as ox__Hex } from "ox";
 import type { Chain } from "../../chains/types.js";
 import type { ThirdwebClient } from "../../client/client.js";
-import type { BridgeAction } from "./BridgeAction.js";
+import type { Action } from "./BridgeAction.js";
 import type { Token } from "./Token.js";
 
 export type Route = {
@@ -35,7 +35,7 @@ export type RouteTransaction = {
   /**
    * The action this transaction performs. This can be "approval", "transfer", "buy", or "sell".
    */
-  action: BridgeAction;
+  action: Action;
   /**
    * The transaction ID, used for tracking purposes.
    */

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/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/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

@@ -5,7 +5,6 @@ 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,
@@ -25,7 +24,6 @@ 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 { PayWithCreditCard } from "../PayWIthCreditCard.js";
@@ -50,6 +48,7 @@ export function FiatScreenContent(props: {
   payer: PayerInfo;
   setTokenAmount: (amount: string) => void;
   setHasEditedAmount: (hasEdited: boolean) => void;
+  paymentLinkId: undefined | string;
 }) {
   const {
     toToken,
@@ -60,6 +59,7 @@ export function FiatScreenContent(props: {
     toChain,
     showCurrencySelector,
     selectedCurrency,
+    paymentLinkId,
   } = props;
   const defaultRecipientAddress = (
     props.payOptions as Extract<PayUIOptions, { mode: "direct_payment" }>
@@ -99,6 +99,7 @@ export function FiatScreenContent(props: {
           purchaseData: props.payOptions.purchaseData,
           fromAddress: payer.account.address,
           preferredProvider: preferredProvider,
+          paymentLinkId: paymentLinkId,
         }
       : undefined,
   );
@@ -227,77 +228,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="accentText" />
-            </>
-          ) : (
-            "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

@@ -71,6 +71,7 @@ export function OnRampScreen(props: {
   payer: PayerInfo;
   onSuccess: (status: BuyWithFiatStatus) => void;
   receiverAddress: string;
+  paymentLinkId?: string;
 }) {
   const connectedWallets = useConnectedWallets();
   const isAutoMode = isInAppSigner({
@@ -85,6 +86,7 @@ export function OnRampScreen(props: {
     payer: props.payer,
     theme: props.theme,
     isAutoMode,
+    paymentLinkId: props.paymentLinkId,
   });
   const firstStepChainId = state.steps[0]?.step.token.chainId;
   return (
@@ -288,6 +290,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 +325,7 @@ function useOnRampScreenState(props: {
     client: props.client,
     payer: props.payer,
     isFiatFlow: true,
+    paymentLinkId: props.paymentLinkId,
   });
 
   // Track swap status
@@ -615,6 +619,7 @@ function useSwapMutation(props: {
   client: ThirdwebClient;
   payer: PayerInfo;
   isFiatFlow: boolean;
+  paymentLinkId?: string;
 }) {
   const queryClient = useQueryClient();
   return useMutation({
@@ -646,6 +651,7 @@ function useSwapMutation(props: {
         toTokenAddress: toToken.tokenAddress,
         fromAddress: account.address,
         toAddress: account.address,
+        paymentLinkId: props.paymentLinkId,
         client: props.client,
       });