@b3dotfun/sdk 0.1.65 → 0.1.66-alpha.1

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

@@ -7451,6 +7451,8 @@ export declare function useFirstEOA(chain?: {
             [x: `bool[${string}]`]: undefined;
             [x: `bytes[${string}]`]: undefined;
             [x: `bytes1[${string}]`]: undefined;
+            [x: `bytes4[${string}]`]: undefined;
+            [x: `bytes30[${string}]`]: undefined;
             [x: `bytes18[${string}]`]: undefined;
             [x: `bytes6[${string}]`]: undefined;
             [x: `bytes9[${string}]`]: undefined;
@@ -7458,7 +7460,6 @@ export declare function useFirstEOA(chain?: {
             [x: `bytes10[${string}]`]: undefined;
             [x: `bytes2[${string}]`]: undefined;
             [x: `bytes3[${string}]`]: undefined;
-            [x: `bytes4[${string}]`]: undefined;
             [x: `bytes5[${string}]`]: undefined;
             [x: `bytes7[${string}]`]: undefined;
             [x: `bytes11[${string}]`]: undefined;
@@ -7479,7 +7480,6 @@ export declare function useFirstEOA(chain?: {
             [x: `bytes27[${string}]`]: undefined;
             [x: `bytes28[${string}]`]: undefined;
             [x: `bytes29[${string}]`]: undefined;
-            [x: `bytes30[${string}]`]: undefined;
             [x: `bytes31[${string}]`]: undefined;
             [x: `bytes32[${string}]`]: undefined;
             [x: `int[${string}]`]: undefined;
@@ -7553,6 +7553,8 @@ export declare function useFirstEOA(chain?: {
             bool?: undefined;
             bytes?: undefined;
             bytes1?: undefined;
+            bytes4?: undefined;
+            bytes30?: undefined;
             bytes18?: undefined;
             bytes6?: undefined;
             bytes9?: undefined;
@@ -7560,7 +7562,6 @@ export declare function useFirstEOA(chain?: {
             bytes10?: undefined;
             bytes2?: undefined;
             bytes3?: undefined;
-            bytes4?: undefined;
             bytes5?: undefined;
             bytes7?: undefined;
             bytes11?: undefined;
@@ -7581,7 +7582,6 @@ export declare function useFirstEOA(chain?: {
             bytes27?: undefined;
             bytes28?: undefined;
             bytes29?: undefined;
-            bytes30?: undefined;
             bytes31?: undefined;
             bytes32?: undefined;
             int56?: undefined;

package/dist/esm/global-account/react/hooks/useUserQuery.js

@@ -1,4 +1,4 @@
-import { useEffect } from "react";
+import { useEffect, useLayoutEffect } from "react";
 import { useUserStore } from "../stores/userStore.js";
 const USER_QUERY_KEY = ["b3-user"];
 /**
@@ -11,6 +11,16 @@ export function useUserQuery() {
     const user = useUserStore(state => state.user);
     const setUserStore = useUserStore(state => state.setUser);
     const clearUserStore = useUserStore(state => state.clearUser);
+    // Manually rehydrate persisted store inside useLayoutEffect to avoid
+    // updating AuthenticationProvider state during Hydrate render.
+    // useLayoutEffect (not useEffect) ensures rehydration triggers a
+    // synchronous re-render before any useEffect callbacks fire, so
+    // downstream effects always see the persisted user value.
+    useLayoutEffect(() => {
+        if (!useUserStore.persist.hasHydrated()) {
+            useUserStore.persist.rehydrate();
+        }
+    }, []);
     // Listen for storage events from other tabs/windows
     useEffect(() => {
         const handleStorageChange = (e) => {

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

@@ -470,11 +470,45 @@ export interface AnySpendCollectorClubPurchaseProps extends BaseModalProps {
     forceFiatPayment?: boolean;
     /** Staging environment support */
     isStaging?: boolean;
+    /** Optional discount code to apply to the purchase */
+    discountCode?: string;
 }
 /**
  * Props for the AnySpend Deposit modal
  * Flexible deposit component with optional chain selection
  */
+/**
+ * Props for the AnySpend Workflow Trigger modal
+ * Handles payments that trigger b3os-workflow runs
+ */
+export interface AnySpendWorkflowTriggerModalProps extends BaseModalProps {
+    /** Modal type identifier */
+    type: "anySpendWorkflowTrigger";
+    /** Payment recipient address (hex) */
+    recipientAddress: string;
+    /** Destination chain ID */
+    chainId: number;
+    /** Destination token address */
+    tokenAddress: string;
+    /** Required payment amount in token base units (wei) */
+    amount: string;
+    /** Workflow ID to trigger */
+    workflowId: string;
+    /** Organization ID that owns the workflow */
+    orgId: string;
+    /** Optional callback metadata */
+    callbackMetadata?: {
+        inputs?: Record<string, unknown>;
+    } & Record<string, unknown>;
+    /** Callback when payment succeeds */
+    onSuccess?: (amount: string) => void;
+    /** Callback when modal is closed */
+    onClose?: () => void;
+    /** Custom action label */
+    actionLabel?: string;
+    /** Custom class names */
+    classes?: AnySpendAllClasses;
+}
 export interface AnySpendDepositModalProps extends BaseModalProps {
     /** Modal type identifier */
     type: "anySpendDeposit";
@@ -534,11 +568,13 @@ 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
  */
-export type ModalContentType = SignInWithB3ModalProps | RequestPermissionsModalProps | ManageAccountModalProps | AnySpendModalProps | AnyspendOrderDetailsProps | AnySpendNftProps | AnySpendJoinTournamentProps | AnySpendFundTournamentProps | AnySpendOrderHistoryProps | AnySpendStakeB3Props | AnySpendStakeB3ExactInProps | AnySpendStakeUpsideProps | AnySpendStakeUpsideExactInProps | AnySpendDepositUpsideProps | AnySpendBuySpinProps | AnySpendSignatureMintProps | AnySpendBondKitProps | LinkAccountModalProps | LinkNewAccountModalProps | AnySpendDepositHypeProps | AvatarEditorModalProps | DepositModalProps | SendModalProps | NotificationsModalProps | AnySpendCollectorClubPurchaseProps | AnySpendDepositModalProps;
+export type ModalContentType = SignInWithB3ModalProps | RequestPermissionsModalProps | ManageAccountModalProps | AnySpendModalProps | AnyspendOrderDetailsProps | AnySpendNftProps | AnySpendJoinTournamentProps | AnySpendFundTournamentProps | AnySpendOrderHistoryProps | AnySpendStakeB3Props | AnySpendStakeB3ExactInProps | AnySpendStakeUpsideProps | AnySpendStakeUpsideExactInProps | AnySpendDepositUpsideProps | AnySpendBuySpinProps | AnySpendSignatureMintProps | AnySpendBondKitProps | LinkAccountModalProps | LinkNewAccountModalProps | AnySpendDepositHypeProps | AvatarEditorModalProps | DepositModalProps | SendModalProps | NotificationsModalProps | AnySpendCollectorClubPurchaseProps | AnySpendDepositModalProps | AnySpendWorkflowTriggerModalProps;
 /**
  * State interface for the modal store
  */

package/dist/esm/global-account/react/stores/userStore.js

@@ -19,6 +19,7 @@ export const useUserStore = create()(persist(set => ({
     },
 }), {
     name: "b3-user",
+    skipHydration: true,
     onRehydrateStorage: () => (_, error) => {
         if (error) {
             console.warn("Failed to rehydrate user store:", error);

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/AnySpendCollectorClubPurchase.d.ts

@@ -69,5 +69,10 @@ export interface AnySpendCollectorClubPurchaseProps {
      * Force fiat payment
      */
     forceFiatPayment?: boolean;
+    /**
+     * Optional discount code to apply to the purchase.
+     * When provided, validates on-chain and adjusts the price accordingly.
+     */
+    discountCode?: string;
 }
-export declare function AnySpendCollectorClubPurchase({ loadOrder, mode, activeTab, packId, packAmount, pricePerPack, paymentToken, recipientAddress, spenderAddress, isStaging, onSuccess, header, showRecipient, vendingMachineId, packType, forceFiatPayment, }: AnySpendCollectorClubPurchaseProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnySpendCollectorClubPurchase({ loadOrder, mode, activeTab, packId, packAmount, pricePerPack, paymentToken, recipientAddress, spenderAddress, isStaging, onSuccess, header, showRecipient, vendingMachineId, packType, forceFiatPayment, discountCode, }: AnySpendCollectorClubPurchaseProps): 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/AnySpendWorkflowTrigger.d.ts

@@ -0,0 +1,31 @@
+import type { AnySpendAllClasses } from "./types/classes";
+export interface AnySpendWorkflowTriggerProps {
+    /** Payment recipient address (hex) */
+    recipientAddress: string;
+    /** Destination chain ID */
+    chainId: number;
+    /** Destination token address */
+    tokenAddress: string;
+    /** Required payment amount in token base units (wei) */
+    amount: string;
+    /** Workflow ID to trigger */
+    workflowId: string;
+    /** Organization ID that owns the workflow */
+    orgId: string;
+    /** Optional callback metadata merged into the order */
+    callbackMetadata?: {
+        /** Passed as trigger result inputs — accessible via {{root.result.inputs.*}} */
+        inputs?: Record<string, unknown>;
+    } & Record<string, unknown>;
+    /** Callback when payment succeeds */
+    onSuccess?: (amount: string) => void;
+    /** Callback when modal is closed */
+    onClose?: () => void;
+    /** Display mode */
+    mode?: "modal" | "page";
+    /** Custom action label */
+    actionLabel?: string;
+    /** Custom class names */
+    classes?: AnySpendAllClasses;
+}
+export declare function AnySpendWorkflowTrigger({ recipientAddress, chainId, tokenAddress, amount, workflowId, orgId, callbackMetadata, onSuccess, onClose, mode, actionLabel, classes, }: AnySpendWorkflowTriggerProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,113 @@
+export declare const BUY_PACKS_FOR_ABI: {
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "packId";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "buyPacksFor";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+};
+export declare const BUY_PACKS_FOR_WITH_DISCOUNT_ABI: {
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "packId";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "string";
+        readonly name: "discountCode";
+        readonly type: "string";
+    }];
+    readonly name: "buyPacksForWithDiscount";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+};
+export declare const IS_DISCOUNT_CODE_VALID_FOR_PACK_ABI: {
+    readonly inputs: readonly [{
+        readonly internalType: "string";
+        readonly name: "code";
+        readonly type: "string";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "packId";
+        readonly type: "uint256";
+    }];
+    readonly name: "isDiscountCodeValidForPack";
+    readonly outputs: readonly [{
+        readonly internalType: "bool";
+        readonly name: "isValid";
+        readonly type: "bool";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "discountAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+};
+export declare const GET_DISCOUNT_CODE_ABI: {
+    readonly inputs: readonly [{
+        readonly internalType: "string";
+        readonly name: "code";
+        readonly type: "string";
+    }];
+    readonly name: "getDiscountCode";
+    readonly outputs: readonly [{
+        readonly components: readonly [{
+            readonly internalType: "uint256";
+            readonly name: "discountAmount";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "expiresAt";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "bool";
+            readonly name: "used";
+            readonly type: "bool";
+        }, {
+            readonly internalType: "bool";
+            readonly name: "exists";
+            readonly type: "bool";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "maxUses";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "usedCount";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "packId";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "minPurchaseAmount";
+            readonly type: "uint256";
+        }];
+        readonly internalType: "struct CCShop.DiscountCode";
+        readonly name: "";
+        readonly type: "tuple";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+};

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/components/index.d.ts

@@ -8,6 +8,8 @@ export { AnySpendDeposit } from "./AnySpendDeposit";
 export type { AnySpendDepositProps, ChainConfig, DepositContractConfig } from "./AnySpendDeposit";
 export type { AnySpendAllClasses, AnySpendClasses, AnySpendCustomExactInClasses, AnySpendDepositClasses, CryptoPaymentMethodClasses, CryptoPaySectionClasses, CryptoReceiveSectionClasses, FiatPaymentMethodClasses, OrderDetailsClasses, PanelOnrampClasses, QRDepositClasses, RecipientSelectionClasses, } from "./types/classes";
 export { AnySpendDepositHype, HYPE_TOKEN_DETAILS } from "./AnyspendDepositHype";
+export { AnySpendWorkflowTrigger } from "./AnySpendWorkflowTrigger";
+export type { AnySpendWorkflowTriggerProps } from "./AnySpendWorkflowTrigger";
 export * from "./AnySpendFingerprintWrapper";
 export { AnySpendNFT } from "./AnySpendNFT";
 export { AnyspendSignatureMint } from "./AnyspendSignatureMint";

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

@@ -12,6 +12,7 @@ export * from "./useGasPrice";
 export * from "./useGeoOnrampOptions";
 export * from "./useGetGeo";
 export * from "./useHyperliquidTransfer";
+export * from "./useOnOrderSuccess";
 export * from "./useRecipientAddressState";
 export * from "./useSigMint";
 export * from "./useStripeClientSecret";

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/react/hooks/useOnOrderSuccess.d.ts

@@ -0,0 +1,10 @@
+import { GetOrderAndTxsResponse } from "../../types/api_req_res";
+/**
+ * Hook to call onSuccess callback when an order is executed.
+ * Handles fallback to relayTxs when executeTx is null.
+ */
+export declare function useOnOrderSuccess({ orderData, orderId, onSuccess, }: {
+    orderData: GetOrderAndTxsResponse | undefined;
+    orderId: string | undefined;
+    onSuccess?: (txHash?: string) => void;
+}): 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/anyspend/utils/chain.d.ts

@@ -82,7 +82,7 @@ export declare function isTestnet(chainId: number): boolean;
 export declare function getDefaultToken(chainId: number): components["schemas"]["Token"];
 export declare function getChainName(chainId: number): string;
 export declare function getCoingeckoName(chainId: number): string | null;
-export declare function getPaymentUrl(address: string, amount: bigint, currency: string, chainId: number, decimals?: number): string;
+export declare function getPaymentUrl(address: string, amount: bigint | undefined, currency: string, chainId: number, decimals?: number): string;
 export declare function getExplorerTxUrl(chainId: number, txHash: string): string;
 export declare function getExplorerAddressUrl(chainId: number, address: string): string;
 export declare function getMulticall3Address(chainId: number): string;

package/dist/types/global-account/react/hooks/useFirstEOA.d.ts

@@ -7451,6 +7451,8 @@ export declare function useFirstEOA(chain?: {
             [x: `bool[${string}]`]: undefined;
             [x: `bytes[${string}]`]: undefined;
             [x: `bytes1[${string}]`]: undefined;
+            [x: `bytes4[${string}]`]: undefined;
+            [x: `bytes30[${string}]`]: undefined;
             [x: `bytes18[${string}]`]: undefined;
             [x: `bytes6[${string}]`]: undefined;
             [x: `bytes9[${string}]`]: undefined;
@@ -7458,7 +7460,6 @@ export declare function useFirstEOA(chain?: {
             [x: `bytes10[${string}]`]: undefined;
             [x: `bytes2[${string}]`]: undefined;
             [x: `bytes3[${string}]`]: undefined;
-            [x: `bytes4[${string}]`]: undefined;
             [x: `bytes5[${string}]`]: undefined;
             [x: `bytes7[${string}]`]: undefined;
             [x: `bytes11[${string}]`]: undefined;
@@ -7479,7 +7480,6 @@ export declare function useFirstEOA(chain?: {
             [x: `bytes27[${string}]`]: undefined;
             [x: `bytes28[${string}]`]: undefined;
             [x: `bytes29[${string}]`]: undefined;
-            [x: `bytes30[${string}]`]: undefined;
             [x: `bytes31[${string}]`]: undefined;
             [x: `bytes32[${string}]`]: undefined;
             [x: `int[${string}]`]: undefined;
@@ -7553,6 +7553,8 @@ export declare function useFirstEOA(chain?: {
             bool?: undefined;
             bytes?: undefined;
             bytes1?: undefined;
+            bytes4?: undefined;
+            bytes30?: undefined;
             bytes18?: undefined;
             bytes6?: undefined;
             bytes9?: undefined;
@@ -7560,7 +7562,6 @@ export declare function useFirstEOA(chain?: {
             bytes10?: undefined;
             bytes2?: undefined;
             bytes3?: undefined;
-            bytes4?: undefined;
             bytes5?: undefined;
             bytes7?: undefined;
             bytes11?: undefined;
@@ -7581,7 +7582,6 @@ export declare function useFirstEOA(chain?: {
             bytes27?: undefined;
             bytes28?: undefined;
             bytes29?: undefined;
-            bytes30?: undefined;
             bytes31?: undefined;
             bytes32?: undefined;
             int56?: undefined;

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

@@ -470,11 +470,45 @@ export interface AnySpendCollectorClubPurchaseProps extends BaseModalProps {
     forceFiatPayment?: boolean;
     /** Staging environment support */
     isStaging?: boolean;
+    /** Optional discount code to apply to the purchase */
+    discountCode?: string;
 }
 /**
  * Props for the AnySpend Deposit modal
  * Flexible deposit component with optional chain selection
  */
+/**
+ * Props for the AnySpend Workflow Trigger modal
+ * Handles payments that trigger b3os-workflow runs
+ */
+export interface AnySpendWorkflowTriggerModalProps extends BaseModalProps {
+    /** Modal type identifier */
+    type: "anySpendWorkflowTrigger";
+    /** Payment recipient address (hex) */
+    recipientAddress: string;
+    /** Destination chain ID */
+    chainId: number;
+    /** Destination token address */
+    tokenAddress: string;
+    /** Required payment amount in token base units (wei) */
+    amount: string;
+    /** Workflow ID to trigger */
+    workflowId: string;
+    /** Organization ID that owns the workflow */
+    orgId: string;
+    /** Optional callback metadata */
+    callbackMetadata?: {
+        inputs?: Record<string, unknown>;
+    } & Record<string, unknown>;
+    /** Callback when payment succeeds */
+    onSuccess?: (amount: string) => void;
+    /** Callback when modal is closed */
+    onClose?: () => void;
+    /** Custom action label */
+    actionLabel?: string;
+    /** Custom class names */
+    classes?: AnySpendAllClasses;
+}
 export interface AnySpendDepositModalProps extends BaseModalProps {
     /** Modal type identifier */
     type: "anySpendDeposit";
@@ -534,11 +568,13 @@ 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
  */
-export type ModalContentType = SignInWithB3ModalProps | RequestPermissionsModalProps | ManageAccountModalProps | AnySpendModalProps | AnyspendOrderDetailsProps | AnySpendNftProps | AnySpendJoinTournamentProps | AnySpendFundTournamentProps | AnySpendOrderHistoryProps | AnySpendStakeB3Props | AnySpendStakeB3ExactInProps | AnySpendStakeUpsideProps | AnySpendStakeUpsideExactInProps | AnySpendDepositUpsideProps | AnySpendBuySpinProps | AnySpendSignatureMintProps | AnySpendBondKitProps | LinkAccountModalProps | LinkNewAccountModalProps | AnySpendDepositHypeProps | AvatarEditorModalProps | DepositModalProps | SendModalProps | NotificationsModalProps | AnySpendCollectorClubPurchaseProps | AnySpendDepositModalProps;
+export type ModalContentType = SignInWithB3ModalProps | RequestPermissionsModalProps | ManageAccountModalProps | AnySpendModalProps | AnyspendOrderDetailsProps | AnySpendNftProps | AnySpendJoinTournamentProps | AnySpendFundTournamentProps | AnySpendOrderHistoryProps | AnySpendStakeB3Props | AnySpendStakeB3ExactInProps | AnySpendStakeUpsideProps | AnySpendStakeUpsideExactInProps | AnySpendDepositUpsideProps | AnySpendBuySpinProps | AnySpendSignatureMintProps | AnySpendBondKitProps | LinkAccountModalProps | LinkNewAccountModalProps | AnySpendDepositHypeProps | AvatarEditorModalProps | DepositModalProps | SendModalProps | NotificationsModalProps | AnySpendCollectorClubPurchaseProps | AnySpendDepositModalProps | AnySpendWorkflowTriggerModalProps;
 /**
  * State interface for the modal store
  */

package/package.json

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

package/src/anyspend/README.md

@@ -81,6 +81,7 @@ That's it! Your users can now purchase NFTs with any token from any supported ch
 | [🧩 Components API](./docs/components.md) | Pre-built React components for common use cases |
 | [🪝 Hooks API](./docs/hooks.md) | React hooks for custom implementations |
 | [💡 Examples & Use Cases](./docs/examples.md) | Real-world integration examples |
+| [🛒 Checkout Sessions](./docs/checkout-sessions.md) | Stripe-like checkout sessions for merchant integrations |
 | [⚠️ Error Handling](./docs/error-handling.md) | Error handling patterns and troubleshooting |
 | [🤝 Contributing](./docs/contributing.md) | How to contribute to AnySpend |
 
@@ -123,6 +124,19 @@ That's it! Your users can now purchase NFTs with any token from any supported ch
 />
 ```
 
+### Merchant Checkout Sessions
+```tsx
+<AnySpend
+  defaultActiveTab="fiat"
+  destinationTokenAddress="0x..." // USDC
+  recipientAddress={userAddress}
+  checkoutSession={{
+    success_url: "https://myshop.com/success?session={SESSION_ID}",
+    metadata: { sku: "widget-1" },
+  }}
+/>
+```
+
 ## 🌐 Supported Networks
 
 - **Ethereum** (Mainnet & Sepolia)