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

package/dist/cjs/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/cjs/anyspend/react/components/AnySpendWorkflowTrigger.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnySpendWorkflowTrigger = AnySpendWorkflowTrigger;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const AnySpendDeposit_1 = require("./AnySpendDeposit");
+function AnySpendWorkflowTrigger({ recipientAddress, chainId, tokenAddress, amount, workflowId, orgId, callbackMetadata, onSuccess, onClose, mode, actionLabel, classes, }) {
+    const metadata = (0, react_1.useMemo)(() => ({
+        workflowId,
+        orgId,
+        ...callbackMetadata,
+    }), [workflowId, orgId, callbackMetadata]);
+    return ((0, jsx_runtime_1.jsx)(AnySpendDeposit_1.AnySpendDeposit, { recipientAddress: recipientAddress, destinationTokenAddress: tokenAddress, destinationTokenChainId: chainId, destinationTokenAmount: amount, callbackMetadata: metadata, onSuccess: onSuccess, onClose: onClose, mode: mode, actionLabel: actionLabel, classes: classes, allowDirectTransfer: true }));
+}

package/dist/cjs/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/cjs/anyspend/react/components/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebviewOnrampPayment = exports.WebviewOnrampOrderStatus = exports.TransferCryptoDetails = exports.TokenBalance = exports.StepProgress = exports.RecipientSelection = exports.OrderTokenAmount = exports.OrderToken = exports.OrderStatus = exports.OrderHistoryItem = exports.OrderHistory = exports.OrderDetailsCollapsible = exports.OrderDetails = exports.CryptoReceiveSection = exports.CryptoPaySection = exports.ChainTokenIcon = exports.AnySpendNFTButton = exports.AnySpendTournament = exports.AnySpendStakeUpsideExactIn = exports.AnySpendStakeUpside = exports.AnySpendStakeB3ExactIn = exports.AnySpendStakeB3 = exports.AnyspendSignatureMint = exports.AnySpendNFT = exports.HYPE_TOKEN_DETAILS = exports.AnySpendDepositHype = exports.AnySpendDeposit = exports.AnySpendCustomExactIn = exports.AnySpendCustom = exports.AnySpendCollectorClubPurchase = exports.AnySpendBuySpin = exports.AnySpendBondKit = exports.AnySpend = void 0;
+exports.WebviewOnrampPayment = exports.WebviewOnrampOrderStatus = exports.TransferCryptoDetails = exports.TokenBalance = exports.StepProgress = exports.RecipientSelection = exports.OrderTokenAmount = exports.OrderToken = exports.OrderStatus = exports.OrderHistoryItem = exports.OrderHistory = exports.OrderDetailsCollapsible = exports.OrderDetails = exports.CryptoReceiveSection = exports.CryptoPaySection = exports.ChainTokenIcon = exports.AnySpendNFTButton = exports.AnySpendTournament = exports.AnySpendStakeUpsideExactIn = exports.AnySpendStakeUpside = exports.AnySpendStakeB3ExactIn = exports.AnySpendStakeB3 = exports.AnyspendSignatureMint = exports.AnySpendNFT = exports.AnySpendWorkflowTrigger = exports.HYPE_TOKEN_DETAILS = exports.AnySpendDepositHype = exports.AnySpendDeposit = exports.AnySpendCustomExactIn = exports.AnySpendCustom = exports.AnySpendCollectorClubPurchase = exports.AnySpendBuySpin = exports.AnySpendBondKit = exports.AnySpend = void 0;
 // Components
 var AnySpend_1 = require("./AnySpend");
 Object.defineProperty(exports, "AnySpend", { enumerable: true, get: function () { return AnySpend_1.AnySpend; } });
@@ -33,6 +33,8 @@ Object.defineProperty(exports, "AnySpendDeposit", { enumerable: true, get: funct
 var AnyspendDepositHype_1 = require("./AnyspendDepositHype");
 Object.defineProperty(exports, "AnySpendDepositHype", { enumerable: true, get: function () { return AnyspendDepositHype_1.AnySpendDepositHype; } });
 Object.defineProperty(exports, "HYPE_TOKEN_DETAILS", { enumerable: true, get: function () { return AnyspendDepositHype_1.HYPE_TOKEN_DETAILS; } });
+var AnySpendWorkflowTrigger_1 = require("./AnySpendWorkflowTrigger");
+Object.defineProperty(exports, "AnySpendWorkflowTrigger", { enumerable: true, get: function () { return AnySpendWorkflowTrigger_1.AnySpendWorkflowTrigger; } });
 __exportStar(require("./AnySpendFingerprintWrapper"), exports);
 var AnySpendNFT_1 = require("./AnySpendNFT");
 Object.defineProperty(exports, "AnySpendNFT", { enumerable: true, get: function () { return AnySpendNFT_1.AnySpendNFT; } });

package/dist/cjs/global-account/react/components/B3DynamicModal.js

@@ -8,6 +8,7 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("../../../anyspend/react");
 const AnySpendDeposit_1 = require("../../../anyspend/react/components/AnySpendDeposit");
 const AnyspendDepositHype_1 = require("../../../anyspend/react/components/AnyspendDepositHype");
+const AnySpendWorkflowTrigger_1 = require("../../../anyspend/react/components/AnySpendWorkflowTrigger");
 const AnySpendDepositUpside_1 = require("../../../anyspend/react/components/AnySpendDepositUpside");
 const AnySpendStakeUpside_1 = require("../../../anyspend/react/components/AnySpendStakeUpside");
 const AnySpendStakeUpsideExactIn_1 = require("../../../anyspend/react/components/AnySpendStakeUpsideExactIn");
@@ -58,6 +59,7 @@ function B3DynamicModal() {
         "send",
         "notifications",
         "anySpendDeposit",
+        "anySpendWorkflowTrigger",
     ];
     const freestyleTypes = [
         "anySpendNft",
@@ -128,6 +130,8 @@ function B3DynamicModal() {
                 return (0, jsx_runtime_1.jsx)(react_1.AnySpendCollectorClubPurchase, { ...contentType, mode: "modal" });
             case "anySpendDeposit":
                 return (0, jsx_runtime_1.jsx)(AnySpendDeposit_1.AnySpendDeposit, { ...contentType, mode: "modal" });
+            case "anySpendWorkflowTrigger":
+                return (0, jsx_runtime_1.jsx)(AnySpendWorkflowTrigger_1.AnySpendWorkflowTrigger, { ...contentType, mode: "modal" });
             case "avatarEditor":
                 return (0, jsx_runtime_1.jsx)(AvatarEditor_1.AvatarEditor, { onSetAvatar: contentType.onSuccess });
             case "deposit":

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

@@ -477,6 +477,38 @@ export interface AnySpendCollectorClubPurchaseProps extends BaseModalProps {
  * 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";
@@ -542,7 +574,7 @@ export interface AnySpendDepositModalProps extends BaseModalProps {
 /**
  * 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/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/esm/anyspend/react/components/AnySpendWorkflowTrigger.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { AnySpendDeposit } from "./AnySpendDeposit.js";
+export function AnySpendWorkflowTrigger({ recipientAddress, chainId, tokenAddress, amount, workflowId, orgId, callbackMetadata, onSuccess, onClose, mode, actionLabel, classes, }) {
+    const metadata = useMemo(() => ({
+        workflowId,
+        orgId,
+        ...callbackMetadata,
+    }), [workflowId, orgId, callbackMetadata]);
+    return (_jsx(AnySpendDeposit, { recipientAddress: recipientAddress, destinationTokenAddress: tokenAddress, destinationTokenChainId: chainId, destinationTokenAmount: amount, callbackMetadata: metadata, onSuccess: onSuccess, onClose: onClose, mode: mode, actionLabel: actionLabel, classes: classes, allowDirectTransfer: true }));
+}

package/dist/esm/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/esm/anyspend/react/components/index.js

@@ -7,6 +7,7 @@ export { AnySpendCustom } from "./AnySpendCustom.js";
 export { AnySpendCustomExactIn } from "./AnySpendCustomExactIn.js";
 export { AnySpendDeposit } from "./AnySpendDeposit.js";
 export { AnySpendDepositHype, HYPE_TOKEN_DETAILS } from "./AnyspendDepositHype.js";
+export { AnySpendWorkflowTrigger } from "./AnySpendWorkflowTrigger.js";
 export * from "./AnySpendFingerprintWrapper.js";
 export { AnySpendNFT } from "./AnySpendNFT.js";
 export { AnyspendSignatureMint } from "./AnyspendSignatureMint.js";

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

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { AnySpend, AnySpendBondKit, AnySpendBuySpin, AnySpendCollectorClubPurchase, AnySpendNFT, AnyspendSignatureMint, AnySpendStakeB3, AnySpendStakeB3ExactIn, AnySpendTournament, OrderHistory, } from "../../../anyspend/react/index.js";
 import { AnySpendDeposit } from "../../../anyspend/react/components/AnySpendDeposit.js";
 import { AnySpendDepositHype } from "../../../anyspend/react/components/AnyspendDepositHype.js";
+import { AnySpendWorkflowTrigger } from "../../../anyspend/react/components/AnySpendWorkflowTrigger.js";
 import { AnySpendDepositUpside } from "../../../anyspend/react/components/AnySpendDepositUpside.js";
 import { AnySpendStakeUpside } from "../../../anyspend/react/components/AnySpendStakeUpside.js";
 import { AnySpendStakeUpsideExactIn } from "../../../anyspend/react/components/AnySpendStakeUpsideExactIn.js";
@@ -52,6 +53,7 @@ export function B3DynamicModal() {
         "send",
         "notifications",
         "anySpendDeposit",
+        "anySpendWorkflowTrigger",
     ];
     const freestyleTypes = [
         "anySpendNft",
@@ -122,6 +124,8 @@ export function B3DynamicModal() {
                 return _jsx(AnySpendCollectorClubPurchase, { ...contentType, mode: "modal" });
             case "anySpendDeposit":
                 return _jsx(AnySpendDeposit, { ...contentType, mode: "modal" });
+            case "anySpendWorkflowTrigger":
+                return _jsx(AnySpendWorkflowTrigger, { ...contentType, mode: "modal" });
             case "avatarEditor":
                 return _jsx(AvatarEditor, { onSetAvatar: contentType.onSuccess });
             case "deposit":

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

@@ -477,6 +477,38 @@ export interface AnySpendCollectorClubPurchaseProps extends BaseModalProps {
  * 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";
@@ -542,7 +574,7 @@ export interface AnySpendDepositModalProps extends BaseModalProps {
 /**
  * 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/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/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/global-account/react/stores/useModalStore.d.ts

@@ -477,6 +477,38 @@ export interface AnySpendCollectorClubPurchaseProps extends BaseModalProps {
  * 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";
@@ -542,7 +574,7 @@ export interface AnySpendDepositModalProps extends BaseModalProps {
 /**
  * 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-alpha.6",
+  "version": "0.1.65-alpha.8",
   "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)

package/src/anyspend/docs/checkout-sessions.md

@@ -0,0 +1,228 @@
+# Checkout Sessions
+
+Stripe-like checkout sessions for AnySpend. Sessions are decoupled from orders — create a session first, then create an order when the user is ready to pay.
+
+## Flow
+
+```
+1. Merchant creates session        POST /checkout-sessions
+                                   <- { id, status: "open" }
+
+2. User picks payment method       POST /orders { checkoutSessionId }
+                                   <- { id, globalAddress, oneClickBuyUrl }
+
+3. User pays                       Crypto: send to globalAddress
+                                   Onramp: redirect to oneClickBuyUrl
+
+4. Merchant polls for completion   GET /checkout-sessions/:id
+                                   <- { status: "complete", order_id }
+```
+
+### Why Decoupled?
+
+Session creation is instant (DB-only, no external calls). The order is created separately when the user commits to a payment method. This means:
+
+- Payment method doesn't need to be known at session creation
+- A hosted checkout page can let users choose how to pay
+- Session creation never fails due to external API errors
+
+## Session Status Lifecycle
+
+```
+open --> processing --> complete
+  |
+  └--> expired
+```
+
+| Status | When |
+|--------|------|
+| `open` | Created, waiting for order/payment |
+| `processing` | Payment received, order executing |
+| `complete` | Order executed successfully |
+| `expired` | TTL expired, payment failed, or manually expired |
+
+## API
+
+### `POST /checkout-sessions` — Create Session
+
+Creates a lightweight session. No order, no external API calls.
+
+```json
+{
+  "success_url": "https://merchant.com/success?session_id={SESSION_ID}",
+  "cancel_url": "https://merchant.com/cancel",
+  "metadata": { "sku": "widget-1" },
+  "client_reference_id": "merchant-order-456",
+  "expires_in": 1800
+}
+```
+
+All fields are optional. Payment config (amount, tokens, chains) lives on the order, not the session.
+
+### `POST /orders` — Create Order with Session Linking
+
+Pass `checkoutSessionId` in the standard order creation request to link the order to a session.
+
+```json
+{
+  "recipientAddress": "0x...",
+  "srcChain": 8453,
+  "dstChain": 8453,
+  "srcTokenAddress": "0x...",
+  "dstTokenAddress": "0x...",
+  "srcAmount": "1000000",
+  "type": "swap",
+  "payload": { "expectedDstAmount": "1000000" },
+  "checkoutSessionId": "550e8400-..."
+}
+```
+
+**Validation:**
+- Session must exist (`400` if not found)
+- Session must be `open` (`400` if expired/processing/complete)
+- Session must not already have an order (`409 Conflict`)
+
+### `GET /checkout-sessions/:id` — Retrieve Session
+
+Returns current session state. Status is synced from the underlying order on each retrieval.
+
+| Query Param | Description |
+|-------------|-------------|
+| `include=order` | Embed the full order object with transactions |
+
+### `POST /checkout-sessions/:id/expire` — Manually Expire
+
+Only works on sessions with status `open`.
+
+## Redirect URL Templates
+
+Use template variables in `success_url` and `cancel_url`:
+
+| Variable | Replaced with |
+|----------|--------------|
+| `{SESSION_ID}` | The checkout session UUID |
+| `{ORDER_ID}` | Same value (alias) |
+
+If no template variable is present, `?sessionId=<uuid>` is appended automatically.
+
+## SDK Integration
+
+### Service Methods
+
+```typescript
+// Create a checkout session
+const session = await anyspend.createCheckoutSession({
+  success_url: "https://mysite.com/success/{SESSION_ID}",
+  metadata: { sku: "widget-1" },
+});
+
+// Retrieve session status
+const session = await anyspend.getCheckoutSession(sessionId);
+```
+
+### React Hooks
+
+#### `useCreateCheckoutSession`
+
+Mutation hook for creating sessions.
+
+```tsx
+import { useCreateCheckoutSession } from "@b3dotfun/sdk/anyspend";
+
+const { mutate: createSession, data, isPending } = useCreateCheckoutSession();
+```
+
+#### `useCheckoutSession`
+
+Query hook with auto-polling. Stops polling when status reaches `complete` or `expired`.
+
+```tsx
+import { useCheckoutSession } from "@b3dotfun/sdk/anyspend";
+
+const { data: session, isLoading } = useCheckoutSession(sessionId);
+```
+
+### Component `checkoutSession` Prop
+
+The `<AnySpend>`, `<AnySpendCustom>`, and `<AnySpendCustomExactIn>` components accept an optional `checkoutSession` prop:
+
+```tsx
+<AnySpend
+  defaultActiveTab="fiat"
+  destinationTokenAddress="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+  destinationTokenChainId={8453}
+  recipientAddress="0x..."
+  checkoutSession={{
+    success_url: "https://myshop.com/success?session={SESSION_ID}",
+    cancel_url: "https://myshop.com/cancel",
+    metadata: { sku: "widget-1" },
+  }}
+/>
+```
+
+When the `checkoutSession` prop is set, the component automatically creates a session before creating the order, and uses the session's `success_url` for redirects. Without the prop, existing flows are unchanged.
+
+## Examples
+
+### Crypto Payment
+
+```typescript
+// 1. Create session
+const session = await fetch("/checkout-sessions", {
+  method: "POST",
+  body: JSON.stringify({
+    success_url: "https://mysite.com/success/{SESSION_ID}",
+    metadata: { sku: "widget-1" },
+  }),
+}).then(r => r.json());
+
+// 2. Create order linked to session
+const order = await fetch("/orders", {
+  method: "POST",
+  body: JSON.stringify({
+    recipientAddress: "0x...",
+    srcChain: 8453,
+    dstChain: 8453,
+    srcTokenAddress: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+    dstTokenAddress: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+    srcAmount: "1000000",
+    type: "swap",
+    payload: { expectedDstAmount: "1000000" },
+    checkoutSessionId: session.data.id,
+  }),
+}).then(r => r.json());
+
+// 3. User sends crypto to order.data.globalAddress
+
+// 4. Poll session until complete
+const poll = setInterval(async () => {
+  const s = await fetch(`/checkout-sessions/${session.data.id}`).then(r => r.json());
+  if (s.data.status === "complete") {
+    clearInterval(poll);
+    // redirect to success_url or show confirmation
+  }
+}, 3000);
+```
+
+### Onramp Payment (Coinbase/Stripe)
+
+```typescript
+// Steps 1-2 same as above, but include onramp config in order creation:
+const order = await fetch("/orders", {
+  method: "POST",
+  body: JSON.stringify({
+    // ... same order fields ...
+    checkoutSessionId: session.data.id,
+    onramp: {
+      vendor: "coinbase",
+      payment_method: "card",
+      country: "US",
+    },
+  }),
+}).then(r => r.json());
+
+// Redirect user to vendor checkout page
+window.location.href = order.data.oneClickBuyUrl;
+
+// After vendor redirects back, poll GET /checkout-sessions/:id for completion
+```

package/src/anyspend/docs/components.md

@@ -207,6 +207,32 @@ const stakingCalldata = encodeFunctionData({
 />
 ```
 
+### Checkout Session Prop
+
+The `<AnySpend>`, `<AnySpendCustom>`, and `<AnySpendCustomExactIn>` components accept an optional `checkoutSession` prop for merchant checkout flows. When set, the component creates a session before the order and uses the session's redirect URLs. See [Checkout Sessions](./checkout-sessions.md) for the full guide.
+
+```tsx
+<AnySpend
+  defaultActiveTab="fiat"
+  destinationTokenAddress="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+  destinationTokenChainId={8453}
+  recipientAddress="0x..."
+  checkoutSession={{
+    success_url: "https://myshop.com/success?session={SESSION_ID}",
+    cancel_url: "https://myshop.com/cancel",
+    metadata: { sku: "widget-1" },
+  }}
+/>
+```
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `checkoutSession.success_url` | `string` | Redirect URL on completion. Supports `{SESSION_ID}` template. |
+| `checkoutSession.cancel_url` | `string` | Redirect URL on cancellation |
+| `checkoutSession.metadata` | `Record<string, string>` | Custom metadata attached to the session |
+
+---
+
 ## Specialized Components
 
 ### `<AnySpendNFT>`

package/src/anyspend/docs/examples.md

@@ -720,8 +720,66 @@ function PortfolioRebalancer() {
 }
 ```
 
+## 🛒 Checkout Sessions (Merchant Integration)
+
+### Hosted Checkout with Payment Choice
+
+Let users choose their payment method (crypto or fiat) after session creation.
+
+```tsx
+import { AnySpend } from "@b3dotfun/sdk/anyspend/react";
+
+function MerchantCheckout({ sku, price }: { sku: string; price: string }) {
+  const [userAddress] = useWallet();
+
+  return (
+    <AnySpend
+      defaultActiveTab="fiat"
+      destinationTokenAddress="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+      destinationTokenChainId={8453}
+      recipientAddress={userAddress}
+      checkoutSession={{
+        success_url: "https://myshop.com/success?session={SESSION_ID}",
+        cancel_url: "https://myshop.com/cancel",
+        metadata: { sku, price },
+      }}
+    />
+  );
+}
+```
+
+### Server-Side Session with Custom Polling
+
+```tsx
+import {
+  useCreateCheckoutSession,
+  useCheckoutSession,
+} from "@b3dotfun/sdk/anyspend";
+
+function ServerCheckout() {
+  const { mutate: createSession, data: session } = useCreateCheckoutSession();
+  const { data: sessionStatus } = useCheckoutSession(session?.data?.id);
+
+  useEffect(() => {
+    createSession({
+      success_url: "https://mysite.com/success/{SESSION_ID}",
+      metadata: { sku: "widget-1" },
+    });
+  }, []);
+
+  if (sessionStatus?.data?.status === "complete") {
+    return <div>Payment complete!</div>;
+  }
+
+  // Render order creation UI...
+}
+```
+
+See [Checkout Sessions](./checkout-sessions.md) for the full guide including API details and the session lifecycle.
+
 ## Next Steps
 
+- [Checkout Sessions →](./checkout-sessions.md)
 - [Error Handling Guide →](./error-handling.md)
 - [Components Reference →](./components.md)
 - [Hooks Reference →](./hooks.md)

package/src/anyspend/docs/hooks.md

@@ -385,6 +385,38 @@ Get Stripe payment intent for credit card payments.
 const { clientSecret, isLoadingClientSecret } = useStripeClientSecret(orderData);
 ```
 
+### `useCreateCheckoutSession`
+
+Create checkout sessions for merchant integrations. See [Checkout Sessions](./checkout-sessions.md) for the full guide.
+
+```tsx
+import { useCreateCheckoutSession } from "@b3dotfun/sdk/anyspend";
+
+const { mutate: createSession, data, isPending } = useCreateCheckoutSession();
+
+createSession({
+  success_url: "https://mysite.com/success/{SESSION_ID}",
+  cancel_url: "https://mysite.com/cancel",
+  metadata: { sku: "widget-1" },
+});
+```
+
+---
+
+### `useCheckoutSession`
+
+Poll a checkout session's status. Auto-polls while the session is `open` or `processing`, and stops when `complete` or `expired`.
+
+```tsx
+import { useCheckoutSession } from "@b3dotfun/sdk/anyspend";
+
+const { data: session, isLoading } = useCheckoutSession(sessionId);
+
+// session.data.status: "open" | "processing" | "complete" | "expired"
+```
+
+---
+
 ## Hook Patterns
 
 ### Error Handling Pattern

package/src/anyspend/llms.txt

@@ -0,0 +1,185 @@
+# AnySpend SDK
+
+> Accept crypto payments and onboard users with zero friction. Users pay with any token on any chain in one seamless experience.
+
+## Overview
+
+AnySpend is a payment SDK (`@b3dotfun/sdk`) for crypto payments and fiat onramps. It provides React components, hooks, and service methods for token swaps, cross-chain transactions, NFT purchases, and merchant checkout flows.
+
+Supported networks: Ethereum, Base, B3.
+Supported platforms: React Web (full), React Native (hooks + services only), Node.js (services only).
+
+## Installation
+
+```bash
+npm install @b3dotfun/sdk
+```
+
+Wrap your app with the provider:
+
+```tsx
+import { AnySpendProvider } from "@b3dotfun/sdk/anyspend/react";
+import "@b3dotfun/sdk/index.css";
+
+function App() {
+  return <AnySpendProvider>{/* app */}</AnySpendProvider>;
+}
+```
+
+Requires Node.js v20.15.0+, React 18/19.
+
+## Components
+
+### AnySpend
+
+Primary swap/onramp interface. Supports modal or page mode.
+
+Props: `mode` ("modal"|"page"), `defaultActiveTab` ("crypto"|"fiat"), `destinationTokenAddress`, `destinationTokenChainId`, `recipientAddress`, `hideTransactionHistoryButton`, `loadOrder`, `onSuccess`, `checkoutSession`.
+
+```tsx
+<AnySpend
+  mode="page"
+  defaultActiveTab="crypto"
+  recipientAddress="0x..."
+  onSuccess={(txHash) => console.log(txHash)}
+/>
+```
+
+### AnySpendNFTButton
+
+One-click NFT purchase button.
+
+Props: `nftContract` (NFTContract), `recipientAddress`, `onSuccess`.
+
+NFTContract shape: `{ chainId, contractAddress, price (wei), priceFormatted, currency: { chainId, address, name, symbol, decimals }, name, description, imageUrl }`.
+
+### AnySpendCustom
+
+Flexible component for custom smart contract interactions (staking, gaming, DeFi).
+
+Props: `orderType` ("custom"), `dstChainId`, `dstToken`, `dstAmount`, `contractAddress`, `encodedData`, `spenderAddress`, `metadata`, `header`, `onSuccess`, `checkoutSession`.
+
+### AnySpendCustomExactIn
+
+Like AnySpendCustom but for exact-input flows. Also supports `checkoutSession` prop.
+
+### Specialized Components
+
+- `AnySpendNFT` — Enhanced NFT with marketplace features
+- `AnySpendStakeB3` — B3 token staking
+- `AnySpendBuySpin` — Gaming spin wheel purchases
+- `AnySpendTournament` — Tournament entry payments
+
+## Hooks
+
+### useAnyspendQuote(quoteRequest)
+
+Get real-time pricing. QuoteRequest: `{ srcChain, dstChain, srcTokenAddress, dstTokenAddress, type ("swap"|"custom"), tradeType ("EXACT_INPUT"|"EXACT_OUTPUT"), amount }`.
+
+Returns: `{ anyspendQuote, isLoadingAnyspendQuote, getAnyspendQuoteError, refetchAnyspendQuote }`.
+
+### useAnyspendCreateOrder(options)
+
+Create orders. Options: `{ onSuccess, onError, onSettled }`.
+
+Returns: `{ createOrder(request), isCreatingOrder, createOrderError }`.
+
+### useAnyspendOrderAndTransactions(orderId)
+
+Monitor order status and transactions in real-time.
+
+Returns: `{ orderAndTransactions: { order, depositTxs, relayTx, executeTx, refundTxs }, isLoadingOrderAndTransactions, getOrderAndTransactionsError }`.
+
+### useAnyspendOrderHistory(creatorAddress, limit, offset)
+
+Paginated order history for a user.
+
+### useAnyspendTokens(chainId, search)
+
+Get available tokens for a chain.
+
+### useCoinbaseOnrampOptions()
+
+Get Coinbase onramp config for fiat payments.
+
+### useStripeClientSecret(orderData)
+
+Get Stripe payment intent for card payments.
+
+### useCreateCheckoutSession()
+
+Mutation hook for creating checkout sessions.
+
+Returns: `{ mutate: createSession, data, isPending }`.
+
+### useCheckoutSession(sessionId)
+
+Query hook that auto-polls a checkout session. Stops on `complete` or `expired`.
+
+Returns: `{ data: session, isLoading }`.
+
+## Checkout Sessions
+
+Stripe-like checkout sessions decoupled from orders. Merchants create a session first, then create an order when the user picks a payment method.
+
+### Flow
+
+1. `POST /checkout-sessions` → Creates session (DB only, instant). Returns `{ id, status: "open" }`.
+2. `POST /orders` with `checkoutSessionId` → Creates order linked to session. Returns order with `globalAddress` or `oneClickBuyUrl`.
+3. User pays (crypto to globalAddress, or onramp redirect).
+4. `GET /checkout-sessions/:id` → Poll status. Returns `{ status: "complete", order_id }`.
+
+### Session Statuses
+
+`open` → `processing` → `complete`, or `open` → `expired`.
+
+### API Endpoints
+
+**POST /checkout-sessions** — Create session. All fields optional: `success_url`, `cancel_url`, `metadata`, `client_reference_id`, `expires_in`.
+
+**POST /orders** — Standard order creation. Add `checkoutSessionId` to link. Validates: session exists (400), session is open (400), session has no order yet (409).
+
+**GET /checkout-sessions/:id** — Retrieve session. Query `?include=order` to embed full order with transactions.
+
+**POST /checkout-sessions/:id/expire** — Manually expire an open session.
+
+### Redirect URL Templates
+
+`success_url` and `cancel_url` support `{SESSION_ID}` and `{ORDER_ID}` template variables. If no variable present, `?sessionId=<uuid>` is appended.
+
+### Component Integration
+
+Pass `checkoutSession` prop to `AnySpend`, `AnySpendCustom`, or `AnySpendCustomExactIn`:
+
+```tsx
+<AnySpend
+  checkoutSession={{
+    success_url: "https://myshop.com/success?session={SESSION_ID}",
+    cancel_url: "https://myshop.com/cancel",
+    metadata: { sku: "widget-1" },
+  }}
+/>
+```
+
+Without the prop, all existing flows are unchanged.
+
+## Order Status Lifecycle
+
+`scanning_deposit_transaction` → `obtain_token` → `sending_token_from_vault` → `relay` → `executed`
+
+Failure states: `obtain_failed`, `expired`, `refunding`, `refunded`, `failure`.
+
+For Stripe: `waiting_stripe_payment` precedes processing.
+
+## Error Codes
+
+Payment: `INSUFFICIENT_BALANCE`, `INVALID_TOKEN_ADDRESS`, `MINIMUM_AMOUNT_NOT_MET`, `MAXIMUM_AMOUNT_EXCEEDED`.
+Network: `SLIPPAGE`, `NETWORK_ERROR`, `QUOTE_EXPIRED`, `CHAIN_NOT_SUPPORTED`.
+Contract: `CONTRACT_CALL_FAILED`, `INSUFFICIENT_GAS`, `NONCE_TOO_LOW`, `TRANSACTION_REVERTED`.
+
+## Links
+
+- Docs: docs/installation.md, docs/components.md, docs/hooks.md, docs/examples.md, docs/checkout-sessions.md, docs/error-handling.md
+- Live demo: https://anyspend.com
+- Discord: https://discord.gg/b3dotfun
+- Issues: https://github.com/b3-fun/b3/issues

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

@@ -0,0 +1,73 @@
+import { useMemo } from "react";
+import type { AnySpendAllClasses } from "./types/classes";
+import { AnySpendDeposit } from "./AnySpendDeposit";
+
+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 function AnySpendWorkflowTrigger({
+  recipientAddress,
+  chainId,
+  tokenAddress,
+  amount,
+  workflowId,
+  orgId,
+  callbackMetadata,
+  onSuccess,
+  onClose,
+  mode,
+  actionLabel,
+  classes,
+}: AnySpendWorkflowTriggerProps) {
+  const metadata = useMemo(
+    () => ({
+      workflowId,
+      orgId,
+      ...callbackMetadata,
+    }),
+    [workflowId, orgId, callbackMetadata],
+  );
+
+  return (
+    <AnySpendDeposit
+      recipientAddress={recipientAddress}
+      destinationTokenAddress={tokenAddress}
+      destinationTokenChainId={chainId}
+      destinationTokenAmount={amount}
+      callbackMetadata={metadata}
+      onSuccess={onSuccess}
+      onClose={onClose}
+      mode={mode}
+      actionLabel={actionLabel}
+      classes={classes}
+      allowDirectTransfer
+    />
+  );
+}

package/src/anyspend/react/components/index.ts

@@ -24,6 +24,8 @@ export type {
   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/src/global-account/react/components/B3DynamicModal.tsx

@@ -12,6 +12,7 @@ import {
 } from "@b3dotfun/sdk/anyspend/react";
 import { AnySpendDeposit } from "@b3dotfun/sdk/anyspend/react/components/AnySpendDeposit";
 import { AnySpendDepositHype } from "@b3dotfun/sdk/anyspend/react/components/AnyspendDepositHype";
+import { AnySpendWorkflowTrigger } from "@b3dotfun/sdk/anyspend/react/components/AnySpendWorkflowTrigger";
 import { AnySpendDepositUpside } from "@b3dotfun/sdk/anyspend/react/components/AnySpendDepositUpside";
 import { AnySpendStakeUpside } from "@b3dotfun/sdk/anyspend/react/components/AnySpendStakeUpside";
 import { AnySpendStakeUpsideExactIn } from "@b3dotfun/sdk/anyspend/react/components/AnySpendStakeUpsideExactIn";
@@ -65,6 +66,7 @@ export function B3DynamicModal() {
     "send",
     "notifications",
     "anySpendDeposit",
+    "anySpendWorkflowTrigger",
   ];
 
   const freestyleTypes = [
@@ -152,6 +154,8 @@ export function B3DynamicModal() {
         return <AnySpendCollectorClubPurchase {...contentType} mode="modal" />;
       case "anySpendDeposit":
         return <AnySpendDeposit {...contentType} mode="modal" />;
+      case "anySpendWorkflowTrigger":
+        return <AnySpendWorkflowTrigger {...contentType} mode="modal" />;
       case "avatarEditor":
         return <AvatarEditor onSetAvatar={contentType.onSuccess} />;
       case "deposit":

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

@@ -505,6 +505,39 @@ export interface AnySpendCollectorClubPurchaseProps extends BaseModalProps {
  * 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";
@@ -595,8 +628,8 @@ export type ModalContentType =
   | SendModalProps
   | NotificationsModalProps
   | AnySpendCollectorClubPurchaseProps
-  | AnySpendDepositModalProps;
-// Add other modal types here like: | OtherModalProps | AnotherModalProps
+  | AnySpendDepositModalProps
+  | AnySpendWorkflowTriggerModalProps;
 
 /**
  * State interface for the modal store