@b3dotfun/sdk 0.1.65-alpha.5 → 0.1.65-alpha.6

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

@@ -1,5 +1,5 @@
 import { components } from "../../../../anyspend/types/api";
-export declare function OrderTokenAmount({ disabled, inputValue, onChangeInput, context, address, chainId, setChainId, token, setToken, hideTokenSelect, canEditAmount, className, innerClassName, amountClassName, tokenSelectClassName, onTokenSelect, walletAddress, skipAutoMaxOnTokenChange, }: {
+export declare function OrderTokenAmount({ disabled, inputValue, onChangeInput, context, address, chainId, setChainId, token, setToken, hideTokenSelect, canEditAmount, className, innerClassName, amountClassName, tokenSelectClassName, onTokenSelect, }: {
     disabled?: boolean;
     inputValue: string;
     onChangeInput: (value: string) => void;
@@ -18,7 +18,4 @@ export declare function OrderTokenAmount({ disabled, inputValue, onChangeInput,
     onTokenSelect?: (token: components["schemas"]["Token"], event: {
         preventDefault: () => void;
     }) => void;
-    walletAddress?: string | undefined;
-    /** When true, skip auto-setting max balance when token changes (used for fixed destination amount mode) */
-    skipAutoMaxOnTokenChange?: boolean;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/esm/anyspend/react/components/common/OrderTokenAmount.js

@@ -1,63 +1,13 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ChevronsUpDown } from "lucide-react";
-import { useEffect, useRef } from "react";
 import { NumericFormat } from "react-number-format";
-import { formatUnits } from "viem";
 import { ALL_CHAINS, RELAY_SOLANA_MAINNET_CHAIN_ID, getAvailableChainIds } from "../../../../anyspend/index.js";
-import { getNativeRequired } from "../../../../anyspend/utils/chain.js";
-import { isNativeToken } from "../../../../anyspend/utils/token.js";
-import { Button, useTokenBalance } from "../../../../global-account/react/index.js";
+import { Button } from "../../../../global-account/react/index.js";
 import { cn } from "../../../../shared/utils/index.js";
 import { TokenSelector } from "@relayprotocol/relay-kit-ui";
 import { ChainTokenIcon } from "./ChainTokenIcon.js";
-export function OrderTokenAmount({ disabled, inputValue, onChangeInput, context, address, chainId, setChainId, token, setToken, hideTokenSelect = false, canEditAmount = true, className, innerClassName, amountClassName, tokenSelectClassName, onTokenSelect, walletAddress, skipAutoMaxOnTokenChange = false, }) {
-    // Track previous token to detect changes
-    const prevTokenRef = useRef(token.address);
-    // Only get token balance when context is "from" (for setting max amount)
-    const { rawBalance } = useTokenBalance({
-        token,
-        address: context === "from" && walletAddress ? walletAddress : undefined,
-    });
-    useEffect(() => {
-        // Only handle "from" context
-        if (context !== "from")
-            return;
-        // Skip auto-max when in fixed destination amount mode
-        if (skipAutoMaxOnTokenChange) {
-            prevTokenRef.current = token.address;
-            return;
-        }
-        // Check if token changed or if this is the initial load with balance
-        const isTokenChanged = prevTokenRef.current !== token.address;
-        if (isTokenChanged && rawBalance) {
-            console.log(`Setting max balance - Token: ${token.address}, Changed: ${isTokenChanged}`);
-            // Calculate max amount with gas reserve for native tokens
-            let maxAmount;
-            if (isNativeToken(token.address)) {
-                const gasReserve = getNativeRequired(token.chainId);
-                // Ensure we don't go negative
-                maxAmount = rawBalance > gasReserve ? rawBalance - gasReserve : BigInt(0);
-            }
-            else {
-                // For ERC20 tokens, use full balance
-                maxAmount = rawBalance;
-            }
-            // Set the max amount as input value
-            onChangeInput(formatUnits(maxAmount, token.decimals));
-            // Update refs
-            prevTokenRef.current = token.address;
-        }
-    }, [
-        token.address,
-        token.chainId,
-        token.decimals,
-        chainId,
-        context,
-        onChangeInput,
-        rawBalance,
-        skipAutoMaxOnTokenChange,
-    ]);
+export function OrderTokenAmount({ disabled, inputValue, onChangeInput, context, address, chainId, setChainId, token, setToken, hideTokenSelect = false, canEditAmount = true, className, innerClassName, amountClassName, tokenSelectClassName, onTokenSelect, }) {
     const handleTokenSelect = (newToken) => {
         const token = {
             address: newToken.address,
@@ -80,11 +30,7 @@ export function OrderTokenAmount({ disabled, inputValue, onChangeInput, context,
                 return; // Early return if callback prevented default behavior
             }
         }
-        // Mark that we're about to change tokens
-        prevTokenRef.current = "changing"; // Temporary value to force effect
-        // Set the chain ID first
         setChainId(newToken.chainId);
-        // Then set the new token - the useEffect will handle setting the max balance
         setToken(token);
     };
     return (_jsx("div", { className: cn("border-as-stroke flex w-full flex-col gap-2 rounded-xl", className), children: _jsxs("div", { className: cn("flex items-center justify-between gap-3", innerClassName), children: [!canEditAmount ? (_jsx("h2", { className: cn("text-3xl font-medium text-white", amountClassName), children: inputValue || "--" })) : (_jsx(NumericFormat, { decimalSeparator: ".", allowedDecimalSeparators: [","], thousandSeparator: true, inputMode: "decimal", autoComplete: "off", autoCorrect: "off", type: "text", placeholder: "0.00", minLength: 1, maxLength: 30, spellCheck: "false", className: cn("placeholder:text-as-primary/70 disabled:text-as-primary/70 text-as-primary w-full bg-transparent text-4xl font-semibold leading-[42px] outline-none sm:text-[30px]", amountClassName), pattern: "^[0-9]*[.,]?[0-9]*$", disabled: disabled, value: inputValue, allowNegative: false, onChange: e => onChangeInput(e.currentTarget.value) }, `input-${token.address}-${chainId}`)), !hideTokenSelect && (_jsx(TokenSelector, { address: address, chainIdsFilter: getAvailableChainIds(context), context: context, fromChainWalletVMSupported: true, isValidAddress: true, lockedChainIds: getAvailableChainIds(context), multiWalletSupportEnabled: true, onAnalyticEvent: undefined, popularChainIds: [1, 8453, RELAY_SOLANA_MAINNET_CHAIN_ID], setToken: handleTokenSelect, supportedWalletVMs: ["evm", "svm"], token: undefined, trigger: _jsxs(Button, { variant: "outline", role: "combobox", className: cn("token-selector-button bg-b3-react-background border-as-stroke flex h-auto w-fit shrink-0 items-center justify-center gap-2 rounded-xl border-2 px-2 py-1 pr-2 text-center", tokenSelectClassName), children: [token.metadata.logoURI ? (_jsx(ChainTokenIcon, { chainUrl: ALL_CHAINS[chainId].logoUrl, tokenUrl: token.metadata.logoURI, className: "h-8 min-h-8 w-8 min-w-8" })) : (_jsx("div", { className: "h-8 w-8 rounded-full bg-gray-700" })), _jsxs("div", { className: "flex flex-col items-start gap-0", children: [_jsx("div", { className: "text-as-primary font-semibold", children: token.symbol }), _jsx("div", { className: "text-as-primary/70 text-xs", children: ALL_CHAINS[chainId].name })] }), _jsx(ChevronsUpDown, { className: "h-4 w-4 shrink-0 opacity-70" })] }) }, `selector-${context}-${token.address}-${chainId}`))] }) }, `${context}-${token.address}-${chainId}`));

package/dist/esm/anyspend/react/components/common/PaySection.js

@@ -39,7 +39,7 @@ export function CryptoPaySection({ selectedSrcChainId, setSelectedSrcChainId, se
     useEffect(() => {
         appliedSrcMetadataRef.current = false;
     }, [selectedSrcToken.address, selectedSrcToken.chainId]);
-    return (_jsxs(motion.div, { initial: { opacity: 0, y: 20, filter: "blur(10px)" }, animate: { opacity: 1, y: 0, filter: "blur(0px)" }, transition: { duration: 0.3, delay: 0, ease: "easeInOut" }, className: "pay-section bg-as-surface-secondary border-as-border-secondary relative flex w-full flex-col gap-2 rounded-2xl border p-4 sm:p-6", children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx("div", { className: "text-as-primary/50 flex h-7 items-center text-sm", children: "Pay" }), _jsx("button", { className: "text-as-tertiarry flex h-7 items-center gap-2 text-sm transition-colors focus:!outline-none", onClick: onSelectCryptoPaymentMethod, children: selectedCryptoPaymentMethod === CryptoPaymentMethodType.CONNECT_WALLET ? (_jsxs(_Fragment, { children: [isConnected ? (_jsx("div", { className: "flex items-center gap-1", children: connectedName ? formatUsername(connectedName) : shortenAddress(connectedAddress || "") })) : ("Connect wallet"), _jsx(ChevronRight, { className: "h-4 w-4" })] })) : selectedCryptoPaymentMethod === CryptoPaymentMethodType.GLOBAL_WALLET ? (_jsxs(_Fragment, { children: ["Global Account", _jsx(ChevronRight, { className: "h-4 w-4" })] })) : selectedCryptoPaymentMethod === CryptoPaymentMethodType.TRANSFER_CRYPTO ? (_jsxs(_Fragment, { children: ["Transfer crypto", _jsx(ChevronRight, { className: "h-4 w-4" })] })) : (_jsxs(_Fragment, { children: ["Select payment method", _jsx(ChevronRight, { className: "h-4 w-4" })] })) })] }), _jsx(OrderTokenAmount, { address: connectedAddress, walletAddress: connectedAddress, context: "from", inputValue: srcAmount, onChangeInput: value => {
+    return (_jsxs(motion.div, { initial: { opacity: 0, y: 20, filter: "blur(10px)" }, animate: { opacity: 1, y: 0, filter: "blur(0px)" }, transition: { duration: 0.3, delay: 0, ease: "easeInOut" }, className: "pay-section bg-as-surface-secondary border-as-border-secondary relative flex w-full flex-col gap-2 rounded-2xl border p-4 sm:p-6", children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx("div", { className: "text-as-primary/50 flex h-7 items-center text-sm", children: "Pay" }), _jsx("button", { className: "text-as-tertiarry flex h-7 items-center gap-2 text-sm transition-colors focus:!outline-none", onClick: onSelectCryptoPaymentMethod, children: selectedCryptoPaymentMethod === CryptoPaymentMethodType.CONNECT_WALLET ? (_jsxs(_Fragment, { children: [isConnected ? (_jsx("div", { className: "flex items-center gap-1", children: connectedName ? formatUsername(connectedName) : shortenAddress(connectedAddress || "") })) : ("Connect wallet"), _jsx(ChevronRight, { className: "h-4 w-4" })] })) : selectedCryptoPaymentMethod === CryptoPaymentMethodType.GLOBAL_WALLET ? (_jsxs(_Fragment, { children: ["Global Account", _jsx(ChevronRight, { className: "h-4 w-4" })] })) : selectedCryptoPaymentMethod === CryptoPaymentMethodType.TRANSFER_CRYPTO ? (_jsxs(_Fragment, { children: ["Transfer crypto", _jsx(ChevronRight, { className: "h-4 w-4" })] })) : (_jsxs(_Fragment, { children: ["Select payment method", _jsx(ChevronRight, { className: "h-4 w-4" })] })) })] }), _jsx(OrderTokenAmount, { address: connectedAddress, context: "from", inputValue: srcAmount, onChangeInput: value => {
                     setIsSrcInputDirty(true);
                     setSrcAmount(value);
                 }, chainId: selectedSrcChainId, setChainId: setSelectedSrcChainId, token: selectedSrcToken, setToken: setSelectedSrcToken }), _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("div", { className: "text-as-primary/50 flex h-5 items-center text-sm", children: formatDisplayNumber(anyspendQuote?.data?.currencyIn?.amountUsd, {

package/dist/esm/anyspend/react/hooks/useAnyspendCreateOnrampOrder.js

@@ -71,6 +71,7 @@ export function useAnyspendCreateOnrampOrder({ onSuccess, onError } = {}) {
                     partnerId,
                     clientReferenceId,
                     visitorData,
+                    callbackMetadata: params.callbackMetadata,
                 });
             }
             catch (error) {

package/dist/esm/anyspend/react/hooks/useAnyspendCreateOrder.d.ts

@@ -18,6 +18,7 @@ export type CreateOrderParams = {
     creatorAddress?: string;
     payload?: any;
     metadata?: Record<string, any>;
+    callbackMetadata?: Record<string, unknown>;
 };
 export type UseAnyspendCreateOrderProps = {
     onSuccess?: (data: any) => void;

package/dist/esm/anyspend/react/hooks/useAnyspendCreateOrder.js

@@ -60,6 +60,7 @@ export function useAnyspendCreateOrder({ onSuccess, onError } = {}) {
                     partnerId,
                     clientReferenceId,
                     visitorData,
+                    callbackMetadata: params.callbackMetadata,
                 });
             }
             catch (error) {

package/dist/esm/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, partnerId?: string) => Promise<GetQuoteResponse>;
-    createOrder: ({ recipientAddress, type, srcChain, dstChain, srcTokenAddress, dstTokenAddress, srcAmount, payload, onramp, metadata, creatorAddress, partnerId, clientReferenceId, visitorData, }: {
+    createOrder: ({ recipientAddress, type, srcChain, dstChain, srcTokenAddress, dstTokenAddress, srcAmount, payload, onramp, metadata, creatorAddress, partnerId, clientReferenceId, visitorData, callbackMetadata, }: {
         recipientAddress: string;
         type: string;
         srcChain: number;
@@ -21,6 +21,7 @@ export declare const anyspendService: {
         partnerId?: string;
         clientReferenceId?: string;
         visitorData?: VisitorData;
+        callbackMetadata?: Record<string, unknown>;
     }) => Promise<{
         success: boolean;
         message: string;

package/dist/esm/anyspend/services/anyspend.js

@@ -36,7 +36,7 @@ export const anyspendService = {
         return data;
     },
     // Order related
-    createOrder: async ({ recipientAddress, type, srcChain, dstChain, srcTokenAddress, dstTokenAddress, srcAmount, payload, onramp, metadata, creatorAddress, partnerId, clientReferenceId, visitorData, }) => {
+    createOrder: async ({ recipientAddress, type, srcChain, dstChain, srcTokenAddress, dstTokenAddress, srcAmount, payload, onramp, metadata, creatorAddress, partnerId, clientReferenceId, visitorData, callbackMetadata, }) => {
         const accessToken = await app.authentication.getAccessToken();
         const response = await fetch(`${ANYSPEND_MAINNET_BASE_URL}/orders`, {
             method: "POST",
@@ -60,6 +60,7 @@ export const anyspendService = {
                 creatorAddress,
                 partnerId,
                 ...(clientReferenceId && { clientReferenceId }),
+                ...(callbackMetadata && { callbackMetadata }),
             }),
         });
         const data = await response.json();

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

@@ -536,6 +536,8 @@ export interface AnySpendDepositModalProps extends BaseModalProps {
     classes?: AnySpendAllClasses;
     /** Whether to allow direct transfer without swap */
     allowDirectTransfer?: boolean;
+    /** Opaque metadata passed to the order for callbacks (e.g., workflow form data) */
+    callbackMetadata?: Record<string, unknown>;
 }
 /**
  * Union type of all possible modal content types

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

@@ -53,4 +53,6 @@ export declare function AnySpend(props: {
     allowDirectTransfer?: boolean;
     /** Fixed destination token amount (in wei/smallest unit). When provided, user cannot change the amount. */
     destinationTokenAmount?: string;
+    /** Opaque metadata passed to the order for callbacks (e.g., workflow form data) */
+    callbackMetadata?: Record<string, unknown>;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -44,6 +44,8 @@ export interface AnySpendCustomExactInProps {
     classes?: AnySpendCustomExactInClasses;
     /** When true, allows direct transfer without swap if source and destination token/chain are the same */
     allowDirectTransfer?: boolean;
+    /** Opaque metadata passed to the order for callbacks (e.g., workflow form data) */
+    callbackMetadata?: Record<string, unknown>;
 }
 export declare function AnySpendCustomExactIn(props: AnySpendCustomExactInProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -101,6 +101,8 @@ export interface AnySpendDepositProps {
     allowDirectTransfer?: boolean;
     /** Fixed destination token amount (in wei/smallest unit). When provided, user cannot change the amount. */
     destinationTokenAmount?: string;
+    /** Opaque metadata passed to the order for callbacks (e.g., workflow form data) */
+    callbackMetadata?: Record<string, unknown>;
 }
 /**
  * A flexible deposit component that wraps AnySpendCustomExactIn with optional chain selection.
@@ -137,4 +139,4 @@ export interface AnySpendDepositProps {
  *   onSuccess={(amount) => console.log(`Deposited ${amount}`)}
  * />
  */
-export declare function AnySpendDeposit({ loadOrder, mode, recipientAddress, paymentType: initialPaymentType, sourceTokenAddress, sourceTokenChainId: initialSourceChainId, destinationTokenAddress, destinationTokenChainId, onSuccess, onOpenCustomModal, mainFooter, onTokenSelect, customUsdInputValues, preferEoa, minDestinationAmount, header, orderType, depositContractConfig, showChainSelection, supportedChains, minPoolSize, topChainsCount, onClose, returnToHomeUrl, customRecipientLabel, returnHomeLabel, isCustomDeposit, classes, allowDirectTransfer, destinationTokenAmount, }: AnySpendDepositProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AnySpendDeposit({ loadOrder, mode, recipientAddress, paymentType: initialPaymentType, sourceTokenAddress, sourceTokenChainId: initialSourceChainId, destinationTokenAddress, destinationTokenChainId, onSuccess, onOpenCustomModal, mainFooter, onTokenSelect, customUsdInputValues, preferEoa, minDestinationAmount, header, orderType, depositContractConfig, showChainSelection, supportedChains, minPoolSize, topChainsCount, onClose, returnToHomeUrl, customRecipientLabel, returnHomeLabel, isCustomDeposit, classes, allowDirectTransfer, destinationTokenAmount, callbackMetadata, }: AnySpendDepositProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -18,8 +18,6 @@ interface CryptoPaySectionProps {
     }) => void;
     onShowFeeDetail?: () => void;
     classes?: CryptoPaySectionClasses;
-    /** When true, skip auto-setting max balance when token changes (used for fixed destination amount mode) */
-    skipAutoMaxOnTokenChange?: boolean;
 }
-export declare function CryptoPaySection({ selectedSrcChainId, setSelectedSrcChainId, selectedSrcToken, setSelectedSrcToken, srcAmount, setSrcAmount, isSrcInputDirty, setIsSrcInputDirty, selectedCryptoPaymentMethod, onSelectCryptoPaymentMethod, anyspendQuote, onTokenSelect, onShowFeeDetail, classes, skipAutoMaxOnTokenChange, }: CryptoPaySectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function CryptoPaySection({ selectedSrcChainId, setSelectedSrcChainId, selectedSrcToken, setSelectedSrcToken, srcAmount, setSrcAmount, isSrcInputDirty, setIsSrcInputDirty, selectedCryptoPaymentMethod, onSelectCryptoPaymentMethod, anyspendQuote, onTokenSelect, onShowFeeDetail, classes, }: CryptoPaySectionProps): 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, walletAddress, skipAutoMaxOnTokenChange, }: {
+export declare function OrderTokenAmount({ disabled, inputValue, onChangeInput, context, address, chainId, setChainId, token, setToken, hideTokenSelect, canEditAmount, className, innerClassName, amountClassName, tokenSelectClassName, onTokenSelect, }: {
     disabled?: boolean;
     inputValue: string;
     onChangeInput: (value: string) => void;
@@ -18,7 +18,4 @@ export declare function OrderTokenAmount({ disabled, inputValue, onChangeInput,
     onTokenSelect?: (token: components["schemas"]["Token"], event: {
         preventDefault: () => void;
     }) => void;
-    walletAddress?: string | undefined;
-    /** When true, skip auto-setting max balance when token changes (used for fixed destination amount mode) */
-    skipAutoMaxOnTokenChange?: boolean;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -18,6 +18,7 @@ export type CreateOrderParams = {
     creatorAddress?: string;
     payload?: any;
     metadata?: Record<string, any>;
+    callbackMetadata?: Record<string, unknown>;
 };
 export type UseAnyspendCreateOrderProps = {
     onSuccess?: (data: any) => void;

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, partnerId?: string) => Promise<GetQuoteResponse>;
-    createOrder: ({ recipientAddress, type, srcChain, dstChain, srcTokenAddress, dstTokenAddress, srcAmount, payload, onramp, metadata, creatorAddress, partnerId, clientReferenceId, visitorData, }: {
+    createOrder: ({ recipientAddress, type, srcChain, dstChain, srcTokenAddress, dstTokenAddress, srcAmount, payload, onramp, metadata, creatorAddress, partnerId, clientReferenceId, visitorData, callbackMetadata, }: {
         recipientAddress: string;
         type: string;
         srcChain: number;
@@ -21,6 +21,7 @@ export declare const anyspendService: {
         partnerId?: string;
         clientReferenceId?: string;
         visitorData?: VisitorData;
+        callbackMetadata?: Record<string, unknown>;
     }) => Promise<{
         success: boolean;
         message: string;

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

@@ -536,6 +536,8 @@ export interface AnySpendDepositModalProps extends BaseModalProps {
     classes?: AnySpendAllClasses;
     /** Whether to allow direct transfer without swap */
     allowDirectTransfer?: boolean;
+    /** Opaque metadata passed to the order for callbacks (e.g., workflow form data) */
+    callbackMetadata?: Record<string, unknown>;
 }
 /**
  * Union type of all possible modal content types

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b3dotfun/sdk",
-  "version": "0.1.65-alpha.5",
+  "version": "0.1.65-alpha.6",
   "source": "src/index.ts",
   "main": "./dist/cjs/index.js",
   "react-native": "./dist/cjs/index.native.js",

package/src/anyspend/react/components/AnySpend.tsx

@@ -127,6 +127,8 @@ export function AnySpend(props: {
   allowDirectTransfer?: boolean;
   /** Fixed destination token amount (in wei/smallest unit). When provided, user cannot change the amount. */
   destinationTokenAmount?: string;
+  /** Opaque metadata passed to the order for callbacks (e.g., workflow form data) */
+  callbackMetadata?: Record<string, unknown>;
 }) {
   const fingerprintConfig = getFingerprintConfig();
 
@@ -159,6 +161,7 @@ function AnySpendInner({
   classes,
   allowDirectTransfer = false,
   destinationTokenAmount,
+  callbackMetadata,
 }: {
   sourceChainId?: number;
   destinationTokenAddress?: string;
@@ -180,6 +183,7 @@ function AnySpendInner({
   classes?: AnySpendClasses;
   allowDirectTransfer?: boolean;
   destinationTokenAmount?: string;
+  callbackMetadata?: Record<string, unknown>;
 }) {
   const searchParams = useSearchParamsSSR();
   const router = useRouter();
@@ -966,6 +970,7 @@ function AnySpendInner({
         srcAmount: srcAmountBigInt.toString(),
         expectedDstAmount: anyspendQuote?.data?.currencyOut?.amount || "0",
         creatorAddress: globalAddress,
+        callbackMetadata,
       });
     } catch (err: any) {
       console.error(err);
@@ -1043,6 +1048,7 @@ function AnySpendInner({
         },
         expectedDstAmount: anyspendQuote?.data?.currencyOut?.amount?.toString() || "0",
         creatorAddress: globalAddress,
+        callbackMetadata,
       });
     } catch (err: any) {
       console.error(err);
@@ -1214,7 +1220,6 @@ function AnySpendInner({
               anyspendQuote={anyspendQuote}
               onTokenSelect={onTokenSelect}
               onShowFeeDetail={() => navigateToPanel(PanelView.FEE_DETAIL, "forward")}
-              skipAutoMaxOnTokenChange={!!destinationTokenAmount}
             />
           ) : (
             <motion.div

package/src/anyspend/react/components/AnySpendCustomExactIn.tsx

@@ -83,6 +83,8 @@ export interface AnySpendCustomExactInProps {
   classes?: AnySpendCustomExactInClasses;
   /** When true, allows direct transfer without swap if source and destination token/chain are the same */
   allowDirectTransfer?: boolean;
+  /** Opaque metadata passed to the order for callbacks (e.g., workflow form data) */
+  callbackMetadata?: Record<string, unknown>;
 }
 
 export function AnySpendCustomExactIn(props: AnySpendCustomExactInProps) {
@@ -120,6 +122,7 @@ function AnySpendCustomExactInInner({
   returnHomeLabel,
   classes,
   allowDirectTransfer = false,
+  callbackMetadata,
 }: AnySpendCustomExactInProps) {
   const actionLabel = customExactInConfig?.action ?? "Custom Execution";
   const setB3ModalOpen = useModalStore(state => state.setB3ModalOpen);
@@ -418,7 +421,6 @@ function AnySpendCustomExactInInner({
               onSelectCryptoPaymentMethod={() => setActivePanel(PanelView.CRYPTO_PAYMENT_METHOD)}
               anyspendQuote={anyspendQuote}
               onTokenSelect={onTokenSelect}
-              skipAutoMaxOnTokenChange={!!destinationTokenAmount}
             />
           ) : (
             <motion.div
@@ -587,6 +589,7 @@ function AnySpendCustomExactInInner({
               ? normalizeAddress(customExactInConfig.spenderAddress)
               : undefined,
           },
+          callbackMetadata,
         });
       } else {
         // EXACT_INPUT mode: create custom_exact_in order (original behavior)
@@ -604,6 +607,7 @@ function AnySpendCustomExactInInner({
           expectedDstAmount: expectedDstAmountRaw,
           creatorAddress: globalAddress,
           payload,
+          callbackMetadata,
         });
       }
     } catch (err: any) {

package/src/anyspend/react/components/AnySpendDeposit.tsx

@@ -123,6 +123,8 @@ export interface AnySpendDepositProps {
   allowDirectTransfer?: boolean;
   /** Fixed destination token amount (in wei/smallest unit). When provided, user cannot change the amount. */
   destinationTokenAmount?: string;
+  /** Opaque metadata passed to the order for callbacks (e.g., workflow form data) */
+  callbackMetadata?: Record<string, unknown>;
 }
 
 // Default supported chains
@@ -248,6 +250,7 @@ export function AnySpendDeposit({
   classes,
   allowDirectTransfer = false,
   destinationTokenAmount,
+  callbackMetadata,
 }: AnySpendDepositProps) {
   // Extract deposit-specific classes for convenience
   const depositClasses = classes?.deposit;
@@ -697,6 +700,7 @@ export function AnySpendDeposit({
             classes={classes?.customExactIn}
             allowDirectTransfer={allowDirectTransfer}
             destinationTokenAmount={destinationTokenAmount}
+            callbackMetadata={callbackMetadata}
           />
         ) : (
           <AnySpend
@@ -720,6 +724,7 @@ export function AnySpendDeposit({
             classes={classes?.anySpend}
             allowDirectTransfer={allowDirectTransfer}
             destinationTokenAmount={destinationTokenAmount}
+            callbackMetadata={callbackMetadata}
           />
         )}
       </div>

package/src/anyspend/react/components/common/CryptoPaySection.tsx

@@ -32,8 +32,6 @@ interface CryptoPaySectionProps {
   onShowFeeDetail?: () => void;
   // Custom classes for styling
   classes?: CryptoPaySectionClasses;
-  /** When true, skip auto-setting max balance when token changes (used for fixed destination amount mode) */
-  skipAutoMaxOnTokenChange?: boolean;
 }
 
 export function CryptoPaySection({
@@ -51,7 +49,6 @@ export function CryptoPaySection({
   onTokenSelect,
   onShowFeeDetail,
   classes,
-  skipAutoMaxOnTokenChange = false,
 }: CryptoPaySectionProps) {
   const { data: srcTokenMetadata } = useTokenData(selectedSrcToken?.chainId, selectedSrcToken?.address);
 
@@ -125,7 +122,6 @@ export function CryptoPaySection({
       <div className={classes?.inputContainer}>
         <OrderTokenAmount
           address={walletAddress}
-          walletAddress={walletAddress}
           context="from"
           inputValue={srcAmount}
           onChangeInput={value => {
@@ -137,7 +133,6 @@ export function CryptoPaySection({
           token={selectedSrcToken}
           setToken={setSelectedSrcToken}
           onTokenSelect={onTokenSelect}
-          skipAutoMaxOnTokenChange={skipAutoMaxOnTokenChange}
         />
       </div>
       <div className={classes?.balanceRow || "flex items-center justify-between"}>

package/src/anyspend/react/components/common/OrderTokenAmount.tsx

@@ -1,15 +1,11 @@
 "use client";
 
 import { ChevronsUpDown } from "lucide-react";
-import { useEffect, useRef } from "react";
 import { NumericFormat } from "react-number-format";
-import { formatUnits } from "viem";
 
 import { ALL_CHAINS, RELAY_SOLANA_MAINNET_CHAIN_ID, getAvailableChainIds } from "@b3dotfun/sdk/anyspend";
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
-import { getNativeRequired } from "@b3dotfun/sdk/anyspend/utils/chain";
-import { isNativeToken } from "@b3dotfun/sdk/anyspend/utils/token";
-import { Button, useTokenBalance } from "@b3dotfun/sdk/global-account/react";
+import { Button } from "@b3dotfun/sdk/global-account/react";
 import { cn } from "@b3dotfun/sdk/shared/utils";
 import { TokenSelector } from "@relayprotocol/relay-kit-ui";
 import { ChainTokenIcon } from "./ChainTokenIcon";
@@ -31,8 +27,6 @@ export function OrderTokenAmount({
   amountClassName,
   tokenSelectClassName,
   onTokenSelect,
-  walletAddress,
-  skipAutoMaxOnTokenChange = false,
 }: {
   disabled?: boolean;
   inputValue: string;
@@ -50,64 +44,7 @@ export function OrderTokenAmount({
   amountClassName?: string;
   tokenSelectClassName?: string;
   onTokenSelect?: (token: components["schemas"]["Token"], event: { preventDefault: () => void }) => void;
-  walletAddress?: string | undefined;
-  /** When true, skip auto-setting max balance when token changes (used for fixed destination amount mode) */
-  skipAutoMaxOnTokenChange?: boolean;
 }) {
-  // Track previous token to detect changes
-  const prevTokenRef = useRef<string>(token.address);
-
-  // Only get token balance when context is "from" (for setting max amount)
-  const { rawBalance } = useTokenBalance({
-    token,
-    address: context === "from" && walletAddress ? walletAddress : undefined,
-  });
-
-  useEffect(() => {
-    // Only handle "from" context
-    if (context !== "from") return;
-
-    // Skip auto-max when in fixed destination amount mode
-    if (skipAutoMaxOnTokenChange) {
-      prevTokenRef.current = token.address;
-      return;
-    }
-
-    // Check if token changed or if this is the initial load with balance
-    const isTokenChanged = prevTokenRef.current !== token.address;
-
-    if (isTokenChanged && rawBalance) {
-      console.log(`Setting max balance - Token: ${token.address}, Changed: ${isTokenChanged}`);
-
-      // Calculate max amount with gas reserve for native tokens
-      let maxAmount: bigint;
-
-      if (isNativeToken(token.address)) {
-        const gasReserve = getNativeRequired(token.chainId);
-        // Ensure we don't go negative
-        maxAmount = rawBalance > gasReserve ? rawBalance - gasReserve : BigInt(0);
-      } else {
-        // For ERC20 tokens, use full balance
-        maxAmount = rawBalance;
-      }
-
-      // Set the max amount as input value
-      onChangeInput(formatUnits(maxAmount, token.decimals));
-
-      // Update refs
-      prevTokenRef.current = token.address;
-    }
-  }, [
-    token.address,
-    token.chainId,
-    token.decimals,
-    chainId,
-    context,
-    onChangeInput,
-    rawBalance,
-    skipAutoMaxOnTokenChange,
-  ]);
-
   const handleTokenSelect = (newToken: any) => {
     const token: components["schemas"]["Token"] = {
       address: newToken.address,
@@ -134,13 +71,7 @@ export function OrderTokenAmount({
       }
     }
 
-    // Mark that we're about to change tokens
-    prevTokenRef.current = "changing"; // Temporary value to force effect
-
-    // Set the chain ID first
     setChainId(newToken.chainId);
-
-    // Then set the new token - the useEffect will handle setting the max balance
     setToken(token);
   };
 

package/src/anyspend/react/components/common/PaySection.tsx

@@ -116,7 +116,6 @@ export function CryptoPaySection({
       </div>
       <OrderTokenAmount
         address={connectedAddress}
-        walletAddress={connectedAddress}
         context="from"
         inputValue={srcAmount}
         onChangeInput={value => {

package/src/anyspend/react/hooks/useAnyspendCreateOnrampOrder.ts

@@ -113,6 +113,7 @@ export function useAnyspendCreateOnrampOrder({ onSuccess, onError }: UseAnyspend
           partnerId,
           clientReferenceId,
           visitorData,
+          callbackMetadata: params.callbackMetadata,
         });
       } catch (error: any) {
         // If the error has a response with message and statusCode, throw that

package/src/anyspend/react/hooks/useAnyspendCreateOrder.ts

@@ -22,6 +22,7 @@ export type CreateOrderParams = {
   creatorAddress?: string;
   payload?: any;
   metadata?: Record<string, any>;
+  callbackMetadata?: Record<string, unknown>;
 };
 
 export type UseAnyspendCreateOrderProps = {
@@ -87,6 +88,7 @@ export function useAnyspendCreateOrder({ onSuccess, onError }: UseAnyspendCreate
           partnerId,
           clientReferenceId,
           visitorData,
+          callbackMetadata: params.callbackMetadata,
         });
       } catch (error: any) {
         // If the error has a response with message and statusCode, throw that

package/src/anyspend/services/anyspend.ts

@@ -70,6 +70,7 @@ export const anyspendService = {
     partnerId,
     clientReferenceId,
     visitorData,
+    callbackMetadata,
   }: {
     recipientAddress: string;
     type: string;
@@ -85,6 +86,7 @@ export const anyspendService = {
     partnerId?: string;
     clientReferenceId?: string;
     visitorData?: VisitorData;
+    callbackMetadata?: Record<string, unknown>;
   }) => {
     const accessToken = await app.authentication.getAccessToken();
     const response = await fetch(`${ANYSPEND_MAINNET_BASE_URL}/orders`, {
@@ -109,6 +111,7 @@ export const anyspendService = {
         creatorAddress,
         partnerId,
         ...(clientReferenceId && { clientReferenceId }),
+        ...(callbackMetadata && { callbackMetadata }),
       }),
     });
     const data: CreateOrderResponse = await response.json();

package/src/global-account/react/stores/useModalStore.ts

@@ -562,6 +562,8 @@ export interface AnySpendDepositModalProps extends BaseModalProps {
   classes?: AnySpendAllClasses;
   /** Whether to allow direct transfer without swap */
   allowDirectTransfer?: boolean;
+  /** Opaque metadata passed to the order for callbacks (e.g., workflow form data) */
+  callbackMetadata?: Record<string, unknown>;
 }
 
 /**