@crossmint/client-sdk-react-ui 1.7.1 → 1.9.1

package/src/components/common/InputOTP.tsx

@@ -0,0 +1,89 @@
+"use client";
+
+import * as React from "react";
+import { OTPInput, OTPInputContext } from "input-otp";
+import { createContext, useContext } from "react";
+import { classNames } from "@/utils/classNames";
+
+// Define the type for customStyles
+type CustomStyles = {
+    textPrimary: string;
+    inputBackground: string;
+    buttonBackground: string;
+    accent: string;
+    danger: string;
+    border: string;
+    borderRadius?: string;
+};
+
+// Create a context for customStyles
+const CustomStylesContext = createContext<CustomStyles | undefined>(undefined);
+
+const InputOTP = React.forwardRef<
+    React.ElementRef<typeof OTPInput>,
+    React.ComponentPropsWithoutRef<typeof OTPInput> & { customStyles?: CustomStyles }
+>(({ className, containerClassName, customStyles, ...props }, ref) => (
+    <CustomStylesContext.Provider value={customStyles}>
+        <OTPInput
+            autoFocus
+            ref={ref}
+            containerClassName={classNames("flex items-center gap-2 has-[:disabled]:opacity-50", containerClassName)}
+            className={classNames("disabled:cursor-not-allowed", className)}
+            {...props}
+        />
+    </CustomStylesContext.Provider>
+));
+InputOTP.displayName = "InputOTP";
+
+const InputOTPGroup = React.forwardRef<React.ElementRef<"div">, React.ComponentPropsWithoutRef<"div">>(
+    ({ className, ...props }, ref) => (
+        <div ref={ref} className={classNames("flex gap-2 items-center", className)} {...props} />
+    )
+);
+InputOTPGroup.displayName = "InputOTPGroup";
+
+const InputOTPSlot = React.forwardRef<
+    React.ElementRef<"div">,
+    React.ComponentPropsWithoutRef<"div"> & {
+        index: number;
+        hasError?: boolean;
+    }
+>(({ index, className, hasError, ...props }, ref) => {
+    const inputOTPContext = React.useContext(OTPInputContext);
+    const { char, hasFakeCaret, isActive } = inputOTPContext.slots[index];
+    const customStyles = useContext(CustomStylesContext);
+
+    return (
+        <div
+            ref={ref}
+            className={classNames(
+                "relative flex h-14 w-12 items-center justify-center border text-lg transition-all rounded-md text-cm-text-primary",
+                isActive && `z-10 ring-2 ring-offset-background`,
+                className
+            )}
+            style={{
+                borderRadius: customStyles?.borderRadius,
+                borderColor: hasError ? customStyles?.danger : customStyles?.border,
+                boxShadow: isActive ? `0 0 0 2px ${customStyles?.accent}` : "none",
+                backgroundColor: char ? customStyles?.buttonBackground : customStyles?.inputBackground,
+            }}
+            {...props}
+        >
+            {char}
+            {hasFakeCaret && (
+                <div className="pointer-events-none absolute inset-0 flex items-center justify-center">
+                    <div
+                        className="h-4 w-px animate-caret-blink duration-1000"
+                        style={{
+                            height: "18px",
+                            backgroundColor: customStyles?.textPrimary,
+                        }}
+                    />
+                </div>
+            )}
+        </div>
+    );
+});
+InputOTPSlot.displayName = "InputOTPSlot";
+
+export { InputOTP, InputOTPGroup, InputOTPSlot };

package/src/components/common/PoweredByCrossmint.tsx

@@ -1,16 +1,11 @@
 import { PoweredByLeaf } from "@/icons/poweredByLeaf";
+import { classNames } from "@/utils/classNames";
 
-export function PoweredByCrossmint({ color }: { color?: string }) {
+export function PoweredByCrossmint({ color, className }: { color?: string; className?: string }) {
     return (
         <p
-            style={{
-                display: "flex",
-                fontSize: "0.75rem",
-                fontWeight: "400",
-                letterSpacing: "-0.2px",
-                padding: "0.5rem",
-                color: color || "#67797F",
-            }}
+            className={classNames("flex text-xs font-normal tracking-tight p-2 items-center", className)}
+            style={{ color: color || "#67797F" }}
         >
             Powered by
             <span className="flex self-center pl-1 gap-1 items-center font-semibold">

package/src/components/common/Spinner.tsx

@@ -0,0 +1,22 @@
+import type React from "react";
+import { classNames } from "@/utils/classNames";
+
+export const Spinner = ({ className, style }: { className?: string; style?: React.CSSProperties }) => (
+    <svg
+        aria-hidden="true"
+        className={classNames("w-6 h-6 fill-cm-text-primary text-cm-text-secondary animate-spin", className)}
+        style={style}
+        viewBox="0 0 100 101"
+        fill="none"
+        xmlns="http://www.w3.org/2000/svg"
+    >
+        <path
+            d="M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z"
+            fill="currentColor"
+        />
+        <path
+            d="M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z"
+            fill="currentFill"
+        />
+    </svg>
+);

package/src/components/dynamic-xyz/DynamicContextProviderWrapper.tsx

@@ -0,0 +1,31 @@
+import type { APIKeyEnvironmentPrefix } from "@crossmint/common-sdk-base";
+import { type DynamicContextProps, DynamicContextProvider } from "@dynamic-labs/sdk-react-core";
+import type { ReactNode } from "react";
+
+export interface DynamicContextProviderWrapperProps {
+    children?: ReactNode;
+    settings: Omit<DynamicContextProps["settings"], "initialAuthenticationMode" | "environmentId">;
+    apiKeyEnvironment: APIKeyEnvironmentPrefix;
+}
+
+export default function DynamicContextProviderWrapper({
+    children,
+    settings,
+    apiKeyEnvironment,
+}: DynamicContextProviderWrapperProps) {
+    return (
+        <DynamicContextProvider
+            settings={{
+                initialAuthenticationMode: "connect-only",
+                environmentId:
+                    apiKeyEnvironment === "production"
+                        ? "3fc6c24e-6a8e-45f8-aae1-a87d7a027e12"
+                        : "cd53135a-b32b-4704-bfca-324b665e9329",
+                cssOverrides: `.powered-by-dynamic { display: none !important; }`,
+                ...settings,
+            }}
+        >
+            {children}
+        </DynamicContextProvider>
+    );
+}

package/src/components/embed/v3/CrossmintEmbeddedCheckoutV3.tsx

@@ -0,0 +1,7 @@
+import type { CrossmintEmbeddedCheckoutV3Props } from "@crossmint/client-sdk-base";
+
+import { EmbeddedCheckoutV3IFrame } from "./EmbeddedCheckoutV3IFrame";
+
+export function CrossmintEmbeddedCheckout_Alpha(props: CrossmintEmbeddedCheckoutV3Props) {
+    return <EmbeddedCheckoutV3IFrame {...props} />;
+}

package/src/components/embed/v3/EmbeddedCheckoutV3IFrame.tsx

@@ -0,0 +1,74 @@
+import { useCrossmint } from "@/hooks";
+import { useEffect, useRef, useState } from "react";
+
+import {
+    type CrossmintEmbeddedCheckoutV3Props,
+    type EmbeddedCheckoutV3IFrameEmitter,
+    crossmintEmbeddedCheckoutV3Service,
+} from "@crossmint/client-sdk-base";
+
+import { CryptoWalletConnectionHandler } from "./crypto/CryptoWalletConnectionHandler";
+import { createCrossmintApiClient } from "@/utils/createCrossmintApiClient";
+
+export function EmbeddedCheckoutV3IFrame(props: CrossmintEmbeddedCheckoutV3Props) {
+    const [iframeClient, setIframeClient] = useState<EmbeddedCheckoutV3IFrameEmitter | null>(null);
+    const [height, setHeight] = useState(0);
+
+    const { crossmint } = useCrossmint();
+    const apiClient = createCrossmintApiClient(crossmint);
+    const embedV3Service = crossmintEmbeddedCheckoutV3Service({ apiClient });
+
+    const ref = useRef<HTMLIFrameElement>(null);
+
+    useEffect(() => {
+        const iframe = ref.current;
+        if (!iframe || iframeClient) {
+            return;
+        }
+        setIframeClient(embedV3Service.iframe.createClient(iframe));
+    }, [ref.current, iframeClient]);
+
+    useEffect(() => {
+        if (iframeClient == null) {
+            return;
+        }
+        iframeClient.on("ui:height.changed", (data) => setHeight(data.height));
+
+        return () => {
+            iframeClient.off("ui:height.changed");
+        };
+    }, [iframeClient]);
+
+    return (
+        <>
+            <iframe
+                ref={ref}
+                src={embedV3Service.iframe.getUrl(props)}
+                id="crossmint-embedded-checkout.iframe"
+                role="crossmint-embedded-checkout.iframe"
+                allow="payment *"
+                style={{
+                    boxShadow: "none",
+                    border: "none",
+                    padding: "0px",
+                    width: "100%",
+                    minWidth: "100%",
+                    overflow: "hidden",
+                    display: "block",
+                    userSelect: "none",
+                    transform: "translate(0px)",
+                    opacity: "1",
+                    transition: "ease 0s, opacity 0.4s ease 0.1s",
+                    height: `${height}px`,
+                    backgroundColor: "transparent",
+                }}
+            />
+            {props.payment.crypto.enabled ? (
+                <CryptoWalletConnectionHandler
+                    iframeClient={iframeClient}
+                    apiKeyEnvironment={apiClient["parsedAPIKey"].environment}
+                />
+            ) : null}
+        </>
+    );
+}

package/src/components/embed/v3/crypto/CryptoWalletConnectionHandler.tsx

@@ -0,0 +1,138 @@
+import DynamicContextProviderWrapper from "@/components/dynamic-xyz/DynamicContextProviderWrapper";
+import type { EmbeddedCheckoutV3IFrameEmitter } from "@crossmint/client-sdk-base";
+import {
+    type APIKeyEnvironmentPrefix,
+    type BlockchainIncludingTestnet,
+    chainIdToBlockchain,
+} from "@crossmint/common-sdk-base";
+import { EthereumWalletConnectors } from "@dynamic-labs/ethereum";
+import { type HandleConnectedWallet, useDynamicContext } from "@dynamic-labs/sdk-react-core";
+import { SolanaWalletConnectors } from "@dynamic-labs/solana";
+import { useEffect } from "react";
+import { handleSendTransaction } from "./utils/handleSendTransaction";
+
+export function CryptoWalletConnectionHandler(props: {
+    iframeClient: EmbeddedCheckoutV3IFrameEmitter | null;
+    apiKeyEnvironment: APIKeyEnvironmentPrefix;
+}) {
+    const { iframeClient, apiKeyEnvironment } = props;
+
+    return (
+        <DynamicContextProviderWrapper
+            apiKeyEnvironment={apiKeyEnvironment}
+            settings={{
+                walletConnectors: [EthereumWalletConnectors, SolanaWalletConnectors],
+                events: {
+                    onAuthFlowCancel() {
+                        console.log("[CryptoWalletConnectionHandler] onAuthFlowCancel");
+                        iframeClient?.send("crypto:connect-wallet.failed", {
+                            error: "cancelled",
+                        });
+                    },
+                    onAuthFlowClose() {
+                        console.log("[CryptoWalletConnectionHandler] onAuthFlowClose");
+                    },
+                    onAuthFailure(data, reason) {
+                        console.error("[CryptoWalletConnectionHandler] onAuthFailure", data, reason);
+                    },
+                    onAuthSuccess(data) {
+                        console.log("[CryptoWalletConnectionHandler] onAuthSuccess", data);
+                    },
+                },
+                handlers: {
+                    handleConnectedWallet: async (wallet) => {
+                        console.log("[CryptoWalletConnectionHandler] handleConnectedWallet", wallet);
+
+                        const address = wallet.address;
+                        if (!address) {
+                            console.error("[CryptoWalletConnectionHandler] handleConnectedWallet: address is missing");
+                            iframeClient?.send("crypto:connect-wallet.failed", {
+                                error: "address is missing",
+                            });
+                            return false;
+                        }
+
+                        const chain = await dynamicChainToCrossmintChain(wallet);
+
+                        iframeClient?.send("crypto:connect-wallet.success", {
+                            address,
+                            chain,
+                            walletProviderKey: wallet.connector?.key,
+                        });
+
+                        return true;
+                    },
+                },
+            }}
+        >
+            <_CryptoWalletConnectionHandler {...props} />
+        </DynamicContextProviderWrapper>
+    );
+}
+
+function _CryptoWalletConnectionHandler({ iframeClient }: Parameters<typeof CryptoWalletConnectionHandler>[0]) {
+    const { setShowAuthFlow, primaryWallet, handleLogOut } = useDynamicContext();
+
+    useEffect(() => {
+        if (iframeClient == null) {
+            return;
+        }
+        const showAuthFlowListener = iframeClient.on("crypto:connect-wallet.show", async ({ show }) => {
+            await handleLogOut();
+            setShowAuthFlow(show);
+        });
+
+        return () => {
+            iframeClient.off(showAuthFlowListener);
+        };
+    }, [iframeClient, handleLogOut, setShowAuthFlow]);
+
+    useEffect(() => {
+        if (iframeClient == null) {
+            return;
+        }
+        const signTransactionListener = iframeClient.on(
+            "crypto:send-transaction",
+            async ({ chain, serializedTransaction }) => {
+                if (primaryWallet == null) {
+                    console.error("[CryptoWalletConnectionHandler] signTransaction: primaryWallet is missing");
+                    iframeClient.send("crypto:send-transaction:failed", {
+                        error: "primaryWallet is missing",
+                    });
+                    return;
+                }
+
+                await handleSendTransaction(
+                    primaryWallet,
+                    chain as BlockchainIncludingTestnet,
+                    serializedTransaction,
+                    iframeClient
+                );
+            }
+        );
+
+        return () => {
+            iframeClient.off(signTransactionListener);
+        };
+    }, [iframeClient, primaryWallet]);
+
+    return null;
+}
+
+async function dynamicChainToCrossmintChain(
+    wallet: Parameters<HandleConnectedWallet>[0]
+): Promise<BlockchainIncludingTestnet> {
+    const chain = wallet.chain;
+    if (chain === "SOL") {
+        return "solana";
+    }
+    const chainId = await wallet.connector?.getNetwork();
+    if (typeof chainId !== "number") {
+        throw new Error("chainId is not a number");
+    }
+    const chainFromChainId = chainIdToBlockchain(chainId);
+    if (!chainFromChainId) {
+        throw new Error(`ChainId ${chainId} is not supported`);
+    }
+    return chainFromChainId as BlockchainIncludingTestnet;
+}

package/src/components/embed/v3/crypto/utils/handleEvmTransaction.ts

@@ -0,0 +1,65 @@
+import type { EmbeddedCheckoutV3IFrameEmitter } from "@crossmint/client-sdk-base";
+import {
+    type BlockchainIncludingTestnet,
+    blockchainToChainId,
+    type EVMBlockchainIncludingTestnet,
+} from "@crossmint/common-sdk-base";
+import type { EthereumWallet } from "@dynamic-labs/ethereum-core";
+import { parseTransaction, type TransactionSerializableEIP1559 } from "viem";
+
+export async function handleEvmTransaction({
+    primaryWallet,
+    chain,
+    serializedTransaction,
+    iframeClient,
+}: {
+    primaryWallet: EthereumWallet;
+    chain: BlockchainIncludingTestnet;
+    serializedTransaction: string;
+    iframeClient: EmbeddedCheckoutV3IFrameEmitter;
+}) {
+    try {
+        await primaryWallet.switchNetwork(blockchainToChainId(chain as EVMBlockchainIncludingTestnet));
+    } catch (error) {
+        console.error("[CryptoWalletConnectionHandler] failed to switch network", error);
+        iframeClient.send("crypto:send-transaction:failed", {
+            error: (error as Error).message,
+        });
+        return;
+    }
+
+    let walletClient: Awaited<ReturnType<typeof primaryWallet.getWalletClient>>;
+    try {
+        walletClient = await primaryWallet.getWalletClient();
+    } catch (error) {
+        console.error("[CryptoWalletConnectionHandler] failed to get wallet client", error);
+        iframeClient.send("crypto:send-transaction:failed", {
+            error: (error as Error).message,
+        });
+        return;
+    }
+
+    let parsedTransaction: TransactionSerializableEIP1559;
+    try {
+        parsedTransaction = parseTransaction(serializedTransaction as `0x${string}`) as TransactionSerializableEIP1559;
+    } catch (error) {
+        console.error("[CryptoWalletConnectionHandler] failed to parse transaction", error);
+        iframeClient.send("crypto:send-transaction:failed", {
+            error: (error as Error).message,
+        });
+        return;
+    }
+
+    try {
+        const txId = await walletClient.sendTransaction(parsedTransaction);
+        console.log("[CryptoWalletConnectionHandler] txId", txId);
+        iframeClient.send("crypto:send-transaction:success", {
+            txId,
+        });
+    } catch (error) {
+        console.error("[CryptoWalletConnectionHandler] failed to send transaction", error);
+        iframeClient.send("crypto:send-transaction:failed", {
+            error: (error as Error).message,
+        });
+    }
+}

package/src/components/embed/v3/crypto/utils/handleSendTransaction.ts

@@ -0,0 +1,31 @@
+import type { Wallet } from "@dynamic-labs/sdk-react-core";
+
+import type { BlockchainIncludingTestnet } from "@crossmint/common-sdk-base";
+
+import { handleEvmTransaction } from "./handleEvmTransaction";
+
+import { isSolanaWallet } from "@dynamic-labs/solana";
+import { handleSolanaTransaction } from "./handleSolanaTransaction";
+import { isEthereumWallet } from "@dynamic-labs/ethereum";
+import type { EmbeddedCheckoutV3IFrameEmitter } from "@crossmint/client-sdk-base";
+
+export async function handleSendTransaction(
+    primaryWallet: Wallet,
+    chain: BlockchainIncludingTestnet,
+    serializedTransaction: string,
+    iframeClient: EmbeddedCheckoutV3IFrameEmitter
+) {
+    const commonParams = {
+        chain,
+        serializedTransaction,
+        iframeClient,
+    };
+    if (isSolanaWallet(primaryWallet)) {
+        return await handleSolanaTransaction({
+            ...commonParams,
+            primaryWallet,
+        });
+    } else if (isEthereumWallet(primaryWallet)) {
+        return await handleEvmTransaction({ ...commonParams, primaryWallet });
+    }
+}

package/src/components/embed/v3/crypto/utils/handleSolanaTransaction.ts

@@ -0,0 +1,51 @@
+import type { EmbeddedCheckoutV3IFrameEmitter } from "@crossmint/client-sdk-base";
+import type { SolanaWallet } from "@dynamic-labs/solana-core";
+import { Transaction } from "@solana/web3.js";
+import base58 from "bs58";
+
+export async function handleSolanaTransaction({
+    primaryWallet,
+    serializedTransaction,
+    iframeClient,
+}: {
+    primaryWallet: SolanaWallet;
+    serializedTransaction: string;
+    iframeClient: EmbeddedCheckoutV3IFrameEmitter;
+}) {
+    // TODO: Handle switch network
+
+    let signer: Awaited<ReturnType<typeof primaryWallet.getSigner>>;
+    try {
+        signer = await primaryWallet.getSigner();
+    } catch (error) {
+        console.error("[CryptoWalletConnectionHandler] failed to get signer", error);
+        iframeClient.send("crypto:send-transaction:failed", {
+            error: "Failed to get signer",
+        });
+        return;
+    }
+
+    let deserializedTransaction: Transaction;
+    try {
+        deserializedTransaction = Transaction.from(base58.decode(serializedTransaction));
+    } catch (error) {
+        console.error("[CryptoWalletConnectionHandler] failed to deserialize transaction", error);
+        iframeClient.send("crypto:send-transaction:failed", {
+            error: "Failed to deserialize transaction",
+        });
+        return;
+    }
+
+    try {
+        const { signature: txId } = await signer.signAndSendTransaction(deserializedTransaction);
+        console.log("[CryptoWalletConnectionHandler] txId", txId);
+        iframeClient.send("crypto:send-transaction:success", {
+            txId,
+        });
+    } catch (error) {
+        console.error("[CryptoWalletConnectionHandler] failed to send transaction", error);
+        iframeClient.send("crypto:send-transaction:failed", {
+            error: (error as Error).message,
+        });
+    }
+}

package/src/components/embed/v3/index.ts

@@ -0,0 +1 @@
+export * from "./CrossmintEmbeddedCheckoutV3";

package/src/components/index.ts

@@ -3,3 +3,6 @@ export * from "./CrossmintNFTDetail";
 
 export * from "./embed";
 export * from "./hosted";
+export * from "./embed/v3";
+
+export { EmbeddedAuthForm } from "./auth/EmbeddedAuthForm";

package/src/hooks/index.ts

@@ -1,4 +1,5 @@
 export * from "./useCrossmint";
+export * from "./useCrossmintCheckout";
 export * from "./useWallet";
 export * from "./useAuth";
 export * from "./useRefreshToken";

package/src/hooks/useAuthSignIn.ts

@@ -0,0 +1,117 @@
+import type { UseSignInData } from "@farcaster/auth-kit";
+
+export function useAuthSignIn() {
+    return {
+        onEmailSignIn,
+        onConfirmEmailOtp,
+        onFarcasterSignIn,
+    };
+}
+
+async function onEmailSignIn(email: string, options: { baseUrl: string; apiKey: string }) {
+    try {
+        const queryParams = new URLSearchParams({ apiKey: options.apiKey });
+        const response = await fetch(`${options.baseUrl}api/2024-09-26/session/sdk/auth/otps/send?${queryParams}`, {
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": options.apiKey,
+            },
+            credentials: "same-origin",
+            cache: "no-cache",
+            mode: "cors",
+            method: "POST",
+            body: JSON.stringify({ email }),
+        });
+
+        if (!response?.ok) {
+            throw new Error("Failed to send email. Please try again or contact support.");
+        }
+
+        return await response.json();
+    } catch (err) {
+        console.error("Error signing in via email ", err);
+        throw new Error("Error signing in via email " + err);
+    }
+}
+
+async function onConfirmEmailOtp(
+    email: string,
+    emailId: string,
+    token: string,
+    options: { baseUrl: string; apiKey: string }
+) {
+    try {
+        const queryParams = new URLSearchParams({
+            email,
+            signinAuthenticationMethod: "email",
+            apiKey: options.apiKey,
+            token,
+            locale: "en",
+            state: emailId,
+            callbackUrl: `${options.baseUrl}api/2024-09-26/session/sdk/auth/we-dont-actually-use-this-anymore`,
+        });
+        const response = await fetch(`${options.baseUrl}api/2024-09-26/session/sdk/auth/authenticate?${queryParams}`, {
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": options.apiKey,
+            },
+            credentials: "same-origin",
+            cache: "no-cache",
+            mode: "cors",
+            method: "POST",
+        });
+
+        if (!response?.ok) {
+            throw new Error("Failed to confirm email otp. Please try again or contact support.");
+        }
+
+        const data = await response.json();
+        const callbackUrl = new URL(data.callbackUrl);
+
+        // parse the oneTimeSecret from the callbackUrl response
+        return callbackUrl.searchParams.get("oneTimeSecret");
+    } catch (err) {
+        console.error("Error confirming email otp ", err);
+        throw new Error("Error confirming email otp " + err);
+    }
+}
+
+async function onFarcasterSignIn(data: UseSignInData, options: { baseUrl: string; apiKey: string }) {
+    try {
+        const queryParams = new URLSearchParams({
+            signinAuthenticationMethod: "farcaster",
+            apiKey: options.apiKey,
+            callbackUrl: `${options.baseUrl}sdk/2024-09-26/auth/callback?isPopup=false`,
+        });
+
+        const response = await fetch(`${options.baseUrl}api/2024-09-26/session/sdk/auth/authenticate?${queryParams}`, {
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": options.apiKey,
+            },
+            body: JSON.stringify({
+                ...data,
+                domain: data.signatureParams.domain,
+                redirect: true,
+                callbackUrl: `${options.baseUrl}sdk/2024-09-26/auth/callback?isPopup=false`,
+            }),
+            credentials: "same-origin",
+            cache: "no-cache",
+            mode: "cors",
+            method: "POST",
+        });
+
+        if (!response?.ok) {
+            throw new Error("Failed to sign in via farcaster. Please try again or contact support.");
+        }
+
+        const resData = await response.json();
+        const callbackUrl = new URL(resData.callbackUrl);
+
+        // parse the oneTimeSecret from the callbackUrl response
+        return callbackUrl.searchParams.get("oneTimeSecret");
+    } catch (err) {
+        console.error("Error signing in via farcaster ", err);
+        throw new Error("Error signing in via farcaster " + err);
+    }
+}