@b3dotfun/sdk 0.0.62 → 0.0.63-alpha.1

package/dist/esm/global-account/react/utils/profileDisplay.js

@@ -1,3 +1,58 @@
+import { debugB3React } from "../../../shared/utils/debug.js";
+const debug = debugB3React("profileDisplay");
+/**
+ * Validates that an image URL uses an allowed schema
+ * @param url - The URL to validate
+ * @returns The URL if valid, null otherwise
+ */
+export function validateImageUrl(url) {
+    if (!url)
+        return null;
+    try {
+        // For blob URLs (from createObjectURL)
+        if (url.startsWith("blob:")) {
+            return url;
+        }
+        // For IPFS protocol URLs
+        if (url.startsWith("ipfs://")) {
+            return url;
+        }
+        // Parse URL to validate protocol and hostname
+        const parsedUrl = new URL(url);
+        // Only allow http and https protocols
+        if (parsedUrl.protocol !== "http:" && parsedUrl.protocol !== "https:") {
+            debug("Rejected unsafe protocol:", parsedUrl.protocol, url);
+            return null;
+        }
+        // Whitelist of allowed IPFS gateway hostnames
+        const allowedIpfsGateways = [
+            "ipfs.io",
+            "gateway.pinata.cloud",
+            "cloudflare-ipfs.com",
+            "dweb.link",
+            "nftstorage.link",
+            "w3s.link",
+        ];
+        // Check if hostname matches allowed IPFS gateways
+        const hostname = parsedUrl.hostname.toLowerCase();
+        const isAllowedIpfsGateway = allowedIpfsGateways.some(gateway => {
+            // Exact match or subdomain of the gateway
+            return hostname === gateway || hostname.endsWith(`.${gateway}`);
+        });
+        if (isAllowedIpfsGateway) {
+            return url;
+        }
+        // For standard HTTP(S) URLs from trusted sources
+        // Add additional hostname validation here if needed
+        // For now, allow all HTTP(S) URLs (can be restricted further if needed)
+        return url;
+    }
+    catch (error) {
+        // Invalid URL format
+        debug("Invalid image URL format:", url, error);
+        return null;
+    }
+}
 export function getProfileDisplayInfo(profile) {
     const { type, details } = profile;
     // Default display info
@@ -14,7 +69,7 @@ export function getProfileDisplayInfo(profile) {
             displayInfo = {
                 title: details.name || details.username || "Unknown",
                 subtitle: details.username ? `@${details.username}` : "X Account",
-                imageUrl: details.profileImageUrl || null,
+                imageUrl: validateImageUrl(details.profileImageUrl),
                 initial: "X",
                 type,
             };
@@ -23,7 +78,7 @@ export function getProfileDisplayInfo(profile) {
             displayInfo = {
                 title: details.name || details.username || "Unknown",
                 subtitle: details.username ? `@${details.username}` : "Farcaster Account",
-                imageUrl: details.profileImageUrl || null,
+                imageUrl: validateImageUrl(details.profileImageUrl),
                 initial: "F",
                 type,
             };
@@ -32,7 +87,7 @@ export function getProfileDisplayInfo(profile) {
             displayInfo = {
                 title: details.name || details.email || "Unknown",
                 subtitle: details.email || "Google Account",
-                imageUrl: details.profileImageUrl || null,
+                imageUrl: validateImageUrl(details.profileImageUrl),
                 initial: "G",
                 type,
             };
@@ -41,7 +96,7 @@ export function getProfileDisplayInfo(profile) {
             displayInfo = {
                 title: details.username || details.name || "Unknown",
                 subtitle: "Discord Account",
-                imageUrl: details.profileImageUrl || null,
+                imageUrl: validateImageUrl(details.profileImageUrl),
                 initial: "D",
                 type,
             };

package/dist/types/anyspend/react/components/AnySpendCustomExactIn.d.ts

@@ -0,0 +1,34 @@
+import { components } from "@b3dotfun/sdk/anyspend/types/api";
+import { GetQuoteResponse } from "@b3dotfun/sdk/anyspend/types/api_req_res";
+type CustomExactInConfig = {
+    functionAbi: string;
+    functionName: string;
+    functionArgs: string[];
+    to: string;
+    spenderAddress?: string;
+    action?: string;
+};
+export interface AnySpendCustomExactInProps {
+    loadOrder?: string;
+    mode?: "modal" | "page";
+    recipientAddress: string;
+    paymentType?: "crypto" | "fiat";
+    sourceTokenAddress?: string;
+    sourceTokenChainId?: number;
+    destinationToken: components["schemas"]["Token"];
+    destinationChainId: number;
+    onSuccess?: (amount: string) => void;
+    mainFooter?: React.ReactNode;
+    onTokenSelect?: (token: components["schemas"]["Token"], event: {
+        preventDefault: () => void;
+    }) => void;
+    customUsdInputValues?: string[];
+    preferEoa?: boolean;
+    customExactInConfig: CustomExactInConfig;
+    header?: ({ anyspendPrice, isLoadingAnyspendPrice, }: {
+        anyspendPrice: GetQuoteResponse | undefined;
+        isLoadingAnyspendPrice: boolean;
+    }) => React.JSX.Element;
+}
+export declare function AnySpendCustomExactIn(props: AnySpendCustomExactInProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/anyspend/react/components/AnySpendStakeB3ExactIn.d.ts

@@ -0,0 +1,9 @@
+export declare function AnySpendStakeB3ExactIn({ loadOrder, mode, sourceTokenAddress, sourceTokenChainId, recipientAddress, stakeAmount, onSuccess, }: {
+    loadOrder?: string;
+    mode?: "modal" | "page";
+    sourceTokenAddress?: string;
+    sourceTokenChainId?: number;
+    recipientAddress: string;
+    stakeAmount?: string;
+    onSuccess?: (amount: string) => void;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/anyspend/react/components/AnySpendStakeUpsideExactIn.d.ts

@@ -0,0 +1,11 @@
+import { components } from "@b3dotfun/sdk/anyspend/types/api";
+export declare function AnySpendStakeUpsideExactIn({ loadOrder, mode, recipientAddress, sourceTokenAddress, sourceTokenChainId, stakingContractAddress, token, onSuccess, }: {
+    loadOrder?: string;
+    mode?: "modal" | "page";
+    recipientAddress: string;
+    sourceTokenAddress?: string;
+    sourceTokenChainId?: number;
+    stakingContractAddress: string;
+    token: components["schemas"]["Token"];
+    onSuccess?: (amount: string) => void;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/anyspend/react/components/common/CryptoReceiveSection.d.ts

@@ -1,10 +1,14 @@
 import { components } from "../../../types/api";
+import { CryptoPaymentMethodType } from "./CryptoPaymentMethod";
 interface CryptoReceiveSectionProps {
     isDepositMode?: boolean;
     isBuyMode?: boolean;
     selectedRecipientAddress?: string;
     recipientName?: string;
     onSelectRecipient: () => void;
+    setRecipientAddress?: (address: string | undefined) => void;
+    recipientAddressFromProps?: string;
+    globalAddress?: string;
     dstAmount: string;
     dstToken: components["schemas"]["Token"];
     selectedDstChainId?: number;
@@ -17,6 +21,7 @@ interface CryptoReceiveSectionProps {
     dstTokenLogoURI?: string;
     onShowPointsDetail?: () => void;
     onShowFeeDetail?: () => void;
+    selectedCryptoPaymentMethod?: CryptoPaymentMethodType;
 }
-export declare function CryptoReceiveSection({ isDepositMode, isBuyMode, selectedRecipientAddress, recipientName, onSelectRecipient, dstAmount, dstToken, selectedDstChainId, setSelectedDstChainId, setSelectedDstToken, isSrcInputDirty, onChangeDstAmount, anyspendQuote, dstTokenSymbol, dstTokenLogoURI, onShowPointsDetail, onShowFeeDetail, }: CryptoReceiveSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function CryptoReceiveSection({ isDepositMode, isBuyMode, selectedRecipientAddress, recipientName, onSelectRecipient, setRecipientAddress, recipientAddressFromProps, globalAddress, dstAmount, dstToken, selectedDstChainId, setSelectedDstChainId, setSelectedDstToken, isSrcInputDirty, onChangeDstAmount, anyspendQuote, dstTokenSymbol, dstTokenLogoURI, onShowPointsDetail, onShowFeeDetail, selectedCryptoPaymentMethod, }: CryptoReceiveSectionProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/anyspend/react/components/common/OrderTokenAmount.d.ts

@@ -1,5 +1,5 @@
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
-export declare function OrderTokenAmount({ disabled, inputValue, onChangeInput, context, address, chainId, setChainId, token, setToken, hideTokenSelect, canEditAmount, className, innerClassName, amountClassName, tokenSelectClassName, onTokenSelect, }: {
+export declare function OrderTokenAmount({ disabled, inputValue, onChangeInput, context, address, chainId, setChainId, token, setToken, hideTokenSelect, canEditAmount, className, innerClassName, amountClassName, tokenSelectClassName, onTokenSelect, walletAddress, }: {
     disabled?: boolean;
     inputValue: string;
     onChangeInput: (value: string) => void;
@@ -18,4 +18,5 @@ export declare function OrderTokenAmount({ disabled, inputValue, onChangeInput,
     onTokenSelect?: (token: components["schemas"]["Token"], event: {
         preventDefault: () => void;
     }) => void;
+    walletAddress?: string | undefined;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/anyspend/react/components/index.d.ts

@@ -2,11 +2,15 @@ export { AnySpend } from "./AnySpend";
 export { AnySpendBondKit } from "./AnySpendBondKit";
 export { AnySpendBuySpin } from "./AnySpendBuySpin";
 export { AnySpendCustom } from "./AnySpendCustom";
+export { AnySpendCustomExactIn } from "./AnySpendCustomExactIn";
 export * from "./AnySpendFingerprintWrapper";
 export { AnySpendNFT } from "./AnySpendNFT";
+export { AnyspendSignatureMint } from "./AnyspendSignatureMint";
 export { AnySpendStakeB3 } from "./AnySpendStakeB3";
+export { AnySpendStakeB3ExactIn } from "./AnySpendStakeB3ExactIn";
+export { AnySpendStakeUpside } from "./AnySpendStakeUpside";
+export { AnySpendStakeUpsideExactIn } from "./AnySpendStakeUpsideExactIn";
 export { AnySpendTournament } from "./AnySpendTournament";
-export { AnyspendSignatureMint } from "./AnyspendSignatureMint";
 export { AnySpendNFTButton } from "./common/AnySpendNFTButton";
 export { ChainTokenIcon } from "./common/ChainTokenIcon";
 export { CryptoPaySection } from "./common/CryptoPaySection";

package/dist/types/anyspend/react/hooks/useAnyspendFlow.d.ts

@@ -17,13 +17,16 @@ interface UseAnyspendFlowProps {
     loadOrder?: string;
     isDepositMode?: boolean;
     onOrderSuccess?: (orderId: string) => void;
-    onTransactionSuccess?: (amount?: string) => void;
+    onTransactionSuccess?: (amount: string) => void;
     sourceTokenAddress?: string;
     sourceTokenChainId?: number;
+    destinationTokenAddress?: string;
+    destinationTokenChainId?: number;
     slippage?: number;
     disableUrlParamManagement?: boolean;
+    orderType?: "hype_duel" | "custom_exact_in";
 }
-export declare function useAnyspendFlow({ paymentType, recipientAddress, loadOrder, isDepositMode, onOrderSuccess, onTransactionSuccess, sourceTokenAddress, sourceTokenChainId, slippage, disableUrlParamManagement, }: UseAnyspendFlowProps): {
+export declare function useAnyspendFlow({ paymentType, recipientAddress, loadOrder, isDepositMode, onOrderSuccess, onTransactionSuccess, sourceTokenAddress, sourceTokenChainId, destinationTokenAddress, destinationTokenChainId, slippage, disableUrlParamManagement, orderType, }: UseAnyspendFlowProps): {
     activePanel: PanelView;
     setActivePanel: import("react").Dispatch<import("react").SetStateAction<PanelView>>;
     orderId: string | undefined;
@@ -44,7 +47,6 @@ export declare function useAnyspendFlow({ paymentType, recipientAddress, loadOrd
     selectedSrcChainId: number;
     setSelectedSrcChainId: import("react").Dispatch<import("react").SetStateAction<number>>;
     selectedDstChainId: number;
-    setSelectedDstChainId: import("react").Dispatch<import("react").SetStateAction<number>>;
     selectedSrcToken: {
         chainId: number;
         address: string;
@@ -65,6 +67,26 @@ export declare function useAnyspendFlow({ paymentType, recipientAddress, loadOrd
             logoURI?: string;
         };
     }>>;
+    selectedDstToken: {
+        chainId: number;
+        address: string;
+        symbol: string;
+        name: string;
+        decimals: number;
+        metadata: {
+            logoURI?: string;
+        };
+    };
+    setSelectedDstToken: import("react").Dispatch<import("react").SetStateAction<{
+        chainId: number;
+        address: string;
+        symbol: string;
+        name: string;
+        decimals: number;
+        metadata: {
+            logoURI?: string;
+        };
+    }>>;
     srcAmount: string;
     setSrcAmount: import("react").Dispatch<import("react").SetStateAction<string>>;
     dstAmount: string;

package/dist/types/anyspend/react/hooks/useAnyspendOrderHistory.d.ts

@@ -53,6 +53,35 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
             relay?: Record<string, never>;
         } | null;
         fee?: Omit<import("../..").components["schemas"]["Fee"], "type"> | null;
+    } & {
+        type: "x402_swap";
+        payload: import("../..").components["schemas"]["X402SwapPayload"];
+        metadata: import("../..").components["schemas"]["X402SwapMetadata"];
+    }) | ({
+        id: string;
+        recipientAddress: string;
+        globalAddress: string;
+        srcChain: number;
+        dstChain: number;
+        srcTokenAddress: string;
+        dstTokenAddress: string;
+        srcAmount: string;
+        status: "scanning_deposit_transaction" | "waiting_stripe_payment" | "expired" | "sending_token_from_vault" | "relay" | "executing" | "executed" | "refunding" | "refunded" | "failure";
+        errorDetails: string | null;
+        createdAt: number;
+        expiredAt: number;
+        filledAt: number | null;
+        receivedDepositAt: number | null;
+        creatorAddress: string | null;
+        partnerId: string | null;
+        onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
+        oneClickBuyUrl: string | null;
+        stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount?: string;
+            relay?: Record<string, never>;
+        } | null;
+        fee?: Omit<import("../..").components["schemas"]["Fee"], "type"> | null;
     } & {
         type: "hype_duel";
         payload: import("../..").components["schemas"]["HypeDuelPayload"];
@@ -111,6 +140,35 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
             relay?: Record<string, never>;
         } | null;
         fee?: Omit<import("../..").components["schemas"]["Fee"], "type"> | null;
+    } & {
+        type: "custom_exact_in";
+        payload: import("../..").components["schemas"]["CustomExactInPayload"];
+        metadata: import("../..").components["schemas"]["CustomMetadata"];
+    }) | ({
+        id: string;
+        recipientAddress: string;
+        globalAddress: string;
+        srcChain: number;
+        dstChain: number;
+        srcTokenAddress: string;
+        dstTokenAddress: string;
+        srcAmount: string;
+        status: "scanning_deposit_transaction" | "waiting_stripe_payment" | "expired" | "sending_token_from_vault" | "relay" | "executing" | "executed" | "refunding" | "refunded" | "failure";
+        errorDetails: string | null;
+        createdAt: number;
+        expiredAt: number;
+        filledAt: number | null;
+        receivedDepositAt: number | null;
+        creatorAddress: string | null;
+        partnerId: string | null;
+        onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
+        oneClickBuyUrl: string | null;
+        stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount?: string;
+            relay?: Record<string, never>;
+        } | null;
+        fee?: Omit<import("../..").components["schemas"]["Fee"], "type"> | null;
     } & {
         type: "mint_nft";
         payload: import("../..").components["schemas"]["MintNftPayload"];
@@ -230,6 +288,35 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
             relay?: Record<string, never>;
         } | null;
         fee?: Omit<import("../..").components["schemas"]["Fee"], "type"> | null;
+    } & {
+        type: "x402_swap";
+        payload: import("../..").components["schemas"]["X402SwapPayload"];
+        metadata: import("../..").components["schemas"]["X402SwapMetadata"];
+    }) | ({
+        id: string;
+        recipientAddress: string;
+        globalAddress: string;
+        srcChain: number;
+        dstChain: number;
+        srcTokenAddress: string;
+        dstTokenAddress: string;
+        srcAmount: string;
+        status: "scanning_deposit_transaction" | "waiting_stripe_payment" | "expired" | "sending_token_from_vault" | "relay" | "executing" | "executed" | "refunding" | "refunded" | "failure";
+        errorDetails: string | null;
+        createdAt: number;
+        expiredAt: number;
+        filledAt: number | null;
+        receivedDepositAt: number | null;
+        creatorAddress: string | null;
+        partnerId: string | null;
+        onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
+        oneClickBuyUrl: string | null;
+        stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount?: string;
+            relay?: Record<string, never>;
+        } | null;
+        fee?: Omit<import("../..").components["schemas"]["Fee"], "type"> | null;
     } & {
         type: "hype_duel";
         payload: import("../..").components["schemas"]["HypeDuelPayload"];
@@ -288,6 +375,35 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
             relay?: Record<string, never>;
         } | null;
         fee?: Omit<import("../..").components["schemas"]["Fee"], "type"> | null;
+    } & {
+        type: "custom_exact_in";
+        payload: import("../..").components["schemas"]["CustomExactInPayload"];
+        metadata: import("../..").components["schemas"]["CustomMetadata"];
+    }) | ({
+        id: string;
+        recipientAddress: string;
+        globalAddress: string;
+        srcChain: number;
+        dstChain: number;
+        srcTokenAddress: string;
+        dstTokenAddress: string;
+        srcAmount: string;
+        status: "scanning_deposit_transaction" | "waiting_stripe_payment" | "expired" | "sending_token_from_vault" | "relay" | "executing" | "executed" | "refunding" | "refunded" | "failure";
+        errorDetails: string | null;
+        createdAt: number;
+        expiredAt: number;
+        filledAt: number | null;
+        receivedDepositAt: number | null;
+        creatorAddress: string | null;
+        partnerId: string | null;
+        onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
+        oneClickBuyUrl: string | null;
+        stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount?: string;
+            relay?: Record<string, never>;
+        } | null;
+        fee?: Omit<import("../..").components["schemas"]["Fee"], "type"> | null;
     } & {
         type: "mint_nft";
         payload: import("../..").components["schemas"]["MintNftPayload"];

package/dist/types/anyspend/react/hooks/useAutoSelectCryptoPaymentMethod.d.ts

@@ -0,0 +1,26 @@
+import { CryptoPaymentMethodType } from "../components/common/CryptoPaymentMethod";
+interface UseAutoSelectCryptoPaymentMethodParams {
+    /** Current payment type (crypto or fiat) */
+    paymentType?: "crypto" | "fiat";
+    /** Currently selected payment method */
+    selectedCryptoPaymentMethod: CryptoPaymentMethodType;
+    /** Function to update the selected payment method */
+    setSelectedCryptoPaymentMethod: (method: CryptoPaymentMethodType) => void;
+    /** Whether user has enough balance to pay */
+    hasEnoughBalance: boolean;
+    /** Whether balance is still loading */
+    isBalanceLoading: boolean;
+}
+/**
+ * Custom hook to automatically select appropriate crypto payment method
+ * based on available wallets and balance.
+ *
+ * Auto-selection logic:
+ * - Only auto-selects when payment method is NONE (doesn't override user choices)
+ * - If EOA/Wagmi wallet connected + has balance → CONNECT_WALLET
+ * - If EOA/Wagmi wallet connected + insufficient balance → TRANSFER_CRYPTO
+ * - If only Global wallet available → GLOBAL_WALLET
+ * - If no wallets → remains NONE
+ */
+export declare function useAutoSelectCryptoPaymentMethod({ paymentType, selectedCryptoPaymentMethod, setSelectedCryptoPaymentMethod, hasEnoughBalance, isBalanceLoading, }: UseAutoSelectCryptoPaymentMethodParams): void;
+export {};

package/dist/types/anyspend/react/hooks/useAutoSetActiveWalletFromWagmi.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Hook that automatically sets the active thirdweb wallet when a wagmi wallet connects.
+ *
+ * This is useful for syncing wagmi wallet connections with thirdweb's wallet system,
+ * ensuring that when users connect via wagmi, the active wallet is properly set.
+ *
+ * Place this hook in components that stay mounted throughout the user flow
+ * (not in components that unmount during navigation).
+ */
+export declare function useAutoSetActiveWalletFromWagmi(): void;

package/dist/types/anyspend/react/hooks/useConnectedWalletDisplay.d.ts

@@ -0,0 +1,14 @@
+import { CryptoPaymentMethodType } from "../components/common/CryptoPaymentMethod";
+interface UseConnectedWalletDisplayResult {
+    walletAddress: string | undefined;
+    shouldShowConnectedEOA: boolean;
+    shouldShowWagmiWallet: boolean;
+    isWalletDuplicated: boolean;
+    suggestedPaymentMethod: CryptoPaymentMethodType;
+}
+/**
+ * Custom hook to determine which wallet to display and its address
+ * Handles logic for showing EOA wallet, wagmi wallet, or global wallet based on payment method
+ */
+export declare function useConnectedWalletDisplay(selectedCryptoPaymentMethod?: CryptoPaymentMethodType): UseConnectedWalletDisplayResult;
+export {};

package/dist/types/anyspend/react/hooks/usePhantomTransfer.d.ts

@@ -0,0 +1,36 @@
+interface UsePhantomTransferParams {
+    /** RPC endpoint URL for Solana network */
+    rpcEndpoint?: string;
+}
+interface PhantomTransferParams {
+    /** Amount in lamports (for SOL) or smallest token unit (for SPL tokens) */
+    amountLamports: string;
+    /** Token address (use "11111111111111111111111111111111" for native SOL) */
+    tokenAddress: string;
+    /** Recipient address */
+    recipientAddress: string;
+}
+/**
+ * Custom hook for handling Phantom wallet transfers on Solana.
+ * Supports both native SOL and SPL token transfers with automatic priority fee calculation.
+ *
+ * @example
+ * ```tsx
+ * const { initiateTransfer, isPhantomAvailable } = usePhantomTransfer();
+ *
+ * await initiateTransfer({
+ *   amountLamports: "1000000000", // 1 SOL
+ *   tokenAddress: "11111111111111111111111111111111",
+ *   recipientAddress: "..."
+ * });
+ * ```
+ */
+export declare function usePhantomTransfer({ rpcEndpoint }?: UsePhantomTransferParams): {
+    /** Function to initiate a transfer */
+    initiateTransfer: ({ amountLamports, tokenAddress, recipientAddress }: PhantomTransferParams) => Promise<void>;
+    /** Whether Phantom wallet is available (installed) */
+    isPhantomAvailable: any;
+    /** Get the currently connected Phantom wallet address */
+    getConnectedAddress: () => any;
+};
+export {};