@b3dotfun/sdk 0.0.70-alpha.0 → 0.0.70-alpha.1

package/dist/cjs/anyspend/utils/validation.d.ts

@@ -0,0 +1,67 @@
+export interface ValidationResult {
+    isValid: boolean;
+    error?: string;
+    cleaned?: string;
+}
+export interface StringValidationOptions {
+    required?: boolean;
+    defaultValue?: () => string;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: RegExp;
+    patternErrorMessage?: string;
+    trim?: boolean;
+    toLowerCase?: boolean;
+    toUpperCase?: boolean;
+    customValidator?: (value: string) => {
+        valid: boolean;
+        error?: string;
+    };
+}
+/**
+ * Generic string validator with configurable rules
+ */
+export declare function validateString(value: string | undefined, options: StringValidationOptions): ValidationResult;
+/**
+ * Common validation patterns
+ */
+export declare const ValidationPatterns: {
+    readonly ALPHANUMERIC: RegExp;
+    readonly ALPHANUMERIC_WITH_DASH_UNDERSCORE: RegExp;
+    readonly ALPHANUMERIC_WITH_SAFE_CHARS: RegExp;
+    readonly SAFE_IDENTIFIER: RegExp;
+    readonly NO_CONTROL_CHARS: RegExp;
+    readonly URL_SAFE: RegExp;
+    readonly NUMERIC: RegExp;
+    readonly HEX: RegExp;
+};
+/**
+ * Pre-configured validators for common use cases
+ */
+export declare const Validators: {
+    /**
+     * Validates client reference IDs (alphanumeric + safe chars)
+     * Returns undefined if not provided
+     */
+    clientReferenceId: (value?: string) => ValidationResult;
+    /**
+     * Validates alphanumeric strings (letters and numbers only)
+     */
+    alphanumeric: (value?: string, required?: boolean) => ValidationResult;
+    /**
+     * Validates wallet addresses (hex format)
+     */
+    walletAddress: (value?: string, required?: boolean) => ValidationResult;
+    /**
+     * Validates order IDs (UUID format)
+     */
+    orderId: (value?: string) => ValidationResult;
+    /**
+     * Validates URL-safe strings
+     */
+    urlSafe: (value?: string, maxLength?: number) => ValidationResult;
+    /**
+     * Validates safe identifiers (no injection risks)
+     */
+    safeIdentifier: (value?: string, required?: boolean) => ValidationResult;
+};

package/dist/cjs/anyspend/utils/validation.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Validators = exports.ValidationPatterns = void 0;
+exports.validateString = validateString;
+/**
+ * Generic string validator with configurable rules
+ */
+function validateString(value, options) {
+    const { required = false, defaultValue, minLength, maxLength, pattern, patternErrorMessage, trim = true, toLowerCase = false, toUpperCase = false, customValidator, } = options;
+    // Handle empty/undefined
+    if (!value || (trim && value.trim() === "")) {
+        if (required && !defaultValue) {
+            return { isValid: false, error: "This field is required" };
+        }
+        if (defaultValue) {
+            return { isValid: true, cleaned: defaultValue() };
+        }
+        return { isValid: true, cleaned: undefined };
+    }
+    // Pre-processing
+    let cleaned = value;
+    if (trim)
+        cleaned = cleaned.trim();
+    if (toLowerCase)
+        cleaned = cleaned.toLowerCase();
+    if (toUpperCase)
+        cleaned = cleaned.toUpperCase();
+    // Length validation
+    if (minLength !== undefined && cleaned.length < minLength) {
+        return {
+            isValid: false,
+            error: `Minimum length is ${minLength} characters`,
+        };
+    }
+    if (maxLength !== undefined && cleaned.length > maxLength) {
+        return {
+            isValid: false,
+            error: `Maximum length is ${maxLength} characters`,
+        };
+    }
+    // Pattern validation
+    if (pattern && !pattern.test(cleaned)) {
+        return {
+            isValid: false,
+            error: patternErrorMessage || "Invalid format",
+        };
+    }
+    // Custom validation
+    if (customValidator) {
+        const customResult = customValidator(cleaned);
+        if (!customResult.valid) {
+            return { isValid: false, error: customResult.error };
+        }
+    }
+    return { isValid: true, cleaned };
+}
+/**
+ * Common validation patterns
+ */
+exports.ValidationPatterns = {
+    ALPHANUMERIC: /^[a-zA-Z0-9]+$/,
+    ALPHANUMERIC_WITH_DASH_UNDERSCORE: /^[a-zA-Z0-9_-]+$/,
+    ALPHANUMERIC_WITH_SAFE_CHARS: /^[a-zA-Z0-9_.\-]+$/,
+    SAFE_IDENTIFIER: /^[a-zA-Z0-9_.\-]+$/, // For IDs, references
+    NO_CONTROL_CHARS: /^[^\x00-\x1F\x7F]+$/,
+    URL_SAFE: /^[a-zA-Z0-9_.\-~]+$/,
+    NUMERIC: /^\d+$/,
+    HEX: /^[0-9a-fA-F]+$/,
+};
+/**
+ * Pre-configured validators for common use cases
+ */
+exports.Validators = {
+    /**
+     * Validates client reference IDs (alphanumeric + safe chars)
+     * Returns undefined if not provided
+     */
+    clientReferenceId: (value) => validateString(value, {
+        required: false,
+        maxLength: 255,
+        pattern: exports.ValidationPatterns.SAFE_IDENTIFIER,
+        patternErrorMessage: "Only letters, numbers, hyphens, underscores, and dots allowed",
+        trim: true,
+        customValidator: val => {
+            // Additional security checks
+            const dangerous = /('|"|;|--|\/\*|\*\/|<|>|script)/i;
+            if (dangerous.test(val)) {
+                return {
+                    valid: false,
+                    error: "Contains potentially dangerous characters",
+                };
+            }
+            return { valid: true };
+        },
+    }),
+    /**
+     * Validates alphanumeric strings (letters and numbers only)
+     */
+    alphanumeric: (value, required = false) => validateString(value, {
+        required,
+        pattern: exports.ValidationPatterns.ALPHANUMERIC,
+        patternErrorMessage: "Only letters and numbers allowed",
+        trim: true,
+    }),
+    /**
+     * Validates wallet addresses (hex format)
+     */
+    walletAddress: (value, required = true) => validateString(value, {
+        required,
+        minLength: 42,
+        maxLength: 42,
+        pattern: /^0x[a-fA-F0-9]{40}$/,
+        patternErrorMessage: "Invalid wallet address format",
+        trim: true,
+        toLowerCase: true,
+    }),
+    /**
+     * Validates order IDs (UUID format)
+     */
+    orderId: (value) => validateString(value, {
+        required: false,
+        pattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+        patternErrorMessage: "Invalid order ID format",
+        trim: true,
+        toLowerCase: true,
+    }),
+    /**
+     * Validates URL-safe strings
+     */
+    urlSafe: (value, maxLength = 255) => validateString(value, {
+        maxLength,
+        pattern: exports.ValidationPatterns.URL_SAFE,
+        patternErrorMessage: "Contains invalid URL characters",
+        trim: true,
+    }),
+    /**
+     * Validates safe identifiers (no injection risks)
+     */
+    safeIdentifier: (value, required = false) => validateString(value, {
+        required,
+        maxLength: 255,
+        pattern: exports.ValidationPatterns.SAFE_IDENTIFIER,
+        patternErrorMessage: "Invalid identifier format",
+        customValidator: val => {
+            // Additional security checks
+            const dangerous = /('|"|;|--|\/\*|\*\/|<|>|script)/i;
+            if (dangerous.test(val)) {
+                return {
+                    valid: false,
+                    error: "Contains potentially dangerous characters",
+                };
+            }
+            return { valid: true };
+        },
+        trim: true,
+    }),
+};

package/dist/cjs/global-account/react/stores/useModalStore.d.ts

@@ -122,6 +122,8 @@ export interface AnySpendModalProps extends BaseModalProps {
     destinationTokenChainId?: number;
     /** Custom USD input values for quick amount buttons in fiat onramp */
     customUsdInputValues?: string[];
+    /** Client-provided reference ID for tracking orders */
+    clientReferenceId?: string;
 }
 /**
  * Props for the AnySpend NFT modal
@@ -136,6 +138,8 @@ export interface AnySpendNftProps extends BaseModalProps {
     recipientAddress?: string;
     /** Callback function called when the NFT is successfully transferred */
     onSuccess?: (txHash?: string) => void;
+    /** Client-provided reference ID for tracking orders */
+    clientReferenceId?: string;
 }
 /**
  * Props for the AnySpend tournament modal

package/dist/esm/anyspend/index.d.ts

@@ -6,6 +6,7 @@ export * from "./utils/json";
 export * from "./utils/number";
 export * from "./utils/string";
 export * from "./utils/token";
+export * from "./utils/validation";
 export * from "./constants";
 export * from "./abis/abiUsdcBase";
 export * from "./abis/erc20Staking";

package/dist/esm/anyspend/index.js

@@ -8,6 +8,7 @@ export * from "./utils/json.js";
 export * from "./utils/number.js";
 export * from "./utils/string.js";
 export * from "./utils/token.js";
+export * from "./utils/validation.js";
 // Constants
 export * from "./constants/index.js";
 // Abis

package/dist/esm/anyspend/react/components/AnySpend.d.ts

@@ -34,4 +34,10 @@ export declare function AnySpend(props: {
     }) => void;
     onSuccess?: (txHash?: string) => void;
     customUsdInputValues?: string[];
+    /**
+     * Client-provided reference ID for tracking orders.
+     * Must be alphanumeric with optional hyphens, underscores, and dots (max 255 chars).
+     * Auto-generates UUID if not provided.
+     */
+    clientReferenceId?: string;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/esm/anyspend/react/components/AnySpend.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { getDefaultToken, USDC_BASE } from "../../../anyspend/index.js";
 import { useAnyspendCreateOnrampOrder, useAnyspendCreateOrder, useAnyspendOrderAndTransactions, useAnyspendQuote, useGeoOnrampOptions, } from "../../../anyspend/react/index.js";
+import { Validators } from "../../../anyspend/utils/validation.js";
 import { Button, ShinyButton, StyleRoot, TransitionPanel, useAccountWallet, useProfile, useRouter, useSearchParamsSSR, useTokenBalanceDirect, useTokenData, useTokenFromUrl, } from "../../../global-account/react/index.js";
 import { cn } from "../../../shared/utils/cn.js";
 import { formatTokenAmount } from "../../../shared/utils/number.js";
@@ -48,9 +49,18 @@ export function AnySpend(props) {
     const fingerprintConfig = getFingerprintConfig();
     return (_jsx(AnySpendFingerprintWrapper, { fingerprint: fingerprintConfig, children: _jsx(AnySpendInner, { ...props }) }));
 }
-function AnySpendInner({ destinationTokenAddress, destinationTokenChainId, mode = "modal", defaultActiveTab = "crypto", loadOrder, hideTransactionHistoryButton, recipientAddress: recipientAddressFromProps, onTokenSelect, onSuccess, customUsdInputValues, }) {
+function AnySpendInner({ destinationTokenAddress, destinationTokenChainId, mode = "modal", defaultActiveTab = "crypto", loadOrder, hideTransactionHistoryButton, recipientAddress: recipientAddressFromProps, onTokenSelect, onSuccess, customUsdInputValues, clientReferenceId: clientReferenceIdFromProps, }) {
     const searchParams = useSearchParamsSSR();
     const router = useRouter();
+    // Validate and clean clientReferenceId
+    const validatedClientReferenceId = useMemo(() => {
+        const validation = Validators.clientReferenceId(clientReferenceIdFromProps);
+        if (!validation.isValid) {
+            console.error(`[AnySpend] Invalid clientReferenceId: ${validation.error || "Validation failed"}. Will be set to undefined.`);
+            return undefined;
+        }
+        return validation.cleaned;
+    }, [clientReferenceIdFromProps]);
     // Determine if we're in "buy mode" based on whether destination token props are provided
     const isBuyMode = !!(destinationTokenAddress && destinationTokenChainId);
     // Add refs to track URL state
@@ -638,6 +648,7 @@ function AnySpendInner({ destinationTokenAddress, destinationTokenChainId, mode
                 srcAmount: srcAmountBigInt.toString(),
                 expectedDstAmount: anyspendQuote?.data?.currencyOut?.amount || "0",
                 creatorAddress: globalAddress,
+                clientReferenceId: validatedClientReferenceId,
             });
         }
         catch (err) {
@@ -702,6 +713,7 @@ function AnySpendInner({ destinationTokenAddress, destinationTokenChainId, mode
                 },
                 expectedDstAmount: anyspendQuote?.data?.currencyOut?.amount?.toString() || "0",
                 creatorAddress: globalAddress,
+                clientReferenceId: validatedClientReferenceId,
             });
         }
         catch (err) {

package/dist/esm/anyspend/react/components/AnySpendBondKit.d.ts

@@ -1,2 +1,4 @@
 import { AnySpendBondKitProps } from "../../../global-account/react/stores/useModalStore";
-export declare function AnySpendBondKit({ mode, recipientAddress, contractAddress, minTokensOut, imageUrl, b3Amount: initialB3Amount, onSuccess, }: AnySpendBondKitProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnySpendBondKit({ mode, recipientAddress, contractAddress, minTokensOut, imageUrl, b3Amount: initialB3Amount, onSuccess, clientReferenceId, }: AnySpendBondKitProps & {
+    clientReferenceId?: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/esm/anyspend/react/components/AnySpendBondKit.js

@@ -20,7 +20,7 @@ function formatNumberWithCommas(x) {
     parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ",");
     return parts.join(".");
 }
-export function AnySpendBondKit({ mode = "modal", recipientAddress, contractAddress, minTokensOut = "0", imageUrl, b3Amount: initialB3Amount, onSuccess, }) {
+export function AnySpendBondKit({ mode = "modal", recipientAddress, contractAddress, minTokensOut = "0", imageUrl, b3Amount: initialB3Amount, onSuccess, clientReferenceId, }) {
     const hasMounted = useHasMounted();
     const [showAmountPrompt, setShowAmountPrompt] = useState(!initialB3Amount);
     const [b3Amount, setB3Amount] = useState(initialB3Amount || "");
@@ -200,5 +200,5 @@ export function AnySpendBondKit({ mode = "modal", recipientAddress, contractAddr
     });
     return (_jsx(AnySpendCustom, { mode: mode, recipientAddress: recipientAddress, orderType: "custom", dstChainId: baseMainnet.id, dstToken: dstToken, dstAmount: parseEther(b3Amount).toString(), contractAddress: contractAddress, encodedData: encodedData, metadata: {
             action: "BondKit Buy",
-        }, header: header, onSuccess: onSuccess, showRecipient: true }));
+        }, header: header, onSuccess: onSuccess, showRecipient: true, clientReferenceId: clientReferenceId }));
 }

package/dist/esm/anyspend/react/components/AnySpendBuySpin.d.ts

@@ -1,4 +1,4 @@
-export declare function AnySpendBuySpin({ loadOrder, mode, spinwheelContractAddress, chainId, recipientAddress, prefillQuantity, onSuccess, }: {
+export declare function AnySpendBuySpin({ loadOrder, mode, spinwheelContractAddress, chainId, recipientAddress, prefillQuantity, onSuccess, clientReferenceId, }: {
     loadOrder?: string;
     mode?: "modal" | "page";
     spinwheelContractAddress: string;
@@ -6,4 +6,5 @@ export declare function AnySpendBuySpin({ loadOrder, mode, spinwheelContractAddr
     recipientAddress: string;
     prefillQuantity?: string;
     onSuccess?: (txHash?: string) => void;
+    clientReferenceId?: string;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/esm/anyspend/react/components/AnySpendBuySpin.js

@@ -85,7 +85,7 @@ const basePublicClient = createPublicClient({
     chain: baseMainnet,
     transport: http(PUBLIC_BASE_RPC_URL),
 });
-export function AnySpendBuySpin({ loadOrder, mode = "modal", spinwheelContractAddress, chainId, recipientAddress, prefillQuantity, onSuccess, }) {
+export function AnySpendBuySpin({ loadOrder, mode = "modal", spinwheelContractAddress, chainId, recipientAddress, prefillQuantity, onSuccess, clientReferenceId, }) {
     const hasMounted = useHasMounted();
     const { setB3ModalOpen } = useModalStore();
     // Payment config state
@@ -391,5 +391,5 @@ export function AnySpendBuySpin({ loadOrder, mode = "modal", spinwheelContractAd
     const encodedData = generateEncodedDataForBuyEntriesAndSpin(address || "", userSpinQuantity);
     return (_jsx(AnySpendCustom, { loadOrder: loadOrder, mode: mode, recipientAddress: recipientAddress, orderType: "custom", dstChainId: chainId, dstToken: B3_TOKEN, dstAmount: totalCost.toString(), contractAddress: spinwheelContractAddress, spenderAddress: paymentConfig.entryModule, encodedData: encodedData, metadata: {
             action: `buy ${userSpinQuantity} spin${userSpinQuantity !== "1" ? "s" : ""}`,
-        }, header: header, onSuccess: txHash => onSuccess?.(txHash), showRecipient: false }));
+        }, header: header, onSuccess: txHash => onSuccess?.(txHash), showRecipient: false, clientReferenceId: clientReferenceId }));
 }

package/dist/esm/anyspend/react/components/AnySpendCustom.d.ts

@@ -21,4 +21,5 @@ export declare function AnySpendCustom(props: {
     onSuccess?: (txHash?: string) => void;
     showRecipient?: boolean;
     onShowPointsDetail?: () => void;
+    clientReferenceId?: string;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/esm/anyspend/react/components/AnySpendCustom.js

@@ -108,7 +108,7 @@ export function AnySpendCustom(props) {
     const fingerprintConfig = getFingerprintConfig();
     return (_jsx(AnySpendFingerprintWrapper, { fingerprint: fingerprintConfig, children: _jsx(AnySpendCustomInner, { ...props }) }));
 }
-function AnySpendCustomInner({ loadOrder, mode = "modal", activeTab: activeTabProps = "crypto", recipientAddress: recipientAddressProps, spenderAddress, orderType, dstChainId, dstToken, dstAmount, contractAddress, encodedData, metadata, header, onSuccess, showRecipient = true, onShowPointsDetail, }) {
+function AnySpendCustomInner({ loadOrder, mode = "modal", activeTab: activeTabProps = "crypto", recipientAddress: recipientAddressProps, spenderAddress, orderType, dstChainId, dstToken, dstAmount, contractAddress, encodedData, metadata, header, onSuccess, showRecipient = true, onShowPointsDetail, clientReferenceId, }) {
     const hasMounted = useHasMounted();
     const featureFlags = useFeatureFlags();
     const searchParams = useSearchParamsSSR();
@@ -351,10 +351,14 @@ function AnySpendCustomInner({ loadOrder, mode = "modal", activeTab: activeTabPr
                             : window.location.origin,
                     },
                     expectedDstAmount: anyspendQuote?.data?.currencyOut?.amount?.toString() || "0",
+                    clientReferenceId: clientReferenceId,
                 });
             }
             else {
-                void createRegularOrder(createOrderParams);
+                void createRegularOrder({
+                    ...createOrderParams,
+                    clientReferenceId: clientReferenceId,
+                });
             }
         }
         catch (err) {

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

@@ -31,6 +31,7 @@ export interface AnySpendCustomExactInProps {
         anyspendPrice: GetQuoteResponse | undefined;
         isLoadingAnyspendPrice: boolean;
     }) => React.JSX.Element;
+    clientReferenceId?: string;
 }
 export declare function AnySpendCustomExactIn(props: AnySpendCustomExactInProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/esm/anyspend/react/components/AnySpendCustomExactIn.js

@@ -25,7 +25,7 @@ export function AnySpendCustomExactIn(props) {
     const fingerprintConfig = getFingerprintConfig();
     return (_jsx(AnySpendFingerprintWrapper, { fingerprint: fingerprintConfig, children: _jsx(AnySpendCustomExactInInner, { ...props }) }));
 }
-function AnySpendCustomExactInInner({ loadOrder, mode = "modal", recipientAddress, paymentType = "crypto", sourceTokenAddress, sourceTokenChainId, destinationToken, destinationChainId, onSuccess, mainFooter, onTokenSelect, customUsdInputValues, preferEoa, customExactInConfig, orderType = "custom_exact_in", minDestinationAmount, header, }) {
+function AnySpendCustomExactInInner({ loadOrder, mode = "modal", recipientAddress, paymentType = "crypto", sourceTokenAddress, sourceTokenChainId, destinationToken, destinationChainId, onSuccess, mainFooter, onTokenSelect, customUsdInputValues, preferEoa, customExactInConfig, orderType = "custom_exact_in", minDestinationAmount, header, clientReferenceId, }) {
     const actionLabel = customExactInConfig?.action ?? "Custom Execution";
     const DESTINATION_TOKEN_DETAILS = {
         SYMBOL: destinationToken.symbol ?? "TOKEN",
@@ -189,6 +189,7 @@ function AnySpendCustomExactInInner({ loadOrder, mode = "modal", recipientAddres
                 expectedDstAmount: expectedDstAmountRaw,
                 creatorAddress: globalAddress,
                 payload,
+                clientReferenceId: clientReferenceId,
             });
         }
         catch (err) {
@@ -241,6 +242,7 @@ function AnySpendCustomExactInInner({ loadOrder, mode = "modal", recipientAddres
                 expectedDstAmount: expectedDstAmountRaw,
                 creatorAddress: globalAddress,
                 payload,
+                clientReferenceId: clientReferenceId,
             });
         }
         catch (err) {

package/dist/esm/anyspend/react/components/AnySpendDepositUpside.d.ts

@@ -1,5 +1,5 @@
 import { components } from "../../../anyspend/types/api";
-export declare function AnySpendDepositUpside({ loadOrder, mode, recipientAddress, sourceTokenAddress, sourceTokenChainId, depositContractAddress, token, onSuccess, }: {
+export declare function AnySpendDepositUpside({ loadOrder, mode, recipientAddress, sourceTokenAddress, sourceTokenChainId, depositContractAddress, token, onSuccess, clientReferenceId, }: {
     loadOrder?: string;
     mode?: "modal" | "page";
     recipientAddress: string;
@@ -8,4 +8,5 @@ export declare function AnySpendDepositUpside({ loadOrder, mode, recipientAddres
     depositContractAddress: string;
     token: components["schemas"]["Token"];
     onSuccess?: (amount: string) => void;
+    clientReferenceId?: string;
 }): import("react/jsx-runtime").JSX.Element | null;

package/dist/esm/anyspend/react/components/AnySpendDepositUpside.js

@@ -22,7 +22,7 @@ const DEPOSIT_FOR_FUNCTION_ABI = JSON.stringify([
         type: "function",
     },
 ]);
-export function AnySpendDepositUpside({ loadOrder, mode = "modal", recipientAddress, sourceTokenAddress, sourceTokenChainId, depositContractAddress, token, onSuccess, }) {
+export function AnySpendDepositUpside({ loadOrder, mode = "modal", recipientAddress, sourceTokenAddress, sourceTokenChainId, depositContractAddress, token, onSuccess, clientReferenceId, }) {
     if (!recipientAddress)
         return null;
     const header = () => (_jsx(_Fragment, { children: _jsx("div", { className: "from-b3-react-background to-as-on-surface-1 w-full rounded-t-lg bg-gradient-to-t", children: _jsx("div", { className: "mb-1 flex w-full flex-col items-center gap-2", children: _jsxs("span", { className: "font-sf-rounded text-2xl font-semibold", children: ["Swap & Deposit ", token.symbol] }) }) }) }));
@@ -34,5 +34,5 @@ export function AnySpendDepositUpside({ loadOrder, mode = "modal", recipientAddr
         spenderAddress: depositContractAddress,
         action: `deposit ${token.symbol}`,
     };
-    return (_jsx(AnySpendCustomExactIn, { loadOrder: loadOrder, mode: mode, recipientAddress: recipientAddress, sourceTokenAddress: sourceTokenAddress, sourceTokenChainId: sourceTokenChainId, destinationToken: token, destinationChainId: base.id, customExactInConfig: customExactInConfig, header: header, onSuccess: onSuccess }));
+    return (_jsx(AnySpendCustomExactIn, { loadOrder: loadOrder, mode: mode, recipientAddress: recipientAddress, sourceTokenAddress: sourceTokenAddress, sourceTokenChainId: sourceTokenChainId, destinationToken: token, destinationChainId: base.id, customExactInConfig: customExactInConfig, header: header, onSuccess: onSuccess, clientReferenceId: clientReferenceId }));
 }

package/dist/esm/anyspend/react/components/AnySpendNFT.d.ts

@@ -1,9 +1,10 @@
 import { components } from "../../../anyspend/types/api";
-export declare function AnySpendNFT({ loadOrder, mode, recipientAddress, nftContract, onSuccess, onShowPointsDetail, }: {
+export declare function AnySpendNFT({ loadOrder, mode, recipientAddress, nftContract, onSuccess, onShowPointsDetail, clientReferenceId, }: {
     loadOrder?: string;
     mode?: "modal" | "page";
     recipientAddress?: string;
     nftContract: components["schemas"]["NftContract"];
     onSuccess?: (txHash?: string) => void;
     onShowPointsDetail?: () => void;
+    clientReferenceId?: string;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/esm/anyspend/react/components/AnySpendNFT.js

@@ -26,7 +26,7 @@ const CONTRACT_URI_ABI = [
         type: "function",
     },
 ];
-export function AnySpendNFT({ loadOrder, mode = "modal", recipientAddress, nftContract, onSuccess, onShowPointsDetail, }) {
+export function AnySpendNFT({ loadOrder, mode = "modal", recipientAddress, nftContract, onSuccess, onShowPointsDetail, clientReferenceId, }) {
     const [imageUrlWithFallback, setFallbackImageUrl] = useState(nftContract.imageUrl);
     const [isLoadingFallback, setIsLoadingFallback] = useState(false);
     // Fetch contract metadata when imageUrl is empty
@@ -86,7 +86,7 @@ export function AnySpendNFT({ loadOrder, mode = "modal", recipientAddress, nftCo
     return (_jsx(AnySpendCustom, { loadOrder: loadOrder, mode: mode, activeTab: "fiat", recipientAddress: recipientAddress, orderType: "mint_nft", dstChainId: nftContract.chainId, dstToken: nftContract.currency, dstAmount: nftContract.price, contractAddress: nftContract.contractAddress, encodedData: "0x", metadata: {
             type: "mint_nft",
             nftContract: nftContract,
-        }, header: header, onSuccess: onSuccess, onShowPointsDetail: onShowPointsDetail }));
+        }, header: header, onSuccess: onSuccess, onShowPointsDetail: onShowPointsDetail, clientReferenceId: clientReferenceId }));
 }
 function DropdownMenu({ nftContract }) {
     const [open, setOpen] = useState(false);

package/dist/esm/anyspend/react/components/AnySpendStakeB3.d.ts

@@ -1,7 +1,8 @@
-export declare function AnySpendStakeB3({ loadOrder, mode, recipientAddress, stakeAmount, onSuccess, }: {
+export declare function AnySpendStakeB3({ loadOrder, mode, recipientAddress, stakeAmount, onSuccess, clientReferenceId, }: {
     loadOrder?: string;
     mode?: "modal" | "page";
     recipientAddress: string;
     stakeAmount?: string;
     onSuccess?: () => void;
+    clientReferenceId?: string;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/esm/anyspend/react/components/AnySpendStakeB3.js

@@ -29,7 +29,7 @@ function generateEncodedDataForStakingB3(amount, beneficiary) {
     });
     return encodedData;
 }
-export function AnySpendStakeB3({ loadOrder, mode = "modal", recipientAddress, stakeAmount, onSuccess, }) {
+export function AnySpendStakeB3({ loadOrder, mode = "modal", recipientAddress, stakeAmount, onSuccess, clientReferenceId, }) {
     const hasMounted = useHasMounted();
     const { setB3ModalOpen } = useModalStore();
     // Wagmi hooks for direct staking
@@ -271,5 +271,5 @@ export function AnySpendStakeB3({ loadOrder, mode = "modal", recipientAddress, s
     const encodedData = generateEncodedDataForStakingB3(userStakeAmount, recipientAddress);
     return (_jsx(AnySpendCustom, { loadOrder: loadOrder, mode: mode, recipientAddress: recipientAddress, orderType: "custom", dstChainId: base.id, dstToken: B3_TOKEN, dstAmount: userStakeAmount, contractAddress: ERC20Staking, encodedData: encodedData, metadata: {
             action: "stake B3",
-        }, header: header, onSuccess: onSuccess, showRecipient: true }));
+        }, header: header, onSuccess: onSuccess, showRecipient: true, clientReferenceId: clientReferenceId }));
 }

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

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

package/dist/esm/anyspend/react/components/AnySpendStakeB3ExactIn.js

@@ -32,7 +32,7 @@ const STAKE_FUNCTION_ABI = JSON.stringify([
         outputs: [],
     },
 ]);
-export function AnySpendStakeB3ExactIn({ loadOrder, mode = "modal", sourceTokenAddress, sourceTokenChainId, recipientAddress, stakeAmount, onSuccess, }) {
+export function AnySpendStakeB3ExactIn({ loadOrder, mode = "modal", sourceTokenAddress, sourceTokenChainId, recipientAddress, stakeAmount, onSuccess, clientReferenceId, }) {
     const hasMounted = useHasMounted();
     const { setB3ModalOpen } = useModalStore();
     // Wagmi hooks for direct staking
@@ -281,5 +281,5 @@ export function AnySpendStakeB3ExactIn({ loadOrder, mode = "modal", sourceTokenA
                                     onSuccess?.(formatTokenAmount(BigInt(userStakeAmount), 18) ?? "");
                                 }, className: "bg-as-brand hover:bg-as-brand/90 text-as-primary h-14 w-full rounded-xl text-lg font-medium", children: "Done" })] })] }) }));
     }
-    return (_jsx(AnySpendCustomExactIn, { loadOrder: loadOrder, mode: mode, recipientAddress: recipientAddress, sourceTokenAddress: sourceTokenAddress, sourceTokenChainId: sourceTokenChainId, destinationToken: B3_TOKEN, destinationChainId: base.id, customExactInConfig: customExactInConfig, header: header, onSuccess: onSuccess }));
+    return (_jsx(AnySpendCustomExactIn, { loadOrder: loadOrder, mode: mode, recipientAddress: recipientAddress, sourceTokenAddress: sourceTokenAddress, sourceTokenChainId: sourceTokenChainId, destinationToken: B3_TOKEN, destinationChainId: base.id, customExactInConfig: customExactInConfig, header: header, onSuccess: onSuccess, clientReferenceId: clientReferenceId }));
 }

package/dist/esm/anyspend/react/components/AnySpendStakeUpside.d.ts

@@ -1,5 +1,5 @@
 import { components } from "../../../anyspend/types/api";
-export declare function AnySpendStakeUpside({ loadOrder, mode, beneficiaryAddress, stakeAmount, stakingContractAddress, token, onSuccess, activeTab, }: {
+export declare function AnySpendStakeUpside({ loadOrder, mode, beneficiaryAddress, stakeAmount, stakingContractAddress, token, onSuccess, activeTab, clientReferenceId, }: {
     loadOrder?: string;
     mode?: "modal" | "page";
     beneficiaryAddress: string;
@@ -8,4 +8,5 @@ export declare function AnySpendStakeUpside({ loadOrder, mode, beneficiaryAddres
     token: components["schemas"]["Token"];
     onSuccess?: () => void;
     activeTab?: "crypto" | "fiat";
+    clientReferenceId?: string;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/esm/anyspend/react/components/AnySpendStakeUpside.js

@@ -14,7 +14,7 @@ function generateEncodedDataForStaking(amount, beneficiary) {
         args: [beneficiary, BigInt(amount)],
     });
 }
-export function AnySpendStakeUpside({ loadOrder, mode = "modal", beneficiaryAddress, stakeAmount, stakingContractAddress, token, onSuccess, activeTab, }) {
+export function AnySpendStakeUpside({ loadOrder, mode = "modal", beneficiaryAddress, stakeAmount, stakingContractAddress, token, onSuccess, activeTab, clientReferenceId, }) {
     const header = () => (_jsx(_Fragment, { children: _jsxs("div", { className: "from-b3-react-background to-as-on-surface-1 mt-[-60px] w-full rounded-t-lg bg-gradient-to-t", children: [_jsx("div", { className: "h-[60px] w-full" }), _jsx("div", { className: "mb-1 flex w-full flex-col items-center gap-2 p-5", children: _jsxs("span", { className: "font-sf-rounded text-2xl font-semibold", children: ["Swap & Stake ", stakeAmount ? formatTokenAmount(BigInt(stakeAmount), token.decimals) : "", " ", token.symbol] }) })] }) }));
     // Only generate encoded data if we have a valid beneficiary address
     // This is used for the AnySpendCustom swap & stake flow
@@ -24,5 +24,5 @@ export function AnySpendStakeUpside({ loadOrder, mode = "modal", beneficiaryAddr
     const encodedData = generateEncodedDataForStaking(stakeAmount, beneficiaryAddress);
     return (_jsx(AnySpendCustom, { loadOrder: loadOrder, mode: mode, recipientAddress: beneficiaryAddress, orderType: "custom", dstChainId: base.id, dstToken: token, dstAmount: stakeAmount, contractAddress: stakingContractAddress, encodedData: encodedData, metadata: {
             action: `stake ${token.symbol}`,
-        }, header: header, onSuccess: onSuccess, showRecipient: true, activeTab: activeTab }));
+        }, header: header, onSuccess: onSuccess, showRecipient: true, activeTab: activeTab, clientReferenceId: clientReferenceId }));
 }

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

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

package/dist/esm/anyspend/react/components/AnySpendStakeUpsideExactIn.js

@@ -14,7 +14,7 @@ const STAKE_FOR_FUNCTION_ABI = JSON.stringify([
         outputs: [],
     },
 ]);
-export function AnySpendStakeUpsideExactIn({ loadOrder, mode = "modal", recipientAddress, sourceTokenAddress, sourceTokenChainId, stakingContractAddress, token, onSuccess, }) {
+export function AnySpendStakeUpsideExactIn({ loadOrder, mode = "modal", recipientAddress, sourceTokenAddress, sourceTokenChainId, stakingContractAddress, token, onSuccess, clientReferenceId, }) {
     if (!recipientAddress)
         return null;
     const header = () => (_jsx(_Fragment, { children: _jsx("div", { className: "from-b3-react-background to-as-on-surface-1 w-full rounded-t-lg bg-gradient-to-t", children: _jsx("div", { className: "mb-1 flex w-full flex-col items-center gap-2", children: _jsxs("span", { className: "font-sf-rounded text-2xl font-semibold", children: ["Swap & Stake ", token.symbol, " (Exact In)"] }) }) }) }));
@@ -26,5 +26,5 @@ export function AnySpendStakeUpsideExactIn({ loadOrder, mode = "modal", recipien
         spenderAddress: stakingContractAddress,
         action: `stake ${token.symbol}`,
     };
-    return (_jsx(AnySpendCustomExactIn, { loadOrder: loadOrder, mode: mode, recipientAddress: recipientAddress, sourceTokenAddress: sourceTokenAddress, sourceTokenChainId: sourceTokenChainId, destinationToken: token, destinationChainId: base.id, customExactInConfig: customExactInConfig, header: header, onSuccess: onSuccess }));
+    return (_jsx(AnySpendCustomExactIn, { loadOrder: loadOrder, mode: mode, recipientAddress: recipientAddress, sourceTokenAddress: sourceTokenAddress, sourceTokenChainId: sourceTokenChainId, destinationToken: token, destinationChainId: base.id, customExactInConfig: customExactInConfig, header: header, onSuccess: onSuccess, clientReferenceId: clientReferenceId }));
 }

package/dist/esm/anyspend/react/components/AnySpendTournament.d.ts

@@ -10,6 +10,7 @@ type AnySpendTournamentProps = {
     tournamentEntryToken: components["schemas"]["Token"];
     tournamentEntryFee: string;
     onSuccess?: () => void;
+    clientReferenceId?: string;
 } | {
     mode?: "modal" | "page";
     action: "fund";
@@ -20,6 +21,7 @@ type AnySpendTournamentProps = {
     tournamentFundToken: components["schemas"]["Token"];
     tournamentFundAmount: string;
     onSuccess?: () => void;
+    clientReferenceId?: string;
 };
 export declare function AnySpendTournament(props: AnySpendTournamentProps): import("react/jsx-runtime").JSX.Element;
 export {};