@b3dotfun/sdk 0.0.70 → 0.0.71-alpha.0

package/dist/esm/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/esm/anyspend/utils/validation.js

@@ -0,0 +1,153 @@
+/**
+ * Generic string validator with configurable rules
+ */
+export 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
+ */
+export const 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
+ */
+export const Validators = {
+    /**
+     * Validates client reference IDs (alphanumeric + safe chars)
+     * Returns undefined if not provided
+     */
+    clientReferenceId: (value) => validateString(value, {
+        required: false,
+        maxLength: 255,
+        pattern: 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: 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: 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: 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/esm/global-account/react/components/B3DynamicModal.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { AnySpend, AnySpendBondKit, AnySpendBuySpin, AnySpendNFT, AnyspendSignatureMint, AnySpendStakeB3, AnySpendStakeB3ExactIn, AnySpendTournament, OrderHistory, } from "../../../anyspend/react/index.js";
+import { AnySpend, AnySpendBondKit, AnySpendBuySpin, AnySpendCollectorClubPurchase, AnySpendNFT, AnyspendSignatureMint, AnySpendStakeB3, AnySpendStakeB3ExactIn, AnySpendTournament, OrderHistory, } from "../../../anyspend/react/index.js";
 import { AnySpendDepositHype } from "../../../anyspend/react/components/AnyspendDepositHype.js";
 import { AnySpendStakeUpside } from "../../../anyspend/react/components/AnySpendStakeUpside.js";
 import { AnySpendStakeUpsideExactIn } from "../../../anyspend/react/components/AnySpendStakeUpsideExactIn.js";
@@ -115,6 +115,8 @@ export function B3DynamicModal() {
                 return _jsx(LinkAccount, { ...contentType });
             case "anySpendDepositHype":
                 return _jsx(AnySpendDepositHype, { ...contentType, mode: "modal" });
+            case "anySpendCollectorClubPurchase":
+                return _jsx(AnySpendCollectorClubPurchase, { ...contentType, mode: "modal" });
             case "avatarEditor":
                 return _jsx(AvatarEditor, { onSetAvatar: contentType.onSuccess });
             case "profileEditor":

package/dist/esm/global-account/react/components/B3Provider/B3Provider.d.ts

@@ -7,7 +7,7 @@ import { B3ContextType } from "./types";
 /**
  * Main B3Provider component
  */
-export declare function B3Provider({ theme, children, accountOverride, environment, automaticallySetFirstEoa, simDuneApiKey, toaster, clientType, rpcUrls, partnerId, onConnect, connectors, overrideDefaultConnectors, }: {
+export declare function B3Provider({ theme, children, accountOverride, environment, automaticallySetFirstEoa, simDuneApiKey, toaster, clientType, rpcUrls, partnerId, onConnect, connectors, overrideDefaultConnectors, createClientReferenceId, }: {
     theme: "light" | "dark";
     children: React.ReactNode;
     accountOverride?: Account;
@@ -24,11 +24,12 @@ export declare function B3Provider({ theme, children, accountOverride, environme
     onConnect?: (wallet: Wallet, b3Jwt: string) => void | Promise<void>;
     connectors?: CreateConnectorFn[];
     overrideDefaultConnectors?: boolean;
+    createClientReferenceId?: () => string;
 }): import("react/jsx-runtime").JSX.Element;
 /**
  * Inner provider component that provides the actual B3Context
  */
-export declare function InnerProvider({ children, accountOverride, environment, defaultPermissions, automaticallySetFirstEoa, theme, clientType, partnerId, }: {
+export declare function InnerProvider({ children, accountOverride, environment, defaultPermissions, automaticallySetFirstEoa, theme, clientType, partnerId, createClientReferenceId, }: {
     children: React.ReactNode;
     accountOverride?: Account;
     environment: B3ContextType["environment"];
@@ -37,4 +38,5 @@ export declare function InnerProvider({ children, accountOverride, environment,
     theme: "light" | "dark";
     clientType?: ClientType;
     partnerId: string;
+    createClientReferenceId?: () => string;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/esm/global-account/react/components/B3Provider/B3Provider.js

@@ -28,7 +28,7 @@ const queryClient = new QueryClient();
 /**
  * Main B3Provider component
  */
-export function B3Provider({ theme = "light", children, accountOverride, environment, automaticallySetFirstEoa, simDuneApiKey, toaster, clientType = "rest", rpcUrls, partnerId, onConnect, connectors, overrideDefaultConnectors = false, }) {
+export function B3Provider({ theme = "light", children, accountOverride, environment, automaticallySetFirstEoa, simDuneApiKey, toaster, clientType = "rest", rpcUrls, partnerId, onConnect, connectors, overrideDefaultConnectors = false, createClientReferenceId, }) {
     // Initialize Google Analytics on mount
     useEffect(() => {
         loadGA4Script();
@@ -38,12 +38,12 @@ export function B3Provider({ theme = "light", children, accountOverride, environ
         setClientType(clientType);
     }, [clientType]);
     const wagmiConfig = createWagmiConfig({ partnerId, rpcUrls, connectors, overrideDefaultConnectors });
-    return (_jsx(ThirdwebProvider, { children: _jsx(WagmiProvider, { config: wagmiConfig, reconnectOnMount: false, children: _jsx(QueryClientProvider, { client: queryClient, children: _jsx(TooltipProvider, { children: _jsx(LocalSDKProvider, { onConnectCallback: onConnect, children: _jsx(InnerProvider, { accountOverride: accountOverride, environment: environment, theme: theme, automaticallySetFirstEoa: !!automaticallySetFirstEoa, clientType: clientType, partnerId: partnerId, children: _jsxs(RelayKitProviderWrapper, { simDuneApiKey: simDuneApiKey, children: [children, _jsx(StyleRoot, { id: "b3-root" }), _jsx(Toaster, { theme: theme, position: toaster?.position, style: toaster?.style })] }) }) }) }) }) }) }));
+    return (_jsx(ThirdwebProvider, { children: _jsx(WagmiProvider, { config: wagmiConfig, reconnectOnMount: false, children: _jsx(QueryClientProvider, { client: queryClient, children: _jsx(TooltipProvider, { children: _jsx(LocalSDKProvider, { onConnectCallback: onConnect, children: _jsx(InnerProvider, { accountOverride: accountOverride, environment: environment, theme: theme, automaticallySetFirstEoa: !!automaticallySetFirstEoa, clientType: clientType, partnerId: partnerId, createClientReferenceId: createClientReferenceId, children: _jsxs(RelayKitProviderWrapper, { simDuneApiKey: simDuneApiKey, children: [children, _jsx(StyleRoot, { id: "b3-root" }), _jsx(Toaster, { theme: theme, position: toaster?.position, style: toaster?.style })] }) }) }) }) }) }) }));
 }
 /**
  * Inner provider component that provides the actual B3Context
  */
-export function InnerProvider({ children, accountOverride, environment, defaultPermissions = DEFAULT_PERMISSIONS, automaticallySetFirstEoa, theme = "light", clientType = "socket", partnerId, }) {
+export function InnerProvider({ children, accountOverride, environment, defaultPermissions = DEFAULT_PERMISSIONS, automaticallySetFirstEoa, theme = "light", clientType = "socket", partnerId, createClientReferenceId, }) {
     const activeAccount = useActiveAccount();
     const [manuallySelectedWallet, setManuallySelectedWallet] = useState(undefined);
     const wallets = useConnectedWallets();
@@ -97,6 +97,7 @@ export function InnerProvider({ children, accountOverride, environment, defaultP
             theme,
             clientType,
             partnerId: partnerId,
+            createClientReferenceId,
         }, children: _jsx(InnerProvider2, { children: children }) }));
 }
 const InnerProvider2 = ({ children }) => {

package/dist/esm/global-account/react/components/B3Provider/types.d.ts

@@ -20,6 +20,7 @@ export interface B3ContextType {
     theme: "light" | "dark";
     clientType: ClientType;
     partnerId: string;
+    createClientReferenceId?: () => string;
 }
 /**
  * Context for B3 provider

package/dist/esm/global-account/react/components/B3Provider/types.js

@@ -16,4 +16,5 @@ export const B3Context = createContext({
     theme: "light",
     clientType: "rest",
     partnerId: "",
+    createClientReferenceId: undefined,
 });

package/dist/esm/global-account/react/hooks/useAuthentication.d.ts

@@ -13,8 +13,8 @@ export declare function useAuthentication(partnerId: string): {
     onConnect: (_walleAutoConnectedWith: Wallet, allConnectedWallets: Wallet[]) => Promise<void>;
     user: {
         email?: string | undefined;
-        username?: string | undefined;
         telNumber?: string | undefined;
+        username?: string | undefined;
         ens?: string | undefined;
         avatar?: string | undefined;
         preferences?: {} | undefined;

package/dist/esm/global-account/react/hooks/useUserQuery.d.ts

@@ -8,8 +8,8 @@ import { Users } from "@b3dotfun/b3-api";
 export declare function useUserQuery(): {
     user: {
         email?: string | undefined;
-        username?: string | undefined;
         telNumber?: string | undefined;
+        username?: string | undefined;
         ens?: string | undefined;
         avatar?: string | undefined;
         preferences?: {} | undefined;

package/dist/esm/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
@@ -377,10 +381,32 @@ export interface ProfileEditorModalProps extends BaseModalProps {
     /** Callback function called when profile is successfully updated */
     onSuccess?: () => void;
 }
+/**
+ * Props for the AnySpend Collector Club Purchase modal
+ * Handles Collector Club pack purchases
+ */
+export interface AnySpendCollectorClubPurchaseProps extends BaseModalProps {
+    /** Modal type identifier */
+    type: "anySpendCollectorClubPurchase";
+    /** The pack ID to purchase */
+    packId: number;
+    /** The number of packs to purchase */
+    packAmount: number;
+    /** Price per pack in wei (e.g., "10000" for 0.01 USDC with 6 decimals) */
+    pricePerPack: string;
+    /** Recipient address to receive the packs */
+    recipientAddress: string;
+    /** Payment type - crypto or fiat */
+    paymentType?: "crypto" | "fiat";
+    /** Callback function called when the purchase is successful */
+    onSuccess?: (txHash?: string) => void;
+    /** Client-provided reference ID for tracking orders */
+    clientReferenceId?: string;
+}
 /**
  * Union type of all possible modal content types
  */
-export type ModalContentType = SignInWithB3ModalProps | RequestPermissionsModalProps | ManageAccountModalProps | AnySpendModalProps | AnyspendOrderDetailsProps | AnySpendNftProps | AnySpendJoinTournamentProps | AnySpendFundTournamentProps | AnySpendOrderHistoryProps | AnySpendStakeB3Props | AnySpendStakeB3ExactInProps | AnySpendStakeUpsideProps | AnySpendStakeUpsideExactInProps | AnySpendDepositUpsideProps | AnySpendBuySpinProps | AnySpendSignatureMintProps | AnySpendBondKitProps | LinkAccountModalProps | AnySpendDepositHypeProps | AvatarEditorModalProps | ProfileEditorModalProps;
+export type ModalContentType = SignInWithB3ModalProps | RequestPermissionsModalProps | ManageAccountModalProps | AnySpendModalProps | AnyspendOrderDetailsProps | AnySpendNftProps | AnySpendJoinTournamentProps | AnySpendFundTournamentProps | AnySpendOrderHistoryProps | AnySpendStakeB3Props | AnySpendStakeB3ExactInProps | AnySpendStakeUpsideProps | AnySpendStakeUpsideExactInProps | AnySpendDepositUpsideProps | AnySpendBuySpinProps | AnySpendSignatureMintProps | AnySpendBondKitProps | LinkAccountModalProps | AnySpendDepositHypeProps | AvatarEditorModalProps | ProfileEditorModalProps | AnySpendCollectorClubPurchaseProps;
 /**
  * State interface for the modal store
  */

package/dist/types/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/types/anyspend/react/components/AnySpendCollectorClubPurchase.d.ts

@@ -0,0 +1,57 @@
+import { components } from "@b3dotfun/sdk/anyspend/types/api";
+import { GetQuoteResponse } from "@b3dotfun/sdk/anyspend/types/api_req_res";
+import React from "react";
+export interface AnySpendCollectorClubPurchaseProps {
+    /**
+     * Optional order ID to load existing order
+     */
+    loadOrder?: string;
+    /**
+     * Display mode
+     */
+    mode?: "modal" | "page";
+    /**
+     * Active tab (crypto or fiat payment)
+     */
+    activeTab?: "crypto" | "fiat";
+    /**
+     * The pack ID to purchase
+     */
+    packId: number;
+    /**
+     * The number of packs to purchase
+     */
+    packAmount: number;
+    /**
+     * Price per pack in wei (e.g., "10000" for 0.01 USDC with 6 decimals)
+     */
+    pricePerPack: string;
+    /**
+     * The payment token (defaults to USDC on Base)
+     */
+    paymentToken?: components["schemas"]["Token"];
+    /**
+     * Address that will receive the packs
+     */
+    recipientAddress: string;
+    /**
+     * Optional spender address (defaults to contract address)
+     */
+    spenderAddress?: string;
+    /**
+     * Success callback
+     */
+    onSuccess?: (txHash?: string) => void;
+    /**
+     * Optional custom header component
+     */
+    header?: (props: {
+        anyspendPrice: GetQuoteResponse | undefined;
+        isLoadingAnyspendPrice: boolean;
+    }) => React.JSX.Element;
+    /**
+     * Show recipient selection (default: true)
+     */
+    showRecipient?: boolean;
+}
+export declare function AnySpendCollectorClubPurchase({ loadOrder, mode, activeTab, packId, packAmount, pricePerPack, paymentToken, recipientAddress, spenderAddress, onSuccess, header, showRecipient, }: AnySpendCollectorClubPurchaseProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,6 +1,7 @@
 export { AnySpend } from "./AnySpend";
 export { AnySpendBondKit } from "./AnySpendBondKit";
 export { AnySpendBuySpin } from "./AnySpendBuySpin";
+export { AnySpendCollectorClubPurchase } from "./AnySpendCollectorClubPurchase";
 export { AnySpendCustom } from "./AnySpendCustom";
 export { AnySpendCustomExactIn } from "./AnySpendCustomExactIn";
 export { AnySpendDepositHype, HYPE_TOKEN_DETAILS } from "./AnyspendDepositHype";

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

@@ -16,6 +16,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -45,6 +46,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -74,6 +76,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -103,6 +106,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -132,6 +136,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -161,6 +166,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -190,6 +196,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -219,6 +226,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -251,6 +259,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -280,6 +289,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -309,6 +319,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -338,6 +349,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -367,6 +379,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -396,6 +409,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -425,6 +439,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
@@ -454,6 +469,7 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         receivedDepositAt: number | null;
         creatorAddress: string | null;
         partnerId: string | null;
+        clientReferenceId?: string | null;
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;

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

@@ -48,8 +48,8 @@ export declare const useGenerateSigMintData: ({ recipientAddress, contractAddres
             creatorMap?: {} | undefined;
             chainId: number;
             address: string;
-            title: string;
             _id: string | {};
+            title: string;
         };
     } | null;
     error: Error | null;

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

@@ -0,0 +1,5 @@
+/**
+ * Hook that provides a validated client reference ID
+ * Gets the createClientReferenceId function from B3 context and validates the result
+ */
+export declare function useValidatedClientReferenceId(): string | undefined;

package/dist/types/anyspend/services/anyspend.d.ts

@@ -6,7 +6,7 @@ export declare const anyspendService: {
     getTokenList: (chainId: number, query: string) => Promise<components["schemas"]["Token"][]>;
     getToken: (chainId: number, tokenAddress: string) => Promise<components["schemas"]["Token"]>;
     getQuote: (req: GetQuoteRequest) => Promise<GetQuoteResponse>;
-    createOrder: ({ recipientAddress, type, srcChain, dstChain, srcTokenAddress, dstTokenAddress, srcAmount, payload, onramp, metadata, creatorAddress, partnerId, visitorData, }: {
+    createOrder: ({ recipientAddress, type, srcChain, dstChain, srcTokenAddress, dstTokenAddress, srcAmount, payload, onramp, metadata, creatorAddress, partnerId, clientReferenceId, visitorData, }: {
         recipientAddress: string;
         type: string;
         srcChain: number;
@@ -19,6 +19,7 @@ export declare const anyspendService: {
         metadata: Record<string, any>;
         creatorAddress?: string;
         partnerId?: string;
+        clientReferenceId?: string;
         visitorData?: VisitorData;
     }) => Promise<{
         success: boolean;